oxutils 0.1.0__py3-none-any.whl

oxutils/locale/fr/LC_MESSAGES/django.po

@@ -0,0 +1,368 @@
+# Oxiliere Utils.
+# Copyright (C) Oxiliere
+# This file is distributed under the same license as the PACKAGE package.
+# Edimedia Mutoke <eddycondor07@gmail.com>, 2025.
+#
+msgid ""
+msgstr ""
+"Project-Id-Version: Oxutils 1.0\n"
+"Report-Msgid-Bugs-To: \n"
+"POT-Creation-Date: 2025-12-02 12:14+0200\n"
+"PO-Revision-Date: 2025-12-02 12:15+0200\n"
+"Last-Translator: Oxiliere Team\n"
+"Language-Team: French\n"
+"Language: fr\n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+"Plural-Forms: nplurals=2; plural=(n > 1);\n"
+
+msgid "Oxiliere Utilities"
+msgstr "Utilitaires Oxiliere"
+
+msgid "Oxutils Export"
+msgstr "Export Oxutils"
+
+msgid "Failed"
+msgstr "Échoué"
+
+msgid "Pending"
+msgstr "En attente"
+
+msgid "Success"
+msgstr "Succès"
+
+msgid "We encountered an error, please try again later."
+msgstr "Nous avons rencontré une erreur, veuillez réessayer plus tard."
+
+msgid "The requested resource does not exist"
+msgstr "La ressource demandée n'existe pas"
+
+msgid "Validation error"
+msgstr "Erreur de validation"
+
+msgid "The operation conflicts with existing data"
+msgstr "L'opération est en conflit avec les données existantes"
+
+msgid "A resource with these details already exists"
+msgstr "Une ressource avec ces détails existe déjà"
+
+msgid "You do not have permission to perform this action"
+msgstr "Vous n'avez pas la permission d'effectuer cette action"
+
+msgid "Authentication is required"
+msgstr "L'authentification est requise"
+
+msgid "Invalid parameter provided"
+msgstr "Paramètre invalide fourni"
+
+msgid "Required parameter is missing"
+msgstr "Paramètre requis manquant"
+
+msgid "An unexpected error occurred while processing your request"
+msgstr "Une erreur inattendue s'est produite lors du traitement de votre demande"
+
+msgid "One or more referenced resources do not exist"
+msgstr "Une ou plusieurs ressources référencées n'existent pas"
+
+#, python-brace-format
+msgid "Required parameter {exc} is missing"
+msgstr "Le paramètre requis {exc} est manquant"
+
+msgid ""
+"An unexpected error occurred. Please try again later or contact support."
+msgstr "Une erreur inattendue s'est produite. Veuillez réessayer plus tard ou contacter le support."
+
+msgid "Credit card"
+msgstr "Carte bancaire"
+
+msgid "PayPal"
+msgstr "PayPal"
+
+msgid "Bank transfer"
+msgstr "Virement bancaire"
+
+msgid "Stripe"
+msgstr "Stripe"
+
+msgid "US Dollar"
+msgstr "Dollar américain"
+
+msgid "Congolese Franc"
+msgstr "Franc congolais"
+
+msgid "billing name"
+msgstr "Nom de facturation"
+
+msgid "Full name for billing"
+msgstr "Nom complet pour la facturation"
+
+msgid "billing email"
+msgstr "email de facturation"
+
+msgid "Email to receive invoices"
+msgstr "Email pour recevoir les factures"
+
+msgid "company name"
+msgstr "Nom de l'entreprise"
+
+msgid "Company name (optional)"
+msgstr "Nom de l'entreprise (optionnel)"
+
+msgid "VAT number"
+msgstr "Numéro de TVA"
+
+msgid "VAT or tax identification number"
+msgstr "Numéro de TVA ou d'identification fiscale"
+
+msgid "address"
+msgstr "Adresse"
+
+msgid "city"
+msgstr "Ville"
+
+msgid "postal code"
+msgstr "Code postal"
+
+msgid "country"
+msgstr "Pays"
+
+msgid "ISO 3166-1 alpha-2 country code"
+msgstr "Code pays ISO 3166-1 alpha-2"
+
+msgid "preferred currency"
+msgstr "Devise préférée"
+
+msgid "preferred payment method"
+msgstr "Méthode de paiement préférée"
+
+msgid "Stripe customer ID"
+msgstr "ID client Stripe"
+
+msgid "Stripe customer identifier"
+msgstr "Identifiant client Stripe"
+
+msgid "automatic payment"
+msgstr "Paiement automatique"
+
+msgid "Enable automatic invoice payment"
+msgstr "Activer le paiement automatique des factures"
+
+msgid "billing notes"
+msgstr "Notes de facturation"
+
+msgid "Custom notes to include on invoices"
+msgstr "Notes personnalisées à inclure sur les factures"
+
+msgid "Billing information"
+msgstr "Informations de facturation"
+
+msgid "invoice number"
+msgstr "Numéro de facture"
+
+msgid "Unique invoice number"
+msgstr "Numéro unique de la facture"
+
+msgid "status"
+msgstr "Statut"
+
+msgid "Invoice status"
+msgstr "Statut de la facture"
+
+msgid "subtotal"
+msgstr "Sous-total"
+
+msgid "Amount excluding taxes"
+msgstr "Montant hors taxes"
+
+msgid "tax rate"
+msgstr "Taux de taxe"
+
+msgid "Tax rate as percentage"
+msgstr "Taux de taxe en pourcentage"
+
+msgid "tax amount"
+msgstr "Montant de la taxe"
+
+msgid "Tax amount"
+msgstr "Montant de la taxe"
+
+msgid "total"
+msgstr "Total"
+
+msgid "Total amount including tax"
+msgstr "Montant total TTC"
+
+msgid "currency"
+msgstr "Devise"
+
+msgid "ISO currency code (CDF, USD, etc.)"
+msgstr "Code devise ISO (CDF, USD, etc.)"
+
+msgid "issue date"
+msgstr "Date d'émission"
+
+msgid "Invoice issue date"
+msgstr "Date d'émission de la facture"
+
+msgid "due date"
+msgstr "Date d'échéance"
+
+msgid "Payment due date"
+msgstr "Date limite de paiement"
+
+msgid "payment date"
+msgstr "Date de paiement"
+
+msgid "Payment date and time"
+msgstr "Date et heure du paiement"
+
+msgid "period start"
+msgstr "Début de période"
+
+msgid "Billing period start date"
+msgstr "Date de début de la période facturée"
+
+msgid "period end"
+msgstr "Fin de période"
+
+msgid "Billing period end date"
+msgstr "Date de fin de la période facturée"
+
+msgid "description"
+msgstr "Description"
+
+msgid "Detailed invoice description"
+msgstr "Description détaillée de la facture"
+
+msgid "notes"
+msgstr "Notes"
+
+msgid "Internal notes about the invoice"
+msgstr "Notes internes sur la facture"
+
+msgid "payment reference"
+msgstr "Référence de paiement"
+
+msgid "External payment system reference (Stripe, etc.)"
+msgstr "Référence du système de paiement externe (Stripe, etc.)"
+
+msgid "Invoice"
+msgstr "Facture"
+
+msgid "Invoices"
+msgstr "Factures"
+
+msgid "service name"
+msgstr "Nom du service"
+
+msgid "Name of the billed service or product"
+msgstr "Nom du service ou produit facturé"
+
+msgid "Detailed service description"
+msgstr "Description détaillée du service"
+
+msgid "quantity"
+msgstr "Quantité"
+
+msgid "Service quantity (hours, units, etc.)"
+msgstr "Quantité du service (heures, unités, etc.)"
+
+msgid "unit price"
+msgstr "Prix unitaire"
+
+msgid "Unit price excluding taxes"
+msgstr "Prix unitaire hors taxes"
+
+msgid "total price"
+msgstr "Prix total"
+
+msgid "Total price for this item (quantity × unit price)"
+msgstr "Prix total pour cet élément (quantité × prix unitaire)"
+
+msgid "metadata"
+msgstr "Métadonnées"
+
+msgid "Additional data in JSON format"
+msgstr "Données supplémentaires en format JSON"
+
+msgid "Invoice item"
+msgstr "Élément de facture"
+
+msgid "Invoice items"
+msgstr "Éléments de facture"
+
+msgid "Approved"
+msgstr "Approuvé"
+
+msgid "Rejected"
+msgstr "Rejeté"
+
+msgid "Processed"
+msgstr "Traité"
+
+msgid "Cancelled"
+msgstr "Annulé"
+
+msgid "Duplicate payment"
+msgstr "Paiement en double"
+
+msgid "Service not received"
+msgstr "Service non reçu"
+
+msgid "Billing error"
+msgstr "Erreur de facturation"
+
+msgid "Cancellation"
+msgstr "Annulation"
+
+msgid "Technical issue"
+msgstr "Problème technique"
+
+msgid "Other"
+msgstr "Autre"
+
+msgid "Refund request status"
+msgstr "Statut de la demande de remboursement"
+
+msgid "reason"
+msgstr "raison"
+
+msgid "Reason for refund request"
+msgstr "Raison de la demande de remboursement"
+
+msgid "Detailed description of the refund request"
+msgstr "Description détaillée de la demande de remboursement"
+
+msgid "requested amount"
+msgstr "Montant demandé"
+
+msgid "Requested refund amount"
+msgstr "Montant du remboursement demandé"
+
+msgid "approved amount"
+msgstr "Montant approuvé"
+
+msgid "Approved refund amount"
+msgstr "Montant du remboursement approuvé"
+
+msgid "processing date"
+msgstr "date de traitement"
+
+msgid "Refund processing date and time"
+msgstr "Date et heure du traitement du remboursement"
+
+msgid "admin notes"
+msgstr "Notes administratives"
+
+msgid "Internal administrator notes"
+msgstr "Notes internes de l'administrateur"
+
+msgid "refund reference"
+msgstr "référence de remboursement"
+
+msgid "Refund request"
+msgstr "Demande de remboursement"
+
+msgid "Refund requests"
+msgstr "Demandes de remboursement"

oxutils/logger/receivers.py

@@ -0,0 +1,18 @@
+from django.contrib.sites.shortcuts import RequestSite
+from django.dispatch import receiver
+import structlog
+from django_structlog import signals
+from cid.locals import get_cid
+from oxutils.settings import oxi_settings
+
+
+
+@receiver(signals.bind_extra_request_metadata)
+def bind_domain(request, logger, **kwargs):
+    current_site = RequestSite(request)
+    structlog.contextvars.bind_contextvars(
+        domain=current_site.domain,
+        cid=get_cid(),
+        user_id=str(request.user.pk),
+        service=oxi_settings.service_name
+    )

oxutils/logger/settings.py

@@ -0,0 +1,63 @@
+import structlog
+
+
+
+
+DJANGO_STRUCTLOG_CELERY_ENABLED = True
+DJANGO_STRUCTLOG_IP_LOGGING_ENABLED = True
+DJANGO_STRUCTLOG_USER_ID_FIELD = 'pk'
+DJANGO_STRUCTLOG_COMMAND_LOGGING_ENABLED = True
+
+
+LOGGING = {
+    "version": 1,
+    "disable_existing_loggers": False,
+    "formatters": {
+        "json_formatter": {
+            "()": structlog.stdlib.ProcessorFormatter,
+            "processor": structlog.processors.JSONRenderer(),
+        },
+        "plain_console": {
+            "()": structlog.stdlib.ProcessorFormatter,
+            "processor": structlog.dev.ConsoleRenderer(),
+        },
+    },
+    "handlers": {
+        "console": {
+            "class": "logging.StreamHandler",
+            "formatter": "plain_console",
+        },
+        "json_file": {
+            "class": "logging.handlers.WatchedFileHandler",
+            "filename": "logs/json.log",
+            "formatter": "json_formatter",
+        },
+    },
+    "loggers": {
+        "django_structlog": {
+            "handlers": ["console", "json_file"],
+            "level": "INFO",
+        },
+        "oxiliere_log": {
+            "handlers": ["console", "json_file"],
+            "level": "INFO",
+        },
+    }
+}
+
+structlog.configure(
+    processors=[
+        structlog.contextvars.merge_contextvars,
+        structlog.stdlib.filter_by_level,
+        structlog.processors.TimeStamper(fmt="iso"),
+        structlog.stdlib.add_logger_name,
+        structlog.stdlib.add_log_level,
+        structlog.stdlib.PositionalArgumentsFormatter(),
+        structlog.processors.StackInfoRenderer(),
+        structlog.processors.format_exc_info,
+        structlog.processors.UnicodeDecoder(),
+        structlog.stdlib.ProcessorFormatter.wrap_for_formatter,
+    ],
+    logger_factory=structlog.stdlib.LoggerFactory(),
+    cache_logger_on_first_use=True,
+)

oxutils/mixins/base.py

@@ -0,0 +1,21 @@
+
+class DetailDictMixin:
+    default_detail: str
+    default_code: str
+
+    def __init__(self, detail=None, code=None) -> None:
+        """
+        Builds a detail dictionary for the error to give more information to API
+        users.
+        """
+        detail_dict = {"detail": self.default_detail, "code": self.default_code}
+
+        if isinstance(detail, dict):
+            detail_dict.update(detail)
+        elif detail is not None:
+            detail_dict["detail"] = detail
+
+        if code is not None:
+            detail_dict["code"] = code
+
+        super().__init__(detail_dict)

oxutils/mixins/schemas.py

@@ -0,0 +1,13 @@
+from typing import Optional, Dict, Any
+from ninja import Schema
+
+
+
+class ResponseSchema(Schema):
+    """
+    Standardized error response schema matching APIException format.
+    Use this for documenting error responses in API endpoints.
+    """
+    detail: str
+    code: str
+    errors: Optional[Dict[str, Any]] = None

oxutils/mixins/services.py

@@ -0,0 +1,146 @@
+from logging import Logger
+from django.utils.translation import gettext_lazy as _
+from auditlog.signals import accessed
+from oxutils.settings import oxi_settings
+
+
+
+
+
+class BaseService:
+    """
+    Base service class with exception handling
+    
+    Services should inherit from this class and override inner_exception_handler
+    to handle service-specific exceptions.
+    """
+
+    logger: Logger | None = None
+
+
+    def object_accessed(self, instance_class, instance):
+        if oxi_settings.log_access:
+            accessed(instance_class, instance)
+
+    def inner_exception_handler(self, exc: Exception, logger: Logger):
+        """
+        Handle service-specific exceptions
+        
+        Override this method in child classes to handle custom exceptions.
+        Should raise an APIException subclass if the exception is handled,
+        or re-raise the original exception if not handled.
+        
+        Args:
+            exc: The exception to handle
+            logger: Logger instance for logging
+            
+        Raises:
+            APIException: If the exception is handled
+            Exception: Re-raises the original exception if not handled
+        """
+        # Default implementation does nothing, child classes should override
+        raise exc
+
+    def exception_handler(self, exc: Exception, logger: Logger | None = None):
+        """
+        Handle all exceptions with a standardized approach
+        
+        This method first calls inner_exception_handler for service-specific exceptions,
+        then handles common Django and Python exceptions.
+        
+        Args:
+            exc: The exception to handle
+            logger: Optional logger instance
+            
+        Raises:
+            APIException: Always raises an appropriate APIException subclass
+        """
+        from oxutils.exceptions import (
+            NotFoundException,
+            ValidationException,
+            ConflictException,
+            DuplicateEntryException,
+            PermissionDeniedException,
+            InvalidParameterException,
+            MissingParameterException,
+            InternalErrorException,
+        )
+        from django.core.exceptions import ValidationError, ObjectDoesNotExist
+        from django.db import IntegrityError
+        import logging
+
+        if self.logger:
+            logger = self.logger
+
+        if logger is None:
+            logger = logging.getLogger(__name__)
+        
+        # Log the exception
+        logger.error(f"Service exception: {type(exc).__name__} - {str(exc)}")
+        
+        try:
+            # First, try to handle service-specific exceptions
+            self.inner_exception_handler(exc, logger)
+        except Exception as inner_exc:
+            # If inner_exception_handler raised an APIException, re-raise it
+            from oxutils.exceptions import APIException
+            if isinstance(inner_exc, APIException):
+                raise inner_exc
+            
+            # Otherwise, continue with standard exception handling
+            exc = inner_exc
+        
+        # Handle Django validation errors
+        if isinstance(exc, ValidationError):
+            detail = str(exc)
+            if hasattr(exc, 'message_dict'):
+                detail = {'detail': str(exc), 'errors': exc.message_dict}
+            raise ValidationException(detail=detail) from exc
+        
+        # Handle object not found errors
+        if isinstance(exc, ObjectDoesNotExist):
+            raise NotFoundException(detail=str(exc) or None) from exc
+        
+        # Handle integrity errors (duplicate entries, foreign key violations)
+        if isinstance(exc, IntegrityError):
+            error_message = str(exc).lower()
+            
+            if 'unique' in error_message or 'duplicate' in error_message:
+                raise DuplicateEntryException() from exc
+            
+            if 'foreign key' in error_message:
+                raise InvalidParameterException(
+                    detail=_('One or more referenced resources do not exist')
+                ) from exc
+            
+            raise ConflictException() from exc
+        
+        # Handle value errors (invalid parameters)
+        if isinstance(exc, ValueError):
+            raise InvalidParameterException(detail=str(exc)) from exc
+        
+        # Handle permission errors
+        if isinstance(exc, PermissionError):
+            raise PermissionDeniedException(detail=str(exc) or None) from exc
+        
+        # Handle type errors (usually programming errors)
+        if isinstance(exc, TypeError):
+            logger.exception("Type error in service")
+            raise InternalErrorException() from exc
+        
+        # Handle key errors (missing required data)
+        if isinstance(exc, KeyError):
+            raise MissingParameterException(
+                detail=_('Required parameter {exc} is missing').format(exc=exc)
+            ) from exc
+        
+        # Handle attribute errors
+        if isinstance(exc, AttributeError):
+            logger.exception("Attribute error in service")
+            raise InternalErrorException() from exc
+        
+        # Default handler for unknown exceptions
+        logger.exception(f"Unhandled exception in service: {type(exc).__name__}")
+        raise InternalErrorException(
+            detail=_('An unexpected error occurred. Please try again later or contact support.')
+        ) from exc

oxutils/models/__init__.py

@@ -0,0 +1,3 @@
+from .base import *
+from .invoice import *
+from .billing import BillingMixin