strapi-kit 0.0.1__tar.gz → 0.0.3__tar.gz

{strapi_kit-0.0.1 → strapi_kit-0.0.3}/.github/workflows/ci.yml

@@ -80,17 +80,24 @@ jobs:
           # Install project with dev dependencies
           uv pip install --system -e ".[dev]"
 
-          # Run tests with coverage
-          pytest --cov=strapi_kit --cov-report=xml --cov-report=term -v
+          # Run tests with coverage and JUnit XML for test analytics
+          pytest --cov=strapi_kit --cov-report=xml --cov-report=term --junitxml=junit.xml -o junit_family=legacy -v
 
-      - name: 📈 Coverage upload
+      - name: 📈 Upload coverage to Codecov
         uses: codecov/codecov-action@v5
         with:
           token: ${{ secrets.CODECOV_TOKEN }}
+          slug: MehdiZare/strapi-kit
           files: coverage.xml
           flags: unittests
           fail_ci_if_error: false
 
+      - name: 📊 Upload test results to Codecov
+        if: ${{ !cancelled() }}
+        uses: codecov/test-results-action@v1
+        with:
+          token: ${{ secrets.CODECOV_TOKEN }}
+
   test-matrix-expected:
     name: Test-MatrixExpected
     runs-on: ubuntu-latest

{strapi_kit-0.0.1 → strapi_kit-0.0.3}/.github/workflows/dev-release.yml

@@ -125,7 +125,7 @@ jobs:
           fi
 
       - name: 🧪  Upload to Test PyPI
-        uses: pypa/gh-action-pypi-publish@v1.13.0
+        uses: pypa/gh-action-pypi-publish@release/v1
         with:
           repository-url: https://test.pypi.org/legacy/
           packages-dir: dist

{strapi_kit-0.0.1 → strapi_kit-0.0.3}/.github/workflows/release.yml

@@ -165,7 +165,7 @@ jobs:
           generate_release_notes: true
 
       - name: 🚀 Publish to PyPI
-        uses: pypa/gh-action-pypi-publish@v1.13.0
+        uses: pypa/gh-action-pypi-publish@release/v1
         with:
           packages-dir: dist/
           skip-existing: false

{strapi_kit-0.0.1 → strapi_kit-0.0.3}/.gitignore

@@ -172,3 +172,8 @@ tmp/
 
 # Hatch version file (auto-generated during build)
 src/strapi_kit/_version.py
+
+# Node.js (not used in this project)
+node_modules/
+package.json
+package-lock.json

strapi_kit-0.0.3/AGENTS.md

@@ -0,0 +1,54 @@
+# Repository Guidelines
+
+## Project Structure & Module Organization
+- `src/strapi_kit/`: library source (clients, models, query builder, migrations, etc.).
+- `tests/`: automated tests organized by scope: `unit/`, `integration/`, `e2e/`.
+- `docs/`: MkDocs documentation source; `site/` is generated output.
+- `examples/`: runnable usage samples and migration scripts.
+
+## Build, Test, and Development Commands
+```bash
+# Install (uv preferred)
+uv pip install -e ".[dev]"    # or: make install-dev
+
+# Quality and tests
+make test                     # pytest
+make coverage                 # coverage report (htmlcov/)
+make lint                     # ruff check
+make format                   # ruff format
+make type-check               # mypy strict
+make pre-commit               # format + lint-fix + type-check + test
+
+# Docs
+make docs-serve               # local docs at http://127.0.0.1:8000
+
+# E2E (requires Strapi via Docker)
+make e2e-setup                # start Strapi
+make e2e                      # run e2e tests
+make e2e-teardown             # stop Strapi
+```
+
+## Coding Style & Naming Conventions
+- Python 3.12+, PEP 8, line length 100 (enforced by Ruff).
+- Use `ruff format` for formatting and `ruff check` for linting.
+- `mypy` runs in strict mode on `src/strapi_kit/`; type hints are expected for all functions.
+- Prefer f-strings and Google-style docstrings.
+- Use project exception types (e.g., from `strapi_kit.exceptions`) and chain errors with `raise ... from e`.
+
+## Testing Guidelines
+- Frameworks: `pytest`, `pytest-asyncio` (auto mode), `respx` for HTTP mocking.
+- Naming: `test_*.py`, `Test*` classes, `test_*` functions (per pytest config).
+- Organize by scope: unit tests are fast/isolated; integration tests require a real Strapi instance; e2e tests are Docker-backed.
+- Coverage target: 85%+ overall.
+
+## Commit & Pull Request Guidelines
+- Recent history uses descriptive sentence-style messages (e.g., “Add…”, “Refactor…”), but the contributing guide requests **Conventional Commits**.
+- Use conventional commit format in commits and PR titles, e.g. `feat(client): add retry logic`.
+- PRs should describe what/why, link issues, note breaking changes, and include screenshots for UI changes.
+- Expect automated review by CodeRabbit; ensure `pytest`, `mypy`, and `ruff` pass.
+
+## Security & Configuration
+- Run security checks with `make security` (Bandit). Use `make security-baseline` to refresh `.secrets.baseline` when needed.
+
+## Agent-Specific Instructions
+- If you are an AI assistant, consult `CLAUDE.md` and `LLM.md` for workflow conventions and architecture notes.

strapi_kit-0.0.3/CHANGELOG.md

@@ -0,0 +1,69 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+### Added
+
+- **Content-Type Builder API** ([#15](https://github.com/MehdiZare/strapi-kit/issues/15))
+  - `get_content_types(include_plugins=False)` - List all content types from Strapi
+  - `get_components()` - List all components
+  - `get_content_type_schema(uid)` - Get full schema for a content type
+  - New models: `ContentTypeListItem`, `ComponentListItem`, `CTBContentTypeSchema`, `CTBContentTypeInfo`
+  - Schema helper methods: `get_field_type()`, `is_relation_field()`, `is_component_field()`, `get_relation_target()`, `get_component_uid()`
+  - Full async support for all methods
+
+- **UID Conversion Utilities** ([#16](https://github.com/MehdiZare/strapi-kit/issues/16))
+  - `api_id_to_singular()` - Convert plural API IDs to singular form (handles irregular plurals like people→person, children→child)
+  - `uid_to_admin_url()` - Build Strapi admin panel URLs from content type UIDs
+  - `uid_to_api_id` - Alias for `uid_to_endpoint` for clarity
+  - Export of existing utilities: `extract_model_name()`, `is_api_content_type()`
+
+- **SEO Configuration Detection** ([#17](https://github.com/MehdiZare/strapi-kit/issues/17))
+  - `detect_seo_configuration()` - Detect SEO setup in content type schemas
+  - `SEOConfiguration` dataclass for structured detection results
+  - Support for component-based SEO (shared.seo, meta, metadata)
+  - Support for flat SEO fields (metaTitle, meta_description, ogTitle, etc.)
+  - Case-insensitive matching for field names and component UIDs
+
+### Changed
+
+- Test coverage increased from 85% to 86% (528 passing tests)
+- Added 68 new tests for Content-Type Builder, UID utilities, and SEO detection
+
+## [0.0.2] - 2025-01-XX
+
+### Added
+
+- Export/Import functionality with automatic relation resolution
+- Schema caching for efficient content type metadata handling
+- Media file export/download support
+- Full migration examples (simple and production-ready)
+
+### Changed
+
+- Improved test coverage to 85%
+
+## [0.0.1] - 2025-01-XX
+
+### Added
+
+- Initial release
+- HTTP clients (sync and async)
+- Configuration with Pydantic and environment variable support
+- Authentication (API tokens)
+- Exception hierarchy with semantic error types
+- API version detection (v4/v5)
+- Type-safe query builder with 24 filter operators
+- Response normalization for both Strapi v4 and v5
+- Media upload/download operations
+- Dependency injection support with protocols
+- Full type hints and mypy strict mode compliance
+
+[Unreleased]: https://github.com/MehdiZare/strapi-kit/compare/v0.0.2...HEAD
+[0.0.2]: https://github.com/MehdiZare/strapi-kit/compare/v0.0.1...v0.0.2
+[0.0.1]: https://github.com/MehdiZare/strapi-kit/releases/tag/v0.0.1

{strapi_kit-0.0.1 → strapi_kit-0.0.3}/CLAUDE.md

@@ -284,10 +284,11 @@ assert len(mock_http.requests) == 1
 
 ```
 StrapiError (base)
+├─ ConfigurationError (invalid config, missing token, bad URL)
 ├─ AuthenticationError (401)
 ├─ AuthorizationError (403)
 ├─ NotFoundError (404)
-├─ ValidationError (400)
+├─ ValidationError (400, input validation)
 ├─ ConflictError (409)
 ├─ ServerError (5xx)
 ├─ NetworkError (connection issues)
@@ -302,6 +303,12 @@ StrapiError (base)
 
 **Usage pattern**: Always catch specific exceptions before generic ones. All exceptions carry optional `details: dict[str, Any]` for context.
 
+**Non-HTTP exceptions**:
+- `ConfigurationError`: Invalid API token, missing config, bad base URL
+- `ValidationError`: Invalid query parameters (pagination, filters), invalid function arguments
+- `FormatError`: Invalid export data format, path traversal prevention
+- `MediaError`: File not found, upload/download failures, context manager misuse
+
 **HTTP mapping** (client/base.py:_handle_error_response):
 - 401 → AuthenticationError
 - 403 → AuthorizationError