aws-sdk-s3 0.1.0__tar.gz

aws_sdk_s3-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Karen Petrosyan
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

aws_sdk_s3-0.1.0/PKG-INFO

@@ -0,0 +1,90 @@
+Metadata-Version: 2.4
+Name: aws-sdk-s3
+Version: 0.1.0
+Summary: Add your description here
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Software Development :: Code Generators
+Classifier: Typing :: Typed
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pywhatwgurl>=0.1.0
+Requires-Dist: zapros>=0.12.0
+Dynamic: license-file
+
+# Getting Started
+
+## Installation
+
+```
+pip install aws-s3
+```
+
+## Usage
+
+```python
+from aws_sdk_python import AsyncS3Client
+
+
+async def main():
+    async with AsyncS3Client() as s3:
+        # Example: call the abort_multipart_upload operation
+        response = await s3.abort_multipart_upload()
+        print(response["request_charged"])
+```
+
+## Pagination
+
+Some operations in this SDK support pagination. If the operation supports pagination it will have an `iter_` prefixed method that returns an async iterator.
+
+```python
+from aws_sdk_python import AsyncS3Client
+
+
+async def main():
+    async with AsyncS3Client() as s3:
+        # Example: paginate over list_buckets
+        async for item in s3.iter_list_buckets():
+            print(item)
+```
+
+## Waiters
+
+Waiters poll an operation until a resource reaches a desired state. If the operation supports waiters it will have a `wait_` prefixed method.
+
+```python
+from aws_sdk_python import AsyncS3Client
+
+
+async def main():
+    async with AsyncS3Client() as s3:
+        # Example: wait for bucket_exists
+        await s3.wait_bucket_exists(max_wait_time=300)
+```
+
+## Error Handling
+
+The SDK raises exceptions for errors returned by the API. Catch them to handle failures gracefully.
+
+```python
+from aws_sdk_python import AsyncS3Client
+from aws_sdk_python.error import NoSuchUpload
+
+
+async def main():
+    async with AsyncS3Client() as s3:
+        try:
+            await s3.abort_multipart_upload()
+        except NoSuchUpload as e:
+            print(f"Error: {e}")
+            print(e.data)  # additional error data
+```

aws_sdk_s3-0.1.0/README.md

@@ -0,0 +1,67 @@
+# Getting Started
+
+## Installation
+
+```
+pip install aws-s3
+```
+
+## Usage
+
+```python
+from aws_sdk_python import AsyncS3Client
+
+
+async def main():
+    async with AsyncS3Client() as s3:
+        # Example: call the abort_multipart_upload operation
+        response = await s3.abort_multipart_upload()
+        print(response["request_charged"])
+```
+
+## Pagination
+
+Some operations in this SDK support pagination. If the operation supports pagination it will have an `iter_` prefixed method that returns an async iterator.
+
+```python
+from aws_sdk_python import AsyncS3Client
+
+
+async def main():
+    async with AsyncS3Client() as s3:
+        # Example: paginate over list_buckets
+        async for item in s3.iter_list_buckets():
+            print(item)
+```
+
+## Waiters
+
+Waiters poll an operation until a resource reaches a desired state. If the operation supports waiters it will have a `wait_` prefixed method.
+
+```python
+from aws_sdk_python import AsyncS3Client
+
+
+async def main():
+    async with AsyncS3Client() as s3:
+        # Example: wait for bucket_exists
+        await s3.wait_bucket_exists(max_wait_time=300)
+```
+
+## Error Handling
+
+The SDK raises exceptions for errors returned by the API. Catch them to handle failures gracefully.
+
+```python
+from aws_sdk_python import AsyncS3Client
+from aws_sdk_python.error import NoSuchUpload
+
+
+async def main():
+    async with AsyncS3Client() as s3:
+        try:
+            await s3.abort_multipart_upload()
+        except NoSuchUpload as e:
+            print(f"Error: {e}")
+            print(e.data)  # additional error data
+```

aws_sdk_s3-0.1.0/pyproject.toml

@@ -0,0 +1,44 @@
+[project]
+name = "aws-sdk-s3"
+version = "0.1.0"
+description = "Add your description here"
+readme = "README.md"
+requires-python = ">=3.10"
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+    "Topic :: Software Development :: Code Generators",
+    "Typing :: Typed",
+]
+dependencies = [
+    "pywhatwgurl>=0.1.0",
+    "zapros>=0.12.0",
+]
+
+[tool.pytest.ini_options]
+pythonpath = ["src"]
+testpaths = ["tests"]
+
+[tool.pyright]
+include = ["src", "tests"]
+extraPaths = ["src"]
+pythonVersion = "3.14"
+
+[dependency-groups]
+dev = [
+    "inline-snapshot>=0.33.0",
+    "pyright>=1.1.409",
+    "pytest>=9.0.3",
+    "ruff>=0.15.14",
+    "zensical>=0.0.42",
+    "mkdocstrings",
+    "mkdocstrings[python]",
+]

aws_sdk_s3-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

aws_sdk_s3-0.1.0/src/aws_sdk_s3/__init__.py

@@ -0,0 +1,15 @@
+from __future__ import annotations
+from ._auth._identity import Identity as Identity, Credentials as Credentials
+from ._auth._providers import (
+    IdentityNotFound as IdentityNotFound,
+    IdentityProvider as IdentityProvider,
+    ChainedProvider as ChainedProvider,
+    CachedProvider as CachedProvider,
+    CredentialsProvider as CredentialsProvider,
+    StaticAwsCredentialsProvider as StaticAwsCredentialsProvider,
+    EnvCredentialsProvider as EnvCredentialsProvider,
+    ProfileCredentialsProvider as ProfileCredentialsProvider,
+)
+from ._auth._signers import Signer as Signer, SigV4Signer as SigV4Signer
+from ._services.amazon_s3 import S3Client as S3Client
+from ._services.async_amazon_s3 import AsyncS3Client as AsyncS3Client

aws_sdk_s3-0.1.0/src/aws_sdk_s3/_auth/_identity.py

@@ -0,0 +1,14 @@
+from __future__ import annotations
+
+from datetime import datetime
+from typing import NotRequired, TypedDict
+
+
+class Identity(TypedDict):
+    expiration: NotRequired[datetime | None]
+
+
+class Credentials(Identity):
+    access_key: str
+    secret_key: str
+    session_token: NotRequired[str | None]

aws_sdk_s3-0.1.0/src/aws_sdk_s3/_auth/_providers.py

@@ -0,0 +1,162 @@
+from __future__ import annotations
+
+import configparser
+import os
+from abc import abstractmethod
+from datetime import datetime, timezone
+from pathlib import Path
+from typing import Generic, TypeVar
+
+from aws_sdk_s3._auth._identity import (
+    Credentials,
+    Identity,
+)
+
+
+class IdentityNotFound(Exception):
+    """Raised when a provider cannot resolve an identity. Chain continues."""
+
+
+IdentityT = TypeVar("IdentityT", bound="Identity")
+
+
+class IdentityProvider(Generic[IdentityT]):
+    @abstractmethod
+    def resolve_identity(self) -> IdentityT:
+        raise NotImplementedError
+
+
+class ChainedProvider(IdentityProvider[IdentityT]):
+    """Try each provider in order; first non-`IdentityNotFound` wins."""
+
+    def __init__(self, *providers: IdentityProvider[IdentityT]) -> None:
+        if not providers:
+            raise ValueError("ChainedProvider requires at least one provider")
+        self._providers = providers
+
+    def resolve_identity(self) -> IdentityT:
+        errors: list[str] = []
+        for p in self._providers:
+            try:
+                return p.resolve_identity()
+            except IdentityNotFound as e:
+                errors.append(f"{type(p).__name__}: {e}")
+        raise IdentityNotFound("no provider succeeded: " + "; ".join(errors))
+
+
+class CachedProvider(IdentityProvider[IdentityT]):
+    """Cache an identity until its `expiration` (minus skew) elapses."""
+
+    _SKEW_SECONDS = 60
+
+    def __init__(self, inner: IdentityProvider[IdentityT]) -> None:
+        self._inner = inner
+        self._cached: IdentityT | None = None
+
+    def resolve_identity(self) -> IdentityT:
+        if self._cached is not None and not self._expired(self._cached):
+            return self._cached
+        self._cached = self._inner.resolve_identity()
+        return self._cached
+
+    @classmethod
+    def _expired(cls, ident: Identity) -> bool:
+        exp = ident.get("expiration")
+        if exp is None:
+            return False
+        return (exp - datetime.now(timezone.utc)).total_seconds() <= cls._SKEW_SECONDS
+
+
+class CredentialsProvider(IdentityProvider[Credentials]):
+    """Base class for providers that resolve AWS `Credentials`."""
+
+    @abstractmethod
+    def resolve_identity(self) -> Credentials:
+        raise NotImplementedError
+
+
+class StaticAwsCredentialsProvider(CredentialsProvider):
+    def __init__(self, credentials: Credentials) -> None:
+        self._credentials = credentials
+
+    def resolve_identity(self) -> Credentials:
+        return self._credentials
+
+
+class EnvCredentialsProvider(CredentialsProvider):
+    """Read AWS_ACCESS_KEY_ID / AWS_SECRET_ACCESS_KEY / AWS_SESSION_TOKEN."""
+
+    def resolve_identity(self) -> Credentials:
+        ak = os.environ.get("AWS_ACCESS_KEY_ID")
+        sk = os.environ.get("AWS_SECRET_ACCESS_KEY")
+        if not ak or not sk:
+            raise IdentityNotFound("AWS_ACCESS_KEY_ID / AWS_SECRET_ACCESS_KEY unset")
+        out: Credentials = {"access_key": ak, "secret_key": sk}
+        token = os.environ.get("AWS_SESSION_TOKEN")
+        if token:
+            out["session_token"] = token
+        return out
+
+
+class ProfileCredentialsProvider(CredentialsProvider):
+    """Read ~/.aws/credentials and ~/.aws/config for the active profile."""
+
+    def __init__(
+        self,
+        profile: str | None = None,
+        credentials_file: Path | None = None,
+        config_file: Path | None = None,
+    ) -> None:
+        self._profile = profile or os.environ.get("AWS_PROFILE", "default")
+        self._cred_file = credentials_file or Path(
+            os.environ.get("AWS_SHARED_CREDENTIALS_FILE")
+            or Path.home() / ".aws" / "credentials"
+        )
+        self._cfg_file = config_file or Path(
+            os.environ.get("AWS_CONFIG_FILE") or Path.home() / ".aws" / "config"
+        )
+
+    def resolve_identity(self) -> Credentials:
+        section = self._load_profile()
+        ak = section.get("aws_access_key_id")
+        sk = section.get("aws_secret_access_key")
+        if not ak or not sk:
+            raise IdentityNotFound(
+                f"profile {self._profile!r}: missing aws_access_key_id/aws_secret_access_key"
+            )
+        out: Credentials = {"access_key": ak, "secret_key": sk}
+        token = section.get("aws_session_token")
+        if token:
+            out["session_token"] = token
+        return out
+
+    def _load_profile(self) -> dict[str, str]:
+        merged: dict[str, str] = {}
+        if self._cfg_file.is_file():
+            cfg = configparser.ConfigParser()
+            cfg.read(self._cfg_file)
+            # config file profiles look like `[profile foo]`, except default
+            key = (
+                "default" if self._profile == "default" else f"profile {self._profile}"
+            )
+            if cfg.has_section(key):
+                merged.update(dict(cfg.items(key)))
+        if self._cred_file.is_file():
+            cfg = configparser.ConfigParser()
+            cfg.read(self._cred_file)
+            if cfg.has_section(self._profile):
+                merged.update(dict(cfg.items(self._profile)))
+        if not merged:
+            raise IdentityNotFound(
+                f"profile {self._profile!r} not found in {self._cred_file} or {self._cfg_file}"
+            )
+        return merged
+
+
+def default_aws_credentials_chain() -> IdentityProvider[Credentials]:
+    return CachedProvider(
+        ChainedProvider(
+            EnvCredentialsProvider(),
+            ProfileCredentialsProvider(),
+        )
+    )

aws_sdk_s3-0.1.0/src/aws_sdk_s3/_auth/_signers.py

@@ -0,0 +1,97 @@
+from __future__ import annotations
+
+from abc import ABC, abstractmethod
+
+from typing import Generic, TypeVar
+
+from typing import Any
+
+from collections.abc import AsyncIterator
+
+from zapros import Request
+
+from aws_sdk_s3._auth._sigv4 import SigV4AuthContext, sign_sigv4
+
+from aws_sdk_s3._auth._identity import Credentials, Identity
+
+from aws_sdk_s3._auth._providers import IdentityProvider
+
+IdentityT = TypeVar("IdentityT", bound="Identity")
+
+
+class Signer(ABC, Generic[IdentityT]):
+    """Per-request request signer. Holds an IdentityProvider plus static config."""
+
+    def __init__(self, provider: IdentityProvider[IdentityT]) -> None:
+        self.provider = provider
+
+    @abstractmethod
+    async def asign(self, req: Request) -> Request: ...
+    @abstractmethod
+    def sign(self, req: Request) -> Request: ...
+
+
+class SigV4Signer(Signer[Credentials]):
+    """aws.auth#sigv4 — AWS Signature Version 4.
+
+    The full auth scheme (``name`` variant, ``signingName``, ``signingRegion``,
+    encoding/normalization flags) is provided by the caller — either from the
+    endpoint rule-set's ``authSchemes`` property or built by the generated
+    ``get_signer`` from operation defaults.
+    """
+
+    def __init__(
+        self, provider: IdentityProvider[Credentials], *, auth_scheme: dict[str, Any]
+    ) -> None:
+        super().__init__(provider)
+        self._auth_scheme = auth_scheme
+
+    async def asign(self, req: Request) -> Request:
+        creds = self.provider.resolve_identity()
+        ctx: SigV4AuthContext = {
+            "type": "sig_v4",
+            "access_key_id": creds["access_key"],
+            "secret_access_key": creds["secret_key"],
+            "session_token": creds.get("session_token"),
+            "signing_region": self._auth_scheme["signingRegion"],
+            "signing_name": self._auth_scheme["signingName"],
+        }
+        if req.body is None:
+            body = b""
+        elif isinstance(req.body, bytes):
+            body = req.body
+        else:
+            assert not isinstance(req.body, AsyncIterator), (
+                "SigV4 single-chunk signing requires a fully buffered body; got an async stream."
+            )
+            body = b"".join(req.body)
+        # Strip Accept-Encoding so transports/intermediaries can't transcode
+        # the response and so the value never enters the canonical request.
+        if "accept-encoding" in req.headers:
+            del req.headers["Accept-Encoding"]
+        return sign_sigv4(req, ctx, body)
+
+    def sign(self, req: Request) -> Request:
+        creds = self.provider.resolve_identity()
+        ctx: SigV4AuthContext = {
+            "type": "sig_v4",
+            "access_key_id": creds["access_key"],
+            "secret_access_key": creds["secret_key"],
+            "session_token": creds.get("session_token"),
+            "signing_region": self._auth_scheme["signingRegion"],
+            "signing_name": self._auth_scheme["signingName"],
+        }
+        if req.body is None:
+            body = b""
+        elif isinstance(req.body, bytes):
+            body = req.body
+        else:
+            assert not isinstance(req.body, AsyncIterator), (
+                "SigV4 single-chunk signing requires a fully buffered body; got an async stream."
+            )
+            body = b"".join(req.body)
+        # Strip Accept-Encoding so transports/intermediaries can't transcode
+        # the response and so the value never enters the canonical request.
+        if "accept-encoding" in req.headers:
+            del req.headers["Accept-Encoding"]
+        return sign_sigv4(req, ctx, body)