pydagu 0.2.2__tar.gz

pydagu-0.2.2/.github/workflows/publish.yml

@@ -0,0 +1,35 @@
+name: Publish to PyPI
+
+on:
+  release:
+    types: [published]
+
+jobs:
+  build-and-publish:
+    runs-on: ubuntu-latest
+    permissions:
+      id-token: write  # Required for trusted publishing
+
+    steps:
+    - uses: actions/checkout@v4
+
+    - name: Set up Python
+      uses: actions/setup-python@v5
+      with:
+        python-version: "3.13"
+
+    - name: Install build tools
+      run: |
+        python -m pip install --upgrade pip
+        pip install build twine
+
+    - name: Build package
+      run: python -m build
+
+    - name: Check package
+      run: twine check dist/*
+
+    - name: Publish to PyPI
+      uses: pypa/gh-action-pypi-publish@release/v1
+      with:
+        verbose: true

pydagu-0.2.2/.github/workflows/test.yml

@@ -0,0 +1,71 @@
+name: Tests
+
+on:
+  push:
+    branches: [ main, master ]
+  pull_request:
+    branches: [ main, master ]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.13"]
+
+    steps:
+    - uses: actions/checkout@v4
+
+    - name: Set up Python ${{ matrix.python-version }}
+      uses: actions/setup-python@v5
+      with:
+        python-version: ${{ matrix.python-version }}
+
+    - name: Install Dagu
+      run: |
+        # Install Dagu using official installer script
+        curl -L https://raw.githubusercontent.com/dagu-org/dagu/main/scripts/installer.sh | bash
+
+        # Add to PATH for this session
+        echo "$HOME/.local/bin" >> $GITHUB_PATH
+
+        # Verify installation
+        $HOME/.local/bin/dagu version
+
+    - name: Start Dagu server
+      run: |
+        # Start Dagu server in the background
+        $HOME/.local/bin/dagu server --host 0.0.0.0 --port 8080 &
+
+        # Wait for server to be ready
+        echo "Waiting for Dagu server to start..."
+        for i in {1..30}; do
+          if curl -s http://localhost:8080/api/v2/dags > /dev/null 2>&1; then
+            echo "Dagu server is ready!"
+            break
+          fi
+          echo "Attempt $i: Server not ready yet..."
+          sleep 2
+        done
+
+        # Verify server is running
+        curl -f http://localhost:8080/api/v2/dags || (echo "Failed to connect to Dagu server" && exit 1)
+
+    - name: Install dependencies
+      run: |
+        python -m pip install --upgrade pip
+        pip install -e ".[dev]"
+
+        # Verify pytest is available
+        pytest --version
+
+    - name: Run tests
+      run: |
+        pytest tests/ -v --cov=pydagu --cov-report=xml --cov-report=term
+
+    - name: Upload coverage to Codecov
+      uses: codecov/codecov-action@v4
+      if: matrix.python-version == '3.13'
+      with:
+        file: ./coverage.xml
+        fail_ci_if_error: false

pydagu-0.2.2/.gitignore

@@ -0,0 +1,13 @@
+# Python-generated files
+__pycache__/
+*.py[oc]
+build/
+dist/
+wheels/
+*.egg-info
+
+# Virtual environments
+.venv
+.hypothesis
+.python-version
+.coverage

pydagu-0.2.2/.importlinter

@@ -0,0 +1,10 @@
+[importlinter]
+root_package = pydagu
+
+[importlinter:contract:one]
+name = Three-tier layers contract
+type = layers
+layers =
+    pydagu.http
+    pydagu.builder
+    pydagu.models

pydagu-0.2.2/.pre-commit-config.yaml

@@ -0,0 +1,37 @@
+# See https://pre-commit.com for more information
+# See https://pre-commit.com/hooks.html for more hooks
+repos:
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v6.0.0
+    hooks:
+      - id: trailing-whitespace
+      - id: end-of-file-fixer
+      - id: check-yaml
+      - id: check-added-large-files
+
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.14.3
+    hooks:
+      - id: ruff-check
+        args: [--fix]
+      - id: ruff-format
+
+  - repo: https://github.com/PyCQA/bandit
+    rev: 1.8.6
+    hooks:
+      - id: bandit
+        args: [-ll, pydagu]
+
+  - repo: local
+    hooks:
+      - id: lint_imports
+        name: "Lint imports"
+        entry: ".venv/bin/lint-imports" # Adapt with custom arguments, if need be.
+        language: system
+        pass_filenames: false
+      - id: mypy-strict
+        name: "MyPy strict type checking"
+        entry: .venv/bin/mypy --strict pydagu/
+        language: system
+        pass_filenames: false
+        types: [python]

pydagu-0.2.2/.vscode/settings.json

@@ -0,0 +1,8 @@
+{
+    "files.exclude": {
+        ".venv": true,
+        ".vscode": true,
+        "**/__pycache__": true
+    },
+    "editor.formatOnSave": true
+}

pydagu-0.2.2/CHANGELOG.md

@@ -0,0 +1,34 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+## [0.1.0] - 2025-01-08
+
+### Added
+- Initial release of pydagu
+- `DagBuilder` and `StepBuilder` for fluent DAG construction
+- `DaguHttpClient` for interacting with Dagu HTTP API
+- Pydantic models for type-safe DAG definitions
+- HTTP executor support with retry policies
+- Webhook integration patterns and examples
+- Comprehensive test suite (6 HTTP tests, 95%+ coverage)
+- Support for Python 3.11, 3.12, and 3.13
+
+### Features
+- Type-safe DAG creation with validation
+- HTTP executor with headers, body, timeout, and retry configuration
+- Automatic JSON body serialization
+- Step dependencies and output capture
+- Parameter and environment variable support
+- Flask/Django/FastAPI webhook integration examples
+
+### Documentation
+- Complete README with quick start guide
+- Webhook integration examples with WebhookManager
+- Production-ready callback patterns
+- GitHub Actions CI/CD workflows

pydagu-0.2.2/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Patrick [Your Last Name]
+
+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.

pydagu-0.2.2/MANIFEST.in

@@ -0,0 +1,8 @@
+include README.md
+include LICENSE
+include pyproject.toml
+recursive-include pydagu *.py
+recursive-include examples *.py *.md
+recursive-exclude tests *
+recursive-exclude * __pycache__
+recursive-exclude * *.py[co]

pydagu-0.2.2/PKG-INFO

@@ -0,0 +1,195 @@
+Metadata-Version: 2.4
+Name: pydagu
+Version: 0.2.2
+Summary: Python client library for Dagu - A cron alternative with a Web UI
+Project-URL: Homepage, https://github.com/yourusername/pydagu
+Project-URL: Documentation, https://github.com/yourusername/pydagu#readme
+Project-URL: Repository, https://github.com/yourusername/pydagu
+Project-URL: Issues, https://github.com/yourusername/pydagu/issues
+Author-email: Patrick Dobbs <patrick.dobbs@gmail.com>
+License: MIT
+License-File: LICENSE
+Keywords: cron,dag,dagu,scheduler,workflow
+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: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: System :: Monitoring
+Requires-Python: >=3.11
+Requires-Dist: httpx>=0.28.1
+Requires-Dist: pydantic>=2.12.3
+Requires-Dist: pyyaml>=6.0.3
+Provides-Extra: dev
+Requires-Dist: hypothesis-jsonschema>=0.23.1; extra == 'dev'
+Requires-Dist: import-linter>=2.5.2; extra == 'dev'
+Requires-Dist: pre-commit>=4.3.0; extra == 'dev'
+Requires-Dist: pytest-cov>=7.0.0; extra == 'dev'
+Requires-Dist: pytest>=8.4.2; extra == 'dev'
+Requires-Dist: ruff>=0.14.3; extra == 'dev'
+Requires-Dist: schemathesis>=4.3.18; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# pydagu
+
+[![PyPI version](https://badge.fury.io/py/pydagu.svg)](https://badge.fury.io/py/pydagu)
+[![Tests](https://github.com/yourusername/pydagu/actions/workflows/test.yml/badge.svg)](https://github.com/yourusername/pydagu/actions/workflows/test.yml)
+[![Python Versions](https://img.shields.io/pypi/pyversions/pydagu.svg)](https://pypi.org/project/pydagu/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+A Python client library for [Dagu](https://github.com/dagu-org/dagu) - providing type-safe DAG creation and HTTP API interaction with Pydantic validation.
+
+## Features
+
+- 🎯 **Type-safe**: Built with Pydantic models for full type safety and validation
+- 🏗️ **Builder Pattern**: Fluent API for constructing DAGs and steps
+- 🔌 **HTTP Client**: Complete client for Dagu's HTTP API
+- 🔄 **Webhook Support**: Built-in patterns for webhook integration
+- ✅ **Well-tested**: Comprehensive test suite with 95%+ coverage
+- 📝 **Examples**: Production-ready integration examples
+
+## Installation
+
+```bash
+pip install pydagu
+```
+
+## Prerequisites
+
+You need a running [Dagu server](https://github.com/dagu-org/dagu) to run the tests. Install Dagu:
+
+```bash
+# macOS
+brew install dagu-org/brew/dagu
+
+# Linux
+curl -L https://github.com/dagu-org/dagu/releases/latest/download/dagu_linux_amd64.tar.gz | tar xz
+sudo mv dagu /usr/local/bin/
+
+# Start the server
+dagu server
+```
+
+## Quick Start
+
+### Create and Run a Simple DAG
+
+```python
+from pydagu.builder import DagBuilder, StepBuilder
+from pydagu.http import DaguHttpClient
+from pydagu.models.request import StartDagRun
+
+# Initialize client
+client = DaguHttpClient(
+    dag_name="my-first-dag",
+    url_root="http://localhost:8080/api/v2/"
+)
+
+# Build a DAG
+dag = (
+    DagBuilder("my-first-dag")
+    .description("My first DAG with pydagu")
+    .add_step_models(
+        StepBuilder("hello-world")
+        .command("echo 'Hello from pydagu!'")
+        .build()
+    )
+    .build()
+)
+
+# Post the DAG to Dagu
+client.post_dag(dag)
+
+# Start a run
+dag_run_id = client.start_dag_run(StartDagRun(dagName=dag.name))
+
+# Check status
+status = client.get_dag_run_status(dag_run_id.dagRunId)
+print(f"Status: {status.statusLabel}")
+```
+
+### HTTP Executor with Retry
+
+```python
+from pydagu.builder import StepBuilder
+
+step = (
+    StepBuilder("api-call")
+    .command("POST https://api.example.com/webhook")
+    .http_executor(
+        headers={
+            "Content-Type": "application/json",
+            "Authorization": "Bearer ${API_TOKEN}"
+        },
+        body={"event": "user.created", "user_id": "123"},
+        timeout=30
+    )
+    .retry(limit=3, interval=5)
+    .build()
+)
+```
+
+### Chained Steps with Dependencies
+
+```python
+from pydagu.builder import DagBuilder, StepBuilder
+
+dag = (
+    DagBuilder("data-pipeline")
+    .add_step_models(
+        StepBuilder("extract")
+        .command("python extract_data.py")
+        .output("EXTRACTED_FILE")
+        .build(),
+
+        StepBuilder("transform")
+        .command("python transform_data.py ${EXTRACTED_FILE}")
+        .depends_on("extract")
+        .output("TRANSFORMED_FILE")
+        .build(),
+
+        StepBuilder("load")
+        .command("python load_data.py ${TRANSFORMED_FILE}")
+        .depends_on("transform")
+        .build()
+    )
+    .build()
+)
+```
+
+## Development
+
+```bash
+# Clone the repository
+git clone https://github.com/yourusername/pydagu.git
+cd pydagu
+
+# Install with dev dependencies
+pip install -e ".[dev]"
+
+# Run tests (requires Dagu server running)
+pytest tests/ -v
+
+# Run with coverage
+pytest tests/ --cov=pydagu --cov-report=html
+```
+
+## Documentation
+
+- [PyDagu Reference](https://github.com/patrickcd/pydagu/blob/main/docs/reference.md)
+- [Dagu Documentation](https://docs.dagu.cloud/)
+
+## Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+## License
+
+MIT License - see [LICENSE](LICENSE) file for details.
+
+## Related Projects
+
+- [Dagu](https://github.com/dagu-org/dagu) - The underlying DAG execution engine
+- [Airflow](https://airflow.apache.org/) - Alternative workflow orchestration platform

pydagu-0.2.2/README.md

@@ -0,0 +1,161 @@
+# pydagu
+
+[![PyPI version](https://badge.fury.io/py/pydagu.svg)](https://badge.fury.io/py/pydagu)
+[![Tests](https://github.com/yourusername/pydagu/actions/workflows/test.yml/badge.svg)](https://github.com/yourusername/pydagu/actions/workflows/test.yml)
+[![Python Versions](https://img.shields.io/pypi/pyversions/pydagu.svg)](https://pypi.org/project/pydagu/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+A Python client library for [Dagu](https://github.com/dagu-org/dagu) - providing type-safe DAG creation and HTTP API interaction with Pydantic validation.
+
+## Features
+
+- 🎯 **Type-safe**: Built with Pydantic models for full type safety and validation
+- 🏗️ **Builder Pattern**: Fluent API for constructing DAGs and steps
+- 🔌 **HTTP Client**: Complete client for Dagu's HTTP API
+- 🔄 **Webhook Support**: Built-in patterns for webhook integration
+- ✅ **Well-tested**: Comprehensive test suite with 95%+ coverage
+- 📝 **Examples**: Production-ready integration examples
+
+## Installation
+
+```bash
+pip install pydagu
+```
+
+## Prerequisites
+
+You need a running [Dagu server](https://github.com/dagu-org/dagu) to run the tests. Install Dagu:
+
+```bash
+# macOS
+brew install dagu-org/brew/dagu
+
+# Linux
+curl -L https://github.com/dagu-org/dagu/releases/latest/download/dagu_linux_amd64.tar.gz | tar xz
+sudo mv dagu /usr/local/bin/
+
+# Start the server
+dagu server
+```
+
+## Quick Start
+
+### Create and Run a Simple DAG
+
+```python
+from pydagu.builder import DagBuilder, StepBuilder
+from pydagu.http import DaguHttpClient
+from pydagu.models.request import StartDagRun
+
+# Initialize client
+client = DaguHttpClient(
+    dag_name="my-first-dag",
+    url_root="http://localhost:8080/api/v2/"
+)
+
+# Build a DAG
+dag = (
+    DagBuilder("my-first-dag")
+    .description("My first DAG with pydagu")
+    .add_step_models(
+        StepBuilder("hello-world")
+        .command("echo 'Hello from pydagu!'")
+        .build()
+    )
+    .build()
+)
+
+# Post the DAG to Dagu
+client.post_dag(dag)
+
+# Start a run
+dag_run_id = client.start_dag_run(StartDagRun(dagName=dag.name))
+
+# Check status
+status = client.get_dag_run_status(dag_run_id.dagRunId)
+print(f"Status: {status.statusLabel}")
+```
+
+### HTTP Executor with Retry
+
+```python
+from pydagu.builder import StepBuilder
+
+step = (
+    StepBuilder("api-call")
+    .command("POST https://api.example.com/webhook")
+    .http_executor(
+        headers={
+            "Content-Type": "application/json",
+            "Authorization": "Bearer ${API_TOKEN}"
+        },
+        body={"event": "user.created", "user_id": "123"},
+        timeout=30
+    )
+    .retry(limit=3, interval=5)
+    .build()
+)
+```
+
+### Chained Steps with Dependencies
+
+```python
+from pydagu.builder import DagBuilder, StepBuilder
+
+dag = (
+    DagBuilder("data-pipeline")
+    .add_step_models(
+        StepBuilder("extract")
+        .command("python extract_data.py")
+        .output("EXTRACTED_FILE")
+        .build(),
+
+        StepBuilder("transform")
+        .command("python transform_data.py ${EXTRACTED_FILE}")
+        .depends_on("extract")
+        .output("TRANSFORMED_FILE")
+        .build(),
+
+        StepBuilder("load")
+        .command("python load_data.py ${TRANSFORMED_FILE}")
+        .depends_on("transform")
+        .build()
+    )
+    .build()
+)
+```
+
+## Development
+
+```bash
+# Clone the repository
+git clone https://github.com/yourusername/pydagu.git
+cd pydagu
+
+# Install with dev dependencies
+pip install -e ".[dev]"
+
+# Run tests (requires Dagu server running)
+pytest tests/ -v
+
+# Run with coverage
+pytest tests/ --cov=pydagu --cov-report=html
+```
+
+## Documentation
+
+- [PyDagu Reference](https://github.com/patrickcd/pydagu/blob/main/docs/reference.md)
+- [Dagu Documentation](https://docs.dagu.cloud/)
+
+## Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+## License
+
+MIT License - see [LICENSE](LICENSE) file for details.
+
+## Related Projects
+
+- [Dagu](https://github.com/dagu-org/dagu) - The underlying DAG execution engine
+- [Airflow](https://airflow.apache.org/) - Alternative workflow orchestration platform