dirigent-cli 0.27.0__tar.gz → 0.27.1__tar.gz

{dirigent_cli-0.27.0 → dirigent_cli-0.27.1}/PKG-INFO

@@ -1,19 +1,19 @@
 Metadata-Version: 2.4
 Name: dirigent-cli
-Version: 0.27.0
+Version: 0.27.1
 Summary: The dirigent command line interface (dirigent / dg).
 License-Expression: LicenseRef-Proprietary
 License-File: LICENSE
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.13
-Requires-Dist: dirigent-block-execute==0.27.0
-Requires-Dist: dirigent-blocks==0.27.0
-Requires-Dist: dirigent-client==0.27.0
-Requires-Dist: dirigent-common==0.27.0
-Requires-Dist: dirigent-core==0.27.0
-Requires-Dist: dirigent-examples==0.27.0
-Requires-Dist: dirigent-plugin==0.27.0
-Requires-Dist: dirigent-server==0.27.0
+Requires-Dist: dirigent-block-execute==0.27.1
+Requires-Dist: dirigent-blocks==0.27.1
+Requires-Dist: dirigent-client==0.27.1
+Requires-Dist: dirigent-common==0.27.1
+Requires-Dist: dirigent-core==0.27.1
+Requires-Dist: dirigent-examples==0.27.1
+Requires-Dist: dirigent-plugin==0.27.1
+Requires-Dist: dirigent-server==0.27.1
 Requires-Dist: httpx2>=2.12.0
 Requires-Dist: python-dotenv>=1.1.0
 Requires-Dist: pyyaml>=6.0.3

{dirigent_cli-0.27.0 → dirigent_cli-0.27.1}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "dirigent-cli"
-version = "0.27.0"
+version = "0.27.1"
 description = "The dirigent command line interface (dirigent / dg)."
 readme = "README.md"
 requires-python = ">=3.13"
@@ -11,14 +11,14 @@ classifiers = [
     "Programming Language :: Python :: 3.13",
 ]
 dependencies = [
-    "dirigent-block-execute==0.27.0",
-    "dirigent-blocks==0.27.0",
-    "dirigent-client==0.27.0",
-    "dirigent-common==0.27.0",
-    "dirigent-core==0.27.0",
-    "dirigent-examples==0.27.0",
-    "dirigent-plugin==0.27.0",
-    "dirigent-server==0.27.0",
+    "dirigent-block-execute==0.27.1",
+    "dirigent-blocks==0.27.1",
+    "dirigent-client==0.27.1",
+    "dirigent-common==0.27.1",
+    "dirigent-core==0.27.1",
+    "dirigent-examples==0.27.1",
+    "dirigent-plugin==0.27.1",
+    "dirigent-server==0.27.1",
     "httpx2>=2.12.0",
     "python-dotenv>=1.1.0",
     "pyyaml>=6.0.3",

{dirigent_cli-0.27.0 → dirigent_cli-0.27.1}/pyproject.toml.orig

@@ -1,6 +1,6 @@
 [project]
 name = "dirigent-cli"
-version = "0.27.0"
+version = "0.27.1"
 description = "The dirigent command line interface (dirigent / dg)."
 readme = "README.md"
 requires-python = ">=3.13"
@@ -11,14 +11,14 @@ classifiers = [
     "Programming Language :: Python :: 3.13",
 ]
 dependencies = [
-    "dirigent-block-execute==0.27.0",
-    "dirigent-blocks==0.27.0",
-    "dirigent-client==0.27.0",
-    "dirigent-common==0.27.0",
-    "dirigent-core==0.27.0",
-    "dirigent-examples==0.27.0",
-    "dirigent-plugin==0.27.0",
-    "dirigent-server==0.27.0",
+    "dirigent-block-execute==0.27.1",
+    "dirigent-blocks==0.27.1",
+    "dirigent-client==0.27.1",
+    "dirigent-common==0.27.1",
+    "dirigent-core==0.27.1",
+    "dirigent-examples==0.27.1",
+    "dirigent-plugin==0.27.1",
+    "dirigent-server==0.27.1",
     "httpx2>=2.12.0",
     "python-dotenv>=1.1.0",
     "pyyaml>=6.0.3",

{dirigent_cli-0.27.0 → dirigent_cli-0.27.1}/src/dirigent_cli/commands.py

@@ -136,6 +136,7 @@ from dirigent_cli.sources import (
     SourceError,
     looks_like_a_document,
     parse_document,
+    read_directory,
     read_document,
     read_path,
 )
@@ -494,7 +495,9 @@ def export_command(
 
 def validate_command(
     ctx: typer.Context,
-    reference: Annotated[str | None, typer.Argument(help="A file, a URL, or - for standard input.")] = None,
+    reference: Annotated[
+        str | None, typer.Argument(help="A file, a directory of documents, a URL, or - for standard input.")
+    ] = None,
     server: Annotated[
         bool, typer.Option("--server", help="Also check it against a server's catalog and requirements.")
     ] = False,
@@ -511,12 +514,21 @@ def validate_command(
     pipelines it holds, the pipeline a triggers document names, and the parameters its
     schedules pin.
 
+    A directory is read at every depth, and each YAML or JSON file in it that declares a
+    `dirigent/` format is checked; the others are counted as skipped.
+
     `--explain` adds the shape of the work ahead for every pipeline document that is valid:
     the fan-out widths, the retry budgets and the waits. With `--server` too, a sensor that
     declares neither cadence nor deadline takes the block's own.
     """
     state = state_of(ctx)
-    documents = _documents_to_apply(reference, None)
+    skipped = 0
+    if reference is not None and Path(reference).is_dir():
+        documents, skipped = read_directory(Path(reference))
+        if not documents:
+            fail(PROJECT_IS_EMPTY, directory=reference)
+    else:
+        documents = _documents_to_apply(reference, None)
     failures = 0
     parsed: list[tuple[PipelineDefinition | TriggersDefinition, str]] = []
     for document in documents:
@@ -601,6 +613,7 @@ def validate_command(
         message="invalid" if failures else "valid",
         documents=len(documents),
         invalid=failures,
+        skipped=skipped,
     )
     if failures:
         raise typer.Exit(code=1)

{dirigent_cli-0.27.0 → dirigent_cli-0.27.1}/src/dirigent_cli/local.py

@@ -80,6 +80,7 @@ class ConnectionSpec(BaseModel):
     code: str
     name: str | None = None
     kind: str = "http"
+    description: str | None = None
     config: JsonMap = Field(default_factory=dict)
 
 
@@ -236,7 +237,16 @@ def connections_for(definitions: Sequence[PipelineDefinition], given: Sequence[C
     embedded: dict[str, ConnectionSpec] = {}
     for definition in definitions:
         for code, carried in definition.connections.items():
-            embedded.setdefault(code, ConnectionSpec(code=code, kind=carried.kind, config=carried.config))
+            embedded.setdefault(
+                code,
+                ConnectionSpec(
+                    code=code,
+                    name=carried.name,
+                    kind=carried.kind,
+                    description=carried.description,
+                    config=carried.config,
+                ),
+            )
     replaced = {spec.code for spec in given}
     return [spec for code, spec in embedded.items() if code not in replaced] + list(given)
 
@@ -349,6 +359,7 @@ async def _seed_connections(
                     code=spec.code,
                     name=spec.name,
                     kind=spec.kind,
+                    description=spec.description,
                     config=public,
                     secret_envelope=envelope,
                     secret_key_id=key_id,

{dirigent_cli-0.27.0 → dirigent_cli-0.27.1}/src/dirigent_cli/seeding.py

@@ -208,7 +208,9 @@ async def _connections(client: Dirigent, declared: Sequence[ConnectionSpec], ori
 async def _connection(client: Dirigent, spec: ConnectionSpec) -> str:
     """Store one connection and say whether it was new, letting a refusal through."""
     try:
-        await client.connections.create(spec.code, kind=spec.kind, config=spec.config, name=spec.name)
+        await client.connections.create(
+            spec.code, kind=spec.kind, config=spec.config, name=spec.name, description=spec.description
+        )
     except DirigentError:
         await client.connections.update(spec.code, config=spec.config)
         return "updated"

{dirigent_cli-0.27.0 → dirigent_cli-0.27.1}/src/dirigent_cli/sources.py

@@ -8,6 +8,7 @@ import httpx2
 import yaml
 from pydantic import BaseModel, ConfigDict
 
+from dirigent_cli.project import DOCUMENT_SUFFIXES
 from dirigent_client import DEFAULT_CONNECT_TIMEOUT
 from dirigent_client.enums import ProvenanceSource
 
@@ -71,6 +72,37 @@ def read_path(path: Path) -> Document:
     return Document(text=path.read_text(), source=ProvenanceSource.FILE, ref=str(path))
 
 
+def read_directory(directory: Path) -> tuple[list[Document], int]:
+    """Read every document under a directory, at any depth, and count the files that are not one.
+
+    A YAML or JSON file is a document when it declares a ``dirigent/`` format, or when it does
+    not parse at all, so a broken document is reported rather than passed over.
+    """
+    documents: list[Document] = []
+    skipped = 0
+    for path in sorted(directory.rglob("*")):
+        if not path.is_file() or path.suffix not in DOCUMENT_SUFFIXES:
+            continue
+        document = read_path(path)
+        if _declares_a_format(document.text):
+            documents.append(document)
+        else:
+            skipped += 1
+    return documents, skipped
+
+
+def _declares_a_format(text: str) -> bool:
+    """Whether a file names a dirigent format at its top, or cannot be read well enough to say."""
+    try:
+        parsed: object = yaml.safe_load(text)
+    except yaml.YAMLError:
+        return True
+    if not isinstance(parsed, dict):
+        return False
+    declared = cast("dict[str, Any]", parsed).get("format")
+    return isinstance(declared, str) and declared.startswith("dirigent/")
+
+
 def parse_document(document: Document) -> dict[str, Any]:
     """Parse a document's text, refusing what is plainly not a pipeline document, by name.