Metadata-Version: 2.1
Name: python-validation-rules
Version: 0.1.17
Summary: UNKNOWN
Home-page: https://github.com/Gaoshengyue/validationRules
Author: Symoon
Author-email: symoon.gao@gmail.com
License: MIT
Download-URL: https://github.com/Gaoshengyue/validationRules/releases/tag/v0.1.17
Description: ## 基于pydantic的BaseModel下实现的validationRules
        ##  描述
        目前标准结构化的python都开始使用pydantic做结构限制以及校验，每一次的validator都要调用validator装饰器后自己实现。本库是为了整合涵盖所有可能出现的需要校验方法进行封装的规则包。目的是开箱即用注解形式方便使用
        ## 前置
        需要配合pydantic的validator使用
        
        ## Install
        
        `pip install python-validation-rules==0.1.0`
        
        ## 使用方式
        
        例如：校验该字段是否是标准手机号
        ```python3
        from pydantic import BaseModel, Field, validator
        
        from validationRules.fieldRules import StringRules
        
        
        class TestUserBase(BaseModel):
            userName: str = Field(description="用户名", alias="user_name")
            mobileNumber: str = Field(description="手机号", alias="mobile_number")
            password: str = Field(description="密码", alias="password")
            email: str = Field(description="邮箱", alias="email")
            IDCard: str = Field(description="身份证号", alias="id_card")
        
            @validator("userName")
            @StringRules.accountRule
            def check_account(cls, column):
                return column
        
            @validator("mobileNumber")
            @StringRules.mobileRule
            def check_mobile_number(cls, column):
                return column
        
            @validator("password")
            @StringRules.keywordCheckRule(password_level=1, min_length=8)
            def check_keyword(cls, column):
                return column
        
            @validator("email")
            @StringRules.emailRule(required=True)
            def check_email(cls, column):
                return column
        
            @validator("IDCard")
            @StringRules.IDCardRule(required=True)
            def check_id_card(cls, column):
                return column
        
        
        # user_obj: TestUserBase = TestUserBase(
        #
        #     user_name="symoon",
        #     mobile_number="13232633123"
        # )
        #
        # print(user_obj)
        # userName='symoon' mobileNumber='13232633123'
        
        user_obj: TestUserBase = TestUserBase(
        
            user_name="symoon",
            mobile_number="13232633123",
            password="gsy121994",
            email="fsdfsfsf@qq.com",
            id_card="130"
        )
        print(user_obj)
        # [132326331231] mobile is not 11 length (type=value_error)
        ```
        
        ## 方法描述
        | 参数           | 类型      | 描述                                                         |
        | -------------- | --------- | ------------------------------------------------------------ |
        | required   | bool | 是否为必填                                 |
        ### 字符串校验
        #### accountRule:账号校验
        
        标准账号校验方法
        ```python3 
            @validator("userName")
            @StringRules.accountRule
            def check_account(cls, column):
                return column
        ```
        
        #### mobileRule:手机号校验
        
        手机号校验
        ```python3
            @validator("mobileNumber")
            @StringRules.mobileRule
            def check_mobile_number(cls, column):
                return column
        ```
        
        #### keywordCheckRule:关键字符校验(密码校验)
        
        | 参数           | 类型      | 描述                                                         |
        | -------------- | --------- | ------------------------------------------------------------ |
        | keyword_list   | List[str] | 校验字符是否包含列表中字符                                   |
        | startswith     | str       | 校验是否以字符开头                                           |
        | endswith       | str       | 校验是否以字符结尾                                           |
        | min_length     | int       | 校验最小长度                                                 |
        | max_length     | int       | 校验最大长度                                                 |
        | password_level | int       | 验证等级，默认为0 {3:"三种必须条件",2:"两种必须条件",3:"必须包含字母及数字",0:"不做验证"} |
        
        ```python3
            @validator("password")
            @StringRules.keywordCheckRule(password_level=1, min_length=8)
            def check_keyword(cls, column):
                return column
        ```
        #### emailRule:邮箱校验
        
        邮箱校验
        ```python3
            @validator("email")
            @StringRules.emailRule(required=True)
            def check_email(cls, column):
                return column
        ```
        #### IDCardRule:身份证校验
        
        身份证校验
        
        ```python3
            @validator("IDCard")
            @StringRules.IDCardRule(required=True)
            def check_id_card(cls, column):
                return column
        ```
        
Keywords: python-validation-rules,validation-rules
Platform: UNKNOWN
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Description-Content-Type: text/markdown
