synth-curator 0.1.0__tar.gz

synth_curator-0.1.0/.github/workflows/release.yml

@@ -0,0 +1,94 @@
+name: release
+
+# Manual only, by design: nothing publishes on a push or tag. Go to the Actions tab, pick
+# "release", click "Run workflow", and choose which index to publish to. Auth is OIDC
+
+on:
+  workflow_dispatch:
+    inputs:
+      target:
+        description: "Which index to publish to"
+        required: true
+        type: choice
+        options: [testpypi, pypi]
+        default: testpypi
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - name: Build sdist + wheel
+        run: |
+          pip install build twine
+          python -m build
+          twine check dist/*
+      - uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+  publish-testpypi:
+    if: inputs.target == 'testpypi'
+    needs: build
+    runs-on: ubuntu-latest
+    environment: testpypi
+    permissions:
+      id-token: write   # required for Trusted Publishing - no token/secret used
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+      - uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          repository-url: https://test.pypi.org/legacy/
+          skip-existing: true   # testing often means re-running against the same version - skip instead of failing
+
+  publish-pypi:
+    if: inputs.target == 'pypi'
+    needs: build
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      id-token: write   # required for Trusted Publishing - no token/secret used
+      contents: write   # required to push the tag below
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+      - uses: pypa/gh-action-pypi-publish@release/v1
+
+      # Only reached if the publish step above succeeded - a tag only ever marks a commit that's
+      # actually live on PyPI, never a failed or in-progress attempt.
+      - name: Tag the released version
+        run: |
+          VERSION=$(python3 -c "import pathlib, re; f = next(pathlib.Path('dist').glob('*.whl')).name; print(re.match(r'^[^-]+-([^-]+)-', f).group(1))")
+          echo "TAG=v$VERSION" >> "$GITHUB_ENV"
+          git config user.name "github-actions[bot]"
+          git config user.email "41898282+github-actions[bot]@users.noreply.github.com"
+          git tag "v$VERSION"
+          git push origin "v$VERSION"
+
+      # Pulls this version's section out of CHANGELOG.md (everything between its "## x.y.z" header
+      # and the next one) as the release notes; falls back to a bare pointer if that section is
+      # missing, rather than publish an empty-looking release.
+      - name: Create the GitHub Release
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: |
+          VERSION="${TAG#v}"
+          awk -v ver="$VERSION" '
+            $0 ~ "^## " ver { found=1; next }
+            found && /^## / { exit }
+            found { print }
+          ' CHANGELOG.md > release_notes.md
+          if [ ! -s release_notes.md ]; then
+            echo "See [CHANGELOG.md](https://github.com/${{ github.repository }}/blob/main/CHANGELOG.md)." > release_notes.md
+          fi
+          gh release create "$TAG" --title "$TAG" --notes-file release_notes.md

synth_curator-0.1.0/.github/workflows/tests.yml

@@ -0,0 +1,66 @@
+name: tests
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+  workflow_dispatch:
+  schedule:
+    # catch a newly-disclosed CVE in an already-pinned dependency even when nothing in the repo
+    # changes to otherwise trigger a run.
+    - cron: "0 6 * * 1"
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.10", "3.11", "3.12"]
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      # [full] pulls in FSIM/LPIPS/BRISQUE/CLIP deps so the fuller suite runs, not just the core one.
+      - name: Install
+        run: pip install -e '.[dev,full]'
+
+      - name: Ruff
+        run: ruff check src/ tests/
+
+      - name: Pytest
+        run: pytest -q
+
+  security-audit:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      # pip itself gets audited otherwise (it's always present in the venv, but it isn't a
+      # dependency we actually ship) - upgrading first avoids that false positive every run.
+      - name: Install
+        run: |
+          pip install --upgrade pip
+          pip install pip-audit
+          pip install -e '.[full,yaml]'
+      - name: pip-audit
+        run: pip-audit
+
+  build:
+    runs-on: ubuntu-latest
+    needs: [test, security-audit]
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - name: Build sdist + wheel
+        run: |
+          pip install build twine
+          python -m build
+          twine check dist/*

synth_curator-0.1.0/.gitignore

@@ -0,0 +1,10 @@
+__pycache__/
+*.egg-info/
+dist/
+build/
+.venv/
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+*.pt
+!tests/fixtures/**/*.pt

synth_curator-0.1.0/CHANGELOG.md

@@ -0,0 +1,19 @@
+# Changelog
+
+## 0.1.0 — initial release
+
+- Full pipeline: standardize → extract features → compute metrics → curate metric sets → run
+  the tournament → derive per-class weights → curate the final set (`SynthCurator.run()`).
+- Two-tier training: cheap tournament ranking (`train_and_evaluate`) vs. an optional, one-time
+  production training call (`train_production`).
+- Pluggable scoring (`metric_beta` / `scoring`) and utility formulas (`utility_formula` /
+  `dist_utility_formula`).
+- Multi-GPU tournament dispatch (`model_factory` + `gpu_ids`).
+- Precomputed weights (`weights_path=` / `shipped_weights=`) to skip the tournament entirely —
+  ships with two ISIC-2018 presets (`isic2018_swin_b`, `isic2018_resnet50`).
+- `resample()` for model-locked, data-variance-swept validation sweeps, with matching config/CLI
+  support (`resample:` section).
+- Config file (`config.example.yaml` / `config.example.shipped.yaml`) + `synth-curator` CLI as an
+  alternative to the Python API.
+- Fingerprint-based resumability on every cacheable step; `pool_workdir` for sharing steps 1-3
+  across a sweep.

synth_curator-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Amindu Kumarasinghe
+
+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.