clear-skies 1.22.10__py3-none-any.whl → 2.0.23__py3-none-any.whl

clearskies/backends/secrets_backend.py

@@ -1,63 +1,100 @@
+from typing import TYPE_CHECKING, Any, Callable
+
+from clearskies.autodoc.schema import Schema as AutoDocSchema
 from clearskies.backends.backend import Backend
+from clearskies.di import inject
+from clearskies.query import Condition, Query
+
+if TYPE_CHECKING:
+    from clearskies import Model
 
 
 class SecretsBackend(Backend):
-    _secrets = None
+    """
+    Fetch and store data from a secret provider.
+
+    ## Installing Dependencies
+
+    Clearskies uses Akeyless by default to manage the secrets.
+    This is not installed by default, but is a named extra that you can install when needed via:
+
+    ```bash
+    pip install clear-skies[secrets]
+    ```
+    """
+
+    """The secrets instance."""
+    secrets = inject.Secrets()
+
+    can_count: bool = False
+
+    def __init__(self):
+        pass
 
-    def __init__(self, secrets):
-        self._secrets = secrets
+    def check_query(self, query: Query) -> None:
+        if not query.conditions:
+            raise KeyError(f"You must search by an id when using the secrets backend.")
 
-    def update(self, id, data, model):
+    def update(self, id: str, data: dict[str, Any], model: Model) -> dict[str, Any]:  # type: ignore[override]
+        """Update the record with the given id with the information from the data dictionary."""
         folder_path = self._make_folder_path(model, id)
         for key, value in data.items():
             if key == model.id_column_name:
                 continue
-            self._secrets.update(f"{folder_path}{key}", value)
-        return self.records({"wheres": [{"column": model.id_column_name, "values": [id]}]}, model)[0]
+            self.secrets.update(f"{folder_path}{key}", value)
 
-    def create(self, data, model):
+        # and now query again to fetch the updated record.
+        return self.records(Query(model.__class__, conditions=[Condition(f"{model.id_column_name}={id}")]))[0]
+
+    def create(self, data: dict[str, Any], model: Model) -> dict[str, Any]:
         if not model.id_column_name in data:
             raise ValueError(
                 f"You must provide '{model.id_column_name}' when creating a record with the secrets backend"
             )
         return self.update(data[model.id_column_name], data, model)
 
-    def delete(self, id):
-        return True
+    def delete(self, id: str, model: Model) -> bool:  # type: ignore[override]
+        """
+        Delete the record with the given id.
 
-    def count(self, configuration, model):
-        return 1
+        Note that this isn't implemented yet, and always returns True.
+        """
+        return True
 
-    def records(self, configuration, model, next_page_data=None):
-        if not configuration["wheres"]:
-            raise ValueError("You must search by an id when using the secrets backend")
-        id = None
-        for condition in configuration["wheres"]:
-            if condition["column"] == model.id_column_name:
-                id = condition["values"][0]
+    def records(self, query: Query, next_page_data: dict[str, str | int] | None = None) -> list[dict[str, Any]]:
+        """Return a list of records that match the given query configuration."""
+        self.check_query(query)
+        for condition in query.conditions:
+            if condition.operator != "=":
+                raise ValueError(
+                    f"I'm not very smart and only know how to search with the equals operator, but I received a condition of {condition.parsed}.  If you need to support this, you'll have to extend the ApiBackend and overwrite the build_records_request method."
+                )
+            if condition.column_name == query.model_class.id_column_name:
+                id = condition.values[0]
+                break
         if id is None:
-            raise ValueError(f"You must search by '{model.id_column_name}' when using the secrets backend")
+            raise ValueError(f"You must search by '{query.model_class.id_column_name}' when using the secrets backend")
 
-        folder_path = self._make_folder_path(model, id)
-        data = {model.id_column_name: id}
-        for path in self._secrets.list_secrets(folder_path):
-            data[path[len(folder_path) :]] = self._secrets.get(path)
+        folder_path = self._make_folder_path(query.model_class, id)
+        data = {query.model_class.id_column_name: id}
+        for path in self.secrets.list_secrets(folder_path):
+            data[path[len(folder_path) :]] = self.secrets.get(path)
         return [data]
 
     def _make_folder_path(self, model, id):
         return model.table_name().rstrip("/") + "/" + id.strip("/") + "/"
 
-    def validate_pagination_kwargs(self, kwargs):
-        pass
+    def validate_pagination_data(self, data: dict[str, Any], case_mapping: Callable[[str], str]) -> str:
+        return ""
 
-    def allowed_pagination_keys(self):
+    def allowed_pagination_keys(self) -> list[str]:
         return []
 
-    def documentation_pagination_next_page_response(self, case_mapping):
-        return {}
+    def documentation_pagination_next_page_response(self, case_mapping: Callable) -> list[Any]:
+        return []
 
-    def documentation_pagination_parameters(self, case_mapping):
-        return {}
+    def documentation_pagination_parameters(self, case_mapping: Callable) -> list[tuple[AutoDocSchema, str]]:
+        return []
 
-    def documentation_pagination_next_page_example(self, case_mapping):
+    def documentation_pagination_next_page_example(self, case_mapping: Callable) -> dict[str, Any]:
         return {}