🎯 feat: add list versions method.

Author: korawica

src/sqlplate/sqlplate.py

@@ -72,6 +72,24 @@ def list_formats(path: Optional[Path] = None) -> list[str]:
             if fmt.is_dir() and fmt.name != 'utils'
         ]
 
+    @staticmethod
+    def list_versions(fmt: str, path: Optional[Path] = None) -> list[str]:
+        """Return supported version of specific format with list of version
+        string value.
+
+        Arges:
+            path (Path | None): A template path that want to search.
+
+        :rtype: list[str]
+        """
+        if path is None:
+            path: Path = Path('./templates')
+        return [
+            f.name
+            for f in (path / fmt).glob(pattern='*')
+            if f.is_dir()
+        ]
+
     @classmethod
     def format(cls, name: str, path: Optional[Path] = None) -> 'SQLPlate':
         """Construction this class from a system value name.

tests/test_sqlplate.py

@@ -27,6 +27,15 @@ def test_sqlplate_version(template_path):
     fmt.version("latest")
 
 
+def test_sqlplate_versions(template_path):
+    versions: list[str] = SQLPlate.list_versions(
+        fmt="databricks", path=template_path
+    )
+    assert isinstance(versions, list)
+    assert len(versions) > 0
+    assert 'latest' in versions
+
+
 def test_sqlplate_check(template_path):
     fmt: SQLPlate = SQLPlate.format("databricks", path=template_path)