media-archive-sync 0.1.0__tar.gz

media_archive_sync-0.1.0/.coderabbit.yaml

@@ -0,0 +1,58 @@
+# CodeRabbit configuration for media-archive-sync
+# https://docs.coderabbit.ai/guides/configure-coderabbit
+
+language: en-US
+
+reviews:
+  # Review settings
+  profile: "chill"  # Options: "chill", "balanced", "assertive"
+
+  # Auto-review settings
+  auto_review:
+    enabled: true
+    auto_incremental_reviews: true
+    drafts: false
+
+    # Base branches to review
+    base_branches:
+      - "main"
+      - "dev"
+      - "release/*"
+
+  # Tools configuration
+  tools:
+    # Static analysis
+    ruff:
+      enabled: true
+
+    # Type checking
+    mypy:
+      enabled: true
+
+    # Security scanning
+    bandit:
+      enabled: true
+
+    # Spell checking
+    languagetool:
+      enabled: true
+      level: "default"
+
+  # Path filters (what to review)
+  path_filters:
+    - "!**/*.md"
+    - "!**/tests/**"
+    - "!examples/**"
+
+  # Comment settings
+  review_comment:
+    enabled: true
+    collapse_walkthrough: true
+
+# Chat settings
+chat:
+  auto_reply: true
+
+# Knowledge base (optional)
+knowledge_base:
+  opt_out: true

media_archive_sync-0.1.0/.gitconfig

@@ -0,0 +1,4 @@
+# Git configuration for media-archive-sync
+# This enables hooks to run automatically from the .githooks directory
+[core]
+    hooksPath = .githooks

media_archive_sync-0.1.0/.githooks/pre-commit

@@ -0,0 +1,78 @@
+#!/bin/sh
+# Native git pre-commit hook for media-archive-sync
+# Runs linting and quick tests before allowing commits
+
+set -e
+
+echo "Running pre-commit checks..."
+
+# Colors for output
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+NC='\033[0m' # No Color
+
+# Check if we're in a virtual environment
+if [ -z "$VIRTUAL_ENV" ] && [ -z "$CONDA_DEFAULT_ENV" ]; then
+    echo "${YELLOW}Warning: Not in a virtual environment${NC}"
+fi
+
+# Get list of staged Python files (null-terminated)
+# Save to temp file to avoid shell variable issues with null bytes
+STAGED_PY_FILE=$(mktemp)
+git diff --cached --name-only -z --diff-filter=ACM | grep -z '\.py$' > "$STAGED_PY_FILE" || true
+
+# Check if we have any Python files staged
+if [ ! -s "$STAGED_PY_FILE" ]; then
+    rm -f "$STAGED_PY_FILE"
+    echo "${GREEN}No Python files staged for commit.${NC}"
+    exit 0
+fi
+
+# Count files for display
+echo "Staged Python files:"
+cat "$STAGED_PY_FILE" | tr '\0' '\n'
+echo ""
+
+# Run Ruff linter
+echo "Running Ruff linter..."
+if command -v ruff >/dev/null 2>&1; then
+    cat "$STAGED_PY_FILE" | xargs -0 ruff check --fix
+    # Re-stage any files that were auto-fixed
+    cat "$STAGED_PY_FILE" | xargs -0 git add
+    echo "${GREEN}Ruff checks passed${NC}"
+else
+    echo "${YELLOW}ruff not found, skipping...${NC}"
+fi
+
+# Run Black formatter check
+echo "Running Black formatter..."
+if command -v black >/dev/null 2>&1; then
+    cat "$STAGED_PY_FILE" | xargs -0 black --check --diff 2>/dev/null || {
+        echo "${YELLOW}Running black to fix formatting...${NC}"
+        cat "$STAGED_PY_FILE" | xargs -0 black
+        cat "$STAGED_PY_FILE" | xargs -0 git add
+        echo "${GREEN}Formatting fixed and staged${NC}"
+    }
+    echo "${GREEN}Black checks passed${NC}"
+else
+    echo "${YELLOW}black not found, skipping...${NC}"
+fi
+
+# Cleanup temp file
+rm -f "$STAGED_PY_FILE"
+
+# Run quick tests
+echo "Running quick tests..."
+if command -v pytest >/dev/null 2>&1; then
+    pytest -x -q --tb=short --disable-warnings 2>/dev/null || {
+        echo "${RED}Tests failed!${NC}"
+        exit 1
+    }
+    echo "${GREEN}Tests passed${NC}"
+else
+    echo "${YELLOW}pytest not found, skipping tests...${NC}"
+fi
+
+echo "${GREEN}All pre-commit checks passed!${NC}"
+exit 0

media_archive_sync-0.1.0/.githooks/pre-push

@@ -0,0 +1,51 @@
+#!/bin/sh
+# Native git pre-push hook for media-archive-sync
+# Runs full test suite with coverage before allowing push
+
+set -e
+
+echo "Running pre-push checks..."
+
+# Colors for output
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+NC='\033[0m' # No Color
+
+# Check if we're in a virtual environment
+if [ -z "$VIRTUAL_ENV" ] && [ -z "$CONDA_DEFAULT_ENV" ]; then
+    echo "${YELLOW}Warning: Not in a virtual environment${NC}"
+fi
+
+# Run full test suite with coverage
+echo "Running full test suite with coverage..."
+if command -v pytest >/dev/null 2>&1; then
+    pytest \
+        --cov=src/media_archive_sync \
+        --cov-report=term-missing \
+        --cov-fail-under=80 \
+        --tb=short \
+        -q \
+        --disable-warnings 2>/dev/null || {
+        echo "${RED}Tests or coverage check failed!${NC}"
+        echo "${YELLOW}Coverage must be >= 80%${NC}"
+        exit 1
+    }
+    echo "${GREEN}All tests passed with adequate coverage!${NC}"
+else
+    echo "${YELLOW}pytest not found, skipping...${NC}"
+fi
+
+# Run MyPy type checking
+echo "Running MyPy type checking..."
+if command -v mypy >/dev/null 2>&1; then
+    mypy src/media_archive_sync --ignore-missing-imports || {
+        echo "${YELLOW}MyPy found type issues (warnings only, not blocking)${NC}"
+    }
+    echo "${GREEN}MyPy checks completed${NC}"
+else
+    echo "${YELLOW}mypy not found, skipping...${NC}"
+fi
+
+echo "${GREEN}All pre-push checks passed!${NC}"
+exit 0

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

@@ -0,0 +1,45 @@
+name: CI
+
+on:
+  push:
+    branches: [ main ]
+  pull_request:
+    branches: [ main ]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.11", "3.12", "3.13"]
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Setup Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Cache pip
+        uses: actions/cache@v4
+        with:
+          path: ~/.cache/pip
+          key: ${{ runner.os }}-pip-${{ hashFiles('**/pyproject.toml') }}
+          restore-keys: |
+            ${{ runner.os }}-pip-
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install -e ".[dev]"
+
+      - name: Run tests
+        run: |
+          pytest -v --tb=short
+
+      - name: Upload coverage
+        uses: codecov/codecov-action@v4
+        with:
+          files: ./coverage.xml
+          fail_ci_if_error: false

media_archive_sync-0.1.0/.github/workflows/docker-build.yml

@@ -0,0 +1,65 @@
+name: Build and Push Docker Image
+
+on:
+  push:
+    branches:
+      - main
+    tags:
+      - 'v*'
+  pull_request:
+    branches:
+      - main
+  workflow_dispatch:
+
+env:
+  REGISTRY: ghcr.io
+  IMAGE_NAME: ${{ github.repository }}
+
+jobs:
+  build-and-push:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      packages: write
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Set up QEMU
+        uses: docker/setup-qemu-action@v3
+
+      - name: Set up Docker Buildx
+        uses: docker/setup-buildx-action@v3
+
+      - name: Log in to Container Registry
+        if: github.event_name != 'pull_request'
+        uses: docker/login-action@v3
+        with:
+          registry: ${{ env.REGISTRY }}
+          username: ${{ github.actor }}
+          password: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Extract metadata (tags, labels) for Docker
+        id: meta
+        uses: docker/metadata-action@v5
+        with:
+          images: ${{ env.REGISTRY }}/${{ env.IMAGE_NAME }}
+          tags: |
+            type=ref,event=branch
+            type=ref,event=pr
+            type=semver,pattern={{version}}
+            type=semver,pattern={{major}}.{{minor}}
+            type=semver,pattern={{major}}
+            type=sha
+
+      - name: Build and push Docker image
+        uses: docker/build-push-action@v5
+        with:
+          context: .
+          platforms: linux/amd64,linux/arm64
+          push: ${{ github.event_name != 'pull_request' }}
+          tags: ${{ steps.meta.outputs.tags }}
+          labels: ${{ steps.meta.outputs.labels }}
+          cache-from: type=gha
+          cache-to: type=gha,mode=max

media_archive_sync-0.1.0/.github/workflows/lint.yml

@@ -0,0 +1,75 @@
+name: Lint & Format
+
+on:
+  pull_request:
+    branches: [ main ]
+  push:
+    branches: [ main ]
+  workflow_dispatch:
+
+jobs:
+  lint:
+    name: Ruff + Black
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.11'
+
+      - name: Install tools
+        run: |
+          python -m pip install --upgrade pip
+          pip install ruff black
+
+      - name: Run ruff
+        run: ruff check .
+
+      - name: Run black (check)
+        run: black --check .
+
+  autofix:
+    name: Autofix (manual)
+    runs-on: ubuntu-latest
+    needs: lint
+    permissions:
+      contents: write
+      pull-requests: write
+    if: github.event_name == 'workflow_dispatch' || contains(github.event.pull_request.labels.*.name, 'autofix')
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          token: ${{ secrets.GITHUB_TOKEN }}
+          ref: ${{ github.event.pull_request.head.ref || github.ref }}
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.11'
+
+      - name: Install tools
+        run: |
+          python -m pip install --upgrade pip
+          pip install ruff black
+
+      - name: Run ruff --fix
+        run: ruff check --fix .
+
+      - name: Run black
+        run: black .
+
+      - name: Commit & push fixes
+        run: |
+          git config user.name "github-actions[bot]"
+          git config user.email "41898282+github-actions[bot]@users.noreply.github.com"
+          git add -A
+          git commit -m "chore: apply ruff/black fixes" || echo "no changes to commit"
+          git push
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

media_archive_sync-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,55 @@
+name: Build and Publish
+
+on:
+  push:
+    tags:
+      - 'v*'
+  workflow_dispatch:
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.11'
+
+      - name: Install build dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install build twine
+
+      - name: Build package
+        run: python -m build
+
+      - name: Check package
+        run: twine check dist/*
+
+      - name: Upload artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+  publish:
+    needs: build
+    runs-on: ubuntu-latest
+    if: github.event_name == 'push' && startsWith(github.ref, 'refs/tags/v')
+    environment: pypi
+    permissions:
+      id-token: write
+    steps:
+      - name: Download artifacts
+        uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          packages-dir: dist/

media_archive_sync-0.1.0/.gitignore

@@ -0,0 +1,44 @@
+# Python
+.cache
+*.pyc
+__pycache__/
+.venv/
+venv/
+env/
+*.egg-info/
+dist/
+build/
+*.egg
+
+# Testing
+htmlcov/
+.coverage
+coverage.xml
+.pytest_cache/
+.mypy_cache/
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Project specific
+media/
+*.partial
+*.partial.*
+downloads/
+temp/
+
+# Logs
+*.log
+log.txt
+
+# Oh-My-OpenCode
+oh-my-opencode.json
+.sisyphus/coverage.xml

media_archive_sync-0.1.0/CONTRIBUTING.md

@@ -0,0 +1,97 @@
+# Contributing to Media Archive Sync
+
+Thank you for your interest in contributing! This document outlines the development workflow.
+
+## Development Setup
+
+### 1. Clone the repository
+
+```bash
+git clone https://github.com/djdembeck/media-archive-sync.git
+cd media-archive-sync
+```
+
+### 2. Enable Git Hooks (Required)
+
+This repository uses git hooks for code quality. Enable them with:
+
+```bash
+# Option 1: Use make
+make install-hooks
+
+# Option 2: Manual git config
+git config --local core.hooksPath .githooks
+```
+
+**Note:** The hooks will now run automatically on every commit and push.
+
+### 3. Install Development Dependencies
+
+```bash
+pip install -e ".[dev]"
+```
+
+Or use the Makefile:
+
+```bash
+make dev-install  # Installs deps + enables hooks
+```
+
+## Git Hooks
+
+The following hooks run automatically:
+
+### pre-commit
+- Runs `ruff` linter with auto-fix
+- Runs `black` formatter
+- Runs quick tests with pytest
+
+### pre-push
+- Runs full test suite with coverage (requires 80%)
+- Runs `mypy` type checking
+
+### Bypassing Hooks
+
+If you need to bypass hooks temporarily:
+
+```bash
+git commit --no-verify  # or -n
+git push --no-verify
+```
+
+## Development Commands
+
+```bash
+# Run tests
+make test
+
+# Run tests with coverage
+make test-cov
+
+# Run linter
+make lint
+
+# Run formatter
+make format
+
+# Clean build artifacts
+make clean
+```
+
+## Code Quality Standards
+
+- **Linting:** Ruff (configured in `pyproject.toml`)
+- **Formatting:** Black (88 char line length)
+- **Type Checking:** MyPy
+- **Testing:** pytest with coverage (80% minimum)
+
+## Submitting Changes
+
+1. Create a feature branch
+2. Make your changes
+3. Ensure hooks pass (they run automatically)
+4. Push and create a Pull Request
+
+## Questions?
+
+Open an issue or discussion on GitHub.

media_archive_sync-0.1.0/Dockerfile

@@ -0,0 +1,64 @@
+# Build stage
+FROM python:3.13-slim AS builder
+
+# Install build dependencies
+RUN apt-get update && apt-get install -y --no-install-recommends \
+        ca-certificates \
+        curl \
+        gcc \
+        libxml2-dev \
+        libxslt-dev \
+    && rm -rf /var/lib/apt/lists/*
+
+# Create non-root user
+ARG UID=1000
+ARG GID=1000
+RUN groupadd -g ${GID} appgroup && \
+    useradd -m -u ${UID} -g ${GID} appuser
+
+# Install Python dependencies
+WORKDIR /app
+COPY pyproject.toml README.md ./
+COPY src/ ./src/
+
+RUN pip install --upgrade pip && \
+    pip install build && \
+    python -m build
+
+# Runtime stage
+FROM python:3.13-slim
+
+# Install runtime dependencies
+RUN apt-get update && apt-get install -y --no-install-recommends \
+        ffmpeg \
+        mkvtoolnix \
+        mediainfo \
+    && rm -rf /var/lib/apt/lists/*
+
+# Create non-root user
+ARG UID=1000
+ARG GID=1000
+RUN groupadd -g ${GID} appgroup && \
+    useradd -m -u ${UID} -g ${GID} appuser
+
+# Install the built package
+COPY --from=builder /app/dist/*.whl /tmp/
+RUN pip install /tmp/*.whl && rm /tmp/*.whl
+
+# Set up directories
+ARG MEDIA_ROOT=/media
+ARG CACHE_DIR=/app/.cache
+ENV MEDIA_ROOT=${MEDIA_ROOT}
+ENV CACHE_DIR=${CACHE_DIR}
+
+RUN mkdir -p ${MEDIA_ROOT} ${CACHE_DIR} && \
+    chown -R ${UID}:${GID} ${MEDIA_ROOT} ${CACHE_DIR}
+
+USER appuser
+
+# Expose volumes
+VOLUME ["/media", "/app/.cache"]
+
+# Default command
+ENTRYPOINT ["media-archive-sync"]
+CMD ["--help"]

media_archive_sync-0.1.0/LICENSE

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

media_archive_sync-0.1.0/Makefile

@@ -0,0 +1,36 @@
+.PHONY: help install-hooks dev-install test test-cov lint format clean
+
+help:
+	@echo "Available targets:"
+	@echo "  install-hooks  - Configure git to use hooks from .githooks/"
+	@echo "  dev-install    - Install package with dev dependencies"
+	@echo "  test           - Run tests"
+	@echo "  test-cov       - Run tests with coverage"
+	@echo "  lint           - Run ruff linter"
+	@echo "  format         - Run black formatter"
+	@echo "  clean          - Clean build artifacts"
+
+install-hooks:
+	git config --local include.path ../.gitconfig
+	@echo "Git hooks configured! They will run on commit/push."
+
+dev-install:
+	pip install -e ".[dev]"
+	$(MAKE) install-hooks
+
+test:
+	pytest -v --tb=short
+
+test-cov:
+	pytest --cov=src/media_archive_sync --cov-report=term-missing --cov-fail-under=80
+
+lint:
+	ruff check --fix src/ tests/
+
+format:
+	black src/ tests/
+
+clean:
+	rm -rf build/ dist/ *.egg-info .pytest_cache .coverage htmlcov
+	find . -type d -name __pycache__ -exec rm -rf {} + 2>/dev/null || true
+	find . -type f -name "*.pyc" -delete