vitya
WARNING: This library is still in development stage.
Validators for different russian banking values.
Values you can validate:
- ИНН
validate_inn- ИНН для ИП/Физ.Лица
validate_inn_ip - ИНН для Юр.Лица
validate_inn_le
- ИНН для ИП/Физ.Лица
- КПП
validate_kpp - БИК
validate_bic - ОГРН
validate_ogrn- ОГРНИП
validate_ogrnip
- ОГРНИП
- СНИЛС
validate_snils - ОКТМО
validate_oktmo
You should pass value as str, otherwise exception will be raised.
If passed value is wrong, all functions will raise ValidationError.
Also, optionally, you can use validators as Pydantic fields
Examples:
validate_inn("3664069397")
try:
validate_inn("770708389")
except ValidationError as e:
print(f"wrong inn: {e}")
validate_kpp("616401001")
validate_bic("044525901")
validate_ogrn("1027700132195")
validate_snils("11223344595")
validate_oktmo("69701000001")
from pydantic import BaseModel, ValidationError
from vitya.pydantic_fields import INN
class InnModel(BaseModel):
inn: INN
inn_model = InnModel(inn="302502032671")
assert inn_model.inn == "302502032671"
try:
InnModel(inn="3664069398")
except ValidationError as e:
print(e.errors())
Валидация платежей по реквизитам (Russian)
Для валидации платежей используется следующий базовый класс, от которого необходимо наследоваться:
class BaseModelChecker
У наследников этого класса есть переменная класса:
__checkers__: ClassVar[List[Tuple[Type[BaseChecker], List[str]]]] = []
В этой переменной содержится список чекеров (наследников BaseChecker), которые будут вызваны (вызовется метод check) при инициализации инстансов BaseModelChecker
Класс чекеров наследуется от BaseChecker
class BaseChecker(ABC):
@abstractmethod
def check(self) -> None: # pragma: no cover
pass
При инициализации инстансов класса BaseModelChecker, когда появляется проверка чекеров не выполняется успешно, выбрасывается ошибка CheckerError, которая затем оборачивается в pydantic.ValidationError
class CheckerError(ValueError):
def __init__(self, errors: Sequence[Exception]):
self._errors = errors
@property
def errors(self) -> Sequence[Exception]:
return self._errors
Пример работы
Для примера разберем базовую ситуацию: ключевание номера счёта и БИКа банка. Чтобы это проверить, нам нужно создать класс наследник BaseModelChecker, со встроенным чекером ключевания счёта и БИКа. Такой чекер есть в базовых реализациях и называется AccountBicChecker.
Пример кода:
class MyPayment(BaseModelChecker):
account_number: AccountNumber
bic: BIC
__checkers__ = [
(AccountBicChecker, ['account_number', 'bic'])
]
try:
payment = MyPayment(account_number='40802810722200035222', bic='045004861')
except ValidationError as e:
print('ой, что-то не так с данными: ', str(e))
else:
print('все отлично!')
Результат выполнения:
ой, что-то не так с данными: 1 validation error for TestAccountBicModelChecker
__root__
[AccountValidationBICValueError()] (type=value_error.checker; _errors=[AccountValidationBICValueError()])
Поменяем БИК на корректный (последнюю цифру)
try:
payment = MyPayment(account_number='40802810722200035222', bic='045004864')
except ValidationError as e:
print('ой, что-то не так с данными: ', str(e))
else:
print('все отлично!')
Результат выполнения:
все отлично!
1 maintainer
Metadata
1 maintainer
Release files for vitya 0.20.21
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| vitya-0.20.21.tar.gz | 28.7 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| vitya-0.20.21-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 57.9 kB
Release files / vitya-0.20.21.tar.gz
| Download URL | vitya-0.20.21.tar.gz |
|---|---|
| Size | 28.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
29983b69dfeafa6b28120a809b847bead6b580d8edd27e9bde8b2fc78505f1a8
|
|
BLAKE2b-256 checksum How to use checksums |
066edcdb36a29ae1c473f6df17e535b945277eefdabce38ba554709ff73898a4
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.9.25
|
Release files / vitya-0.20.21-py3-none-any.whl
| Download URL | vitya-0.20.21-py3-none-any.whl |
|---|---|
| Size | 29.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
692469bf827d0b8257477e313e43015bfcb47aac4224899a6fca49fd79f542c3
|
|
BLAKE2b-256 checksum How to use checksums |
f8e5e546787c243546378ef2f0a8d68ff159e2cc4ef090fe599cf5fa21be4b63
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.9.25
|
