msw-io 1.0.2__tar.gz

msw_io-1.0.2/.copier-answers.yml

@@ -0,0 +1,15 @@
+# Changes here will be overwritten by Copier
+_commit: v0.8.5
+_src_path: gh:larsrollik/templatepy
+author_email: lars@rollik.me
+author_name: Lars B. Rollik
+github_repo: msw-io
+github_username: murineshiftwork
+license_type: noncommercial
+private_repo_deps: false
+project_description: 'Murine Shift Work session data IO: file codec, namespace utilities, and session readers.'
+project_name: msw-io
+project_slug: msw_io
+python_requires: '3.10'
+year: '2026'
+test_on_windows: false

msw_io-1.0.2/.forgejo/workflows/ci.yml

@@ -0,0 +1,77 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+    tags-ignore: ["v*"]
+  pull_request:
+    branches: [main]
+
+permissions:
+  contents: read
+
+jobs:
+  lint:
+    name: Lint
+    runs-on: ubuntu-latest
+    if: "!startsWith(github.event.head_commit.message, 'bump:')"
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - uses: astral-sh/setup-uv@v7
+        with:
+          python-version: "3.12"
+
+
+      - name: Install dependencies
+        run: uv sync --extra dev
+
+      - name: Run pre-commit (ruff + mypy + commitizen + gitleaks)
+        run: uv run pre-commit run --all-files --show-diff-on-failure
+
+  test:
+    name: Test (Python ${{ matrix.python-version }})
+    runs-on: ubuntu-latest
+    if: github.event_name == 'pull_request'
+    strategy:
+      fail-fast: false
+      matrix:
+
+
+        python-version: ["3.10", "3.13"]
+
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - uses: astral-sh/setup-uv@v7
+        with:
+          python-version: ${{ matrix.python-version }}
+
+
+      - name: Install dependencies
+        run: uv sync --extra dev
+
+      - name: Run tests
+        run: uv run pytest
+
+  # Aggregate gate — add as required status check in branch protection
+  ci:
+    name: CI
+    runs-on: ubuntu-latest
+    needs: [lint, test]
+    if: always()
+    steps:
+      - name: Check required jobs
+        run: |
+
+          if [[ "${{ needs.lint.result }}" != "success" && "${{ needs.lint.result }}" != "skipped" ]]; then
+            echo "lint failed" && exit 1
+          fi
+          if [[ "${{ needs.test.result }}" != "success" && "${{ needs.test.result }}" != "skipped" ]]; then
+            echo "test failed" && exit 1
+          fi
+          echo "All required checks passed."

msw_io-1.0.2/.forgejo/workflows/docs.yml

@@ -0,0 +1,33 @@
+name: Docs
+
+on:
+  push:
+    branches: [main]
+    paths:
+      - "docs/**"
+      - "mkdocs.yml"
+      - ".forgejo/workflows/docs.yml"
+      - "src/**/*.py"
+  workflow_dispatch:
+
+permissions:
+  contents: write
+
+jobs:
+  deploy:
+    name: Deploy docs to Pages
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - uses: astral-sh/setup-uv@v7
+        with:
+          python-version: "3.12"
+
+      - name: Install dependencies
+        run: uv sync --extra docs
+
+      - name: Deploy
+        run: uv run mkdocs gh-deploy --force

msw_io-1.0.2/.forgejo/workflows/pr-review.yml

@@ -0,0 +1,105 @@
+name: PR Review (optional LLM)
+
+# Optional AI-assisted pull request review.
+# Uncomment ONE of the sections below and configure the required secret.
+#
+# Option A: Claude API requires ANTHROPIC_API_KEY secret.
+# Option B: Ollama requires a self-hosted runner with Ollama on localhost:11434.
+#
+# This workflow has a no-op placeholder job so it stays valid while
+# both options remain commented out.
+
+on:
+  pull_request:
+    types: [opened, synchronize, ready_for_review]
+
+jobs:
+
+  # ── Option A: Claude API (Anthropic) ─────────────────────────────────────
+  # Requires secret: ANTHROPIC_API_KEY
+  #
+  # llm-review-claude:
+  #   name: Claude PR review
+  #   runs-on: ubuntu-latest
+  #   steps:
+  #     - uses: actions/checkout@v4
+  #       with:
+  #         fetch-depth: 0
+  #
+  #     - name: Generate diff
+  #       id: diff
+  #       run: |
+  #         DIFF=$(git diff origin/main...HEAD -- '*.py' | head -c 8000)
+  #         echo "content<<EOF" >> "$GITHUB_OUTPUT"
+  #         echo "$DIFF"        >> "$GITHUB_OUTPUT"
+  #         echo "EOF"          >> "$GITHUB_OUTPUT"
+  #
+  #     - name: Review with Claude
+  #       env:
+  #         ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
+  #         GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+  #         PR_NUMBER: ${{ github.event.pull_request.number }}
+  #       run: |
+  #         if [ -z "$ANTHROPIC_API_KEY" ]; then
+  #           echo "ANTHROPIC_API_KEY not set — skipping."
+  #           exit 0
+  #         fi
+  #         REVIEW=$(curl -s https://api.anthropic.com/v1/messages \
+  #           -H "x-api-key: $ANTHROPIC_API_KEY" \
+  #           -H "anthropic-version: 2023-06-01" \
+  #           -H "content-type: application/json" \
+  #           -d "{
+  #             \"model\": \"claude-sonnet-4-6\",
+  #             \"max_tokens\": 1024,
+  #             \"messages\": [{
+  #               \"role\": \"user\",
+  #               \"content\": \"Review this Python PR diff for bugs, style issues, and improvements. Be concise.\n\n${{ steps.diff.outputs.content }}\"
+  #             }]
+  #           }" | python3 -c "import sys,json; print(json.load(sys.stdin)['content'][0]['text'])")
+  #         curl -s -X POST \
+  #           "${GITHUB_SERVER_URL}/api/v1/repos/${GITHUB_REPOSITORY}/issues/${PR_NUMBER}/comments" \
+  #           -H "Authorization: token ${GITHUB_TOKEN}" \
+  #           -H "Content-Type: application/json" \
+  #           -d "{\"body\": \"## Claude PR Review\n\n${REVIEW}\"}"
+
+  # ── Option B: Local Ollama (self-hosted runner) ───────────────────────────
+  # Requires: a self-hosted runner with Ollama running on localhost:11434
+  #
+  # llm-review-ollama:
+  #   name: Ollama PR review
+  #   runs-on: self-hosted
+  #   steps:
+  #     - uses: actions/checkout@v4
+  #       with:
+  #         fetch-depth: 0
+  #
+  #     - name: Generate diff
+  #       id: diff
+  #       run: |
+  #         DIFF=$(git diff origin/main...HEAD -- '*.py' | head -c 4000)
+  #         echo "content<<EOF" >> "$GITHUB_OUTPUT"
+  #         echo "$DIFF"        >> "$GITHUB_OUTPUT"
+  #         echo "EOF"          >> "$GITHUB_OUTPUT"
+  #
+  #     - name: Review with Ollama
+  #       env:
+  #         GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+  #         PR_NUMBER: ${{ github.event.pull_request.number }}
+  #         OLLAMA_MODEL: "llama3.2"
+  #       run: |
+  #         PROMPT="Review this Python PR diff for bugs, style issues, and improvements. Be concise.\n\n${{ steps.diff.outputs.content }}"
+  #         REVIEW=$(curl -s http://localhost:11434/api/generate \
+  #           -d "{\"model\": \"${OLLAMA_MODEL}\", \"prompt\": \"${PROMPT}\", \"stream\": false}" \
+  #           | python3 -c "import sys,json; print(json.load(sys.stdin)['response'])")
+  #         curl -s -X POST \
+  #           "${GITHUB_SERVER_URL}/api/v1/repos/${GITHUB_REPOSITORY}/issues/${PR_NUMBER}/comments" \
+  #           -H "Authorization: token ${GITHUB_TOKEN}" \
+  #           -H "Content-Type: application/json" \
+  #           -d "{\"body\": \"## Ollama PR Review (${OLLAMA_MODEL})\n\n${REVIEW}\"}"
+
+  # Placeholder — remove once an option above is uncommented
+  no-op:
+    name: LLM review (not configured)
+    runs-on: ubuntu-latest
+    steps:
+      - run: echo "LLM PR review not configured. See .forgejo/workflows/pr-review.yml."

msw_io-1.0.2/.forgejo/workflows/release.yml

@@ -0,0 +1,64 @@
+name: Release
+
+on:
+  push:
+    branches: [main]
+  workflow_dispatch:
+
+permissions:
+  contents: write
+
+jobs:
+  release:
+    name: Bump, build, publish
+    runs-on: ubuntu-latest
+    if: "!startsWith(github.event.head_commit.message, 'bump:')"
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Configure git identity
+        run: |
+          git config user.name "forgejo-actions[bot]"
+          git config user.email "forgejo-actions[bot]@noreply"
+
+      - uses: astral-sh/setup-uv@v7
+        with:
+          python-version: "3.12"
+
+      - name: Bump version
+        id: bump
+        run: |
+          uvx --from commitizen cz bump --yes || EXIT=$?
+          if [ "${EXIT:-0}" -eq 21 ] || [ "${EXIT:-0}" -eq 6 ]; then
+            echo "No bumpable commits since last tag — skipping."
+            echo "skipped=true" >> "$GITHUB_OUTPUT"
+            exit 0
+          fi
+          [ "${EXIT:-0}" -eq 0 ] || exit $EXIT
+          VERSION=$(cat VERSION)
+          git push origin HEAD:main
+          git push origin "v${VERSION}"
+          echo "version=${VERSION}" >> "$GITHUB_OUTPUT"
+
+      - name: Build
+        if: steps.bump.outputs.skipped != 'true'
+        run: uv build
+
+      - name: Create Forgejo release
+        if: steps.bump.outputs.skipped != 'true'
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          VERSION: ${{ steps.bump.outputs.version }}
+        run: |
+          curl -s -X POST "${GITHUB_SERVER_URL}/api/v1/repos/${GITHUB_REPOSITORY}/releases" \
+            -H "Authorization: token ${GITHUB_TOKEN}" \
+            -H "Content-Type: application/json" \
+            -d "{\"tag_name\": \"v${VERSION}\", \"name\": \"v${VERSION}\", \"body\": \"Release v${VERSION}\"}"
+
+      - name: Publish to PyPI
+        if: steps.bump.outputs.skipped != 'true'
+        env:
+          UV_PUBLISH_TOKEN: ${{ secrets.UV_PUBLISH_TOKEN }}
+        run: uv publish

msw_io-1.0.2/.githooks/fix_commit_msg.py

@@ -0,0 +1,52 @@
+#!/usr/bin/env python3
+"""Auto-fix mechanical commit message formatting issues before linting."""
+
+import sys
+from pathlib import Path
+
+
+def fix(path: Path) -> None:
+    text = path.read_text()
+    lines = text.splitlines(keepends=True)
+
+    fixed = []
+    for i, line in enumerate(lines):
+        if line.startswith("#"):
+            fixed.append(line)
+            continue
+
+        # Strip trailing whitespace on every line
+        line = line.rstrip() + "\n"
+
+        # Strip leading whitespace from subject line (first content line)
+        if i == 0 or all(ln.startswith("#") for ln in lines[:i]):
+            line = line.lstrip()
+
+        # Convert hard tabs to four spaces
+        line = line.replace("\t", "    ")
+
+        fixed.append(line)
+
+    # Ensure blank line between subject and body if body is present
+    first = next((i for i, ln in enumerate(fixed) if not ln.startswith("#")), None)
+    if first is not None and first + 1 < len(fixed):
+        next_content = next(
+            (
+                i
+                for i, ln in enumerate(fixed[first + 1 :], first + 1)
+                if not ln.startswith("#")
+            ),
+            None,
+        )
+        if (
+            next_content is not None
+            and next_content == first + 1
+            and fixed[first + 1].strip()
+        ):
+            fixed.insert(first + 1, "\n")
+
+    path.write_text("".join(fixed))
+
+
+if __name__ == "__main__":
+    fix(Path(sys.argv[1]))

msw_io-1.0.2/.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,32 @@
+---
+name: Bug report
+about: Something isn't working
+labels: bug
+---
+
+## Description
+
+_Clear description of the bug._
+
+## Steps to reproduce
+
+1. ...
+2. ...
+
+## Expected behaviour
+
+_What should happen._
+
+## Actual behaviour
+
+_What actually happens._
+
+## Environment
+
+- OS:
+- Python version:
+- Package version:
+
+## Additional context
+
+_Logs, screenshots, related issues._

msw_io-1.0.2/.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,21 @@
+---
+name: Feature request
+about: Suggest an idea or improvement
+labels: enhancement
+---
+
+## Problem
+
+_What problem does this solve? What use case does it enable?_
+
+## Proposed solution
+
+_Describe what you'd like to see._
+
+## Alternatives considered
+
+_Other approaches you've thought about._
+
+## Additional context
+
+_Anything else relevant._

msw_io-1.0.2/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,18 @@
+## Summary
+
+_What does this PR do? Link to any relevant issue with `closes #N`._
+
+## Type
+
+- [ ] Bug fix
+- [ ] New feature
+- [ ] Refactor / cleanup
+- [ ] Docs / chore
+
+## Checklist
+
+- [ ] Branch created from `main`
+- [ ] Commits follow Conventional Commits (`cz commit`)
+- [ ] Version bumped with `cz bump` and pushed with `--follow-tags` (if releasing)
+- [ ] Tests added or updated
+- [ ] `uv run pre-commit run --all-files` passes locally

msw_io-1.0.2/.github/workflows/ci.yml

@@ -0,0 +1,72 @@
+name: CI
+
+on:
+  push:
+    branches: ["**"]
+    tags-ignore: ["v*"]
+  pull_request:
+    branches: [main]
+
+permissions:
+  contents: read
+
+jobs:
+  lint:
+    name: Lint
+    runs-on: ubuntu-latest
+    if: "!startsWith(github.event.head_commit.message, 'bump:')"
+    steps:
+      - uses: actions/checkout@v6
+        with:
+          fetch-depth: 0
+
+      - uses: astral-sh/setup-uv@v7
+        with:
+          python-version: "3.12"
+
+      - name: Install dependencies
+        run: uv sync --extra dev
+
+      - name: Run pre-commit (ruff + mypy + commitizen + gitleaks)
+        run: uv run pre-commit run --all-files --show-diff-on-failure
+
+  test:
+    name: Test (Python ${{ matrix.python-version }} · ${{ matrix.os }})
+    runs-on: ${{ matrix.os }}
+    if: github.event_name == 'pull_request'
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest]
+        python-version: ["3.11", "3.13"]
+
+    steps:
+      - uses: actions/checkout@v6
+        with:
+          fetch-depth: 0
+
+      - uses: astral-sh/setup-uv@v7
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install dependencies
+        run: uv sync --extra dev
+
+      - name: Run tests
+        run: uv run pytest
+
+  ci:
+    name: CI
+    runs-on: ubuntu-latest
+    needs: [lint, test]
+    if: always()
+    steps:
+      - name: Check required jobs
+        run: |
+          if [[ "${{ needs.lint.result }}" != "success" && "${{ needs.lint.result }}" != "skipped" ]]; then
+            echo "lint failed" && exit 1
+          fi
+          if [[ "${{ needs.test.result }}" != "success" && "${{ needs.test.result }}" != "skipped" ]]; then
+            echo "test failed" && exit 1
+          fi
+          echo "All required checks passed."

msw_io-1.0.2/.github/workflows/docs.yml

@@ -0,0 +1,31 @@
+name: Docs
+
+on:
+  push:
+    branches: [main]
+    paths:
+      - "docs/**"
+      - "mkdocs.yml"
+      - "src/**/*.py"
+
+permissions:
+  contents: write
+
+jobs:
+  deploy:
+    name: Deploy docs to GitHub Pages
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+        with:
+          fetch-depth: 0
+
+      - uses: astral-sh/setup-uv@v7
+        with:
+          python-version: "3.12"
+
+      - name: Install dependencies
+        run: uv sync --extra docs
+
+      - name: Deploy
+        run: uv run mkdocs gh-deploy --force

msw_io-1.0.2/.github/workflows/pr-review.yml

@@ -0,0 +1,96 @@
+name: PR Review (optional LLM)
+
+# Optional AI-assisted pull request review.
+# Uncomment ONE of the sections below and configure the required secret.
+#
+# This workflow has a no-op placeholder job so it stays valid while
+# both options remain commented out.
+
+on:
+  pull_request:
+    types: [opened, synchronize, ready_for_review]
+
+jobs:
+
+  # ── Option A: Claude API (Anthropic) ─────────────────────────────────────
+  # Requires secret: ANTHROPIC_API_KEY
+  # Docs: https://docs.anthropic.com/en/api/getting-started
+  #
+  # llm-review-claude:
+  #   name: Claude PR review
+  #   runs-on: ubuntu-latest
+  #   steps:
+  #     - uses: actions/checkout@v6
+  #       with:
+  #         fetch-depth: 0
+  #
+  #     - name: Generate diff
+  #       id: diff
+  #       run: |
+  #         DIFF=$(git diff origin/main...HEAD -- '*.py' | head -c 8000)
+  #         echo "content<<EOF" >> "$GITHUB_OUTPUT"
+  #         echo "$DIFF"        >> "$GITHUB_OUTPUT"
+  #         echo "EOF"          >> "$GITHUB_OUTPUT"
+  #
+  #     - name: Review with Claude
+  #       env:
+  #         ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
+  #         GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+  #         PR_NUMBER: ${{ github.event.pull_request.number }}
+  #       run: |
+  #         if [ -z "$ANTHROPIC_API_KEY" ]; then
+  #           echo "ANTHROPIC_API_KEY not set — skipping."
+  #           exit 0
+  #         fi
+  #         REVIEW=$(curl -s https://api.anthropic.com/v1/messages \
+  #           -H "x-api-key: $ANTHROPIC_API_KEY" \
+  #           -H "anthropic-version: 2023-06-01" \
+  #           -H "content-type: application/json" \
+  #           -d "{
+  #             \"model\": \"claude-sonnet-4-6\",
+  #             \"max_tokens\": 1024,
+  #             \"messages\": [{
+  #               \"role\": \"user\",
+  #               \"content\": \"Review this Python PR diff for bugs, style issues, and improvements. Be concise.\n\n${{ steps.diff.outputs.content }}\"
+  #             }]
+  #           }" | python3 -c "import sys,json; print(json.load(sys.stdin)['content'][0]['text'])")
+  #         gh pr comment "$PR_NUMBER" --body "## Claude PR Review\n\n${REVIEW}"
+
+  # ── Option B: Local Ollama (self-hosted runner) ───────────────────────────
+  # Requires: a self-hosted runner with Ollama running on localhost:11434
+  # Docs: https://ollama.com / https://docs.github.com/en/actions/hosting-your-own-runners
+  #
+  # llm-review-ollama:
+  #   name: Ollama PR review
+  #   runs-on: self-hosted
+  #   steps:
+  #     - uses: actions/checkout@v6
+  #       with:
+  #         fetch-depth: 0
+  #
+  #     - name: Generate diff
+  #       id: diff
+  #       run: |
+  #         DIFF=$(git diff origin/main...HEAD -- '*.py' | head -c 4000)
+  #         echo "content<<EOF" >> "$GITHUB_OUTPUT"
+  #         echo "$DIFF"        >> "$GITHUB_OUTPUT"
+  #         echo "EOF"          >> "$GITHUB_OUTPUT"
+  #
+  #     - name: Review with Ollama
+  #       env:
+  #         GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+  #         PR_NUMBER: ${{ github.event.pull_request.number }}
+  #         OLLAMA_MODEL: "llama3.2"   # change to your preferred model
+  #       run: |
+  #         PROMPT="Review this Python PR diff for bugs, style issues, and improvements. Be concise.\n\n${{ steps.diff.outputs.content }}"
+  #         REVIEW=$(curl -s http://localhost:11434/api/generate \
+  #           -d "{\"model\": \"${OLLAMA_MODEL}\", \"prompt\": \"${PROMPT}\", \"stream\": false}" \
+  #           | python3 -c "import sys,json; print(json.load(sys.stdin)['response'])")
+  #         gh pr comment "$PR_NUMBER" --body "## Ollama PR Review (${OLLAMA_MODEL})\n\n${REVIEW}"
+
+  # Placeholder — remove once an option above is uncommented
+  no-op:
+    name: LLM review (not configured)
+    runs-on: ubuntu-latest
+    steps:
+      - run: echo "LLM PR review not configured. See .github/workflows/pr-review.yml."