معرفی شرکت ها
django-ext-utils-0.0.1
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشترتوضیحات
Useful utilities for your django project
| ویژگی | مقدار |
|---|---|
| سیستم عامل | - |
| نام فایل | django-ext-utils-0.0.1 |
| نام | django-ext-utils |
| نسخه کتابخانه | 0.0.1 |
| نگهدارنده | [] |
| ایمیل نگهدارنده | [] |
| نویسنده | Andrei Koptev |
| ایمیل نویسنده | akoptev1989@ya.ru |
| آدرس صفحه اصلی | https://github.com/a1k89/django-ext-utils |
| آدرس اینترنتی | https://pypi.org/project/django-ext-utils/ |
| مجوز | MIT |
# Django-ext-utils
### Useful utilities for your django project
## Requirements
+ Python >= 3.0
+ Django >= 2.0
+ Pillow
+ (optional) Djangorestframework
## Installation
```commandline
pip install django-ext-utils
```
Add to your settings
`settings.py`
```python
INSTALLED_APPS = [
'django.contrib.admin',
'django.contrib.auth',
...
'django_ext_utils',
]
SERIALIZERS_PATH = 'api.v1.serializers' # path to serializers folder
```
## Usage
#### ResizeImageMixin
Resize image on the fly before save to `ImageField`:
```python
from django.contrib.auth.models import AbstractUser
from django_ext_utils.utils import ResizeImageMixin
class User(AbstractUser, ResizeImageMixin):
avatar = models.ImageField(upload_to='avatars')
...
def save(self, *args, **kwargs):
if self.pk is None:
self.resize(self.avatar, (200, 200)) # here!
super().save(*args, **kwargs)
```
#### DeletedModelMixin
On `delete` mark `is_mark_as_delete` instead
```python
from django_ext_utils.utils import DeletedModelMixin
```
#### SingletonModelMixin
Create only one instance of model
```python
from django_ext_utils.utils import SingletonModelMixin
```
#### Service
Service-form-oriented helper (I really like services)
```python
from django_ext_utils.utils import Service
from .models import Subscription
# Services/service.py
class AddSubscriptionService(Service):
def go(self):
email = self.cleaned_data.get('email')
name = self.cleaned_data.get('name')
subscription, created = Subscription.objects.get_or_create(
email = email,
defaults = {
'name': name
}
)
if created:
# notify user
......
return subscription
# views.py
subscription = NotificationService.exec({
'email': 'foo@example.com',
'name': 'foo'
})
...
return Response(subscription.serialize_data)
```
### Rest api helpers
#### ResponsesMixin
* wrapper for `rest_framework.Response` with statuses
* `simple_text_response` return text with `200` code
* `success_objects_response` return object with `200` code
* `error_response` return `Error` object with `400` code
```python
class UserProfileViewSet(ResponsesMixin, GenericAPIView):
serializer_class = UserSerializer
def post(self, request, *args, **kwargs):
user = request.user
serializer = UserSerializer(instance=request.user,
data=request.data,
context={'request': request})
if serializer.is_valid():
serializer.save()
return self.success_objects_response(serializer.data) # here
return self.error_response(serializer.errors) # here
def get(self, request, *args, **kwargs):
user = request.user
data = user._serialize_data(request)
return self.success_objects_response(data) # here
```
##### Base
Abstract class to help serialize your models
* get_serializer # Return serializer by name (**Model**Serializer)
* get_short_serializer # Retrun another serializer by name (**Model**ShortSerializer)
* serialize_data # Find serializer by name and return `serialize data`
* _serialize_data(request) # Find serializer by name and serialize data with `request`
* IMPORTANT: you must create serializer by rule: **ModelName**Serializer or **ModelName**ShortSerializer
```python
from django_ext_utils.rest_utils import Base
# models.py
class User(AbstractUser, Base, ResizeImageMixin):
avatar = models.ImageField(upload_to='avatars')
....
# serializer.py
class UserSerializer(serializers.ModelSerializer):
class Meta:
model = User
fields = [
'pk',
'first_name',
'last_name'
]
# views.py
from rest_framework.generics import GenericAPIView
class UserApiView(GenericAPIView):
def get(self, request, *args, **kwargs):
user = request.user
data = user._serialize_data(request) # here!
return self.success_objects_response(data)
```
#### ImageBase64Field
* Wrapper for `serializers.ImageField()`
* Got `base64` string and save in model `ImageField`
* Return `link to image` (http://example.com/media/avatars/my.jpeg)
```python
# serializer.py
class SomeUserApiView(serializers.ModelSerializer):
image = ImageBase64Field()
created_at = TimestampField(read_only=True)
class Meta:
model = User
fields = [
'uid',
'image',
'created_at'
]
```
نیازمندی
| مقدار | نام |
|---|---|
| >=2.0 | Django |
| - | Pillow |
| >=3.0 | djangorestframework |
نحوه نصب
نصب پکیج whl django-ext-utils-0.0.1:
pip install django-ext-utils-0.0.1.whl
نصب پکیج tar.gz django-ext-utils-0.0.1:
pip install django-ext-utils-0.0.1.tar.gz