Metadata-Version: 2.1
Name: django-success-response
Version: 1.1.2
Summary: Django app for customizing response
Home-page: https://github.com/QuvonchbekBobojonov/django-success-response
Author: Quvonchbek Bobojonov
Author-email: hi@moorfo.uz
License: MIT
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Framework :: Django
Requires-Python: >=3.6
Description-Content-Type: text/markdown
License-File: LICENSE

# Django Success Response

`django-success-response` is a Django REST Framework extension that standardizes success and error response formats in API views. It simplifies response handling by providing a consistent structure and offers easy customization for data formats.

Official Docs: [django-success-response.moorfo.uz](http://django-success-response.moorfo.uz/)

## Installation

Install the package via pip:

```bash
pip install django-success-response
```

## Usage

### Standard Success Response

To return a standard success response, use `SuccessResponse` in your Django views.

#### Example:

```python
from success_response.response import SuccessResponse
from rest_framework.views import APIView

class MyView(APIView):
    @staticmethod
    def get(request):
        data = {'key': 'value'}
        return SuccessResponse(data)
```

#### Response:

```json
{
    "success": true,
    "result": {
        "key": "value"
    }
}
```

### Error Response

For error responses, set `success=False` and provide an error message.

#### Example:

```python
from success_response.response import SuccessResponse
from rest_framework.views import APIView

class MyView(APIView):
    @staticmethod
    def get(request):
        data = {'message': 'error'}
        return SuccessResponse(data, success=False)
```

#### Response:

```json
{
    "success": false,
    "error": {
        "message": "error"
    }
}
```

## Error Handling

To format all error responses using the `SuccessResponse` structure, configure the `EXCEPTION_HANDLER` in your `settings.py`:

```python
REST_FRAMEWORK = {
    'EXCEPTION_HANDLER': 'success_response.views.success_exception_handler'
}
```

## Generic Views and ViewSets

`django-success-response` provides customized DRF generic views and viewsets that automatically return responses in the `SuccessResponse` format.

### Available Views and ViewSets:

| Standard View                  | Success Equivalent                     |
|---------------------------------|----------------------------------------|
| `CreateAPIView`                 | `SuccessCreateAPIView`                 |
| `RetrieveAPIView`               | `SuccessRetrieveAPIView`               |
| `UpdateAPIView`                 | `SuccessUpdateAPIView`                 |
| `DestroyAPIView`                | `SuccessDestroyAPIView`                |
| `ListAPIView`                   | `SuccessListAPIView`                   |
| `RetrieveUpdateAPIView`         | `SuccessRetrieveUpdateAPIView`         |
| `RetrieveDestroyAPIView`        | `SuccessRetrieveDestroyAPIView`        |
| `RetrieveUpdateDestroyAPIView`  | `SuccessRetrieveUpdateDestroyAPIView`  |
| `ModelViewSet`                  | `SuccessModelViewSet`                  |
| `ReadOnlyModelViewSet`          | `SuccessReadOnlyModelViewSet`          |

These views behave like their DRF counterparts but automatically format responses using `SuccessResponse`.
