djresttoolkit 0.11.0__tar.gz → 0.12.0__tar.gz

{djresttoolkit-0.11.0 → djresttoolkit-0.12.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: djresttoolkit
-Version: 0.11.0
+Version: 0.12.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
@@ -622,7 +622,7 @@ A **Django model mixin** to retrieve **choice fields** from a model, designed to
 
 #### Model Choice Field Mixin Methods
 
-`get_choices() -> dict[str, dict[str, str]]`
+- `get_choices() -> dict[str, dict[str, str]]`
 
 Retrieve the choice fields from the model as a dictionary.
 
@@ -681,6 +681,78 @@ print(choices)
 - Returns a ready-to-use dictionary mapping values to labels.
 - Ideal for DRF serializers, forms, and admin customization.
 
+Here’s a concise **docs entry** for your `ChoiceFieldsAPIView` suitable for `djresttoolkit` documentation:
+
+---
+
+### 11. ChoiceFieldsAPIView — API Reference
+
+```python
+from djresttoolkit.views import ChoiceFieldsAPIView
+```
+
+#### `ChoiceFieldsAPIView`
+
+A **generic DRF API view** to return all choices for specified model fields.
+
+#### Class Attributes of Choice Fields APIView
+
+- `model_class: type[Model] | None` — The Django model to inspect. **Must be set.**
+- `choice_fields: list[str] | None` — List of fields on the model with choices. **Must be set.**
+
+---
+
+#### Choice Fields APIView Methods
+
+- `get(request: Request) -> Response`
+
+Fetches the choices for the configured model fields.
+
+- **Returns:**
+  - `200 OK` — JSON object containing all choices:
+
+    ```json
+    {
+        "choices": {
+            "status": {"draft": "Draft", "published": "Published"},
+            "category": {"a": "Category A", "b": "Category B"}
+        }
+    }
+    ```
+
+  - `400 Bad Request` — If any error occurs while retrieving choices.
+
+- **Raises:**
+  - `AttributeDoesNotExist` — If `model_class` or `choice_fields` is not set.
+
+---
+
+### Example of Choice Fields APIView
+
+```python
+from django.urls import path
+from djresttoolkit.views import ChoiceFieldsAPIView
+from myapp.models import Product
+
+class ProductChoiceAPI(ChoiceFieldsAPIView):
+    model_class = Product
+    choice_fields = ["status", "category"]
+
+urlpatterns = [
+    path(
+      "api/v1/product-choices/",
+      ProductChoiceAPI.as_view(),
+      name="product-choices"
+    ),
+]
+```
+
+#### Choice Fields APIView Features
+
+- Dynamically returns all choices for selected fields in a model.
+- Useful for frontend forms or API consumers that need selectable options.
+- Integrates seamlessly with `ModelChoiceFieldMixin` from `djresttoolkit`.
+
 ## 🛠️ Planned Features
 
 - Add more utils

{djresttoolkit-0.11.0 → djresttoolkit-0.12.0}/README.md

@@ -564,7 +564,7 @@ A **Django model mixin** to retrieve **choice fields** from a model, designed to
 
 #### Model Choice Field Mixin Methods
 
-`get_choices() -> dict[str, dict[str, str]]`
+- `get_choices() -> dict[str, dict[str, str]]`
 
 Retrieve the choice fields from the model as a dictionary.
 
@@ -623,6 +623,78 @@ print(choices)
 - Returns a ready-to-use dictionary mapping values to labels.
 - Ideal for DRF serializers, forms, and admin customization.
 
+Here’s a concise **docs entry** for your `ChoiceFieldsAPIView` suitable for `djresttoolkit` documentation:
+
+---
+
+### 11. ChoiceFieldsAPIView — API Reference
+
+```python
+from djresttoolkit.views import ChoiceFieldsAPIView
+```
+
+#### `ChoiceFieldsAPIView`
+
+A **generic DRF API view** to return all choices for specified model fields.
+
+#### Class Attributes of Choice Fields APIView
+
+- `model_class: type[Model] | None` — The Django model to inspect. **Must be set.**
+- `choice_fields: list[str] | None` — List of fields on the model with choices. **Must be set.**
+
+---
+
+#### Choice Fields APIView Methods
+
+- `get(request: Request) -> Response`
+
+Fetches the choices for the configured model fields.
+
+- **Returns:**
+  - `200 OK` — JSON object containing all choices:
+
+    ```json
+    {
+        "choices": {
+            "status": {"draft": "Draft", "published": "Published"},
+            "category": {"a": "Category A", "b": "Category B"}
+        }
+    }
+    ```
+
+  - `400 Bad Request` — If any error occurs while retrieving choices.
+
+- **Raises:**
+  - `AttributeDoesNotExist` — If `model_class` or `choice_fields` is not set.
+
+---
+
+### Example of Choice Fields APIView
+
+```python
+from django.urls import path
+from djresttoolkit.views import ChoiceFieldsAPIView
+from myapp.models import Product
+
+class ProductChoiceAPI(ChoiceFieldsAPIView):
+    model_class = Product
+    choice_fields = ["status", "category"]
+
+urlpatterns = [
+    path(
+      "api/v1/product-choices/",
+      ProductChoiceAPI.as_view(),
+      name="product-choices"
+    ),
+]
+```
+
+#### Choice Fields APIView Features
+
+- Dynamically returns all choices for selected fields in a model.
+- Useful for frontend forms or API consumers that need selectable options.
+- Integrates seamlessly with `ModelChoiceFieldMixin` from `djresttoolkit`.
+
 ## 🛠️ Planned Features
 
 - Add more utils

{djresttoolkit-0.11.0 → djresttoolkit-0.12.0}/pyproject.toml

@@ -4,7 +4,7 @@
 
 [project]
 name = "djresttoolkit"
-version = "0.11.0"
+version = "0.12.0"
 description = "A collection of Django and DRF utilities to simplify API development."
 readme = { file = "README.md", content-type = "text/markdown" }
 license = { file = "LICENSE" }

djresttoolkit-0.12.0/src/djresttoolkit/views/__init__.py

@@ -0,0 +1,7 @@
+from ._exceptions import exception_handler
+from ._api_views._choice_fields_apiview import ChoiceFieldsAPIView
+
+__all__ = [
+    "exception_handler",
+    "ChoiceFieldsAPIView",
+]

djresttoolkit-0.12.0/src/djresttoolkit/views/_api_views/_choice_fields_apiview.py

@@ -0,0 +1,42 @@
+# views.py
+from rest_framework.views import APIView
+from rest_framework.response import Response
+from rest_framework.request import Request
+from rest_framework import status
+from djresttoolkit.models.mixins import ModelChoiceFieldMixin, AttributeDoesNotExist
+from django.db.models import Model
+
+
+class ChoiceFieldsAPIView(APIView):
+    """
+    Generic API view to return choice fields from a model.
+    """
+
+    model_class: type[Model] | None = None
+    choice_fields: list[str] | None = None
+
+    def get(self, request: Request) -> Response:
+        """
+        Return a JSON response with all choices for the specified fields.
+        """
+        if not self.model_class or not self.choice_fields:
+            raise AttributeDoesNotExist(
+                "model_class and choice_fields must be set.",
+            )
+
+        # Dynamically create a mixin instance
+        class DynamicChoiceMixin(ModelChoiceFieldMixin):
+            model = self.model_class
+            choice_fields = self.choice_fields
+
+        try:
+            choices = DynamicChoiceMixin.get_choices()
+            return Response(
+                {"choices": choices},
+                status=status.HTTP_200_OK,
+            )
+        except Exception:
+            return Response(
+                {"detail": "An error occurred while retrieving choices."},
+                status=status.HTTP_400_BAD_REQUEST,
+            )

djresttoolkit-0.11.0/src/djresttoolkit/views/__init__.py

@@ -1,3 +0,0 @@
-from ._exceptions import exception_handler
-
-__all__ = ["exception_handler"]