python-kanka 2.2.0__tar.gz → 2.3.0__tar.gz

{python_kanka-2.2.0 → python_kanka-2.3.0}/.bumpversion.cfg

@@ -1,5 +1,5 @@
 [bumpversion]
-current_version = 2.2.0
+current_version = 2.3.0
 commit = True
 tag = True
 tag_name = v{new_version}
@@ -8,3 +8,7 @@ message = Bump version: {current_version} → {new_version}
 [bumpversion:file:src/kanka/_version.py]
 search = __version__ = "{current_version}"
 replace = __version__ = "{new_version}"
+
+[bumpversion:file:pyproject.toml]
+search = version = "{current_version}"
+replace = version = "{new_version}"

{python_kanka-2.2.0 → python_kanka-2.3.0}/.github/renovate.json

@@ -7,7 +7,8 @@
     ":disableRateLimiting",
     ":separateMajorReleases",
     ":combinePatchMinorReleases",
-    ":ignoreUnstable"
+    ":ignoreUnstable",
+    ":pinVersions"
   ],
   "timezone": "America/Chicago",
   "assignees": [

{python_kanka-2.2.0 → python_kanka-2.3.0}/.github/workflows/ci.yml

@@ -12,42 +12,36 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        python-version: ["3.9", "3.10", "3.11", "3.12"]
+        python-version: ["3.12", "3.13", "3.14"]
 
     steps:
-    - uses: actions/checkout@v4
+    - uses: actions/checkout@v6
 
-    - name: Set up Python ${{ matrix.python-version }}
-      uses: actions/setup-python@v5
+    - name: Install uv
+      uses: astral-sh/setup-uv@v7
       with:
-        python-version: ${{ matrix.python-version }}
+        enable-cache: true
+        cache-dependency-glob: "uv.lock"
 
-    - name: Cache pip dependencies
-      uses: actions/cache@v4
-      with:
-        path: ~/.cache/pip
-        key: ${{ runner.os }}-pip-${{ hashFiles('**/requirements.txt', '**/dev-requirements.txt') }}
-        restore-keys: |
-          ${{ runner.os }}-pip-
+    - name: Set up Python ${{ matrix.python-version }}
+      run: uv python install ${{ matrix.python-version }}
 
     - name: Install dependencies
       run: |
-        python -m pip install --upgrade pip
-        pip install -r requirements.txt
-        pip install -r dev-requirements.txt
-        pip install -e .
+        uv sync --all-groups
+        uv pip install -e .
 
     - name: Run all quality checks
       run: |
         make check
 
     - name: Generate coverage report
-      if: matrix.python-version == '3.11'
+      if: matrix.python-version == '3.14'
       run: |
         make coverage
 
     - name: Upload coverage reports to Codecov
-      if: matrix.python-version == '3.11'
+      if: matrix.python-version == '3.14'
       uses: codecov/codecov-action@v5
       env:
         CODECOV_TOKEN: ${{ secrets.CODECOV_TOKEN }}

{python_kanka-2.2.0 → python_kanka-2.3.0}/.github/workflows/publish.yml

@@ -16,22 +16,24 @@ jobs:
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        python-version: ["3.9", "3.10", "3.11", "3.12"]
+        python-version: ["3.12", "3.13", "3.14"]
 
     steps:
-    - uses: actions/checkout@v4
+    - uses: actions/checkout@v6
 
-    - name: Set up Python ${{ matrix.python-version }}
-      uses: actions/setup-python@v5
+    - name: Install uv
+      uses: astral-sh/setup-uv@v7
       with:
-        python-version: ${{ matrix.python-version }}
+        enable-cache: true
+        cache-dependency-glob: "uv.lock"
+
+    - name: Set up Python ${{ matrix.python-version }}
+      run: uv python install ${{ matrix.python-version }}
 
     - name: Install dependencies
       run: |
-        python -m pip install --upgrade pip
-        pip install -r requirements.txt
-        pip install -r dev-requirements.txt
-        pip install -e .
+        uv sync --all-groups
+        uv pip install -e .
 
     - name: Run all quality checks
       run: |
@@ -41,26 +43,20 @@ jobs:
     needs: test
     runs-on: ubuntu-latest
     steps:
-    - uses: actions/checkout@v4
+    - uses: actions/checkout@v6
 
-    - name: Set up Python
-      uses: actions/setup-python@v5
-      with:
-        python-version: '3.13'
+    - name: Install uv
+      uses: astral-sh/setup-uv@v7
 
-    - name: Install build dependencies
-      run: |
-        python -m pip install --upgrade pip
-        pip install build twine
+    - name: Set up Python
+      run: uv python install 3.14
 
     - name: Build package
-      run: python -m build
-
-    - name: Check package
-      run: twine check dist/*
+      run: |
+        uv build
 
     - name: Upload artifacts
-      uses: actions/upload-artifact@v4
+      uses: actions/upload-artifact@v5
       with:
         name: dist
         path: dist/
@@ -75,7 +71,7 @@ jobs:
 
     steps:
     - name: Download artifacts
-      uses: actions/download-artifact@v4
+      uses: actions/download-artifact@v6
       with:
         name: dist
         path: dist/

{python_kanka-2.2.0 → python_kanka-2.3.0}/.gitignore

@@ -111,6 +111,7 @@ celerybeat.pid
 
 # Environments
 .env
+.envrc
 .venv
 env/
 venv/

{python_kanka-2.2.0 → python_kanka-2.3.0}/.pre-commit-config.yaml

@@ -2,7 +2,7 @@
 # See https://pre-commit.com/hooks.html for more hooks
 repos:
   - repo: https://github.com/pre-commit/pre-commit-hooks
-    rev: v4.5.0
+    rev: v6.0.0
     hooks:
       - id: trailing-whitespace
       - id: end-of-file-fixer
@@ -15,19 +15,19 @@ repos:
       - id: mixed-line-ending
 
   - repo: https://github.com/psf/black
-    rev: 23.12.1
+    rev: 26.1.0
     hooks:
       - id: black
         language_version: python3
 
   - repo: https://github.com/pycqa/isort
-    rev: 5.13.2
+    rev: 8.0.0
     hooks:
       - id: isort
         args: ["--profile", "black"]
 
   - repo: https://github.com/astral-sh/ruff-pre-commit
-    rev: v0.1.9
+    rev: v0.15.2
     hooks:
       - id: ruff
         args: ["--fix"]

{python_kanka-2.2.0 → python_kanka-2.3.0}/CLAUDE.md

@@ -4,10 +4,15 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
 
 ## Key Development Commands
 
+This project uses [uv](https://docs.astral.sh/uv/) for dependency management. All commands are wrapped in the Makefile for convenience:
+
 ```bash
-# Install development environment
+# Install development environment (uses uv sync)
 make install
 
+# Sync dependencies without updating lock file
+make sync
+
 # Run unit tests only (no integration tests)
 make test
 
@@ -31,12 +36,67 @@ make typecheck
 make check
 
 # Build the package
-python -m build
+make build
 
 # Generate coverage report
 make coverage
 ```
 
+### Direct uv commands
+
+```bash
+# Install dependencies
+uv sync --all-groups
+
+# Run a command in the environment
+uv run pytest
+
+# Add a new dependency
+uv add package-name
+
+# Add a dev dependency
+uv add --group dev package-name
+
+# Update dependencies
+uv lock --upgrade
+
+# Build the package
+uv build
+```
+
+## Git Commit Message Format
+
+This project uses conventional commits format:
+```
+<type>(<scope>): <subject>
+
+<body>
+
+<footer>
+```
+
+**Types:**
+- `feat`: New feature
+- `fix`: Bug fix
+- `docs`: Documentation only changes
+- `style`: Code style changes (formatting, missing semicolons, etc)
+- `refactor`: Code change that neither fixes a bug nor adds a feature
+- `test`: Adding missing tests or correcting existing tests
+- `chore`: Changes to build process, dependencies, or auxiliary tools
+
+**Examples:**
+- `feat: add pagination properties to EntityManager`
+- `fix: replace is_private with visibility_id parameter for posts`
+- `chore(deps): update dependency ruff to v0.11.13`
+- `refactor: reorganize package structure for PyPI publishing`
+
+**Note:** When Claude generates commits, they should include the attribution at the end of the commit body:
+```
+🤖 Generated with [Claude Code](https://claude.ai/code)
+
+Co-Authored-By: Claude <noreply@anthropic.com>
+```
+
 ## Architecture Overview
 
 The SDK follows a **Client → Manager → Model** pattern that requires understanding across multiple files:

{python_kanka-2.2.0 → python_kanka-2.3.0}/Makefile

@@ -1,9 +1,10 @@
-.PHONY: install test lint format typecheck check clean coverage help
+.PHONY: install test lint format typecheck check clean coverage help sync build
 
 # Default target
 help:
 	@echo "Available commands:"
-	@echo "  make install   - Install development dependencies"
+	@echo "  make install   - Install development dependencies with uv"
+	@echo "  make sync      - Sync dependencies with uv.lock"
 	@echo "  make test      - Run all tests"
 	@echo "  make lint      - Run code linting"
 	@echo "  make typecheck - Run type checking with mypy"
@@ -11,36 +12,39 @@ help:
 	@echo "  make check     - Run all checks (lint + typecheck + test)"
 	@echo "  make clean     - Clean up temporary files"
 	@echo "  make coverage  - Run tests with coverage report"
+	@echo "  make build     - Build the package"
 
-# Install development dependencies
+# Install development dependencies and sync with lock file
 install:
-	pip install -r requirements.txt
-	pip install -r dev-requirements.txt
-	pip install -e .
+	uv sync --all-groups
+
+# Sync dependencies without updating lock file
+sync:
+	uv sync --all-groups
 
 # Run all tests
 test:
-	pytest tests/ -v
+	uv run pytest tests/ -v
 
 # Run linting
 lint:
-	ruff check .
-	black --check .
-	isort --check-only .
+	uv run ruff check .
+	uv run black --check .
+	uv run isort --check-only .
 
 # Run type checking
 typecheck:
-	mypy src/kanka tests examples --ignore-missing-imports
+	uv run mypy src/kanka tests examples --ignore-missing-imports
 
 # Format code
 format:
-	black .
-	isort .
-	ruff check --fix .
+	uv run black .
+	uv run isort .
+	uv run ruff check --fix .
 
 # Run pre-commit hooks on all files
 pre-commit:
-	pre-commit run --all-files
+	uv run pre-commit run --all-files
 
 # Run all checks
 check: lint typecheck test
@@ -62,4 +66,8 @@ clean:
 
 # Run tests with coverage
 coverage:
-	pytest tests/ -v --cov=src/kanka --cov-report=html --cov-report=term
+	uv run pytest tests/ -v --cov=src/kanka --cov-report=html --cov-report=term
+
+# Build the package
+build:
+	uv build

{python_kanka-2.2.0/src/python_kanka.egg-info → python_kanka-2.3.0}/PKG-INFO

@@ -1,57 +1,30 @@
 Metadata-Version: 2.4
 Name: python-kanka
-Version: 2.2.0
-Summary: A modern Python client for the Kanka API with full typing support
-Home-page: https://github.com/ervwalter/python-kanka
-Author: Erv Walter
-Author-email: erv@ewal.net
-License: MIT
-Project-URL: Bug Reports, https://github.com/ervwalter/python-kanka/issues
-Project-URL: Source, https://github.com/ervwalter/python-kanka
+Version: 2.3.0
+Summary: Python client for the Kanka API
+Project-URL: Homepage, https://github.com/ervwalter/python-kanka
 Project-URL: Documentation, https://github.com/ervwalter/python-kanka#readme
-Project-URL: Kanka API, https://kanka.io/en-US/docs/1.0
-Keywords: kanka api client worldbuilding rpg campaign tabletop ttrpg dnd pathfinder
+Project-URL: Repository, https://github.com/ervwalter/python-kanka
+Project-URL: Issues, https://github.com/ervwalter/python-kanka/issues
+Author-email: Erv Walter <erv@ewal.net>
+License: MIT
+License-File: LICENSE
+Keywords: api,campaign,dnd,kanka,pathfinder,rpg,tabletop,ttrpg,worldbuilding
 Classifier: Development Status :: 4 - Beta
 Classifier: Intended Audience :: Developers
-Classifier: Topic :: Games/Entertainment :: Role-Playing
-Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Classifier: License :: OSI Approved :: MIT License
 Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.9
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
-Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Games/Entertainment :: Role-Playing
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Classifier: Typing :: Typed
-Requires-Python: >=3.9
+Requires-Python: >=3.12
+Requires-Dist: pydantic==2.12.5
+Requires-Dist: requests-toolbelt==1.0.0
+Requires-Dist: requests==2.32.5
 Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: requests==2.32.4
-Requires-Dist: requests_toolbelt>=0.9.1
-Requires-Dist: pydantic==2.11.5
-Provides-Extra: dev
-Requires-Dist: pytest>=7.0.0; extra == "dev"
-Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
-Requires-Dist: pytest-mock>=3.10.0; extra == "dev"
-Requires-Dist: black>=23.0.0; extra == "dev"
-Requires-Dist: isort>=5.12.0; extra == "dev"
-Requires-Dist: ruff>=0.1.0; extra == "dev"
-Requires-Dist: mypy>=1.0.0; extra == "dev"
-Requires-Dist: pre-commit>=3.0.0; extra == "dev"
-Dynamic: author
-Dynamic: author-email
-Dynamic: classifier
-Dynamic: description
-Dynamic: description-content-type
-Dynamic: home-page
-Dynamic: keywords
-Dynamic: license
-Dynamic: license-file
-Dynamic: project-url
-Dynamic: provides-extra
-Dynamic: requires-dist
-Dynamic: requires-python
-Dynamic: summary
 
 # python-kanka
 
@@ -81,10 +54,20 @@ Install from PyPI:
 pip install python-kanka
 ```
 
-Or install from source:
+### From Source (using uv)
 ```bash
 git clone https://github.com/ervwalter/python-kanka.git
 cd python-kanka
+uv sync --all-groups
+uv pip install -e .
+```
+
+### From Source (using pip)
+```bash
+git clone https://github.com/ervwalter/python-kanka.git
+cd python-kanka
+pip install -r requirements.txt
+pip install -r dev-requirements.txt
 pip install -e .
 ```
 

{python_kanka-2.2.0 → python_kanka-2.3.0}/README.md

@@ -26,10 +26,20 @@ Install from PyPI:
 pip install python-kanka
 ```
 
-Or install from source:
+### From Source (using uv)
 ```bash
 git clone https://github.com/ervwalter/python-kanka.git
 cd python-kanka
+uv sync --all-groups
+uv pip install -e .
+```
+
+### From Source (using pip)
+```bash
+git clone https://github.com/ervwalter/python-kanka.git
+cd python-kanka
+pip install -r requirements.txt
+pip install -r dev-requirements.txt
 pip install -e .
 ```