oxutils 0.1.4__tar.gz → 0.1.6__tar.gz

{oxutils-0.1.4 → oxutils-0.1.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: oxutils
-Version: 0.1.4
+Version: 0.1.6
 Summary: Production-ready utilities for Django applications in the Oxiliere ecosystem
 Keywords: django,utilities,jwt,s3,audit,logging,celery,structlog
 Author: Edimedia Mutoke
@@ -16,7 +16,6 @@ Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Classifier: Topic :: Internet :: WWW/HTTP
-Requires-Dist: bcc-rates>=1.1.0
 Requires-Dist: boto3>=1.41.5
 Requires-Dist: celery>=5.5.3
 Requires-Dist: cryptography>=46.0.3
@@ -31,12 +30,19 @@ Requires-Dist: jwcrypto>=1.5.6
 Requires-Dist: pydantic-settings>=2.12.0
 Requires-Dist: pyjwt>=2.10.1
 Requires-Dist: requests>=2.32.5
+Requires-Dist: bcc-rates>=1.1.0 ; extra == 'currency'
+Requires-Dist: django-cacheops>=7.2 ; extra == 'oxiliere'
+Requires-Dist: django-tenants>=3.9.0 ; extra == 'oxiliere'
+Requires-Dist: weasyprint>=67.0 ; extra == 'pdf'
 Requires-Python: >=3.12
 Project-URL: Changelog, https://github.com/oxiliere/oxutils/blob/main/CHANGELOG.md
 Project-URL: Documentation, https://github.com/oxiliere/oxutils/tree/main/docs
 Project-URL: Homepage, https://github.com/oxiliere/oxutils
 Project-URL: Issues, https://github.com/oxiliere/oxutils/issues
 Project-URL: Repository, https://github.com/oxiliere/oxutils
+Provides-Extra: currency
+Provides-Extra: oxiliere
+Provides-Extra: pdf
 Description-Content-Type: text/markdown
 
 # OxUtils
@@ -46,7 +52,7 @@ Description-Content-Type: text/markdown
 [![PyPI version](https://img.shields.io/pypi/v/oxutils.svg)](https://pypi.org/project/oxutils/)
 [![Python 3.12+](https://img.shields.io/badge/python-3.12+-blue.svg)](https://www.python.org/)
 [![Django 5.0+](https://img.shields.io/badge/django-5.0+-green.svg)](https://www.djangoproject.com/)
-[![Tests](https://img.shields.io/badge/tests-145%20passed-success.svg)](tests/)
+[![Tests](https://img.shields.io/badge/tests-201%20passed-success.svg)](tests/)
 [![License](https://img.shields.io/badge/license-Apache%202.0-blue.svg)](LICENSE)
 [![Code style: ruff](https://img.shields.io/badge/code%20style-ruff-000000.svg)](https://github.com/astral-sh/ruff)
 
@@ -60,6 +66,9 @@ Description-Content-Type: text/markdown
 - 🛠️ **Django Mixins** - UUID, timestamps, user tracking
 - ⚡ **Custom Exceptions** - Standardized API errors
 - 🎨 **Context Processors** - Site name and domain for templates
+- 💱 **Currency Module** - Multi-source exchange rates (BCC/OXR)
+- 📄 **PDF Generation** - WeasyPrint integration for Django
+- 🏢 **Multi-Tenant** - PostgreSQL schema-based isolation
 
 ---
 
@@ -141,6 +150,7 @@ TEMPLATES = [{
 
 ## Documentation
 
+### Core Modules
 - **[Settings](docs/settings.md)** - Configuration reference
 - **[JWT](docs/jwt.md)** - Authentication
 - **[S3](docs/s3.md)** - Storage backends
@@ -149,6 +159,11 @@ TEMPLATES = [{
 - **[Mixins](docs/mixins.md)** - Model/service mixins
 - **[Celery](docs/celery.md)** - Task processing
 
+### Additional Modules
+- **[Currency](docs/currency.md)** - Exchange rates management
+- **[PDF](docs/pdf.md)** - PDF generation with WeasyPrint
+- **[Oxiliere](docs/oxiliere.md)** - Multi-tenant architecture
+
 ## Requirements
 
 - Python 3.12+
@@ -161,7 +176,7 @@ TEMPLATES = [{
 git clone https://github.com/oxiliere/oxutils.git
 cd oxutils
 uv sync
-uv run pytest  # 145 tests
+uv run pytest  # 201 tests passing, 4 skipped
 ```
 
 ### Creating Migrations
@@ -176,6 +191,19 @@ uv run make_migrations.py
 
 See [MIGRATIONS.md](MIGRATIONS.md) for detailed documentation.
 
+## Optional Dependencies
+
+```bash
+# Multi-tenant support
+uv add oxutils[oxiliere]
+
+# PDF generation
+uv add oxutils[pdf]
+
+# Development tools
+uv add oxutils[dev]
+```
+
 ## Advanced Examples
 
 ### JWT with Django Ninja
@@ -210,6 +238,55 @@ export = export_logs_from_date(from_date=from_date)
 print(f"Exported to {export.data.url}")
 ```
 
+### Currency Exchange Rates
+
+```python
+from oxutils.currency.models import CurrencyState
+
+# Sync rates from BCC (with OXR fallback)
+state = CurrencyState.sync()
+
+# Get latest rates
+latest = CurrencyState.objects.latest()
+usd_rate = latest.currencies.get(code='USD').rate
+eur_rate = latest.currencies.get(code='EUR').rate
+```
+
+### PDF Generation
+
+```python
+from oxutils.pdf.printer import Printer
+from oxutils.pdf.views import WeasyTemplateView
+
+# Standalone PDF generation
+printer = Printer(
+    template_name='invoice.html',
+    context={'invoice': invoice},
+    stylesheets=['css/invoice.css']
+)
+pdf_bytes = printer.write_pdf()
+
+# Class-based view
+class InvoicePDFView(WeasyTemplateView):
+    template_name = 'invoice.html'
+    pdf_filename = 'invoice.pdf'
+    pdf_stylesheets = ['css/invoice.css']
+```
+
+### Multi-Tenant Setup
+
+```python
+# settings.py
+TENANT_MODEL = "oxiliere.Tenant"
+MIDDLEWARE = [
+    'oxutils.oxiliere.middleware.TenantMainMiddleware',  # First!
+    # other middleware...
+]
+
+# All requests must include X-Organization-ID header
+# Data is automatically isolated per tenant schema
+```
+
 ## License
 
 Apache 2.0 License - see [LICENSE](LICENSE)

{oxutils-0.1.4 → oxutils-0.1.6}/README.md

@@ -5,7 +5,7 @@
 [![PyPI version](https://img.shields.io/pypi/v/oxutils.svg)](https://pypi.org/project/oxutils/)
 [![Python 3.12+](https://img.shields.io/badge/python-3.12+-blue.svg)](https://www.python.org/)
 [![Django 5.0+](https://img.shields.io/badge/django-5.0+-green.svg)](https://www.djangoproject.com/)
-[![Tests](https://img.shields.io/badge/tests-145%20passed-success.svg)](tests/)
+[![Tests](https://img.shields.io/badge/tests-201%20passed-success.svg)](tests/)
 [![License](https://img.shields.io/badge/license-Apache%202.0-blue.svg)](LICENSE)
 [![Code style: ruff](https://img.shields.io/badge/code%20style-ruff-000000.svg)](https://github.com/astral-sh/ruff)
 
@@ -19,6 +19,9 @@
 - 🛠️ **Django Mixins** - UUID, timestamps, user tracking
 - ⚡ **Custom Exceptions** - Standardized API errors
 - 🎨 **Context Processors** - Site name and domain for templates
+- 💱 **Currency Module** - Multi-source exchange rates (BCC/OXR)
+- 📄 **PDF Generation** - WeasyPrint integration for Django
+- 🏢 **Multi-Tenant** - PostgreSQL schema-based isolation
 
 ---
 
@@ -100,6 +103,7 @@ TEMPLATES = [{
 
 ## Documentation
 
+### Core Modules
 - **[Settings](docs/settings.md)** - Configuration reference
 - **[JWT](docs/jwt.md)** - Authentication
 - **[S3](docs/s3.md)** - Storage backends
@@ -108,6 +112,11 @@ TEMPLATES = [{
 - **[Mixins](docs/mixins.md)** - Model/service mixins
 - **[Celery](docs/celery.md)** - Task processing
 
+### Additional Modules
+- **[Currency](docs/currency.md)** - Exchange rates management
+- **[PDF](docs/pdf.md)** - PDF generation with WeasyPrint
+- **[Oxiliere](docs/oxiliere.md)** - Multi-tenant architecture
+
 ## Requirements
 
 - Python 3.12+
@@ -120,7 +129,7 @@ TEMPLATES = [{
 git clone https://github.com/oxiliere/oxutils.git
 cd oxutils
 uv sync
-uv run pytest  # 145 tests
+uv run pytest  # 201 tests passing, 4 skipped
 ```
 
 ### Creating Migrations
@@ -135,6 +144,19 @@ uv run make_migrations.py
 
 See [MIGRATIONS.md](MIGRATIONS.md) for detailed documentation.
 
+## Optional Dependencies
+
+```bash
+# Multi-tenant support
+uv add oxutils[oxiliere]
+
+# PDF generation
+uv add oxutils[pdf]
+
+# Development tools
+uv add oxutils[dev]
+```
+
 ## Advanced Examples
 
 ### JWT with Django Ninja
@@ -169,6 +191,55 @@ export = export_logs_from_date(from_date=from_date)
 print(f"Exported to {export.data.url}")
 ```
 
+### Currency Exchange Rates
+
+```python
+from oxutils.currency.models import CurrencyState
+
+# Sync rates from BCC (with OXR fallback)
+state = CurrencyState.sync()
+
+# Get latest rates
+latest = CurrencyState.objects.latest()
+usd_rate = latest.currencies.get(code='USD').rate
+eur_rate = latest.currencies.get(code='EUR').rate
+```
+
+### PDF Generation
+
+```python
+from oxutils.pdf.printer import Printer
+from oxutils.pdf.views import WeasyTemplateView
+
+# Standalone PDF generation
+printer = Printer(
+    template_name='invoice.html',
+    context={'invoice': invoice},
+    stylesheets=['css/invoice.css']
+)
+pdf_bytes = printer.write_pdf()
+
+# Class-based view
+class InvoicePDFView(WeasyTemplateView):
+    template_name = 'invoice.html'
+    pdf_filename = 'invoice.pdf'
+    pdf_stylesheets = ['css/invoice.css']
+```
+
+### Multi-Tenant Setup
+
+```python
+# settings.py
+TENANT_MODEL = "oxiliere.Tenant"
+MIDDLEWARE = [
+    'oxutils.oxiliere.middleware.TenantMainMiddleware',  # First!
+    # other middleware...
+]
+
+# All requests must include X-Organization-ID header
+# Data is automatically isolated per tenant schema
+```
+
 ## License
 
 Apache 2.0 License - see [LICENSE](LICENSE)

{oxutils-0.1.4 → oxutils-0.1.6}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "oxutils"
-version = "0.1.4"
+version = "0.1.6"
 description = "Production-ready utilities for Django applications in the Oxiliere ecosystem"
 readme = "README.md"
 license = "Apache-2.0"
@@ -22,7 +22,6 @@ classifiers = [
     "Topic :: Internet :: WWW/HTTP",
 ]
 dependencies = [
-    "bcc-rates>=1.1.0",
     "boto3>=1.41.5",
     "celery>=5.5.3",
     "cryptography>=46.0.3",
@@ -55,6 +54,22 @@ members = [
     ".",
 ]
 
+[tool.uv.sources]
+oxutils = { workspace = true }
+
+[project.optional-dependencies]
+currency = [
+    "bcc-rates>=1.1.0",
+]
+
+oxiliere = [
+    "django-cacheops>=7.2",
+    "django-tenants>=3.9.0",
+]
+pdf = [
+    "weasyprint>=67.0",
+]
+
 [dependency-groups]
 dev = [
     "pytest>=8.0.0",
@@ -66,6 +81,7 @@ dev = [
     "ruff>=0.8.0",
 ]
 
+
 [tool.ruff]
 line-length = 100
 target-version = "py312"

{oxutils-0.1.4 → oxutils-0.1.6}/src/oxutils/__init__.py

@@ -10,7 +10,7 @@ This package provides:
 - Custom exceptions
 """
 
-__version__ = "0.1.4"
+__version__ = "0.1.6"
 
 from oxutils.settings import oxi_settings
 from oxutils.conf import UTILS_APPS, AUDIT_MIDDLEWARE

oxutils-0.1.6/src/oxutils/constants.py

@@ -0,0 +1,2 @@
+ORGANIZATION_QUERY_KEY = 'organization_id'
+ORGANIZATION_HEADER_KEY = 'X-Organization-ID'

{oxutils-0.1.4 → oxutils-0.1.6}/src/oxutils/currency/controllers.py

@@ -11,12 +11,13 @@ from ninja_extra.pagination import (
 from ninja.errors import HttpError
 from uuid import UUID
 import structlog
-from currency.models import CurrencyState
-from currency.schemas import (
+from oxutils.currency.models import CurrencyState
+from oxutils.currency.schemas import (
     CurrencyStateSchema,
     CurrencyStateDetailSchema,
 )
 
+
 logger = structlog.get_logger(__name__)
 
 

oxutils-0.1.6/src/oxutils/currency/utils.py

@@ -0,0 +1,69 @@
+import time
+from django.conf import settings
+from django.db import transaction
+from bcc_rates import BCCBankSource, OXRBankSource, SourceValue
+from oxutils.currency.enums import CurrencySource
+from oxutils.currency.schemas import CurrencyStateDetailSchema
+import structlog
+
+logger = structlog.get_logger(__name__)
+
+
+def load_rates() -> tuple[list[SourceValue], CurrencySource]:
+    max_retries = 3
+    retry_count = 0
+    
+    while retry_count < max_retries:
+        try:
+            bcc_source = BCCBankSource()
+            rates = bcc_source.sync(cache=True)
+            return rates, CurrencySource.BCC
+        except Exception as e:
+            retry_count += 1
+            if retry_count < max_retries:
+                time.sleep(1)
+            else:
+                if not getattr(settings, 'OXI_BCC_FALLBACK_ON_OXR', False):
+                    raise Exception(f"Failed to load rates from BCC: {str(e)}")
+                break
+    
+    try:
+        oxr_source = OXRBankSource()
+        rates = oxr_source.sync(cache=True)
+        return rates, CurrencySource.OXR
+    except Exception as e:
+        raise Exception(f"Failed to load rates from both BCC and OXR: {str(e)}")
+
+@transaction.atomic
+def update_rates(state: CurrencyStateDetailSchema):
+    from oxutils.currency.models import CurrencyState, Currency 
+
+    if CurrencyState.objects.filter(id=state.id).exists():
+        logger.info("currency_state_exists", id=state.id)
+        return
+
+    if not len(state.currencies.keys()):
+        logger.info("currency_state_no_currencies", id=state.id)
+        return
+
+    _state = CurrencyState.objects.create(
+        id=state.id,
+        source=state.source,
+        created_at=state.created_at,
+        updated_at=state.updated_at,
+    )
+
+    currencies = []
+
+    for key, value in state.currencies.items():
+        currencies.append(
+            Currency(
+                code=key,
+                rate=value,
+                state=_state
+            )
+        )
+
+    Currency.objects.bulk_create(currencies)
+
+    logger.info("currency_state_updated", id=state.id)

oxutils-0.1.6/src/oxutils/oxiliere/admin.py

@@ -0,0 +1,3 @@
+from django.contrib import admin
+
+# Register your models here.

oxutils-0.1.6/src/oxutils/oxiliere/apps.py

@@ -0,0 +1,6 @@
+from django.apps import AppConfig
+
+
+class OxiliereConfig(AppConfig):
+    default_auto_field = 'django.db.models.BigAutoField'
+    name = 'oxiliere'

oxutils-0.1.6/src/oxutils/oxiliere/cacheops.py

@@ -0,0 +1,7 @@
+from  django.db import connection
+
+
+def cacheops_prefix(query):
+    if connection.schema_name:
+        return '%s:' % connection.schema_name
+    return 'default:'

oxutils-0.1.6/src/oxutils/oxiliere/caches.py

@@ -0,0 +1,33 @@
+from cacheops import cached_as, cached
+from oxutils.oxiliere.models import Tenant, TenantUser
+from django_tenants.utils import get_tenant_model
+
+
+TenantModel = get_tenant_model()
+
+
+@cached_as(TenantModel, timeout=60*15)
+def get_tenant_by_oxi_id(oxi_id: str):
+    return TenantModel.objects.get(oxi_id=oxi_id)
+
+
+@cached_as(TenantModel, timeout=60*15)
+def get_tenant_by_schema_name(schema_name: str) -> Tenant:
+    return TenantModel.objects.get(schema_name=schema_name)
+
+
+@cached_as(TenantUser, timeout=60*15)
+def get_tenant_user(oxi_org_id: str, oxi_user_id: str):
+    return TenantUser.objects.get(
+        tenant__oxi_id=oxi_org_id,
+        user__oxi_id=oxi_user_id
+    )
+
+@cached(timeout=60*15)
+def get_system_tenant():
+    from oxutils.oxiliere.utils import oxid_to_schema_name
+
+    system_schema_name = oxid_to_schema_name(
+        getattr(settings, 'OXI_SYSTEM_TENANT', 'tenant_oxisystem')
+    )
+    return get_tenant_model().objects.get(schema_name=system_schema_name)

oxutils-0.1.6/src/oxutils/oxiliere/controllers.py

@@ -0,0 +1,36 @@
+from ninja_extra import (
+    api_controller,
+    ControllerBase,
+    http_post,
+)
+from .permissions import OxiliereServicePermission
+from .schemas import CreateTenantSchema
+from oxutils.mixins.schemas import ResponseSchema
+
+
+@api_controller(
+    '/setup',
+    tags=['Setup'],
+    auth=None,
+    permissions=[
+        OxiliereServicePermission(),
+    ]
+)
+class SetupController(ControllerBase):
+    
+    @http_post(
+        '/init',
+        response=ResponseSchema,
+    )
+    def init(self, payload: CreateTenantSchema):
+        try:
+            payload.create_tenant()
+        except Exception as e:
+            return ResponseSchema(
+                code='initialization_failed',
+                detail=str(e)
+            )
+        return ResponseSchema(
+            code='success',
+            detail='Tenant initialized successfully'
+        )

oxutils-0.1.6/src/oxutils/oxiliere/enums.py

@@ -0,0 +1,10 @@
+from django.db.models import TextChoices
+
+
+
+class TenantStatus(TextChoices):
+    ACTIVE = 'active'
+    INACTIVE = 'inactive'
+    SUSPENDED = 'suspended'
+    DELETED = 'deleted'
+    REMOVED = 'removed'

oxutils-0.1.6/src/oxutils/oxiliere/management/commands/init_oxiliere_system.py

@@ -0,0 +1,86 @@
+import uuid
+from django.core.management.base import BaseCommand
+from django.conf import settings
+from django.db import transaction
+from django.contrib.auth import get_user_model
+from django_tenants.utils import get_tenant_model
+from oxutils.oxiliere.models import Domain, TenantUser
+from oxutils.oxiliere.utils import oxid_to_schema_name
+
+
+
+class Command(BaseCommand):
+    help = 'Initialise le tenant système Oxiliere'
+
+    @transaction.atomic
+    def handle(self, *args, **options):
+        TenantModel = get_tenant_model()
+        UserModel = get_user_model()
+        
+        # Configuration du tenant système depuis settings
+        system_slug = getattr(settings, 'OXI_SYSTEM_TENANT', 'tenant_oxisystem')
+        schema_name = oxid_to_schema_name(system_slug)
+        system_domain = getattr(settings, 'OXI_SYSTEM_DOMAIN', 'system.oxiliere.com')
+        owner_email = getattr(settings, 'OXI_SYSTEM_OWNER_EMAIL', 'dev@oxiliere.com')
+        owner_oxi_id = uuid.uuid4()
+        
+        self.stdout.write(self.style.WARNING(f'Initialisation du tenant système...'))
+        
+        # Vérifier si le tenant système existe déjà
+        if TenantModel.objects.filter(schema_name=schema_name).exists():
+            self.stdout.write(self.style.ERROR(f'Le tenant système "{schema_name}" existe déjà!'))
+            return
+        
+        # Créer le tenant système
+        self.stdout.write(f'Création du tenant système: {schema_name}')
+        tenant = TenantModel.objects.create(
+            name='Oxiliere System',
+            schema_name=schema_name,
+            oxi_id=system_slug,
+            subscription_plan='system',
+            subscription_status='active',
+        )
+        self.stdout.write(self.style.SUCCESS(f'✓ Tenant système créé: {tenant.name} ({tenant.schema_name})'))
+        
+        # Créer le domaine pour le tenant système
+        self.stdout.write(f'Création du domaine: {system_domain}')
+        domain = Domain.objects.create(
+            domain=system_domain,
+            tenant=tenant,
+            is_primary=True
+        )
+        self.stdout.write(self.style.SUCCESS(f'✓ Domaine créé: {domain.domain}'))
+        
+        self.stdout.write(f'Création du superuser: {owner_email}')
+        try:
+            superuser = UserModel.objects.get(email=owner_email)
+            self.stdout.write(self.style.WARNING(f'⚠ Superuser existe déjà: {superuser.email}'))
+        except UserModel.DoesNotExist:
+            superuser = UserModel.objects.create_superuser(
+                email=owner_email,
+                oxi_id=owner_oxi_id,
+                first_name='System',
+                last_name='Admin'
+            )
+            self.stdout.write(self.style.SUCCESS(f'✓ Superuser créé: {superuser.email}'))
+        
+        # Lier le superuser au tenant système
+        self.stdout.write('Liaison du superuser au tenant système')
+        tenant_user, created = TenantUser.objects.get_or_create(
+            tenant=tenant,
+            user=superuser,
+            defaults={
+                'is_owner': True,
+                'is_admin': True,
+            }
+        )
+        if created:
+            self.stdout.write(self.style.SUCCESS(f'✓ Superuser lié au tenant système'))
+        else:
+            self.stdout.write(self.style.WARNING(f'⚠ Liaison existe déjà'))
+        
+        self.stdout.write(self.style.SUCCESS('\n=== Initialisation terminée avec succès ==='))
+        self.stdout.write(f'Tenant: {tenant.name}')
+        self.stdout.write(f'Schema: {tenant.schema_name}')
+        self.stdout.write(f'Domain: {domain.domain}')
+        self.stdout.write(f'Superuser: {owner_email}')