معرفی شرکت ها
django-dynamic-model-validation-1.0.0
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشترتوضیحات
Extra django model validation.
| ویژگی | مقدار |
|---|---|
| سیستم عامل | - |
| نام فایل | django-dynamic-model-validation-1.0.0 |
| نام | django-dynamic-model-validation |
| نسخه کتابخانه | 1.0.0 |
| نگهدارنده | ['Tonye Jack'] |
| ایمیل نگهدارنده | ['jtonye@ymail.com'] |
| نویسنده | Tonye Jack |
| ایمیل نویسنده | jtonye@ymail.com |
| آدرس صفحه اصلی | https://github.com/jackton1/django-dynamic-model-validation.git |
| آدرس اینترنتی | https://pypi.org/project/django-dynamic-model-validation/ |
| مجوز | MIT/Apache-2.0 |
django-dynamic-model-validation
===============================
 [](https://travis-ci.org/tj-django/django-dynamic-model-validation) [](https://www.codacy.com/gh/tj-django/django-dynamic-model-validation/dashboard?utm_source=github.com&utm_medium=referral&utm_content=tj-django/django-dynamic-model-validation&utm_campaign=Badge_Grade) [](https://www.codacy.com/gh/tj-django/django-dynamic-model-validation/dashboard?utm_source=github.com&utm_medium=referral&utm_content=tj-django/django-dynamic-model-validation&utm_campaign=Badge_Coverage)
  [](https://pepy.tech/project/django-clone)
Introduction
------------
This package aims to provide tools needed to define custom field validation logic which can be used independently or with
django forms, test cases, API implementation or any model operation that requires saving data to the database.
This can also be extended by defining table check constraints if needed but currently validation
will only be handled at the model level.
Installation
------------
django-dynamic-model-validation is distributed on [PyPI](https://pypi.org) as a universal
wheel and is available on Linux/macOS and Windows and supports
Python 2.7/3.5+ and PyPy.
```bash
pip install django-dynamic-model-validation
```
Usage
-----
This provides model level validation which includes:
- Conditional field validation
- Cross field validation
- Required field validation
- Optional field validation
### Require a single field in a collection
```py
from django.db import models
from dynamic_validator import ModelFieldRequiredMixin
class TestModel(ModelFieldRequiredMixin, models.Model):
amount = models.DecimalField(max_digits=5, decimal_places=2, null=True, blank=True)
fixed_price = models.DecimalField(max_digits=7, decimal_places=2, null=True, blank=True)
percentage = models.DecimalField(max_digits=3, decimal_places=0, null=True, blank=True)
REQUIRED_TOGGLE_FIELDS = [
['amount', 'fixed_price', 'percentage'], # Require only one of the following fields.
]
```
```bash
python manage.py shell
...
>>> from decimal import Decimal
>>> from demo.models import TestModel
>>> TestModel.objects.create(amount=Decimal('2.50'), fixed_price=Decimal('3.00'))
...
ValueError: {'fixed_price': ValidationError([u'Please provide only one of: Amount, Fixed price, Percentage'])}
```
### Require all fields
```py
from django.db import models
from dynamic_validator import ModelFieldRequiredMixin
class TestModel(ModelFieldRequiredMixin, models.Model):
amount = models.DecimalField(max_digits=5, decimal_places=2, null=True, blank=True)
fixed_price = models.DecimalField(max_digits=7, decimal_places=2, null=True, blank=True)
percentage = models.DecimalField(max_digits=3, decimal_places=0, null=True, blank=True)
REQUIRED_FIELDS = ['amount'] # Always requires an amount to create the instance.
```
```bash
python manage.py shell
...
>>> from decimal import Decimal
>>> from demo.models import TestModel
>>> TestModel.objects.create(fixed_price=Decimal('3.00'))
...
ValueError: {'amount': ValidationError([u'Please provide a value for: "amount".'])}
```
### Optionally required fields
```py
from django.db import models
from dynamic_validator import ModelFieldRequiredMixin
class TestModel(ModelFieldRequiredMixin, models.Model):
amount = models.DecimalField(max_digits=5, decimal_places=2, null=True, blank=True)
fixed_price = models.DecimalField(max_digits=7, decimal_places=2, null=True, blank=True)
percentage = models.DecimalField(max_digits=3, decimal_places=0, null=True, blank=True)
OPTIONAL_TOGGLE_FIELDS = [
['fixed_price', 'percentage'] # Optionally validates that only fixed price/percentage are provided when present.
]
```
```bash
python manage.py shell
...
>>> from decimal import Decimal
>>> from demo.models import TestModel
>>> first_obj = TestModel.objects.create(amount=Decimal('2.0'))
>>> second_obj = TestModel.objects.create(amount=Decimal('2.0'), fixed_price=Decimal('3.00'))
>>> third_obj = TestModel.objects.create(amount=Decimal('2.0'), fixed_price=Decimal('3.00'), percentage=Decimal('10.0'))
...
ValueError: {'percentage': ValidationError([u'Please provide only one of: Fixed price, Percentage'])}
```
### Conditional required fields
```py
from django.db import models
from django.conf import settings
from dynamic_validator import ModelFieldRequiredMixin
class TestModel(ModelFieldRequiredMixin, models.Model):
user = models.ForeignKey(settings.AUTH_USER_MODEL)
amount = models.DecimalField(max_digits=5, decimal_places=2, null=True, blank=True)
fixed_price = models.DecimalField(max_digits=7, decimal_places=2, null=True, blank=True)
percentage = models.DecimalField(max_digits=3, decimal_places=0, null=True, blank=True)
CONDITIONAL_REQUIRED_FIELDS = [
(
lambda instance: instance.user.is_active, ['amount', 'percentage'],
),
]
```
```bash
python manage.py shell
...
>>> from decimal import Decimal
>>> from django.contrib.auth import get_user_model
>>> from demo.models import TestModel
>>> user = get_user_model().objects.create(username='test', is_active=True)
>>> first_obj = TestModel.objects.create(user=user, amount=Decimal('2.0'))
...
ValueError: {u'percentage': ValidationError([u'Please provide a value for: "percentage"'])}
```
### Conditional required optional fields
```py
from django.db import models
from django.conf import settings
from dynamic_validator import ModelFieldRequiredMixin
class TestModel(ModelFieldRequiredMixin, models.Model):
user = models.ForeignKey(settings.AUTH_USER_MODEL)
amount = models.DecimalField(max_digits=5, decimal_places=2, null=True, blank=True)
fixed_price = models.DecimalField(max_digits=7, decimal_places=2, null=True, blank=True)
percentage = models.DecimalField(max_digits=3, decimal_places=0, null=True, blank=True)
CONDITIONAL_REQUIRED_TOGGLE_FIELDS = [
(
lambda instance: instance.user.is_active, ['fixed_price', 'percentage', 'amount'],
),
]
```
```bash
python manage.py shell
...
>>> from decimal import Decimal
>>> from django.contrib.auth import get_user_model
>>> from demo.models import TestModel
>>> user = get_user_model().objects.create(username='test', is_active=True)
>>> first_obj = TestModel.objects.create(user=user)
...
ValueError: {'__all__': ValidationError([u'Please provide a valid value for any of the following fields: Fixed price, Percentage, Amount'])}
...
>>>first_obj = TestModel.objects.create(user=user, amount=Decimal('2'), fixed_price=Decimal('2'))
...
ValueError: {'__all__': ValidationError([u'Please provide only one of the following fields: Fixed price, Percentage, Amount'])}
...
```
Model Attributes
----------------
This is done using model attributes below.
```py
# Using a list/iterable: [['a', 'b'], ['c', 'd']] which validates that a field from each item is provided.
REQUIRED_TOGGLE_FIELDS = []
# Using a list/iterable validates that all fields are provided.
REQUIRED_FIELDS = []
# Optional toggle fields list: [['a', 'b']] which runs the validation only when any of the fields are present.
OPTIONAL_TOGGLE_FIELDS = []
# Conditional field validation using a list of tuples the condition which could be boolean or a callable and the list/iterable of fields that are required if the condition evaluates to `True`.
# [(condition, [fields]), (condition, fields)]
# Using a callable CONDITIONAL_REQUIRED_FIELDS = [(lambda instance: instance.is_admin, ['a', 'd'])]
# Using a boolean CONDITIONAL_REQUIRED_TOGGLE_FIELDS = [(True, ['b', 'c']), (True, ['d', f])]
# asserts that either 'b' or 'c' is provided and either 'd' or 'f'.
# (Note: This can also be handled using REQUIRED_FIELDS/REQUIRED_TOGGLE_FIELDS)
# Validates that all fields are present if the condition is True
CONDITIONAL_REQUIRED_FIELDS = []
# Validated at least one not both fields are provided if the condition is True.
CONDITIONAL_REQUIRED_TOGGLE_FIELDS = []
```
License
-------
django-dynamic-model-validation is distributed under the terms of both
- [MIT License](https://choosealicense.com/licenses/mit)
- [Apache License, Version 2.0](https://choosealicense.com/licenses/apache-2.0)
at your option.
TODO's
------
- Move to support class and function based validators that use the instance object this should enable cross field model validation.
نیازمندی
| مقدار | نام |
|---|---|
| - | future |
| - | six |
| - | readme-renderer[md] |
| ==0.5.11 | bump2version |
| >=1.11.18 | Django |
| - | pip-tools |
| - | check-manifest |
| - | future |
| - | six |
| - | tox |
| - | pytest-django |
| >=0.7 | pluggy |
| - | mock |
| - | codacy-coverage |
| - | flake8 |
| - | yamllint |
| - | isort |
| - | flake8 |
| - | yamllint |
| - | isort |
| - | tox |
| - | pytest-django |
| >=0.7 | pluggy |
| - | mock |
| - | codacy-coverage |
| >=1.11.18 | Django |
| - | pip-tools |
| - | check-manifest |
زبان مورد نیاز
| مقدار | نام |
|---|---|
| >=2.6 | Python |
نحوه نصب
نصب پکیج whl django-dynamic-model-validation-1.0.0:
pip install django-dynamic-model-validation-1.0.0.whl
نصب پکیج tar.gz django-dynamic-model-validation-1.0.0:
pip install django-dynamic-model-validation-1.0.0.tar.gz