pico-sqlalchemy 0.2.1.dev0__tar.gz → 0.3.0__tar.gz

pico_sqlalchemy-0.3.0/.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,32 @@
+name: Bug Report
+description: Report a bug in pico-sqlalchemy
+labels: ["bug"]
+body:
+  - type: textarea
+    id: description
+    attributes:
+      label: Description
+      description: What happened?
+    validations:
+      required: true
+  - type: textarea
+    id: reproduction
+    attributes:
+      label: Steps to Reproduce
+      description: Minimal code or steps to reproduce the issue.
+    validations:
+      required: true
+  - type: input
+    id: version
+    attributes:
+      label: pico-sqlalchemy version
+      placeholder: "0.2.0"
+    validations:
+      required: true
+  - type: input
+    id: python-version
+    attributes:
+      label: Python version
+      placeholder: "3.11"
+    validations:
+      required: true

pico_sqlalchemy-0.3.0/.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,18 @@
+name: Feature Request
+description: Suggest an enhancement for pico-sqlalchemy
+labels: ["enhancement"]
+body:
+  - type: textarea
+    id: problem
+    attributes:
+      label: Problem
+      description: What problem does this solve?
+    validations:
+      required: true
+  - type: textarea
+    id: solution
+    attributes:
+      label: Proposed Solution
+      description: How should it work?
+    validations:
+      required: true

pico_sqlalchemy-0.3.0/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,10 @@
+## Summary
+
+<!-- Brief description of the changes -->
+
+## Checklist
+
+- [ ] Tests pass (`pytest tests/ -v`)
+- [ ] Code formatted (`ruff format src/ tests/`)
+- [ ] Lint clean (`ruff check src/ tests/`)
+- [ ] CHANGELOG.md updated (if user-facing change)

pico_sqlalchemy-0.3.0/.github/dependabot.yml

@@ -0,0 +1,11 @@
+version: 2
+updates:
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+
+  - package-ecosystem: "pip"
+    directory: "/"
+    schedule:
+      interval: "weekly"

{pico_sqlalchemy-0.2.1.dev0 → pico_sqlalchemy-0.3.0}/.github/workflows/ci.yml

@@ -3,8 +3,23 @@ name: CI & Coverage
 on:
   push:
     branches: [ main ]
+  pull_request:
+    branches: [ main ]
 
 jobs:
+  lint:
+    name: Lint & Format
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+      - uses: actions/setup-python@v6
+        with:
+          python-version: '3.11'
+          cache: pip
+      - run: pip install ruff
+      - run: ruff check src/ tests/
+      - run: ruff format --check src/ tests/
+
   tests:
     name: Tests (Python ${{ matrix.python-version }})
     runs-on: ubuntu-latest
@@ -15,12 +30,12 @@ jobs:
 
     steps:
       - name: Checkout
-        uses: actions/checkout@v4
+        uses: actions/checkout@v6
         with:
           fetch-depth: 0
 
       - name: Set up Python ${{ matrix.python-version }}
-        uses: actions/setup-python@v5
+        uses: actions/setup-python@v6
         with:
           python-version: ${{ matrix.python-version }}
           cache: pip
@@ -30,6 +45,12 @@ jobs:
           python -m pip install --upgrade pip
           pip install tox
 
+      - name: Cache tox environments
+        uses: actions/cache@v5
+        with:
+          path: .tox
+          key: tox-${{ matrix.python-version }}-${{ hashFiles('pyproject.toml', 'tox.ini') }}
+
       - name: Install build dependencies
         run: |
           sudo apt-get update
@@ -58,7 +79,7 @@ jobs:
     needs: tests
     steps:
       - name: Checkout (for repo context)
-        uses: actions/checkout@v4
+        uses: actions/checkout@v6
 
       - name: Download all coverage artifacts
         uses: actions/download-artifact@v4

pico_sqlalchemy-0.3.0/.github/workflows/codeql.yml

@@ -0,0 +1,28 @@
+name: CodeQL
+
+on:
+  push:
+    branches: [ main ]
+  pull_request:
+    branches: [ main ]
+  schedule:
+    - cron: '0 6 * * 1'
+
+jobs:
+  analyze:
+    name: Analyze (Python)
+    runs-on: ubuntu-latest
+    permissions:
+      security-events: write
+      contents: read
+
+    steps:
+      - uses: actions/checkout@v6
+
+      - name: Initialize CodeQL
+        uses: github/codeql-action/init@v4
+        with:
+          languages: python
+
+      - name: Perform CodeQL Analysis
+        uses: github/codeql-action/analyze@v4

{pico_sqlalchemy-0.2.1.dev0 → pico_sqlalchemy-0.3.0}/.github/workflows/docs.yml

@@ -29,11 +29,11 @@ jobs:
     if: github.event_name == 'pull_request'
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
         with:
           fetch-depth: 0
 
-      - uses: actions/setup-python@v5
+      - uses: actions/setup-python@v6
         with:
           python-version: '3.11'
           cache: 'pip'
@@ -51,7 +51,7 @@ jobs:
           pip install linkchecker
           python -m http.server --directory site 8000 &
           sleep 3
-          linkchecker http://127.0.0.1:8000 --check-extern || true
+          linkchecker http://127.0.0.1:8000 --check-extern
 
   deploy:
     if: github.event_name != 'pull_request'
@@ -61,11 +61,11 @@ jobs:
       url: ${{ steps.deployment.outputs.page_url }}
 
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
         with:
           fetch-depth: 0
 
-      - uses: actions/setup-python@v5
+      - uses: actions/setup-python@v6
         with:
           python-version: '3.11'
           cache: 'pip'

{pico_sqlalchemy-0.2.1.dev0 → pico_sqlalchemy-0.3.0}/.github/workflows/publish-to-pypi.yml

@@ -12,12 +12,12 @@ jobs:
       contents: read
 
     steps:
-    - uses: actions/checkout@v4
+    - uses: actions/checkout@v6
       with:
         fetch-depth: 0
 
     - name: Set up Python
-      uses: actions/setup-python@v5
+      uses: actions/setup-python@v6
       with:
         python-version: '3.x'
 
@@ -32,5 +32,5 @@ jobs:
       with:
         skip-existing: true
         verify-metadata: true
-        attestations: false
+        attestations: true
 

{pico_sqlalchemy-0.2.1.dev0 → pico_sqlalchemy-0.3.0}/.github/workflows/sync-keywords.yml

@@ -18,10 +18,10 @@ jobs:
 
     steps:
       - name: Checkout Repository
-        uses: actions/checkout@v4
+        uses: actions/checkout@v6
 
       - name: Set up Python
-        uses: actions/setup-python@v4
+        uses: actions/setup-python@v6
         with:
           python-version: '3.11'
 

{pico_sqlalchemy-0.2.1.dev0/docs → pico_sqlalchemy-0.3.0}/CHANGELOG.md

@@ -7,6 +7,13 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.h
 
 ---
 
+## [0.3.0] - 2026-02-20
+
+### Changed
+- **Breaking:** Renamed `DatabaseConfigurer.configure(engine)` to `configure_database(engine)` to avoid protocol collision with `FastApiConfigurer.configure(app)` in structural typing.
+
+---
+
 ## [0.2.0] - 2026-02-06
 
 ### Added

{pico_sqlalchemy-0.2.1.dev0 → pico_sqlalchemy-0.3.0}/CLAUDE.md

@@ -11,7 +11,7 @@ pico-sqlalchemy provides SQLAlchemy integration for pico-ioc. It uses:
 ## Key Reminders
 
 - pico-ioc dependency: `>= 2.2.0`
-- `version_scheme = "guess-next-dev"` (clean versions on tag)
+- **NEVER change `version_scheme`** in pyproject.toml. It MUST remain `"post-release"`. Changing it to `"guess-next-dev"` causes `.dev0` versions to leak to PyPI. This was already fixed once — do not revert it.
 - requires-python >= 3.11
 - Commit messages: one line only
 - `@transactional` works both with and without parentheses (like `@repository`)

pico_sqlalchemy-0.3.0/CODE_OF_CONDUCT.md

@@ -0,0 +1,31 @@
+# Contributor Covenant Code of Conduct
+
+## Our Pledge
+
+We as members, contributors, and leaders pledge to make participation in our
+community a harassment-free experience for everyone.
+
+## Our Standards
+
+Examples of behavior that contributes to a positive environment:
+
+* Using welcoming and inclusive language
+* Being respectful of differing viewpoints and experiences
+* Gracefully accepting constructive criticism
+* Focusing on what is best for the community
+
+Examples of unacceptable behavior:
+
+* Trolling, insulting or derogatory comments, and personal or political attacks
+* Public or private harassment
+* Publishing others' private information without explicit permission
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be
+reported to **dperezcabrera@gmail.com**. All complaints will be reviewed
+and investigated promptly and fairly.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant](https://www.contributor-covenant.org/), version 2.1.

pico_sqlalchemy-0.3.0/CONTRIBUTING.md

@@ -0,0 +1,34 @@
+# Contributing to Pico-SQLAlchemy
+
+## Development Setup
+
+```bash
+python -m venv .venv
+source .venv/bin/activate
+pip install -e ".[test]"
+pip install ruff
+```
+
+## Running Tests
+
+```bash
+pytest tests/ -v                # Run tests
+tox                             # Full matrix (3.11-3.14)
+```
+
+## Code Style
+
+- Python 3.11+
+- Format with `ruff format src/ tests/`
+- Lint with `ruff check src/ tests/`
+
+## Pull Requests
+
+1. Fork the repository
+2. Create a feature branch
+3. Ensure tests pass and code is formatted
+4. Submit a PR with a clear description
+
+## Reporting Issues
+
+Use [GitHub Issues](https://github.com/dperezcabrera/pico-sqlalchemy/issues) for bugs and feature requests.

{pico_sqlalchemy-0.2.1.dev0 → pico_sqlalchemy-0.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pico-sqlalchemy
-Version: 0.2.1.dev0
+Version: 0.3.0
 Summary: Pico-ioc integration for SQLAlchemy. Adds Spring-style transactional support, configuration, and helpers.
 Author-email: David Perez Cabrera <dperezcabrera@gmail.com>
 License: MIT License
@@ -28,6 +28,8 @@ License: MIT License
 Project-URL: Homepage, https://github.com/dperezcabrera/pico-sqlalchemy
 Project-URL: Repository, https://github.com/dperezcabrera/pico-sqlalchemy
 Project-URL: Issue Tracker, https://github.com/dperezcabrera/pico-sqlalchemy/issues
+Project-URL: Documentation, https://dperezcabrera.github.io/pico-sqlalchemy/
+Project-URL: Changelog, https://github.com/dperezcabrera/pico-sqlalchemy/blob/main/CHANGELOG.md
 Keywords: ioc,di,dependency injection,sqlalchemy,transaction,orm,inversion of control,asyncio
 Classifier: Development Status :: 4 - Beta
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
@@ -38,8 +40,10 @@ Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Classifier: Programming Language :: Python :: 3.14
+Classifier: Intended Audience :: Developers
 Classifier: License :: OSI Approved :: MIT License
 Classifier: Operating System :: OS Independent
+Classifier: Typing :: Typed
 Requires-Python: >=3.11
 Description-Content-Type: text/markdown
 License-File: LICENSE
@@ -333,16 +337,23 @@ async def test_service():
 
 -----
 
-## 🤖 Claude Code Skills
+## AI Coding Skills
 
-This project includes pre-designed skills for [Claude Code](https://claude.ai/claude-code), enabling AI-assisted development with pico-sqlalchemy patterns.
+Install [Claude Code](https://code.claude.com) or [OpenAI Codex](https://openai.com/index/introducing-codex/) skills for AI-assisted development with pico-sqlalchemy:
 
-| Skill | Command | Description |
-|-------|---------|-------------|
-| **Pico SQLAlchemy Repository** | `/pico-sqlalchemy` | Creates models, repositories and services with DI |
-| **Pico Test Generator** | `/pico-tests` | Generates tests for pico-framework components |
+```bash
+curl -sL https://raw.githubusercontent.com/dperezcabrera/pico-skills/main/install.sh | bash -s -- sqlalchemy
+```
+
+| Command | Description |
+|---------|-------------|
+| `/add-repository` | Add SQLAlchemy entities and repositories with transactions |
+| `/add-component` | Add components, factories, interceptors, settings |
+| `/add-tests` | Generate tests for pico-framework components |
+
+All skills: `curl -sL https://raw.githubusercontent.com/dperezcabrera/pico-skills/main/install.sh | bash`
 
-See [Skills documentation](docs/skills.md) for full details and installation instructions.
+See [pico-skills](https://github.com/dperezcabrera/pico-skills) for details.
 
 ---
 

{pico_sqlalchemy-0.2.1.dev0 → pico_sqlalchemy-0.3.0}/README.md

@@ -278,16 +278,23 @@ async def test_service():
 
 -----
 
-## 🤖 Claude Code Skills
+## AI Coding Skills
 
-This project includes pre-designed skills for [Claude Code](https://claude.ai/claude-code), enabling AI-assisted development with pico-sqlalchemy patterns.
+Install [Claude Code](https://code.claude.com) or [OpenAI Codex](https://openai.com/index/introducing-codex/) skills for AI-assisted development with pico-sqlalchemy:
 
-| Skill | Command | Description |
-|-------|---------|-------------|
-| **Pico SQLAlchemy Repository** | `/pico-sqlalchemy` | Creates models, repositories and services with DI |
-| **Pico Test Generator** | `/pico-tests` | Generates tests for pico-framework components |
+```bash
+curl -sL https://raw.githubusercontent.com/dperezcabrera/pico-skills/main/install.sh | bash -s -- sqlalchemy
+```
+
+| Command | Description |
+|---------|-------------|
+| `/add-repository` | Add SQLAlchemy entities and repositories with transactions |
+| `/add-component` | Add components, factories, interceptors, settings |
+| `/add-tests` | Generate tests for pico-framework components |
+
+All skills: `curl -sL https://raw.githubusercontent.com/dperezcabrera/pico-skills/main/install.sh | bash`
 
-See [Skills documentation](docs/skills.md) for full details and installation instructions.
+See [pico-skills](https://github.com/dperezcabrera/pico-skills) for details.
 
 ---
 

pico_sqlalchemy-0.3.0/SECURITY.md

@@ -0,0 +1,23 @@
+# Security Policy
+
+## Supported Versions
+
+| Version | Supported          |
+|---------|--------------------|
+| 0.2.x   | Yes                |
+
+## Reporting a Vulnerability
+
+If you discover a security vulnerability, please report it responsibly:
+
+1. **Do NOT open a public issue.**
+2. Email **dperezcabrera@gmail.com** with:
+   - Description of the vulnerability
+   - Steps to reproduce
+   - Potential impact
+3. You will receive a response within 7 days.
+4. A fix will be released as soon as possible, with credit to the reporter (unless anonymity is preferred).
+
+## Scope
+
+This policy covers the `pico-sqlalchemy` Python package distributed via PyPI.

{pico_sqlalchemy-0.2.1.dev0 → pico_sqlalchemy-0.3.0/docs}/CHANGELOG.md

@@ -7,6 +7,13 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.h
 
 ---
 
+## [0.3.0] - 2026-02-20
+
+### Changed
+- **Breaking:** Renamed `DatabaseConfigurer.configure(engine)` to `configure_database(engine)` to avoid protocol collision with `FastApiConfigurer.configure(app)` in structural typing.
+
+---
+
 ## [0.2.0] - 2026-02-06
 
 ### Added