Metadata-Version: 2.1
Name: drf-extended
Version: 0.1
Summary: DRF extender for django models.
Author: Vladyslav Halatskyi
Author-email: galatskiy.vlad@steelkiwi.com
License: BSD-3-Clause
Classifier: Environment :: Web Environment
Classifier: Framework :: Django
Classifier: Framework :: Django :: 4.0
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: BSD License
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Topic :: Internet :: WWW/HTTP
Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
Requires-Python: >=3.8
Description-Content-Type: text/markdown

![lint](https://github.com/floydya/drf-extended/actions/workflows/lint.yml/badge.svg)
![deploy](https://github.com/floydya/drf-extended/actions/workflows/deploy.yml/badge.svg)
![pypi](https://badge.fury.io/py/tensorflow.svg)

# Django Model Serializer package  

This package provides ability for developers to create serializers directly from models.  

## Installation  

### Install using pip:  

```bash  
pip install django-modelserializer  
```  

## Usage  

### Models file:

```python  
from django.db import models

from django_modelserializer import APIMixin, APIModel, APIField
from rest_framework import serializers

class MyParentModel(APIMixin, models.Model):
    """You can inherit from APIMixin that provides serializer constructor method."""
    name = models.CharField(max_length=64)
    description = models.TextField()

	api_fields = [
		APIField('name'),
		APIField('description'),
	]

class MyModel(APIModel):
    """You can inherit from APIModel, that is inherited from APIMixin and models.Model"""
    title = models.CharField(max_length=40)
    parent = models.ForeignKey(MyParentModel, on_delete=models.CASCADE)
  
    api_fields = [
        # Plain serialize title as rest_framework does it out of the box.
        APIField('title'),
        # Serializer from foreign key field's model will be calculated automatically,
        # if ForeingKey related model is subclass of APIMixin(or APIModel).
        APIField('parent'),
        # You can specify custom serializer for field.
        APIField('parent_id', serializers.IntegerField(source='parent.id')),
    ]
```

### Get serializer:

```python
from .models import MyModel

MyModelSerializer = MyModel.get_serializer_class()
```
#### Here, MyModelSerializer is equal to:
```python
from rest_framework import serializers
from .models import MyParentModel


class MyParentModelSerializer(serializers.ModelSerializer):

    class Meta:
        model = MyParentModel
        fields = ('name', 'description')

class MyModelSerializer(serializers.ModelSerializer):
    parent = MyParentModelSerializer()

    class Meta:
        fields = ('title', 'parent', 'parent_id')

```

### Use in views:
```python

from rest_framework.generics import RetrieveAPIView

from .models import MyModel


class MyModelRetrieveView(RetrieveAPIView):
    serializer_class = MyModel.get_serializer_class()
    queryset = MyModel.objects.select_related('parent').all()

```
