release 2.21

Author: loyada

docs/structures.rst

@@ -917,6 +917,22 @@ This is done by calling the class method "from_trusted_data". For example:
 The method "from_trusted_data" is similar to "from_other_class" method, but is much faster, since it bypasses the
 validation. The difference in speed is x10-x25, based on the complexity of the Structure.
 
+Another option is to declare that instantiation of this Structure should always trust the input, and then
+any following instantiation will shortcut the validation logic. It has the same effect as "from_trusted_data".
+
+.. code-block:: python
+
+    Person.trust_supplied_values(True)
+
+    # this will be fast...
+    person = Person(
+        first_name=f"joe-1",
+        last_name="smith",
+        role=Role.admin,
+        ....
+    )
+
+
 
 Global Defaults
 ===============

setup.py

@@ -46,9 +46,9 @@
     license="MIT",
     long_description=long_description,
     url="http://github.com/loyada/typedpy",
-    download_url="https://github.com/loyada/typedpy/archive/v2.20.4.tar.gz",
+    download_url="https://github.com/loyada/typedpy/archive/v2.21.1.tar.gz",
     keywords=["testing", "type-safe", "strict", "schema", "validation"],
-    version="2.20.4",
+    version="2.21.1",
 )
 
 # coverage run --source=typedpy/ setup.py test

tests/test_trusted_instantiation.py

@@ -150,6 +150,19 @@ def test_nested_trusted_instantiation():
     assert employee == trusted_employee
 
 
+def test_trusted_instantiation_different_style():
+    start = time.time()
+    validated_policies = build_policies(hard_limit=20, codes=[1, 2, 3], time_days=7)
+    time_1 = time.time()
+    Policy.trust_supplied_values(True)
+    fast_policies = build_policies(hard_limit=20, codes=[1, 2, 3], time_days=7)
+    time_2 = time.time()
+    print(f"validated policies took: {time_1 - start}")
+    print(f"fast policies took: {time_2 - time_1}")
+    print(f"ratio: {(time_1 - start) / (time_2 - time_1)}")
+    assert validated_policies == fast_policies
+
+
 def test_nested_trusted_instantiation_with_dict():
     employee = create_employee()
     trusted_employee = Employee.from_trusted_data(employee.to_other_class(dict))