clear-skies 1.22.0__py3-none-any.whl → 1.22.2__py3-none-any.whl

{clear_skies-1.22.0.dist-info → clear_skies-1.22.2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: clear-skies
-Version: 1.22.0
+Version: 1.22.2
 Summary: A framework for building backends in the cloud
 Home-page: https://github.com/cmancone/clearskies
 License: MIT

{clear_skies-1.22.0.dist-info → clear_skies-1.22.2.dist-info}/RECORD

@@ -1,9 +1,10 @@
 clearskies/__init__.py,sha256=Iz_VxSgiqM6VtGXoUsB_yVKFy_uWvcf071w803wJ8EE,832
 clearskies/application.py,sha256=_gYGIUGdVE5fAS9dwxRZ1gDpDjqGo7-twVt_VxI6XVE,966
-clearskies/authentication/__init__.py,sha256=pHKJOfujgvNAbgzQpKVzEhWORwjAZTE4jKhJ50M7zts,900
+clearskies/authentication/__init__.py,sha256=e8hJ_gKdKn7dIzHe4Hg3jdUYIzGGSr5aJKnQa3zh-MU,997
 clearskies/authentication/auth0_jwks.py,sha256=bzqNaEoG_iPndwttRXuaKpgkDtgOCLAooyifl0I0ACI,4447
 clearskies/authentication/auth_exception.py,sha256=8Tay3Sim2K8vAZ6ldisSJyRyN0cwX7iyGHwfglSKW_A,41
 clearskies/authentication/authorization.py,sha256=eLzBrXMNr1gYoIBZTd8I6uH3R0CfMMjhvimkJt4Amrs,601
+clearskies/authentication/authorization_pass_through.py,sha256=wrRSY0RyRFifeyRgNn9D-3ptCXjPSbytHB8xAyyFSWE,737
 clearskies/authentication/jwks.py,sha256=AOrCkL7pVznTM6mbrQ3RVHCccws0b_yEtqEOe6NRw5k,3368
 clearskies/authentication/jwks_jwcrypto.py,sha256=PqyQNJZY7P98qgdxNltwCWoPxsaWLDqPuMknB4u2mDc,1732
 clearskies/authentication/public.py,sha256=zNpglAILTU7koz22YaGpMOAtTn_dG8dAP4Q9REdbaOk,630
@@ -57,7 +58,7 @@ clearskies/backends/secrets_backend.py,sha256=4lzrgdL_O_pgCT5HknV2gotFgp9GzjQ5_2
 clearskies/binding_config.py,sha256=bF8LBNEgJacwKCqToAtDqN9hv5omzU7zt_4qB9KPtE0,457
 clearskies/column_types/__init__.py,sha256=wofhLfyW00I6tb6o9DMsMx7j9hlbbqefhDzWfw0Row0,4731
 clearskies/column_types/audit.py,sha256=2YcrZVVElpOUdmxYTQ_6CshL1HVou6fz65dOOs_b8Gw,9659
-clearskies/column_types/belongs_to.py,sha256=tH1tbTOfjifSNuVjO-KbMF7GiUIoLfcDItrrS3TGGM8,11044
+clearskies/column_types/belongs_to.py,sha256=E7Wi84vr2PnNw7TBCoZa8jkpwiJhO-iQmZ_ekq26kTs,12206
 clearskies/column_types/boolean.py,sha256=1yyM1CUfgD84pPE65c1OP1Qjf_J0Z45hjPrDR51AUkQ,1878
 clearskies/column_types/category_tree.py,sha256=kPx0fNTJxHaaEI_-0JxQ7NBcV2bYgUDGmtf1wmTqoEg,13172
 clearskies/column_types/column.py,sha256=ftuDFswjk-KE9Frxo1rhgkjr4sjSjnUc5ZtfNrnGLIc,15530
@@ -72,7 +73,7 @@ clearskies/column_types/datetime.py,sha256=xtuZpUC9fA16i1oO80kPIx--8RDPuei9RdsDD
 clearskies/column_types/datetime_micro.py,sha256=ewQSniCc2MmNIyX2XNuNcCIwh5Fpf1HcvpLfzB8lz8g,382
 clearskies/column_types/email.py,sha256=qq0Yo_C3KxUqT68q2HWXocBBR4xwMqjxcIdgZRv218U,584
 clearskies/column_types/float.py,sha256=j8jJeBueSOusPtAFCWgLHYBncfLnqT1U7bh1zcAkYiA,1332
-clearskies/column_types/has_many.py,sha256=Z4oM1g2dQx6H9171c52FLC41nLryCOKmh51I75mYmmY,5895
+clearskies/column_types/has_many.py,sha256=090CNJOrpLTgfB8MHEenjGtkeGVUvXWq0wC-bowSF9g,7200
 clearskies/column_types/has_one.py,sha256=uphIPUuHLwwmhljLMaKKPujR6TYTT7onn-hHUF6S_IY,2230
 clearskies/column_types/integer.py,sha256=dGIluusPmhLRNg7PplOJLbQI2AXojqRBUHt8ekYWNVI,1386
 clearskies/column_types/json.py,sha256=TbZkdwCoZYhbALUxof2jENGfaq2i5TlcyBcmo7XzDGQ,652
@@ -205,7 +206,7 @@ clearskies/tests/simple_api/models/__init__.py,sha256=nUA0W6fgXw_Bxa9CudkaDkC80t
 clearskies/tests/simple_api/models/status.py,sha256=PEhPbaQh5qdUNHp8O0gz91LOLENAEBtqSaHxUPXchaM,699
 clearskies/tests/simple_api/models/user.py,sha256=5_P4Tp1tTdX7PkMJ__epPM5MA7JAeVYGas69vcWloLc,819
 clearskies/tests/simple_api/users_api.py,sha256=KYXCgEofDxHeRdQK67txN5oYUPvxxmB8JTku7L-apk4,2344
-clear_skies-1.22.0.dist-info/LICENSE,sha256=3Ehd0g3YOpCj8sqj0Xjq5qbOtjjgk9qzhhD9YjRQgOA,1053
-clear_skies-1.22.0.dist-info/METADATA,sha256=a0Q4D5KWAlqhWVBabYpHGsj6ZNUClL8Ce1eBaXFE03g,1817
-clear_skies-1.22.0.dist-info/WHEEL,sha256=d2fvjOD7sXsVzChCqf0Ty0JbHKBaLYwDbGQDwQTnJ50,88
-clear_skies-1.22.0.dist-info/RECORD,,
+clear_skies-1.22.2.dist-info/LICENSE,sha256=3Ehd0g3YOpCj8sqj0Xjq5qbOtjjgk9qzhhD9YjRQgOA,1053
+clear_skies-1.22.2.dist-info/METADATA,sha256=VK-epQE4gX0HBLswlPrBOSyKYKegicpH7hW5ZfYLSrE,1817
+clear_skies-1.22.2.dist-info/WHEEL,sha256=d2fvjOD7sXsVzChCqf0Ty0JbHKBaLYwDbGQDwQTnJ50,88
+clear_skies-1.22.2.dist-info/RECORD,,

clearskies/authentication/__init__.py

@@ -5,6 +5,7 @@ from .auth0_jwks import Auth0JWKS
 from .authorization import Authorization
 from .jwks import JWKS
 from .jwks_jwcrypto import JWKSJwCrypto
+from .authorization_pass_through import AuthorizationPassThrough
 
 
 def public():
@@ -29,6 +30,7 @@ def jwks_jwcrypto(jwks_url, **kwargs):
 
 __all__ = [
     "Authorization",
+    "AuthorizationPassThrough",
     "BindingConfig",
     "public",
     "Public",

clearskies/authentication/authorization_pass_through.py

@@ -0,0 +1,18 @@
+from clearskies.authentication import JWKSJwCrypto
+
+
+class AuthorizationPassThrough(JWKSJwCrypto):
+    """
+    This authentication class takes the authentication header from the incoming request and reflects
+    it on outgoing requests.
+    """
+
+    def __init__(self, environment, requests, di):
+        super().__init__(environment, requests)
+        # we need the dependency injection container so we can grab the input output and,
+        # with that, the request headers (which contain the JWT we'll pass through).
+        self.di = di
+
+    def headers(self, retry_auth=False):
+        input_output = self.di.build("input_output", cache=True)
+        return {"Authorization": input_output.get_request_header("authorization", True)}

clearskies/column_types/belongs_to.py

@@ -34,6 +34,7 @@ class BelongsTo(String):
         "model_column_name",
         "readable_parent_columns",
         "join_type",
+        "where",
     ]
 
     def __init__(self, di):
@@ -43,6 +44,7 @@ class BelongsTo(String):
         super()._check_configuration(configuration)
         self.validate_models_class(configuration["parent_models_class"])
 
+        error_prefix = f"Configuration error for '{self.name}' in '{self.model_class.__name__}':"
         if not configuration.get("model_column_name") and self.name[-3:] != "_id":
             raise ValueError(
                 f"Invalid name for column '{self.name}' in '{self.model_class.__name__}' - "
@@ -50,19 +52,14 @@ class BelongsTo(String):
                 + "that the parent model can be fetched from."
             )
         if configuration.get("model_column_name") and type(configuration.get("model_column_name")) != str:
-            raise ValueError(
-                f"Configuration error for '{self.name}' in '{self.model_class.__name__}': 'model_column_name' must be a string."
-            )
+            raise ValueError(f"{error_prefix} 'model_column_name' must be a string.")
 
         join_type = configuration.get("join_type")
         if join_type and join_type.upper() not in ["LEFT", "INNER"]:
-            raise ValueError(
-                f"Configuration error for '{self.name}' in '{self.model_class.__name__}': join_type must be INNER or LEFT"
-            )
+            raise ValueError(f"{error_prefix} join_type must be INNER or LEFT")
 
         if configuration.get("readable_parent_columns"):
             parent_columns = self.di.build(configuration["parent_models_class"], cache=True).raw_columns_configuration()
-            error_prefix = f"Configuration error for '{self.name}' in '{self.model_class.__name__}':"
             readable_parent_columns = configuration["readable_parent_columns"]
             if not hasattr(readable_parent_columns, "__iter__"):
                 raise ValueError(
@@ -81,6 +78,19 @@ class BelongsTo(String):
                         + "column does not exist in the model class."
                     )
 
+        wheres = configuration.get("where")
+        if wheres:
+            if not isinstance(wheres, list):
+                raise ValueError(
+                    f"{error_prefix} 'where' must be a list of where conditions or callables that return where conditions"
+                )
+            for index, where in enumerate(wheres):
+                if callable(where) or isinstance(where, str):
+                    continue
+                raise ValueError(
+                    f"{error_prefix} 'where' must be a list of where conditions or callables that return where conditions, but the item in entry #${index+1} was neither a string nor a callable"
+                )
+
     def _finalize_configuration(self, configuration):
         return {
             **super()._finalize_configuration(configuration),
@@ -89,6 +99,7 @@ class BelongsTo(String):
                 if configuration.get("model_column_name")
                 else self.name[:-3],
                 "join_type": configuration.get("join_type", "INNER").upper(),
+                "where": configuration.get("where", []),
             },
         }
 
@@ -149,7 +160,17 @@ class BelongsTo(String):
 
     @property
     def parent_models(self):
-        return self.di.build(self.config("parent_models_class"), cache=True)
+        parents = self.di.build(self.config("parent_models_class"), cache=True)
+        for where in self.config("where"):
+            if callable(where):
+                parents = self.di.call_function(where, model=parents)
+                if not parents:
+                    raise ValueError(
+                        f"Configuration error for column '{self.name}' in model '{self.model_class.__name__}': when 'where' is a callable, it must return a models class, but when the callable in where entry #{index+1} was called, it did not return the models class"
+                    )
+            else:
+                parents = parents.where(where)
+        return parents
 
     @property
     def parent_columns(self):

clearskies/column_types/has_many.py

@@ -27,6 +27,7 @@ class HasMany(Column):
         "is_readable",
         "readable_child_columns",
         "parent_id_column_name",
+        "where",
     ]
 
     def __init__(self, di):
@@ -63,9 +64,10 @@ class HasMany(Column):
 
     def _check_configuration(self, configuration):
         super()._check_configuration(configuration)
+        error_prefix = f"Configuration error for '{self.name}' in '{self.model_class.__name__}':"
+
         if configuration.get("is_readable"):
             child_columns = self.di.build(configuration["child_models_class"], cache=True).raw_columns_configuration()
-            error_prefix = f"Configuration error for '{self.name}' in '{self.model_class.__name__}':"
             if not "readable_child_columns" in configuration:
                 raise ValueError(f"{error_prefix} must provide 'readable_child_columns' if is_readable is set")
             readable_child_columns = configuration["readable_child_columns"]
@@ -86,6 +88,19 @@ class HasMany(Column):
                         + "column does not exist in the model class."
                     )
 
+        wheres = configuration.get("where")
+        if wheres:
+            if not isinstance(wheres, list):
+                raise ValueError(
+                    f"{error_prefix} 'where' must be a list of where conditions or callables that return where conditions"
+                )
+            for index, where in enumerate(wheres):
+                if callable(where) or isinstance(where, str):
+                    continue
+                raise ValueError(
+                    f"{error_prefix} 'where' must be a list of where conditions or callables that return where conditions, but the item in entry #${index+1} was neither a string nor a callable"
+                )
+
     def get_child_columns(self):
         if "child_columns" not in self.configuration:
             self.configuration["child_columns"] = self.child_models.columns()
@@ -119,7 +134,17 @@ class HasMany(Column):
 
     @property
     def child_models(self):
-        return self.di.build(self.config("child_models_class"), cache=True)
+        children = self.di.build(self.config("child_models_class"), cache=True)
+        for index, where in enumerate(self.config("where")):
+            if callable(where):
+                children = self.di.call_function(where, model=children)
+                if not children:
+                    raise ValueError(
+                        f"Configuration error for column '{self.name}' in model '{self.model_class.__name__}': when 'where' is a callable, it must return a models class, but when the callable in where entry #{index+1} was called, it did not return the models class"
+                    )
+            else:
+                children = children.where(where)
+        return children
 
     def documentation(self, name=None, example=None, value=None):
         columns = self.get_child_columns()