simplibs-rules 0.1.0__tar.gz → 0.2.1__tar.gz
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- {simplibs_rules-0.1.0/src/simplibs_rules.egg-info → simplibs_rules-0.2.1}/PKG-INFO +6 -25
- {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/README.md +5 -24
- {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/pyproject.toml +1 -1
- {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/__init__.py +22 -12
- simplibs_rules-0.2.1/src/simplibs/rules/predicates/__init__.py +24 -0
- simplibs_rules-0.2.1/src/simplibs/rules/predicates/strings/IsIdentifier.py +100 -0
- simplibs_rules-0.2.1/src/simplibs/rules/predicates/strings/IsPrintable.py +99 -0
- simplibs_rules-0.2.1/src/simplibs/rules/predicates/strings/IsWhitespace.py +99 -0
- {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/strings/__init__.py +6 -0
- {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/testing/__init__.py +0 -3
- {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/testing/assert_rule_contract.py +7 -48
- {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/testing/asserts/__init__.py +1 -4
- {simplibs_rules-0.1.0 → simplibs_rules-0.2.1/src/simplibs_rules.egg-info}/PKG-INFO +6 -25
- {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs_rules.egg-info/SOURCES.txt +3 -3
- simplibs_rules-0.1.0/src/simplibs/rules/predicates/__init__.py +0 -103
- simplibs_rules-0.1.0/src/simplibs/rules/testing/asserts/assert_rule_raise_invalid.py +0 -91
- simplibs_rules-0.1.0/src/simplibs/rules/tools/__init__.py +0 -16
- simplibs_rules-0.1.0/src/simplibs/rules/tools/raise_invalid.py +0 -84
- {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/LICENSE +0 -0
- {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/setup.cfg +0 -0
- {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/base_class/Rule.py +0 -0
- {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/base_class/_NotARule.py +0 -0
- {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/base_class/__init__.py +0 -0
- {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/containers/AllOf.py +0 -0
- {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/containers/AnyOf.py +0 -0
- {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/containers/Compose.py +0 -0
- {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/containers/ForEach.py +0 -0
- {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/containers/NoneOf.py +0 -0
- {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/containers/Not.py +0 -0
- {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/containers/__init__.py +0 -0
- {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/containers/_helpers/__init__.py +0 -0
- {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/containers/_helpers/as_predicate.py +0 -0
- {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/containers/_helpers/build_child_exception.py +0 -0
- {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/containers/_helpers/describe_rule.py +0 -0
- {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/containers/_helpers/validations/__init__.py +0 -0
- {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/containers/_helpers/validations/raise_invalid_predicate.py +0 -0
- {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/containers/_init_validators/__init__.py +0 -0
- {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/containers/_init_validators/raise_container_param_not_type_error.py +0 -0
- {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/containers/_init_validators/raise_requires_at_least_one_rule_error.py +0 -0
- {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/containers/_init_validators/raise_rule_param_not_callable.py +0 -0
- {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/containers/_init_validators/validate_compose_param_is_callable.py +0 -0
- {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/_helpers/__init__.py +0 -0
- {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/_helpers/accepts_one_positional_argument.py +0 -0
- {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/_helpers/format_container.py +0 -0
- {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/_init_validators/__init__.py +0 -0
- {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/_init_validators/rule_errors/__init__.py +0 -0
- {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/_init_validators/rule_errors/raise_has_length_param_conflict_error.py +0 -0
- {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/_init_validators/rule_errors/raise_regex_param_invalid_pattern_error.py +0 -0
- {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/_init_validators/rule_errors/raise_user_rule_param_wrong_arity.py +0 -0
- {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/_init_validators/shared_errors/__init__.py +0 -0
- {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/_init_validators/shared_errors/raise_param_min_max_bounds_inverted_error.py +0 -0
- {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/_init_validators/shared_errors/raise_param_min_max_incomparable_error.py +0 -0
- {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/_init_validators/shared_errors/raise_param_missing_error.py +0 -0
- {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/_init_validators/shared_errors/raise_param_not_callable_error.py +0 -0
- {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/_init_validators/shared_errors/raise_param_not_container_error.py +0 -0
- {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/_init_validators/shared_errors/raise_param_not_non_negative_integer_error.py +0 -0
- {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/_init_validators/shared_errors/raise_param_not_string_error.py +0 -0
- {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/_init_validators/shared_errors/raise_param_not_type_error.py +0 -0
- {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/_init_validators/shared_validators/__init__.py +0 -0
- {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/_init_validators/shared_validators/validate_param_is_integer.py +0 -0
- {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/_init_validators/shared_validators/validate_param_is_not_zero.py +0 -0
- {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/_init_validators/shared_validators/validate_param_is_primitive_number.py +0 -0
- {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/_init_validators/shared_validators/validate_param_remainder_in_range.py +0 -0
- {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/arithmetic/CloseTo.py +0 -0
- {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/arithmetic/DivisibleBy.py +0 -0
- {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/arithmetic/HasRemainder.py +0 -0
- {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/arithmetic/__init__.py +0 -0
- {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/checkers/IsEmpty.py +0 -0
- {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/checkers/IsFalse.py +0 -0
- {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/checkers/IsNone.py +0 -0
- {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/checkers/IsTrue.py +0 -0
- {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/checkers/NotEmpty.py +0 -0
- {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/checkers/__init__.py +0 -0
- {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/collections/AllUnique.py +0 -0
- {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/collections/HasItem.py +0 -0
- {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/collections/HasKey.py +0 -0
- {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/collections/HasKeys.py +0 -0
- {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/collections/IsContainer.py +0 -0
- {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/collections/IsSubsetOf.py +0 -0
- {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/collections/IsSupersetOf.py +0 -0
- {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/collections/__init__.py +0 -0
- {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/comparisons/Equals.py +0 -0
- {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/comparisons/GreaterOrEqual.py +0 -0
- {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/comparisons/GreaterThan.py +0 -0
- {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/comparisons/InRange.py +0 -0
- {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/comparisons/LessOrEqual.py +0 -0
- {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/comparisons/LessThan.py +0 -0
- {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/comparisons/NotEquals.py +0 -0
- {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/comparisons/__init__.py +0 -0
- {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/introspection/HasAttribute.py +0 -0
- {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/introspection/HasLength.py +0 -0
- {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/introspection/IsCallable.py +0 -0
- {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/introspection/IsDataclass.py +0 -0
- {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/introspection/IsHashable.py +0 -0
- {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/introspection/IsInstance.py +0 -0
- {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/introspection/IsIterable.py +0 -0
- {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/introspection/IsSubclass.py +0 -0
- {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/introspection/IsType.py +0 -0
- {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/introspection/__init__.py +0 -0
- {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/logic/Is.py +0 -0
- {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/logic/IsIn.py +0 -0
- {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/logic/IsNot.py +0 -0
- {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/logic/NotIn.py +0 -0
- {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/logic/UserRule.py +0 -0
- {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/logic/__init__.py +0 -0
- {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/numeric/IsBool.py +0 -0
- {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/numeric/IsDecimal.py +0 -0
- {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/numeric/IsEven.py +0 -0
- {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/numeric/IsFinite.py +0 -0
- {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/numeric/IsFloat.py +0 -0
- {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/numeric/IsInfinity.py +0 -0
- {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/numeric/IsInteger.py +0 -0
- {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/numeric/IsNan.py +0 -0
- {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/numeric/IsNumber.py +0 -0
- {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/numeric/IsOdd.py +0 -0
- {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/numeric/IsPi.py +0 -0
- {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/numeric/IsPrimitiveNumber.py +0 -0
- {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/numeric/IsZero.py +0 -0
- {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/numeric/__init__.py +0 -0
- {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/strings/Contains.py +0 -0
- {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/strings/EndsWith.py +0 -0
- {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/strings/IsAlnum.py +0 -0
- {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/strings/IsAlpha.py +0 -0
- {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/strings/IsAscii.py +0 -0
- {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/strings/IsBlank.py +0 -0
- {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/strings/IsDigitString.py +0 -0
- {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/strings/IsLowercase.py +0 -0
- {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/strings/IsString.py +0 -0
- {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/strings/IsSubstringOf.py +0 -0
- {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/strings/IsTitlecase.py +0 -0
- {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/strings/IsUppercase.py +0 -0
- {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/strings/NotBlank.py +0 -0
- {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/strings/Regex.py +0 -0
- {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/strings/StartsWith.py +0 -0
- {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/typing/IsAny.py +0 -0
- {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/typing/IsTyping.py +0 -0
- {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/typing/__init__.py +0 -0
- {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/typing/_builders/ORIGIN_TABLE.py +0 -0
- {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/typing/_builders/__init__.py +0 -0
- {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/typing/_builders/build_annotated_rule.py +0 -0
- {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/typing/_builders/build_any_of_rule.py +0 -0
- {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/typing/_builders/build_callable_rule.py +0 -0
- {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/typing/_builders/build_elements_rule.py +0 -0
- {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/typing/_builders/build_key_value_rule.py +0 -0
- {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/typing/_builders/build_literal_rule.py +0 -0
- {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/typing/_builders/build_tuple_rule.py +0 -0
- {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/typing/_builders/build_type_rule.py +0 -0
- {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/typing/_validations/__init__.py +0 -0
- {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/typing/_validations/raise_unsupported_annotation_error.py +0 -0
- {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/typing/build_typing_rule.py +0 -0
- {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/typing/tools/__init__.py +0 -0
- {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/typing/tools/get_supported_origins.py +0 -0
- {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/typing/tools/is_supported_annotation.py +0 -0
- {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/testing/asserts/assert_rule_build_exception.py +0 -0
- {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/testing/asserts/assert_rule_is_valid.py +0 -0
- {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/testing/asserts/assert_rule_param_error.py +0 -0
- {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/testing/asserts/assert_rule_validate.py +0 -0
- {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs_rules.egg-info/dependency_links.txt +0 -0
- {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs_rules.egg-info/requires.txt +0 -0
- {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs_rules.egg-info/top_level.txt +0 -0
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
Metadata-Version: 2.4
|
|
2
2
|
Name: simplibs-rules
|
|
3
|
-
Version: 0.1
|
|
3
|
+
Version: 0.2.1
|
|
4
4
|
Summary: Composable, explicit validation rules — pure predicates, zero transformation.
|
|
5
5
|
Author-email: "Dalibor Sova (Sudip2708)" <daliborsova@seznam.cz>
|
|
6
6
|
License-Expression: MIT
|
|
@@ -134,22 +134,6 @@ typing_rule.is_valid({"apples": 5, "oranges": 10}) # -> True
|
|
|
134
134
|
typing_rule.is_valid({"apples": "5"}) # -> False
|
|
135
135
|
```
|
|
136
136
|
|
|
137
|
-
### Level 4: Unconditional direct triggers
|
|
138
|
-
|
|
139
|
-
When control flow guards in your application have already detected a failure condition
|
|
140
|
-
inline, use `raise_invalid()` to bypass rule evaluation entirely and construct the
|
|
141
|
-
diagnostic exception immediately:
|
|
142
|
-
|
|
143
|
-
```python
|
|
144
|
-
from simplibs.rules import raise_invalid, is_integer
|
|
145
|
-
|
|
146
|
-
value = -5
|
|
147
|
-
|
|
148
|
-
if value < 0:
|
|
149
|
-
# Bypasses evaluation and directly raises the structured exception card
|
|
150
|
-
raise_invalid(value, is_integer, value_name="age", context="Must be non-negative")
|
|
151
|
-
```
|
|
152
|
-
|
|
153
137
|
---
|
|
154
138
|
|
|
155
139
|
## 🛠️ Architecture & Package Structure
|
|
@@ -170,8 +154,6 @@ src/simplibs/rules/
|
|
|
170
154
|
│ ├── numeric/ ◄── IsBool, IsInteger, IsFloat, IsDecimal, IsNumber, IsPrimitiveNumber, IsZero, IsNan, IsInfinity, IsPi
|
|
171
155
|
│ ├── strings/ ◄── IsString, Contains, IsSubstringOf, StartsWith, EndsWith, Regex, IsBlank, NotBlank
|
|
172
156
|
│ └── typing/ ◄── Annotation-driven evaluation (IsAny, IsTyping, build_typing_rule)
|
|
173
|
-
├── tools/ ◄── Operational helper utilities
|
|
174
|
-
│ └── raise_invalid.py ◄── Unconditional exception trigger (bypasses logic evaluation)
|
|
175
157
|
└── testing/ ◄── Testing contracts for Rule implementations
|
|
176
158
|
└── assert_rule_contract.py
|
|
177
159
|
```
|
|
@@ -299,8 +281,8 @@ mechanism that also powers `simplibs-validate`'s `validate_call`/`validate_datac
|
|
|
299
281
|
`simplibs-rules` includes its own contract testing tools to ensure custom or existing `Rule`
|
|
300
282
|
implementations strictly follow all rules and return modes:
|
|
301
283
|
|
|
302
|
-
|
|
303
|
-
|
|
284
|
+
assert_rule_contract: Verifies is_valid, direct calling, validate() matrix, return modes,
|
|
285
|
+
and exception generation consistency for any Rule instance.
|
|
304
286
|
|
|
305
287
|
➡️ [README_TESTING_ASSERTS_RULE_CONTRACT](https://github.com/simplibs/simplibs-rules/blob/main/docs/testing/README_TESTING_ASSERTS_RULE_CONTRACT.md)
|
|
306
288
|
|
|
@@ -308,7 +290,7 @@ implementations strictly follow all rules and return modes:
|
|
|
308
290
|
|
|
309
291
|
## ⚠️ Exceptions
|
|
310
292
|
|
|
311
|
-
Diagnostic exceptions built by `build_exception()
|
|
293
|
+
Diagnostic exceptions built by `build_exception()` are structured
|
|
312
294
|
[`simplibs.exception.SimpleException`](https://pypi.org/project/simplibs-exception/) cards
|
|
313
295
|
rather than bare tracebacks. `simplibs-validate` builds its own `ValidateError` hierarchy
|
|
314
296
|
on top of the same mechanism for the higher-level entry points (`validate()`,
|
|
@@ -319,9 +301,8 @@ on top of the same mechanism for the higher-level entry points (`validate()`,
|
|
|
319
301
|
## 🔗 Related libraries
|
|
320
302
|
|
|
321
303
|
* **[`simplibs-validate`](https://pypi.org/project/simplibs-validate/)** — the `validate()`
|
|
322
|
-
entry point, ready-made
|
|
323
|
-
(
|
|
324
|
-
lives here, in `simplibs-rules`, not there.
|
|
304
|
+
entry point, ready-made validate_* wrappers, operational tools (raise_invalid, validated_type),
|
|
305
|
+
and self-validating decorators (validate_call, validate_dataclass) built on top of Rule.
|
|
325
306
|
* **`simplibs-types`** *(in progress)* — reusable, named validated types (`Annotated[type,
|
|
326
307
|
Rule]` combinations) built on `Rule`, for sharing a single constraint definition across
|
|
327
308
|
many annotations.
|
|
@@ -106,22 +106,6 @@ typing_rule.is_valid({"apples": 5, "oranges": 10}) # -> True
|
|
|
106
106
|
typing_rule.is_valid({"apples": "5"}) # -> False
|
|
107
107
|
```
|
|
108
108
|
|
|
109
|
-
### Level 4: Unconditional direct triggers
|
|
110
|
-
|
|
111
|
-
When control flow guards in your application have already detected a failure condition
|
|
112
|
-
inline, use `raise_invalid()` to bypass rule evaluation entirely and construct the
|
|
113
|
-
diagnostic exception immediately:
|
|
114
|
-
|
|
115
|
-
```python
|
|
116
|
-
from simplibs.rules import raise_invalid, is_integer
|
|
117
|
-
|
|
118
|
-
value = -5
|
|
119
|
-
|
|
120
|
-
if value < 0:
|
|
121
|
-
# Bypasses evaluation and directly raises the structured exception card
|
|
122
|
-
raise_invalid(value, is_integer, value_name="age", context="Must be non-negative")
|
|
123
|
-
```
|
|
124
|
-
|
|
125
109
|
---
|
|
126
110
|
|
|
127
111
|
## 🛠️ Architecture & Package Structure
|
|
@@ -142,8 +126,6 @@ src/simplibs/rules/
|
|
|
142
126
|
│ ├── numeric/ ◄── IsBool, IsInteger, IsFloat, IsDecimal, IsNumber, IsPrimitiveNumber, IsZero, IsNan, IsInfinity, IsPi
|
|
143
127
|
│ ├── strings/ ◄── IsString, Contains, IsSubstringOf, StartsWith, EndsWith, Regex, IsBlank, NotBlank
|
|
144
128
|
│ └── typing/ ◄── Annotation-driven evaluation (IsAny, IsTyping, build_typing_rule)
|
|
145
|
-
├── tools/ ◄── Operational helper utilities
|
|
146
|
-
│ └── raise_invalid.py ◄── Unconditional exception trigger (bypasses logic evaluation)
|
|
147
129
|
└── testing/ ◄── Testing contracts for Rule implementations
|
|
148
130
|
└── assert_rule_contract.py
|
|
149
131
|
```
|
|
@@ -271,8 +253,8 @@ mechanism that also powers `simplibs-validate`'s `validate_call`/`validate_datac
|
|
|
271
253
|
`simplibs-rules` includes its own contract testing tools to ensure custom or existing `Rule`
|
|
272
254
|
implementations strictly follow all rules and return modes:
|
|
273
255
|
|
|
274
|
-
|
|
275
|
-
|
|
256
|
+
assert_rule_contract: Verifies is_valid, direct calling, validate() matrix, return modes,
|
|
257
|
+
and exception generation consistency for any Rule instance.
|
|
276
258
|
|
|
277
259
|
➡️ [README_TESTING_ASSERTS_RULE_CONTRACT](https://github.com/simplibs/simplibs-rules/blob/main/docs/testing/README_TESTING_ASSERTS_RULE_CONTRACT.md)
|
|
278
260
|
|
|
@@ -280,7 +262,7 @@ implementations strictly follow all rules and return modes:
|
|
|
280
262
|
|
|
281
263
|
## ⚠️ Exceptions
|
|
282
264
|
|
|
283
|
-
Diagnostic exceptions built by `build_exception()
|
|
265
|
+
Diagnostic exceptions built by `build_exception()` are structured
|
|
284
266
|
[`simplibs.exception.SimpleException`](https://pypi.org/project/simplibs-exception/) cards
|
|
285
267
|
rather than bare tracebacks. `simplibs-validate` builds its own `ValidateError` hierarchy
|
|
286
268
|
on top of the same mechanism for the higher-level entry points (`validate()`,
|
|
@@ -291,9 +273,8 @@ on top of the same mechanism for the higher-level entry points (`validate()`,
|
|
|
291
273
|
## 🔗 Related libraries
|
|
292
274
|
|
|
293
275
|
* **[`simplibs-validate`](https://pypi.org/project/simplibs-validate/)** — the `validate()`
|
|
294
|
-
entry point, ready-made
|
|
295
|
-
(
|
|
296
|
-
lives here, in `simplibs-rules`, not there.
|
|
276
|
+
entry point, ready-made validate_* wrappers, operational tools (raise_invalid, validated_type),
|
|
277
|
+
and self-validating decorators (validate_call, validate_dataclass) built on top of Rule.
|
|
297
278
|
* **`simplibs-types`** *(in progress)* — reusable, named validated types (`Annotated[type,
|
|
298
279
|
Rule]` combinations) built on `Rule`, for sharing a single constraint definition across
|
|
299
280
|
many annotations.
|
|
@@ -106,7 +106,10 @@ from .predicates.strings import (
|
|
|
106
106
|
IsAscii,
|
|
107
107
|
IsLowercase,
|
|
108
108
|
IsUppercase,
|
|
109
|
-
IsTitlecase
|
|
109
|
+
IsTitlecase,
|
|
110
|
+
IsIdentifier,
|
|
111
|
+
IsPrintable,
|
|
112
|
+
IsWhitespace,
|
|
110
113
|
)
|
|
111
114
|
|
|
112
115
|
# Predicates — typing
|
|
@@ -118,9 +121,6 @@ from .predicates.typing import (
|
|
|
118
121
|
is_supported_annotation
|
|
119
122
|
)
|
|
120
123
|
|
|
121
|
-
# Tools
|
|
122
|
-
from .tools import raise_invalid
|
|
123
|
-
|
|
124
124
|
|
|
125
125
|
# ============================================================================
|
|
126
126
|
# Rule shortcuts
|
|
@@ -241,6 +241,9 @@ is_ascii = IsAscii()
|
|
|
241
241
|
is_lowercase = IsLowercase()
|
|
242
242
|
is_uppercase = IsUppercase()
|
|
243
243
|
is_titlecase = IsTitlecase()
|
|
244
|
+
is_identifier = IsIdentifier()
|
|
245
|
+
is_printable = IsPrintable()
|
|
246
|
+
is_whitespace = IsWhitespace()
|
|
244
247
|
|
|
245
248
|
# ---- predicates/typing -------------------------------------------------------
|
|
246
249
|
|
|
@@ -346,6 +349,9 @@ rule_class = SimpleNamespace(
|
|
|
346
349
|
IsLowercase=IsLowercase,
|
|
347
350
|
IsUppercase=IsUppercase,
|
|
348
351
|
IsTitlecase=IsTitlecase,
|
|
352
|
+
IsIdentifier=IsIdentifier,
|
|
353
|
+
IsPrintable=IsPrintable,
|
|
354
|
+
IsWhitespace=IsWhitespace,
|
|
349
355
|
|
|
350
356
|
# typing
|
|
351
357
|
IsAny=IsAny,
|
|
@@ -458,6 +464,9 @@ rules = SimpleNamespace(
|
|
|
458
464
|
is_lowercase=is_lowercase,
|
|
459
465
|
is_uppercase=is_uppercase,
|
|
460
466
|
is_titlecase=is_titlecase,
|
|
467
|
+
is_identifier=is_identifier,
|
|
468
|
+
is_printable=is_printable,
|
|
469
|
+
is_whitespace=is_whitespace,
|
|
461
470
|
|
|
462
471
|
# typing
|
|
463
472
|
always_false=always_false,
|
|
@@ -562,6 +571,9 @@ __all__ = [
|
|
|
562
571
|
"IsLowercase",
|
|
563
572
|
"IsUppercase",
|
|
564
573
|
"IsTitlecase",
|
|
574
|
+
"IsIdentifier",
|
|
575
|
+
"IsPrintable",
|
|
576
|
+
"IsWhitespace",
|
|
565
577
|
|
|
566
578
|
# typing
|
|
567
579
|
"IsAny",
|
|
@@ -570,9 +582,6 @@ __all__ = [
|
|
|
570
582
|
"get_supported_origins",
|
|
571
583
|
"is_supported_annotation",
|
|
572
584
|
|
|
573
|
-
# tools
|
|
574
|
-
"raise_invalid",
|
|
575
|
-
|
|
576
585
|
# shortcuts
|
|
577
586
|
"all_of",
|
|
578
587
|
"any_of",
|
|
@@ -654,6 +663,9 @@ __all__ = [
|
|
|
654
663
|
"is_lowercase",
|
|
655
664
|
"is_uppercase",
|
|
656
665
|
"is_titlecase",
|
|
666
|
+
"is_identifier",
|
|
667
|
+
"is_printable",
|
|
668
|
+
"is_whitespace",
|
|
657
669
|
"is_typing",
|
|
658
670
|
"always_false",
|
|
659
671
|
"always_true",
|
|
@@ -924,6 +936,9 @@ are compound names rather than the keywords themselves.
|
|
|
924
936
|
| `regex` | `pattern` | Regex search finds a match in the string. |
|
|
925
937
|
| `starts_with` | `prefix` | Value starts with the prefix. |
|
|
926
938
|
| `is_substring_of` | `target_string` | String value must be a substring of a target string. |
|
|
939
|
+
| `is_identifier` | — | String is a valid Python identifier. |
|
|
940
|
+
| `is_printable` | — | String consists entirely of printable characters. |
|
|
941
|
+
| `is_whitespace` | — | String consists entirely of whitespace (non-empty). |
|
|
927
942
|
|
|
928
943
|
|
|
929
944
|
### `typing/`
|
|
@@ -935,9 +950,4 @@ are compound names rather than the keywords themselves.
|
|
|
935
950
|
| `is_any` | — | Alias for `always_true` (accepts any value). |
|
|
936
951
|
| `is_typing` | `annotation` | Value must satisfy the given typing annotation. |
|
|
937
952
|
|
|
938
|
-
## 6. Tools (`tools/`)
|
|
939
|
-
Provides execution utilities for direct exception management and control flow optimization:
|
|
940
|
-
- `raise_invalid`: Directly builds and triggers a structured `ValidationError` for
|
|
941
|
-
a failed `Rule` or plain callable predicate. Used in "happy path" control flow guards
|
|
942
|
-
where a condition failure has already been determined inline, avoiding redundant rule re-evaluation.
|
|
943
953
|
"""
|
|
@@ -0,0 +1,24 @@
|
|
|
1
|
+
_DESIGN_NOTES = """
|
|
2
|
+
# Predicates Sub-Package
|
|
3
|
+
|
|
4
|
+
## Purpose
|
|
5
|
+
Root registry and re-export point for all single-purpose atomic rules (predicates).
|
|
6
|
+
Predicates represent single, non-composite assertions evaluated directly against an
|
|
7
|
+
input value or its structural properties.
|
|
8
|
+
|
|
9
|
+
## Sub-Packages Registry
|
|
10
|
+
|
|
11
|
+
| Sub-Package | Focus Area / Responsibility |
|
|
12
|
+
| :----------------- | :---------------------------------------------------------------------------------- |
|
|
13
|
+
| `arithmetic` | Mathematical calculations and properties (tolerances, divisibility, remainders). |
|
|
14
|
+
| `checkers` | Parameterless boolean, identity, and emptiness state assertions. |
|
|
15
|
+
| `collections` | Structure and contents of containers, sets, sequences, and mappings. |
|
|
16
|
+
| `comparisons` | Value-based relational operators (equality, inequality, order, numeric ranges). |
|
|
17
|
+
| `introspection` | Structural inspection of types, interfaces, attributes, callable states, and `len`. |
|
|
18
|
+
| `logic` | Core identity (`is`) and collection membership (`in`) assertions with strict flags. |
|
|
19
|
+
| `numeric` | Specific numeric domain type checks, non-finite values (`NaN`, `inf`), and `bool`. |
|
|
20
|
+
| `strings` | Textual contents, pattern matching, prefix/suffix checks, and whitespace states. |
|
|
21
|
+
| `_helpers` | Internal shared utilities for diagnostic rendering and predicate calculation logic. |
|
|
22
|
+
| `_init_validators` | Internal constructor assertion routines ensuring valid parameter boundaries. |
|
|
23
|
+
|
|
24
|
+
"""
|
|
@@ -0,0 +1,100 @@
|
|
|
1
|
+
from typing import Any
|
|
2
|
+
from simplibs.exception import ValidationError
|
|
3
|
+
# Outers
|
|
4
|
+
from ...base_class import Rule
|
|
5
|
+
|
|
6
|
+
|
|
7
|
+
class IsIdentifier(Rule):
|
|
8
|
+
"""String value must be a valid Python identifier.
|
|
9
|
+
|
|
10
|
+
Rule:
|
|
11
|
+
value.isidentifier()
|
|
12
|
+
|
|
13
|
+
Example:
|
|
14
|
+
validate(value, IsIdentifier())
|
|
15
|
+
"""
|
|
16
|
+
|
|
17
|
+
__slots__ = ()
|
|
18
|
+
|
|
19
|
+
# ----------------------------------------------------------------------
|
|
20
|
+
# Rule definition
|
|
21
|
+
# ----------------------------------------------------------------------
|
|
22
|
+
def is_valid(self, value: Any) -> bool:
|
|
23
|
+
|
|
24
|
+
# 1. Evaluate the type and identifier validity
|
|
25
|
+
return (
|
|
26
|
+
|
|
27
|
+
# 1.1 Check that the value is of type str
|
|
28
|
+
isinstance(value, str)
|
|
29
|
+
|
|
30
|
+
# 1.2 Check that the value is a valid Python identifier
|
|
31
|
+
and value.isidentifier()
|
|
32
|
+
)
|
|
33
|
+
|
|
34
|
+
# ----------------------------------------------------------------------
|
|
35
|
+
# Exception definition
|
|
36
|
+
# ----------------------------------------------------------------------
|
|
37
|
+
def build_exception(
|
|
38
|
+
self,
|
|
39
|
+
value: Any,
|
|
40
|
+
value_name: str | None = None,
|
|
41
|
+
context: str | None = None,
|
|
42
|
+
) -> Exception:
|
|
43
|
+
|
|
44
|
+
# 1. Prepare data
|
|
45
|
+
# 1.1 When value is not a string
|
|
46
|
+
if not isinstance(value, str):
|
|
47
|
+
problem = f"Value {value!r} of type '{type(value).__name__}' is not a string."
|
|
48
|
+
how_to_fix = "Provide a string value."
|
|
49
|
+
exception_type = TypeError
|
|
50
|
+
|
|
51
|
+
# 1.2 When the string is not a valid Python identifier
|
|
52
|
+
else:
|
|
53
|
+
problem = f"Value {value!r} is not a valid Python identifier."
|
|
54
|
+
how_to_fix = "Provide a valid Python identifier string (e.g. 'my_var', 'foo1')."
|
|
55
|
+
exception_type = ValueError
|
|
56
|
+
|
|
57
|
+
# 2. Build the exception
|
|
58
|
+
return ValidationError(
|
|
59
|
+
error_name="IS_IDENTIFIER_ERROR",
|
|
60
|
+
label=value_name,
|
|
61
|
+
expected="a valid Python identifier string",
|
|
62
|
+
value=value,
|
|
63
|
+
problem=problem,
|
|
64
|
+
context=context,
|
|
65
|
+
how_to_fix=how_to_fix,
|
|
66
|
+
exception=exception_type,
|
|
67
|
+
)
|
|
68
|
+
|
|
69
|
+
|
|
70
|
+
# ----------------------------------------------------------------------
|
|
71
|
+
# Helper function for internal validation across the project
|
|
72
|
+
# ----------------------------------------------------------------------
|
|
73
|
+
is_identifier = IsIdentifier().is_valid
|
|
74
|
+
|
|
75
|
+
|
|
76
|
+
_DESIGN_NOTES = """
|
|
77
|
+
# IsIdentifier — Python Identifier Validation Rule
|
|
78
|
+
|
|
79
|
+
## Purpose
|
|
80
|
+
The `IsIdentifier` rule validates that a string is a valid Python identifier
|
|
81
|
+
via Python's native `str.isidentifier()`.
|
|
82
|
+
|
|
83
|
+
---
|
|
84
|
+
|
|
85
|
+
## 1. Execution Rationale & Safeguards
|
|
86
|
+
|
|
87
|
+
* **Unicode-Aware:**
|
|
88
|
+
`str.isidentifier()` follows Python 3 rules for valid identifiers, including
|
|
89
|
+
Unicode characters valid in variable names.
|
|
90
|
+
* **Empty String & Keywords:**
|
|
91
|
+
`"".isidentifier()` returns `False`. Python language keywords (like `def`, `class`)
|
|
92
|
+
return `True` under `str.isidentifier()`.
|
|
93
|
+
|
|
94
|
+
---
|
|
95
|
+
|
|
96
|
+
## 2. Exception Card Design
|
|
97
|
+
|
|
98
|
+
* **Dual Diagnostic Path:** `TypeError` when the value isn't a string at all;
|
|
99
|
+
`ValueError` (`IS_IDENTIFIER_ERROR`) when it is a string but fails the identifier check.
|
|
100
|
+
"""
|
|
@@ -0,0 +1,99 @@
|
|
|
1
|
+
from typing import Any
|
|
2
|
+
from simplibs.exception import ValidationError
|
|
3
|
+
# Outers
|
|
4
|
+
from ...base_class import Rule
|
|
5
|
+
|
|
6
|
+
|
|
7
|
+
class IsPrintable(Rule):
|
|
8
|
+
"""String value must consist entirely of printable characters.
|
|
9
|
+
|
|
10
|
+
Rule:
|
|
11
|
+
value.isprintable()
|
|
12
|
+
|
|
13
|
+
Example:
|
|
14
|
+
validate(value, IsPrintable())
|
|
15
|
+
"""
|
|
16
|
+
|
|
17
|
+
__slots__ = ()
|
|
18
|
+
|
|
19
|
+
# ----------------------------------------------------------------------
|
|
20
|
+
# Rule definition
|
|
21
|
+
# ----------------------------------------------------------------------
|
|
22
|
+
def is_valid(self, value: Any) -> bool:
|
|
23
|
+
|
|
24
|
+
# 1. Evaluate the type and printable content
|
|
25
|
+
return (
|
|
26
|
+
|
|
27
|
+
# 1.1 Check that the value is of type str
|
|
28
|
+
isinstance(value, str)
|
|
29
|
+
|
|
30
|
+
# 1.2 Check that every character is printable (accepts empty string "")
|
|
31
|
+
and value.isprintable()
|
|
32
|
+
)
|
|
33
|
+
|
|
34
|
+
# ----------------------------------------------------------------------
|
|
35
|
+
# Exception definition
|
|
36
|
+
# ----------------------------------------------------------------------
|
|
37
|
+
def build_exception(
|
|
38
|
+
self,
|
|
39
|
+
value: Any,
|
|
40
|
+
value_name: str | None = None,
|
|
41
|
+
context: str | None = None,
|
|
42
|
+
) -> Exception:
|
|
43
|
+
|
|
44
|
+
# 1. Prepare data
|
|
45
|
+
# 1.1 When value is not a string
|
|
46
|
+
if not isinstance(value, str):
|
|
47
|
+
problem = f"Value {value!r} of type '{type(value).__name__}' is not a string."
|
|
48
|
+
how_to_fix = "Provide a string value."
|
|
49
|
+
exception_type = TypeError
|
|
50
|
+
|
|
51
|
+
# 1.2 When the string contains unprintable characters
|
|
52
|
+
else:
|
|
53
|
+
problem = f"Value {value!r} contains unprintable or control characters."
|
|
54
|
+
how_to_fix = "Provide a string containing only printable characters."
|
|
55
|
+
exception_type = ValueError
|
|
56
|
+
|
|
57
|
+
# 2. Build the exception
|
|
58
|
+
return ValidationError(
|
|
59
|
+
error_name="IS_PRINTABLE_ERROR",
|
|
60
|
+
label=value_name,
|
|
61
|
+
expected="a printable string (no control characters)",
|
|
62
|
+
value=value,
|
|
63
|
+
problem=problem,
|
|
64
|
+
context=context,
|
|
65
|
+
how_to_fix=how_to_fix,
|
|
66
|
+
exception=exception_type,
|
|
67
|
+
)
|
|
68
|
+
|
|
69
|
+
|
|
70
|
+
# ----------------------------------------------------------------------
|
|
71
|
+
# Helper function for internal validation across the project
|
|
72
|
+
# ----------------------------------------------------------------------
|
|
73
|
+
is_printable = IsPrintable().is_valid
|
|
74
|
+
|
|
75
|
+
|
|
76
|
+
_DESIGN_NOTES = """
|
|
77
|
+
# IsPrintable — Printable String Validation Rule
|
|
78
|
+
|
|
79
|
+
## Purpose
|
|
80
|
+
The `IsPrintable` rule validates that a string consists entirely of printable
|
|
81
|
+
characters via Python's native `str.isprintable()`.
|
|
82
|
+
|
|
83
|
+
---
|
|
84
|
+
|
|
85
|
+
## 1. Execution Rationale & Safeguards
|
|
86
|
+
|
|
87
|
+
* **Empty String Accepted:**
|
|
88
|
+
`"".isprintable()` returns `True` in Python.
|
|
89
|
+
* **Control Characters Rejected:**
|
|
90
|
+
Characters considered non-printable (such as unescaped control codes like `\x00`)
|
|
91
|
+
will cause validation to fail.
|
|
92
|
+
|
|
93
|
+
---
|
|
94
|
+
|
|
95
|
+
## 2. Exception Card Design
|
|
96
|
+
|
|
97
|
+
* **Dual Diagnostic Path:** `TypeError` when the value isn't a string at all;
|
|
98
|
+
`ValueError` (`IS_PRINTABLE_ERROR`) when it is a string but contains unprintable characters.
|
|
99
|
+
"""
|
|
@@ -0,0 +1,99 @@
|
|
|
1
|
+
from typing import Any
|
|
2
|
+
from simplibs.exception import ValidationError
|
|
3
|
+
# Outers
|
|
4
|
+
from ...base_class import Rule
|
|
5
|
+
|
|
6
|
+
|
|
7
|
+
class IsWhitespace(Rule):
|
|
8
|
+
"""String value must consist entirely of whitespace characters.
|
|
9
|
+
|
|
10
|
+
Rule:
|
|
11
|
+
value.isspace()
|
|
12
|
+
|
|
13
|
+
Example:
|
|
14
|
+
validate(value, IsWhitespace())
|
|
15
|
+
"""
|
|
16
|
+
|
|
17
|
+
__slots__ = ()
|
|
18
|
+
|
|
19
|
+
# ----------------------------------------------------------------------
|
|
20
|
+
# Rule definition
|
|
21
|
+
# ----------------------------------------------------------------------
|
|
22
|
+
def is_valid(self, value: Any) -> bool:
|
|
23
|
+
|
|
24
|
+
# 1. Evaluate the type and whitespace content
|
|
25
|
+
return (
|
|
26
|
+
|
|
27
|
+
# 1.1 Check that the value is of type str
|
|
28
|
+
isinstance(value, str)
|
|
29
|
+
|
|
30
|
+
# 1.2 Check that every character is whitespace (also rejects "")
|
|
31
|
+
and value.isspace()
|
|
32
|
+
)
|
|
33
|
+
|
|
34
|
+
# ----------------------------------------------------------------------
|
|
35
|
+
# Exception definition
|
|
36
|
+
# ----------------------------------------------------------------------
|
|
37
|
+
def build_exception(
|
|
38
|
+
self,
|
|
39
|
+
value: Any,
|
|
40
|
+
value_name: str | None = None,
|
|
41
|
+
context: str | None = None,
|
|
42
|
+
) -> Exception:
|
|
43
|
+
|
|
44
|
+
# 1. Prepare data
|
|
45
|
+
# 1.1 When value is not a string
|
|
46
|
+
if not isinstance(value, str):
|
|
47
|
+
problem = f"Value {value!r} of type '{type(value).__name__}' is not a string."
|
|
48
|
+
how_to_fix = "Provide a string value."
|
|
49
|
+
exception_type = TypeError
|
|
50
|
+
|
|
51
|
+
# 1.2 When the string contains non-whitespace characters (or is empty)
|
|
52
|
+
else:
|
|
53
|
+
problem = f"Value {value!r} contains non-whitespace characters or is empty."
|
|
54
|
+
how_to_fix = "Provide a non-empty string consisting only of whitespace characters."
|
|
55
|
+
exception_type = ValueError
|
|
56
|
+
|
|
57
|
+
# 2. Build the exception
|
|
58
|
+
return ValidationError(
|
|
59
|
+
error_name="IS_WHITESPACE_ERROR",
|
|
60
|
+
label=value_name,
|
|
61
|
+
expected="a non-empty, purely whitespace string",
|
|
62
|
+
value=value,
|
|
63
|
+
problem=problem,
|
|
64
|
+
context=context,
|
|
65
|
+
how_to_fix=how_to_fix,
|
|
66
|
+
exception=exception_type,
|
|
67
|
+
)
|
|
68
|
+
|
|
69
|
+
|
|
70
|
+
# ----------------------------------------------------------------------
|
|
71
|
+
# Helper function for internal validation across the project
|
|
72
|
+
# ----------------------------------------------------------------------
|
|
73
|
+
is_whitespace = IsWhitespace().is_valid
|
|
74
|
+
|
|
75
|
+
|
|
76
|
+
_DESIGN_NOTES = """
|
|
77
|
+
# IsWhitespace — Whitespace String Validation Rule
|
|
78
|
+
|
|
79
|
+
## Purpose
|
|
80
|
+
The `IsWhitespace` rule validates that a string consists entirely of whitespace
|
|
81
|
+
characters via Python's native `str.isspace()`.
|
|
82
|
+
|
|
83
|
+
---
|
|
84
|
+
|
|
85
|
+
## 1. Execution Rationale & Safeguards
|
|
86
|
+
|
|
87
|
+
* **Empty String Rejected:**
|
|
88
|
+
`"".isspace()` returns `False` in Python — this rule inherits that behavior directly.
|
|
89
|
+
* **Unicode Whitespace:**
|
|
90
|
+
`str.isspace()` accepts spaces, tabs (`\t`), newlines (`\n`), carriage returns (`\r`),
|
|
91
|
+
and all Unicode whitespace characters.
|
|
92
|
+
|
|
93
|
+
---
|
|
94
|
+
|
|
95
|
+
## 2. Exception Card Design
|
|
96
|
+
|
|
97
|
+
* **Dual Diagnostic Path:** `TypeError` when the value isn't a string at all;
|
|
98
|
+
`ValueError` (`IS_WHITESPACE_ERROR`) when it is a string but fails the whitespace check.
|
|
99
|
+
"""
|
{simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/strings/__init__.py
RENAMED
|
@@ -13,6 +13,9 @@ from .IsAscii import IsAscii
|
|
|
13
13
|
from .IsLowercase import IsLowercase
|
|
14
14
|
from .IsUppercase import IsUppercase
|
|
15
15
|
from .IsTitlecase import IsTitlecase
|
|
16
|
+
from .IsIdentifier import IsIdentifier, is_identifier
|
|
17
|
+
from .IsPrintable import IsPrintable, is_printable
|
|
18
|
+
from .IsWhitespace import IsWhitespace, is_whitespace
|
|
16
19
|
|
|
17
20
|
|
|
18
21
|
_DESIGN_NOTES = """
|
|
@@ -41,4 +44,7 @@ and affix checks, and blank/non-blank content checks.
|
|
|
41
44
|
| `IsLowercase` | Class | String must be entirely lowercase (with at least one cased character). |
|
|
42
45
|
| `IsUppercase` | Class | String must be entirely uppercase (with at least one cased character). |
|
|
43
46
|
| `IsTitlecase` | Class | String must be title-cased. |
|
|
47
|
+
| `IsIdentifier` | Class | String must be a valid Python identifier. |
|
|
48
|
+
| `IsPrintable` | Class | String must consist entirely of printable characters. |
|
|
49
|
+
| `IsWhitespace` | Class | String must consist entirely of whitespace characters (non-empty). |
|
|
44
50
|
"""
|
|
@@ -5,7 +5,6 @@ from .asserts import (
|
|
|
5
5
|
assert_rule_build_exception,
|
|
6
6
|
assert_rule_is_valid,
|
|
7
7
|
assert_rule_param_error,
|
|
8
|
-
assert_rule_raise_invalid,
|
|
9
8
|
assert_rule_validate,
|
|
10
9
|
)
|
|
11
10
|
|
|
@@ -14,7 +13,6 @@ __all__ = [
|
|
|
14
13
|
"assert_rule_build_exception",
|
|
15
14
|
"assert_rule_is_valid",
|
|
16
15
|
"assert_rule_param_error",
|
|
17
|
-
"assert_rule_raise_invalid",
|
|
18
16
|
"assert_rule_validate",
|
|
19
17
|
]
|
|
20
18
|
|
|
@@ -35,6 +33,5 @@ implementations across the library ecosystem.
|
|
|
35
33
|
| `assert_rule_build_exception` | Function | Verifies that `build_exception()` yields expected `ValidationError` cards. |
|
|
36
34
|
| `assert_rule_is_valid` | Function | Asserts boolean `is_valid()` results across valid and invalid inputs. |
|
|
37
35
|
| `assert_rule_param_error` | Function | Verifies that rule instantiation fails properly on invalid init arguments. |
|
|
38
|
-
| `assert_rule_raise_invalid` | Function | Verifies that `raise_invalid()` raises the expected `ValidationError`. |
|
|
39
36
|
| `assert_rule_validate` | Function | Verifies `validate()` execution, pass-through return values, and errors. |
|
|
40
37
|
"""
|