nlbone 0.1.21__tar.gz → 0.1.24__tar.gz

nlbone-0.1.24/.gitignore

@@ -0,0 +1,58 @@
+# Python
+local
+__pycache__/
+*.py[cod]
+*.pyo
+*.pyd
+*.pdb
+*.pyc
+
+# Virtual environment
+venv/
+env/
+ENV/
+.venv/
+
+# FastAPI
+*.log
+*.logs/
+
+# PyCharm
+.idea/
+.idea
+*.iml
+*.ipr
+*.iws
+
+# Others
+.DS_Store
+*.sqlite3
+*.db
+
+# VSCode
+.vscode/
+
+# Test cache
+htmlcov/
+.coverage
+.tox/
+nosetests.xml
+coverage.xml
+*.cover
+.pytest_cache/
+
+# Build
+build/
+dist/
+*.egg-info/
+.eggs/
+
+# dotenv
+.env
+.env.*
+
+# mypy
+.mypy_cache/
+.dmypy.json
+
+/dist

{nlbone-0.1.21 → nlbone-0.1.24}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: nlbone
-Version: 0.1.21
+Version: 0.1.24
 Summary: Backbone package for interfaces and infrastructure in Python projects
 Author-email: Amir Hosein Kahkbazzadeh <a.khakbazzadeh@gmail.com>
 License: MIT
@@ -21,6 +21,7 @@ Requires-Dist: pre-commit>=3.7; extra == 'dev'
 Requires-Dist: pytest-asyncio>=0.23; extra == 'dev'
 Requires-Dist: pytest>=8.0; extra == 'dev'
 Requires-Dist: ruff>=0.5; extra == 'dev'
+Requires-Dist: tomli; extra == 'dev'
 Requires-Dist: twine; extra == 'dev'
 Description-Content-Type: text/markdown
 

{nlbone-0.1.21 → nlbone-0.1.24}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "nlbone"
-version = "0.1.21"
+version = "0.1.24"
 description = "Backbone package for interfaces and infrastructure in Python projects"
 readme = "README.md"
 requires-python = ">=3.10"
@@ -30,7 +30,8 @@ dev = [
     "ruff>=0.5",
     "mypy>=1.10",
     "pre-commit>=3.7",
-    "twine"
+    "twine",
+    "tomli"
 ]
 
 [tool.ruff]

nlbone-0.1.24/src/nlbone/adapters/db/__init__.py

@@ -0,0 +1,2 @@
+from .sqlalchemy.engine import *
+from .sqlalchemy.query import *

nlbone-0.1.24/src/nlbone/adapters/db/sqlalchemy/engine.py

@@ -0,0 +1,118 @@
+from contextlib import asynccontextmanager, contextmanager
+from typing import Generator, Optional, Any, AsyncGenerator
+
+from sqlalchemy import create_engine, text
+from sqlalchemy.engine import Engine
+from sqlalchemy.orm import Session, sessionmaker
+
+from sqlalchemy.ext.asyncio import (
+    AsyncEngine,
+    AsyncSession,
+    async_sessionmaker,
+    create_async_engine,
+)
+
+from nlbone.config.settings import get_settings
+
+_settings = get_settings()
+
+ASYNC_DSN: str = _settings.POSTGRES_DB_DSN
+
+if "+asyncpg" in ASYNC_DSN:
+    SYNC_DSN: str = ASYNC_DSN.replace("+asyncpg", "+psycopg")
+else:
+    SYNC_DSN = ASYNC_DSN
+
+_async_engine: Optional[AsyncEngine] = None
+_async_session_factory: Optional[async_sessionmaker[AsyncSession]] = None
+
+_sync_engine: Optional[Engine] = None
+_sync_session_factory: Optional[sessionmaker[Session]] = None
+
+
+def init_async_engine(echo: Optional[bool] = None) -> AsyncEngine:
+    global _async_engine, _async_session_factory
+    if _async_engine is not None:
+        return _async_engine
+
+    _async_engine = create_async_engine(
+        ASYNC_DSN,
+        echo=_settings.DEBUG if echo is None else echo,
+        pool_pre_ping=True,
+        pool_size=5,
+        max_overflow=10,
+    )
+    _async_session_factory = async_sessionmaker(
+        bind=_async_engine,
+        expire_on_commit=False,
+        autoflush=False,
+    )
+    return _async_engine
+
+
+@asynccontextmanager
+async def async_session() -> AsyncGenerator[AsyncSession, Any]:
+    if _async_session_factory is None:
+        init_async_engine()
+    assert _async_session_factory is not None
+    session = _async_session_factory()
+    try:
+        yield session
+        await session.commit()
+    except Exception:
+        await session.rollback()
+        raise
+    finally:
+        await session.close()
+
+
+async def async_ping() -> None:
+    eng = init_async_engine()
+    async with eng.connect() as conn:
+        await conn.execute(text("SELECT 1"))
+
+
+def init_sync_engine(echo: Optional[bool] = None) -> Engine:
+    global _sync_engine, _sync_session_factory
+    if _sync_engine is not None:
+        return _sync_engine
+
+    _sync_engine = create_engine(
+        SYNC_DSN,
+        echo=_settings.DEBUG if echo is None else echo,
+        pool_pre_ping=True,
+        pool_size=5,
+        max_overflow=10,
+        future=True,
+    )
+    _sync_session_factory = sessionmaker(
+        bind=_sync_engine,
+        autocommit=False,
+        autoflush=False,
+        expire_on_commit=False,
+        future=True,
+    )
+    return _sync_engine
+
+
+@contextmanager
+def sync_session() -> Generator[Session, None, None]:
+    if _sync_session_factory is None:
+        init_sync_engine()
+    assert _sync_session_factory is not None
+    s = _sync_session_factory()
+    try:
+        yield s
+        s.commit()
+    except Exception:
+        s.rollback()
+        raise
+    finally:
+        s.close()
+
+
+def sync_ping() -> None:
+    """Health check برای اتصال sync."""
+    eng = init_sync_engine()
+    with eng.connect() as conn:
+        conn.execute(text("SELECT 1"))

{nlbone-0.1.21 → nlbone-0.1.24}/src/nlbone/config/settings.py

@@ -12,7 +12,7 @@ class Settings(BaseSettings):
     ENV: Literal["local", "dev", "staging", "prod"] = Field(default="local")
     DEBUG: bool = Field(default=False)
     LOG_LEVEL: Literal["CRITICAL", "ERROR", "WARNING", "INFO", "DEBUG"] = Field(default="INFO")
-    LOG_JSON: bool = Field(default=True)  # اگر False باشد، فرمت متنی ساده می‌شود.
+    LOG_JSON: bool = Field(default=True)
 
     # ---------------------------
     # HTTP / Timeouts
@@ -30,10 +30,10 @@ class Settings(BaseSettings):
     # ---------------------------
     # Database
     # ---------------------------
-    DB_DSN: str = Field(default="postgresql+asyncpg://user:pass@localhost:5432/nlbone")
+    POSTGRES_DB_DSN: str = Field(default="postgresql+asyncpg://user:pass@localhost:5432/nlbone")
 
     # ---------------------------
-    # Messaging / Cache (نمونه)
+    # Messaging / Cache
     # ---------------------------
     REDIS_URL: str = Field(default="redis://localhost:6379/0")
 

nlbone-0.1.24/src/nlbone/interfaces/api/dependencies.py

@@ -0,0 +1,16 @@
+from __future__ import annotations
+from typing import AsyncGenerator, Generator
+
+from sqlalchemy.orm import Session
+from sqlalchemy.ext.asyncio import AsyncSession
+
+from nlbone.adapters.db.sqlalchemy.engine import async_session, sync_session
+
+
+async def get_async_session() -> AsyncGenerator[AsyncSession, None]:
+    async with async_session() as s:
+        yield s
+
+def get_session() -> Generator[Session, None, None]:
+    with sync_session() as s:
+        yield s