add imports

Author: martindurant

pyproject.toml

@@ -39,7 +39,7 @@ projspec = "projspec.__main__:main"
 po_test = ["pytest"]
 
 [tool.poetry]
-# poetry can't resolve hatch's dynamic version but needs a value
+# poetry can't resolve hatch's dynamic versioning but needs a value.
 version="0.0.1"
 
 [tool.hatch.version]

src/projspec/__main__.py

@@ -7,7 +7,7 @@
 
 import projspec.proj
 
-# TODO: allow subcommands to list known types and set config
+# TODO: allow subcommands to execute artifacts, list known types and set config
 
 
 @click.command()

src/projspec/cli.py

@@ -1,11 +1,13 @@
 from .base import Project, ProjectSpec
 from .conda_package import CondaRecipe, RattlerRecipe
 from .conda_project import CondaProject
+from .documentation import RTD, MDBook
 from .git import GitRepo
 from .pixi import Pixi
 from .poetry import PoetryProject
 from .pyscript import PyScriptSpec
 from .python_code import PythonCode, PythonLibrary
+from .rust import Rust, RustPython
 from .uv import UVProject
 
 __all__ = [
@@ -14,11 +16,15 @@
     "CondaRecipe",
     "CondaProject",
     "GitRepo",
+    "MDBook",
     "PoetryProject",
     "RattlerRecipe",
     "Pixi",
     "PyScriptSpec",
     "PythonCode",
     "PythonLibrary",
+    "RTD",
+    "Rust",
+    "RustPython",
     "UVProject",
 ]

src/projspec/proj/__init__.py

@@ -1,3 +1,5 @@
+import re
+
 from projspec.proj import ProjectSpec
 
 
@@ -18,5 +20,10 @@ class RTD(ProjectSpec):
 
     def match(self) -> bool:
         basenames = [_.rsplit("/", 1)[-1] for _ in self.root.filelist]
+        return any(re.match("[.]?readthedocs.y[a]?ml", _) for _ in basenames)
+
+    def parse(self) -> None:
         # supports mkdocs and sphinx builders
-        return ".readthedocs.yaml" in basenames
+        # build env usually in `python.install[*].requirements`, which can
+        # point to a requirements.txt or conda.environment for conda env.
+        pass

src/projspec/proj/documentation.py

@@ -132,8 +132,7 @@ def __contains__(self, item):
 
 
 def _yaml_no_jinja(fileobj):
-    # TODO: rather than skip jinja stuff, we can copy conda code to parse it, but
-    #  templates can involve function calls and reference to env vars we don't have
+    """Read YAML text from the given file, attempting to evaluate jinja2 templates."""
     txt = fileobj.read().decode()
     lines = []
     variables = {}
@@ -194,3 +193,13 @@ def flatten(x: Iterable):
             except TypeError:
                 out.add(item)
     return out
+
+
+def sort_version_strings(versions: Iterable[str]) -> list[str]:
+    def int_or(x):
+        try:
+            return int(x)
+        except ValueError:
+            return x
+
+    return sorted(versions, key=lambda s: [int_or(_) for _ in s.split(".")])