kinemotion 0.7.1__tar.gz → 0.8.0__tar.gz

kinemotion-0.8.0/.dockerignore

@@ -0,0 +1,59 @@
+# Python
+__pycache__
+*.py[cod]
+*$py.class
+*.so
+.Python
+*.egg-info/
+dist/
+build/
+.venv/
+venv/
+ENV/
+
+# Testing
+.pytest_cache/
+.coverage
+htmlcov/
+.tox/
+
+# IDEs
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# Git
+.git/
+.gitignore
+.gitattributes
+
+# CI/CD
+.github/
+.pre-commit-config.yaml
+
+# Documentation
+docs/
+CHANGELOG.md
+CLAUDE.md
+*.md
+!README.md
+
+# Sample files
+samples/
+examples/
+
+# Development tools
+.mypy_cache/
+.ruff_cache/
+.pytest_cache/
+
+# OS
+.DS_Store
+Thumbs.db
+
+# MCP and Claude
+.mcp.json
+.claude/
+CLAUDE.md

kinemotion-0.8.0/.github/workflows/release.yml

@@ -0,0 +1,108 @@
+name: Release
+
+on:
+  push:
+    branches:
+      - main
+
+jobs:
+  release:
+    name: Create Release
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+      id-token: write
+      packages: write
+    outputs:
+      version: ${{ steps.get_version.outputs.version }}
+      released: ${{ steps.get_version.outputs.released }}
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Set up uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          version: "0.8.17"
+
+      - name: Install dependencies
+        run: uv sync
+
+      - name: Create Release
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: |
+          git config user.name "github-actions"
+          git config user.email "github-actions@github.com"
+          uv run semantic-release version
+
+      - name: Get version from pyproject.toml
+        id: get_version
+        run: |
+          VERSION=$(grep '^version = ' pyproject.toml | cut -d'"' -f2)
+          echo "version=$VERSION" >> $GITHUB_OUTPUT
+          # Check if semantic-release created a new release by checking if there's a new tag
+          if git describe --exact-match --tags HEAD 2>/dev/null; then
+            echo "released=true" >> $GITHUB_OUTPUT
+          else
+            echo "released=false" >> $GITHUB_OUTPUT
+          fi
+
+      - name: Publish to PyPI
+        if: steps.get_version.outputs.released == 'true'
+        uses: pypa/gh-action-pypi-publish@release/v1
+
+  docker:
+    name: Build and Push Docker Image
+    needs: release
+    if: needs.release.outputs.released == 'true'
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      packages: write
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          ref: v${{ needs.release.outputs.version }}
+
+      - name: Set up Docker Buildx
+        uses: docker/setup-buildx-action@v3
+
+      - name: Log in to GitHub Container Registry
+        uses: docker/login-action@v3
+        with:
+          registry: ghcr.io
+          username: ${{ github.actor }}
+          password: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Extract metadata (tags, labels) for Docker
+        id: meta
+        uses: docker/metadata-action@v5
+        with:
+          images: ghcr.io/${{ github.repository }}
+          tags: |
+            type=semver,pattern={{version}},value=v${{ needs.release.outputs.version }}
+            type=semver,pattern={{major}}.{{minor}},value=v${{ needs.release.outputs.version }}
+            type=semver,pattern={{major}},value=v${{ needs.release.outputs.version }}
+            type=raw,value=latest
+
+      - name: Build and push Docker image
+        id: push
+        uses: docker/build-push-action@v6
+        with:
+          context: .
+          push: true
+          tags: ${{ steps.meta.outputs.tags }}
+          labels: ${{ steps.meta.outputs.labels }}
+          platforms: linux/amd64
+          # Multi-scope caching: Docker layers + uv cache
+          cache-from: type=gha
+          cache-to: type=gha,mode=max

{kinemotion-0.7.1 → kinemotion-0.8.0}/.gitignore

@@ -28,7 +28,6 @@ env/
 
 # uv
 .uv/
-uv.lock
 
 # IDEs
 .vscode/

{kinemotion-0.7.1 → kinemotion-0.8.0}/CHANGELOG.md

@@ -7,6 +7,14 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 <!-- version list -->
 
+## v0.8.0 (2025-11-02)
+
+### Features
+
+- Add Docker support and GitHub Container Registry publishing
+  ([`249ca4c`](https://github.com/feniix/kinemotion/commit/249ca4c0c0ab40cda5acfebac012db8075b9694f))
+
+
 ## v0.7.1 (2025-11-01)
 
 ### Bug Fixes

kinemotion-0.8.0/Dockerfile

@@ -0,0 +1,96 @@
+# Multi-stage Dockerfile for kinemotion
+# Optimized for Python 3.12, uv, OpenCV, and MediaPipe
+# Note: Only linux/amd64 platform supported (MediaPipe lacks ARM64 Linux wheels)
+
+# ============================================================================
+# Stage 1: Builder - Install dependencies with uv
+# ============================================================================
+FROM ghcr.io/astral-sh/uv:python3.12-bookworm-slim AS builder
+
+# Optimization: Compile Python bytecode at build time for faster startup
+# Optimization: Copy mode for dependencies to work across build stages
+ENV UV_COMPILE_BYTECODE=1 \
+    UV_LINK_MODE=copy
+
+WORKDIR /app
+
+# Install dependencies FIRST (cached layer - only invalidated when dependencies change)
+# Use bind mounts to avoid copying files into the image
+# Use cache mount to reuse uv downloads across builds
+RUN --mount=type=cache,target=/root/.cache/uv \
+    --mount=type=bind,source=uv.lock,target=uv.lock \
+    --mount=type=bind,source=pyproject.toml,target=pyproject.toml \
+    uv sync --frozen --no-install-project --no-dev
+
+# Copy source code AFTER dependencies (source changes don't invalidate dependency cache)
+COPY . /app
+
+# Install the project itself as a non-editable package (fast since dependencies are already installed)
+# --no-editable ensures the package is properly installed, not as editable
+RUN --mount=type=cache,target=/root/.cache/uv \
+    uv sync --frozen --no-dev --no-editable
+
+# ============================================================================
+# Stage 2: Runtime - Minimal production image
+# ============================================================================
+FROM python:3.12-slim-bookworm AS runtime
+
+# Install system dependencies required by OpenCV and MediaPipe
+# - libgl1: OpenGL library for OpenCV
+# - libglib2.0-0: GLib library for MediaPipe
+# - libgomp1: GNU OpenMP library for multi-threading
+# - ffmpeg: Video codec support for OpenCV
+# hadolint ignore=DL3008
+RUN apt-get update && apt-get install -y --no-install-recommends \
+    libgl1 \
+    libglib2.0-0 \
+    libgomp1 \
+    ffmpeg \
+    && apt-get clean \
+    && rm -rf /var/lib/apt/lists/*
+
+WORKDIR /app
+
+# Copy virtual environment from builder (contains installed package)
+COPY --from=builder /app/.venv /app/.venv
+
+# Set environment variables
+# PATH: Use virtual environment binaries
+# PYTHONUNBUFFERED: Force stdout/stderr to be unbuffered for real-time logging
+# PYTHONDONTWRITEBYTECODE: Don't create .pyc files (saves space)
+ENV PATH="/app/.venv/bin:$PATH" \
+    PYTHONUNBUFFERED=1 \
+    PYTHONDONTWRITEBYTECODE=1
+
+# Create non-root user for security
+RUN useradd -m -u 1000 kinemotion && \
+    chown -R kinemotion:kinemotion /app
+
+USER kinemotion
+
+# Verify installation
+RUN python -c "import kinemotion; print('kinemotion installed successfully')"
+
+# Set entrypoint to kinemotion CLI
+ENTRYPOINT ["kinemotion"]
+
+# Default command: show help
+CMD ["--help"]
+
+# ============================================================================
+# Usage examples:
+#
+# Build:
+#   docker build -t kinemotion:latest .
+#
+# Run with help:
+#   docker run --rm kinemotion:latest --help
+#
+# Analyze video:
+#   docker run --rm -v $(pwd):/data kinemotion:latest \
+#     dropjump-analyze /data/video.mp4 --drop-height 0.40 \
+#     --output /data/debug.mp4 --json-output /data/metrics.json
+#
+# Interactive shell:
+#   docker run --rm -it --entrypoint /bin/bash kinemotion:latest
+# ============================================================================

{kinemotion-0.7.1 → kinemotion-0.8.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: kinemotion
-Version: 0.7.1
+Version: 0.8.0
 Summary: Video-based kinematic analysis for athletic performance
 Project-URL: Homepage, https://github.com/feniix/kinemotion
 Project-URL: Repository, https://github.com/feniix/kinemotion

{kinemotion-0.7.1 → kinemotion-0.8.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "kinemotion"
-version = "0.7.1"
+version = "0.8.0"
 description = "Video-based kinematic analysis for athletic performance"
 readme = "README.md"
 requires-python = ">=3.10,<3.13"