Initial code

.github/workflows/docs.yml

@@ -0,0 +1,57 @@
+name: Documentation Validation
+
+on:
+  push:
+    branches:
+      - "**"
+  pull_request:
+    branches:
+      - main
+      - master
+  workflow_dispatch:
+
+jobs:
+  validate-docs:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+
+      - name: Install markdownlint-cli2
+        run: npm install -g markdownlint-cli2
+
+      - name: Install markdown-link-check
+        run: npm install -g markdown-link-check
+
+      - name: Lint markdown files
+        run: markdownlint-cli2 "README.md" "CONTRIBUTING.md" "tests/README.md" "docs/**/*.md"
+        continue-on-error: false
+
+      - name: Check links in README.md
+        run: markdown-link-check README.md
+        continue-on-error: false
+
+      - name: Check links in CONTRIBUTING.md
+        run: markdown-link-check CONTRIBUTING.md
+        continue-on-error: false
+
+      - name: Check links in tests/README.md
+        run: markdown-link-check tests/README.md
+        continue-on-error: false
+
+      - name: Check links in docs/RELEASING.md
+        run: markdown-link-check docs/RELEASING.md
+        continue-on-error: false
+
+      - name: Check links in docs/SHELL_COMPLETION.md
+        run: markdown-link-check docs/SHELL_COMPLETION.md
+        continue-on-error: false
+
+      - name: Check links in docs/WORKFLOWS.md
+        run: markdown-link-check docs/WORKFLOWS.md
+        continue-on-error: false

.github/workflows/lint.yml

@@ -0,0 +1,41 @@
+name: Lint
+
+on:
+  push:
+    branches:
+      - '**'
+  pull_request:
+    branches:
+      - main
+      - master
+  workflow_dispatch:
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v4
+        with:
+          enable-cache: true
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.11'
+
+      - name: Install dependencies
+        run: uv pip install -e ".[dev]" --system
+
+      - name: Run Ruff linting
+        run: uv run ruff check src/
+
+      - name: Run Ruff formatting check
+        run: uv run ruff format --check src/
+
+      - name: Run Mypy type checking
+        run: uv run mypy src/glpkg/ --strict

.github/workflows/publish.yml

@@ -0,0 +1,48 @@
+name: Publish to PyPI
+
+on:
+  release:
+    types: [published]
+  workflow_dispatch:
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v4
+
+      - name: Install build dependencies
+        run: uv pip install build --system
+
+      - name: Install build tools for .pyz
+        run: uv pip install shiv --system
+
+      - name: Build package distributions
+        run: python -m build
+
+      - name: Build .pyz universal binary
+        run: bash scripts/build_pyz.sh --tool shiv --output-dir dist
+
+      - name: List built artifacts
+        run: ls -la dist/
+
+      - name: Upload .pyz to release
+        if: github.event_name == 'release'
+        uses: softprops/action-gh-release@v1
+        with:
+          files: dist/glpkg.pyz
+          fail_on_unmatched_files: true
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          password: ${{ secrets.PYPI_API_TOKEN }}

.github/workflows/test.yml

@@ -0,0 +1,90 @@
+name: Tests
+
+on:
+  push:
+    branches:
+      - '**'
+  pull_request:
+    branches:
+      - main
+      - master
+  workflow_dispatch:
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.11", "3.12", "3.13"]
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v4
+        with:
+          enable-cache: true
+
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install package in editable mode
+        run: uv pip install -e . --system
+
+      - name: Install test dependencies
+        run: uv pip install -e ".[test]" --system
+
+      - name: Run unit tests with coverage
+        run: uv run pytest tests/unit/ -m unit -v -n auto --cov=glpkg --cov-report=xml --cov-report=term
+
+      - name: Upload coverage reports
+        if: matrix.python-version == '3.11'
+        uses: actions/upload-artifact@v4
+        with:
+          name: coverage-report
+          path: |
+            coverage.xml
+            htmlcov/
+          retention-days: 7
+
+      - name: Check coverage threshold
+        if: matrix.python-version == '3.11'
+        run: |
+          # Extract coverage percentage from XML
+          COVERAGE=$(python -c "
+          import xml.etree.ElementTree as ET
+          tree = ET.parse('coverage.xml')
+          root = tree.getroot()
+          line_rate = float(root.get('line-rate', 0))
+          print(f'{line_rate * 100:.2f}')
+          ")
+          echo "Coverage: ${COVERAGE}%"
+
+          # Check if below 95% warning threshold
+          if (( $(echo "$COVERAGE < 95" | bc -l) )); then
+            echo "::warning::Coverage is below 95% target: ${COVERAGE}%"
+          fi
+
+          # The --cov-fail-under=90 in pytest already handles the failure threshold
+
+      - name: Run integration tests
+        if: ${{ secrets.GITLAB_TOKEN != '' && secrets.GITLAB_REPO != '' }}
+        env:
+          GITLAB_TOKEN: ${{ secrets.GITLAB_TOKEN }}
+          GITLAB_PROJECT_PATH: ${{ secrets.GITLAB_REPO }}
+          RUN_INTEGRATION_TESTS: "1"
+        run: uv run pytest tests/integration/ -m integration -v -n auto --no-cov
+
+      - name: Upload test results
+        uses: actions/upload-artifact@v4
+        if: always()
+        with:
+          name: pytest-results-${{ matrix.python-version }}
+          path: |
+            .pytest_cache/
+            htmlcov/
+          retention-days: 7

.gitignore

@@ -0,0 +1,76 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+pip-wheel-metadata/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# Shiv/PEX universal binaries
+*.pyz
+*.pex
+
+# PyInstaller
+*.manifest
+*.spec
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# IDEs
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# Type checking
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Linting
+.ruff_cache/
+
+# OS
+.DS_Store
+Thumbs.db

.pre-commit-config.yaml

@@ -0,0 +1,34 @@
+repos:
+  # File maintenance hooks
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v5.0.0
+    hooks:
+      - id: trailing-whitespace
+      - id: end-of-file-fixer
+      - id: check-yaml
+      - id: check-toml
+      - id: check-added-large-files
+
+  # Ruff linting and formatting
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.8.4
+    hooks:
+      - id: ruff
+        args: [--fix]
+        files: ^src/
+      - id: ruff-format
+        files: ^src/
+
+  # Mypy type checking
+  - repo: https://github.com/pre-commit/mirrors-mypy
+    rev: v1.14.1
+    hooks:
+      - id: mypy
+        args: [--strict]
+        files: ^src/gitlab_pkg_upload/
+        additional_dependencies:
+          - python-gitlab
+          - rich
+          - GitPython
+          - tenacity
+          - argcomplete