djresttoolkit 0.9.0__py3-none-any.whl → 0.10.0__py3-none-any.whl

README.md

@@ -30,7 +30,7 @@ djresttoolkit is a collection of utilities and helpers for Django and Django RES
 
 ## 📚 All API Reference
 
-### 1. DB Seed Utilities
+### 1. DB Seed Utilities — API Reference
 
 #### `Generator`
 
@@ -89,7 +89,7 @@ Here’s a **concise API reference** for your database flush management command
 
 ---
 
-### 2. DB Flush Command
+### 2. DB Flush Command — API Reference
 
 ```python
 from djresttoolkit.management.commands import flush
@@ -145,7 +145,7 @@ or
 Flushed 120 records from all models and reset IDs.
 ```
 
-### 3. EnvBaseSettings
+### 3. EnvBaseSettings — API Reference
 
 ```python
 from djresttoolkit.envconfig import EnvBaseSettings
@@ -200,7 +200,7 @@ Loads configuration from **YAML first**, then overrides with **environment varia
 ```python
 from djresttoolkit.envconfig import EnvBaseSettings
 
-class EnvSettings(EnvBaseSettings):
+class EnvSettings(EnvBaseSettings["EnvSettings"]):
     debug: bool = False
     database_url: str
 
@@ -217,7 +217,7 @@ print(settings.database_url)
 - Supports nested keys: `DATABASE__HOST` → `settings.database.host`.
 - Designed to be subclassed for project-specific settings.
 
-### 4. EmailSender
+### 4. EmailSender — API Reference
 
 ```python
 from djresttoolkit.mail import EmailSender, EmailContent, EmailTemplate
@@ -266,7 +266,7 @@ EmailSender(content).send(to=["user@example.com"])
 
 - `text`, `html` — template file paths
 
-### 5. Custom DRF Exception Handler
+### 5. Custom DRF Exception Handler — API Reference
 
 ```python
 from djresttoolkit.views import exception_handler
@@ -306,7 +306,7 @@ REST_FRAMEWORK = {
 - Tracks requests in cache and calculates `retry_after`.
 - Cleans expired timestamps automatically.
 
-### 6. Response Time Middleware
+### 6. Response Time Middleware — API Reference
 
 ```python
 from djresttoolkit.middlewares import ResponseTimeMiddleware
@@ -353,7 +353,7 @@ X-Response-Time: 0.01234 seconds
 INFO: Request processed in 0.01234 seconds
 ```
 
-### 7. Throttle Utilities
+### 7. Throttle Utilities — API Reference
 
 #### `ThrottleInfoJSONRenderer`
 
@@ -469,6 +469,84 @@ data = serializer.data
 - Relative file paths are automatically converted to absolute URLs.
 - Can manually specify fields via `file_fields` for non-model serializers.
 
+### 9. BulkCreateMixin — API Reference
+
+```python
+from djresttoolkit.serializers.mixins import BulkCreateMixin
+```
+
+#### `BulkCreateMixin`
+
+A **DRF serializer mixin** that adds support for:
+
+- **Single instance creation** with extra context fields
+- **Bulk creation** from a list of validated data dictionaries
+- **Updating serializer field error messages** with model-specific messages
+
+#### Bulk Create Mixin Notes
+
+- `bulk_create()` does **not trigger model signals** or call `.save()` on instances.
+- `Meta.model` **must** be defined in the serializer.
+
+#### Bulk Create Mixin Methods
+
+#### `create(self, validated_data: dict[str, Any] | list[dict[str, Any]]) -> Model | list[Model]`
+
+- Creates single or multiple model instances.
+- **Parameters:**
+  - `validated_data`: dict for single instance or list of dicts for bulk creation.
+  
+- **Returns:**
+  - Single model instance or list of instances.
+  
+- **Raises:**
+  - `AttributeError` if `Meta.model` is not defined.
+  - `NotImplementedError` if used with a serializer that does not implement `create()`.
+
+#### `get_fields(self) -> dict[str, SerializerField]`
+
+- Extends DRF serializer `get_fields()` to update **error messages** using model field definitions.
+- **Returns:**
+  - Dictionary of serializer fields.
+
+- **Warning:**
+  - Logs a warning if a serializer field is not present on the model.
+
+### Bulk Create Mixin Example
+
+```python
+from rest_framework import serializers
+from djresttoolkit.serializers.mixins import BulkCreateMixin
+from myapp.models import Product
+
+class ProductSerializer(BulkCreateMixin, serializers.ModelSerializer):
+    class Meta:
+        model = Product
+        fields = ["id", "name", "price"]
+
+# Single creation
+serializer = ProductSerializer(data={"name": "Item1", "price": 10})
+serializer.is_valid(raise_exception=True)
+product = serializer.save()
+
+# Bulk creation
+serializer = ProductSerializer(
+    data=[
+        {"name": "Item2", "price": 20},
+        {"name": "Item3", "price": 30},
+    ],
+    many=True
+)
+serializer.is_valid(raise_exception=True)
+products = serializer.save()
+```
+
+#### Bulk Create Mixin Features
+
+- Works seamlessly with DRF `ModelSerializer`.
+- Automatically updates field error messages based on Django model definitions.
+- Bulk creation is optimized using `model.objects.bulk_create()` for efficiency.
+
 ## 🛠️ Planned Features
 
 - Add more utils

{djresttoolkit-0.9.0.dist-info → djresttoolkit-0.10.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: djresttoolkit
-Version: 0.9.0
+Version: 0.10.0
 Summary: A collection of Django and DRF utilities to simplify API development.
 Project-URL: Homepage, https://github.com/shaileshpandit141/djresttoolkit
 Project-URL: Documentation, https://shaileshpandit141.github.io/djresttoolkit
@@ -88,7 +88,7 @@ djresttoolkit is a collection of utilities and helpers for Django and Django RES
 
 ## 📚 All API Reference
 
-### 1. DB Seed Utilities
+### 1. DB Seed Utilities — API Reference
 
 #### `Generator`
 
@@ -147,7 +147,7 @@ Here’s a **concise API reference** for your database flush management command
 
 ---
 
-### 2. DB Flush Command
+### 2. DB Flush Command — API Reference
 
 ```python
 from djresttoolkit.management.commands import flush
@@ -203,7 +203,7 @@ or
 Flushed 120 records from all models and reset IDs.
 ```
 
-### 3. EnvBaseSettings
+### 3. EnvBaseSettings — API Reference
 
 ```python
 from djresttoolkit.envconfig import EnvBaseSettings
@@ -258,7 +258,7 @@ Loads configuration from **YAML first**, then overrides with **environment varia
 ```python
 from djresttoolkit.envconfig import EnvBaseSettings
 
-class EnvSettings(EnvBaseSettings):
+class EnvSettings(EnvBaseSettings["EnvSettings"]):
     debug: bool = False
     database_url: str
 
@@ -275,7 +275,7 @@ print(settings.database_url)
 - Supports nested keys: `DATABASE__HOST` → `settings.database.host`.
 - Designed to be subclassed for project-specific settings.
 
-### 4. EmailSender
+### 4. EmailSender — API Reference
 
 ```python
 from djresttoolkit.mail import EmailSender, EmailContent, EmailTemplate
@@ -324,7 +324,7 @@ EmailSender(content).send(to=["user@example.com"])
 
 - `text`, `html` — template file paths
 
-### 5. Custom DRF Exception Handler
+### 5. Custom DRF Exception Handler — API Reference
 
 ```python
 from djresttoolkit.views import exception_handler
@@ -364,7 +364,7 @@ REST_FRAMEWORK = {
 - Tracks requests in cache and calculates `retry_after`.
 - Cleans expired timestamps automatically.
 
-### 6. Response Time Middleware
+### 6. Response Time Middleware — API Reference
 
 ```python
 from djresttoolkit.middlewares import ResponseTimeMiddleware
@@ -411,7 +411,7 @@ X-Response-Time: 0.01234 seconds
 INFO: Request processed in 0.01234 seconds
 ```
 
-### 7. Throttle Utilities
+### 7. Throttle Utilities — API Reference
 
 #### `ThrottleInfoJSONRenderer`
 
@@ -527,6 +527,84 @@ data = serializer.data
 - Relative file paths are automatically converted to absolute URLs.
 - Can manually specify fields via `file_fields` for non-model serializers.
 
+### 9. BulkCreateMixin — API Reference
+
+```python
+from djresttoolkit.serializers.mixins import BulkCreateMixin
+```
+
+#### `BulkCreateMixin`
+
+A **DRF serializer mixin** that adds support for:
+
+- **Single instance creation** with extra context fields
+- **Bulk creation** from a list of validated data dictionaries
+- **Updating serializer field error messages** with model-specific messages
+
+#### Bulk Create Mixin Notes
+
+- `bulk_create()` does **not trigger model signals** or call `.save()` on instances.
+- `Meta.model` **must** be defined in the serializer.
+
+#### Bulk Create Mixin Methods
+
+#### `create(self, validated_data: dict[str, Any] | list[dict[str, Any]]) -> Model | list[Model]`
+
+- Creates single or multiple model instances.
+- **Parameters:**
+  - `validated_data`: dict for single instance or list of dicts for bulk creation.
+  
+- **Returns:**
+  - Single model instance or list of instances.
+  
+- **Raises:**
+  - `AttributeError` if `Meta.model` is not defined.
+  - `NotImplementedError` if used with a serializer that does not implement `create()`.
+
+#### `get_fields(self) -> dict[str, SerializerField]`
+
+- Extends DRF serializer `get_fields()` to update **error messages** using model field definitions.
+- **Returns:**
+  - Dictionary of serializer fields.
+
+- **Warning:**
+  - Logs a warning if a serializer field is not present on the model.
+
+### Bulk Create Mixin Example
+
+```python
+from rest_framework import serializers
+from djresttoolkit.serializers.mixins import BulkCreateMixin
+from myapp.models import Product
+
+class ProductSerializer(BulkCreateMixin, serializers.ModelSerializer):
+    class Meta:
+        model = Product
+        fields = ["id", "name", "price"]
+
+# Single creation
+serializer = ProductSerializer(data={"name": "Item1", "price": 10})
+serializer.is_valid(raise_exception=True)
+product = serializer.save()
+
+# Bulk creation
+serializer = ProductSerializer(
+    data=[
+        {"name": "Item2", "price": 20},
+        {"name": "Item3", "price": 30},
+    ],
+    many=True
+)
+serializer.is_valid(raise_exception=True)
+products = serializer.save()
+```
+
+#### Bulk Create Mixin Features
+
+- Works seamlessly with DRF `ModelSerializer`.
+- Automatically updates field error messages based on Django model definitions.
+- Bulk creation is optimized using `model.objects.bulk_create()` for efficiency.
+
 ## 🛠️ Planned Features
 
 - Add more utils

{djresttoolkit-0.9.0.dist-info → djresttoolkit-0.10.0.dist-info}/RECORD

@@ -1,5 +1,5 @@
 LICENSE,sha256=8-oZM3yuuTRjySMbVKX9YXYA7Y4M_KhQNBYXPFjeWUo,1074
-README.md,sha256=OoZENrGn6D6SPnRlXO1CI_rdRaqZfSJunHlE9QOm-zI,12188
+README.md,sha256=OzvflId2K79hvwsZr4VIf393Fvm1PhTExUHAAnBvpzo,14651
 demo/staticfiles/admin/img/LICENSE,sha256=0RT6_zSIwWwxmzI13EH5AjnT1j2YU3MwM9j3U19cAAQ,1081
 src/djresttoolkit/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 src/djresttoolkit/admin.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -27,16 +27,16 @@ src/djresttoolkit/models/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZ
 src/djresttoolkit/renderers/__init__.py,sha256=kmFMPRiMfD8CuJTN1_-6Z_Hqil3x8GBM0IN1roZESm0,107
 src/djresttoolkit/renderers/_throttle_info_json_renderer.py,sha256=aP2cN4cB_Imcpy732zsPBQrMQqcKEs5R3dld5Y_4AMU,1089
 src/djresttoolkit/serializers/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-src/djresttoolkit/serializers/_serializer_create_mixin.py,sha256=KprWF_aeEgRygcWG--xtVfnWsOowKqjmdF0aHmrNlzE,3253
-src/djresttoolkit/serializers/mixins/__init__.py,sha256=fCDNLYLx7Y_19mp8Ya_0akCAViSU3a3LhqgS_sFDMsA,154
+src/djresttoolkit/serializers/mixins/__init__.py,sha256=dRT0kXDckOkZo1RQHrT1gXbGFMIv5M8TBHGF2uF-81Q,225
 src/djresttoolkit/serializers/mixins/_absolute_url_file_mixin.py,sha256=5ewael0_RsJZ9b36IfXacxjb-Vx1eQ9Dk6dWuj5D_dc,3261
+src/djresttoolkit/serializers/mixins/_bulk_create_mixin.py,sha256=9ZWm2MNaZOhmhKlWOu6VECtlDbUtaPeceGHmivDYwYQ,3248
 src/djresttoolkit/throttling/__init__.py,sha256=01sjMymjx8XjqnAw3bEBLc-JtfhCDrp5dGxSNXMvPpU,84
 src/djresttoolkit/throttling/_throttle_inspector.py,sha256=Kss6ZxKy-EXq9UGaGprGDhpSuJ5992bmEYZSWmUVBHo,6480
 src/djresttoolkit/views/__init__.py,sha256=XrxBrs6sH4HmUzp41omcmy_y94pSaXAVn01ttQ022-4,76
 src/djresttoolkit/views/_exceptions/__init__.py,sha256=DrCUxuPNyBR4WhzNutn5HDxLa--q51ykIxSG7_bFsOI,83
 src/djresttoolkit/views/_exceptions/_exception_handler.py,sha256=_o7If47bzWLl57LeSXSWsIDsJGo2RIpwYAwNQ-hsHVY,2839
-djresttoolkit-0.9.0.dist-info/METADATA,sha256=8Kb2jWYW9ZTev9M6ciwtPk5A0z0lFJVrDhXVZkoIis8,15197
-djresttoolkit-0.9.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-djresttoolkit-0.9.0.dist-info/entry_points.txt,sha256=YMhfTF-7mYppO8QqqWnvR_hyMWvoYxD6XI94_ViFu3k,60
-djresttoolkit-0.9.0.dist-info/licenses/LICENSE,sha256=8-oZM3yuuTRjySMbVKX9YXYA7Y4M_KhQNBYXPFjeWUo,1074
-djresttoolkit-0.9.0.dist-info/RECORD,,
+djresttoolkit-0.10.0.dist-info/METADATA,sha256=A91Vw-rZ7cni31PQzgw568wk5tGRLROJkBe9mLXYa14,17661
+djresttoolkit-0.10.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+djresttoolkit-0.10.0.dist-info/entry_points.txt,sha256=YMhfTF-7mYppO8QqqWnvR_hyMWvoYxD6XI94_ViFu3k,60
+djresttoolkit-0.10.0.dist-info/licenses/LICENSE,sha256=8-oZM3yuuTRjySMbVKX9YXYA7Y4M_KhQNBYXPFjeWUo,1074
+djresttoolkit-0.10.0.dist-info/RECORD,,

src/djresttoolkit/serializers/mixins/__init__.py

@@ -1,6 +1,8 @@
 from ._absolute_url_file_mixin import AbsoluteUrlFileMixin, MissingRequestContext
+from ._bulk_create_mixin import BulkCreateMixin
 
 __all__ = [
     "AbsoluteUrlFileMixin",
     "MissingRequestContext",
+    "BulkCreateMixin",
 ]

src/djresttoolkit/serializers/{_serializer_create_mixin.py → mixins/_bulk_create_mixin.py}

@@ -10,7 +10,7 @@ from django.db.models import Field as ModelField
 logger = logging.getLogger(__name__)
 
 
-class RecordsCreationMixin:
+class BulkCreateMixin:
     """
     A mixin for DRF serializers that supports:
       - Single instance creation with extra context fields