sg-python-api 0.1.0__py3-none-any.whl → 0.1.2__py3-none-any.whl

{sg_python_api-0.1.0.dist-info → sg_python_api-0.1.2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: sg-python-api
-Version: 0.1.0
+Version: 0.1.2
 Summary: Python client for Autodesk Flow Production Tracking
 Project-URL: Documentation, https://github.com/dactylo/sg-python-api/tree/main/docs
 Project-URL: Homepage, https://github.com/dactylo/sg-python-api
@@ -44,9 +44,9 @@ This documentation uses SG for Flow Production Tracking, formerly named Shotgun
   for application tests.
 
 sg-python-api is an independent implementation of the documented API of Autodesk's Python client
-`3.10.2`. Some behavior differs on purpose, so validate your application's workflows against a test
-site before replacing its production client. The [migration guide](https://github.com/dactylo/sg-python-api/blob/v0.1.0/docs/migration-guide.md) walks
-through the switch, and the [compatibility reference](https://github.com/dactylo/sg-python-api/blob/v0.1.0/COMPATIBILITY.md) lists the differences.
+`3.10.3`. Some behavior differs on purpose, so validate your application's workflows against a test
+site before replacing its production client. The [migration guide](https://github.com/dactylo/sg-python-api/blob/v0.1.2/docs/migration-guide.md) walks
+through the switch, and the [compatibility reference](https://github.com/dactylo/sg-python-api/blob/v0.1.2/COMPATIBILITY.md) lists the differences.
 
 ## Installation
 
@@ -55,16 +55,9 @@ requests to a remote site require HTTPS.
 
 `sg-python-api` and Autodesk's `shotgun-api3` both install the `shotgun_api3` package, so install
 exactly one of them in a Python environment. If the official client is already installed, follow
-the [migration steps](https://github.com/dactylo/sg-python-api/blob/v0.1.0/docs/migration-guide.md#install-the-replacement) to replace it.
+the [migration steps](https://github.com/dactylo/sg-python-api/blob/v0.1.2/docs/migration-guide.md#install-the-replacement) to replace it.
 
-When a release is available on your package index, install into the Python environment that runs
-your application:
-
-```sh
-python -m pip install sg-python-api
-```
-
-To install from a checkout instead, run:
+From a checkout, install into the Python environment that runs your application:
 
 ```sh
 python -m pip install .
@@ -74,12 +67,6 @@ The base installation provides the synchronous `Shotgun` client and both `mockgu
 use the native asynchronous client, `AsyncShotgun`, install the `async` extra, which adds the
 `httpx2` HTTP library:
 
-```sh
-python -m pip install 'sg-python-api[async]'
-```
-
-From a checkout, use:
-
 ```sh
 python -m pip install '.[async]'
 ```
@@ -143,23 +130,23 @@ operation fails. Without the `async` extra, importing `AsyncShotgun` raises `Imp
 
 Share an `AsyncShotgun` only among tasks on one event loop, and cancel its work by cancelling the
 task. A cancelled write may already have reached the server, so check its outcome before repeating
-it. The [async reference](https://github.com/dactylo/sg-python-api/blob/v0.1.0/COMPATIBILITY.md#async-extension-surfaces) covers shutdown and
+it. The [async reference](https://github.com/dactylo/sg-python-api/blob/v0.1.2/COMPATIBILITY.md#async-extension-surfaces) covers shutdown and
 cancellation in detail.
 
 ## Documentation
 
 | If you want to...                                     | Read                                                                               |
 | ----------------------------------------------------- | ---------------------------------------------------------------------------------- |
-| Replace Autodesk's client in an existing application  | [Migration guide](https://github.com/dactylo/sg-python-api/blob/v0.1.0/docs/migration-guide.md)                                         |
-| Check what behaves differently from Autodesk's client | [Compatibility](https://github.com/dactylo/sg-python-api/blob/v0.1.0/COMPATIBILITY.md)                                                  |
-| Tune pooling and page prefetch, or observe requests   | [Configuration extensions](https://github.com/dactylo/sg-python-api/blob/v0.1.0/COMPATIBILITY.md#configuration-and-observer-extensions) |
-| Confirm which client loads and run a smoke test       | [Testing an installation](https://github.com/dactylo/sg-python-api/blob/v0.1.0/docs/testing.md)                                         |
-| Compare measured latency and transfer memory          | [Benchmarks](https://github.com/dactylo/sg-python-api/blob/v0.1.0/docs/benchmarks.md)                                                   |
-| See changes by version                                | [Changelog](https://github.com/dactylo/sg-python-api/blob/v0.1.0/CHANGELOG.md)                                                          |
+| Replace Autodesk's client in an existing application  | [Migration guide](https://github.com/dactylo/sg-python-api/blob/v0.1.2/docs/migration-guide.md)                                         |
+| Check what behaves differently from Autodesk's client | [Compatibility](https://github.com/dactylo/sg-python-api/blob/v0.1.2/COMPATIBILITY.md)                                                  |
+| Tune pooling and page prefetch, or observe requests   | [Configuration extensions](https://github.com/dactylo/sg-python-api/blob/v0.1.2/COMPATIBILITY.md#configuration-and-observer-extensions) |
+| Confirm which client loads and run a smoke test       | [Testing an installation](https://github.com/dactylo/sg-python-api/blob/v0.1.2/docs/testing.md)                                         |
+| Compare measured latency and transfer memory          | [Benchmarks](https://github.com/dactylo/sg-python-api/blob/v0.1.2/docs/benchmarks.md)                                                   |
+| See changes by version                                | [Changelog](https://github.com/dactylo/sg-python-api/blob/v0.1.2/CHANGELOG.md)                                                          |
 
 ## Development
 
-See the [development guide](https://github.com/dactylo/sg-python-api/blob/v0.1.0/docs/development.md) for the required tools, CI, and dependency locks.
+See the [development guide](https://github.com/dactylo/sg-python-api/blob/v0.1.2/docs/development.md) for the required tools, CI, and dependency locks.
 With those tools installed, run:
 
 ```sh
@@ -172,6 +159,6 @@ make check
 
 ## License
 
-sg-python-api is available under the [MIT License](https://github.com/dactylo/sg-python-api/blob/v0.1.0/LICENSE). It is an independent project and is
+sg-python-api is available under the [MIT License](https://github.com/dactylo/sg-python-api/blob/v0.1.2/LICENSE). It is an independent project and is
 not affiliated with or endorsed by Autodesk. Flow Production Tracking is a product of Autodesk,
 Inc.

{sg_python_api-0.1.0.dist-info → sg_python_api-0.1.2.dist-info}/RECORD

@@ -1,23 +1,23 @@
 shotgun_api3/__init__.py,sha256=fviJGOi_Gb9jHi5Q9ty5tIbeIvxMtLNrKx_4HJVgemI,2011
-shotgun_api3/_async_client.py,sha256=or11Le6Y2WB3TVTVj_7QiLfOLpDbwjs1p3VVAQhFHLQ,111070
-shotgun_api3/_async_driver.py,sha256=ldrETCNgihOcuoGYVqt8M4u2R1euNkvp3TRXLYQbzJ0,32838
+shotgun_api3/_async_client.py,sha256=UYVk_IGzMcUguJ4oCV-Nof4mL2kvzYYGuiYvW4gHeMs,113167
+shotgun_api3/_async_driver.py,sha256=NnuMmQP5KrAoANBvWIhcIUe_ljD62pK_7xSIoEIltXw,32308
 shotgun_api3/_async_httpx2.py,sha256=3pjeFsb5racGArvlR50c3w0XtrttXuRU_6E9Y-cBU3c,24387
 shotgun_api3/_async_transport.py,sha256=8iAcoFafEHKRBirBkqdIqMFgqLs1YTgtzgACudD0kM4,4928
 shotgun_api3/_capabilities.py,sha256=RrStvExVC3TAADhfbY2JpYZUXmvE63vXIJy1R-nkEII,5527
-shotgun_api3/_client.py,sha256=n4lbXG9UxQhrv1IhwsJd8dD41JIq_Xh-_zqDueSguW8,100184
-shotgun_api3/_config.py,sha256=hCKJtaO06wZFJEz-yIw2SagDeWqZMHpuqSmS33qG2Q4,55264
+shotgun_api3/_client.py,sha256=jtemxhdhFr1gwE7qB6K-62Sohb2C_S4dEO7uKpVh2Uo,102109
+shotgun_api3/_config.py,sha256=fALxy5xGI3A0nECsRDyls_9A8tvjB0DNSpTu1agNEHw,54931
 shotgun_api3/_crud.py,sha256=Ax36jA2E-lauRf2D-2rmRDj61SilOygtkjKgs5XDCUs,30319
-shotgun_api3/_driver.py,sha256=sPkiseKisJTMSNAxkCvdGXc_H1kKS6sg-rJQLKXSVgU,30139
+shotgun_api3/_driver.py,sha256=DAtnZW044TWiqscs0G1uwTiluAFtCoR2wKTbJYJHT2g,29498
 shotgun_api3/_errors.py,sha256=fk7v3XbmZK63M272r5wDwF_GgI-4RynPfAWv1P-J-GI,1480
 shotgun_api3/_execution.py,sha256=Kn2Yd9sXIA975stnof7MeuA8bT3dyOuWDIqQnP65LO0,8235
-shotgun_api3/_files.py,sha256=a1PfHKV4OMi6j7BQG2rkMPCcaNTB5uAWNiqCh64AEXg,35223
-shotgun_api3/_methods.py,sha256=8dD5BUN_5hnGAYomUEAX1dHZnI4Cliid6PrrP8AhhPI,36132
-shotgun_api3/_protocol.py,sha256=dKr1XqB6Xo56QloZ2MAyN4ulqYkTjw8VYeJRd5QHufQ,45286
+shotgun_api3/_files.py,sha256=-eXHyG0U9mEAdYTthgVEhlzBKYUOt4g-3k9D522L3zM,33900
+shotgun_api3/_methods.py,sha256=pYzx2pN0nus6vPWf-Gl8Zz4MgRf8R4b7kvxN8lhoXgc,37685
+shotgun_api3/_protocol.py,sha256=0ccL65aIm3v2w6dOtNnZuFrKQncA8WO4yadtxRP55-w,42194
 shotgun_api3/_sentinel.py,sha256=KAQzQjJVhTTZPLFY1f88-_vP7U06i2g6ZS7KJcn4vIA,116
 shotgun_api3/_sg_timezone.py,sha256=yr7Wdln9fwfTVGMQSFsgO-eduuTHQ5EbSY5xEVQ2tYw,115
 shotgun_api3/_signatures.py,sha256=_yhNnbkVF-0opaBfg9H6SauBN2RT4hJsHGa3ZO3Ug4s,1622
 shotgun_api3/_transport.py,sha256=LmQ0e2VvAKwFdNy4SyfRHwgKC6GWnwkIN5Wa2fin3AM,30047
-shotgun_api3/_version.py,sha256=yK498PuHvOUCFnIC1QKSqvFXzUBBuOMHBsVo5gSpFCE,102
+shotgun_api3/_version.py,sha256=0NYED9oy2nGCvTERMwWJvajshS5qzH_v4w7QUAGAivY,102
 shotgun_api3/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 shotgun_api3/shotgun.py,sha256=X7PLlCC-gR8dJgY_uLYXw_LWN8mz5MsQsSYJldtavTk,1706
 shotgun_api3/lib/__init__.py,sha256=4WGYod6xHcj23rapx5bTDGdjT52H1CAQNMz4BmzNmn0,55
@@ -25,7 +25,7 @@ shotgun_api3/lib/sgtimezone.py,sha256=nYSaCsIeq_SJh7YgL4yWN7dTVVz9lAfx-G3mzsHb8i
 shotgun_api3/lib/mockgun/__init__.py,sha256=2mHjMJAV4mZ8JvnP8WHn6tkdMJoB7UQtNSs99YzNW30,703
 shotgun_api3/lib/mockgun/_async.py,sha256=7bTZFdlSzeoGq9fRbPBAf-X08qDmrkzV9rxskx5AGX8,10812
 shotgun_api3/lib/mockgun/_mockgun.py,sha256=k2cqLMCKpU5oIbUGiYulf1aIU0HLrMB6DQQ3KrCy7WQ,65093
-sg_python_api-0.1.0.dist-info/METADATA,sha256=7Wzieh6ix8BwZJ_oD-B4_G-bO6m5pPDr1wzC5EFYhUQ,7789
-sg_python_api-0.1.0.dist-info/WHEEL,sha256=W3fkpkm7-wf9vBI5Z-7s0eWkeM-spu78I8Neb98DeEg,87
-sg_python_api-0.1.0.dist-info/licenses/LICENSE,sha256=V3moMsQxKDchTd3mtXl5J-ODaNBDvFrapOf1DK7Nx_U,1082
-sg_python_api-0.1.0.dist-info/RECORD,,
+sg_python_api-0.1.2.dist-info/METADATA,sha256=2Zv6g9pJZ28QttHMO6Q1yYWvyczPypCHc-QCAYbjIaQ,7587
+sg_python_api-0.1.2.dist-info/WHEEL,sha256=W3fkpkm7-wf9vBI5Z-7s0eWkeM-spu78I8Neb98DeEg,87
+sg_python_api-0.1.2.dist-info/licenses/LICENSE,sha256=V3moMsQxKDchTd3mtXl5J-ODaNBDvFrapOf1DK7Nx_U,1082
+sg_python_api-0.1.2.dist-info/RECORD,,

shotgun_api3/_async_client.py

@@ -51,7 +51,6 @@ from ._client import (
     expose_constructor_signature,
 )
 from ._config import (
-    CompatibilityWarningCode,
     Config,
     RequestContext,
     advance_transport_generation,
@@ -60,7 +59,6 @@ from ._config import (
     server_host,
     server_page_limit,
 )
-from ._errors import ShotgunError
 from ._execution import SuppressedExceptionCapture, release_lease, retire_transport
 from ._signatures import bind_arguments, expose_signature
 from ._transport import (
@@ -288,7 +286,6 @@ class _InvocationOptions:
     """Collect non-payload controls for one client invocation."""
 
     auth_spec: _protocol.AuthSpec | None = None
-    compatibility_warning_codes: tuple[CompatibilityWarningCode, ...] = ()
     include_auth: bool = True
     logical_method_name: str | None = None
 
@@ -523,7 +520,6 @@ class AsyncShotgun:
             outbound,
             context,
             include_auth=invocation.options.include_auth,
-            compatibility_warning_codes=invocation.options.compatibility_warning_codes,
             _logical_method_name=invocation.options.logical_method_name,
         )
         return _protocol.transform_inbound(result, context.convert_datetimes_to_utc)
@@ -1040,29 +1036,6 @@ class AsyncShotgun:
             lambda _text, _headers: None,
         )
 
-    @staticmethod
-    async def _upload_form(
-        driver: AsyncDriver,
-        context: RequestContext,
-        prepared: _files.PreparedUpload,
-    ) -> Never:
-        """Send the observed form request without guessing a success result."""
-        if context.canonical_origin is None:
-            raise ValueError('server parameters must be configured before upload I/O')
-        exchange = _files.build_form_upload_exchange(
-            context.canonical_origin,
-            context.user_agent,
-            prepared,
-            context.auth,
-            chunk_size=_ASYNC_FILE_BATCH_SIZE,
-        )
-
-        def reject_success(_text: str, _headers: Mapping[str, str]) -> Never:
-            raise ShotgunError('form upload success response is not established')
-
-        await _execute_upload_exchange(driver, context, exchange, reject_success)
-        raise AssertionError('form upload response parser returned')
-
     @staticmethod
     async def _upload_link(
         driver: AsyncDriver,
@@ -1165,14 +1138,14 @@ class AsyncShotgun:
         arguments = prepared.options.arguments
         capabilities = await self._ensure_readiness(context, driver)
         operation_context = await self._authenticated_context(context, driver)
-        upload_path = _files.choose_upload_path(
-            capabilities.server_info,
-            arguments.entity_type,
-            arguments.field_name,
-            prepared.file_size,
+        upload_path = _files.require_supported_upload_path(
+            _files.choose_upload_path(
+                capabilities.server_info,
+                arguments.entity_type,
+                arguments.field_name,
+                prepared.file_size,
+            )
         )
-        if upload_path == 'form':
-            return await self._upload_form(driver, operation_context, prepared)
         multipart = upload_path == 'multipart'
         upload_info = await self._upload_allocation(
             driver,
@@ -1211,6 +1184,16 @@ class AsyncShotgun:
         prepared: _files.PreparedUpload,
     ) -> int:
         """Execute the exact direct-storage thumbnail workflow."""
+        capabilities = await self._ensure_readiness(context, driver)
+        arguments = prepared.options.arguments
+        _files.require_supported_upload_path(
+            _files.choose_upload_path(
+                capabilities.server_info,
+                arguments.entity_type,
+                arguments.field_name,
+                prepared.file_size,
+            )
+        )
         upload_info = await self._upload_allocation(
             driver,
             context,
@@ -1220,6 +1203,28 @@ class AsyncShotgun:
         await self._upload_direct(driver, context, prepared, upload_info)
         return await self._upload_link(driver, context, prepared, upload_info)
 
+    async def _upload_thumbnails_after_write(
+        self,
+        entity_type: str,
+        entity_id: int,
+        thumbnails: dict[str, object],
+        result: dict[str, object],
+    ) -> dict[str, object]:
+        """Upload separated thumbnail paths and merge their current field values."""
+        if not thumbnails:
+            return result
+        for field_name, path in thumbnails.items():
+            upload = (
+                self.upload_filmstrip_thumbnail
+                if field_name == 'filmstrip_image'
+                else self.upload_thumbnail
+            )
+            await upload(entity_type, entity_id, cast('str', path))
+        current = await self.find_one(entity_type, [['id', 'is', entity_id]], list(thumbnails))
+        if current is not None:
+            result.update({field_name: current.get(field_name) for field_name in thumbnails})
+        return result
+
     @overload
     async def activity_stream_read(self, entity_type: Never) -> dict[str, object]: ...
 
@@ -1520,6 +1525,10 @@ class AsyncShotgun:
     ) -> dict[str, object]:
         """Create an entity with the supplied field values.
 
+        Non-empty `image` and `filmstrip_image` values are file paths. They are
+        uploaded as thumbnails after the entity is created, and the result
+        includes their current field values.
+
         Args:
             entity_type: Entity type to create.
             data: Field values for the new entity.
@@ -1530,14 +1539,22 @@ class AsyncShotgun:
 
         Raises:
             ShotgunError: If an RPC fault or terminal transport failure occurs,
-                or if `data`, its field names, `return_fields`, or the server
-                result is invalid.
+                if `data`, its field names, `return_fields`, or the server
+                result is invalid, or if a thumbnail path is not a nonempty
+                file. A thumbnail failure occurs after the entity is created.
             ProtocolError: If a server request returns an HTTP error.
             ValueError: If authenticated HTTP violates the configured origin
                 policy.
         """
-        params = _crud.build_create_params(entity_type, data, return_fields)
-        return _crud.require_dictionary_result(await self._call('create', params), 'create')
+        field_data, thumbnails = _files.split_thumbnail_uploads(data, keep_image_none=False)
+        params = _crud.build_create_params(entity_type, field_data, return_fields)
+        result = _crud.require_dictionary_result(await self._call('create', params), 'create')
+        if not thumbnails:
+            return result
+        entity_id = _crud.require_entity_id(result.get('id'), 'create did not return an entity id')
+        return await self._upload_thumbnails_after_write(
+            entity_type, entity_id, thumbnails, result
+        )
 
     async def delete(self, entity_type: str, entity_id: int) -> bool:
         """Retire an entity.
@@ -1642,6 +1659,15 @@ class AsyncShotgun:
         except (TransportError, _errors.ProtocolError, OSError):
             raise _errors.ShotgunFileDownloadError('attachment download failed') from None
 
+    async def entity_types(self) -> Never:
+        """Reject the deprecated alias of `schema_entity_read()` without I/O.
+
+        Raises:
+            ShotgunError: Always, naming `schema_entity_read()` as the
+                replacement.
+        """
+        raise _methods.entity_types_alias_error()
+
     @overload
     async def export_page(
         self,
@@ -1662,6 +1688,9 @@ class AsyncShotgun:
     async def export_page(self, *args: object, **kwargs: object) -> str:
         """Export a page using the documented arguments.
 
+        The Page or its layout must be marked API Exportable in the web UI, or
+        the server rejects the export.
+
         Args:
             *args: Positional values from the documented `export_page`
                 signature.
@@ -1982,7 +2011,11 @@ class AsyncShotgun:
             entity,
             seed_entity_field,
         )
-        result = await self._call('nav_search_entity', params)
+        result = await self._call(
+            'nav_search',
+            params,
+            _InvocationOptions(logical_method_name='nav_search_entity'),
+        )
         return _methods.require_dictionary_list_result(result, 'nav_search_entity')
 
     async def nav_search_string(
@@ -2013,7 +2046,11 @@ class AsyncShotgun:
             search_string,
             seed_entity_field,
         )
-        result = await self._call('nav_search_string', params)
+        result = await self._call(
+            'nav_search',
+            params,
+            _InvocationOptions(logical_method_name='nav_search_string'),
+        )
         return _methods.require_dictionary_list_result(result, 'nav_search_string')
 
     async def note_thread_read(
@@ -2038,7 +2075,11 @@ class AsyncShotgun:
                 policy.
         """
         params = _methods.build_note_thread_read_params(note_id, entity_fields)
-        result = await self._call('note_thread_read', params)
+        result = await self._call(
+            'note_thread_contents',
+            params,
+            _InvocationOptions(logical_method_name='note_thread_read'),
+        )
         return _methods.require_dictionary_list_result(result, 'note_thread_read')
 
     async def preferences_read(self, prefs: list[str] | None = None) -> dict[str, object]:
@@ -2085,6 +2126,18 @@ class AsyncShotgun:
         params = _crud.build_entity_action_params(entity_type, entity_id)
         return _crud.require_boolean_result(await self._call('revive', params), 'revive')
 
+    async def schema(self, entity_type: str) -> Never:
+        """Reject the deprecated alias of `schema_field_read()` without I/O.
+
+        Args:
+            entity_type: Entity type named in the replacement suggestion.
+
+        Raises:
+            ShotgunError: Always, naming the equivalent `schema_field_read()`
+                call.
+        """
+        raise _methods.schema_alias_error(entity_type)
+
     async def schema_entity_read(
         self,
         project_entity: dict[str, Any] | None = None,
@@ -2104,34 +2157,12 @@ class AsyncShotgun:
             ValueError: If authenticated HTTP violates the configured origin
                 policy.
         """
-        warnings_codes = _methods.consume_compatibility_warnings(
-            _methods.SCHEMA_ENTITY_READ_WARNINGS,
-            self,
-        )
         result = await self._call(
             'schema_entity_read',
             _methods.build_schema_entity_read_params(project_entity),
-            _InvocationOptions(compatibility_warning_codes=warnings_codes),
         )
         return _crud.require_dictionary_result(result, 'schema_entity_read')
 
-    async def entity_types(self) -> dict[str, object]:
-        """Return entity schema through the deprecated alias.
-
-        Returns:
-            Entity-type schema data returned by the server.
-
-        Raises:
-            ShotgunError: If an RPC fault or terminal transport failure occurs,
-                or if the server result is not a dictionary.
-            ProtocolError: If a server request returns an HTTP error.
-            ValueError: If authenticated HTTP violates the configured origin
-                policy.
-        """
-        _methods.warn_entity_types_alias()
-        with _methods.entity_types_alias(self):
-            return await self.schema_entity_read()
-
     async def schema_field_create(
         self,
         entity_type: str,
@@ -2210,10 +2241,6 @@ class AsyncShotgun:
             ValueError: If authenticated HTTP violates the configured origin
                 policy.
         """
-        warning_codes = _methods.consume_compatibility_warnings(
-            _methods.SCHEMA_FIELD_READ_WARNINGS,
-            self,
-        )
         result = await self._call(
             'schema_field_read',
             _methods.build_schema_field_read_params(
@@ -2221,30 +2248,9 @@ class AsyncShotgun:
                 field_name,
                 project_entity,
             ),
-            _InvocationOptions(compatibility_warning_codes=warning_codes),
         )
         return _crud.require_dictionary_result(result, 'schema_field_read')
 
-    async def schema(self, entity_type: str) -> dict[str, object]:
-        """Return field schema through the deprecated alias.
-
-        Args:
-            entity_type: Entity type whose fields to return.
-
-        Returns:
-            Field schema data returned by the server.
-
-        Raises:
-            ShotgunError: If an RPC fault or terminal transport failure occurs,
-                or if the server result is invalid.
-            ProtocolError: If a server request returns an HTTP error.
-            ValueError: If authenticated HTTP violates the configured origin
-                policy.
-        """
-        _methods.warn_schema_alias()
-        with _methods.schema_alias(self):
-            return await self.schema_field_read(entity_type)
-
     async def schema_field_update(
         self,
         entity_type: str,
@@ -2352,7 +2358,8 @@ class AsyncShotgun:
 
         Supply exactly one of `thumbnail_path` and `source_entity`. A local
         thumbnail is uploaded to the first target before it is shared with the
-        remaining targets.
+        remaining targets. A local thumbnail is rejected before any upload
+        request if the server requires legacy form uploads.
 
         Args:
             entities: Nonempty list of target entities with `type` and `id`.
@@ -2369,7 +2376,8 @@ class AsyncShotgun:
             TypeError: If forwarded arguments do not match the upload signature
                 or include `field_name`.
             ShotgunError: If an RPC fault or terminal transport failure occurs,
-                or if the source selection, entities, or transport fails.
+                or if the source selection, entities, or transport fails, or a
+                local upload requires the legacy form route.
             ShotgunThumbnailNotReady: If an uploaded source stays transient.
             ProtocolError: If an upload endpoint returns an HTTP error.
             ValueError: If authenticated HTTP violates the configured origin
@@ -2559,6 +2567,12 @@ class AsyncShotgun:
     ) -> dict[str, object]:
         """Update fields on an existing entity.
 
+        Non-empty `image` and `filmstrip_image` values are file paths. They are
+        uploaded as thumbnails after the other fields are updated, and the
+        result includes their current field values. An `image` of `None` clears
+        both thumbnails. When no other fields remain, no update request is sent
+        and the result contains only `id` and `type`.
+
         Args:
             entity_type: Entity type to update.
             entity_id: Numeric entity identifier.
@@ -2570,19 +2584,29 @@ class AsyncShotgun:
 
         Raises:
             ShotgunError: If an RPC fault or terminal transport failure occurs,
-                or if `data`, its field names, `multi_entity_update_modes`, or
-                the server result is invalid.
+                if `data`, its field names, `multi_entity_update_modes`, or the
+                server result is invalid, or if a thumbnail path is not a
+                nonempty file. A thumbnail failure occurs after the update.
             ProtocolError: If a server request returns an HTTP error.
             ValueError: If authenticated HTTP violates the configured origin
                 policy.
         """
+        field_data, thumbnails = _files.split_thumbnail_uploads(data, keep_image_none=True)
         params = _crud.build_update_params(
             entity_type,
             entity_id,
-            data,
+            field_data,
             multi_entity_update_modes,
         )
-        return _crud.require_dictionary_result(await self._call('update', params), 'update')
+        result: dict[str, object] = {'id': entity_id, 'type': entity_type}
+        if params['fields']:
+            result = _crud.require_dictionary_result(
+                await self._call('update', params),
+                'update',
+            )
+        return await self._upload_thumbnails_after_write(
+            entity_type, entity_id, thumbnails, result
+        )
 
     async def update_project_last_accessed(
         self,
@@ -2626,9 +2650,8 @@ class AsyncShotgun:
     async def upload(self, *args: object, **kwargs: object) -> int:
         """Upload a file or thumbnail and return its Attachment ID.
 
-        A successful HTTP response from the legacy form-upload route still
-        raises `ShotgunError`; no Attachment ID is established for that route.
-        The form request has already been sent when this error is raised.
+        A server requiring legacy form uploads raises `ShotgunError` before any
+        upload request is sent. Server capability reads may occur.
 
         Args:
             *args: Positional arguments from the documented upload signature.
@@ -2640,8 +2663,8 @@ class AsyncShotgun:
         Raises:
             TypeError: If arguments do not match the documented signature.
             ShotgunError: If the file or an upload response is invalid, an RPC
-                fault or terminal transport failure occurs, or the legacy
-                form-upload route succeeds.
+                fault or terminal transport failure occurs, or the server
+                requires legacy form uploads.
             ProtocolError: If an upload endpoint returns an HTTP error.
             ValueError: If authenticated HTTP violates the configured origin
                 policy.
@@ -2673,6 +2696,9 @@ class AsyncShotgun:
     ) -> int:
         """Upload a filmstrip thumbnail through `upload`.
 
+        Servers requiring legacy form uploads are rejected before any upload
+        request is sent.
+
         Args:
             entity_type: Entity type receiving the thumbnail.
             entity_id: Numeric identifier of the receiving entity.
@@ -2685,7 +2711,8 @@ class AsyncShotgun:
         Raises:
             TypeError: If forwarded arguments do not match `upload`.
             ShotgunError: If an RPC fault or terminal transport failure occurs,
-                or if the file, upload response, or transport fails.
+                or if the file, upload response, or transport fails, or the
+                server requires legacy form uploads.
             ProtocolError: If an upload endpoint returns an HTTP error.
             ValueError: If authenticated HTTP violates the configured origin
                 policy.
@@ -2707,6 +2734,9 @@ class AsyncShotgun:
     ) -> int:
         """Upload a static thumbnail through `upload`.
 
+        Servers requiring legacy form uploads are rejected before any upload
+        request is sent.
+
         Args:
             entity_type: Entity type receiving the thumbnail.
             entity_id: Numeric identifier of the receiving entity.
@@ -2719,7 +2749,8 @@ class AsyncShotgun:
         Raises:
             TypeError: If forwarded arguments do not match `upload`.
             ShotgunError: If an RPC fault or terminal transport failure occurs,
-                or if the file, upload response, or transport fails.
+                or if the file, upload response, or transport fails, or the
+                server requires legacy form uploads.
             ProtocolError: If an upload endpoint returns an HTTP error.
             ValueError: If authenticated HTTP violates the configured origin
                 policy.
@@ -2735,28 +2766,40 @@ class AsyncShotgun:
     async def user_subscriptions_create(self, users: list[dict[str, Any]]) -> bool:
         """Assign subscriptions to users.
 
+        The server accepts this call from scripts and from human users with
+        permission to manage subscriptions, such as members of the Admin
+        permission group. It refuses other human users.
+
         Args:
-            users: Subscription dictionaries containing `user_id` keys.
+            users: Subscription dictionaries with a string or integer
+                `humanUserId`; integers become decimal string keys and booleans
+                are not accepted. Each user may appear only once.
+                `subscription` is `None`, a string, or a list of strings.
+                Lists are copied in order. Other entry keys are ignored.
 
         Returns:
-            Whether the server created the subscriptions.
+            `True` when every per-user report is `None`, meaning the server
+            reported no problem; `False` when any user has a non-`None` report.
 
         Raises:
             ShotgunError: If an RPC fault or terminal transport failure occurs,
-                or if arguments or the server result are invalid.
+                or if `users` contains invalid or duplicate entries, or the
+                server result is not a mapping with string keys.
             ProtocolError: If a server request returns an HTTP error.
             ValueError: If authenticated HTTP violates the configured origin
                 policy.
         """
         params = _methods.build_user_subscriptions_create_params(users)
         result = await self._call('user_subscriptions_create', params)
-        return _crud.require_boolean_result(result, 'user_subscriptions_create')
+        return _methods.require_user_subscriptions_create_result(result)
 
     async def user_subscriptions_read(self) -> list[dict[str, object]]:
-        """List the current user's subscriptions.
+        """List user subscriptions in server order.
 
         Returns:
-            User subscription dictionaries returned by the server.
+            Subscription entries in server order, each with an unchanged string
+            `humanUserId` and a `subscription` of `None`, a string, or a copied
+            list of strings.
 
         Raises:
             ShotgunError: If an RPC fault or terminal transport failure occurs,
@@ -2766,7 +2809,7 @@ class AsyncShotgun:
                 policy.
         """
         result = await self._call('user_subscriptions_read', None)
-        return _methods.require_dictionary_list_result(result, 'user_subscriptions_read')
+        return _methods.require_user_subscriptions_result(result)
 
     async def work_schedule_read(
         self,