dbentity 1.0.0__tar.gz

dbentity-1.0.0/.github/workflows/publish.yml

@@ -0,0 +1,35 @@
+name: Publish to PyPI
+
+on:
+  release:
+    types: [published]
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      id-token: write
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.14"
+
+      - name: Install build dependencies
+        run: pip install build
+
+      - name: Install package
+        run: pip install .
+
+      - name: Run unit tests
+        run: python -m unittest discover -v tests/
+
+      - name: Build package
+        run: python -m build
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

dbentity-1.0.0/.github/workflows/tests.yml

@@ -0,0 +1,29 @@
+name: Tests
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    runs-on: ${{ matrix.os }}
+    strategy:
+      matrix:
+        os: [ubuntu-latest, windows-latest]
+        python-version: ["3.10", "3.14"]
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install package
+        run: pip install .
+
+      - name: Run unit tests
+        run: python -m unittest discover -v tests/

dbentity-1.0.0/.gitignore

@@ -0,0 +1,13 @@
+__pycache__
+build
+dist
+.*
+!.gitignore
+!.github
+!.mpyproject
+*.egg-info
+_version.py
+*.md
+!README*.md
+scripts/
+*.whl

dbentity-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2024 Pavel Revak
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

dbentity-1.0.0/PKG-INFO

@@ -0,0 +1,126 @@
+Metadata-Version: 2.4
+Name: dbentity
+Version: 1.0.0
+Summary: Lightweight Python ORM library for PostgreSQL
+Author-email: Pavel Revak <pavel.revak@gmail.com>
+License: MIT
+Project-URL: Homepage, https://github.com/pavelrevak/dbentity
+Keywords: orm,postgresql,database,entity,sql
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Database
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Programming Language :: Python :: 3
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# dbentity
+
+Lightweight Python ORM library for PostgreSQL.
+
+## Installation
+
+```bash
+pip install dbentity
+```
+
+## Features
+
+- Declarative entity definitions with typed attributes
+- Automatic SQL query generation
+- Support for JOIN operations
+- Query builder with boolean logic (AND, OR, NOT)
+- Database migration support
+- No external dependencies
+
+## Quick Start
+
+```python
+from dbentity.db_entity import DbEntity
+from dbentity.attribute import IndexAttribute, StringAttribute, IntegerAttribute
+from dbentity.db_control import OrderByDesc, Limit
+
+class User(DbEntity):
+    TABLE = 'users'
+    ITEMS = (
+        IndexAttribute(),
+        StringAttribute('name', form_key='user_name'),
+        IntegerAttribute('age', minimal=0, maximal=150),
+    )
+
+# Query with controls
+users = User.db_list(db, OrderByDesc('age'), Limit(10), name='John')
+user = User.db_get(db, uid=123)
+
+# Create new entity
+user = User.create(db, name='Jane', age=25)
+
+# Update
+user.age = 26
+user.db_save(db)
+
+# Delete
+user.db_delete(db)
+```
+
+## Attribute Types
+
+- `IndexAttribute` / `CreateIndexAttribute` - Primary key
+- `StringAttribute` - Text fields
+- `IntegerAttribute` - Integer with optional min/max
+- `FixedPointAttribute` - Decimal numbers
+- `BooleanAttribute` - Boolean values
+- `BytesAttribute` - Binary data
+- `PasswordAttribute` - Password fields (hidden in templates)
+- `DatetimeAttribute` - Datetime values
+- `ConnectionAttribute` - Foreign key relationships
+- `SubElementsAttribute` - One-to-many relationships
+
+## Query Controls
+
+```python
+from dbentity.db_control import (
+    Where, And, Or, Not,
+    Lt, Gt, Le, Ge,
+    OrderBy, OrderByAsc, OrderByDesc,
+    Limit, Offset,
+    LeftJoin, RightJoin,
+    GroupBy,
+)
+
+# Complex queries
+users = User.db_list(
+    db,
+    Or(Where(name='John'), Where(name='Jane')),
+    Gt(age=18),
+    Lt(age=65),
+    OrderByDesc('age'),
+    Limit(10),
+)
+
+# Joins
+posts = Post.db_list(
+    db,
+    LeftJoin('author', name='John'),
+    OrderByDesc('created_at'),
+)
+```
+
+## Database Migrations
+
+```python
+from dbentity.db_upgrade import db_upgrade
+
+SQL_UPGRADE_FILES = [
+    (1, 'upgrade_001.sql'),
+    (2, 'upgrade_002.sql'),
+]
+
+db_upgrade(db, log, 'sql/', 'init.sql', SQL_UPGRADE_FILES)
+```
+
+## License
+
+MIT

dbentity-1.0.0/README.md

@@ -0,0 +1,108 @@
+# dbentity
+
+Lightweight Python ORM library for PostgreSQL.
+
+## Installation
+
+```bash
+pip install dbentity
+```
+
+## Features
+
+- Declarative entity definitions with typed attributes
+- Automatic SQL query generation
+- Support for JOIN operations
+- Query builder with boolean logic (AND, OR, NOT)
+- Database migration support
+- No external dependencies
+
+## Quick Start
+
+```python
+from dbentity.db_entity import DbEntity
+from dbentity.attribute import IndexAttribute, StringAttribute, IntegerAttribute
+from dbentity.db_control import OrderByDesc, Limit
+
+class User(DbEntity):
+    TABLE = 'users'
+    ITEMS = (
+        IndexAttribute(),
+        StringAttribute('name', form_key='user_name'),
+        IntegerAttribute('age', minimal=0, maximal=150),
+    )
+
+# Query with controls
+users = User.db_list(db, OrderByDesc('age'), Limit(10), name='John')
+user = User.db_get(db, uid=123)
+
+# Create new entity
+user = User.create(db, name='Jane', age=25)
+
+# Update
+user.age = 26
+user.db_save(db)
+
+# Delete
+user.db_delete(db)
+```
+
+## Attribute Types
+
+- `IndexAttribute` / `CreateIndexAttribute` - Primary key
+- `StringAttribute` - Text fields
+- `IntegerAttribute` - Integer with optional min/max
+- `FixedPointAttribute` - Decimal numbers
+- `BooleanAttribute` - Boolean values
+- `BytesAttribute` - Binary data
+- `PasswordAttribute` - Password fields (hidden in templates)
+- `DatetimeAttribute` - Datetime values
+- `ConnectionAttribute` - Foreign key relationships
+- `SubElementsAttribute` - One-to-many relationships
+
+## Query Controls
+
+```python
+from dbentity.db_control import (
+    Where, And, Or, Not,
+    Lt, Gt, Le, Ge,
+    OrderBy, OrderByAsc, OrderByDesc,
+    Limit, Offset,
+    LeftJoin, RightJoin,
+    GroupBy,
+)
+
+# Complex queries
+users = User.db_list(
+    db,
+    Or(Where(name='John'), Where(name='Jane')),
+    Gt(age=18),
+    Lt(age=65),
+    OrderByDesc('age'),
+    Limit(10),
+)
+
+# Joins
+posts = Post.db_list(
+    db,
+    LeftJoin('author', name='John'),
+    OrderByDesc('created_at'),
+)
+```
+
+## Database Migrations
+
+```python
+from dbentity.db_upgrade import db_upgrade
+
+SQL_UPGRADE_FILES = [
+    (1, 'upgrade_001.sql'),
+    (2, 'upgrade_002.sql'),
+]
+
+db_upgrade(db, log, 'sql/', 'init.sql', SQL_UPGRADE_FILES)
+```
+
+## License
+
+MIT

dbentity-1.0.0/dbentity/__init__.py

@@ -0,0 +1,6 @@
+"""Lightweight Python ORM library for PostgreSQL"""
+
+try:
+    from dbentity._version import version as __version__
+except ImportError:
+    __version__ = "0.0.0"

dbentity-1.0.0/dbentity/_version.py

@@ -0,0 +1,24 @@
+# file generated by vcs-versioning
+# don't change, don't track in version control
+from __future__ import annotations
+
+__all__ = [
+    "__version__",
+    "__version_tuple__",
+    "version",
+    "version_tuple",
+    "__commit_id__",
+    "commit_id",
+]
+
+version: str
+__version__: str
+__version_tuple__: tuple[int | str, ...]
+version_tuple: tuple[int | str, ...]
+commit_id: str | None
+__commit_id__: str | None
+
+__version__ = version = '1.0.0'
+__version_tuple__ = version_tuple = (1, 0, 0)
+
+__commit_id__ = commit_id = 'ge2f9626cc'