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.
Files changed (160) hide show
  1. {simplibs_rules-0.1.0/src/simplibs_rules.egg-info → simplibs_rules-0.2.1}/PKG-INFO +6 -25
  2. {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/README.md +5 -24
  3. {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/pyproject.toml +1 -1
  4. {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/__init__.py +22 -12
  5. simplibs_rules-0.2.1/src/simplibs/rules/predicates/__init__.py +24 -0
  6. simplibs_rules-0.2.1/src/simplibs/rules/predicates/strings/IsIdentifier.py +100 -0
  7. simplibs_rules-0.2.1/src/simplibs/rules/predicates/strings/IsPrintable.py +99 -0
  8. simplibs_rules-0.2.1/src/simplibs/rules/predicates/strings/IsWhitespace.py +99 -0
  9. {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/strings/__init__.py +6 -0
  10. {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/testing/__init__.py +0 -3
  11. {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/testing/assert_rule_contract.py +7 -48
  12. {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/testing/asserts/__init__.py +1 -4
  13. {simplibs_rules-0.1.0 → simplibs_rules-0.2.1/src/simplibs_rules.egg-info}/PKG-INFO +6 -25
  14. {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs_rules.egg-info/SOURCES.txt +3 -3
  15. simplibs_rules-0.1.0/src/simplibs/rules/predicates/__init__.py +0 -103
  16. simplibs_rules-0.1.0/src/simplibs/rules/testing/asserts/assert_rule_raise_invalid.py +0 -91
  17. simplibs_rules-0.1.0/src/simplibs/rules/tools/__init__.py +0 -16
  18. simplibs_rules-0.1.0/src/simplibs/rules/tools/raise_invalid.py +0 -84
  19. {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/LICENSE +0 -0
  20. {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/setup.cfg +0 -0
  21. {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/base_class/Rule.py +0 -0
  22. {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/base_class/_NotARule.py +0 -0
  23. {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/base_class/__init__.py +0 -0
  24. {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/containers/AllOf.py +0 -0
  25. {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/containers/AnyOf.py +0 -0
  26. {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/containers/Compose.py +0 -0
  27. {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/containers/ForEach.py +0 -0
  28. {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/containers/NoneOf.py +0 -0
  29. {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/containers/Not.py +0 -0
  30. {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/containers/__init__.py +0 -0
  31. {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/containers/_helpers/__init__.py +0 -0
  32. {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/containers/_helpers/as_predicate.py +0 -0
  33. {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/containers/_helpers/build_child_exception.py +0 -0
  34. {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/containers/_helpers/describe_rule.py +0 -0
  35. {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/containers/_helpers/validations/__init__.py +0 -0
  36. {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/containers/_helpers/validations/raise_invalid_predicate.py +0 -0
  37. {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/containers/_init_validators/__init__.py +0 -0
  38. {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
  39. {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
  40. {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/containers/_init_validators/raise_rule_param_not_callable.py +0 -0
  41. {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/containers/_init_validators/validate_compose_param_is_callable.py +0 -0
  42. {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/_helpers/__init__.py +0 -0
  43. {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/_helpers/accepts_one_positional_argument.py +0 -0
  44. {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/_helpers/format_container.py +0 -0
  45. {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/_init_validators/__init__.py +0 -0
  46. {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/_init_validators/rule_errors/__init__.py +0 -0
  47. {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
  48. {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
  49. {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
  50. {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/_init_validators/shared_errors/__init__.py +0 -0
  51. {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
  52. {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
  53. {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
  54. {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
  55. {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
  56. {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
  57. {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
  58. {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
  59. {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/_init_validators/shared_validators/__init__.py +0 -0
  60. {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
  61. {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
  62. {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
  63. {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
  64. {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/arithmetic/CloseTo.py +0 -0
  65. {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/arithmetic/DivisibleBy.py +0 -0
  66. {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/arithmetic/HasRemainder.py +0 -0
  67. {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/arithmetic/__init__.py +0 -0
  68. {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/checkers/IsEmpty.py +0 -0
  69. {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/checkers/IsFalse.py +0 -0
  70. {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/checkers/IsNone.py +0 -0
  71. {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/checkers/IsTrue.py +0 -0
  72. {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/checkers/NotEmpty.py +0 -0
  73. {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/checkers/__init__.py +0 -0
  74. {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/collections/AllUnique.py +0 -0
  75. {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/collections/HasItem.py +0 -0
  76. {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/collections/HasKey.py +0 -0
  77. {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/collections/HasKeys.py +0 -0
  78. {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/collections/IsContainer.py +0 -0
  79. {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/collections/IsSubsetOf.py +0 -0
  80. {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/collections/IsSupersetOf.py +0 -0
  81. {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/collections/__init__.py +0 -0
  82. {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/comparisons/Equals.py +0 -0
  83. {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/comparisons/GreaterOrEqual.py +0 -0
  84. {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/comparisons/GreaterThan.py +0 -0
  85. {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/comparisons/InRange.py +0 -0
  86. {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/comparisons/LessOrEqual.py +0 -0
  87. {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/comparisons/LessThan.py +0 -0
  88. {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/comparisons/NotEquals.py +0 -0
  89. {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/comparisons/__init__.py +0 -0
  90. {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/introspection/HasAttribute.py +0 -0
  91. {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/introspection/HasLength.py +0 -0
  92. {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/introspection/IsCallable.py +0 -0
  93. {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/introspection/IsDataclass.py +0 -0
  94. {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/introspection/IsHashable.py +0 -0
  95. {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/introspection/IsInstance.py +0 -0
  96. {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/introspection/IsIterable.py +0 -0
  97. {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/introspection/IsSubclass.py +0 -0
  98. {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/introspection/IsType.py +0 -0
  99. {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/introspection/__init__.py +0 -0
  100. {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/logic/Is.py +0 -0
  101. {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/logic/IsIn.py +0 -0
  102. {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/logic/IsNot.py +0 -0
  103. {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/logic/NotIn.py +0 -0
  104. {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/logic/UserRule.py +0 -0
  105. {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/logic/__init__.py +0 -0
  106. {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/numeric/IsBool.py +0 -0
  107. {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/numeric/IsDecimal.py +0 -0
  108. {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/numeric/IsEven.py +0 -0
  109. {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/numeric/IsFinite.py +0 -0
  110. {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/numeric/IsFloat.py +0 -0
  111. {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/numeric/IsInfinity.py +0 -0
  112. {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/numeric/IsInteger.py +0 -0
  113. {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/numeric/IsNan.py +0 -0
  114. {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/numeric/IsNumber.py +0 -0
  115. {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/numeric/IsOdd.py +0 -0
  116. {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/numeric/IsPi.py +0 -0
  117. {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/numeric/IsPrimitiveNumber.py +0 -0
  118. {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/numeric/IsZero.py +0 -0
  119. {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/numeric/__init__.py +0 -0
  120. {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/strings/Contains.py +0 -0
  121. {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/strings/EndsWith.py +0 -0
  122. {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/strings/IsAlnum.py +0 -0
  123. {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/strings/IsAlpha.py +0 -0
  124. {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/strings/IsAscii.py +0 -0
  125. {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/strings/IsBlank.py +0 -0
  126. {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/strings/IsDigitString.py +0 -0
  127. {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/strings/IsLowercase.py +0 -0
  128. {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/strings/IsString.py +0 -0
  129. {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/strings/IsSubstringOf.py +0 -0
  130. {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/strings/IsTitlecase.py +0 -0
  131. {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/strings/IsUppercase.py +0 -0
  132. {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/strings/NotBlank.py +0 -0
  133. {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/strings/Regex.py +0 -0
  134. {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/strings/StartsWith.py +0 -0
  135. {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/typing/IsAny.py +0 -0
  136. {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/typing/IsTyping.py +0 -0
  137. {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/typing/__init__.py +0 -0
  138. {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/typing/_builders/ORIGIN_TABLE.py +0 -0
  139. {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/typing/_builders/__init__.py +0 -0
  140. {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/typing/_builders/build_annotated_rule.py +0 -0
  141. {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/typing/_builders/build_any_of_rule.py +0 -0
  142. {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/typing/_builders/build_callable_rule.py +0 -0
  143. {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/typing/_builders/build_elements_rule.py +0 -0
  144. {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/typing/_builders/build_key_value_rule.py +0 -0
  145. {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/typing/_builders/build_literal_rule.py +0 -0
  146. {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/typing/_builders/build_tuple_rule.py +0 -0
  147. {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/typing/_builders/build_type_rule.py +0 -0
  148. {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/typing/_validations/__init__.py +0 -0
  149. {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/typing/_validations/raise_unsupported_annotation_error.py +0 -0
  150. {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/typing/build_typing_rule.py +0 -0
  151. {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/typing/tools/__init__.py +0 -0
  152. {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/typing/tools/get_supported_origins.py +0 -0
  153. {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/predicates/typing/tools/is_supported_annotation.py +0 -0
  154. {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/testing/asserts/assert_rule_build_exception.py +0 -0
  155. {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/testing/asserts/assert_rule_is_valid.py +0 -0
  156. {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/testing/asserts/assert_rule_param_error.py +0 -0
  157. {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs/rules/testing/asserts/assert_rule_validate.py +0 -0
  158. {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs_rules.egg-info/dependency_links.txt +0 -0
  159. {simplibs_rules-0.1.0 → simplibs_rules-0.2.1}/src/simplibs_rules.egg-info/requires.txt +0 -0
  160. {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.0
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
- * **`assert_rule_contract`**: Verifies `is_valid`, direct calling, `validate()` matrix,
303
- return modes, exception generation, and `raise_invalid()` consistency for any `Rule` instance.
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()`/`raise_invalid()` are structured
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 `validate_*` wrappers, and self-validating decorators
323
- (`validate_call`, `validate_dataclass`) built on top of `Rule`. `raise_invalid()`
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
- * **`assert_rule_contract`**: Verifies `is_valid`, direct calling, `validate()` matrix,
275
- return modes, exception generation, and `raise_invalid()` consistency for any `Rule` instance.
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()`/`raise_invalid()` are structured
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 `validate_*` wrappers, and self-validating decorators
295
- (`validate_call`, `validate_dataclass`) built on top of `Rule`. `raise_invalid()`
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.
@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
4
4
 
5
5
  [project]
6
6
  name = "simplibs-rules"
7
- version = "0.1.0"
7
+ version = "0.2.1"
8
8
  description = "Composable, explicit validation rules — pure predicates, zero transformation."
9
9
  readme = "README.md"
10
10
  license = "MIT"
@@ -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
+ """
@@ -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
  """