kaboo-workflows 0.9.0__tar.gz

kaboo_workflows-0.9.0/.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,124 @@
+name: Bug Report
+description: Report a bug in kaboo-workflows
+title: "[BUG] "
+labels: ["bug", "triage"]
+assignees: []
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for taking the time to fill out this bug report for kaboo-workflows!
+
+  - type: checkboxes
+    id: checks
+    attributes:
+      label: Checks
+      options:
+        - label: I have updated to the latest version of kaboo-workflows
+          required: true
+        - label: I have checked the documentation and this is not expected behavior
+          required: true
+        - label: I have searched [./issues](./issues?q=) and there are no duplicates of my issue
+          required: true
+
+  - type: input
+    id: compose-version
+    attributes:
+      label: kaboo-workflows Version
+      description: Which version of kaboo-workflows are you using?
+      placeholder: e.g., 0.1.0
+    validations:
+      required: true
+
+  - type: input
+    id: strands-version
+    attributes:
+      label: strands-agents Version
+      description: Which version of strands-agents are you using?
+      placeholder: e.g., 1.32.0
+    validations:
+      required: true
+
+  - type: input
+    id: python-version
+    attributes:
+      label: Python Version
+      description: Which version of Python are you using?
+      placeholder: e.g., 3.11.5
+    validations:
+      required: true
+
+  - type: input
+    id: os
+    attributes:
+      label: Operating System
+      description: Which operating system are you using?
+      placeholder: e.g., Ubuntu 22.04 / Windows 11 / macOS 14
+    validations:
+      required: true
+
+  - type: dropdown
+    id: installation-method
+    attributes:
+      label: Installation Method
+      description: How did you install kaboo-workflows?
+      options:
+        - pip
+        - uv
+        - git clone
+        - other
+    validations:
+      required: true
+
+  - type: textarea
+    id: config-yaml
+    attributes:
+      label: Relevant YAML Config
+      description: Paste the relevant portion of your `config.yaml` (remove any secrets)
+      render: yaml
+
+  - type: textarea
+    id: steps-to-reproduce
+    attributes:
+      label: Steps to Reproduce
+      description: Detailed steps to reproduce the behavior
+      placeholder: |
+        1. config.yaml and code snippet (minimal reproducible example)
+        2. Run the command...
+        3. See error...
+    validations:
+      required: true
+
+  - type: textarea
+    id: expected-behavior
+    attributes:
+      label: Expected Behavior
+      description: A clear description of what you expected to happen
+    validations:
+      required: true
+
+  - type: textarea
+    id: actual-behavior
+    attributes:
+      label: Actual Behavior
+      description: What actually happened — include full traceback if applicable
+    validations:
+      required: true
+
+  - type: textarea
+    id: additional-context
+    attributes:
+      label: Additional Context
+      description: Any other relevant information, logs, screenshots, etc.
+
+  - type: textarea
+    id: possible-solution
+    attributes:
+      label: Possible Solution
+      description: Optional — if you have suggestions on how to fix the bug
+
+  - type: input
+    id: related-issues
+    attributes:
+      label: Related Issues
+      description: Optional — link to related issues if applicable

kaboo_workflows-0.9.0/.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,8 @@
+blank_issues_enabled: false
+contact_links:
+  - name: kaboo-workflows Discussions
+    url: https://github.com/gl-pgege/kaboo-workflows/discussions
+    about: Please ask and answer questions here
+  - name: kaboo-workflows Documentation
+    url: https://gl-pgege.github.io/kaboo-workflows/
+    about: Visit the documentation for help

kaboo_workflows-0.9.0/.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,46 @@
+name: Feature Request
+description: Suggest a new feature or enhancement for kaboo-workflows
+title: "[FEATURE] "
+labels: ["enhancement", "triage"]
+assignees: []
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for suggesting a new feature for kaboo-workflows!
+
+  - type: textarea
+    id: problem-statement
+    attributes:
+      label: Problem Statement
+      description: Describe the problem you're trying to solve. What is currently difficult or impossible to do?
+      placeholder: I would like kaboo-workflows to...
+    validations:
+      required: true
+
+  - type: textarea
+    id: proposed-solution
+    attributes:
+      label: Proposed Solution
+      description: Optional — describe your proposed solution. How would this feature work? Include example YAML or Python if helpful.
+
+  - type: textarea
+    id: use-case
+    attributes:
+      label: Use Case
+      description: Provide specific use cases for the feature. How would people use it?
+      placeholder: This would help with...
+    validations:
+      required: true
+
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: Alternatives Considered
+      description: Optional — have you considered alternative approaches? What are their pros and cons?
+
+  - type: textarea
+    id: additional-context
+    attributes:
+      label: Additional Context
+      description: Any other context, screenshots, code examples, or references that might help understand the request.

kaboo_workflows-0.9.0/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,45 @@
+## Description
+
+<!-- Provide a detailed description of the changes in this PR -->
+
+## Related Issues
+
+<!-- Link to related issues using #issue-number format -->
+
+## Type of Change
+
+<!-- Choose one and delete the rest -->
+
+- Bug fix
+- New feature
+- Breaking change
+- Documentation update
+- Other (please describe):
+
+## YAML / API Impact
+
+<!-- Does this change affect the config schema or the public Python API?
+     If yes, describe what changes and whether it's backwards-compatible. -->
+
+## Testing
+
+How have you tested the change?
+
+- [ ] I ran `uv run just check` (lint + type check)
+- [ ] I ran `uv run just test` for overall testing
+- [ ] I ran `uv run just test-docs` and `uv run mkdocs build --strict`
+- [ ] I added or updated tests that prove my fix is effective or my feature works
+- [ ] New public symbols have a docstring + an autodoc page (`docs/api/`)
+- [ ] I verified existing examples in `examples/` still work
+- [ ] I regenerated `llms.txt` / `llms-full.txt` if docs changed (`uv run just docs-llms`)
+
+## Checklist
+
+- [ ] I have read the [CONTRIBUTING](CONTRIBUTING.md) document
+- [ ] I have updated the documentation accordingly
+- [ ] My changes generate no new warnings
+- [ ] Any dependent changes have been merged and published
+
+---
+
+By submitting this pull request, I confirm that you can use, modify, copy, and redistribute this contribution, under the terms of your choice.

kaboo_workflows-0.9.0/.github/dependabot.yml

@@ -0,0 +1,20 @@
+version: 2
+updates:
+  - package-ecosystem: "pip"
+    directory: "/"
+    schedule:
+      interval: "daily"
+    open-pull-requests-limit: 100
+    commit-message:
+      prefix: ci
+    groups:
+      dev-dependencies:
+        patterns:
+          - "pytest"
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "daily"
+    open-pull-requests-limit: 100
+    commit-message:
+      prefix: ci

kaboo_workflows-0.9.0/.github/workflows/ci.yml

@@ -0,0 +1,93 @@
+# Continuous Integration — runs on every push and pull request.
+
+name: CI
+
+on:
+  push:
+    branches: ["main"]
+  pull_request:
+    branches: ["main"]
+  workflow_call:
+
+concurrency:
+  group: ci-${{ github.ref }}
+  cancel-in-progress: true
+
+permissions:
+  contents: read
+
+jobs:
+  # ── Quality checks (format · lint · type · security) ──────────────────────
+  check:
+    name: Quality checks
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+    steps:
+      - uses: actions/checkout@v7
+
+      - uses: astral-sh/setup-uv@v8.2.0
+        with:
+          enable-cache: true
+
+      - name: Install dev deps
+        run: uv sync --all-groups --all-extras
+
+      - name: Ruff — format check
+        run: uv run just check-format-ci
+
+      - name: Ruff — lint
+        run: uv run just check-code
+
+      - name: ty — type check
+        run: uv run just check-type
+
+      - name: Bandit — security scan
+        run: uv run just check-security
+
+  # ── Tests ──────────────────────────────────────────────────────────────────
+  test:
+    name: Tests (Python ${{ matrix.python-version }}, ${{ matrix.os }})
+    runs-on: ${{ matrix.os }}
+    permissions:
+      contents: read
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, windows-latest]
+        python-version: ["3.12", "3.13"]
+    steps:
+      - uses: actions/checkout@v7
+
+      - uses: astral-sh/setup-uv@v8.2.0
+        with:
+          enable-cache: true
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install dev deps
+        run: uv sync --all-groups --all-extras
+
+      - name: pytest with coverage
+        run: uv run just test
+
+  # ── Docs (proven snippets + strict site build) ──────────────────────────────
+  docs:
+    name: Docs
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+    steps:
+      - uses: actions/checkout@v7
+
+      - uses: astral-sh/setup-uv@v8.2.0
+        with:
+          enable-cache: true
+
+      - name: Install deps (dev + docs)
+        run: uv sync --all-groups --all-extras
+
+      - name: Execute doc snippets
+        run: uv run just test-docs
+
+      - name: Build docs (strict) + render sanity check
+        run: uv run just docs-check-render

kaboo_workflows-0.9.0/.github/workflows/pages.yml

@@ -0,0 +1,49 @@
+# Build and deploy the MkDocs Material site to GitHub Pages.
+#
+# One-time manual step (a maintainer must do this once; the workflow cannot
+# self-enable Pages): repo Settings -> Pages -> Source = "GitHub Actions".
+name: Pages
+
+on:
+  push:
+    branches: ["main"]
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: pages
+  cancel-in-progress: true
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v7
+
+      - uses: astral-sh/setup-uv@v8.2.0
+        with:
+          enable-cache: true
+
+      - name: Install docs dependencies
+        run: uv sync --group docs
+
+      - name: Build (strict)
+        run: uv run mkdocs build --strict
+
+      - uses: actions/upload-pages-artifact@v3
+        with:
+          path: site
+
+  deploy:
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    steps:
+      - id: deployment
+        uses: actions/deploy-pages@v4

kaboo_workflows-0.9.0/.github/workflows/publish.yml

@@ -0,0 +1,123 @@
+# Publish to PyPI — triggered by pushing a version tag (v*.*.*).
+# Uses Trusted Publishing (OIDC — no API tokens required).
+#
+# One-time setup on PyPI:
+#   1. Create a project for "kaboo-workflows" at https://pypi.org/manage/account/publishing/
+#   2. Configure Trusted Publisher:
+#     - Owner:       gl-pgege
+#     - Repository:  kaboo-workflows
+#     - Workflow:    publish.yml
+#     - Environment: release
+
+name: Publish
+
+on:
+  push:
+    tags:
+      - "v[0-9]+.[0-9]+.[0-9]+"
+      - "v[0-9]+.[0-9]+.[0-9]+.post*"
+      - "v[0-9]+.[0-9]+.[0-9]+rc*"
+
+permissions:
+  contents: read
+
+jobs:
+  # ── Gate: run CI checks before publishing ─────────────────────────────────
+  ci:
+    uses: ./.github/workflows/ci.yml
+    permissions:
+      contents: read
+
+  # ── Build distribution package ────────────────────────────────────────────
+  # Pure Python package — one wheel (py3-none-any) runs on every OS and arch.
+  # No need for cibuildwheel or a platform matrix.
+  build:
+    name: Build
+    needs: ci
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+    steps:
+      - uses: actions/checkout@v7
+
+      - uses: astral-sh/setup-uv@v8.2.0
+        with:
+          enable-cache: true
+
+      - name: Build wheel + sdist
+        run: uv build --out-dir dist/
+
+      - name: Upload build artifacts
+        uses: actions/upload-artifact@v7
+        with:
+          name: dist
+          path: dist/
+          if-no-files-found: error
+
+  # ── Publish to PyPI ───────────────────────────────────────────────────────
+  publish:
+    name: Publish to PyPI
+    needs: build
+    runs-on: ubuntu-latest
+    environment: release
+    permissions:
+      id-token: write
+    steps:
+      - name: Download build artifacts
+        uses: actions/download-artifact@v8
+        with:
+          name: dist
+          path: dist/
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          packages-dir: dist/
+
+  # ── Create GitHub Release with CHANGELOG notes ────────────────────────────
+  github-release:
+    name: GitHub Release
+    needs: publish
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    steps:
+      - uses: actions/checkout@v7
+        with:
+          fetch-depth: 0
+
+      - uses: actions/setup-python@v6
+        with:
+          python-version: "3.x"
+
+      - name: Extract changelog for this version
+        id: changelog
+        run: |
+          VERSION="${GITHUB_REF_NAME#v}"
+          NOTES=$(python -c "
+          import re, pathlib
+          text = pathlib.Path('CHANGELOG.md').read_text()
+          match = re.search(
+              r'(?:^|\n)(## v?' + re.escape('$VERSION') + r'[^\n]*\n.*?)(?=\n## |\Z)',
+              text, re.DOTALL
+          )
+          print(match.group(1).strip() if match else 'See CHANGELOG.md for details.')
+          " VERSION="$VERSION")
+          {
+            echo 'notes<<EOF'
+            echo "$NOTES"
+            echo EOF
+          } >> "$GITHUB_OUTPUT"
+
+      - name: Download all artifacts
+        uses: actions/download-artifact@v8
+        with:
+          path: dist-all/
+          merge-multiple: true
+
+      - name: Create GitHub Release
+        uses: softprops/action-gh-release@v3
+        with:
+          body: ${{ steps.changelog.outputs.notes }}
+          files: dist-all/**/*
+          prerelease: ${{ contains(github.ref_name, 'rc') || contains(github.ref_name, 'alpha') || contains(github.ref_name, 'beta') }}

kaboo_workflows-0.9.0/.gitignore

@@ -0,0 +1,63 @@
+.env
+.claude
+.kiro/specs
+.sessions
+.converter
+.hypothesis
+
+# Ignore Python cache and compiled files
+__pycache__/
+*.py[cod]
+*.pyo
+*.pyd
+.ruff_cache
+
+# Ignore virtual environments
+venv/
+env/
+.venv/
+.env/
+
+# Ignore Jupyter Notebook checkpoints
+.ipynb_checkpoints/
+
+# Existing rules
+python/*
+.req.txt
+*.egg-info/
+dist/
+build/
+requirements.txt
+*.log
+.logs/
+
+# Pytest cache
+.pytest_cache/
+.coverage*
+htmlcov/
+.tox/
+.nox/
+
+# VS Code settings
+.vscode/
+
+# Visual Studio files
+*.user
+*.suo
+*.userosscache
+*.sln.docstates
+
+# JetBrains IDEs (PyCharm, IntelliJ, etc.)
+.idea/
+*.iml
+
+# Sublime Text
+*.sublime-workspace
+*.sublime-project
+
+# MacOS and Windows system files
+.DS_Store
+Thumbs.db
+
+# MkDocs site build output
+/site/