flowrs 0.14.1__tar.gz

flowrs-0.14.1/.coderabbit.yaml

@@ -0,0 +1,10 @@
+reviews:
+  path_filters:
+    - "!**/*.lock"
+    - "!Cargo.toml"
+    - "!**/Cargo.toml"
+    - "!CLAUDE.md"
+    - "!.gitignore"
+    - "!release-plz.toml"
+    - "!.github/**"
+    - "!docs/**"

flowrs-0.14.1/.gitattributes

@@ -0,0 +1,2 @@
+*.gif filter=lfs diff=lfs merge=lfs -text
+*.png filter=lfs diff=lfs merge=lfs -text

flowrs-0.14.1/.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,27 @@
+---
+name: Bug report
+about: Create a report to help us improve
+title: ''
+labels: ''
+assignees: ''
+
+---
+
+**Describe the bug**
+A clear and concise description of what the bug is.
+
+**To Reproduce**
+Steps to reproduce the behavior
+
+**Expected behavior**
+A clear and concise description of what you expected to happen.
+
+**Screenshots**
+If applicable, add screenshots to help explain your problem.
+
+**Desktop (please complete the following information):**
+ - OS: [e.g. iOS]
+ - Version [e.g. 22]
+
+**Additional context**
+Add any other context about the problem here.

flowrs-0.14.1/.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,20 @@
+---
+name: Feature request
+about: Suggest an idea for this project
+title: ''
+labels: ''
+assignees: ''
+
+---
+
+**Is your feature request related to a problem? Please describe.**
+A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]
+
+**Describe the solution you'd like**
+A clear and concise description of what you want to happen.
+
+**Describe alternatives you've considered**
+A clear and concise description of any alternative solutions or features you've considered.
+
+**Additional context**
+Add any other context or screenshots about the feature request here.

flowrs-0.14.1/.github/dependabot.yml

@@ -0,0 +1,11 @@
+# To get started with Dependabot version updates, you'll need to specify which
+# package ecosystems to update and where the package manifests are located.
+# Please see the documentation for all configuration options:
+# https://docs.github.com/github/administering-a-repository/configuration-options-for-dependency-updates
+
+version: 2
+updates:
+  - package-ecosystem: "cargo" # See documentation for possible values
+    directory: "/" # Location of package manifests
+    schedule:
+      interval: "weekly"

flowrs-0.14.1/.github/workflows/ci.yml

@@ -0,0 +1,53 @@
+name: CI
+
+on:
+  pull_request:
+    branches: [main]
+
+env:
+  CARGO_TERM_COLOR: always
+
+jobs:
+  fmt:
+    name: Format
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: dtolnay/rust-toolchain@stable
+        with:
+          components: rustfmt
+      - run: cargo fmt --all --check
+
+  clippy:
+    name: Clippy
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: dtolnay/rust-toolchain@stable
+        with:
+          components: clippy
+      - uses: Swatinem/rust-cache@v2
+      - run: cargo clippy --workspace --all-targets --all-features -- -D warnings
+
+  feature-combos:
+    name: Feature Combinations
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: dtolnay/rust-toolchain@stable
+        with:
+          components: clippy
+      - uses: Swatinem/rust-cache@v2
+      - uses: taiki-e/install-action@cargo-hack
+      # flowrs-airflow is the only feature-gated crate; verify every combination
+      # of its managed-service features compiles and lints cleanly.
+      - run: cargo hack --feature-powerset -p flowrs-airflow clippy --all-targets -- -D warnings
+
+  test:
+    name: Unit Tests
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: dtolnay/rust-toolchain@stable
+      - uses: Swatinem/rust-cache@v2
+      - run: cargo test --workspace --lib --bins

flowrs-0.14.1/.github/workflows/integration.yml

@@ -0,0 +1,149 @@
+name: Integration Tests
+
+on:
+  push:
+    branches: [main]
+
+env:
+  CARGO_TERM_COLOR: always
+
+jobs:
+  integration:
+    name: Integration (${{ matrix.airflow_version }})
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - airflow_version: "2.10.4"
+            api_version: "v1"
+          - airflow_version: "3.1.6"
+            api_version: "v2"
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: dtolnay/rust-toolchain@stable
+
+      - uses: Swatinem/rust-cache@v2
+
+      - name: Start Airflow 2.x container
+        if: matrix.api_version == 'v1'
+        run: |
+          docker run -d --name airflow \
+            -p 8080:8080 \
+            -e AIRFLOW__CORE__LOAD_EXAMPLES=true \
+            -e AIRFLOW__DATABASE__SQL_ALCHEMY_CONN=sqlite:////tmp/airflow.db \
+            -e AIRFLOW__WEBSERVER__SECRET_KEY=test-secret-key \
+            -e AIRFLOW__API__AUTH_BACKENDS=airflow.api.auth.backend.basic_auth \
+            --entrypoint /bin/bash \
+            apache/airflow:${{ matrix.airflow_version }} \
+            -c "sleep infinity"
+
+      - name: Start Airflow 3.x container
+        if: matrix.api_version == 'v2'
+        run: |
+          docker run -d --name airflow \
+            -p 8080:8080 \
+            -e AIRFLOW__CORE__LOAD_EXAMPLES=true \
+            -e AIRFLOW__DATABASE__SQL_ALCHEMY_CONN=sqlite:////tmp/airflow.db \
+            -e AIRFLOW__WEBSERVER__SECRET_KEY=test-secret-key \
+            -e AIRFLOW__CORE__SIMPLE_AUTH_MANAGER_USERS=airflow:admin \
+            --entrypoint /bin/bash \
+            apache/airflow:${{ matrix.airflow_version }} \
+            -c "sleep infinity"
+
+      - name: Initialize Airflow database
+        run: |
+          docker exec airflow airflow db migrate
+
+      - name: Create Airflow user (v2.x only)
+        if: matrix.api_version == 'v1'
+        run: |
+          docker exec airflow airflow users create \
+            --username airflow \
+            --password airflow \
+            --firstname Test \
+            --lastname User \
+            --role Admin \
+            --email test@example.com
+
+      - name: Start Airflow services (v2.x)
+        if: matrix.api_version == 'v1'
+        run: |
+          docker exec -d airflow airflow webserver --port 8080
+          docker exec -d airflow airflow scheduler
+
+      - name: Start Airflow services (v3.x)
+        if: matrix.api_version == 'v2'
+        run: |
+          docker exec -d airflow airflow api-server --port 8080
+          docker exec -d airflow airflow scheduler
+          docker exec -d airflow airflow dag-processor
+
+      - name: Wait for Airflow API (v2.x)
+        if: matrix.api_version == 'v1'
+        run: |
+          timeout 120 bash -c '
+            until curl -sf -u airflow:airflow http://localhost:8080/api/v1/health; do
+              echo "Waiting for Airflow API..."
+              sleep 5
+            done
+          '
+          echo "Airflow API is ready"
+
+      - name: Wait for Airflow API (v3.x)
+        if: matrix.api_version == 'v2'
+        run: |
+          timeout 120 bash -c '
+            until curl -sf http://localhost:8080/api/v2/version; do
+              echo "Waiting for Airflow API..."
+              sleep 5
+            done
+          '
+          echo "Airflow API is ready"
+
+      - name: Get Airflow 3.x password
+        if: matrix.api_version == 'v2'
+        id: airflow_password
+        run: |
+          # Password file is generated by api-server, find it
+          echo "Looking for password file..."
+          docker exec airflow find /opt/airflow /home/airflow -name "*.generated" 2>/dev/null || true
+          docker exec airflow ls -la /opt/airflow/ 2>/dev/null || true
+
+          # Try common locations
+          PASSWORD=""
+          for path in /opt/airflow/simple_auth_manager_passwords.json.generated /home/airflow/simple_auth_manager_passwords.json.generated; do
+            if docker exec airflow test -f "$path" 2>/dev/null; then
+              echo "Found password file at $path"
+              docker exec airflow cat "$path"
+              PASSWORD=$(docker exec airflow cat "$path" | python3 -c "import sys, json; print(json.load(sys.stdin).get('airflow', ''))")
+              break
+            fi
+          done
+
+          if [ -z "$PASSWORD" ]; then
+            echo "ERROR: Could not retrieve password from password file"
+            exit 1
+          fi
+
+          echo "password=$PASSWORD" >> $GITHUB_OUTPUT
+          echo "Successfully retrieved password for airflow user"
+
+      - name: Wait for DAGs to load
+        run: |
+          echo "Waiting for scheduler to parse DAGs..."
+          sleep 45
+
+      - name: Run integration tests
+        env:
+          TEST_AIRFLOW_URL: http://localhost:8080
+          TEST_AIRFLOW_USERNAME: airflow
+          TEST_AIRFLOW_PASSWORD: ${{ matrix.api_version == 'v2' && steps.airflow_password.outputs.password || 'airflow' }}
+          TEST_API_VERSION: ${{ matrix.api_version }}
+        run: cargo test --test '*' -- --test-threads=1
+
+      - name: Cleanup
+        if: always()
+        run: docker rm -f airflow || true

flowrs-0.14.1/.github/workflows/pypi.yml

@@ -0,0 +1,159 @@
+name: PyPI
+
+# Builds platform wheels that ship the `flowrs` binary, so it can be installed
+# with `uv tool install flowrs` / `pipx install flowrs`.
+#
+# Publishes on the same `flowrs-tui-v*` tags that trigger the cargo-dist
+# release workflow, so a release-plz tag ships crates.io, GitHub Releases,
+# Homebrew and PyPI together. The wheel version is read from Cargo.toml, so
+# nothing needs bumping here. The `flowrs-airflow-*` and `flowrs-config-*`
+# library tags are deliberately not matched: only the binary crate is shipped
+# to PyPI.
+#
+# Running this workflow manually builds everything and exercises the PyPI
+# trusted-publishing OIDC exchange in --dry-run mode, without uploading. Use
+# that to validate the publisher setup before the first real release. Only a
+# version tag ever uploads.
+#
+# The wheel matrix mirrors the platforms cargo-dist already releases binaries
+# for (see dist-workspace.toml). Windows, musl and linux aarch64 are left out
+# because flowrs ships no binaries for them today; nothing in the build blocks
+# them, so they can be added here whenever those targets are supported.
+
+on:
+  push:
+    tags:
+      - 'flowrs-tui-v[0-9]+.[0-9]+.[0-9]+*'
+  # Verify the packaging still builds when it changes, without publishing.
+  pull_request:
+    paths:
+      - pyproject.toml
+      - .github/workflows/pypi.yml
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+env:
+  CARGO_TERM_COLOR: always
+
+jobs:
+  linux:
+    name: Wheel (manylinux x86_64)
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Build wheel
+        uses: PyO3/maturin-action@v1
+        with:
+          target: x86_64
+          args: --release --out dist
+          # glibc 2.28 (AlmaLinux 8) is still an older baseline than the
+          # ubuntu-22.04 the cargo-dist binaries are built on, and the build
+          # links no system libraries beyond libc, so the wheel bundles nothing.
+          manylinux: '2_28'
+          sccache: ${{ !startsWith(github.ref, 'refs/tags/') }}
+      - uses: actions/upload-artifact@v4
+        with:
+          name: wheels-manylinux-x86_64
+          path: dist
+
+  macos:
+    name: Wheel (macOS ${{ matrix.target }})
+    runs-on: ${{ matrix.runner }}
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - runner: macos-latest
+            target: aarch64
+          - runner: macos-15-intel
+            target: x86_64
+    steps:
+      - uses: actions/checkout@v4
+      - name: Build wheel
+        uses: PyO3/maturin-action@v1
+        with:
+          target: ${{ matrix.target }}
+          args: --release --out dist
+          sccache: ${{ !startsWith(github.ref, 'refs/tags/') }}
+      - uses: actions/upload-artifact@v4
+        with:
+          name: wheels-macos-${{ matrix.target }}
+          path: dist
+
+  sdist:
+    name: Source distribution
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Build sdist
+        uses: PyO3/maturin-action@v1
+        with:
+          command: sdist
+          args: --out dist
+      - uses: actions/upload-artifact@v4
+        with:
+          name: wheels-sdist
+          path: dist
+
+  smoke-test:
+    name: Smoke test (${{ matrix.os }})
+    needs: [linux, macos]
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, macos-latest]
+    env:
+      UV_TOOL_BIN_DIR: ${{ github.workspace }}/tool-bin
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          pattern: wheels-*
+          merge-multiple: true
+          path: dist
+      - uses: astral-sh/setup-uv@v7
+      - name: Install from the built wheel and run it
+        shell: bash
+        # --no-build asserts a matching wheel exists for this platform rather
+        # than silently falling back to compiling the sdist.
+        run: |
+          uv tool install --no-index --no-build --find-links dist flowrs
+          "${UV_TOOL_BIN_DIR}/flowrs" --version
+
+  publish:
+    name: Publish to PyPI
+    needs: [linux, macos, sdist, smoke-test]
+    # Tags upload for real; a manual run only dry-runs (see the step below).
+    if: startsWith(github.ref, 'refs/tags/') || github.event_name == 'workflow_dispatch'
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/p/flowrs
+    permissions:
+      contents: read
+      # Required for PyPI Trusted Publishing (OIDC). No API token needed.
+      id-token: write
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          pattern: wheels-*
+          merge-multiple: true
+          path: dist
+      - uses: astral-sh/setup-uv@v7
+      - name: Publish
+        # `--trusted-publishing always` fails loudly if the OIDC exchange is
+        # not configured, rather than silently falling back to looking for a
+        # token. `--check-url` makes a re-run skip already-uploaded files.
+        #
+        # A manual run adds --dry-run, which still performs the full OIDC
+        # exchange but uploads nothing, so the publisher setup can be verified
+        # without burning a version number. Uploads are therefore reachable
+        # only from a version tag.
+        run: >-
+          uv publish
+          --trusted-publishing always
+          --check-url https://pypi.org/simple/flowrs/
+          ${{ github.event_name == 'workflow_dispatch' && '--dry-run' || '' }}
+          'dist/*'

flowrs-0.14.1/.github/workflows/release-plz.yml

@@ -0,0 +1,54 @@
+name: Release-plz
+
+permissions:
+  pull-requests: write
+  contents: write
+
+on:
+  push:
+    branches:
+      - main
+  workflow_dispatch:
+
+jobs:
+  release-plz-release:
+    name: Release-plz release
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+          token: ${{ secrets.RELEASE_PLZ_TOKEN }}
+      - name: Install Rust toolchain
+        uses: dtolnay/rust-toolchain@stable
+      - name: Run release-plz
+        uses: MarcoIeni/release-plz-action@v0.5
+        with:
+          command: release
+        env:
+          GITHUB_TOKEN: ${{ secrets.RELEASE_PLZ_TOKEN }}
+          CARGO_REGISTRY_TOKEN: ${{ secrets.CARGO_REGISTRY_TOKEN }}
+
+  release-plz-pr:
+    name: Release-plz PR
+    runs-on: ubuntu-latest
+    needs: release-plz-release
+    concurrency:
+      group: release-plz-${{ github.ref }}
+      cancel-in-progress: false
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+          token: ${{ secrets.RELEASE_PLZ_TOKEN }}
+      - name: Install Rust toolchain
+        uses: dtolnay/rust-toolchain@stable
+      - name: Run release-plz
+        uses: MarcoIeni/release-plz-action@v0.5
+        with:
+          command: release-pr
+        env:
+          GITHUB_TOKEN: ${{ secrets.RELEASE_PLZ_TOKEN }}
+          CARGO_REGISTRY_TOKEN: ${{ secrets.CARGO_REGISTRY_TOKEN }}