msgflux 0.1.0__tar.gz

msgflux-0.1.0/.github/CODEOWNERS

@@ -0,0 +1,5 @@
+# See https://help.github.com/articles/about-codeowners/
+# for more info about CODEOWNERS file
+
+# CODEOWNERS
+* @vilsonrodrigues

msgflux-0.1.0/.github/dependabot.yml

@@ -0,0 +1,20 @@
+version: 2
+
+updates:
+  - package-ecosystem: "uv"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+    open-pull-requests-limit: 10
+    labels:
+      - "dependencies"
+      - "python"
+
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+    open-pull-requests-limit: 5
+    labels:
+      - "dependencies"
+      - "github-actions"

msgflux-0.1.0/.github/labeler.yml

@@ -0,0 +1,48 @@
+# Configuration for labeler action
+# https://github.com/actions/labeler
+
+# Models
+models:
+  - changed-files:
+    - any-glob-to-any-file: 'src/msgflux/models/**'
+
+# Core
+core:
+  - changed-files:
+    - any-glob-to-any-file:
+      - 'src/msgflux/generation/**'
+      - 'src/msgflux/dsl/**'
+      - 'src/msgflux/nn/**'
+
+# Tests
+tests:
+  - changed-files:
+    - any-glob-to-any-file: 'tests/**'
+
+# Documentation
+documentation:
+  - changed-files:
+    - any-glob-to-any-file:
+      - '**/*.md'
+      - 'docs/**'
+
+# CI/CD
+ci:
+  - changed-files:
+    - any-glob-to-any-file:
+      - '.github/workflows/**'
+      - '.github/dependabot.yml'
+      - '.github/labeler.yml'
+
+# Dependencies
+dependencies:
+  - changed-files:
+    - any-glob-to-any-file:
+      - 'pyproject.toml'
+      - 'uv.lock'
+      - '.pre-commit-config.yaml'
+
+# Examples
+examples:
+  - changed-files:
+    - any-glob-to-any-file: 'examples/**'

msgflux-0.1.0/.github/pull_request_template.md

@@ -0,0 +1,54 @@
+## Summary
+
+<!-- Brief description of what this PR does -->
+
+## Changes
+
+<!-- List the main changes in this PR -->
+-
+-
+-
+
+## Type of Change
+
+<!-- Mark the relevant option with an "x" -->
+- [ ] Bug fix (non-breaking change which fixes an issue)
+- [ ] New feature (non-breaking change which adds functionality)
+- [ ] Breaking change (fix or feature that would cause existing functionality to not work as expected)
+- [ ] Documentation update
+- [ ] Code refactoring
+- [ ] Performance improvement
+- [ ] Test improvement
+- [ ] CI/CD improvement
+- [ ] Chore/maintenance
+
+## Testing
+
+<!-- Describe how you tested these changes -->
+- [ ] Tests pass locally (`uv run pytest -v`)
+- [ ] Added new tests for this change
+- [ ] Updated existing tests
+
+## Documentation
+
+<!-- Check if documentation needs updating -->
+- [ ] Updated README.md (if API changed)
+- [ ] Updated CHANGELOG.md (if notable change)
+- [ ] Added/updated code comments
+- [ ] Added/updated docstrings
+
+## Checklist
+
+<!-- Mark completed items with an "x" -->
+- [ ] Code formatted (`uv run ruff format`)
+- [ ] Lint checks pass (`uv run ruff check`)
+- [ ] Tests pass (`uv run pytest -v`)
+- [ ] **Version NOT changed** (maintainers bump version after merge)
+- [ ] Commit messages follow [conventional commits](https://www.conventionalcommits.org/)
+- [ ] No breaking changes (or documented above)
+- [ ] Added tests for new features
+- [ ] Documentation is up to date
+
+## Additional Notes
+
+<!-- Any additional information reviewers should know -->

msgflux-0.1.0/.github/release-drafter.yml

@@ -0,0 +1,80 @@
+name-template: 'v$RESOLVED_VERSION'
+tag-template: 'v$RESOLVED_VERSION'
+
+categories:
+  - title: '🚨 Breaking Changes'
+    labels:
+      - 'breaking-change'
+      - 'breaking'
+  - title: '🚀 Features'
+    labels:
+      - 'enhancement'
+      - 'feat'
+      - 'feature'
+  - title: '🐛 Bug Fixes'
+    labels:
+      - 'bug'
+      - 'fix'
+  - title: '⚡ Performance'
+    labels:
+      - 'performance'
+      - 'perf'
+  - title: '🔐 Security'
+    labels:
+      - 'security'
+  - title: '📚 Documentation'
+    labels:
+      - 'documentation'
+      - 'docs'
+  - title: '🔄 Refactoring'
+    labels:
+      - 'refactor'
+      - 'refactoring'
+  - title: '🧪 Tests'
+    labels:
+      - 'tests'
+      - 'test'
+  - title: '🤖 CI/CD'
+    labels:
+      - 'ci'
+      - 'ci-cd'
+  - title: '📦 Dependencies'
+    labels:
+      - 'dependencies'
+  - title: '🔧 Maintenance'
+    labels:
+      - 'maintenance'
+      - 'chore'
+
+change-template: '- $TITLE @$AUTHOR (#$NUMBER)'
+change-title-escapes: '\<*_&'
+
+version-resolver:
+  major:
+    labels:
+      - 'breaking-change'
+      - 'major'
+  minor:
+    labels:
+      - 'enhancement'
+      - 'feat'
+      - 'feature'
+  patch:
+    labels:
+      - 'bug'
+      - 'fix'
+      - 'patch'
+      - 'documentation'
+      - 'dependencies'
+  default: patch
+
+template: |
+  ## Changes
+
+  $CHANGES
+
+  ## Contributors
+
+  Thank you to all contributors! 🙏
+
+  $CONTRIBUTORS

msgflux-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,133 @@
+name: CI
+
+on:
+  pull_request:
+    branches: [main]
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+jobs:
+  lint-format:
+    name: Ruff Lint & Format
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v6
+        with:
+          fetch-depth: 0
+
+      - name: Set up Python
+        uses: actions/setup-python@v6
+        with:
+          python-version: '3.12'
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v7
+        with:
+          version: "latest"
+
+      - name: Install dependencies
+        run: uv sync --python 3.12 --group dev
+
+      - name: Determine changed Python files
+        id: changed-python
+        shell: bash
+        run: |
+          if [[ "${{ github.event_name }}" == "pull_request" ]]; then
+            BASE_SHA="${{ github.event.pull_request.base.sha }}"
+            HEAD_SHA="${{ github.event.pull_request.head.sha }}"
+            CHANGED_PY=$(git diff --name-only --diff-filter=ACMR "${BASE_SHA}...${HEAD_SHA}" -- '*.py')
+          elif git rev-parse HEAD~1 >/dev/null 2>&1; then
+            CHANGED_PY=$(git diff --name-only --diff-filter=ACMR HEAD~1 HEAD -- '*.py')
+          else
+            CHANGED_PY=$(git ls-files '*.py')
+          fi
+
+          {
+            echo "files<<EOF"
+            echo "$CHANGED_PY"
+            echo "EOF"
+          } >> "$GITHUB_OUTPUT"
+
+      - name: Run ruff format check on changed files
+        if: steps.changed-python.outputs.files != ''
+        run: |
+          printf '%s\n' "${{ steps.changed-python.outputs.files }}" | xargs uv run --python 3.12 ruff format --check
+
+      - name: Run ruff lint on changed files
+        if: steps.changed-python.outputs.files != ''
+        run: |
+          printf '%s\n' "${{ steps.changed-python.outputs.files }}" | xargs uv run --python 3.12 ruff check --output-format=github
+
+      - name: Skip ruff when no Python files changed
+        if: steps.changed-python.outputs.files == ''
+        run: echo "No Python files changed; skipping Ruff."
+
+  test:
+    name: Test Python ${{ matrix.python-version }}
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ['3.10', '3.11', '3.12', '3.13']
+
+    steps:
+      - uses: actions/checkout@v6
+
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v6
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v7
+        with:
+          version: "latest"
+
+      - name: Install dependencies
+        run: uv sync --python ${{ matrix.python-version }} --group dev
+
+      - name: Run tests
+        run: uv run --python ${{ matrix.python-version }} pytest -v --ignore=tests/integration --cov=src/msgflux --cov-report=xml --cov-report=term
+
+      - name: Upload coverage
+        uses: codecov/codecov-action@v6
+        if: matrix.python-version == '3.12'
+        with:
+          file: ./coverage.xml
+          fail_ci_if_error: false
+
+  build:
+    name: Build distribution
+    runs-on: ubuntu-latest
+    needs: [lint-format, test]
+
+    steps:
+      - uses: actions/checkout@v6
+
+      - name: Set up Python
+        uses: actions/setup-python@v6
+        with:
+          python-version: '3.12'
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v7
+
+      - name: Install dependencies
+        run: uv sync --python 3.12 --group dev
+
+      - name: Build package
+        run: uv build
+
+      - name: Check package
+        run: |
+          ls -lh dist/
+          uv run twine check dist/*
+
+      - name: Store distribution
+        uses: actions/upload-artifact@v7
+        with:
+          name: python-package-distributions
+          path: dist/

msgflux-0.1.0/.github/workflows/docs.yml

@@ -0,0 +1,43 @@
+name: Deploy Documentation
+
+on:
+  push:
+    branches:
+      - main
+  pull_request:
+
+permissions:
+  contents: write
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.11'
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v7
+        with:
+          version: "latest"
+          enable-cache: true
+          cache-dependency-glob: "pyproject.toml"
+
+      - name: Install dependencies
+        run: |
+          uv sync --group doc
+
+      - name: Build documentation
+        run: uv run --group doc mkdocs build --clean
+
+      - name: Deploy to GitHub Pages
+        if: github.event_name == 'push' && github.ref == 'refs/heads/main'
+        uses: peaceiris/actions-gh-pages@v4
+        with:
+          github_token: ${{ secrets.GITHUB_TOKEN }}
+          publish_dir: ./site
+          publish_branch: gh-pages

msgflux-0.1.0/.github/workflows/labeler.yml

@@ -0,0 +1,132 @@
+name: Label PRs
+
+on:
+  pull_request:
+    types: [opened, edited, synchronize]
+
+permissions:
+  contents: read
+  pull-requests: write
+
+jobs:
+  label:
+    # Disabled: fails on fork PRs due to token permissions
+    if: false
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v6
+
+      - name: Label PR based on files
+        uses: actions/labeler@v6
+        with:
+          repo-token: ${{ secrets.GITHUB_TOKEN }}
+          configuration-path: .github/labeler.yml
+
+      - name: Label PR based on size
+        uses: actions/github-script@v8
+        with:
+          script: |
+            const pr = context.payload.pull_request;
+            const additions = pr.additions;
+            const deletions = pr.deletions;
+            const totalChanges = additions + deletions;
+
+            // Remove existing size labels
+            const existingLabels = pr.labels.map(label => label.name);
+            const sizeLabels = ['size/XS', 'size/S', 'size/M', 'size/L', 'size/XL'];
+            const labelsToRemove = existingLabels.filter(label => sizeLabels.includes(label));
+
+            for (const label of labelsToRemove) {
+              await github.rest.issues.removeLabel({
+                owner: context.repo.owner,
+                repo: context.repo.repo,
+                issue_number: pr.number,
+                name: label
+              });
+            }
+
+            // Determine size label
+            let sizeLabel;
+            if (totalChanges < 10) {
+              sizeLabel = 'size/XS';
+            } else if (totalChanges < 50) {
+              sizeLabel = 'size/S';
+            } else if (totalChanges < 200) {
+              sizeLabel = 'size/M';
+            } else if (totalChanges < 500) {
+              sizeLabel = 'size/L';
+            } else {
+              sizeLabel = 'size/XL';
+            }
+
+            // Add new size label
+            await github.rest.issues.addLabels({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              issue_number: pr.number,
+              labels: [sizeLabel]
+            });
+
+            core.info(`Added label: ${sizeLabel} (${totalChanges} changes)`);
+
+      - name: Label PR based on title
+        uses: actions/github-script@v8
+        with:
+          script: |
+            const pr = context.payload.pull_request;
+            const title = pr.title.toLowerCase();
+
+            const labels = [];
+
+            // Conventional commit prefixes (case-insensitive with [] or () brackets)
+            const patterns = {
+              feat: /^(feat|FEAT)[\[:(]/,
+              fix: /^(fix|FIX)[\[:(]/,
+              docs: /^(docs|DOCS)[\[:(]/,
+              test: /^(test|TEST|tests|TESTS)[\[:(]/,
+              chore: /^(chore|CHORE)[\[:(]/,
+              refactor: /^(refactor|REFACTOR)[\[:(]/,
+              perf: /^(perf|PERF)[\[:(]/,
+              style: /^(style|STYLE)[\[:(]/,
+              ci: /^(ci|CI)[\[:(]/,
+            };
+
+            if (patterns.feat.test(pr.title)) {
+              labels.push('enhancement');
+            } else if (patterns.fix.test(pr.title)) {
+              labels.push('bug');
+            } else if (patterns.docs.test(pr.title)) {
+              labels.push('documentation');
+            } else if (patterns.test.test(pr.title)) {
+              labels.push('tests');
+            } else if (patterns.chore.test(pr.title)) {
+              labels.push('maintenance');
+            } else if (patterns.refactor.test(pr.title)) {
+              labels.push('refactor');
+            } else if (patterns.perf.test(pr.title)) {
+              labels.push('performance');
+            } else if (patterns.ci.test(pr.title)) {
+              labels.push('ci');
+            }
+
+            // Keywords
+            if (title.includes('breaking') || title.includes('breaking change')) {
+              labels.push('breaking-change');
+            }
+
+            if (title.includes('security')) {
+              labels.push('security');
+            }
+
+            // Add labels
+            if (labels.length > 0) {
+              await github.rest.issues.addLabels({
+                owner: context.repo.owner,
+                repo: context.repo.repo,
+                issue_number: pr.number,
+                labels: labels
+              });
+
+              core.info(`Added labels: ${labels.join(', ')}`);
+            }