arthur-common 0.0.0.post0__tar.gz

arthur_common-0.0.0.post0/.bumpversion.cfg

@@ -0,0 +1,11 @@
+[bumpversion]
+current_version = 2.4.56
+commit = True
+tag = True
+tag_name = {new_version}
+parse = (?P<major>\d+)\.(?P<minor>\d+)\.(?P<patch>\d+)
+serialize = {major}.{minor}.{patch}
+
+[bumpversion:file:pyproject.toml]
+search = version = "{current_version}"
+replace = version = "{new_version}"

arthur_common-0.0.0.post0/.github/workflows/arthur-common-release.yml

@@ -0,0 +1,163 @@
+name: Arthur Common Release
+
+on:
+  push:
+    branches:
+      - main
+    tags:
+      - '*-lts'
+      - '*-lts-patch-*'
+
+jobs:
+  pypi-build:
+    # Should be separate from publish job: https://docs.pypi.org/trusted-publishers/security-model/#:~:text=Retrieve%20the%20publishable%20distribution%20files%20from%20a%20separate%20build%20job%3B
+    # written from guide: https://johnfraney.ca/blog/how-to-publish-a-python-package-with-poetry-and-github-actions/
+    name: Build release for PyPI
+    if: github.ref_type == 'branch' && startsWith(github.event.head_commit.message, 'Bump version')
+    runs-on: ubuntu-latest
+    env:
+      GIT_DEPTH: 100
+    permissions:
+      contents: read
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: ${{ env.GIT_DEPTH }}
+          ref: main
+      - uses: ./.github/workflows/composite-actions/setup-git
+        with:
+          safe-directory: ${{ runner.workspace }}
+      - uses: ./.github/workflows/composite-actions/setup-uv
+      - name: Package project
+        run: uv build
+      - name: List build artifacts
+        run: ls -la dist/
+      - name: Archive package
+        uses: actions/upload-artifact@v4
+        with:
+          name: arthur-common
+          path: dist/
+          retention-days: 1
+          if-no-files-found: error
+
+  pypi-publish:
+    # don't add more steps to this job—it should only publish so that steps with access to the OIDC token for use with
+    # PyPI are as limited as possible
+    needs: pypi-build
+    # does not run on dev—https://packaging.python.org/en/latest/specifications/version-specifiers/#version-specifiers:~:text=Local%20version%20identifiers%20SHOULD%20NOT%20be%20used%20when%20publishing%20upstream%20projects%20to%20a%20public%20index%20server%2C%20but%20MAY%20be%20used%20to%20identify%20private%20builds%20created%20directly%20from%20the%20project%20source.
+    name: Upload release to PyPI
+    if: github.ref_type == 'branch' && startsWith(github.event.head_commit.message, 'Bump version')
+    runs-on: ubuntu-latest
+    environment:  # must be the same as what is set for the trusted publisher in PyPI
+      name: shared-protected-branch-secrets
+      url: https://pypi.org/project/arthur-common/
+    permissions:
+      contents: read
+      id-token: write  # needed for PyPI trusted publishing to create short-lived ID token to verify authority to publish
+    steps:
+        - name: Download distribution from pypi-build job
+          uses: actions/download-artifact@v4
+          with:
+            name: arthur-common
+            path: dist
+        - name: List downloaded artifacts
+          run: ls -la dist/
+        - name: Publish package distributions to PyPI
+          uses: pypa/gh-action-pypi-publish@release/v1
+          with:
+            packages-dir: dist
+
+  create-git-tag:
+    needs: pypi-publish
+    name: Create git tag for the release
+    if: github.ref_type == 'branch' && startsWith(github.event.head_commit.message, 'Bump version')
+    runs-on: ubuntu-latest
+    environment:  # must be the same as what is set for the trusted publisher in PyPI
+      name: shared-protected-branch-secrets
+      url: https://pypi.org/project/arthur-common/
+    permissions:
+      contents: write
+    steps:
+      - name: Generate Arthur GitHub Automator App Token
+        id: generate-token
+        uses: actions/create-github-app-token@v1
+        with:
+          app-id: ${{ secrets.ARTHUR_GH_AUTOMATOR_APP_ID }}
+          private-key: ${{ secrets.ARTHUR_GH_AUTOMATOR_APP_PRIVATE_KEY }}
+      - uses: actions/checkout@v4
+        with:
+          token: ${{ steps.generate-token.outputs.token }}
+      - uses: ./.github/workflows/composite-actions/setup-git
+        with:
+          safe-directory: ${{ runner.workspace }}
+      - uses: ./.github/workflows/composite-actions/setup-uv
+      - name: Get current version
+        id: get-version
+        run: |
+          VERSION=$(python -c "import tomllib; data=tomllib.load(open('pyproject.toml','rb')); print(data['project']['version'])")
+          echo "Current version: $VERSION"
+          echo "version=$VERSION" >> "$GITHUB_OUTPUT"
+      - name: Create and push git tag
+        run: |
+          git tag ${{ steps.get-version.outputs.version }}
+          git push origin ${{ steps.get-version.outputs.version }}
+
+  # ---------------------------------------------------------------------------
+  # LTS publish — fires on *-lts and *-lts-patch-* tags only.
+  # The lts-management orchestrator writes pyproject.toml to the .post form
+  # (e.g. 1.5.0.post0) and pushes the LTS tag, which triggers these jobs.
+  # PyPI versions are immutable so we rebuild the wheel rather than retag.
+  # ---------------------------------------------------------------------------
+
+  lts-pypi-build:
+    name: Build LTS wheel
+    if: github.ref_type == 'tag'
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          ref: ${{ github.ref }}
+      - uses: ./.github/workflows/composite-actions/setup-git
+        with:
+          safe-directory: ${{ runner.workspace }}
+      # Use astral-sh/setup-uv directly (NOT the local setup-uv composite,
+      # which runs `uv sync --frozen` — the orchestrator changed pyproject.toml
+      # putting it out of sync with uv.lock). uv build doesn't need a synced env.
+      - uses: astral-sh/setup-uv@v5
+        with:
+          version: "0.11.7"
+      - name: Build wheel
+        run: uv build
+      - name: List artifacts
+        run: ls -la dist/
+      - name: Archive wheel
+        uses: actions/upload-artifact@v4
+        with:
+          name: arthur-common-lts
+          path: dist/
+          retention-days: 1
+          if-no-files-found: error
+
+  lts-pypi-publish:
+    name: Publish LTS wheel to PyPI
+    needs: lts-pypi-build
+    if: github.ref_type == 'tag'
+    runs-on: ubuntu-latest
+    environment:
+      name: shared-protected-branch-secrets
+      url: https://pypi.org/project/arthur-common/
+    permissions:
+      contents: read
+      id-token: write
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          name: arthur-common-lts
+          path: dist
+      - run: ls -la dist/
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          packages-dir: dist

arthur_common-0.0.0.post0/.github/workflows/arthur-common-version-bump.yml

@@ -0,0 +1,49 @@
+name: Arthur Common Version Bump
+
+on:
+  workflow_dispatch:
+    inputs:
+      intent:
+        description: 'Trigger version bump'
+        required: true
+        default: 'bump_version'
+        type: string
+      bump_type:
+        description: 'Version bump type (patch, minor, major)'
+        required: true
+        default: 'patch'
+        type: choice
+        options:
+          - patch
+          - minor
+          - major
+
+jobs:
+  bump-version:
+    environment: shared-protected-branch-secrets
+    if: github.event_name == 'workflow_dispatch' && github.event.inputs.intent == 'bump_version'
+    runs-on: ubuntu-latest
+    steps:
+      - name: Generate Arthur GitHub Automator App Token
+        id: generate-token
+        uses: actions/create-github-app-token@v1
+        with:
+          app-id: ${{ secrets.ARTHUR_GH_AUTOMATOR_APP_ID }}
+          private-key: ${{ secrets.ARTHUR_GH_AUTOMATOR_APP_PRIVATE_KEY }}
+      - uses: actions/checkout@v5
+        with:
+          fetch-depth: 0
+          token: ${{ steps.generate-token.outputs.token }}
+      - uses: ./.github/workflows/composite-actions/setup-git
+        with:
+          safe-directory: ${{ runner.workspace }}
+      - uses: astral-sh/setup-uv@v5
+        with:
+          version: "0.6.x"
+      - name: Bump version
+        run: |
+          uvx bump2version ${{ github.event.inputs.bump_type }}
+
+          git status
+
+          git push origin

arthur_common-0.0.0.post0/.github/workflows/arthur-common-workflow.yml

@@ -0,0 +1,62 @@
+name: Arthur Common CI
+
+on:
+  push:
+    branches:
+      - main
+  pull_request:
+    branches:
+      - main
+
+jobs:
+  run-linter:
+    runs-on: ubuntu-latest
+    env:
+      SKIP: pytest-check,changelog-check
+      GIT_DEPTH: 100
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: ${{ env.GIT_DEPTH }}
+      - uses: ./.github/workflows/composite-actions/setup-git
+        with:
+          safe-directory: ${{ runner.workspace }}
+      - uses: ./.github/workflows/composite-actions/setup-uv
+      - name: Run linters
+        run: |
+          uv run autoflake src/
+          uv run isort src/
+          uv run black src/
+          uv run mypy --config-file pyproject.toml src/
+
+  run-unit-tests:
+    runs-on: ubuntu-latest
+    steps:
+        - uses: actions/checkout@v4
+        - uses: ./.github/workflows/composite-actions/setup-git
+          with:
+            safe-directory: ${{ runner.workspace }}
+        - uses: ./.github/workflows/composite-actions/setup-uv
+        - name: Run unit tests
+          shell: bash
+          run: |
+            set -o pipefail
+            uv run pytest tests/unit/ --cov --cov=src/arthur_common \
+            --cov-report term \
+            --junitxml=report.xml \
+            | tee pytest-coverage.txt
+        - name: Pytest coverage comment
+          if: always()
+          uses: MishaKav/pytest-coverage-comment@main
+          with:
+            pytest-coverage-path: pytest-coverage.txt
+            junitxml-path: report.xml
+            title: Coverage Report
+        - name: Upload coverage report
+          if: always()
+          uses: actions/upload-artifact@v4
+          with:
+            name: test-results
+            path: |
+              report.xml
+              pytest-coverage.txt

arthur_common-0.0.0.post0/.github/workflows/claude-code-review.yml

@@ -0,0 +1,45 @@
+name: Claude Code Review
+
+on:
+  pull_request:
+    types: [opened, synchronize]
+    # Optional: Only run on specific file changes
+    # paths:
+    #   - "src/**/*.ts"
+    #   - "src/**/*.tsx"
+    #   - "src/**/*.js"
+    #   - "src/**/*.jsx"
+
+jobs:
+  claude-review:
+    # Optional: Filter by PR author
+    # if: |
+    #   github.event.pull_request.user.login == 'external-contributor' ||
+    #   github.event.pull_request.user.login == 'new-developer' ||
+    #   github.event.pull_request.author_association == 'FIRST_TIME_CONTRIBUTOR'
+
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      pull-requests: write
+      issues: read
+      id-token: write
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 1
+
+      - name: Run Claude Code Review
+        id: claude-review
+        uses: anthropics/claude-code-action@v1
+        with:
+          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
+          plugin_marketplaces: 'https://github.com/anthropics/claude-code.git'
+          plugins: 'code-review@claude-code-plugins'
+          prompt: '/code-review:code-review --comment https://github.com/${{ github.repository }}/pull/${{ github.event.pull_request.number }}'
+          # See https://github.com/anthropics/claude-code-action/blob/main/docs/usage.md
+          # Example prompts and configurations: https://github.com/anthropics/claude-code-action/blob/main/docs/solutions.md
+          # CLI flags: https://code.claude.com/docs/en/cli-reference
+          # Code review plugin: https://github.com/anthropics/claude-code/tree/main/plugins/code-review

arthur_common-0.0.0.post0/.github/workflows/claude.yml

@@ -0,0 +1,50 @@
+name: Claude Code
+
+on:
+  issue_comment:
+    types: [created]
+  pull_request_review_comment:
+    types: [created]
+  issues:
+    types: [opened, assigned]
+  pull_request_review:
+    types: [submitted]
+
+jobs:
+  claude:
+    if: |
+      (github.event_name == 'issue_comment' && contains(github.event.comment.body, '@claude')) ||
+      (github.event_name == 'pull_request_review_comment' && contains(github.event.comment.body, '@claude')) ||
+      (github.event_name == 'pull_request_review' && contains(github.event.review.body, '@claude')) ||
+      (github.event_name == 'issues' && (contains(github.event.issue.body, '@claude') || contains(github.event.issue.title, '@claude')))
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      pull-requests: write
+      issues: read
+      id-token: write
+      actions: read # Required for Claude to read CI results on PRs
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 1
+
+      - name: Run Claude Code
+        id: claude
+        uses: anthropics/claude-code-action@v1
+        with:
+          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
+
+          # This is an optional setting that allows Claude to read CI results on PRs
+          additional_permissions: |
+            actions: read
+
+          # Optional: Give a custom prompt to Claude. If this is not specified, Claude will perform the instructions specified in the comment that tagged it.
+          # prompt: 'Update the pull request description to include a summary of changes.'
+
+          # Optional: Add claude_args to customize behavior and configuration
+          # See https://github.com/anthropics/claude-code-action/blob/main/docs/usage.md
+          # or https://code.claude.com/docs/en/cli-reference for available options
+          # claude_args: '--allowed-tools Bash(gh pr:*)'
+

arthur_common-0.0.0.post0/.github/workflows/composite-actions/setup-git/action.yml

@@ -0,0 +1,34 @@
+name: 'Setup Git'
+description: 'Installs and configures Git'
+
+inputs:
+  safe-directory:
+    description: 'Directory to mark as safe for Git operations'
+    required: true
+
+runs:
+  using: 'composite'
+  steps:
+    - name: 'Configure Git user'
+      shell: bash
+      run: |
+        git config --global user.email "github_ci@arthur.ai"
+        git config --global user.name "GitHub CI"
+
+    - name: 'Configure safe directory'
+      shell: bash
+      # run: git config --global --add safe.directory ${{ inputs.safe-directory }}
+      # run: git config --global --add safe.directory ${{ runner.workspace }}
+      run: git config --global --add safe.directory /__w/arthur-common/arthur-common
+
+    - name: 'Fetch tags'
+      shell: bash
+      run: git fetch --tags origin || true
+
+    - name: 'Show recent commits'
+      shell: bash
+      run: git log -n2
+
+    - name: 'Show repository status'
+      shell: bash
+      run: git status

arthur_common-0.0.0.post0/.github/workflows/composite-actions/setup-poetry/action.yml

@@ -0,0 +1,17 @@
+name: 'Setup Poetry'
+description: 'Installs and configures Poetry'
+
+inputs:
+  poetry-version:
+    description: 'Poetry version to install'
+    required: true
+    default: '2.1.3'
+
+runs:
+  using: 'composite'
+  steps:
+    - name: 'Setup Poetry'
+      shell: bash
+      run: |
+        pip install poetry==${{ inputs.poetry-version }}
+        poetry install

arthur_common-0.0.0.post0/.github/workflows/composite-actions/setup-uv/action.yml

@@ -0,0 +1,13 @@
+name: 'Setup uv'
+description: 'Installs uv and syncs dependencies'
+
+runs:
+  using: 'composite'
+  steps:
+    - name: 'Install uv'
+      uses: astral-sh/setup-uv@v5
+      with:
+        version: "0.11.7"
+    - name: 'Install dependencies'
+      shell: bash
+      run: uv sync --all-groups --frozen

arthur_common-0.0.0.post0/.gitignore

@@ -0,0 +1,126 @@
+.idea
+
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+.hypothesis/
+.pytest_cache/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+.target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+.python-version
+
+# pipenv
+Pipfile.lock
+
+# PEP 582; used by e.g. github.com/David-OConnor/pyflow
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# pytype static type analyzer
+.pytype/
+
+# Cython debug symbols
+cython_debug/

arthur_common-0.0.0.post0/.pre-commit-config.yaml

@@ -0,0 +1,61 @@
+repos:
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v5.0.0
+    hooks:
+      - id: trailing-whitespace
+      - id: end-of-file-fixer
+      - id: check-yaml
+      - id: debug-statements
+      - id: name-tests-test
+        args: ["--pytest-test-first"]
+        exclude: |
+          (?x)^(
+            tests/test_data/|
+            tests/unit/aggregation_functions/helpers.py
+          )
+  - repo: https://github.com/pycqa/autoflake
+    rev: v2.2.1
+    hooks:
+      - id: autoflake
+        args:
+          - "--in-place"
+          - "--remove-all-unused-imports"
+          - "--recursive"
+        fail_fast: true
+  - repo: https://github.com/pycqa/isort
+    rev: 5.12.0
+    hooks:
+      - id: isort
+        name: "sort imports"
+        args: ["--profile", "black"]
+        fail_fast: true
+  - repo: https://github.com/psf/black
+    rev: 24.10.0
+    hooks:
+      - id: black
+        language_version: python3.12
+        fail_fast: true
+  - repo: https://github.com/asottile/add-trailing-comma
+    rev: v3.1.0
+    hooks:
+      - id: add-trailing-comma
+        name: "add trailing commas"
+        fail_fast: true
+  - repo: local
+    hooks:
+      - id: pytest-check
+        name: "pytest unit tests and coverage"
+        entry: uv run pytest tests/ --cov=arthur_common --cov-fail-under=45
+        language: system
+        types: [python]
+        pass_filenames: false
+        always_run: false
+        files: ^src/arthur_common/
+      - id: mypy
+        name: "mypy type checking"
+        entry: uv run mypy src/arthur_common/ --ignore-missing-imports
+        language: system
+        types: [python]
+        pass_filenames: false
+        always_run: false
+        files: ^src/arthur_common/