aws-sdk-cloudfront-keyvaluestore 0.1.0__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (63) hide show
  1. aws_sdk_cloudfront_keyvaluestore/__init__.py +36 -0
  2. aws_sdk_cloudfront_keyvaluestore/_async.py +25 -0
  3. aws_sdk_cloudfront_keyvaluestore/_auth/_identity.py +16 -0
  4. aws_sdk_cloudfront_keyvaluestore/_auth/_providers.py +159 -0
  5. aws_sdk_cloudfront_keyvaluestore/_auth/_signers.py +84 -0
  6. aws_sdk_cloudfront_keyvaluestore/_auth/_sigv4.py +382 -0
  7. aws_sdk_cloudfront_keyvaluestore/_auth/_zapros_handler.py +62 -0
  8. aws_sdk_cloudfront_keyvaluestore/_iter.py +23 -0
  9. aws_sdk_cloudfront_keyvaluestore/_operations/cloud_front_key_value_store/delete_key.py +170 -0
  10. aws_sdk_cloudfront_keyvaluestore/_operations/cloud_front_key_value_store/describe_key_value_store.py +154 -0
  11. aws_sdk_cloudfront_keyvaluestore/_operations/cloud_front_key_value_store/get_key.py +157 -0
  12. aws_sdk_cloudfront_keyvaluestore/_operations/cloud_front_key_value_store/list_keys.py +164 -0
  13. aws_sdk_cloudfront_keyvaluestore/_operations/cloud_front_key_value_store/put_key.py +177 -0
  14. aws_sdk_cloudfront_keyvaluestore/_operations/cloud_front_key_value_store/update_keys.py +175 -0
  15. aws_sdk_cloudfront_keyvaluestore/_pagination.py +21 -0
  16. aws_sdk_cloudfront_keyvaluestore/_protocol/__init__.py +1 -0
  17. aws_sdk_cloudfront_keyvaluestore/_protocol/errors.py +59 -0
  18. aws_sdk_cloudfront_keyvaluestore/_protocol/xml.py +27 -0
  19. aws_sdk_cloudfront_keyvaluestore/_rule_engine/__init__.py +0 -0
  20. aws_sdk_cloudfront_keyvaluestore/_rule_engine/_aws_partition.py +160 -0
  21. aws_sdk_cloudfront_keyvaluestore/_rule_engine/_endpoint_rule_set.py +283 -0
  22. aws_sdk_cloudfront_keyvaluestore/_rule_engine/_endpoint_runtime.py +389 -0
  23. aws_sdk_cloudfront_keyvaluestore/_services/_pipeline.py +195 -0
  24. aws_sdk_cloudfront_keyvaluestore/_services/async_cloud_front_key_value_store.py +475 -0
  25. aws_sdk_cloudfront_keyvaluestore/_services/cloud_front_key_value_store.py +468 -0
  26. aws_sdk_cloudfront_keyvaluestore/errors/__init__.py +32 -0
  27. aws_sdk_cloudfront_keyvaluestore/errors/_base.py +94 -0
  28. aws_sdk_cloudfront_keyvaluestore/errors/access_denied_exception.py +45 -0
  29. aws_sdk_cloudfront_keyvaluestore/errors/conflict_exception.py +45 -0
  30. aws_sdk_cloudfront_keyvaluestore/errors/internal_server_exception.py +45 -0
  31. aws_sdk_cloudfront_keyvaluestore/errors/resource_not_found_exception.py +45 -0
  32. aws_sdk_cloudfront_keyvaluestore/errors/service_quota_exceeded_exception.py +45 -0
  33. aws_sdk_cloudfront_keyvaluestore/errors/validation_exception.py +45 -0
  34. aws_sdk_cloudfront_keyvaluestore/py.typed +0 -0
  35. aws_sdk_cloudfront_keyvaluestore/types/_prelude/blob.py +12 -0
  36. aws_sdk_cloudfront_keyvaluestore/types/_prelude/timestamp.py +12 -0
  37. aws_sdk_cloudfront_keyvaluestore/types/delete_key_request.py +28 -0
  38. aws_sdk_cloudfront_keyvaluestore/types/delete_key_request_list_item.py +29 -0
  39. aws_sdk_cloudfront_keyvaluestore/types/delete_key_requests_list.py +37 -0
  40. aws_sdk_cloudfront_keyvaluestore/types/delete_key_response.py +38 -0
  41. aws_sdk_cloudfront_keyvaluestore/types/describe_key_value_store_request.py +22 -0
  42. aws_sdk_cloudfront_keyvaluestore/types/describe_key_value_store_response.py +101 -0
  43. aws_sdk_cloudfront_keyvaluestore/types/etag.py +5 -0
  44. aws_sdk_cloudfront_keyvaluestore/types/get_key_request.py +25 -0
  45. aws_sdk_cloudfront_keyvaluestore/types/get_key_response.py +51 -0
  46. aws_sdk_cloudfront_keyvaluestore/types/key.py +5 -0
  47. aws_sdk_cloudfront_keyvaluestore/types/kvs_arn.py +5 -0
  48. aws_sdk_cloudfront_keyvaluestore/types/list_keys_request.py +28 -0
  49. aws_sdk_cloudfront_keyvaluestore/types/list_keys_response.py +48 -0
  50. aws_sdk_cloudfront_keyvaluestore/types/list_keys_response_list.py +37 -0
  51. aws_sdk_cloudfront_keyvaluestore/types/list_keys_response_list_item.py +37 -0
  52. aws_sdk_cloudfront_keyvaluestore/types/put_key_request.py +38 -0
  53. aws_sdk_cloudfront_keyvaluestore/types/put_key_request_list_item.py +37 -0
  54. aws_sdk_cloudfront_keyvaluestore/types/put_key_requests_list.py +37 -0
  55. aws_sdk_cloudfront_keyvaluestore/types/put_key_response.py +38 -0
  56. aws_sdk_cloudfront_keyvaluestore/types/update_keys_request.py +69 -0
  57. aws_sdk_cloudfront_keyvaluestore/types/update_keys_response.py +38 -0
  58. aws_sdk_cloudfront_keyvaluestore/types/value.py +5 -0
  59. aws_sdk_cloudfront_keyvaluestore-0.1.0.dist-info/METADATA +97 -0
  60. aws_sdk_cloudfront_keyvaluestore-0.1.0.dist-info/RECORD +63 -0
  61. aws_sdk_cloudfront_keyvaluestore-0.1.0.dist-info/WHEEL +5 -0
  62. aws_sdk_cloudfront_keyvaluestore-0.1.0.dist-info/licenses/LICENSE +21 -0
  63. aws_sdk_cloudfront_keyvaluestore-0.1.0.dist-info/top_level.txt +1 -0
@@ -0,0 +1,36 @@
1
+ from __future__ import annotations
2
+
3
+ from ._auth._identity import Credentials as Credentials
4
+ from ._auth._identity import Identity as Identity
5
+ from ._auth._providers import (
6
+ CachedProvider as CachedProvider,
7
+ )
8
+ from ._auth._providers import (
9
+ ChainedProvider as ChainedProvider,
10
+ )
11
+ from ._auth._providers import (
12
+ CredentialsProvider as CredentialsProvider,
13
+ )
14
+ from ._auth._providers import (
15
+ EnvCredentialsProvider as EnvCredentialsProvider,
16
+ )
17
+ from ._auth._providers import (
18
+ IdentityNotFound as IdentityNotFound,
19
+ )
20
+ from ._auth._providers import (
21
+ IdentityProvider as IdentityProvider,
22
+ )
23
+ from ._auth._providers import (
24
+ ProfileCredentialsProvider as ProfileCredentialsProvider,
25
+ )
26
+ from ._auth._providers import (
27
+ StaticAwsCredentialsProvider as StaticAwsCredentialsProvider,
28
+ )
29
+ from ._auth._signers import Signer as Signer
30
+ from ._auth._signers import SigV4Signer as SigV4Signer
31
+ from ._services.async_cloud_front_key_value_store import (
32
+ AsyncCloudFrontKeyValueStoreClient as AsyncCloudFrontKeyValueStoreClient,
33
+ )
34
+ from ._services.cloud_front_key_value_store import (
35
+ CloudFrontKeyValueStoreClient as CloudFrontKeyValueStoreClient,
36
+ )
@@ -0,0 +1,25 @@
1
+ from __future__ import annotations
2
+
3
+ import asyncio
4
+ from typing import TYPE_CHECKING
5
+
6
+ if TYPE_CHECKING:
7
+ import trio
8
+ else:
9
+ try:
10
+ import trio
11
+ except ImportError:
12
+ trio = None
13
+
14
+
15
+ def in_trio_run() -> bool:
16
+ if trio is None:
17
+ return False
18
+ return trio.lowlevel.in_trio_run()
19
+
20
+
21
+ async def anysleep(delay: float) -> None:
22
+ if in_trio_run():
23
+ await trio.sleep(delay)
24
+ else:
25
+ await asyncio.sleep(delay)
@@ -0,0 +1,16 @@
1
+ from __future__ import annotations
2
+
3
+ from datetime import datetime
4
+ from typing import TypedDict
5
+
6
+ from typing_extensions import NotRequired
7
+
8
+
9
+ class Identity(TypedDict):
10
+ expiration: NotRequired[datetime | None]
11
+
12
+
13
+ class Credentials(Identity):
14
+ access_key: str
15
+ secret_key: str
16
+ session_token: NotRequired[str | None]
@@ -0,0 +1,159 @@
1
+ from __future__ import annotations
2
+
3
+ import configparser
4
+ import os
5
+ from abc import abstractmethod
6
+ from datetime import datetime, timezone
7
+ from pathlib import Path
8
+ from typing import Generic, TypeVar
9
+
10
+ from aws_sdk_cloudfront_keyvaluestore._auth._identity import (
11
+ Credentials,
12
+ Identity,
13
+ )
14
+
15
+
16
+ class IdentityNotFound(Exception):
17
+ """Raised when a provider cannot resolve an identity. Chain continues."""
18
+
19
+
20
+ IdentityT = TypeVar("IdentityT", bound="Identity")
21
+
22
+
23
+ class IdentityProvider(Generic[IdentityT]):
24
+ @abstractmethod
25
+ def resolve_identity(self) -> IdentityT:
26
+ raise NotImplementedError
27
+
28
+
29
+ class ChainedProvider(IdentityProvider[IdentityT]):
30
+ """Try each provider in order; first non-`IdentityNotFound` wins."""
31
+
32
+ def __init__(self, *providers: IdentityProvider[IdentityT]) -> None:
33
+ if not providers:
34
+ raise ValueError("ChainedProvider requires at least one provider")
35
+ self._providers = providers
36
+
37
+ def resolve_identity(self) -> IdentityT:
38
+ errors: list[str] = []
39
+ for p in self._providers:
40
+ try:
41
+ return p.resolve_identity()
42
+ except IdentityNotFound as e:
43
+ errors.append(f"{type(p).__name__}: {e}")
44
+ raise IdentityNotFound("no provider succeeded: " + "; ".join(errors))
45
+
46
+
47
+ class CachedProvider(IdentityProvider[IdentityT]):
48
+ """Cache an identity until its `expiration` (minus skew) elapses."""
49
+
50
+ _SKEW_SECONDS = 60
51
+
52
+ def __init__(self, inner: IdentityProvider[IdentityT]) -> None:
53
+ self._inner = inner
54
+ self._cached: IdentityT | None = None
55
+
56
+ def resolve_identity(self) -> IdentityT:
57
+ if self._cached is not None and not self._expired(self._cached):
58
+ return self._cached
59
+ self._cached = self._inner.resolve_identity()
60
+ return self._cached
61
+
62
+ @classmethod
63
+ def _expired(cls, ident: Identity) -> bool:
64
+ exp = ident.get("expiration")
65
+ if exp is None:
66
+ return False
67
+ return (exp - datetime.now(timezone.utc)).total_seconds() <= cls._SKEW_SECONDS
68
+
69
+
70
+ class CredentialsProvider(IdentityProvider[Credentials]):
71
+ """Base class for providers that resolve AWS `Credentials`."""
72
+
73
+ @abstractmethod
74
+ def resolve_identity(self) -> Credentials:
75
+ raise NotImplementedError
76
+
77
+
78
+ class StaticAwsCredentialsProvider(CredentialsProvider):
79
+ def __init__(self, credentials: Credentials) -> None:
80
+ self._credentials = credentials
81
+
82
+ def resolve_identity(self) -> Credentials:
83
+ return self._credentials
84
+
85
+
86
+ class EnvCredentialsProvider(CredentialsProvider):
87
+ """Read AWS_ACCESS_KEY_ID / AWS_SECRET_ACCESS_KEY / AWS_SESSION_TOKEN."""
88
+
89
+ def resolve_identity(self) -> Credentials:
90
+ ak = os.environ.get("AWS_ACCESS_KEY_ID")
91
+ sk = os.environ.get("AWS_SECRET_ACCESS_KEY")
92
+ if not ak or not sk:
93
+ raise IdentityNotFound("AWS_ACCESS_KEY_ID / AWS_SECRET_ACCESS_KEY unset")
94
+ out: Credentials = {"access_key": ak, "secret_key": sk}
95
+ token = os.environ.get("AWS_SESSION_TOKEN")
96
+ if token:
97
+ out["session_token"] = token
98
+ return out
99
+
100
+
101
+ class ProfileCredentialsProvider(CredentialsProvider):
102
+ """Read ~/.aws/credentials and ~/.aws/config for the active profile."""
103
+
104
+ def __init__(
105
+ self,
106
+ profile: str | None = None,
107
+ credentials_file: Path | None = None,
108
+ config_file: Path | None = None,
109
+ ) -> None:
110
+ self._profile = profile or os.environ.get("AWS_PROFILE", "default")
111
+ self._cred_file = credentials_file or Path(
112
+ os.environ.get("AWS_SHARED_CREDENTIALS_FILE")
113
+ or Path.home() / ".aws" / "credentials"
114
+ )
115
+ self._cfg_file = config_file or Path(
116
+ os.environ.get("AWS_CONFIG_FILE") or Path.home() / ".aws" / "config"
117
+ )
118
+
119
+ def resolve_identity(self) -> Credentials:
120
+ section = self._load_profile()
121
+ ak = section.get("aws_access_key_id")
122
+ sk = section.get("aws_secret_access_key")
123
+ if not ak or not sk:
124
+ raise IdentityNotFound(
125
+ f"profile {self._profile!r}: missing aws_access_key_id/aws_secret_access_key"
126
+ )
127
+ out: Credentials = {"access_key": ak, "secret_key": sk}
128
+ token = section.get("aws_session_token")
129
+ if token:
130
+ out["session_token"] = token
131
+ return out
132
+
133
+ def _load_profile(self) -> dict[str, str]:
134
+ merged: dict[str, str] = {}
135
+ if self._cfg_file.is_file():
136
+ cfg = configparser.ConfigParser()
137
+ cfg.read(self._cfg_file)
138
+ # config file profiles look like `[profile foo]`, except default
139
+ key = (
140
+ "default" if self._profile == "default" else f"profile {self._profile}"
141
+ )
142
+ if cfg.has_section(key):
143
+ merged.update(dict(cfg.items(key)))
144
+ if self._cred_file.is_file():
145
+ cfg = configparser.ConfigParser()
146
+ cfg.read(self._cred_file)
147
+ if cfg.has_section(self._profile):
148
+ merged.update(dict(cfg.items(self._profile)))
149
+ if not merged:
150
+ raise IdentityNotFound(
151
+ f"profile {self._profile!r} not found in {self._cred_file} or {self._cfg_file}"
152
+ )
153
+ return merged
154
+
155
+
156
+ def default_aws_credentials_chain() -> IdentityProvider[Credentials]:
157
+ return CachedProvider(
158
+ ChainedProvider(EnvCredentialsProvider(), ProfileCredentialsProvider())
159
+ )
@@ -0,0 +1,84 @@
1
+ from __future__ import annotations
2
+
3
+ from abc import ABC, abstractmethod
4
+ from typing import Any, Generic, TypeVar
5
+
6
+ from zapros import Request
7
+
8
+ from aws_sdk_cloudfront_keyvaluestore._auth._identity import Credentials, Identity
9
+ from aws_sdk_cloudfront_keyvaluestore._auth._providers import IdentityProvider
10
+ from aws_sdk_cloudfront_keyvaluestore._auth._sigv4 import SigV4AuthContext, sign_sigv4
11
+
12
+ IdentityT = TypeVar("IdentityT", bound="Identity")
13
+
14
+
15
+ class Signer(ABC, Generic[IdentityT]):
16
+ """Per-request request signer. Holds an IdentityProvider plus static config."""
17
+
18
+ def __init__(self, provider: IdentityProvider[IdentityT]) -> None:
19
+ self.provider = provider
20
+
21
+ @abstractmethod
22
+ async def asign(self, req: Request) -> Request: ...
23
+ @abstractmethod
24
+ def sign(self, req: Request) -> Request: ...
25
+
26
+
27
+ class SigV4Signer(Signer[Credentials]):
28
+ """aws.auth#sigv4 — AWS Signature Version 4.
29
+
30
+ The full auth scheme (``name`` variant, ``signingName``, ``signingRegion``,
31
+ encoding/normalization flags) is provided by the caller — either from the
32
+ endpoint rule-set's ``authSchemes`` property or built by the generated
33
+ ``get_signer`` from operation defaults.
34
+ """
35
+
36
+ def __init__(
37
+ self, provider: IdentityProvider[Credentials], *, auth_scheme: dict[str, Any]
38
+ ) -> None:
39
+ super().__init__(provider)
40
+ self._auth_scheme = auth_scheme
41
+
42
+ async def asign(self, req: Request) -> Request:
43
+ creds = self.provider.resolve_identity()
44
+ ctx: SigV4AuthContext = {
45
+ "type": "sig_v4",
46
+ "access_key_id": creds["access_key"],
47
+ "secret_access_key": creds["secret_key"],
48
+ "session_token": creds.get("session_token"),
49
+ "signing_region": self._auth_scheme["signingRegion"],
50
+ "signing_name": self._auth_scheme["signingName"],
51
+ }
52
+ if req.body is None:
53
+ body: bytes | None = b""
54
+ elif isinstance(req.body, bytes):
55
+ body = req.body
56
+ else:
57
+ body = None
58
+ # Strip Accept-Encoding so transports/intermediaries can't transcode
59
+ # the response and so the value never enters the canonical request.
60
+ if "accept-encoding" in req.headers:
61
+ del req.headers["Accept-Encoding"]
62
+ return sign_sigv4(req, ctx, body)
63
+
64
+ def sign(self, req: Request) -> Request:
65
+ creds = self.provider.resolve_identity()
66
+ ctx: SigV4AuthContext = {
67
+ "type": "sig_v4",
68
+ "access_key_id": creds["access_key"],
69
+ "secret_access_key": creds["secret_key"],
70
+ "session_token": creds.get("session_token"),
71
+ "signing_region": self._auth_scheme["signingRegion"],
72
+ "signing_name": self._auth_scheme["signingName"],
73
+ }
74
+ if req.body is None:
75
+ body: bytes | None = b""
76
+ elif isinstance(req.body, bytes):
77
+ body = req.body
78
+ else:
79
+ body = None
80
+ # Strip Accept-Encoding so transports/intermediaries can't transcode
81
+ # the response and so the value never enters the canonical request.
82
+ if "accept-encoding" in req.headers:
83
+ del req.headers["Accept-Encoding"]
84
+ return sign_sigv4(req, ctx, body)