matrx-orm 1.4.1

Add your description here

matrx-orm

ORM utilities for the Matrx platform.

Installation

From PyPI (recommended)

pip install matrx-orm
# or with uv
uv add matrx-orm

From GitHub (for development)

pip install git+https://github.com/armanisadeghi/matrx-orm.git

Publishing a New Version

Automated PyPI Publishing (Current Process)

The package automatically publishes to PyPI when you push a version tag. Here's the workflow:

1. Make and test your changes locally

   # Test your changes
   

2. Update the version in pyproject.toml

   version = "1.0.5"  # Increment appropriately
   

3. Commit and push changes

   git add .
   git commit -m "Add new feature - v1.0.5"
   git push origin main
   

4. Create and push the version tag

   git tag v1.0.5
   git push origin v1.0.5
   

5. GitHub Actions automatically:

   • Verifies the tag matches pyproject.toml version
   • Builds the package
   • Publishes to PyPI

6. Update dependent projects

   In projects like AI Dream, simply update the version:

   uv add matrx-orm@1.0.5
   # or manually in pyproject.toml:
   # matrx-orm = "^1.0.5"
   

Version History

Check current tags: git tag

Latest Versions:

• v1.2.0 - Upgraded to psycopg3 (modern PostgreSQL adapter, no pg_config build required)
• v1.1.3 - Legacy version (psycopg2)
• v1.0.x - Earlier releases

Important Notes

• Always update pyproject.toml version before tagging
• The GitHub Action will fail if tag version ≠ pyproject.toml version
• Semantic versioning: MAJOR.MINOR.PATCH (e.g., v1.0.5)
• Tags trigger automatic PyPI publishing