camas 0.1.0__tar.gz

camas-0.1.0/.github/workflows/ci.yaml

@@ -0,0 +1,64 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+    tags: ["*"]
+  pull_request:
+  workflow_dispatch:
+
+jobs:
+  check:
+    strategy:
+      matrix:
+        os: [ubuntu-latest, ubuntu-24.04-arm, macos-latest, windows-latest]
+      fail-fast: false
+    runs-on: ${{ matrix.os }}
+    steps:
+      - uses: actions/checkout@v5
+        with:
+          fetch-depth: 0
+
+      - uses: astral-sh/setup-uv@v6
+
+      - run: uv run camas matrix --effects='(Summary(SummaryOptions(Fixed(120))),)'
+
+      - run: uv build
+
+      - uses: actions/upload-artifact@v4
+        with:
+          name: dist-${{ matrix.os }}
+          path: |
+            dist/*.tar.gz
+            dist/*.whl
+
+  coverage:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v5
+        with:
+          fetch-depth: 0
+
+      - uses: astral-sh/setup-uv@v6
+
+      - run: uv run camas coverage --effects='(Summary(),)'
+
+  publish:
+    if: startsWith(github.ref, 'refs/tags/')
+    needs: [check, coverage]
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/p/camas
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - uses: astral-sh/setup-uv@v6
+
+      - run: uv build
+
+      - uses: pypa/gh-action-pypi-publish@release/v1

camas-0.1.0/.gitignore

@@ -0,0 +1,3 @@
+__pycache__
+.coverage
+.venv*

camas-0.1.0/.python-version

@@ -0,0 +1,3 @@
+3.14
+3.13
+3.12

camas-0.1.0/.vscode/extensions.json

@@ -0,0 +1,7 @@
+{
+	"recommendations": [
+		"ms-python.python",
+		"charliermarsh.ruff",
+		"ms-python.mypy-type-checker"
+	]
+}

camas-0.1.0/.vscode/settings.json

@@ -0,0 +1,13 @@
+{
+	"[python]": {
+		"editor.formatOnSave": true,
+		"editor.defaultFormatter": "charliermarsh.ruff",
+		"editor.codeActionsOnSave": {
+			"source.organizeImports": "always"
+		}
+	},
+	"flake8.enabled": false,
+	"ruff.enable": true,
+	"ruff.lint.enable": true,
+	"mypy-type-checker.importStrategy": "fromEnvironment"
+}

camas-0.1.0/CODE_OF_CONDUCT.md

@@ -0,0 +1,128 @@
+# Contributor Covenant Code of Conduct
+
+## Our Pledge
+
+We as members, contributors, and leaders pledge to make participation in our
+community a harassment-free experience for everyone, regardless of age, body
+size, visible or invisible disability, ethnicity, sex characteristics, gender
+identity and expression, level of experience, education, socio-economic status,
+nationality, personal appearance, race, religion, or sexual identity
+and orientation.
+
+We pledge to act and interact in ways that contribute to an open, welcoming,
+diverse, inclusive, and healthy community.
+
+## Our Standards
+
+Examples of behavior that contributes to a positive environment for our
+community include:
+
+* Demonstrating empathy and kindness toward other people
+* Being respectful of differing opinions, viewpoints, and experiences
+* Giving and gracefully accepting constructive feedback
+* Accepting responsibility and apologizing to those affected by our mistakes,
+  and learning from the experience
+* Focusing on what is best not just for us as individuals, but for the
+  overall community
+
+Examples of unacceptable behavior include:
+
+* The use of sexualized language or imagery, and sexual attention or
+  advances of any kind
+* Trolling, insulting or derogatory comments, and personal or political attacks
+* Public or private harassment
+* Publishing others' private information, such as a physical or email
+  address, without their explicit permission
+* Other conduct which could reasonably be considered inappropriate in a
+  professional setting
+
+## Enforcement Responsibilities
+
+Community leaders are responsible for clarifying and enforcing our standards of
+acceptable behavior and will take appropriate and fair corrective action in
+response to any behavior that they deem inappropriate, threatening, offensive,
+or harmful.
+
+Community leaders have the right and responsibility to remove, edit, or reject
+comments, commits, code, wiki edits, issues, and other contributions that are
+not aligned to this Code of Conduct, and will communicate reasons for moderation
+decisions when appropriate.
+
+## Scope
+
+This Code of Conduct applies within all community spaces, and also applies when
+an individual is officially representing the community in public spaces.
+Examples of representing our community include using an official e-mail address,
+posting via an official social media account, or acting as an appointed
+representative at an online or offline event.
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be
+reported to the community leaders responsible for enforcement at
+jphutchins@gmail.com.
+All complaints will be reviewed and investigated promptly and fairly.
+
+All community leaders are obligated to respect the privacy and security of the
+reporter of any incident.
+
+## Enforcement Guidelines
+
+Community leaders will follow these Community Impact Guidelines in determining
+the consequences for any action they deem in violation of this Code of Conduct:
+
+### 1. Correction
+
+**Community Impact**: Use of inappropriate language or other behavior deemed
+unprofessional or unwelcome in the community.
+
+**Consequence**: A private, written warning from community leaders, providing
+clarity around the nature of the violation and an explanation of why the
+behavior was inappropriate. A public apology may be requested.
+
+### 2. Warning
+
+**Community Impact**: A violation through a single incident or series
+of actions.
+
+**Consequence**: A warning with consequences for continued behavior. No
+interaction with the people involved, including unsolicited interaction with
+those enforcing the Code of Conduct, for a specified period of time. This
+includes avoiding interactions in community spaces as well as external channels
+like social media. Violating these terms may lead to a temporary or
+permanent ban.
+
+### 3. Temporary Ban
+
+**Community Impact**: A serious violation of community standards, including
+sustained inappropriate behavior.
+
+**Consequence**: A temporary ban from any sort of interaction or public
+communication with the community for a specified period of time. No public or
+private interaction with the people involved, including unsolicited interaction
+with those enforcing the Code of Conduct, is allowed during this period.
+Violating these terms may lead to a permanent ban.
+
+### 4. Permanent Ban
+
+**Community Impact**: Demonstrating a pattern of violation of community
+standards, including sustained inappropriate behavior,  harassment of an
+individual, or aggression toward or disparagement of classes of individuals.
+
+**Consequence**: A permanent ban from any sort of public interaction within
+the community.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant][homepage],
+version 2.0, available at
+https://www.contributor-covenant.org/version/2/0/code_of_conduct.html.
+
+Community Impact Guidelines were inspired by [Mozilla's code of conduct
+enforcement ladder](https://github.com/mozilla/diversity).
+
+[homepage]: https://www.contributor-covenant.org
+
+For answers to common questions about this code of conduct, see the FAQ at
+https://www.contributor-covenant.org/faq. Translations are available at
+https://www.contributor-covenant.org/translations.

camas-0.1.0/CONTRIBUTING.md

@@ -0,0 +1,37 @@
+# Camas
+
+Contributions and bug reports are welcome!
+
+> [!IMPORTANT]
+> ### First time setup
+>
+> - Install [uv](https://github.com/astral-sh/uv)
+> - Initialize the environment:
+>   ```
+>   uv sync --locked --all-extras --all-packages --dev
+>   ```
+
+### Formatting
+```
+uv run task format
+```
+> [!NOTE]
+> VSCode is setup to do this for you on save - feel free to add more editors.
+
+### Linting
+```
+uv run task lint
+```
+> [!NOTE]
+> VSCode is setup to to run these LSPs in the background - feel free to add more
+> editors.
+
+### Tests
+```
+uv run task test
+```
+
+### All
+```
+uv run task all
+```

camas-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 JP Hutchins
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

camas-0.1.0/PKG-INFO

@@ -0,0 +1,98 @@
+Metadata-Version: 2.4
+Name: camas
+Version: 0.1.0
+Summary: Generic parallel/sequential task runner with TUI output
+Project-URL: Homepage, https://github.com/JPHutchins/camas
+Project-URL: Repository, https://github.com/JPHutchins/camas
+Project-URL: Issues, https://github.com/JPHutchins/camas/issues
+Author-email: JP Hutchins <jp@intercreate.io>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: async,parallel,sequential,task-runner,tui
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Software Development :: Build Tools
+Classifier: Typing :: Typed
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+
+# Camas
+
+Generic parallel/sequential task runner with a live tree-style TUI.
+
+[![CI](https://github.com/JPHutchins/camas/actions/workflows/ci.yaml/badge.svg)](https://github.com/JPHutchins/camas/actions/workflows/ci.yaml)
+
+## Install
+
+```
+uv add camas
+```
+
+or
+
+```
+pip install camas
+```
+
+## Quick start
+
+Camas takes a typed Python expression describing a tree of `Task`, `Sequential`,
+and `Parallel` nodes and runs it, streaming progress into a live tree in your
+terminal.
+
+Run two checks in parallel:
+```
+python -m camas 'Parallel(tasks=(Task("ruff check ."), Task("mypy .")))'
+```
+
+A typical CI pipeline — format-check, then checks in parallel, then tests:
+```
+python -m camas 'Sequential(tasks=(
+    Task("ruff format . --check"),
+    Parallel(tasks=(Task("mypy ."), Task("pyright ."))),
+    Task("pytest"),
+))'
+```
+
+Run one task across a matrix of Python versions in parallel:
+```
+python -m camas 'Parallel(
+    tasks=(Task("pytest --python {PY}"),),
+    matrix={"PY": ("3.12", "3.13", "3.14")},
+)'
+```
+
+Use `--dry-run` to print the task tree without executing it.
+
+## Library
+
+The same building blocks are available as a library:
+
+```python
+import asyncio
+from camas import Parallel, Sequential, Task, run
+from camas.effect.termtree import Termtree, TermtreeOptions
+
+task = Sequential(tasks=(
+    Task("ruff format . --check"),
+    Parallel(tasks=(Task("mypy ."), Task("pyright ."))),
+    Task("pytest"),
+))
+
+result = asyncio.run(run(task, effects=(Termtree(TermtreeOptions()),)))
+raise SystemExit(result.returncode)
+```
+
+`Task`, `Sequential`, and `Parallel` are immutable `NamedTuple` values. A
+`Sequential` short-circuits on the first non-zero exit; a `Parallel` runs its
+children concurrently. Both accept an optional `matrix` mapping for variable
+expansion in task commands, names, and environments.
+
+## License
+
+[MIT](LICENSE)

camas-0.1.0/README.md

@@ -0,0 +1,75 @@
+# Camas
+
+Generic parallel/sequential task runner with a live tree-style TUI.
+
+[![CI](https://github.com/JPHutchins/camas/actions/workflows/ci.yaml/badge.svg)](https://github.com/JPHutchins/camas/actions/workflows/ci.yaml)
+
+## Install
+
+```
+uv add camas
+```
+
+or
+
+```
+pip install camas
+```
+
+## Quick start
+
+Camas takes a typed Python expression describing a tree of `Task`, `Sequential`,
+and `Parallel` nodes and runs it, streaming progress into a live tree in your
+terminal.
+
+Run two checks in parallel:
+```
+python -m camas 'Parallel(tasks=(Task("ruff check ."), Task("mypy .")))'
+```
+
+A typical CI pipeline — format-check, then checks in parallel, then tests:
+```
+python -m camas 'Sequential(tasks=(
+    Task("ruff format . --check"),
+    Parallel(tasks=(Task("mypy ."), Task("pyright ."))),
+    Task("pytest"),
+))'
+```
+
+Run one task across a matrix of Python versions in parallel:
+```
+python -m camas 'Parallel(
+    tasks=(Task("pytest --python {PY}"),),
+    matrix={"PY": ("3.12", "3.13", "3.14")},
+)'
+```
+
+Use `--dry-run` to print the task tree without executing it.
+
+## Library
+
+The same building blocks are available as a library:
+
+```python
+import asyncio
+from camas import Parallel, Sequential, Task, run
+from camas.effect.termtree import Termtree, TermtreeOptions
+
+task = Sequential(tasks=(
+    Task("ruff format . --check"),
+    Parallel(tasks=(Task("mypy ."), Task("pyright ."))),
+    Task("pytest"),
+))
+
+result = asyncio.run(run(task, effects=(Termtree(TermtreeOptions()),)))
+raise SystemExit(result.returncode)
+```
+
+`Task`, `Sequential`, and `Parallel` are immutable `NamedTuple` values. A
+`Sequential` short-circuits on the first non-zero exit; a `Parallel` runs its
+children concurrently. Both accept an optional `matrix` mapping for variable
+expansion in task commands, names, and environments.
+
+## License
+
+[MIT](LICENSE)

camas-0.1.0/check.py

@@ -0,0 +1,57 @@
+"""camas task definitions for this project.
+
+Run directly with ``python check.py <task>``. Every module-level
+``Task``/``Sequential``/``Parallel`` becomes an invokable task by its binding
+name. Private names (leading ``_``) are skipped.
+"""
+
+from camas import Parallel, Sequential, Task
+from camas.main import run_cli
+
+format = Task("uv run ruff format .")
+format_check = Task("uv run ruff format --check .")
+lint = Task("uv run ruff check .")
+mypy = Task("uv run mypy .")
+ty = Task("uv run ty check")
+zuban = Task("uv run zuban check")
+pyrefly = Task("uv run pyrefly check")
+pyright = Task("uv run pyright src tests")
+
+typecheck = Parallel(tasks=(mypy, pyright, ty, zuban, pyrefly))
+test = Task("uv run pytest --doctest-modules -v -m 'not slow'")
+coverage = Task("uv run pytest --doctest-modules -m 'not slow' --cov --cov-report=term-missing")
+
+all = Sequential(
+	tasks=(
+		format,
+		Parallel(tasks=(lint, typecheck, test)),
+	)
+)
+
+check = Sequential(
+	tasks=(
+		format_check,
+		Parallel(tasks=(lint, typecheck, test)),
+	)
+)
+
+venvs = Parallel(
+	tasks=(
+		Sequential(
+			tasks=(
+				Task("uv venv --python {PY} .venv-{PY}"),
+				Task("uv sync", env={"UV_PROJECT_ENVIRONMENT": ".venv-{PY}"}),
+			)
+		),
+	),
+	matrix={"PY": ("3.12", "3.13", "3.14")},
+)
+
+matrix = Parallel(
+	tasks=(check,),
+	matrix={"UV_PROJECT_ENVIRONMENT": (".venv-3.12", ".venv-3.13", ".venv-3.14")},
+)
+
+
+if __name__ == "__main__":
+	run_cli(globals())

camas-0.1.0/pyproject.toml

@@ -0,0 +1,121 @@
+[project]
+name = "camas"
+description = "Generic parallel/sequential task runner with TUI output"
+readme = "README.md"
+license = "MIT"
+authors = [{ name = "JP Hutchins", email = "jp@intercreate.io" }]
+requires-python = ">=3.12"
+dependencies = []
+dynamic = ["version"]
+keywords = ["task-runner", "parallel", "sequential", "tui", "async"]
+classifiers = [
+"Development Status :: 3 - Alpha",
+"Intended Audience :: Developers",
+"License :: OSI Approved :: MIT License",
+"Programming Language :: Python :: 3",
+"Programming Language :: Python :: 3.12",
+"Programming Language :: Python :: 3.13",
+"Programming Language :: Python :: 3.14",
+"Topic :: Software Development :: Build Tools",
+"Typing :: Typed",
+]
+
+[project.urls]
+Homepage = "https://github.com/JPHutchins/camas"
+Repository = "https://github.com/JPHutchins/camas"
+Issues = "https://github.com/JPHutchins/camas/issues"
+
+[project.scripts]
+camas = "camas.main:main"
+
+[build-system]
+requires = ["hatchling", "hatch-vcs"]
+build-backend = "hatchling.build"
+
+[tool.hatch.version]
+source = "vcs"
+
+[dependency-groups]
+dev = [
+"mypy>=1.19",
+"pyright>=1.1.408",
+"pytest>=9,<10",
+"pytest-cov>=7.0.0",
+"cyclopts>=4,<5",
+"ruff>=0.12.0",
+"ty>=0.0.31,<1",
+"zuban>=0.7,<1",
+"pyrefly>=0.61,<1",
+]
+
+[tool.camas.tasks]
+format = "uv run ruff format ."
+lint = "uv run ruff check ."
+mypy = "uv run mypy ."
+ty = "uv run ty check"
+zuban = "uv run zuban check"
+pyrefly = "uv run pyrefly check"
+pyright = "uv run pyright src tests"
+typecheck = "Parallel(tasks=(mypy, pyright, ty, zuban, pyrefly))"
+test = "pytest --doctest-modules -v -m 'not slow'"
+coverage = "pytest --doctest-modules -m 'not slow' --cov --cov-report=term-missing"
+all = '''
+Sequential(tasks=(
+    format,
+    Parallel(tasks=(lint, typecheck, test)),
+))
+'''
+matrix = '''
+Parallel(
+    tasks=(all,),
+    matrix={"UV_PROJECT_ENVIRONMENT": (
+		".venv-3.12",
+		".venv-3.13",
+		".venv-3.14"
+	)},
+)
+'''
+
+[tool.pytest.ini_options]
+testpaths = ["src", "tests"]
+markers = ["slow: visual demo tests with real delays"]
+
+[tool.ruff]
+line-length = 100
+
+[tool.ruff.lint]
+extend-select = ["I"]
+
+[tool.ruff.format]
+indent-style = "tab"
+
+[tool.mypy]
+strict = true
+warn_unused_ignores = true
+
+[tool.pyright]
+typeCheckingMode = "strict"
+include = ["src", "tests"]
+
+[tool.coverage.run]
+source = ["camas", "tests"]
+branch = true
+omit = ["tests/test_demos.py", "src/camas/__main__.py"]
+
+[tool.coverage.report]
+fail_under = 100
+partial_branches = ["pragma: no branch", "case LeafInfo", "case Waiting"]
+exclude_also = ["async for .* in proc\\.stdout"]
+exclude_lines = [
+"@overload",
+"assert_never",
+"case _:",
+"pragma: no cover",
+"if __name__ == .__main__.:",
+"if TYPE_CHECKING",
+':\s*\.\.\.\s*$',
+'^\s*\.\.\.\s*$',
+"raise AssertionError",
+"@pytest.mark.slow",
+"@app.command",
+]