kinemotion 0.11.7__tar.gz

kinemotion-0.11.7/.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.11.7/.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,105 @@
+name: Bug Report
+description: Report a bug or issue with Kinemotion
+title: "[Bug]: "
+labels: ["bug"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thank you for taking the time to report a bug! Please fill out the form below with as much detail as possible.
+
+  - type: textarea
+    id: description
+    attributes:
+      label: Bug Description
+      description: A clear and concise description of what the bug is.
+      placeholder: Describe what happened...
+    validations:
+      required: true
+
+  - type: textarea
+    id: reproduction
+    attributes:
+      label: Steps to Reproduce
+      description: Detailed steps to reproduce the behavior.
+      placeholder: |
+        1. Run command '...'
+        2. With video file '...'
+        3. See error '...'
+    validations:
+      required: true
+
+  - type: textarea
+    id: expected
+    attributes:
+      label: Expected Behavior
+      description: What you expected to happen.
+      placeholder: Describe the expected behavior...
+    validations:
+      required: true
+
+  - type: textarea
+    id: actual
+    attributes:
+      label: Actual Behavior
+      description: What actually happened.
+      placeholder: Describe what actually happened...
+    validations:
+      required: true
+
+  - type: textarea
+    id: command
+    attributes:
+      label: Command Used
+      description: The exact command you ran (please remove any sensitive paths if needed).
+      placeholder: |
+        kinemotion dropjump-analyze video.mp4 --drop-height 0.40 --output debug.mp4
+      render: bash
+    validations:
+      required: false
+
+  - type: textarea
+    id: environment
+    attributes:
+      label: Environment
+      description: Information about your environment.
+      value: |
+        - OS: [e.g., macOS 14.0, Ubuntu 22.04, Windows 11]
+        - Python version: [run `python --version`]
+        - Kinemotion version: [run `kinemotion --version` or check `pyproject.toml`]
+        - Video format: [e.g., MP4 H.264, MOV, AVI]
+        - Video specs: [e.g., 1920x1080, 30fps, iPhone 15 Pro recording]
+    validations:
+      required: true
+
+  - type: textarea
+    id: logs
+    attributes:
+      label: Error Messages / Logs
+      description: Any error messages, stack traces, or relevant log output.
+      placeholder: Paste error messages or logs here...
+      render: text
+    validations:
+      required: false
+
+  - type: textarea
+    id: additional
+    attributes:
+      label: Additional Context
+      description: Add any other context about the problem here (screenshots, debug videos, etc.).
+      placeholder: Any additional information...
+    validations:
+      required: false
+
+  - type: checkboxes
+    id: checklist
+    attributes:
+      label: Pre-submission Checklist
+      description: Please confirm the following before submitting.
+      options:
+        - label: I have searched existing issues to avoid duplicates
+          required: true
+        - label: I am using the latest version of Kinemotion
+          required: false
+        - label: I have included all relevant environment details
+          required: true

kinemotion-0.11.7/.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,11 @@
+blank_issues_enabled: true
+contact_links:
+  - name: Question or Discussion
+    url: https://github.com/feniix/kinemotion/discussions
+    about: Ask questions or discuss ideas with the community
+  - name: Documentation
+    url: https://github.com/feniix/kinemotion/blob/main/README.md
+    about: Read the documentation, usage guides, and troubleshooting tips
+  - name: Contributing Guide
+    url: https://github.com/feniix/kinemotion/blob/main/CONTRIBUTING.md
+    about: Learn how to contribute to Kinemotion

kinemotion-0.11.7/.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,96 @@
+name: Feature Request
+description: Suggest a new feature or enhancement for Kinemotion
+title: "[Feature]: "
+labels: ["enhancement"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thank you for suggesting a new feature! Please describe your idea in detail below.
+
+  - type: textarea
+    id: problem
+    attributes:
+      label: Problem Statement
+      description: Is your feature request related to a problem? Please describe.
+      placeholder: "I'm frustrated when... / It would be helpful if..."
+    validations:
+      required: true
+
+  - type: textarea
+    id: solution
+    attributes:
+      label: Proposed Solution
+      description: Describe the solution or feature you'd like to see.
+      placeholder: "I would like Kinemotion to..."
+    validations:
+      required: true
+
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: Alternatives Considered
+      description: Describe any alternative solutions or features you've considered.
+      placeholder: "Another approach could be..."
+    validations:
+      required: false
+
+  - type: dropdown
+    id: feature-type
+    attributes:
+      label: Feature Type
+      description: What type of feature is this?
+      options:
+        - New analysis capability
+        - Improved accuracy/precision
+        - Performance improvement
+        - Better output/visualization
+        - CLI/UX improvement
+        - Documentation improvement
+        - Other
+    validations:
+      required: true
+
+  - type: textarea
+    id: use-case
+    attributes:
+      label: Use Case
+      description: Describe your specific use case for this feature.
+      placeholder: "I want to analyze... / This would help me..."
+    validations:
+      required: true
+
+  - type: dropdown
+    id: priority
+    attributes:
+      label: Priority
+      description: How important is this feature to you?
+      options:
+        - Critical - blocking my work
+        - High - would significantly improve my workflow
+        - Medium - would be nice to have
+        - Low - minor enhancement
+    validations:
+      required: false
+
+  - type: textarea
+    id: additional
+    attributes:
+      label: Additional Context
+      description: Add any other context, screenshots, examples, or references about the feature request.
+      placeholder: "Related papers, similar tools, mockups, etc..."
+    validations:
+      required: false
+
+  - type: checkboxes
+    id: contribution
+    attributes:
+      label: Contribution
+      description: Would you be willing to contribute to this feature?
+      options:
+        - label: I would be willing to submit a PR for this feature
+          required: false
+        - label: I can help with testing this feature
+          required: false
+        - label: I can help with documentation for this feature
+          required: false

kinemotion-0.11.7/.github/pull_request_template.md

@@ -0,0 +1,102 @@
+## Description
+
+<!-- Provide a brief description of the changes in this PR -->
+
+## Type of Change
+
+<!-- Mark the relevant option with an "x" -->
+
+- [ ] Bug fix (non-breaking change which fixes an issue)
+- [ ] New feature (non-breaking change which adds functionality)
+- [ ] Breaking change (fix or feature that would cause existing functionality to not work as expected)
+- [ ] Documentation update
+- [ ] Code refactoring (no functional changes)
+- [ ] Performance improvement
+- [ ] Test coverage improvement
+
+## Related Issues
+
+<!-- Link to related issues using #issue_number -->
+
+Closes #
+Related to #
+
+## Changes Made
+
+<!-- Describe the changes in detail -->
+
+-
+-
+-
+
+## Testing
+
+<!-- Describe the testing you've done -->
+
+### Test Environment
+
+- OS: <!-- e.g., macOS 14.0, Ubuntu 22.04 -->
+- Python version: <!-- e.g., 3.12.7 -->
+- Video specs tested: <!-- e.g., 1920x1080 30fps MP4 -->
+
+### Test Cases
+
+<!-- Describe what you tested -->
+
+- [ ] Tested with sample videos
+- [ ] Added/updated unit tests
+- [ ] All existing tests pass
+- [ ] Tested edge cases
+
+### Commands Run
+
+```bash
+# Example test commands
+uv run kinemotion dropjump-analyze test_video.mp4 --drop-height 0.40
+```
+
+## Code Quality Checklist
+
+<!-- Confirm all checks pass -->
+
+- [ ] Code follows the project's style guidelines
+- [ ] Code is formatted with Black: `uv run black src/`
+- [ ] Linting passes: `uv run ruff check`
+- [ ] Type checking passes: `uv run mypy src/kinemotion`
+- [ ] All tests pass: `uv run pytest`
+- [ ] Added type annotations to all new functions
+- [ ] Added docstrings to public functions/classes
+- [ ] No new linting warnings introduced
+
+## Documentation
+
+<!-- Update documentation as needed -->
+
+- [ ] Updated README.md (if needed)
+- [ ] Updated CLAUDE.md (if needed)
+- [ ] Updated docs/PARAMETERS.md (if adding/changing parameters)
+- [ ] Added/updated code comments
+- [ ] Added docstrings
+
+## Screenshots / Videos
+
+<!-- If applicable, add screenshots or demo videos -->
+
+## Breaking Changes
+
+<!-- If this PR introduces breaking changes, describe them and migration steps -->
+
+## Additional Notes
+
+<!-- Any additional information reviewers should know -->
+
+## Reviewer Checklist
+
+<!-- For reviewers -->
+
+- [ ] Code quality meets project standards
+- [ ] Tests are comprehensive and pass
+- [ ] Documentation is clear and complete
+- [ ] No security concerns
+- [ ] Performance impact is acceptable
+- [ ] Breaking changes are justified and documented

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

@@ -0,0 +1,111 @@
+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
+        env:
+          DOCKER_METADATA_ANNOTATIONS_LEVELS: manifest,index
+
+      - 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 }}
+          annotations: ${{ steps.meta.outputs.annotations }}
+          platforms: linux/amd64
+          # Multi-scope caching: Docker layers + uv cache
+          cache-from: type=gha
+          cache-to: type=gha,mode=max

kinemotion-0.11.7/.gitignore

@@ -0,0 +1,66 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# Virtual environments
+venv/
+ENV/
+env/
+.venv
+
+# uv
+.uv/
+
+# IDEs
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# Testing
+.pytest_cache/
+.coverage
+htmlcov/
+
+# Output files
+*.mov
+*.MOV
+*.mp4
+*.avi
+*.json
+*.csv
+!pyproject.toml
+
+# Logs
+*.log
+combined.log
+error.log
+
+# OS
+.DS_Store
+Thumbs.db
+
+*.mp4
+*.jpeg
+*.jpg
+
+.claude/settings.local.json*

kinemotion-0.11.7/.pre-commit-config.yaml

@@ -0,0 +1,48 @@
+# See https://pre-commit.com for more information
+# See https://pre-commit.com/hooks.html for more hooks
+repos:
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v6.0.0
+    hooks:
+      - id: trailing-whitespace
+      - id: end-of-file-fixer
+      - id: check-yaml
+      - id: check-added-large-files
+        args: ['--maxkb=1000']
+      - id: check-merge-conflict
+      - id: check-toml
+      - id: debug-statements
+      - id: mixed-line-ending
+
+  - repo: https://github.com/psf/black
+    rev: 25.9.0
+    hooks:
+      - id: black
+
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.14.3
+    hooks:
+      - id: ruff
+        args: [--fix, --exit-non-zero-on-fix]
+
+  - repo: https://github.com/RobertCraigie/pyright-python
+    rev: v1.1.407
+    hooks:
+      - id: pyright
+        files: ^src/
+        # Pyright reads configuration from pyproject.toml automatically
+
+  - repo: https://github.com/executablebooks/mdformat
+    rev: 0.7.17
+    hooks:
+      - id: mdformat
+        additional_dependencies:
+          - mdformat-gfm>=0.3.5  # GitHub Flavored Markdown
+          - mdformat-tables  # Table formatting
+        exclude: ^CLAUDE\.md$
+
+  - repo: https://github.com/compilerla/conventional-pre-commit
+    rev: v4.3.0
+    hooks:
+      - id: conventional-pre-commit
+        stages: [commit-msg]

kinemotion-0.11.7/.tool-versions

@@ -0,0 +1,2 @@
+uv 0.9.7
+python 3.12.7