atomic-keygen 1.0__tar.gz

atomic_keygen-1.0/.copier-answers.yml

@@ -0,0 +1,12 @@
+# Changes here will be overwritten by Copier; NEVER EDIT MANUALLY
+_commit: 1.8-13-g86b0a7d
+_src_path: /home/maximiliantodea/Github/github-infra
+description: Zero-dependency generic seeded generator framework with dedup and SQLite
+    persistence.
+development_status: 5 - Production/Stable
+min_python: '3.12'
+optional_extras:
+    sobol:
+    - scipy>=1.12
+package_name: keygen
+project_name: atomic-keygen

atomic_keygen-1.0/.github/workflows/release.yml

@@ -0,0 +1,110 @@
+name: Prepare Release Branch
+
+# Trigger manually from the Actions UI. The workflow will create
+# release/<version> from the selected dev branch when it does not exist yet,
+# or reuse the existing release branch when it is already present.
+on:
+  workflow_dispatch:
+    inputs:
+      dev-branch:
+        description: "Source dev branch to branch from when creating the release branch"
+        required: true
+        default: ""
+      version:
+        description: "Release version without the leading v; used as release/<version>"
+        required: true
+        default: ""
+
+permissions:
+  contents: write
+  pull-requests: write
+  models: read
+
+jobs:
+  setup:
+    name: Parse release inputs
+    runs-on: ubuntu-latest
+    outputs:
+      fingerprints: ${{ steps.parse.outputs.fingerprints }}
+      version: ${{ steps.parse.outputs.version }}
+      dev_branch: ${{ steps.parse.outputs.dev_branch }}
+      release_branch: ${{ steps.parse.outputs.release_branch }}
+      groom_branch: ${{ steps.parse.outputs.groom_branch }}
+
+    steps:
+      - name: Parse workflow inputs
+        id: parse
+        run: |
+          VERSION_INPUT="${{ github.event.inputs.version || '' }}"
+          DEV_BRANCH="${{ github.event.inputs['dev-branch'] || '' }}"
+
+          VERSION="${VERSION_INPUT#v}"
+          VERSION="${VERSION#release/}"
+
+          if [ -z "$VERSION" ]; then
+            echo "Version input is required." >&2
+            exit 1
+          fi
+
+          if [ -z "$DEV_BRANCH" ]; then
+            echo "dev-branch input is required." >&2
+            exit 1
+          fi
+
+          RELEASE_BRANCH="release/${VERSION}"
+          GROOM_BRANCH="groom/release-${VERSION}"
+
+          echo "version=${VERSION}" >> "$GITHUB_OUTPUT"
+          echo "dev_branch=${DEV_BRANCH}" >> "$GITHUB_OUTPUT"
+          echo "release_branch=${RELEASE_BRANCH}" >> "$GITHUB_OUTPUT"
+          echo "groom_branch=${GROOM_BRANCH}" >> "$GITHUB_OUTPUT"
+          {
+            echo 'fingerprints<<EOF'
+            echo 'fingerprints/standardize-docstrings.md'
+            echo 'fingerprints/standardize-comments.md'
+            echo 'EOF'
+          } >> "$GITHUB_OUTPUT"
+
+          echo "Dev branch     : $DEV_BRANCH"
+          echo "Release branch : $RELEASE_BRANCH"
+          echo "Version        : $VERSION"
+
+  ensure-release-branch:
+    name: Ensure release branch exists
+    needs: setup
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+          token: ${{ secrets.TEMPLATE_SYNC_TOKEN != '' && secrets.TEMPLATE_SYNC_TOKEN || github.token }}
+
+      - name: Create or reuse release branch
+        env:
+          DEV_BRANCH: ${{ needs.setup.outputs.dev_branch }}
+          RELEASE_BRANCH: ${{ needs.setup.outputs.release_branch }}
+        run: |
+          if git ls-remote --exit-code --heads origin "refs/heads/${RELEASE_BRANCH}" >/dev/null 2>&1; then
+            echo "Release branch already exists on origin: ${RELEASE_BRANCH}"
+            exit 0
+          fi
+
+          git fetch origin "$DEV_BRANCH" --no-tags
+          git config user.name  "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+          git switch -C "$RELEASE_BRANCH" "origin/$DEV_BRANCH"
+          git push origin "$RELEASE_BRANCH"
+
+  review:
+    name: Groom release branch
+    needs: [setup, ensure-release-branch]
+    uses: importt-ant/github-infra/.github/workflows/prepare-for-release.yml@main
+    with:
+      python-version: "3.12"
+      fingerprints: ${{ needs.setup.outputs.fingerprints }}
+      source-branch: ${{ needs.setup.outputs.release_branch }}
+      working-branch: ${{ needs.setup.outputs.groom_branch }}
+      pr-base-branch: ${{ needs.setup.outputs.release_branch }}
+      run-doc-generator: true
+    secrets: inherit

atomic_keygen-1.0/.github/workflows/sync-template.yml

@@ -0,0 +1,191 @@
+name: Sync Template
+
+# automatically syncs with copier
+
+on:
+  repository_dispatch:
+    types: [github-infra-template-update]
+  workflow_dispatch:
+    inputs:
+      template-ref:
+        description: "Commit SHA or ref from github-infra to apply"
+        required: false
+        default: ""
+
+permissions:
+  contents: write
+  pull-requests: write
+
+concurrency:
+  group: template-sync
+  cancel-in-progress: false
+
+jobs:
+  sync-template:
+    name: Sync Copier template
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+          token: ${{ secrets.TEMPLATE_SYNC_TOKEN != '' && secrets.TEMPLATE_SYNC_TOKEN || github.token }}
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install copier
+        run: pip install --quiet copier
+
+      - name: Check copier setup
+        id: setup
+        run: |
+          if [ ! -f .copier-answers.yml ]; then
+            echo "enabled=false" >> "$GITHUB_OUTPUT"
+            echo "No .copier-answers.yml found; skipping."
+            exit 0
+          fi
+
+          if ! grep -q 'github-infra' .copier-answers.yml; then
+            echo "enabled=false" >> "$GITHUB_OUTPUT"
+            echo "This repo is not initialized from github-infra; skipping."
+            exit 0
+          fi
+
+          echo "enabled=true" >> "$GITHUB_OUTPUT"
+
+      - name: Resolve template ref
+        if: steps.setup.outputs.enabled == 'true'
+        id: ref
+        env:
+          EVENT_TEMPLATE_REF: ${{ github.event.client_payload.template_ref || '' }}
+          INPUT_TEMPLATE_REF: ${{ github.event.inputs['template-ref'] || '' }}
+        run: |
+          TEMPLATE_REF="${EVENT_TEMPLATE_REF:-$INPUT_TEMPLATE_REF}"
+          TEMPLATE_REF="${TEMPLATE_REF:-main}"
+
+          if printf '%s' "$TEMPLATE_REF" | grep -Eq '^[0-9a-f]{40}$'; then
+            TEMPLATE_SHA="$TEMPLATE_REF"
+          else
+            TEMPLATE_SHA=$(git ls-remote https://github.com/importt-ant/github-infra.git "$TEMPLATE_REF" | awk 'NR==1 {print $1}')
+          fi
+
+          if [ -z "$TEMPLATE_SHA" ]; then
+            echo "Could not resolve github-infra ref: $TEMPLATE_REF" >&2
+            exit 1
+          fi
+
+          SHORT_SHA="$(printf '%s' "$TEMPLATE_SHA" | cut -c1-12)"
+          BRANCH="chore/template-sync-${SHORT_SHA}"
+          echo "template_ref=${TEMPLATE_REF}" >> "$GITHUB_OUTPUT"
+          echo "template_sha=${TEMPLATE_SHA}" >> "$GITHUB_OUTPUT"
+          echo "short_sha=${SHORT_SHA}" >> "$GITHUB_OUTPUT"
+          echo "branch=${BRANCH}" >> "$GITHUB_OUTPUT"
+
+      - name: Create sync branch
+        if: steps.setup.outputs.enabled == 'true'
+        id: branch
+        env:
+          BRANCH: ${{ steps.ref.outputs.branch }}
+        run: |
+          git config user.name  "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+          START_SHA="$(git rev-parse HEAD)"
+          git switch -C "$BRANCH"
+          echo "start_sha=${START_SHA}" >> "$GITHUB_OUTPUT"
+
+      - name: Normalize copier source
+        if: steps.setup.outputs.enabled == 'true'
+        env:
+          TEMPLATE_SHA: ${{ steps.ref.outputs.template_sha }}
+        run: |
+          python - <<'PY'
+          from pathlib import Path
+
+          path = Path('.copier-answers.yml')
+          lines = path.read_text(encoding='utf-8').splitlines()
+          updated: list[str] = []
+          changed = False
+
+          for line in lines:
+              if line.startswith('_src_path:'):
+                  desired = '_src_path: gh:importt-ant/github-infra'
+                  updated.append(desired)
+                  changed = changed or line != desired
+              else:
+                  updated.append(line)
+
+          if changed:
+              path.write_text('\n'.join(updated) + '\n', encoding='utf-8')
+          PY
+
+          if [ -n "$(git status --porcelain .copier-answers.yml)" ]; then
+            git add .copier-answers.yml
+            git commit -m "chore(template): normalize copier source ${TEMPLATE_SHA} [skip ci]"
+          fi
+
+      - name: Run copier update
+        if: steps.setup.outputs.enabled == 'true'
+        env:
+          TEMPLATE_REF: ${{ steps.ref.outputs.template_ref }}
+        run: |
+          copier update --trust --defaults --vcs-ref "$TEMPLATE_REF"
+
+      - name: Commit and push
+        if: steps.setup.outputs.enabled == 'true'
+        id: commit
+        env:
+          SHORT_SHA: ${{ steps.ref.outputs.short_sha }}
+          BRANCH: ${{ steps.ref.outputs.branch }}
+          START_SHA: ${{ steps.branch.outputs.start_sha }}
+        run: |
+          if [ -n "$(git status --porcelain)" ]; then
+            git add -A
+            git commit -m "chore(template): sync github-infra ${SHORT_SHA} [skip ci]"
+          fi
+
+          if [ "$(git rev-parse HEAD)" = "$START_SHA" ]; then
+            echo "No template changes."
+            echo "branch=" >> "$GITHUB_OUTPUT"
+            exit 0
+          fi
+
+          git push --force-with-lease origin "$BRANCH"
+          echo "branch=${BRANCH}" >> "$GITHUB_OUTPUT"
+
+      - name: Open pull request
+        if: steps.commit.outputs.branch != ''
+        env:
+          GH_TOKEN: ${{ secrets.TEMPLATE_SYNC_TOKEN != '' && secrets.TEMPLATE_SYNC_TOKEN || github.token }}
+          BRANCH: ${{ steps.commit.outputs.branch }}
+          TEMPLATE_REF: ${{ steps.ref.outputs.template_ref }}
+          TEMPLATE_SHA: ${{ steps.ref.outputs.template_sha }}
+          SHORT_SHA: ${{ steps.ref.outputs.short_sha }}
+          BASE_BRANCH: ${{ github.event.repository.default_branch }}
+        run: |
+          EXISTING=$(gh pr list --head "$BRANCH" --base "$BASE_BRANCH" --json url --jq '.[0].url' 2>/dev/null || true)
+
+          if [ -n "$EXISTING" ]; then
+            echo "PR already exists: $EXISTING"
+          else
+            BODY=$(cat <<EOF
+          ## Automated template sync
+
+          This PR updates the repository from the latest `github-infra` Copier template ref: `${TEMPLATE_REF}`.
+
+          - resolved commit: `${TEMPLATE_SHA}`
+
+          ### What ran
+          - normalized `.copier-answers.yml` to use the remote template source
+          - ran `copier update --trust --defaults --vcs-ref ${TEMPLATE_REF}`
+
+          Review and merge when the generated changes look correct.
+          EOF
+            )
+            gh pr create \
+              --title "chore(template): sync github-infra ${SHORT_SHA}" \
+              --body "$BODY" \
+              --base "$BASE_BRANCH" \
+              --head "$BRANCH"
+          fi

atomic_keygen-1.0/.github/workflows/tag.yml

@@ -0,0 +1,171 @@
+name: Release and Publish
+
+# Trigger manually from the GitHub Actions UI while the selected ref is the
+# release/x.y.z branch you want to ship.
+#
+# The workflow:
+#   1. runs pytest on the release branch
+#   2. creates and pushes tag vX.Y.Z from that branch
+#   3. creates the GitHub release
+#   4. publishes to PyPI
+#   5. opens PRs from release/x.y.z into main and dev/x.y
+#
+on:
+  workflow_dispatch:
+    inputs:
+      version:
+        description: "Release version without the leading v; defaults to the selected release/x.y.z branch suffix"
+        required: false
+        default: ""
+
+permissions:
+  contents: write
+  id-token: write
+  pull-requests: write
+
+jobs:
+  setup:
+    name: Parse release inputs
+    runs-on: ubuntu-latest
+    outputs:
+      tag: ${{ steps.parse.outputs.tag }}
+      version: ${{ steps.parse.outputs.version }}
+      release_branch: ${{ steps.parse.outputs.release_branch }}
+      dev_branch: ${{ steps.parse.outputs.dev_branch }}
+    steps:
+      - name: Parse version from branch
+        id: parse
+        run: |
+          BRANCH="${GITHUB_REF_NAME}"
+          if [[ "$BRANCH" != release/* ]]; then
+            echo "This workflow must be run from a release/x.y.z branch; got '$BRANCH'" >&2
+            exit 1
+          fi
+
+          VERSION_INPUT="${{ github.event.inputs.version || '' }}"
+          VERSION="${VERSION_INPUT:-${BRANCH#release/}}"
+          TAG="v${VERSION}"
+          MAJOR="$(echo "$VERSION" | cut -d. -f1)"
+          MINOR="$(echo "$VERSION" | cut -d. -f2)"
+          RELEASE_BRANCH="$BRANCH"
+          DEV_BRANCH="dev/${MAJOR}.${MINOR}"
+
+          echo "branch=${BRANCH}"
+          echo "tag=${TAG}" >> "$GITHUB_OUTPUT"
+          echo "version=${VERSION}" >> "$GITHUB_OUTPUT"
+          echo "release_branch=${RELEASE_BRANCH}" >> "$GITHUB_OUTPUT"
+          echo "dev_branch=${DEV_BRANCH}" >> "$GITHUB_OUTPUT"
+
+  pytest:
+    name: Run pytest before release
+    needs: setup
+    uses: importt-ant/github-infra/.github/workflows/run-pytest.yml@main
+    with:
+      python-version: "3.12"
+      checkout-ref: ${{ needs.setup.outputs.release_branch }}
+    secrets: inherit
+
+  create-release:
+    name: Create tag and GitHub release
+    needs: [setup, pytest]
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Create and push tag
+        env:
+          TAG: ${{ needs.setup.outputs.tag }}
+          RELEASE_BRANCH: ${{ needs.setup.outputs.release_branch }}
+        run: |
+          git fetch origin "$RELEASE_BRANCH" --tags --no-tags || true
+          git fetch origin "$RELEASE_BRANCH" --no-tags
+          git switch -C "$RELEASE_BRANCH" "origin/$RELEASE_BRANCH"
+
+          if git ls-remote --exit-code --tags origin "refs/tags/${TAG}" >/dev/null 2>&1; then
+            echo "Tag $TAG already exists on origin."
+          else
+            git tag "$TAG"
+            git push origin "$TAG"
+          fi
+
+      - name: Create published release from the dev line
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          TAG: ${{ needs.setup.outputs.tag }}
+          DEV_BRANCH: ${{ needs.setup.outputs.dev_branch }}
+        run: |
+          if gh release view "$TAG" >/dev/null 2>&1; then
+            echo "Release already exists for $TAG."
+          else
+            gh release create "$TAG" --verify-tag --generate-notes --target "$DEV_BRANCH"
+          fi
+
+  publish-to-pypi:
+    name: Publish to PyPI
+    needs: [setup, create-release]
+    runs-on: ubuntu-latest
+    environment: pypi
+
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+          token: ${{ secrets.TEMPLATE_SYNC_TOKEN != '' && secrets.TEMPLATE_SYNC_TOKEN || github.token }}
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install build
+        run: pip install build
+
+      - name: Build package
+        run: python -m build
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+
+  open-merge-prs:
+    name: Open merge PRs
+    needs: [setup, create-release, publish-to-pypi]
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Open PRs into main and dev
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          VERSION: ${{ needs.setup.outputs.version }}
+          RELEASE_BRANCH: ${{ needs.setup.outputs.release_branch }}
+          DEV_BRANCH: ${{ needs.setup.outputs.dev_branch }}
+        run: |
+          for TARGET in main "$DEV_BRANCH"; do
+            EXISTING=$(gh pr list \
+              --head "$RELEASE_BRANCH" \
+              --base "$TARGET" \
+              --json url \
+              --jq '.[0].url' 2>/dev/null || true)
+
+            if [ -n "$EXISTING" ]; then
+              echo "PR already exists for $RELEASE_BRANCH -> $TARGET: $EXISTING"
+              continue
+            fi
+
+            BODY=$(printf '%s\n' \
+              '## Release merge' \
+              '' \
+              "This PR was opened automatically after publishing version \`${VERSION}\`." \
+              '' \
+              "- source branch: \`${RELEASE_BRANCH}\`" \
+              "- target branch: \`${TARGET}\`" \
+              '' \
+              'Merge this PR after the release publication checks look correct.')
+
+            gh pr create \
+              --head "$RELEASE_BRANCH" \
+              --base "$TARGET" \
+              --title "chore(release): merge ${VERSION} into ${TARGET}" \
+              --body "$BODY"
+          done

atomic_keygen-1.0/.gitignore

@@ -0,0 +1,51 @@
+# ── Python ────────────────────────────────────────────────────────────────────
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+
+# Distributions
+*.egg-info/
+dist/
+build/
+*.egg
+.eggs/
+
+# Virtual environments
+.venv/
+venv/
+env/
+
+# ── Tools ─────────────────────────────────────────────────────────────────────
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+
+# Testing / linting caches
+.pytest_cache/
+.ruff_cache/
+.mypy_cache/
+.coverage
+htmlcov/
+
+# Type checker
+.pyright/
+
+# ── Build / version ───────────────────────────────────────────────────────────
+*.python-version
+uv.lock
+
+# ── OS ────────────────────────────────────────────────────────────────────────
+.DS_Store
+Thumbs.db
+
+# ── Environment ───────────────────────────────────────────────────────────────
+.env
+.env.*
+!.env.example
+
+# ── Project-specific ──────────────────────────────────────────────────────────
+# (add per-project entries below this line)

atomic_keygen-1.0/LICENSE

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