tlmtc 0.1.0__tar.gz

tlmtc-0.1.0/.github/dependabot.yml

@@ -0,0 +1,49 @@
+version: 2
+
+updates:
+  - package-ecosystem: "uv"
+    directory: "/"
+    schedule:
+      interval: "monthly"
+      day: "monday"
+      time: "06:00"
+      timezone: "Europe/Berlin"
+    cooldown:
+      default-days: 14
+    open-pull-requests-limit: 5
+    versioning-strategy: "lockfile-only"
+    commit-message:
+      prefix: "deps"
+    labels:
+      - "dependencies"
+    groups:
+      minor-and-patch:
+        applies-to: version-updates
+        patterns:
+          - "*"
+        update-types:
+          - "minor"
+          - "patch"
+
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "monthly"
+      day: "monday"
+      time: "06:00"
+      timezone: "Europe/Berlin"
+    cooldown:
+      default-days: 14
+    open-pull-requests-limit: 5
+    commit-message:
+      prefix: "deps"
+    labels:
+      - "dependencies"
+    groups:
+      minor-and-patch:
+        applies-to: version-updates
+        patterns:
+          - "*"
+        update-types:
+          - "minor"
+          - "patch"

tlmtc-0.1.0/.github/labeler.yml

@@ -0,0 +1,41 @@
+feature:
+  - head-branch:
+      - '^feat/'
+      - '^feature/'
+
+fix:
+  - head-branch:
+      - '^fix/'
+      - '^bugfix/'
+
+refactor:
+  - head-branch:
+      - '^refactor/'
+
+tests:
+  - head-branch:
+      - '^test/'
+      - '^tests/'
+
+documentation:
+  - head-branch:
+      - '^docs/'
+      - '^doc/'
+
+ci:
+  - head-branch:
+      - '^ci/'
+
+release:
+  - head-branch:
+      - '^release/'
+
+chore:
+  - head-branch:
+      - '^chore/'
+      - '^build/'
+
+dependencies:
+  - head-branch:
+      - '^deps/'
+      - '^dependabot/'

tlmtc-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,123 @@
+name: CI
+
+on:
+  push:
+    branches: [ "main" ]
+  pull_request:
+    branches: [ "main" ]
+  workflow_dispatch:
+
+env:
+  UV_VERSION: "0.9.30"
+  PYTHON_VERSION: "3.12"
+
+jobs:
+  lint:
+    name: Lint
+    runs-on: ubuntu-latest
+
+    steps:
+    - name: Checkout code
+      uses: actions/checkout@v6
+
+    - name: Set up uv
+      uses: astral-sh/setup-uv@v8.1.0
+      with:
+        version: ${{ env.UV_VERSION }}
+        enable-cache: true
+        cache-dependency-glob: "uv.lock"
+
+    - name: Set up Python
+      run: uv python install ${{ env.PYTHON_VERSION }}
+
+    - name: Check lockfile is current
+      run: uv lock --check
+
+    - name: Install lint dependencies
+      run: uv sync --group lint --frozen
+
+    - name: Run Ruff formatter
+      run: uv run ruff format --check .
+
+    - name: Run Ruff linter
+      run: uv run ruff check .
+
+  type:
+    name: Type check
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v6
+
+      - name: Set up uv
+        uses: astral-sh/setup-uv@v8.1.0
+        with:
+          version: ${{ env.UV_VERSION }}
+          enable-cache: true
+          cache-dependency-glob: "uv.lock"
+
+      - name: Set up Python
+        run: uv python install ${{ env.PYTHON_VERSION }}
+
+      - name: Check lockfile is current
+        run: uv lock --check
+
+      - name: Install type-check dependencies
+        run: uv sync --group type --frozen
+
+      - name: Run mypy
+        run: uv run mypy src/tlmtc
+
+  test:
+    name: Test
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v6
+
+      - name: Set up uv
+        uses: astral-sh/setup-uv@v8.1.0
+        with:
+          version: ${{ env.UV_VERSION }}
+          enable-cache: true
+          cache-dependency-glob: "uv.lock"
+
+      - name: Set up Python
+        run: uv python install ${{ env.PYTHON_VERSION }}
+
+      - name: Check lockfile is current
+        run: uv lock --check
+
+      - name: Install test dependencies
+        run: uv sync --group test --extra full --frozen
+
+      - name: Run unit tests
+        run: uv run pytest -q -m "not integration"
+
+  build:
+    name: Build package
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v6
+
+      - name: Set up uv
+        uses: astral-sh/setup-uv@v8.1.0
+        with:
+          version: ${{ env.UV_VERSION }}
+          enable-cache: true
+          cache-dependency-glob: "uv.lock"
+
+      - name: Set up Python
+        run: uv python install ${{ env.PYTHON_VERSION }}
+
+      - name: Check lockfile is current
+        run: uv lock --check
+
+      - name: Build package
+        run: uv build
+
+

tlmtc-0.1.0/.github/workflows/pr-labeler.yml

@@ -0,0 +1,46 @@
+name: Pull Request Labeler
+
+on:
+  pull_request_target:
+    types:
+      - opened
+      - reopened
+      - synchronize
+      - edited
+
+permissions:
+  contents: read
+  pull-requests: write
+  issues: write
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.event.pull_request.number || github.run_id }}
+  cancel-in-progress: true
+
+jobs:
+  label:
+    name: Label pull request
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Apply type labels
+        uses: actions/labeler@v6
+        with:
+          sync-labels: true
+
+      - name: Apply size label
+        if: github.event.action != 'edited'
+        uses: codelytv/pr-size-labeler@v1
+        with:
+          xs_label: 'size: XS'
+          xs_max_size: '49'
+          s_label: 'size: S'
+          s_max_size: '199'
+          m_label: 'size: M'
+          m_max_size: '499'
+          l_label: 'size: L'
+          l_max_size: '999'
+          xl_label: 'size: XL'
+          fail_if_xl: 'false'
+          files_to_ignore: |
+            uv.lock

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

@@ -0,0 +1,141 @@
+name: Release
+
+on:
+  workflow_dispatch:
+    inputs:
+      build_package:
+        description: "Run full release preflight including package build"
+        required: false
+        type: boolean
+        default: false
+
+  push:
+    tags:
+      - "v*.*.*"
+
+permissions:
+  contents: read
+
+env:
+  UV_VERSION: "0.9.30"
+  PYTHON_VERSION: "3.12"
+
+jobs:
+  integration-tests:
+    name: Run integration tests
+    runs-on: ubuntu-latest
+    timeout-minutes: 30
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v6
+        with:
+          fetch-depth: 0
+
+      - name: Check release tag is on main
+        if: github.event_name == 'push'
+        run: |
+          git fetch origin main
+          git merge-base --is-ancestor HEAD origin/main
+
+      - name: Set up uv
+        uses: astral-sh/setup-uv@v8.1.0
+        with:
+          version: ${{ env.UV_VERSION }}
+          enable-cache: true
+          cache-dependency-glob: "uv.lock"
+
+      - name: Set up Python
+        run: uv python install ${{ env.PYTHON_VERSION }}
+
+      - name: Check lockfile is current
+        run: uv lock --check
+
+      - name: Install dependencies
+        run: uv sync --frozen --extra full --group test
+
+      - name: Run integration tests
+        run: uv run --frozen pytest -m integration
+
+  build:
+    name: Build package
+    runs-on: ubuntu-latest
+    needs: integration-tests
+    if: github.event_name == 'push' || inputs.build_package
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v6
+
+      - name: Set up uv
+        uses: astral-sh/setup-uv@v8.1.0
+        with:
+          version: ${{ env.UV_VERSION }}
+          enable-cache: true
+          cache-dependency-glob: "uv.lock"
+
+      - name: Set up Python
+        run: uv python install ${{ env.PYTHON_VERSION }}
+
+      - name: Check tag matches package version
+        if: github.event_name == 'push'
+        run: |
+          TAG_VERSION="${GITHUB_REF_NAME#v}"
+          PACKAGE_VERSION="$(uv run --no-sync python - <<'PY'
+          import tomllib
+          from pathlib import Path
+
+          pyproject = tomllib.loads(Path("pyproject.toml").read_text())
+          print(pyproject["project"]["version"])
+          PY
+          )"
+
+          echo "Tag version:     ${TAG_VERSION}"
+          echo "Package version: ${PACKAGE_VERSION}"
+
+          test "${TAG_VERSION}" = "${PACKAGE_VERSION}"
+
+      - name: Check lockfile is current
+        run: uv lock --check
+
+      - name: Build package
+        run: uv build
+
+      - name: Check build artifacts
+        run: |
+          echo "Built files:"
+          ls -l dist/
+
+      - name: Check package metadata
+        run: uvx --from twine twine check dist/*
+
+      - name: Upload package distributions
+        uses: actions/upload-artifact@v6
+        with:
+          name: python-package-distributions
+          path: dist/*
+          if-no-files-found: error
+
+  publish:
+    name: Publish package to PyPI
+    runs-on: ubuntu-latest
+    needs: build
+    if: github.event_name == 'push' && startsWith(github.ref, 'refs/tags/v')
+
+    environment:
+      name: pypi
+      url: https://pypi.org/p/tlmtc
+
+    permissions:
+      contents: read
+      id-token: write
+
+    steps:
+      - name: Download package distributions
+        uses: actions/download-artifact@v6
+        with:
+          name: python-package-distributions
+          path: dist/
+
+      - name: Publish package distributions to PyPI
+        uses: pypa/gh-action-pypi-publish@v1.14.0

tlmtc-0.1.0/.gitignore

@@ -0,0 +1,39 @@
+# OS
+.DS_Store
+Thumbs.db
+
+# Editor / IDE
+.idea/
+*.iml
+.vscode/
+*.swp
+*.swo
+*~
+
+# Python bytecode
+__pycache__/
+*.pyc
+
+# Virtual environments
+.venv/
+venv/
+env/
+
+# Build artifacts
+build/
+dist/
+*.egg-info/
+.eggs/
+
+# Test / lint / type-check caches
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+.coverage
+htmlcov/
+
+# Environment files
+.env
+.env.*
+!.env.example
+!.env.*.example

tlmtc-0.1.0/CONTRIBUTING.md

@@ -0,0 +1,102 @@
+Thanks for your interest in contributing to **tlmtc**.
+
+Contributions are welcome, including:
+
+- asking questions about usage or design
+- reporting bugs
+- suggesting features or improvements
+- improving documentation, examples, or error messages
+- adding or improving tests
+- contributing code
+
+## Before you start
+
+### Issue first, then PR
+
+Unless your change is trivial, such as a typo correction or minor documentation improvement, please open an issue before submitting a pull request.
+
+Opening an issue first helps avoid wasted work and keeps design decisions visible.
+
+### AI-assisted contributions
+
+AI-assisted work is welcome when there is clear human ownership.
+
+You may use AI tools to help draft, revise, explore, or implement contributions, but you are responsible for the final result. Before submitting, you must review every change, verify behavior against the codebase, run the relevant checks, and make sure the contribution matches the project style and intent.
+
+Unreviewed AI-agent or bulk-generated contributions are not accepted. Please do not submit issues or pull requests that were generated autonomously, submitted at scale, or opened without careful human review and testing.
+
+Pull requests that appear automated, low-effort, spam-like, or submitted without clear human ownership may be closed without review, regardless of how they were produced.
+
+### Issues
+
+When reporting a bug, please include:
+
+- what you expected to happen
+- what actually happened
+- a minimal example, if possible
+- the relevant package version, Python version, and operating system
+- the relevant error message or traceback, if applicable
+
+When suggesting a feature, please describe:
+
+- the use case
+- why the current behavior is insufficient
+- the expected behavior or API, if you have a concrete proposal
+
+### Pull requests
+
+All changes must be submitted through pull requests.
+
+Each pull request should represent one substantively coherent change. Large, mixed-scope pull requests may be closed or split before review.
+
+A good pull request should include:
+
+- a short summary of what changed and why the change is needed
+- a scoped list of key changes
+- tests, or an explanation of why tests were not added
+- documentation updates when user-facing behavior changes
+- notes on how the change was tested
+
+## Branches and commits
+
+The `main` branch is protected. Direct commits to `main` by non-admins are not allowed.
+
+Work should happen on short-lived, task-specific branches scoped to a single pull request.
+
+Use simple branch names such as:
+
+- `feature/short-description`
+- `fix/short-description`
+- `refactor/short-description`
+- `docs/short-description`
+- `tests/short-description`
+- `ci/short-description`
+- `chore/short-description`
+
+Commits should follow a simple, consistent style:
+
+- `feat: add new functionality`
+- `fix: correct a bug`
+- `refactor: restructure code without changing behavior`
+- `docs: update documentation`
+- `tests: add or adjust tests`
+- `ci: update CI configuration`
+- `chore: update maintenance files`
+
+## Tests and checks
+
+Before opening a pull request, please run the relevant local checks: `ruff`, `mypy`, and `pytest`.
+
+The project uses Python 3.12 or newer. We recommend using `uv` for local development. Install the project with the optional dependencies when working on training, prediction, or integration behavior.
+
+When your change affects end-to-end training or prediction behavior, please also run the integration tests.
+
+Not every pull request needs to run every expensive check locally, but pull requests should not knowingly rely on GitHub Actions to catch obvious failures.
+
+## Review and merge policy
+
+Pull requests require passing CI checks and maintainer approval before merging.
+
+Community review is welcome and may inform maintainer decisions, but final merge decisions are made by maintainers.
+
+Pull requests are merged using squash merge.

tlmtc-0.1.0/LICENSE.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Sascha Göbel
+
+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.