silo-python-sdk 0.1.0__py3-none-any.whl

silo/__init__.py

@@ -0,0 +1,8 @@
+"""Unofficial Silo Python SDK, powered by minio 7.2.20."""
+from minio import Minio
+from minio.error import S3Error
+
+from .client import Silo
+
+__version__ = "0.1.0"
+__all__ = ["Silo", "Minio", "S3Error", "__version__"]

silo/api.py

@@ -0,0 +1,104 @@
+"""Compatibility exports from minio.api (minio 7.2.20)."""
+from minio.api import (
+    Any as Any,
+    BaseHTTPResponse as BaseHTTPResponse,
+    BaseURL as BaseURL,
+    BinaryIO as BinaryIO,
+    Bucket as Bucket,
+    BytesIO as BytesIO,
+    COPY as COPY,
+    CompleteMultipartUploadResult as CompleteMultipartUploadResult,
+    ComposeSource as ComposeSource,
+    CopySource as CopySource,
+    Credentials as Credentials,
+    DeleteError as DeleteError,
+    DeleteObject as DeleteObject,
+    DeleteRequest as DeleteRequest,
+    DeleteResult as DeleteResult,
+    DictType as DictType,
+    ET as ET,
+    Element as Element,
+    EventIterable as EventIterable,
+    HTTPHeaderDict as HTTPHeaderDict,
+    InvalidResponseError as InvalidResponseError,
+    Iterable as Iterable,
+    Iterator as Iterator,
+    LegalHold as LegalHold,
+    LifecycleConfig as LifecycleConfig,
+    ListAllMyBucketsResult as ListAllMyBucketsResult,
+    ListMultipartUploadsResult as ListMultipartUploadsResult,
+    ListPartsResult as ListPartsResult,
+    MAX_MULTIPART_COUNT as MAX_MULTIPART_COUNT,
+    MAX_MULTIPART_OBJECT_SIZE as MAX_MULTIPART_OBJECT_SIZE,
+    MAX_PART_SIZE as MAX_PART_SIZE,
+    MIN_PART_SIZE as MIN_PART_SIZE,
+    Minio as Minio,
+    NotificationConfig as NotificationConfig,
+    Object as Object,
+    ObjectLockConfig as ObjectLockConfig,
+    ObjectWriteResult as ObjectWriteResult,
+    Optional as Optional,
+    Part as Part,
+    PostPolicy as PostPolicy,
+    ProgressType as ProgressType,
+    Provider as Provider,
+    REPLACE as REPLACE,
+    ReplicationConfig as ReplicationConfig,
+    Retention as Retention,
+    Retry as Retry,
+    S3Error as S3Error,
+    SSEConfig as SSEConfig,
+    SelectObjectReader as SelectObjectReader,
+    SelectRequest as SelectRequest,
+    ServerError as ServerError,
+    SnowballObject as SnowballObject,
+    Sse as Sse,
+    SseCustomerKey as SseCustomerKey,
+    StaticProvider as StaticProvider,
+    SubElement as SubElement,
+    Tagging as Tagging,
+    Tags as Tags,
+    TextIO as TextIO,
+    ThreadPool as ThreadPool,
+    Timeout as Timeout,
+    Tuple as Tuple,
+    Union as Union,
+    VersioningConfig as VersioningConfig,
+    absolute_import as absolute_import,
+    annotations as annotations,
+    cast as cast,
+    certifi as certifi,
+    check_bucket_name as check_bucket_name,
+    check_object_name as check_object_name,
+    check_sse as check_sse,
+    check_ssec as check_ssec,
+    datetime as datetime,
+    findtext as findtext,
+    genheaders as genheaders,
+    get_part_info as get_part_info,
+    getbytes as getbytes,
+    headers_to_strings as headers_to_strings,
+    is_valid_policy_type as is_valid_policy_type,
+    itertools as itertools,
+    json as json,
+    makedirs as makedirs,
+    marshal as marshal,
+    md5sum_hash as md5sum_hash,
+    os as os,
+    parse_copy_object as parse_copy_object,
+    parse_list_objects as parse_list_objects,
+    presign_v4 as presign_v4,
+    queryencode as queryencode,
+    random as random,
+    read_part_data as read_part_data,
+    sha256_hash as sha256_hash,
+    sign_v4_s3 as sign_v4_s3,
+    tarfile as tarfile,
+    time as time,
+    timedelta as timedelta,
+    unmarshal as unmarshal,
+    urllib3 as urllib3,
+    urlunsplit as urlunsplit,
+)
+
+__all__ = ['Any', 'BaseHTTPResponse', 'BaseURL', 'BinaryIO', 'Bucket', 'BytesIO', 'COPY', 'CompleteMultipartUploadResult', 'ComposeSource', 'CopySource', 'Credentials', 'DeleteError', 'DeleteObject', 'DeleteRequest', 'DeleteResult', 'DictType', 'ET', 'Element', 'EventIterable', 'HTTPHeaderDict', 'InvalidResponseError', 'Iterable', 'Iterator', 'LegalHold', 'LifecycleConfig', 'ListAllMyBucketsResult', 'ListMultipartUploadsResult', 'ListPartsResult', 'MAX_MULTIPART_COUNT', 'MAX_MULTIPART_OBJECT_SIZE', 'MAX_PART_SIZE', 'MIN_PART_SIZE', 'Minio', 'NotificationConfig', 'Object', 'ObjectLockConfig', 'ObjectWriteResult', 'Optional', 'Part', 'PostPolicy', 'ProgressType', 'Provider', 'REPLACE', 'ReplicationConfig', 'Retention', 'Retry', 'S3Error', 'SSEConfig', 'SelectObjectReader', 'SelectRequest', 'ServerError', 'SnowballObject', 'Sse', 'SseCustomerKey', 'StaticProvider', 'SubElement', 'Tagging', 'Tags', 'TextIO', 'ThreadPool', 'Timeout', 'Tuple', 'Union', 'VersioningConfig', 'absolute_import', 'annotations', 'cast', 'certifi', 'check_bucket_name', 'check_object_name', 'check_sse', 'check_ssec', 'datetime', 'findtext', 'genheaders', 'get_part_info', 'getbytes', 'headers_to_strings', 'is_valid_policy_type', 'itertools', 'json', 'makedirs', 'marshal', 'md5sum_hash', 'os', 'parse_copy_object', 'parse_list_objects', 'presign_v4', 'queryencode', 'random', 'read_part_data', 'sha256_hash', 'sign_v4_s3', 'tarfile', 'time', 'timedelta', 'unmarshal', 'urllib3', 'urlunsplit']

silo/client.py

@@ -0,0 +1,65 @@
+"""Silo convenience methods; all upstream MinIO methods remain inherited."""
+import os
+from io import BytesIO
+
+from minio import Minio
+from minio.helpers import ObjectWriteResult
+
+
+class Silo(Minio):
+    """Silo S3 client with the unchanged Minio constructor and public API."""
+
+    @classmethod
+    def from_env(cls) -> "Silo":
+        """Read SILO_* credentials; HTTPS defaults on, booleans are true/false.
+
+        SILO_ENDPOINT uses the upstream host:port format, without a URL scheme.
+        Missing credentials or an invalid SILO_SECURE value raise ValueError.
+        """
+        values = {}
+        for key in ("SILO_ENDPOINT", "SILO_ACCESS_KEY", "SILO_SECRET_KEY"):
+            value = os.environ.get(key)
+            if value is None or not value.strip():
+                raise ValueError(f"{key} is required")
+            values[key] = value
+        secure = os.environ.get("SILO_SECURE", "true").strip().lower()
+        if secure not in ("true", "false"):
+            raise ValueError("SILO_SECURE must be 'true' or 'false'")
+        return cls(
+            values["SILO_ENDPOINT"].strip(),
+            access_key=values["SILO_ACCESS_KEY"],
+            secret_key=values["SILO_SECRET_KEY"],
+            secure=secure == "true",
+        )
+
+    def upload_bytes(
+        self,
+        bucket_name: str,
+        object_name: str,
+        data: bytes,
+        content_type: str = "application/octet-stream",
+    ) -> ObjectWriteResult:
+        """Upload in-memory bytes and return the upstream ObjectWriteResult.
+
+        For streams, metadata, encryption or large files, use inherited
+        put_object/fput_object with their complete upstream options.
+        """
+        return self.put_object(
+            bucket_name, object_name, BytesIO(data), len(data),
+            content_type=content_type,
+        )
+
+    def download_bytes(self, bucket_name: str, object_name: str) -> bytes:
+        """Read an object fully into memory, always releasing the connection.
+
+        For large objects, ranges or version IDs, use inherited get_object
+        or fget_object. S3/network errors propagate unchanged.
+        """
+        response = self.get_object(bucket_name, object_name)
+        try:
+            return response.read()
+        finally:
+            try:
+                response.close()
+            finally:
+                response.release_conn()

silo/commonconfig.py

@@ -0,0 +1,48 @@
+"""Compatibility exports from minio.commonconfig (minio 7.2.20)."""
+from minio.commonconfig import (
+    A as A,
+    ABC as ABC,
+    AndOperator as AndOperator,
+    B as B,
+    BaseRule as BaseRule,
+    C as C,
+    COMPLIANCE as COMPLIANCE,
+    COPY as COPY,
+    ComposeSource as ComposeSource,
+    CopySource as CopySource,
+    D as D,
+    DISABLED as DISABLED,
+    E as E,
+    ENABLED as ENABLED,
+    ET as ET,
+    F as F,
+    Filter as Filter,
+    GOVERNANCE as GOVERNANCE,
+    IO as IO,
+    MinioException as MinioException,
+    ObjectConditionalReadArgs as ObjectConditionalReadArgs,
+    Optional as Optional,
+    REPLACE as REPLACE,
+    SnowballObject as SnowballObject,
+    SseCustomerKey as SseCustomerKey,
+    SubElement as SubElement,
+    Tag as Tag,
+    Tags as Tags,
+    Type as Type,
+    TypeVar as TypeVar,
+    absolute_import as absolute_import,
+    abstractmethod as abstractmethod,
+    annotations as annotations,
+    cast as cast,
+    check_status as check_status,
+    dataclass as dataclass,
+    datetime as datetime,
+    field as field,
+    find as find,
+    findall as findall,
+    findtext as findtext,
+    quote as quote,
+    to_http_header as to_http_header,
+)
+
+__all__ = ['A', 'ABC', 'AndOperator', 'B', 'BaseRule', 'C', 'COMPLIANCE', 'COPY', 'ComposeSource', 'CopySource', 'D', 'DISABLED', 'E', 'ENABLED', 'ET', 'F', 'Filter', 'GOVERNANCE', 'IO', 'MinioException', 'ObjectConditionalReadArgs', 'Optional', 'REPLACE', 'SnowballObject', 'SseCustomerKey', 'SubElement', 'Tag', 'Tags', 'Type', 'TypeVar', 'absolute_import', 'abstractmethod', 'annotations', 'cast', 'check_status', 'dataclass', 'datetime', 'field', 'find', 'findall', 'findtext', 'quote', 'to_http_header']

silo/credentials/__init__.py

@@ -0,0 +1,26 @@
+"""Compatibility exports from minio.credentials (minio 7.2.20)."""
+from minio.credentials import (
+    AWSConfigProvider as AWSConfigProvider,
+    AssumeRoleProvider as AssumeRoleProvider,
+    CertificateIdentityProvider as CertificateIdentityProvider,
+    ChainedProvider as ChainedProvider,
+    ClientGrantsProvider as ClientGrantsProvider,
+    Credentials as Credentials,
+    EnvAWSProvider as EnvAWSProvider,
+    EnvMinioProvider as EnvMinioProvider,
+    IamAwsProvider as IamAwsProvider,
+    LdapIdentityProvider as LdapIdentityProvider,
+    MinioClientConfigProvider as MinioClientConfigProvider,
+    Provider as Provider,
+    StaticProvider as StaticProvider,
+    WebIdentityProvider as WebIdentityProvider,
+    credentials as credentials,
+    providers as providers,
+)
+
+__all__ = ['AWSConfigProvider', 'AssumeRoleProvider', 'CertificateIdentityProvider', 'ChainedProvider', 'ClientGrantsProvider', 'Credentials', 'EnvAWSProvider', 'EnvMinioProvider', 'IamAwsProvider', 'LdapIdentityProvider', 'MinioClientConfigProvider', 'Provider', 'StaticProvider', 'WebIdentityProvider', 'credentials', 'providers']
+
+# Preserve upstream module identity even when consumers import child modules.
+import sys as _sys
+_sys.modules[__name__ + '.credentials'] = credentials
+_sys.modules[__name__ + '.providers'] = providers

silo/credentials/credentials.py

@@ -0,0 +1,12 @@
+"""Compatibility exports from minio.credentials.credentials (minio 7.2.20)."""
+from minio.credentials.credentials import (
+    Credentials as Credentials,
+    Optional as Optional,
+    annotations as annotations,
+    dataclass as dataclass,
+    datetime as datetime,
+    timedelta as timedelta,
+    timezone as timezone,
+)
+
+__all__ = ['Credentials', 'Optional', 'annotations', 'dataclass', 'datetime', 'timedelta', 'timezone']

silo/credentials/providers.py

@@ -0,0 +1,53 @@
+"""Compatibility exports from minio.credentials.providers (minio 7.2.20)."""
+from minio.credentials.providers import (
+    ABC as ABC,
+    AWSConfigProvider as AWSConfigProvider,
+    AssumeRoleProvider as AssumeRoleProvider,
+    BaseHTTPResponse as BaseHTTPResponse,
+    Callable as Callable,
+    CertificateIdentityProvider as CertificateIdentityProvider,
+    ChainedProvider as ChainedProvider,
+    ClientGrantsProvider as ClientGrantsProvider,
+    Credentials as Credentials,
+    ET as ET,
+    EnvAWSProvider as EnvAWSProvider,
+    EnvMinioProvider as EnvMinioProvider,
+    IamAwsProvider as IamAwsProvider,
+    LdapIdentityProvider as LdapIdentityProvider,
+    MinioClientConfigProvider as MinioClientConfigProvider,
+    Optional as Optional,
+    Path as Path,
+    PoolManager as PoolManager,
+    Provider as Provider,
+    Retry as Retry,
+    StaticProvider as StaticProvider,
+    WebIdentityClientGrantsProvider as WebIdentityClientGrantsProvider,
+    WebIdentityProvider as WebIdentityProvider,
+    abstractmethod as abstractmethod,
+    annotations as annotations,
+    cast as cast,
+    certifi as certifi,
+    configparser as configparser,
+    find as find,
+    findtext as findtext,
+    from_iso8601utc as from_iso8601utc,
+    ipaddress as ipaddress,
+    json as json,
+    os as os,
+    parse_url as parse_url,
+    re as re,
+    sha256_hash as sha256_hash,
+    sign_v4_sts as sign_v4_sts,
+    socket as socket,
+    sys as sys,
+    time as time,
+    timedelta as timedelta,
+    to_amz_date as to_amz_date,
+    url_replace as url_replace,
+    urlencode as urlencode,
+    urlsplit as urlsplit,
+    urlunsplit as urlunsplit,
+    utcnow as utcnow,
+)
+
+__all__ = ['ABC', 'AWSConfigProvider', 'AssumeRoleProvider', 'BaseHTTPResponse', 'Callable', 'CertificateIdentityProvider', 'ChainedProvider', 'ClientGrantsProvider', 'Credentials', 'ET', 'EnvAWSProvider', 'EnvMinioProvider', 'IamAwsProvider', 'LdapIdentityProvider', 'MinioClientConfigProvider', 'Optional', 'Path', 'PoolManager', 'Provider', 'Retry', 'StaticProvider', 'WebIdentityClientGrantsProvider', 'WebIdentityProvider', 'abstractmethod', 'annotations', 'cast', 'certifi', 'configparser', 'find', 'findtext', 'from_iso8601utc', 'ipaddress', 'json', 'os', 'parse_url', 're', 'sha256_hash', 'sign_v4_sts', 'socket', 'sys', 'time', 'timedelta', 'to_amz_date', 'url_replace', 'urlencode', 'urlsplit', 'urlunsplit', 'utcnow']

silo/crypto.py

@@ -0,0 +1,18 @@
+"""Compatibility exports from minio.crypto (minio 7.2.20)."""
+from minio.crypto import (
+    AES as AES,
+    BaseHTTPResponse as BaseHTTPResponse,
+    ChaCha20Poly1305Cipher as ChaCha20Poly1305Cipher,
+    ChaCha20_Poly1305 as ChaCha20_Poly1305,
+    DecryptReader as DecryptReader,
+    GcmMode as GcmMode,
+    Type as Type,
+    absolute_import as absolute_import,
+    annotations as annotations,
+    decrypt as decrypt,
+    encrypt as encrypt,
+    hash_secret_raw as hash_secret_raw,
+    os as os,
+)
+
+__all__ = ['AES', 'BaseHTTPResponse', 'ChaCha20Poly1305Cipher', 'ChaCha20_Poly1305', 'DecryptReader', 'GcmMode', 'Type', 'absolute_import', 'annotations', 'decrypt', 'encrypt', 'hash_secret_raw', 'os']

silo/datatypes.py

@@ -0,0 +1,56 @@
+"""Compatibility exports from minio.datatypes (minio 7.2.20)."""
+from minio.datatypes import (
+    A as A,
+    Any as Any,
+    B as B,
+    BaseHTTPResponse as BaseHTTPResponse,
+    Bucket as Bucket,
+    C as C,
+    CompleteMultipartUploadResult as CompleteMultipartUploadResult,
+    Credentials as Credentials,
+    ET as ET,
+    Enum as Enum,
+    EventIterable as EventIterable,
+    HTTPHeaderDict as HTTPHeaderDict,
+    JSONDecodeError as JSONDecodeError,
+    List as List,
+    ListAllMyBucketsResult as ListAllMyBucketsResult,
+    ListMultipartUploadsResult as ListMultipartUploadsResult,
+    ListPartsResult as ListPartsResult,
+    Object as Object,
+    Optional as Optional,
+    OrderedDict as OrderedDict,
+    Part as Part,
+    PeerInfo as PeerInfo,
+    PeerSite as PeerSite,
+    PostPolicy as PostPolicy,
+    SiteReplicationStatusOptions as SiteReplicationStatusOptions,
+    Tags as Tags,
+    Tuple as Tuple,
+    Type as Type,
+    TypeVar as TypeVar,
+    Union as Union,
+    Upload as Upload,
+    absolute_import as absolute_import,
+    annotations as annotations,
+    base64 as base64,
+    cast as cast,
+    check_bucket_name as check_bucket_name,
+    dataclass as dataclass,
+    datetime as datetime,
+    field as field,
+    find as find,
+    findall as findall,
+    findtext as findtext,
+    from_iso8601utc as from_iso8601utc,
+    get_credential_string as get_credential_string,
+    json as json,
+    parse_copy_object as parse_copy_object,
+    parse_list_objects as parse_list_objects,
+    post_presign_v4 as post_presign_v4,
+    to_amz_date as to_amz_date,
+    to_iso8601utc as to_iso8601utc,
+    unquote_plus as unquote_plus,
+)
+
+__all__ = ['A', 'Any', 'B', 'BaseHTTPResponse', 'Bucket', 'C', 'CompleteMultipartUploadResult', 'Credentials', 'ET', 'Enum', 'EventIterable', 'HTTPHeaderDict', 'JSONDecodeError', 'List', 'ListAllMyBucketsResult', 'ListMultipartUploadsResult', 'ListPartsResult', 'Object', 'Optional', 'OrderedDict', 'Part', 'PeerInfo', 'PeerSite', 'PostPolicy', 'SiteReplicationStatusOptions', 'Tags', 'Tuple', 'Type', 'TypeVar', 'Union', 'Upload', 'absolute_import', 'annotations', 'base64', 'cast', 'check_bucket_name', 'dataclass', 'datetime', 'field', 'find', 'findall', 'findtext', 'from_iso8601utc', 'get_credential_string', 'json', 'parse_copy_object', 'parse_list_objects', 'post_presign_v4', 'to_amz_date', 'to_iso8601utc', 'unquote_plus']

silo/deleteobjects.py

@@ -0,0 +1,25 @@
+"""Compatibility exports from minio.deleteobjects (minio 7.2.20)."""
+from minio.deleteobjects import (
+    A as A,
+    B as B,
+    C as C,
+    DeleteError as DeleteError,
+    DeleteObject as DeleteObject,
+    DeleteRequest as DeleteRequest,
+    DeleteResult as DeleteResult,
+    DeletedObject as DeletedObject,
+    ET as ET,
+    Element as Element,
+    Optional as Optional,
+    SubElement as SubElement,
+    Type as Type,
+    TypeVar as TypeVar,
+    absolute_import as absolute_import,
+    annotations as annotations,
+    cast as cast,
+    dataclass as dataclass,
+    findall as findall,
+    findtext as findtext,
+)
+
+__all__ = ['A', 'B', 'C', 'DeleteError', 'DeleteObject', 'DeleteRequest', 'DeleteResult', 'DeletedObject', 'ET', 'Element', 'Optional', 'SubElement', 'Type', 'TypeVar', 'absolute_import', 'annotations', 'cast', 'dataclass', 'findall', 'findtext']

silo/error.py

@@ -0,0 +1,19 @@
+"""Compatibility exports from minio.error (minio 7.2.20)."""
+from minio.error import (
+    A as A,
+    BaseHTTPResponse as BaseHTTPResponse,
+    ET as ET,
+    InvalidResponseError as InvalidResponseError,
+    MinioAdminException as MinioAdminException,
+    MinioException as MinioException,
+    Optional as Optional,
+    S3Error as S3Error,
+    ServerError as ServerError,
+    Type as Type,
+    TypeVar as TypeVar,
+    absolute_import as absolute_import,
+    annotations as annotations,
+    findtext as findtext,
+)
+
+__all__ = ['A', 'BaseHTTPResponse', 'ET', 'InvalidResponseError', 'MinioAdminException', 'MinioException', 'Optional', 'S3Error', 'ServerError', 'Type', 'TypeVar', 'absolute_import', 'annotations', 'findtext']

silo/helpers.py

@@ -0,0 +1,61 @@
+"""Compatibility exports from minio.helpers (minio 7.2.20)."""
+from minio.helpers import (
+    BaseURL as BaseURL,
+    BinaryIO as BinaryIO,
+    BoundedSemaphore as BoundedSemaphore,
+    Dict as Dict,
+    DictType as DictType,
+    HTTPHeaderDict as HTTPHeaderDict,
+    List as List,
+    MAX_MULTIPART_COUNT as MAX_MULTIPART_COUNT,
+    MAX_MULTIPART_OBJECT_SIZE as MAX_MULTIPART_OBJECT_SIZE,
+    MAX_PART_SIZE as MAX_PART_SIZE,
+    MIN_PART_SIZE as MIN_PART_SIZE,
+    Mapping as Mapping,
+    ObjectWriteResult as ObjectWriteResult,
+    Optional as Optional,
+    ProgressType as ProgressType,
+    Protocol as Protocol,
+    Queue as Queue,
+    Sse as Sse,
+    SseCustomerKey as SseCustomerKey,
+    Thread as Thread,
+    ThreadPool as ThreadPool,
+    Tuple as Tuple,
+    Union as Union,
+    Worker as Worker,
+    absolute_import as absolute_import,
+    annotations as annotations,
+    base64 as base64,
+    check_bucket_name as check_bucket_name,
+    check_non_empty_string as check_non_empty_string,
+    check_object_name as check_object_name,
+    check_sse as check_sse,
+    check_ssec as check_ssec,
+    dataclass as dataclass,
+    datetime as datetime,
+    division as division,
+    errno as errno,
+    genheaders as genheaders,
+    get_part_info as get_part_info,
+    hashlib as hashlib,
+    headers_to_strings as headers_to_strings,
+    is_valid_policy_type as is_valid_policy_type,
+    makedirs as makedirs,
+    math as math,
+    md5sum_hash as md5sum_hash,
+    normalize_headers as normalize_headers,
+    os as os,
+    platform as platform,
+    queryencode as queryencode,
+    quote as quote,
+    re as re,
+    read_part_data as read_part_data,
+    sha256_hash as sha256_hash,
+    to_iso8601utc as to_iso8601utc,
+    unicode_literals as unicode_literals,
+    url_replace as url_replace,
+    urllib as urllib,
+)
+
+__all__ = ['BaseURL', 'BinaryIO', 'BoundedSemaphore', 'Dict', 'DictType', 'HTTPHeaderDict', 'List', 'MAX_MULTIPART_COUNT', 'MAX_MULTIPART_OBJECT_SIZE', 'MAX_PART_SIZE', 'MIN_PART_SIZE', 'Mapping', 'ObjectWriteResult', 'Optional', 'ProgressType', 'Protocol', 'Queue', 'Sse', 'SseCustomerKey', 'Thread', 'ThreadPool', 'Tuple', 'Union', 'Worker', 'absolute_import', 'annotations', 'base64', 'check_bucket_name', 'check_non_empty_string', 'check_object_name', 'check_sse', 'check_ssec', 'dataclass', 'datetime', 'division', 'errno', 'genheaders', 'get_part_info', 'hashlib', 'headers_to_strings', 'is_valid_policy_type', 'makedirs', 'math', 'md5sum_hash', 'normalize_headers', 'os', 'platform', 'queryencode', 'quote', 're', 'read_part_data', 'sha256_hash', 'to_iso8601utc', 'unicode_literals', 'url_replace', 'urllib']

silo/legalhold.py

@@ -0,0 +1,17 @@
+"""Compatibility exports from minio.legalhold (minio 7.2.20)."""
+from minio.legalhold import (
+    A as A,
+    ET as ET,
+    Element as Element,
+    LegalHold as LegalHold,
+    Optional as Optional,
+    SubElement as SubElement,
+    Type as Type,
+    TypeVar as TypeVar,
+    absolute_import as absolute_import,
+    annotations as annotations,
+    dataclass as dataclass,
+    findtext as findtext,
+)
+
+__all__ = ['A', 'ET', 'Element', 'LegalHold', 'Optional', 'SubElement', 'Type', 'TypeVar', 'absolute_import', 'annotations', 'dataclass', 'findtext']

silo/lifecycleconfig.py

@@ -0,0 +1,38 @@
+"""Compatibility exports from minio.lifecycleconfig (minio 7.2.20)."""
+from minio.lifecycleconfig import (
+    A as A,
+    ABC as ABC,
+    AbortIncompleteMultipartUpload as AbortIncompleteMultipartUpload,
+    B as B,
+    BaseRule as BaseRule,
+    C as C,
+    D as D,
+    DateDays as DateDays,
+    E as E,
+    ET as ET,
+    Element as Element,
+    Expiration as Expiration,
+    F as F,
+    G as G,
+    LifecycleConfig as LifecycleConfig,
+    NoncurrentVersionExpiration as NoncurrentVersionExpiration,
+    NoncurrentVersionTransition as NoncurrentVersionTransition,
+    Optional as Optional,
+    Rule as Rule,
+    SubElement as SubElement,
+    Transition as Transition,
+    Type as Type,
+    TypeVar as TypeVar,
+    absolute_import as absolute_import,
+    annotations as annotations,
+    cast as cast,
+    dataclass as dataclass,
+    datetime as datetime,
+    find as find,
+    findall as findall,
+    findtext as findtext,
+    from_iso8601utc as from_iso8601utc,
+    to_iso8601utc as to_iso8601utc,
+)
+
+__all__ = ['A', 'ABC', 'AbortIncompleteMultipartUpload', 'B', 'BaseRule', 'C', 'D', 'DateDays', 'E', 'ET', 'Element', 'Expiration', 'F', 'G', 'LifecycleConfig', 'NoncurrentVersionExpiration', 'NoncurrentVersionTransition', 'Optional', 'Rule', 'SubElement', 'Transition', 'Type', 'TypeVar', 'absolute_import', 'annotations', 'cast', 'dataclass', 'datetime', 'find', 'findall', 'findtext', 'from_iso8601utc', 'to_iso8601utc']

silo/minioadmin.py

@@ -0,0 +1,39 @@
+"""Compatibility exports from minio.minioadmin (minio 7.2.20)."""
+from minio.minioadmin import (
+    Any as Any,
+    BaseHTTPResponse as BaseHTTPResponse,
+    DictType as DictType,
+    Enum as Enum,
+    HTTPHeaderDict as HTTPHeaderDict,
+    MinioAdmin as MinioAdmin,
+    MinioAdminException as MinioAdminException,
+    Optional as Optional,
+    PeerInfo as PeerInfo,
+    PeerSite as PeerSite,
+    PoolManager as PoolManager,
+    Provider as Provider,
+    Retry as Retry,
+    SiteReplicationStatusOptions as SiteReplicationStatusOptions,
+    TextIO as TextIO,
+    Timeout as Timeout,
+    Tuple as Tuple,
+    absolute_import as absolute_import,
+    annotations as annotations,
+    cast as cast,
+    certifi as certifi,
+    decrypt as decrypt,
+    encrypt as encrypt,
+    headers_to_strings as headers_to_strings,
+    json as json,
+    os as os,
+    queryencode as queryencode,
+    sha256_hash as sha256_hash,
+    sign_v4_s3 as sign_v4_s3,
+    time as time,
+    timedelta as timedelta,
+    unique as unique,
+    url_replace as url_replace,
+    urlunsplit as urlunsplit,
+)
+
+__all__ = ['Any', 'BaseHTTPResponse', 'DictType', 'Enum', 'HTTPHeaderDict', 'MinioAdmin', 'MinioAdminException', 'Optional', 'PeerInfo', 'PeerSite', 'PoolManager', 'Provider', 'Retry', 'SiteReplicationStatusOptions', 'TextIO', 'Timeout', 'Tuple', 'absolute_import', 'annotations', 'cast', 'certifi', 'decrypt', 'encrypt', 'headers_to_strings', 'json', 'os', 'queryencode', 'sha256_hash', 'sign_v4_s3', 'time', 'timedelta', 'unique', 'url_replace', 'urlunsplit']

silo/notificationconfig.py

@@ -0,0 +1,33 @@
+"""Compatibility exports from minio.notificationconfig (minio 7.2.20)."""
+from minio.notificationconfig import (
+    A as A,
+    ABC as ABC,
+    B as B,
+    C as C,
+    CloudFuncConfig as CloudFuncConfig,
+    CommonConfig as CommonConfig,
+    D as D,
+    E as E,
+    ET as ET,
+    Element as Element,
+    FilterRule as FilterRule,
+    NotificationConfig as NotificationConfig,
+    Optional as Optional,
+    PrefixFilterRule as PrefixFilterRule,
+    QueueConfig as QueueConfig,
+    SubElement as SubElement,
+    SuffixFilterRule as SuffixFilterRule,
+    TopicConfig as TopicConfig,
+    Type as Type,
+    TypeVar as TypeVar,
+    absolute_import as absolute_import,
+    annotations as annotations,
+    cast as cast,
+    dataclass as dataclass,
+    field as field,
+    find as find,
+    findall as findall,
+    findtext as findtext,
+)
+
+__all__ = ['A', 'ABC', 'B', 'C', 'CloudFuncConfig', 'CommonConfig', 'D', 'E', 'ET', 'Element', 'FilterRule', 'NotificationConfig', 'Optional', 'PrefixFilterRule', 'QueueConfig', 'SubElement', 'SuffixFilterRule', 'TopicConfig', 'Type', 'TypeVar', 'absolute_import', 'annotations', 'cast', 'dataclass', 'field', 'find', 'findall', 'findtext']

silo/objectlockconfig.py

@@ -0,0 +1,24 @@
+"""Compatibility exports from minio.objectlockconfig (minio 7.2.20)."""
+from minio.objectlockconfig import (
+    A as A,
+    COMPLIANCE as COMPLIANCE,
+    DAYS as DAYS,
+    ENABLED as ENABLED,
+    ET as ET,
+    Element as Element,
+    GOVERNANCE as GOVERNANCE,
+    ObjectLockConfig as ObjectLockConfig,
+    Optional as Optional,
+    SubElement as SubElement,
+    Type as Type,
+    TypeVar as TypeVar,
+    YEARS as YEARS,
+    absolute_import as absolute_import,
+    annotations as annotations,
+    cast as cast,
+    dataclass as dataclass,
+    find as find,
+    findtext as findtext,
+)
+
+__all__ = ['A', 'COMPLIANCE', 'DAYS', 'ENABLED', 'ET', 'Element', 'GOVERNANCE', 'ObjectLockConfig', 'Optional', 'SubElement', 'Type', 'TypeVar', 'YEARS', 'absolute_import', 'annotations', 'cast', 'dataclass', 'find', 'findtext']

silo/replicationconfig.py

@@ -0,0 +1,48 @@
+"""Compatibility exports from minio.replicationconfig (minio 7.2.20)."""
+from minio.replicationconfig import (
+    A as A,
+    ABC as ABC,
+    AccessControlTranslation as AccessControlTranslation,
+    B as B,
+    BaseRule as BaseRule,
+    C as C,
+    D as D,
+    DISABLED as DISABLED,
+    DeleteMarkerReplication as DeleteMarkerReplication,
+    Destination as Destination,
+    E as E,
+    ET as ET,
+    Element as Element,
+    EncryptionConfig as EncryptionConfig,
+    EventThreshold as EventThreshold,
+    ExistingObjectReplication as ExistingObjectReplication,
+    F as F,
+    Filter as Filter,
+    G as G,
+    H as H,
+    I as I,
+    J as J,
+    Metrics as Metrics,
+    Optional as Optional,
+    ReplicationConfig as ReplicationConfig,
+    ReplicationTime as ReplicationTime,
+    ReplicationTimeValue as ReplicationTimeValue,
+    Rule as Rule,
+    SourceSelectionCriteria as SourceSelectionCriteria,
+    SseKmsEncryptedObjects as SseKmsEncryptedObjects,
+    Status as Status,
+    SubElement as SubElement,
+    Time as Time,
+    Type as Type,
+    TypeVar as TypeVar,
+    absolute_import as absolute_import,
+    annotations as annotations,
+    cast as cast,
+    check_status as check_status,
+    dataclass as dataclass,
+    find as find,
+    findall as findall,
+    findtext as findtext,
+)
+
+__all__ = ['A', 'ABC', 'AccessControlTranslation', 'B', 'BaseRule', 'C', 'D', 'DISABLED', 'DeleteMarkerReplication', 'Destination', 'E', 'ET', 'Element', 'EncryptionConfig', 'EventThreshold', 'ExistingObjectReplication', 'F', 'Filter', 'G', 'H', 'I', 'J', 'Metrics', 'Optional', 'ReplicationConfig', 'ReplicationTime', 'ReplicationTimeValue', 'Rule', 'SourceSelectionCriteria', 'SseKmsEncryptedObjects', 'Status', 'SubElement', 'Time', 'Type', 'TypeVar', 'absolute_import', 'annotations', 'cast', 'check_status', 'dataclass', 'find', 'findall', 'findtext']

silo/retention.py

@@ -0,0 +1,23 @@
+"""Compatibility exports from minio.retention (minio 7.2.20)."""
+from minio.retention import (
+    A as A,
+    COMPLIANCE as COMPLIANCE,
+    ET as ET,
+    Element as Element,
+    GOVERNANCE as GOVERNANCE,
+    Optional as Optional,
+    Retention as Retention,
+    SubElement as SubElement,
+    Type as Type,
+    TypeVar as TypeVar,
+    absolute_import as absolute_import,
+    annotations as annotations,
+    cast as cast,
+    dataclass as dataclass,
+    datetime as datetime,
+    findtext as findtext,
+    from_iso8601utc as from_iso8601utc,
+    to_iso8601utc as to_iso8601utc,
+)
+
+__all__ = ['A', 'COMPLIANCE', 'ET', 'Element', 'GOVERNANCE', 'Optional', 'Retention', 'SubElement', 'Type', 'TypeVar', 'absolute_import', 'annotations', 'cast', 'dataclass', 'datetime', 'findtext', 'from_iso8601utc', 'to_iso8601utc']

silo/select.py

@@ -0,0 +1,37 @@
+"""Compatibility exports from minio.select (minio 7.2.20)."""
+from minio.select import (
+    ABC as ABC,
+    BytesIO as BytesIO,
+    COMPRESSION_TYPE_BZIP2 as COMPRESSION_TYPE_BZIP2,
+    COMPRESSION_TYPE_GZIP as COMPRESSION_TYPE_GZIP,
+    COMPRESSION_TYPE_NONE as COMPRESSION_TYPE_NONE,
+    CSVInputSerialization as CSVInputSerialization,
+    CSVOutputSerialization as CSVOutputSerialization,
+    ET as ET,
+    Element as Element,
+    FILE_HEADER_INFO_IGNORE as FILE_HEADER_INFO_IGNORE,
+    FILE_HEADER_INFO_NONE as FILE_HEADER_INFO_NONE,
+    FILE_HEADER_INFO_USE as FILE_HEADER_INFO_USE,
+    InputSerialization as InputSerialization,
+    JSONInputSerialization as JSONInputSerialization,
+    JSONOutputSerialization as JSONOutputSerialization,
+    JSON_TYPE_DOCUMENT as JSON_TYPE_DOCUMENT,
+    JSON_TYPE_LINES as JSON_TYPE_LINES,
+    MinioException as MinioException,
+    Optional as Optional,
+    OutputSerialization as OutputSerialization,
+    ParquetInputSerialization as ParquetInputSerialization,
+    QUOTE_FIELDS_ALWAYS as QUOTE_FIELDS_ALWAYS,
+    QUOTE_FIELDS_ASNEEDED as QUOTE_FIELDS_ASNEEDED,
+    SelectObjectReader as SelectObjectReader,
+    SelectRequest as SelectRequest,
+    Stats as Stats,
+    SubElement as SubElement,
+    absolute_import as absolute_import,
+    abstractmethod as abstractmethod,
+    crc32 as crc32,
+    dataclass as dataclass,
+    findtext as findtext,
+)
+
+__all__ = ['ABC', 'BytesIO', 'COMPRESSION_TYPE_BZIP2', 'COMPRESSION_TYPE_GZIP', 'COMPRESSION_TYPE_NONE', 'CSVInputSerialization', 'CSVOutputSerialization', 'ET', 'Element', 'FILE_HEADER_INFO_IGNORE', 'FILE_HEADER_INFO_NONE', 'FILE_HEADER_INFO_USE', 'InputSerialization', 'JSONInputSerialization', 'JSONOutputSerialization', 'JSON_TYPE_DOCUMENT', 'JSON_TYPE_LINES', 'MinioException', 'Optional', 'OutputSerialization', 'ParquetInputSerialization', 'QUOTE_FIELDS_ALWAYS', 'QUOTE_FIELDS_ASNEEDED', 'SelectObjectReader', 'SelectRequest', 'Stats', 'SubElement', 'absolute_import', 'abstractmethod', 'crc32', 'dataclass', 'findtext']

silo/signer.py

@@ -0,0 +1,26 @@
+"""Compatibility exports from minio.signer (minio 7.2.20)."""
+from minio.signer import (
+    Credentials as Credentials,
+    DictType as DictType,
+    Mapping as Mapping,
+    OrderedDict as OrderedDict,
+    SIGN_V4_ALGORITHM as SIGN_V4_ALGORITHM,
+    SplitResult as SplitResult,
+    absolute_import as absolute_import,
+    annotations as annotations,
+    cast as cast,
+    datetime as datetime,
+    get_credential_string as get_credential_string,
+    hashlib as hashlib,
+    hmac as hmac,
+    post_presign_v4 as post_presign_v4,
+    presign_v4 as presign_v4,
+    queryencode as queryencode,
+    re as re,
+    sha256_hash as sha256_hash,
+    sign_v4_s3 as sign_v4_s3,
+    sign_v4_sts as sign_v4_sts,
+    time as time,
+)
+
+__all__ = ['Credentials', 'DictType', 'Mapping', 'OrderedDict', 'SIGN_V4_ALGORITHM', 'SplitResult', 'absolute_import', 'annotations', 'cast', 'datetime', 'get_credential_string', 'hashlib', 'hmac', 'post_presign_v4', 'presign_v4', 'queryencode', 're', 'sha256_hash', 'sign_v4_s3', 'sign_v4_sts', 'time']

silo/sse.py

@@ -0,0 +1,17 @@
+"""Compatibility exports from minio.sse (minio 7.2.20)."""
+from minio.sse import (
+    ABC as ABC,
+    Any as Any,
+    Sse as Sse,
+    SseCustomerKey as SseCustomerKey,
+    SseKMS as SseKMS,
+    SseS3 as SseS3,
+    absolute_import as absolute_import,
+    abstractmethod as abstractmethod,
+    annotations as annotations,
+    base64 as base64,
+    cast as cast,
+    json as json,
+)
+
+__all__ = ['ABC', 'Any', 'Sse', 'SseCustomerKey', 'SseKMS', 'SseS3', 'absolute_import', 'abstractmethod', 'annotations', 'base64', 'cast', 'json']

silo/sseconfig.py

@@ -0,0 +1,24 @@
+"""Compatibility exports from minio.sseconfig (minio 7.2.20)."""
+from minio.sseconfig import (
+    A as A,
+    ABC as ABC,
+    AES256 as AES256,
+    AWS_KMS as AWS_KMS,
+    B as B,
+    ET as ET,
+    Element as Element,
+    Optional as Optional,
+    Rule as Rule,
+    SSEConfig as SSEConfig,
+    SubElement as SubElement,
+    Type as Type,
+    TypeVar as TypeVar,
+    absolute_import as absolute_import,
+    annotations as annotations,
+    cast as cast,
+    dataclass as dataclass,
+    find as find,
+    findtext as findtext,
+)
+
+__all__ = ['A', 'ABC', 'AES256', 'AWS_KMS', 'B', 'ET', 'Element', 'Optional', 'Rule', 'SSEConfig', 'SubElement', 'Type', 'TypeVar', 'absolute_import', 'annotations', 'cast', 'dataclass', 'find', 'findtext']

silo/tagging.py

@@ -0,0 +1,19 @@
+"""Compatibility exports from minio.tagging (minio 7.2.20)."""
+from minio.tagging import (
+    A as A,
+    ET as ET,
+    Element as Element,
+    Optional as Optional,
+    SubElement as SubElement,
+    Tagging as Tagging,
+    Tags as Tags,
+    Type as Type,
+    TypeVar as TypeVar,
+    absolute_import as absolute_import,
+    annotations as annotations,
+    cast as cast,
+    dataclass as dataclass,
+    find as find,
+)
+
+__all__ = ['A', 'ET', 'Element', 'Optional', 'SubElement', 'Tagging', 'Tags', 'Type', 'TypeVar', 'absolute_import', 'annotations', 'cast', 'dataclass', 'find']

silo/time.py

@@ -0,0 +1,25 @@
+"""Compatibility exports from minio.time (minio 7.2.20)."""
+from minio.time import (
+    Optional as Optional,
+    absolute_import as absolute_import,
+    annotations as annotations,
+    ctime as ctime,
+    datetime as datetime,
+    from_http_header as from_http_header,
+    from_iso8601utc as from_iso8601utc,
+    timezone as timezone,
+    to_amz_date as to_amz_date,
+    to_float as to_float,
+    to_http_header as to_http_header,
+    to_iso8601utc as to_iso8601utc,
+    to_signer_date as to_signer_date,
+    utcnow as utcnow,
+)
+
+__all__ = ['Optional', 'absolute_import', 'annotations', 'ctime', 'datetime', 'from_http_header', 'from_iso8601utc', 'timezone', 'to_amz_date', 'to_float', 'to_http_header', 'to_iso8601utc', 'to_signer_date', 'utcnow']
+
+# datetime.UTC only exists on newer Python versions; mirror upstream exactly.
+import minio.time as _upstream_time
+if hasattr(_upstream_time, "UTC"):
+    UTC = _upstream_time.UTC
+    __all__.append("UTC")

silo/versioningconfig.py

@@ -0,0 +1,25 @@
+"""Compatibility exports from minio.versioningconfig (minio 7.2.20)."""
+from minio.versioningconfig import (
+    A as A,
+    DISABLED as DISABLED,
+    ENABLED as ENABLED,
+    ET as ET,
+    Element as Element,
+    List as List,
+    OFF as OFF,
+    Optional as Optional,
+    SUSPENDED as SUSPENDED,
+    SubElement as SubElement,
+    Type as Type,
+    TypeVar as TypeVar,
+    Union as Union,
+    VersioningConfig as VersioningConfig,
+    absolute_import as absolute_import,
+    annotations as annotations,
+    cast as cast,
+    dataclass as dataclass,
+    findall as findall,
+    findtext as findtext,
+)
+
+__all__ = ['A', 'DISABLED', 'ENABLED', 'ET', 'Element', 'List', 'OFF', 'Optional', 'SUSPENDED', 'SubElement', 'Type', 'TypeVar', 'Union', 'VersioningConfig', 'absolute_import', 'annotations', 'cast', 'dataclass', 'findall', 'findtext']

silo/xml.py

@@ -0,0 +1,25 @@
+"""Compatibility exports from minio.xml (minio 7.2.20)."""
+from minio.xml import (
+    A as A,
+    B as B,
+    ET as ET,
+    Element as Element,
+    FromXmlType as FromXmlType,
+    Optional as Optional,
+    Protocol as Protocol,
+    SubElement as SubElement,
+    ToXmlType as ToXmlType,
+    Type as Type,
+    TypeVar as TypeVar,
+    absolute_import as absolute_import,
+    annotations as annotations,
+    find as find,
+    findall as findall,
+    findtext as findtext,
+    getbytes as getbytes,
+    io as io,
+    marshal as marshal,
+    unmarshal as unmarshal,
+)
+
+__all__ = ['A', 'B', 'ET', 'Element', 'FromXmlType', 'Optional', 'Protocol', 'SubElement', 'ToXmlType', 'Type', 'TypeVar', 'absolute_import', 'annotations', 'find', 'findall', 'findtext', 'getbytes', 'io', 'marshal', 'unmarshal']

silo_python_sdk-0.1.0.dist-info/METADATA

@@ -0,0 +1,131 @@
+Metadata-Version: 2.4
+Name: silo-python-sdk
+Version: 0.1.0
+Summary: Unofficial Silo client preserving the MinIO Python SDK API
+License-Expression: MIT
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+License-File: NOTICE
+Requires-Dist: minio==7.2.20
+Provides-Extra: test
+Requires-Dist: pytest<10,>=8; extra == "test"
+Dynamic: license-file
+
+# Silo Python SDK
+
+面向 [PGSTY Silo](https://github.com/pgsty/silo) 的**非官方** Python SDK，复用官方 [MinIO Python SDK](https://github.com/minio/minio-py)。Python 3.9+。
+
+## 安装
+
+从本目录安装：
+
+```bash
+python -m pip install .
+```
+
+或安装交付的 wheel：
+
+```bash
+python -m pip install dist/silo_python_sdk-0.1.0-py3-none-any.whl
+```
+
+包名 `silo-python-sdk`，导入名 `silo`。尚未发布至 PyPI；安装时需要取得 `minio==7.2.20` 及其依赖。
+
+## 连接和迁移
+
+```python
+import os
+from silo import Silo
+from silo.error import S3Error
+
+client = Silo(
+    endpoint="localhost:9000",  # host:port，不包含 http://
+    access_key=os.environ["SILO_ACCESS_KEY"],
+    secret_key=os.environ["SILO_SECRET_KEY"],
+    secure=False,               # 仅本机 HTTP 实例；默认值为 True
+)
+
+if not client.bucket_exists("example"):
+    client.make_bucket("example")
+
+client.fput_object("example", "hello.txt", "./hello.txt")
+client.fget_object("example", "hello.txt", "./download.txt")
+for obj in client.list_objects("example", recursive=True):
+    print(obj.object_name, obj.size)
+```
+
+迁移原代码时，将 `from minio import Minio` 换为 `from silo import Silo`，构造调用改为 `Silo(...)`；已有方法调用不变。辅助模块可把 `minio.commonconfig` 等改为 `silo.commonconfig`。`from silo import Minio` 也可用，它是上游原类。
+
+`Silo` 继承 `Minio`，**63 个公开方法全部保持原方法、参数签名、返回类型和异常类型**，包括桶管理、对象操作、复制与合成、分片上传、删除、分页、版本控制、生命周期、访问策略、标签、通知、预签名 GET/PUT/POST、加密、对象锁、保留策略、法律保留、复制配置、Select、Snowball、append、prompt 等。25 个辅助模块的全部公开符号直接引用上游对象，包含 `credentials` 子模块、`minioadmin`、错误、配置和数据模型。
+
+完整清单和签名见 [docs/api-inventory.json](docs/api-inventory.json)。高级参数、凭据 Provider、session_token、自定义 http_client、region、cert_check 均沿用上游构造接口。管理类可从 `silo.minioadmin` 导入，SDK 并未承诺所有管理调用都能在 Silo 服务端执行。
+
+这份兼容承诺针对 **minio 7.2.20**。依赖固定该版本；升级时需重跑兼容及服务端测试。它不是独立重写的 S3 协议库。
+
+## 环境变量和便捷操作
+
+```bash
+export SILO_ENDPOINT=localhost:9000
+export SILO_ACCESS_KEY=silo-admin
+export SILO_SECRET_KEY='填入实际密码'
+export SILO_SECURE=false
+```
+
+```python
+from silo import Silo
+
+client = Silo.from_env()
+client.upload_bytes("example", "folder/中文.txt", "你好 Silo".encode(), "text/plain")
+content = client.download_bytes("example", "folder/中文.txt")
+print(content.decode())
+```
+
+前三个变量必填，缺失或全空白抛出 `ValueError`；密钥原文保持不变。`SILO_SECURE` 默认 `true`，只接受 `true`/`false`（大小写不敏感，可带首尾空白），拼写错误报错。示例 `.env.example` 供参考，SDK 不自动读取 `.env` 文件。
+
+`upload_bytes` 返回上游 `ObjectWriteResult`。`download_bytes` 在成功或异常时关闭响应并释放连接，内容全部读入内存。大文件、版本读取、加密和元数据操作请使用完整的上游 `put_object`、`get_object`、`fput_object`、`fget_object` 接口。例如：
+
+```python
+response = client.get_object("example", "hello.txt", version_id="实际版本 ID")
+try:
+    for chunk in response.stream(1024 * 1024):
+        print(len(chunk))
+finally:
+    response.close()
+    response.release_conn()
+```
+
+异常原样传播，使用 `silo.error.S3Error` 或 `minio.error.S3Error` 捕获结果相同。客户端可在线程间共享；不可在多个进程间共享同一个实例，应每个进程独立创建。首次使用前自行创建目标桶；SDK 不修改既有桶策略。
+
+## 验证与限制
+
+完整对照核验见 [docs/compatibility-report.md](docs/compatibility-report.md)：官方原版和 Silo 各有 114 项单元测试通过（2 项 locale 跳过），官方功能测试各有 49 项实执行通过（1 项 AWS 区域不适用）。官方功能测试新增实测了条件复制、预签名过期/响应头、线程读写、Select 和 Snowball；预签名 POST 仅生成策略，尚未实测 POST 上传。
+
+API 保留和服务端支持是不同的保证。兼容测试遍历并检查所有方法和辅助符号；本机服务端测试覆盖：
+
+- 创建/查询/删除桶，空字节和中文对象名，文件和字节上传下载。
+- 元数据、范围读取、复制、合成，7 MiB 分片上传。
+- 实际预签名 GET/PUT 请求，1005 个对象的跨页列举。
+- 版本启用、指定版本读取、删除标记和版本清理。
+- 生命周期配置、桶策略、桶/对象标签、空通知配置及相应删除操作。
+- 未找到对象和错误凭据的真实 `S3Error`。
+
+Python 3.9.25 和 3.13.3 上各有 67 项 SDK 测试通过；最低 Python 版本与原版一致为 3.9。
+
+实测对象为本机 Silo `RELEASE.2026-09-16T00-00-00Z`，HTTP、单节点。**未实测**外部身份 Provider、管理员 API、加密/KMS、对象锁/保留/法律保留、跨站复制、真实通知投递/监听、预签名 POST、append、prompt、AWS 加速/双栈、TLS、集群和故障恢复。这些接口仍完整保留，能否执行取决于服务端配置和功能支持。没有把兼容测试描述为这些功能的端到端证明。
+
+## 重跑测试和构建
+
+```bash
+python -m pip install '.[test]' build
+python -m pytest                         # 单元和兼容测试；跳过真实服务端测试
+# 先设置上述四个 SILO_* 环境变量
+python -m pytest --run-integration       # 完整测试；缺少配置会报错
+python -m build
+```
+
+集成测试使用随机 `silo-sdk-test-*` 桶，结束时删除本次生成的对象和桶；不会操作原有业务桶。验证证据见 `verification.json`。快速示例为 `examples/quickstart.py`；它保留新建示例桶和上传文件，便于在控制台查看。
+
+## 许可
+
+本包的封装代码采用 MIT。`minio` 是独立安装的 Apache-2.0 依赖，辅助模块仅导出其对象，没有复制上游实现。Silo 服务端为单独的软件项目，其许可不由本 SDK 改变。参见 LICENSE 和 NOTICE。

silo_python_sdk-0.1.0.dist-info/RECORD

@@ -0,0 +1,34 @@
+silo/__init__.py,sha256=weE38R1kpwP_ucr9YCpr5ylsMRXF1uJl1jH3cJPIUr0,218
+silo/api.py,sha256=SI5nzKyukOALF66QglxgHqQKx3iSz-gRuDjcxa9UnDA,4702
+silo/client.py,sha256=9u2xnnPqAtOpa0WRhDtAnrZXR9Q-dY-E7vDTGaPxfcs,2363
+silo/commonconfig.py,sha256=eMGdq1GKv9Gg68QDpTdKdfnrSAlxxNWnNYmbR4gtoHk,1695
+silo/crypto.py,sha256=HOWC4RM34oOZj5izFJgVZ5K_hh1RO5Hv9C7z6nEHaJ4,702
+silo/datatypes.py,sha256=Z1Bz554_cQ7EdhA_FH7KoLiT7hmmsf1IQUaoAkvb4KY,2374
+silo/deleteobjects.py,sha256=N30N1q5I8UR9Z3fiI5OEfd9f6j4LrHcu4e4Y_SWf3ug,865
+silo/error.py,sha256=0mu7OOkoLxx9oRdr4amKELZ_45cnq9bT1Xm4NcPbZEk,726
+silo/helpers.py,sha256=pvEGkHLSfWXinGKNEyDkw-FAyy6j76RAYnUTJYOrqUw,2632
+silo/legalhold.py,sha256=qFclImlczxEBJyb8Td1l9V01o918tv_35N9S-R1lUtE,550
+silo/lifecycleconfig.py,sha256=kh4lCL5vjL6IxB8kdYRSrMBiPG0r--n-jztsbKTra9Y,1426
+silo/minioadmin.py,sha256=7LIpvm-7BHKkw8qQhOtjLCGgmAzS_Kpj2eh9lNuumCI,1532
+silo/notificationconfig.py,sha256=np3JVDh1zEXtkj9G5SDlbcp_lQzvMy-rsE77eCQcRYA,1173
+silo/objectlockconfig.py,sha256=mUc-AmVt-axLlmLa6aKideaQJOpfJqFzcVgNKG2X5Ok,815
+silo/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+silo/replicationconfig.py,sha256=EA_eu9aCYFZZ4UQPU9BmjONXKYfyasfbZDPjnUKPhBI,1849
+silo/retention.py,sha256=LRpnudUZ4svOpq6jHvwtNKAONUMkWdCxeXzKT7TSlck,814
+silo/select.py,sha256=LFN5w5sMZN_9clhPePad0DuClC1kiy8EFCJRj9srFUY,2018
+silo/signer.py,sha256=Al5QrssYmoyTUaqmnMDKzhSSBSJO6iT5j7S7f5EBebg,1024
+silo/sse.py,sha256=Tp5lcC1ztCWXnERyepio2b_TIrMSGQGwopL8sNfNrr8,529
+silo/sseconfig.py,sha256=Z9-WfY5XeRw-XGnQWHZSWV21WRBU5JOBOBGS0ifvmlk,735
+silo/tagging.py,sha256=RefzzrpB6c6JQISdzczDa-1VCeumUhYQvT48lHxvJ0w,580
+silo/time.py,sha256=-1TVQ5ExWSydRS3AEx1bXL-RhNXp39Ep8H4boISdL_A,956
+silo/versioningconfig.py,sha256=gPDQAQ3zXVZyW0igdxAlH0V2lzTAEmJLZOvepQKPAjs,838
+silo/xml.py,sha256=uRn8yEjJ5y8bio-mHK0twuudPVDFIOsNy5MdOcqQ-ho,794
+silo/credentials/__init__.py,sha256=F0uNPYvaTB9IwsNkPT9l-Bi1MyHQpLd-jsu_O1uIjAM,1313
+silo/credentials/credentials.py,sha256=WbuIaUTRUQcDx0p_Np6BMMyI9PyJ7iQkSjFwItOYMrI,427
+silo/credentials/providers.py,sha256=X9OcnqmB4NcoCDmqlPPIEe9GtS3HKWCwUrl9uBy9Fts,2383
+silo_python_sdk-0.1.0.dist-info/licenses/LICENSE,sha256=rWFdmFBm5xxaqg5pBYj8c4kCTHv9EU3UaTusAtGjTxw,1085
+silo_python_sdk-0.1.0.dist-info/licenses/NOTICE,sha256=LKN03-IyCQYPKiHAAt_uk4tfBuyDdWrHW8O8YrClhmo,434
+silo_python_sdk-0.1.0.dist-info/METADATA,sha256=ZA-_2gAgZoelkIIg9iZ7yuLsJL3a3f9LhuLi30h8OP4,6744
+silo_python_sdk-0.1.0.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
+silo_python_sdk-0.1.0.dist-info/top_level.txt,sha256=3PNbI_TTdp9a0jp9jnGP-svS20dJKfH-ipm5HNoDPuU,5
+silo_python_sdk-0.1.0.dist-info/RECORD,,

silo_python_sdk-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (84.0.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

silo_python_sdk-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Silo Python SDK contributors
+
+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.

silo_python_sdk-0.1.0.dist-info/licenses/NOTICE

@@ -0,0 +1,7 @@
+This is an unofficial Silo Python SDK. It is not endorsed by MinIO or PGSTY.
+The package depends on minio 7.2.20, distributed separately under Apache-2.0.
+Upstream: https://github.com/minio/minio-py
+Upstream copyright: MinIO, Inc.
+The compatibility modules re-export upstream objects; upstream implementation
+source is not bundled in this distribution. Keep minio's own license and
+notices with any redistribution of that dependency.

silo_python_sdk-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+silo