codecraftai-restclient-pychestrate 1.2.0__py3-none-any.whl

ccai/pychestrate/rest/client/groups/rbac.py

@@ -0,0 +1,243 @@
+# Auto-generated by RestClientGenerator. DO NOT EDIT.
+
+from typing import Any, Dict, List, Optional
+
+from ccai.pychestrate.rest.client.models.rbac import Rbaccheckrequest
+from ccai.pychestrate.rest.client.models.rbac import Rbaccheckresponse
+from ccai.pychestrate.rest.client.models.rbac import Rbacrolebindingcreaterequest
+from ccai.restclient.base.aspectsrest import AspectsRest
+from ccai.restclient.base.restapigroup import RestApiGroup
+
+
+class RbacApiGroup(RestApiGroup):
+    """
+        Roles, permissions, role bindings, and permission checks.
+    """
+
+    def rbac_check_permission(self, body: Rbaccheckrequest, *, exp_status: Optional[List[int]] = None, headers: Optional[Dict[str, str]] = None, aspects: Optional[AspectsRest] = None) -> Rbaccheckresponse:
+        """
+            Check whether the actor has a permission in a scope.
+        """
+        client = self.client
+        if aspects is None:
+            aspects = client.aspects
+
+        header_params = client.headers
+        if headers is not None:
+            header_params = headers
+
+        call_leaf = "/rbac/check"
+
+        query_params = None
+
+
+        if exp_status is None:
+            exp_status = [200]
+
+        resp = client.perform_call(
+            leaf=call_leaf,
+            method="POST",
+            params=query_params if query_params else None,
+            body=body,
+            exp_status=exp_status,
+            headers=header_params if header_params else None,
+            context_msg=None,
+            aspects=aspects,
+        )
+        if resp.status_code in (204, 205) or (resp.status_code == 202 and len(resp.content) == 0):
+            rtnobj = None
+        else:
+            raw_data = resp.json()
+            rtnobj = Rbaccheckresponse.from_dict(raw_data)
+        return rtnobj
+
+    def rbac_create_binding(self, body: Rbacrolebindingcreaterequest, *, exp_status: Optional[List[int]] = None, headers: Optional[Dict[str, str]] = None, aspects: Optional[AspectsRest] = None) -> Any:
+        """
+            Create a role binding.
+        """
+        client = self.client
+        if aspects is None:
+            aspects = client.aspects
+
+        header_params = client.headers
+        if headers is not None:
+            header_params = headers
+
+        call_leaf = "/rbac/bindings"
+
+        query_params = None
+
+
+        if exp_status is None:
+            exp_status = [201]
+
+        resp = client.perform_call(
+            leaf=call_leaf,
+            method="POST",
+            params=query_params if query_params else None,
+            body=body,
+            exp_status=exp_status,
+            headers=header_params if header_params else None,
+            context_msg=None,
+            aspects=aspects,
+        )
+        if resp.status_code in (204, 205) or (resp.status_code == 202 and len(resp.content) == 0):
+            rtnval = None
+        else:
+            rtnval = resp.json()
+        return rtnval
+
+    def rbac_delete_binding(self, binding_id: str, *, exp_status: Optional[List[int]] = None, headers: Optional[Dict[str, str]] = None, aspects: Optional[AspectsRest] = None) -> Any:
+        """
+            Delete a role binding.
+        """
+        client = self.client
+        if aspects is None:
+            aspects = client.aspects
+
+        header_params = client.headers
+        if headers is not None:
+            header_params = headers
+
+        leaf_template = "/rbac/bindings/{binding_id}"
+        path_params = {
+            'binding_id': binding_id,
+        }
+        call_leaf = leaf_template.format(**path_params)
+
+        query_params = None
+
+
+        if exp_status is None:
+            exp_status = [204]
+
+        resp = client.perform_call(
+            leaf=call_leaf,
+            method="DELETE",
+            params=query_params if query_params else None,
+            body=None,
+            exp_status=exp_status,
+            headers=header_params if header_params else None,
+            context_msg=None,
+            aspects=aspects,
+        )
+        if resp.status_code in (204, 205) or (resp.status_code == 202 and len(resp.content) == 0):
+            rtnval = None
+        else:
+            rtnval = resp.json()
+        return rtnval
+
+    def rbac_list_bindings(self, *, user_id: Optional[str] = None, project_id: Optional[str] = None, exp_status: Optional[List[int]] = None, headers: Optional[Dict[str, str]] = None, aspects: Optional[AspectsRest] = None) -> Dict[str, Any]:
+        """
+            List role bindings.
+        """
+        client = self.client
+        if aspects is None:
+            aspects = client.aspects
+
+        header_params = client.headers
+        if headers is not None:
+            header_params = headers
+
+        call_leaf = "/rbac/bindings"
+
+        query_params = {}
+        if user_id is not None:
+            query_params['user_id'] = user_id
+        if project_id is not None:
+            query_params['project_id'] = project_id
+
+
+        if exp_status is None:
+            exp_status = [200]
+
+        resp = client.perform_call(
+            leaf=call_leaf,
+            method="GET",
+            params=query_params if query_params else None,
+            body=None,
+            exp_status=exp_status,
+            headers=header_params if header_params else None,
+            context_msg=None,
+            aspects=aspects,
+        )
+        if resp.status_code in (204, 205) or (resp.status_code == 202 and len(resp.content) == 0):
+            rtnval = None
+        else:
+            raw_data = resp.json()
+            rtnval = self._parse_item(raw_data, Dict[str, Any])
+        return rtnval
+
+    def rbac_list_permissions(self, *, exp_status: Optional[List[int]] = None, headers: Optional[Dict[str, str]] = None, aspects: Optional[AspectsRest] = None) -> Dict[str, Any]:
+        """
+            List declared RBAC permission keys.
+        """
+        client = self.client
+        if aspects is None:
+            aspects = client.aspects
+
+        header_params = client.headers
+        if headers is not None:
+            header_params = headers
+
+        call_leaf = "/rbac/permissions"
+
+        query_params = None
+
+
+        if exp_status is None:
+            exp_status = [200]
+
+        resp = client.perform_call(
+            leaf=call_leaf,
+            method="GET",
+            params=query_params if query_params else None,
+            body=None,
+            exp_status=exp_status,
+            headers=header_params if header_params else None,
+            context_msg=None,
+            aspects=aspects,
+        )
+        if resp.status_code in (204, 205) or (resp.status_code == 202 and len(resp.content) == 0):
+            rtnval = None
+        else:
+            raw_data = resp.json()
+            rtnval = self._parse_item(raw_data, Dict[str, Any])
+        return rtnval
+
+    def rbac_list_roles(self, *, exp_status: Optional[List[int]] = None, headers: Optional[Dict[str, str]] = None, aspects: Optional[AspectsRest] = None) -> Dict[str, Any]:
+        """
+            List declared roles.
+        """
+        client = self.client
+        if aspects is None:
+            aspects = client.aspects
+
+        header_params = client.headers
+        if headers is not None:
+            header_params = headers
+
+        call_leaf = "/rbac/roles"
+
+        query_params = None
+
+
+        if exp_status is None:
+            exp_status = [200]
+
+        resp = client.perform_call(
+            leaf=call_leaf,
+            method="GET",
+            params=query_params if query_params else None,
+            body=None,
+            exp_status=exp_status,
+            headers=header_params if header_params else None,
+            context_msg=None,
+            aspects=aspects,
+        )
+        if resp.status_code in (204, 205) or (resp.status_code == 202 and len(resp.content) == 0):
+            rtnval = None
+        else:
+            raw_data = resp.json()
+            rtnval = self._parse_item(raw_data, Dict[str, Any])
+        return rtnval

ccai/pychestrate/rest/client/groups/results.py

@@ -0,0 +1,193 @@
+# Auto-generated by RestClientGenerator. DO NOT EDIT.
+
+from typing import Any, Dict, List, Optional
+
+from ccai.pychestrate.rest.client.models.results import Artifactpresignrequest
+from ccai.pychestrate.rest.client.models.results import Artifactpresignresponse
+from ccai.pychestrate.rest.client.models.results import Resultmanifest
+from ccai.restclient.base.aspectsrest import AspectsRest
+from ccai.restclient.base.restapigroup import RestApiGroup
+
+
+class ResultsApiGroup(RestApiGroup):
+    """
+        Pod-client → server final-result manifests.
+    """
+
+    def artifacts_local_upload(self, run_id: str, path: str, expires: int, signature: str, *, exp_status: Optional[List[int]] = None, headers: Optional[Dict[str, str]] = None, aspects: Optional[AspectsRest] = None) -> Any:
+        """
+            Upload sink for the local-filesystem presign fallback.
+            
+            The upload sink the `:presign` operation's local-filesystem
+fallback URLs point at. Used only when the deploy has no
+S3-compatible object store.
+
+The request body is the raw artifact bytes. The handler
+re-verifies the `signature` query parameter against the
+server-held HMAC secret before writing the bytes under the
+run's allocated `backend_key_prefix`. A forged or expired
+signature is rejected with 403; the signature -- not a
+permission check -- is this endpoint's auth contract, so no
+object-store credential is involved.
+
+        """
+        client = self.client
+        if aspects is None:
+            aspects = client.aspects
+
+        header_params = client.headers
+        if headers is not None:
+            header_params = headers
+
+        leaf_template = "/runs/{run_id}/artifacts/_local-upload"
+        path_params = {
+            'run_id': run_id,
+        }
+        call_leaf = leaf_template.format(**path_params)
+
+        query_params = {}
+        if path is not None:
+            query_params['path'] = path
+        if expires is not None:
+            query_params['expires'] = expires
+        if signature is not None:
+            query_params['signature'] = signature
+
+
+        if exp_status is None:
+            exp_status = [201]
+
+        resp = client.perform_call(
+            leaf=call_leaf,
+            method="PUT",
+            params=query_params if query_params else None,
+            body=None,
+            exp_status=exp_status,
+            headers=header_params if header_params else None,
+            context_msg=None,
+            aspects=aspects,
+        )
+        if resp.status_code in (204, 205) or (resp.status_code == 202 and len(resp.content) == 0):
+            rtnval = None
+        else:
+            rtnval = resp.json()
+        return rtnval
+
+    def artifacts_presign_upload(self, run_id: str, body: Artifactpresignrequest, *, exp_status: Optional[List[int]] = None, headers: Optional[Dict[str, str]] = None, aspects: Optional[AspectsRest] = None) -> Artifactpresignresponse:
+        """
+            Mint presigned PUT URLs for a run's result-tree upload.
+            
+            Posted by the pod client agent over mTLS to obtain
+short-lived presigned PUT URLs for the relative artifact
+paths it discovered while walking its testbase result tree.
+
+The agent PUTs each artifact's bytes directly to the
+returned `put_url`, then calls
+`POST /runs/{run_id}/results/complete`. Object-store
+credentials never leave the server -- the credentialed
+transfer is encoded entirely in the presigned URL.
+
+On the dev / alpha deploy there is no S3-compatible object
+store, so the server mints **local-filesystem fallback**
+URLs that point back at
+`PUT /runs/{run_id}/artifacts/_local-upload`. The URL
+carries an HMAC signature over `run_id` + path + expiry, so
+the fallback needs no object-store credential while staying
+tamper-proof. The agent's code path is identical either way.
+
+Auth: the verified mTLS client common-name must match the
+`client_id` that owns the run's current dispatch receipt --
+only the client running the job may upload its results. A
+run that has already reached a terminal state no longer
+accepts uploads (409).
+
+        """
+        client = self.client
+        if aspects is None:
+            aspects = client.aspects
+
+        header_params = client.headers
+        if headers is not None:
+            header_params = headers
+
+        leaf_template = "/runs/{run_id}/artifacts:presign"
+        path_params = {
+            'run_id': run_id,
+        }
+        call_leaf = leaf_template.format(**path_params)
+
+        query_params = None
+
+
+        if exp_status is None:
+            exp_status = [200]
+
+        resp = client.perform_call(
+            leaf=call_leaf,
+            method="POST",
+            params=query_params if query_params else None,
+            body=body,
+            exp_status=exp_status,
+            headers=header_params if header_params else None,
+            context_msg=None,
+            aspects=aspects,
+        )
+        if resp.status_code in (204, 205) or (resp.status_code == 202 and len(resp.content) == 0):
+            rtnobj = None
+        else:
+            raw_data = resp.json()
+            rtnobj = Artifactpresignresponse.from_dict(raw_data)
+        return rtnobj
+
+    def results_post_complete(self, run_id: str, body: Resultmanifest, *, exp_status: Optional[List[int]] = None, headers: Optional[Dict[str, str]] = None, aspects: Optional[AspectsRest] = None) -> Any:
+        """
+            Signal that the result tree for a run is fully uploaded.
+            
+            Posted by the pod client agent over mTLS once it has finished
+writing the testbase result tree (`testrun_summary.json`,
+`testrun_results_stream.jsos`, `testrun_results.json`,
+`testsummary.html`, plus the `artifacts/`, `taskings/`,
+`tc-by-products/`, `diagnostics/` subtrees) to the shared
+results backend.
+
+The server transitions the run to a terminal state
+(`COMPLETED` / `FAILED`) based on the manifest's
+`terminal_outcome` field and kicks off the
+`result_tree_parser` extension chain.
+
+        """
+        client = self.client
+        if aspects is None:
+            aspects = client.aspects
+
+        header_params = client.headers
+        if headers is not None:
+            header_params = headers
+
+        leaf_template = "/runs/{run_id}/results/complete"
+        path_params = {
+            'run_id': run_id,
+        }
+        call_leaf = leaf_template.format(**path_params)
+
+        query_params = None
+
+
+        if exp_status is None:
+            exp_status = [202]
+
+        resp = client.perform_call(
+            leaf=call_leaf,
+            method="POST",
+            params=query_params if query_params else None,
+            body=body,
+            exp_status=exp_status,
+            headers=header_params if header_params else None,
+            context_msg=None,
+            aspects=aspects,
+        )
+        if resp.status_code in (204, 205) or (resp.status_code == 202 and len(resp.content) == 0):
+            rtnval = None
+        else:
+            rtnval = resp.json()
+        return rtnval

ccai/pychestrate/rest/client/groups/retention.py

@@ -0,0 +1,169 @@
+# Auto-generated by RestClientGenerator. DO NOT EDIT.
+
+from typing import Any, Dict, List, Optional
+
+from ccai.pychestrate.rest.client.models.retention import Retentionpolicy
+from ccai.pychestrate.rest.client.models.retention import Retentionpolicycreaterequest
+from ccai.restclient.base.aspectsrest import AspectsRest
+from ccai.restclient.base.restapigroup import RestApiGroup
+
+
+class RetentionApiGroup(RestApiGroup):
+    """
+        Per-data-class retention policies.
+    """
+
+    def retention_create(self, body: Retentionpolicycreaterequest, *, exp_status: Optional[List[int]] = None, headers: Optional[Dict[str, str]] = None, aspects: Optional[AspectsRest] = None) -> Any:
+        """
+            Create a retention policy.
+        """
+        client = self.client
+        if aspects is None:
+            aspects = client.aspects
+
+        header_params = client.headers
+        if headers is not None:
+            header_params = headers
+
+        call_leaf = "/retention/policies"
+
+        query_params = None
+
+
+        if exp_status is None:
+            exp_status = [201]
+
+        resp = client.perform_call(
+            leaf=call_leaf,
+            method="POST",
+            params=query_params if query_params else None,
+            body=body,
+            exp_status=exp_status,
+            headers=header_params if header_params else None,
+            context_msg=None,
+            aspects=aspects,
+        )
+        if resp.status_code in (204, 205) or (resp.status_code == 202 and len(resp.content) == 0):
+            rtnval = None
+        else:
+            rtnval = resp.json()
+        return rtnval
+
+    def retention_get_by_id(self, policy_id: str, *, exp_status: Optional[List[int]] = None, headers: Optional[Dict[str, str]] = None, aspects: Optional[AspectsRest] = None) -> Retentionpolicy:
+        """
+            Read a retention policy.
+        """
+        client = self.client
+        if aspects is None:
+            aspects = client.aspects
+
+        header_params = client.headers
+        if headers is not None:
+            header_params = headers
+
+        leaf_template = "/retention/policies/{policy_id}"
+        path_params = {
+            'policy_id': policy_id,
+        }
+        call_leaf = leaf_template.format(**path_params)
+
+        query_params = None
+
+
+        if exp_status is None:
+            exp_status = [200]
+
+        resp = client.perform_call(
+            leaf=call_leaf,
+            method="GET",
+            params=query_params if query_params else None,
+            body=None,
+            exp_status=exp_status,
+            headers=header_params if header_params else None,
+            context_msg=None,
+            aspects=aspects,
+        )
+        if resp.status_code in (204, 205) or (resp.status_code == 202 and len(resp.content) == 0):
+            rtnobj = None
+        else:
+            raw_data = resp.json()
+            rtnobj = Retentionpolicy.from_dict(raw_data)
+        return rtnobj
+
+    def retention_list(self, *, exp_status: Optional[List[int]] = None, headers: Optional[Dict[str, str]] = None, aspects: Optional[AspectsRest] = None) -> Dict[str, Any]:
+        """
+            List retention policies.
+        """
+        client = self.client
+        if aspects is None:
+            aspects = client.aspects
+
+        header_params = client.headers
+        if headers is not None:
+            header_params = headers
+
+        call_leaf = "/retention/policies"
+
+        query_params = None
+
+
+        if exp_status is None:
+            exp_status = [200]
+
+        resp = client.perform_call(
+            leaf=call_leaf,
+            method="GET",
+            params=query_params if query_params else None,
+            body=None,
+            exp_status=exp_status,
+            headers=header_params if header_params else None,
+            context_msg=None,
+            aspects=aspects,
+        )
+        if resp.status_code in (204, 205) or (resp.status_code == 202 and len(resp.content) == 0):
+            rtnval = None
+        else:
+            raw_data = resp.json()
+            rtnval = self._parse_item(raw_data, Dict[str, Any])
+        return rtnval
+
+    def retention_publish(self, policy_id: str, *, exp_status: Optional[List[int]] = None, headers: Optional[Dict[str, str]] = None, aspects: Optional[AspectsRest] = None) -> Retentionpolicy:
+        """
+            Publish (activate) a retention policy.
+        """
+        client = self.client
+        if aspects is None:
+            aspects = client.aspects
+
+        header_params = client.headers
+        if headers is not None:
+            header_params = headers
+
+        leaf_template = "/retention/policies/{policy_id}/publish"
+        path_params = {
+            'policy_id': policy_id,
+        }
+        call_leaf = leaf_template.format(**path_params)
+
+        query_params = None
+
+
+        if exp_status is None:
+            exp_status = [200]
+
+        resp = client.perform_call(
+            leaf=call_leaf,
+            method="POST",
+            params=query_params if query_params else None,
+            body=None,
+            exp_status=exp_status,
+            headers=header_params if header_params else None,
+            context_msg=None,
+            aspects=aspects,
+        )
+        if resp.status_code in (204, 205) or (resp.status_code == 202 and len(resp.content) == 0):
+            rtnobj = None
+        else:
+            raw_data = resp.json()
+            rtnobj = Retentionpolicy.from_dict(raw_data)
+        return rtnobj