lite-runner 0.1.1__tar.gz

lite_runner-0.1.1/.copier-answers.yml

@@ -0,0 +1,19 @@
+# Changes here will be overwritten by Copier; NEVER EDIT MANUALLY
+_commit: v0.26.2
+_src_path: https://github.com/tsvikas/python-template
+cli_framework: none
+format_tool: ruff
+get_package_version_from_vcs: true
+github_user: moonmath-ai
+in_codecov: true
+in_pypi: true
+in_rtd: false
+jupyter_files: forbid
+license: MIT
+package_description: Runner for generative models with local and W&B tracking.
+package_name: lite_runner
+project_name: LiteRunner
+python_min: 10
+user_email: tsvika@moonmath.ai
+user_name: MoonMath.ai
+year: 2026

lite_runner-0.1.1/.editorconfig

@@ -0,0 +1,30 @@
+root = true
+
+[*]
+indent_style = space
+end_of_line = lf
+charset = utf-8
+trim_trailing_whitespace = true
+insert_final_newline = true
+
+# common file types with indent=2
+[*.{toml,yaml,yml}]
+indent_size = 2
+
+# CSV-like
+[*.{tsv,tab,csv}]
+indent_style = unset
+trim_trailing_whitespace = false
+insert_final_newline = false
+
+# These file types are formatted with tools (indent=2)
+[*.{md,sh,json}]
+indent_size = unset
+
+# These file types are formatted with tools (indent=4)
+[*.{py,fish}]
+indent_size = unset
+
+# LICENSE files
+[LICENSE]
+indent_size = unset

lite_runner-0.1.1/.git_archival.txt

@@ -0,0 +1,3 @@
+node: $Format:%H$
+node-date: $Format:%cI$
+describe-name: $Format:%(describe:tags=true,match=*[0-9]*)$

lite_runner-0.1.1/.gitattributes

@@ -0,0 +1 @@
+.git_archival.txt  export-subst

lite_runner-0.1.1/.github/dependabot.yml

@@ -0,0 +1,9 @@
+version: 2
+updates:
+  - package-ecosystem: github-actions
+    directory: /
+    schedule:
+      interval: weekly
+    groups:
+      github-actions:
+        patterns: ['*']

lite_runner-0.1.1/.github/release.yml

@@ -0,0 +1,5 @@
+changelog:
+  exclude:
+    authors:
+      - dependabot[bot]
+      - pre-commit-ci[bot]

lite_runner-0.1.1/.github/workflows/build-and-publish.yml

@@ -0,0 +1,78 @@
+# Configure trusted publishing for this workflow.
+# See: https://packaging.python.org/en/latest/guides/publishing-package-distribution-releases-using-github-actions-ci-cd-workflows/
+# Go to: https://pypi.org/manage/account/publishing/
+# Fill: lite-runner / moonmath-ai / LiteRunner / build-and-publish.yml / pypi
+# Go to: https://test.pypi.org/manage/account/publishing/
+# Fill: lite-runner / moonmath-ai / LiteRunner / build-and-publish.yml / testpypi
+
+name: Build and Publish
+
+on:
+  push:
+    tags: ['v*']
+  release:
+    types: [published]
+
+permissions:
+  contents: read
+
+env:
+  # Many color libraries just need this variable to be set to any value.
+  # Set it to 3 to support 8-bit color graphics (256 colors per channel)
+  # for libraries that care about the value set.
+  FORCE_COLOR: 3
+
+jobs:
+  ci:
+    uses: ./.github/workflows/ci.yml
+
+  build-and-inspect-package:
+    needs: ci
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+        with:
+          persist-credentials: false
+      - uses: hynek/build-and-inspect-python-package@v2
+
+  publish-to-testpypi:
+    if: github.event_name == 'push'
+    needs: build-and-inspect-package
+    runs-on: ubuntu-latest
+    environment:
+      name: testpypi
+      url: https://test.pypi.org/p/lite-runner
+    permissions:
+      # IMPORTANT: this permission is mandatory for trusted publishing, but
+      # should NOT be granted anywhere else!
+      id-token: write
+    steps:
+      - name: Download package distributions
+        uses: actions/download-artifact@v7
+        with:
+          name: Packages
+          path: dist/
+      - name: Publish distribution to TestPyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          repository-url: https://test.pypi.org/legacy/
+
+  publish-to-pypi:
+    if: github.event_name == 'release'
+    needs: build-and-inspect-package
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/p/lite-runner
+    permissions:
+      # IMPORTANT: this permission is mandatory for trusted publishing, but
+      # should NOT be granted anywhere else!
+      id-token: write
+    steps:
+      - name: Download package distributions
+        uses: actions/download-artifact@v7
+        with:
+          name: Packages
+          path: dist/
+      - name: Publish distribution to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

lite_runner-0.1.1/.github/workflows/ci.yml

@@ -0,0 +1,230 @@
+name: CI
+
+on:
+  workflow_dispatch:
+  pull_request:
+  push:
+    branches: [main, develop]
+  workflow_call:
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+permissions:
+  contents: read
+
+env:
+  # Many color libraries just need this variable to be set to any value.
+  # Set it to 3 to support 8-bit color graphics (256 colors per channel)
+  # for libraries that care about the value set.
+  FORCE_COLOR: 3
+
+jobs:
+  format-python:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+        with:
+          persist-credentials: false
+      - uses: astral-sh/ruff-action@v3
+        with:
+          args: format --check
+
+  ruff-check:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+        with:
+          persist-credentials: false
+      - uses: astral-sh/ruff-action@v3
+
+  pre-commit:
+    env:
+      COLUMNS: 120
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+        with:
+          persist-credentials: false
+      - uses: pre-commit/action@v3.0.1
+
+  mypy:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+        with:
+          persist-credentials: false
+      - uses: astral-sh/setup-uv@v7
+      - name: Install packages
+        run: >-
+          uv sync
+          --exact
+          --all-extras
+          --no-default-groups
+          --group typing
+          --group test
+          --locked
+      - name: List packages
+        run: uv pip list
+      - name: Run mypy
+        run: uv run --no-sync mypy
+
+  dependencies:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+        with:
+          persist-credentials: false
+      - uses: astral-sh/setup-uv@v7
+      - name: Install packages
+        run: >-
+          uv sync
+          --exact
+          --all-extras
+          --all-groups
+          --locked
+      - name: List packages
+        run: uv pip list
+      - name: Run deptry
+        run: uv run --no-sync --with deptry -- deptry src/
+      - name: Run pip-audit
+        run: >-
+          uv run --no-sync --with pip-audit -- pip-audit --skip-editable
+
+
+  test:
+    strategy:
+      matrix:
+        include:
+          # test with highest resolution
+          - resolution: highest
+            os: ubuntu-latest
+            python-version: '3.14'
+          # test with lowest resolution
+          - resolution: lowest
+            os: ubuntu-latest
+            python-version: '3.10'
+          # test with different os
+          - resolution: locked
+            os: ubuntu-latest
+            python-version: '3.10'
+          - resolution: locked
+            os: macos-latest
+            python-version: '3.10'
+          # - resolution: locked
+          #   os: windows-latest
+          #   python-version: '3.10'
+      fail-fast: false
+    runs-on: ${{ matrix.os }}
+    name: test-${{ matrix.python-version }}-${{ matrix.resolution }}-${{ matrix.os }}
+    steps:
+      - uses: actions/checkout@v6
+        with:
+          persist-credentials: false
+      - uses: astral-sh/setup-uv@v7
+        with:
+          python-version: ${{ matrix.python-version }}
+          cache-suffix: ${{ matrix.resolution }}
+      - name: Install packages
+        id: install_packages
+        run: >-
+          uv sync
+          --exact
+          --all-extras
+          --no-default-groups
+          --group test
+          ${{ matrix.resolution == 'locked' && '--locked'
+              || matrix.resolution == 'lowest' && '--upgrade --resolution lowest-direct'
+              || matrix.resolution == 'highest' && '--upgrade --resolution highest'
+              || '--NON_RECOGNIZED_RESOLUTION'
+          }}
+      - name: List packages
+        run: uv pip list
+      - name: Run tests
+        id: run_tests
+        run: >-
+          uv run --no-sync --
+          pytest
+          --cov-branch
+          --cov-report=term
+          --cov-report=xml
+          --junitxml=junit.xml
+      - name: Upload test results to Codecov
+        if: ${{ !cancelled() && steps.run_tests.conclusion != 'skipped' }}
+        uses: codecov/test-results-action@v1
+        with:
+          token: ${{ secrets.CODECOV_TOKEN }}
+      - name: Upload coverage reports to Codecov
+        uses: codecov/codecov-action@v5
+        with:
+          token: ${{ secrets.CODECOV_TOKEN }}
+
+
+  test-pypy-and-prerelease:
+    strategy:
+      matrix:
+        include:
+          # test with pypy
+          - resolution: highest
+            os: ubuntu-latest
+            python-version: 'pypy3.11'
+          # test on prerelease
+          - resolution: prerelease
+            os: ubuntu-latest
+            python-version: '3.14'
+          - resolution: prerelease
+            os: ubuntu-latest
+            python-version: '3.15'
+      fail-fast: false
+    runs-on: ${{ matrix.os }}
+    name: test-${{ matrix.python-version }}-${{ matrix.resolution }}-${{ matrix.os }}
+    steps:
+      - uses: actions/checkout@v6
+        with:
+          persist-credentials: false
+      - uses: astral-sh/setup-uv@v7
+        with:
+          python-version: ${{ matrix.python-version }}
+          cache-suffix: ${{ matrix.resolution }}
+      - name: Install packages
+        id: install_packages
+        run: >-
+          uv sync
+          --exact
+          --all-extras
+          --no-default-groups
+          --group test
+          ${{ matrix.resolution == 'locked' && '--locked'
+              || matrix.resolution == 'lowest' && '--upgrade --resolution lowest-direct'
+              || matrix.resolution == 'highest' && '--upgrade --resolution highest'
+              || matrix.resolution == 'prerelease' && '--upgrade --resolution highest --prerelease allow'
+              || '--NON_RECOGNIZED_RESOLUTION'
+          }}
+        continue-on-error: true
+      - name: Stop job with warning if install fails
+        if: ${{ steps.install_packages.outcome == 'failure' }}
+        run: >-
+          echo "::warning::Stopping job due to installation failure on Python ${{ matrix.python-version }}"
+      - name: List packages
+        if: ${{ steps.install_packages.outcome == 'success' }}
+        run: uv pip list
+      - name: Run tests
+        if: ${{ steps.install_packages.outcome == 'success' }}
+        run: uv run --no-sync -- pytest --cov-branch --cov-report=xml --junitxml=junit.xml
+
+  pass:
+    if: ${{ always() }}
+    needs:
+      - format-python
+      - ruff-check
+      - pre-commit
+      - mypy
+      - dependencies
+      - test
+      - test-pypy-and-prerelease
+    runs-on: ubuntu-latest
+    steps:
+      - uses: re-actors/alls-green@release/v1
+        with:
+          jobs: ${{ toJSON(needs) }}

lite_runner-0.1.1/.github/workflows/deps-update.yml

@@ -0,0 +1,54 @@
+name: Update Dependencies
+
+on:
+  workflow_dispatch:
+
+jobs:
+  update-deps:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+      pull-requests: write
+
+    steps:
+      - uses: actions/checkout@v6
+        with:
+          persist-credentials: false
+      - uses: astral-sh/setup-uv@v7
+      - name: Sync dependencies
+        run: uv sync
+      - name: Update dependencies
+        run: uv run just deps-update
+      - name: Run security audit
+        id: audit
+        run: |
+          echo 'AUDIT<<EOF' >> "$GITHUB_OUTPUT"
+          uv run just deps-audit 2>&1 || true
+          echo 'EOF' >> "$GITHUB_OUTPUT"
+      - name: Check outdated packages
+        id: outdated
+        run: |
+          echo 'OUTDATED<<EOF' >> "$GITHUB_OUTPUT"
+          uv run just deps-list-outdated 2>&1 || true
+          echo 'EOF' >> "$GITHUB_OUTPUT"
+      - name: Create Pull Request
+        uses: peter-evans/create-pull-request@v8
+        with:
+          token: ${{ secrets.GITHUB_TOKEN }}
+          commit-message: "⬆️ Update project dependencies"
+          title: "⬆️ Update project dependencies"
+          body: |
+            Automated dependency update.
+
+            ## Security Audit
+            ```
+            ${{ steps.audit.outputs.AUDIT }}
+            ```
+
+            ## Outdated Packages
+            ```
+            ${{ steps.outdated.outputs.OUTDATED }}
+            ```
+          branch: deps/update
+          delete-branch: true
+          labels: dependencies

lite_runner-0.1.1/.github/workflows/weekly-ci.yml

@@ -0,0 +1,160 @@
+name: Scheduled CI
+
+on:
+  workflow_dispatch:
+  schedule:
+    - cron: 0 6 * * 0  # Sunday at 6 AM UTC
+
+permissions:
+  contents: read
+  issues: write
+
+env:
+  # Many color libraries just need this variable to be set to any value.
+  # Set it to 3 to support 8-bit color graphics (256 colors per channel)
+  # for libraries that care about the value set.
+  FORCE_COLOR: 3
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    timeout-minutes: 30
+    steps:
+      - uses: actions/checkout@v6
+        with:
+          persist-credentials: false
+      - uses: astral-sh/setup-uv@v7
+        with:
+          python-version: '3.14'
+          enable-cache: false
+      - name: Install packages
+        run: >-
+          uv sync
+          --exact
+          --all-extras
+          --no-default-groups
+          --group test
+          --upgrade
+          --resolution highest
+      - name: List packages
+        run: uv pip list
+      - name: Run tests
+        run: uv run --no-sync pytest
+      - name: Create failure issue
+        if: failure()
+        uses: actions/github-script@v8
+        with:
+          script: |
+            // Check for existing test failure issues
+            const existingIssues = await github.rest.issues.listForRepo({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              state: 'open',
+              labels: 'scheduled-ci-tests',
+              per_page: 10
+            });
+
+            if (existingIssues.data.length > 0) {
+              // Update existing issue
+              const existingIssue = existingIssues.data[0];
+              await github.rest.issues.createComment({
+                owner: context.repo.owner,
+                repo: context.repo.repo,
+                issue_number: existingIssue.number,
+                body: `Another test failure occurred on ${context.sha.substring(0, 7)}, see the [workflow run](${context.payload.repository.html_url}/actions/runs/${context.runId})`
+              });
+              await core.notice(`Updated existing issue ${existingIssue.html_url}`);
+
+            } else {
+              // Create new issue
+              const issue = await github.rest.issues.create({
+                owner: context.repo.owner,
+                repo: context.repo.repo,
+                title: `Scheduled CI Tests Failed - ${new Date().toISOString().split('T')[0]}`,
+                body: `The scheduled CI tests failed on ${context.sha.substring(0, 7)}.
+
+            **Failed Jobs:**
+            - Check the [workflow run](${context.payload.repository.html_url}/actions/runs/${context.runId})
+
+            **Likely Causes:**
+            - New dependency versions with breaking changes
+
+            **Next Steps:**
+            - Review the logs above
+            - Update code for new dependencies or limit package versions
+            - Re-run the workflow to verify fixes`,
+                labels: ['scheduled-ci-tests'],
+                assignees: [context.repo.owner],
+              });
+              await core.notice(`Created issue ${issue.data.html_url}`);
+            }
+
+  pip-audit:
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+    steps:
+      - uses: actions/checkout@v6
+        with:
+          persist-credentials: false
+      - uses: astral-sh/setup-uv@v7
+      - name: Export packages
+        run: >-
+          uv export
+          --all-packages
+          --all-extras
+          --all-groups
+          -o requirements.txt
+          --no-emit-local
+          --locked
+      - uses: pypa/gh-action-pip-audit@v1.1.0
+        with:
+          inputs: requirements.txt
+          require-hashes: true
+      - name: Create failure issue
+        if: failure()
+        uses: actions/github-script@v8
+        with:
+          script: |
+            // Check for existing audit failure issues
+            const existingIssues = await github.rest.issues.listForRepo({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              state: 'open',
+              labels: 'scheduled-ci-audit',
+              per_page: 10
+            });
+
+            if (existingIssues.data.length > 0) {
+              // Update existing issue instead of creating new one
+              const existingIssue = existingIssues.data[0];
+              await github.rest.issues.createComment({
+                owner: context.repo.owner,
+                repo: context.repo.repo,
+                issue_number: existingIssue.number,
+                body: `Another audit failure occurred on ${context.sha.substring(0, 7)}, see the [workflow run](${context.payload.repository.html_url}/actions/runs/${context.runId})`
+              });
+              await core.notice(`Updated existing issue ${existingIssue.html_url}`);
+
+            } else {
+              // Create new issue
+              const issue = await github.rest.issues.create({
+                owner: context.repo.owner,
+                repo: context.repo.repo,
+                title: `Scheduled CI Audit Failed - ${new Date().toISOString().split('T')[0]}`,
+                body: `The scheduled CI audit check failed on ${context.sha.substring(0, 7)}.
+
+            **Failed Jobs:**
+            - Check the [workflow run](${context.payload.repository.html_url}/actions/runs/${context.runId})
+
+            **Likely Causes:**
+            - New security vulnerabilities detected by pip-audit
+
+            **Next Steps:**
+            - Review the logs above
+            - Update locked dependencies
+            - Re-run the workflow to verify fixes`,
+                labels: ['scheduled-ci-audit'],
+                assignees: [context.repo.owner],
+              });
+              await core.notice(`Created issue ${issue.data.html_url}`);
+            }

lite_runner-0.1.1/.gitignore

@@ -0,0 +1,71 @@
+# Created by https://www.toptal.com/developers/gitignore/api/pythonvanilla
+# Edit at https://www.toptal.com/developers/gitignore?templates=pythonvanilla
+
+### PythonVanilla ###
+# 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/
+__pypackages__/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# Unit test / coverage reports
+.cache
+.pytest_cache/
+.coverage
+
+# End of https://www.toptal.com/developers/gitignore/api/pythonvanilla
+
+
+# version file
+_version.py
+
+# virtual envs
+venv/
+.venv/
+
+# mkdocs documentation
+/site
+/docs/reference
+
+# development tools
+.mypy_cache/
+.dmypy.json
+.ruff_cache/
+.hypothesis/
+.benchmarks/
+
+# Secrets
+.env
+
+# jupyter
+.ipynb_checkpoints/
+
+# TODO
+TODO*
+
+
+# specific to this project:
+wandb/