liminal-orm 2.0.2__py3-none-any.whl → 2.0.3__py3-none-any.whl

liminal/validation/__init__.py

@@ -1,4 +1,3 @@
-import inspect
 from datetime import datetime
 from functools import partial, wraps
 from typing import TYPE_CHECKING, Any, Callable
@@ -101,24 +100,33 @@ class BenchlingValidatorReport(BaseModel):
         )
 
 
-def _liminal_decorator(
-    func: Callable[[type["BenchlingBaseModel"]], BenchlingValidatorReport | None],
-    validator_level: ValidationSeverity,
-    validator_name: str | None,
+def liminal_validator(
+    func: Callable[["BenchlingBaseModel"], BenchlingValidatorReport | None]
+    | None = None,
+    *,
+    validator_level: ValidationSeverity = ValidationSeverity.LOW,
+    validator_name: str | None = None,
 ) -> Callable:
-    """Core decorator logic for liminal_validator."""
-    sig = inspect.signature(func)
-    params = list(sig.parameters.values())
-    if not params or params[0].name != "self" or len(params) > 1:
-        raise TypeError(
-            "Validator must be defined in a schema class, where the only argument to this validator must be 'self'."
-        )
+    """A decorator for a function that validates a Benchling entity, defined on a schema class.
+    Can be used with or without parameters. Wraps around any exceptions raised by the validator function,
+    and returns a BenchlingValidatorReport.
 
-    if validator_name is None:
-        validator_name = pascalize(func.__name__)
+    Parameters
+    ----------
+    validator_level: ValidationSeverity
+        The severity level of the validation report. Defaults to ValidationSeverity.LOW.
+    validator_name: str | None
+        The name of the validator. Defaults to the PascalCase version of the function name.
+    """
+    if func is None:
+        return partial(
+            liminal_validator,
+            validator_level=validator_level,
+            validator_name=validator_name,
+        )
 
     @wraps(func)
-    def wrapper(self: type["BenchlingBaseModel"]) -> BenchlingValidatorReport:
+    def wrapper(self: "BenchlingBaseModel") -> BenchlingValidatorReport:
         """Wrapper that runs the validator function and returns a BenchlingValidatorReport."""
         try:
             ret_val = func(self)
@@ -129,36 +137,15 @@ def _liminal_decorator(
                 valid=False,
                 level=validator_level,
                 entity=self,
-                validator_name=validator_name,
+                validator_name=validator_name or pascalize(func.__name__),
                 message=str(e),
             )
         return BenchlingValidatorReport.create_validation_report(
             valid=True,
             level=validator_level,
             entity=self,
-            validator_name=validator_name,
+            validator_name=validator_name or pascalize(func.__name__),
         )
 
     setattr(wrapper, "_is_liminal_validator", True)
     return wrapper
-
-
-def liminal_validator(
-    validator_level: ValidationSeverity = ValidationSeverity.LOW,
-    validator_name: str | None = None,
-) -> Callable:
-    """A decorator for a function that validates a Benchling entity, defined on a schema class.
-    Wraps around any exceptions raised by the validator function, and returns a BenchlingValidatorReport.
-
-    Parameters
-    ----------
-    validator_level: ValidationSeverity
-        The severity level of the validation report. Defaults to ValidationSeverity.LOW.
-    validator_name: str | None =
-        The name of the validator. Defaults to the PascalCase version of the function name.
-    """
-    return partial(
-        _liminal_decorator,
-        validator_level=validator_level,
-        validator_name=validator_name,
-    )

{liminal_orm-2.0.2.dist-info → liminal_orm-2.0.3.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: liminal-orm
-Version: 2.0.2
+Version: 2.0.3
 Summary: An ORM and toolkit that builds on top of Benchling's platform to keep your schemas and downstream code dependencies in sync.
 Home-page: https://github.com/dynotx/liminal-orm
 Author: DynoTx Open Source

{liminal_orm-2.0.2.dist-info → liminal_orm-2.0.3.dist-info}/RECORD

@@ -59,10 +59,10 @@ liminal/tests/from benchling_sdk.py,sha256=CjRUHFB3iaa4rUPLGOqDiBq5EPKldm-Fd8aQQ
 liminal/tests/test_dropdown_compare.py,sha256=yHB0ovQlBLRu8-qYkqIPd8VtYEOmOft_93FQM86g_z8,8198
 liminal/tests/test_entity_schema_compare.py,sha256=-26Bu5eYIuHRswB5kYjGDo5Wed5LUWjm1e6IRI1Q-lE,18952
 liminal/utils.py,sha256=radRtRsZmCiNblMvxOX1DH0rcO5TR09kFlp6OONIPBU,2951
-liminal/validation/__init__.py,sha256=aMxO1vcZ_1Ay1Br0BCEEc09xge8-g5TL1sJ0KHbtRM8,5684
+liminal/validation/__init__.py,sha256=TVaHrSF3GnSd4mbZrPn8TBHscGWkAPKAUUPq7-symC8,5275
 liminal/validation/validation_severity.py,sha256=ib03PTZCQHcbBDc01v4gJF53YtA-ANY6QSFnhTV-FbU,259
-liminal_orm-2.0.2.dist-info/LICENSE.md,sha256=oVA877F_D1AV44dpjsv4f-4k690uNGApX1EtzOo3T8U,11353
-liminal_orm-2.0.2.dist-info/METADATA,sha256=xOqcfpE7GSkUtmzLq_aNi8xGC74QEmKgK1Ki50przG4,11032
-liminal_orm-2.0.2.dist-info/WHEEL,sha256=Nq82e9rUAnEjt98J6MlVmMCZb-t9cYE2Ir1kpBmnWfs,88
-liminal_orm-2.0.2.dist-info/entry_points.txt,sha256=atIrU63rrzH81dWC2sjUbFLlc5FWMmYRdMxXEWexIZA,47
-liminal_orm-2.0.2.dist-info/RECORD,,
+liminal_orm-2.0.3.dist-info/LICENSE.md,sha256=oVA877F_D1AV44dpjsv4f-4k690uNGApX1EtzOo3T8U,11353
+liminal_orm-2.0.3.dist-info/METADATA,sha256=Gq7H7QpXrTZouxJAvjnHQA_iCL95i8FcDuAUWLJKvMk,11032
+liminal_orm-2.0.3.dist-info/WHEEL,sha256=Nq82e9rUAnEjt98J6MlVmMCZb-t9cYE2Ir1kpBmnWfs,88
+liminal_orm-2.0.3.dist-info/entry_points.txt,sha256=atIrU63rrzH81dWC2sjUbFLlc5FWMmYRdMxXEWexIZA,47
+liminal_orm-2.0.3.dist-info/RECORD,,