oxutils 0.1.0__py3-none-any.whl → 0.1.1__py3-none-any.whl

oxutils/__init__.py

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

oxutils/audit/__init__.py

@@ -0,0 +1,20 @@
+"""
+Oxutils Audit Module
+
+Provides audit log export functionality with S3 storage.
+"""
+
+# Models are imported lazily to avoid AppRegistryNotReady errors
+# Use: from oxutils.audit.models import LogExportState, LogExportHistory
+
+__all__ = [
+    'LogExportState',
+    'LogExportHistory',
+]
+
+def __getattr__(name):
+    """Lazy import of models to avoid AppRegistryNotReady errors."""
+    if name in __all__:
+        from oxutils.audit.models import LogExportState, LogExportHistory
+        return locals()[name]
+    raise AttributeError(f"module {__name__!r} has no attribute {name!r}")

oxutils/audit/apps.py

@@ -3,10 +3,10 @@ from django.utils.translation import gettext_lazy as _
 
 
 
-class OxutilsConfig(AppConfig):
+class OxutilsAuditConfig(AppConfig):
     default_auto_field = 'django.db.models.BigAutoField'
-    name = 'oxutils_export'
-    verbose_name = _("Oxutils Export")
+    name = 'oxutils.audit'
+    verbose_name = _("Oxutils Audit")
 
     def ready(self):
         return super().ready()

oxutils/audit/migrations/0001_initial.py

@@ -0,0 +1,41 @@
+# Generated by Django 5.2.8 on 2025-12-03 21:53
+
+import django.db.models.deletion
+import oxutils.enums.audit
+import oxutils.s3.storages
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    initial = True
+
+    dependencies = [
+    ]
+
+    operations = [
+        migrations.CreateModel(
+            name='LogExportState',
+            fields=[
+                ('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
+                ('created_at', models.DateTimeField(auto_now_add=True, help_text='Date and time when this record was created')),
+                ('updated_at', models.DateTimeField(auto_now=True, help_text='Date and time when this record was last updated')),
+                ('last_export_date', models.DateTimeField(null=True)),
+                ('status', models.CharField(choices=[(oxutils.enums.audit.ExportStatus['FAILED'], 'Failed'), (oxutils.enums.audit.ExportStatus['PENDING'], 'Pending'), (oxutils.enums.audit.ExportStatus['SUCCESS'], 'Success')], default=oxutils.enums.audit.ExportStatus['PENDING'])),
+                ('data', models.FileField(storage=oxutils.s3.storages.LogStorage(), upload_to='')),
+                ('size', models.BigIntegerField()),
+            ],
+            options={
+                'abstract': False,
+            },
+        ),
+        migrations.CreateModel(
+            name='LogExportHistory',
+            fields=[
+                ('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
+                ('status', models.CharField(choices=[(oxutils.enums.audit.ExportStatus['FAILED'], 'Failed'), (oxutils.enums.audit.ExportStatus['PENDING'], 'Pending'), (oxutils.enums.audit.ExportStatus['SUCCESS'], 'Success')], default=oxutils.enums.audit.ExportStatus['PENDING'])),
+                ('created_at', models.DateTimeField(auto_now_add=True, help_text='Date and time when this record was created')),
+                ('state', models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, related_name='log_histories', to='audit.logexportstate')),
+            ],
+        ),
+    ]

oxutils/conf.py

@@ -3,6 +3,7 @@ UTILS_APPS = (
     'auditlog',
     'cid.apps.CidAppConfig',
     'django_celery_results',
+    'oxutils.audit',
 )
 
 AUDIT_MIDDLEWARE = (

{oxutils-0.1.0.dist-info → oxutils-0.1.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: oxutils
-Version: 0.1.0
+Version: 0.1.1
 Summary: Production-ready utilities for Django applications in the Oxiliere ecosystem
 Keywords: django,utilities,jwt,s3,audit,logging,celery,structlog
 Author: Edimedia Mutoke
@@ -153,6 +153,18 @@ uv sync
 uv run pytest  # 126 tests
 ```
 
+### Creating Migrations
+
+To generate Django migrations for the audit module:
+
+```bash
+make migrations
+# or
+uv run make_migrations.py
+```
+
+See [MIGRATIONS.md](MIGRATIONS.md) for detailed documentation.
+
 ## Advanced Examples
 
 ### JWT with Django Ninja
@@ -189,7 +201,7 @@ print(f"Exported to {export.data.url}")
 
 ## License
 
-MIT License - see [LICENSE](LICENSE)
+Apache 2.0 License - see [LICENSE](LICENSE)
 
 ## Support
 

{oxutils-0.1.0.dist-info → oxutils-0.1.1.dist-info}/RECORD

@@ -1,15 +1,17 @@
-oxutils/__init__.py,sha256=P25yalCx6B4hRjjbABZP9zpGc6WLaErSr62EtbkKXMw,536
+oxutils/__init__.py,sha256=3P1RgwJOYUc9uXjd_PhSprxHiOLf_qZrSxX2nuxBRWU,536
 oxutils/apps.py,sha256=8pO8eXUZeKYn8fPo0rkoytmHACwDNuTNhdRcpkPTxGM,347
-oxutils/audit/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-oxutils/audit/apps.py,sha256=oT6yoZiFsrg__xSTwr1YXPh0rBhgxcXkuWLIx_fv5rA,301
+oxutils/audit/__init__.py,sha256=uonc00G73Xm7RwRHVWD-wBn8lJYNCq3iBgnRGMWAEWs,583
+oxutils/audit/apps.py,sha256=xvnmB5Z6nLV7ejzhSeQbesTkwRoFygoPFob8H5QTHgU,304
 oxutils/audit/export.py,sha256=MVf2RhLzXatBaGK7bIEvSY1VTwEojrPEKwYMvH1stwE,7992
 oxutils/audit/masks.py,sha256=BRCz2m8dbaLgqn5umxpWCwn9mT6Z_ww_WIedl36AmPM,2345
+oxutils/audit/migrations/0001_initial.py,sha256=xDOxV6NqkU8yuEDPvqG2AKANKrOJsOIAEJn5IbuLLFU,2151
+oxutils/audit/migrations/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 oxutils/audit/models.py,sha256=NWzZjwgRGB212PeSb0E_aSxSComrTSR0knt2aBCiWhg,2100
 oxutils/audit/settings.py,sha256=E4AoTpbvL1svDogux-OTjAdccD5LzyJ1G-lBeCZTbDU,353
 oxutils/celery/__init__.py,sha256=29jo4DfdvOoThX-jfL0ZiDjsy3-Z_fNhwHVJaLO5rsk,29
 oxutils/celery/base.py,sha256=qLlBU2XvT2zj8qszy8togqH7hM_wUYyWWA3JAQPPJx0,3378
 oxutils/celery/settings.py,sha256=njhHBErpcFczV2e23NCPX_Jxs015jr4dIig4Is_wbgE,33
-oxutils/conf.py,sha256=Www0b7XdmsRK_wcKFmp9sHMLKApSA4JVgM-dVvdB0UM,275
+oxutils/conf.py,sha256=JT0Zj4Wmn9HCEDpk7eOIY47YLBGP793tstsm34cLb1A,296
 oxutils/enums/__init__.py,sha256=gFhZG8ER6ArGZO5agWhdfs7NiD2h9FzrzfQRHq18dD0,40
 oxutils/enums/audit.py,sha256=ju2Z9CrtdyPziRQ7oOe4Ygw85t9sW3jynO_1DkgZoAM,126
 oxutils/enums/invoices.py,sha256=E33QGQeutZUqvlovJY0VGDxWUb0i_kdfhEiir1ARKuQ,201
@@ -38,6 +40,6 @@ oxutils/s3/settings.py,sha256=NIlVhaOzWdsepOgCpxdTTJRHfM0tM5EcAoy4kaFC1R8,1190
 oxutils/s3/storages.py,sha256=vW8BlxLwkqMgVJPf9z2rkjmlrL_RArlN3YA6y4BJ7Zw,5414
 oxutils/settings.py,sha256=iOVRgkurkv6UtlEvY0dkO71oxxgPAIdyXgHhf3RJaTU,9673
 oxutils/types.py,sha256=DIz8YK8xMpLc7FYbf88yEElyLsYN_-rbvaZXvENQkOQ,234
-oxutils-0.1.0.dist-info/WHEEL,sha256=4n27za1eEkOnA7dNjN6C5-O2rUiw6iapszm14Uj-Qmk,79
-oxutils-0.1.0.dist-info/METADATA,sha256=q6Jww1jWZILdwarNnXtg0SkqKcvvuqYVCCyZaIs9CII,5725
-oxutils-0.1.0.dist-info/RECORD,,
+oxutils-0.1.1.dist-info/WHEEL,sha256=4n27za1eEkOnA7dNjN6C5-O2rUiw6iapszm14Uj-Qmk,79
+oxutils-0.1.1.dist-info/METADATA,sha256=H5gVh_JOIWKKesVrHu8o6orUe2stxJhmeDm31wRrUa0,5934
+oxutils-0.1.1.dist-info/RECORD,,