bijux-cli Python Package

bijux-cli-python is the Python distribution for installing and launching the Bijux bijux command through PyPI. It provides the Python launcher, native bridge, fallback facade, mounted-app SDK, and a process client for an independently installed bijux-dag executable.

Installing this wheel does not install the bijux-dag binary. The DAG helpers are clients of that binary; they are not an in-process workflow engine and do not define independent DAG semantics.

Install And Verify

python -m pip install bijux-cli
bijux --help
bijux doctor
python -m bijux_cli_py --help

The package is on the v0.4.1 release line and requires Python 3.11 or newer. The bijux console entrypoint and python -m bijux_cli_py resolve the same runtime contract.

Package Boundary

This package does not own maintainer commands, repository governance, a Python-only command schema, or a Python implementation of the DAG runtime.

Runtime Resolution

The Python launcher and DAG client resolve different executables:

Repository checkouts may resolve workspace binaries for development. Installed applications should treat PATH or the explicit override as the deployment contract, not depend on checkout discovery.

BIJUX_DAG_PY_SUBPROCESS_TIMEOUT controls the DAG process timeout. The selected binary defines available commands and release behavior.

DAG Workflow Client

Install the DAG executable separately before using dag_sdk:

cargo install bijux-dag-cli
bijux-dag version

from pathlib import Path

from bijux_cli_py import validate_dag_graph

result = validate_dag_graph(Path("workflow.dag.json"))

Use the DAG command surface for supported behavior and the release boundary before depending on a non-stable route.

Mounted Python Apps

bijux_cli_py.app_sdk builds mount descriptors and root-compatible result envelopes for Python applications. Discovery policy and route execution remain owned by the Rust bijux runtime.

from bijux_cli_py.app_sdk import build_python_mount_manifest

manifest = build_python_mount_manifest(
    namespace="sample",
    display_name="Sample App",
    module="sample_app.cli",
    function="main",
    summary="Sample mounted Python app",
)

The mounted app guide owns callable shape, compatibility checks, manifest placement, stream discipline, and packaging.

Source Map

The runtime implementations live outside this crate:

• crates/bijux-cli owns bijux command semantics.
• crates/bijux-dag-runtime owns DAG execution behavior.
• crates/bijux-dag-cli owns the thin bijux-dag executable boundary.

Failure Decisions

• Run bijux doctor when the installed bijux runtime cannot be resolved.
• Use dag_post_install_diagnostics() before offering DAG features from a Python application.
• Treat an unavailable bijux-dag executable as a deployment error.
• Treat invalid JSON from bijux-dag as a runtime contract failure, not a successful empty result.
• Preserve the original structured command failure for diagnosis.

Internal Documentation

• ARCHITECTURE.md: Rust/Python component boundaries, invocation paths, and semantic authorities.
• BINDINGS_AND_CONVERSIONS.md: native binding surface, bridge payloads, argument rules, and error mapping.
• CONTRACTS.md: package ownership, process boundaries, invariants, and failure behavior.
• MOUNTED_APPS.md: Python application descriptors, interpreter discovery, and stream discipline.
• PACKAGING_AND_COMPATIBILITY.md: wheel construction, entrypoint ownership, path precedence, and release verification.
• RUNTIME_SELECTION.md: native import policy, subprocess resolution, timeout, failure classification, and parity rules.

References

• Package contracts: docs/CONTRACTS.md
• Runtime crate: crates/bijux-cli
• DAG runtime crate: crates/bijux-dag-runtime
• DAG executable crate: crates/bijux-dag-cli
• Python bridge crate: crates/bijux-cli-python
• Mounted app guide: crates/bijux-cli-python/docs/MOUNTED_APPS.md
• Package changelog: crates/bijux-cli-python/CHANGELOG.md
• Repository handbook: CLI handbook

License

Apache-2.0 (repository LICENSE).