matelab-python-sdk 0.2.0a9__py3-none-any.whl → 0.3.0a1__py3-none-any.whl

matelab/_generated/models.py

@@ -2,7 +2,7 @@
 #
 # @generated by datamodel-codegen:
 #   filename:  openapi.yaml
-#   version:   0.87.0
+#   version:   0.90.0
 
 from enum import StrEnum
 from typing import Annotated, Any, Literal
@@ -11,7 +11,7 @@ from pydantic import ConfigDict, Field, RootModel, SecretStr, StrictBool, Strict
 
 from matelab._wire_validation import WireModel
 
-OPENAPI_INFO_VERSION = "2026.11.1"
+OPENAPI_INFO_VERSION = "2026.11.2"
 
 
 class ResponseEnvelope(WireModel):
@@ -2759,9 +2759,9 @@ class StageTemporaryFileRequest(WireModel):
     """
     file: bytes | None = None
     """
-    Required for upload branches and omitted for abort. The multipart
-    filename's sanitized final extension selects the temporary bytes;
-    keep that extension unchanged throughout continuation.
+    Required for upload branches and omitted for abort. Filename and
+    extension may change between fragments in the same uid/tempid
+    session. Completion uses the final fragment's source filename.
 
     """
 

matelab/_transport.py

@@ -5,11 +5,10 @@ from collections.abc import AsyncIterator, Mapping
 from contextlib import suppress
 from dataclasses import dataclass
 from enum import StrEnum
-from typing import IO, Generic, TypeAlias, TypeVar, cast
+from typing import IO, cast, override
 
 from httpx2 import AsyncByteStream, AsyncClient, Request, RequestError, Response, SyncByteStream
 from pydantic import BaseModel, JsonValue, SecretStr, ValidationError
-from typing_extensions import override
 
 from matelab._generated import models as wire_models
 from matelab.errors import (
@@ -23,10 +22,9 @@ from matelab.errors import (
 from matelab.session import Session, Token
 from matelab.streaming import ByteRange, DownloadStream
 
-WireResponse = TypeVar("WireResponse", bound=BaseModel)
 _ACCESS_EXPIRY_SKEW_MS = 30_000
-_ParameterValue: TypeAlias = str | int | float | bool | None
-_Files: TypeAlias = Mapping[str, tuple[str, IO[bytes] | bytes, str]]
+type _ParameterValue = str | int | float | bool | None
+type _Files = Mapping[str, tuple[str, IO[bytes] | bytes, str]]
 _CONTENT_RANGE_PATTERN = re.compile(r"^bytes [0-9]+-[0-9]+/[0-9]+$")
 
 
@@ -100,7 +98,7 @@ class Encoding(StrEnum):
 
 
 @dataclass(frozen=True, slots=True)
-class Operation(Generic[WireResponse]):
+class Operation[WireResponse: BaseModel]:
     method: str
     path: str
     encoding: Encoding
@@ -177,7 +175,7 @@ class SessionTransport:
             )
             return self.session
 
-    async def _send_multipart(
+    async def _send_multipart[WireResponse: BaseModel](
         self,
         operation: Operation[WireResponse],
         *,
@@ -205,7 +203,7 @@ class SessionTransport:
             request.stream = _ThreadedMultipartStream(request.stream)
         return await self._http.send(request)
 
-    async def request(
+    async def request[WireResponse: BaseModel](
         self, operation: Operation[WireResponse], *, payload: BaseModel | None = None, files: _Files | None = None
     ) -> WireResponse:
         if (

matelab/_wire_validation.py

@@ -1,6 +1,6 @@
 import json
 from collections.abc import Callable, Collection, Iterator, Mapping
-from typing import TypeAlias, TypeVar, cast
+from typing import cast
 
 from jsonschema import Draft202012Validator
 from jsonschema.exceptions import ValidationError as JsonSchemaValidationError
@@ -15,8 +15,7 @@ from matelab.errors import MatelabUsageError
 
 _RUNTIME_RULES_KEY = "matelab-runtime-rules"
 JsonObject = dict[str, JsonValue]
-WireValue: TypeAlias = JsonValue | bytes | Mapping[str, "WireValue"]
-ModelT = TypeVar("ModelT", bound=BaseModel)
+type WireValue = JsonValue | bytes | Mapping[str, WireValue]
 
 
 def _reject_json_constant(_value: str) -> None:
@@ -44,7 +43,7 @@ _ContractValidator = cast(
 )
 
 
-def validate_request(model: type[ModelT], data: Mapping[str, WireValue], message: str) -> ModelT:
+def validate_request[ModelT: BaseModel](model: type[ModelT], data: Mapping[str, WireValue], message: str) -> ModelT:
     """Validate caller input without exposing it in the public exception."""
     try:
         return model.model_validate(data)
@@ -52,7 +51,7 @@ def validate_request(model: type[ModelT], data: Mapping[str, WireValue], message
         raise MatelabUsageError(message) from None
 
 
-def validate_multipart_request(
+def validate_multipart_request[ModelT: BaseModel](
     model: type[ModelT], data: Mapping[str, WireValue], file_fields: Collection[str], message: str
 ) -> ModelT:
     """Validate multipart fields whose binary content is transported separately."""

matelab/domains/records.py

@@ -5,11 +5,10 @@ from copy import deepcopy
 from dataclasses import dataclass, field
 from html.parser import HTMLParser
 from types import MappingProxyType
-from typing import IO, Literal, Self, TypeAlias, cast
+from typing import IO, Literal, Self, cast, override
 from urllib.parse import unquote
 
 from pydantic import BaseModel, JsonValue, model_validator
-from typing_extensions import override
 
 from matelab._generated import models as wire_models
 from matelab._hashes import LOWERCASE_SHA256_PATTERN
@@ -426,7 +425,7 @@ class StagedAttachment:
             raise ValueError("Staged attachment metadata is invalid.")
 
 
-RecordImportValue: TypeAlias = (
+type RecordImportValue = (
     str
     | int
     | float
@@ -434,9 +433,9 @@ RecordImportValue: TypeAlias = (
     | None
     | StagedAttachment
     | CloudFile
-    | Mapping[str, "RecordImportValue"]
-    | list["RecordImportValue"]
-    | tuple["RecordImportValue", ...]
+    | Mapping[str, RecordImportValue]
+    | list[RecordImportValue]
+    | tuple[RecordImportValue, ...]
 )
 
 
@@ -563,7 +562,7 @@ class RecordTableFileColumnDeletion:
     name: str
 
 
-RecordChange: TypeAlias = (
+type RecordChange = (
     RecordValueUpdate
     | RecordValueDeletion
     | RecordModuleCreation

matelab/domains/uploads.py

@@ -79,7 +79,7 @@ class Uploads:
         complete_sha256: str | None = None,
         content_type: str = "application/octet-stream",
     ) -> StagedUploadSession | StagedFile:
-        """Stage bytes; preserve the sanitized, case-sensitive filename extension when resuming."""
+        """Stage bytes; continuation filenames may change, and completion uses the final filename."""
         if session is None:
             session = StagedUploadSession(
                 binding=UploadBindingRef.new(), upload_session_id=f"tmp-{secrets.token_urlsafe(24)}"
@@ -163,7 +163,7 @@ class Uploads:
         )
 
     async def abort(self, upload: StagedUploadSession | StagedFile) -> None:
-        """Cancel incomplete extension variants; completed staging identities remain untouched (PVD-052)."""
+        """Cancel extensionless incomplete bytes; completed staging identities remain untouched (PVD-052)."""
         if isinstance(upload, StagedFile):
             # The completed file keeps this Provider identity private except for same-module cleanup.
             upload_session_id = upload._upload_session_id  # pyright: ignore[reportPrivateUsage]

{matelab_python_sdk-0.2.0a9.dist-info → matelab_python_sdk-0.3.0a1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: matelab-python-sdk
-Version: 0.2.0a9
+Version: 0.3.0a1
 Summary: Reusable async Python client for the Matelab Integration Contract
 Author: CMPDC, Institute of Physics, Chinese Academy of Sciences
 License-Expression: Apache-2.0
@@ -12,24 +12,24 @@ Classifier: Framework :: AsyncIO
 Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3 :: Only
-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: Programming Language :: Python :: 3.15
 Classifier: Topic :: Scientific/Engineering
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Classifier: Typing :: Typed
-Requires-Python: >=3.11
+Requires-Python: >=3.12
 Requires-Dist: httpx2>=2.16.0
 Requires-Dist: jsonschema>=4.26.0
-Requires-Dist: pydantic>=2.14.1
+Requires-Dist: pydantic>=2.14.3
 Requires-Dist: typing-extensions>=4.16.0
 Description-Content-Type: text/markdown
 
 # matelab-python-sdk
 
 Async Python client for the Matelab Integration Contract, with typed interfaces for authentication,
-notebooks, records, attachments, cloud files, templates, and literature. Requires Python 3.11 or newer.
+notebooks, records, attachments, cloud files, templates, and literature. Requires Python 3.12 or newer.
 
 ## Installation
 
@@ -64,6 +64,6 @@ asyncio.run(main())
 
 ## Documentation
 
-- [API reference](https://github.com/tiannianzhu/matelab-python-sdk/blob/main/docs/api.md): Session persistence, errors, examples, and Provider limits.
-- [Operation coverage](https://github.com/tiannianzhu/matelab-python-sdk/blob/main/docs/operation-coverage.yaml): supported operations.
-- [Development and releases](https://github.com/tiannianzhu/matelab-python-sdk/blob/main/docs/development.md): checks, Provider smoke, versioning, and builds.
+- [API reference](https://gitee.com/mat-code/matelab-python-sdk/blob/main/docs/api.md): Session persistence, errors, examples, and Provider limits.
+- [Operation coverage](https://gitee.com/mat-code/matelab-python-sdk/blob/main/docs/operation-coverage.yaml): supported operations.
+- [Development and releases](https://gitee.com/mat-code/matelab-python-sdk/blob/main/docs/development.md): checks, Provider smoke, versioning, and builds.

{matelab_python_sdk-0.2.0a9.dist-info → matelab_python_sdk-0.3.0a1.dist-info}/RECORD

@@ -1,26 +1,26 @@
 matelab/__init__.py,sha256=cJgzpDJiKJ9-XANRfRAjiRNoFVc3EovfxO-M2vu-HwU,5093
 matelab/_hashes.py,sha256=ImrLHx9wvcU6R-xGOrUCVDN_30sYA2UMn-NLwFrmFtU,163
-matelab/_transport.py,sha256=hdDxNsVnEYoZvhtkD4hQLzsVhlOTKsU4wvCdOpHVDuI,14863
-matelab/_wire_validation.py,sha256=nGXANykegIy7kvBcsCdFjdOHTj6py_jwMNST87At1xU,4790
+matelab/_transport.py,sha256=PP5zsU__ZMbEdME3bS0Hfx9AKtMF8P2tTyknviYlQzE,14789
+matelab/_wire_validation.py,sha256=yRZdsh3mM0EzCew4iOLqZTBSaihoo6ke8VKHIsLp_XA,4756
 matelab/client.py,sha256=SXlrTX8ekf7ympTxCXlrt4tE3UHqM5adDj4EFUXGwWg,5068
 matelab/errors.py,sha256=CJjZH12nca_-41msyLYMrIDpIaQO4CDgz2LaQRVBzpQ,1630
 matelab/py.typed,sha256=AbpHGcgLb-kRsJGnwFEktk7uzpZOCcBY74-YBdrKVGs,1
 matelab/session.py,sha256=D8i9uyAt32-bADotS-Lrb7RpmWRNYNIkIpZUijTYvy4,899
 matelab/streaming.py,sha256=36epH2josWk87Ors_JY0YsjNmtiq3NZa2iB9djLmlnY,3792
 matelab/_generated/__init__.py,sha256=jmGbXLLe3JorsGU7OUdF8iKGewFMRqkCzgyFAw7C15w,79
-matelab/_generated/models.py,sha256=VhE1ixBb-qflSTEO8VEbixnB6jtHshXqCd9gAgJBGQ8,179704
+matelab/_generated/models.py,sha256=Q19JccPYKBzXXEf6Rr1N4L9zKKh0itmfHKhTEmqAJAo,179707
 matelab/domains/__init__.py,sha256=C34IWsGoCAwP7r6uYKJ79DJkToZyrZ4LWA87ufc1i0Q,65
 matelab/domains/_attachment_content.py,sha256=z26hwFpdgAk2x1w8EGe00XBLtJ3QFDX8BPS35Zc5SoE,1461
 matelab/domains/cloud_drive.py,sha256=EoqAYWvLVUfVOsic3g-TxsQEtAI3wTp5h0_vB79KpwY,10406
 matelab/domains/groups.py,sha256=H8-Da2WTm2Ui4m3Nr1bhMNMn7stbzbRa3EmpkTRmkBU,1300
 matelab/domains/literature.py,sha256=xpdHuFCR1RpEPB_Lk8VOaddlIpGQ2rnp4kxl5a8Bk4M,27473
 matelab/domains/notebooks.py,sha256=_SvffaViECSEOkN5iwXtSv6El3fK2OYaR4RJvUCXfGk,13477
-matelab/domains/records.py,sha256=U3zOLwTjJ1YbnuayGXKroEKhUZLhsmjRCYtnFaDyJzQ,95614
+matelab/domains/records.py,sha256=0R8MdA-HJQqy0cBKrFWxesOyshGF9cisg7RyIU9Y0pg,95556
 matelab/domains/templates.py,sha256=-x7RqRLhrRnAK3HGK3c4I3C-SsAk7zpicIcvzoVd414,17698
-matelab/domains/uploads.py,sha256=6y4i85UWGxumasWw9HAubcgtK_fqgZLnBUbX0oghxQU,7699
+matelab/domains/uploads.py,sha256=NcOSJg5Q54e-rv7WIBRz3us4qUU9U4rmYvkkKiKq_tI,7702
 matelab/domains/users.py,sha256=ZhlLzC_AadwYqNqxQrqkUBgIUqL7MJ6FgMyxwq-az8s,1445
-matelab_python_sdk-0.2.0a9.dist-info/METADATA,sha256=l5luHe5D2BRV0uAUoy1EusPL6A_bpCGQSlqHEp08_Ro,2436
-matelab_python_sdk-0.2.0a9.dist-info/WHEEL,sha256=2iZrJkDIkeDh0k9SikKMqFuRP-ua6mb4Ir1AsER4BEw,87
-matelab_python_sdk-0.2.0a9.dist-info/licenses/LICENSE,sha256=z8d0m5b2O9McPEK1xHG_dWgUBT6EfBDz6wA0F7xSPTA,11358
-matelab_python_sdk-0.2.0a9.dist-info/licenses/NOTICE,sha256=Hc4scCJTof5VL3JCPI2aaewnnzCejIHUGuBVYBf-klc,98
-matelab_python_sdk-0.2.0a9.dist-info/RECORD,,
+matelab_python_sdk-0.3.0a1.dist-info/METADATA,sha256=5pGcaed3-KRhwA_j66kouW_gC6-UUWkDY-kZoXHTjv0,2424
+matelab_python_sdk-0.3.0a1.dist-info/WHEEL,sha256=2iZrJkDIkeDh0k9SikKMqFuRP-ua6mb4Ir1AsER4BEw,87
+matelab_python_sdk-0.3.0a1.dist-info/licenses/LICENSE,sha256=z8d0m5b2O9McPEK1xHG_dWgUBT6EfBDz6wA0F7xSPTA,11358
+matelab_python_sdk-0.3.0a1.dist-info/licenses/NOTICE,sha256=Hc4scCJTof5VL3JCPI2aaewnnzCejIHUGuBVYBf-klc,98
+matelab_python_sdk-0.3.0a1.dist-info/RECORD,,