autoassembler 0.3.1__py3-none-any.whl

autoassembler/assemblies/client.py

@@ -0,0 +1,1177 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+
+from .. import core
+from ..core.client_wrapper import AsyncClientWrapper, SyncClientWrapper
+from ..core.request_options import RequestOptions
+from ..types.assembly import Assembly
+from ..types.assembly_connections_response import AssemblyConnectionsResponse
+from ..types.assembly_info import AssemblyInfo
+from ..types.assembly_json_response import AssemblyJsonResponse
+from ..types.assembly_version_summary import AssemblyVersionSummary
+from ..types.diff_report import DiffReport
+from ..types.filter import Filter
+from ..types.process_assembly_response import ProcessAssemblyResponse
+from ..types.search_assemblies_response import SearchAssembliesResponse
+from ..types.sort import Sort
+from ..types.upload_response import UploadResponse
+from .raw_client import AsyncRawAssembliesClient, RawAssembliesClient
+from .types.delete_assembly_response import DeleteAssemblyResponse
+from .types.download_assembly_cad_request_namespace import DownloadAssemblyCadRequestNamespace
+from .types.get_assembly_info_request_namespace import GetAssemblyInfoRequestNamespace
+from .types.get_status_request_namespace import GetStatusRequestNamespace
+from .types.get_status_response import GetStatusResponse
+from .types.get_structure_request_namespace import GetStructureRequestNamespace
+from .types.list_assembly_versions_request_namespace import ListAssemblyVersionsRequestNamespace
+from .types.list_connections_request_namespace import ListConnectionsRequestNamespace
+from .types.process_request_namespace import ProcessRequestNamespace
+from .types.update_assembly_info_request_namespace import UpdateAssemblyInfoRequestNamespace
+
+# this is used as the default value for optional parameters
+OMIT = typing.cast(typing.Any, ...)
+
+
+class AssembliesClient:
+    def __init__(self, *, client_wrapper: SyncClientWrapper):
+        self._raw_client = RawAssembliesClient(client_wrapper=client_wrapper)
+
+    @property
+    def with_raw_response(self) -> RawAssembliesClient:
+        """
+        Retrieves a raw implementation of this client that returns raw responses.
+
+        Returns
+        -------
+        RawAssembliesClient
+        """
+        return self._raw_client
+
+    def upload(
+        self, *, file: typing.Optional[core.File] = OMIT, request_options: typing.Optional[RequestOptions] = None
+    ) -> UploadResponse:
+        """
+        Parameters
+        ----------
+        file : typing.Optional[core.File]
+            See core.File for more documentation
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        UploadResponse
+            Successful upload
+
+        Examples
+        --------
+        from autoassembler import AutoAssembler
+
+        client = AutoAssembler(
+            token="YOUR_TOKEN",
+        )
+        client.assemblies.upload()
+        """
+        _response = self._raw_client.upload(file=file, request_options=request_options)
+        return _response.data
+
+    def search(
+        self,
+        *,
+        offset: typing.Optional[int] = OMIT,
+        limit: typing.Optional[int] = OMIT,
+        filters: typing.Optional[typing.Sequence[Filter]] = OMIT,
+        sort: typing.Optional[Sort] = OMIT,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> SearchAssembliesResponse:
+        """
+        Parameters
+        ----------
+        offset : typing.Optional[int]
+
+        limit : typing.Optional[int]
+
+        filters : typing.Optional[typing.Sequence[Filter]]
+
+        sort : typing.Optional[Sort]
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        SearchAssembliesResponse
+            Search results
+
+        Examples
+        --------
+        from autoassembler import AutoAssembler
+
+        client = AutoAssembler(
+            token="YOUR_TOKEN",
+        )
+        client.assemblies.search()
+        """
+        _response = self._raw_client.search(
+            offset=offset, limit=limit, filters=filters, sort=sort, request_options=request_options
+        )
+        return _response.data
+
+    def diff(
+        self,
+        *,
+        reference_id: str,
+        target_id: str,
+        context_n_hops: typing.Optional[int] = OMIT,
+        async_: typing.Optional[bool] = OMIT,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> DiffReport:
+        """
+        Compares a baseline assembly (`referenceId`) with another assembly
+        revision (`targetId`) and returns a structured report describing what
+        changed.
+
+        Typical UI mapping:
+        - Use `summary` for aggregate counts and badges.
+        - Use `details.geomDiffNodes.reference` for parts present only in the baseline.
+        - Use `details.geomDiffNodes.target` for parts present only in the target.
+        - Use `details.movedPosePairs` for matching parts that changed position or orientation.
+        - Use `details.swaps` for likely replacements, swaps, or renamed parts.
+        - Treat `flags` as supporting metadata for explanations, filters, or diagnostics.
+
+        Set `async` to `true` to get `202` with the operation computing the diff
+        (AIP-151): poll `GET /api/v4/operations/{id}` until it is `done`, then fetch
+        `resultUrl` for the `DiffReport`.
+
+        **Deprecated:** calling without `async: true`, which blocks until the diff is
+        computed and answers `200` with the report, with a `Deprecation` header
+        (RFC 9745). Pass `async: true` and wait on the operation instead; a later
+        version will always answer `202`.
+
+        Parameters
+        ----------
+        reference_id : str
+            Baseline assembly ID.
+
+        target_id : str
+            Target assembly ID.
+
+        context_n_hops : typing.Optional[int]
+            Graph radius used to collect surviving parts that define each added, removed, or swapped part's liaison context.
+
+        async_ : typing.Optional[bool]
+            When true, queues the diff and returns 202 with the operation computing it. Omitting it (or `false`) is deprecated.
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        DiffReport
+            Deprecated: the diff report, when called without `async: true`. Pass `async: true` and wait on the operation instead.
+
+        Examples
+        --------
+        from autoassembler import AutoAssembler
+
+        client = AutoAssembler(
+            token="YOUR_TOKEN",
+        )
+        client.assemblies.diff(
+            reference_id="referenceId",
+            target_id="targetId",
+        )
+        """
+        _response = self._raw_client.diff(
+            reference_id=reference_id,
+            target_id=target_id,
+            context_n_hops=context_n_hops,
+            async_=async_,
+            request_options=request_options,
+        )
+        return _response.data
+
+    def delete_assembly(
+        self, id: str, *, request_options: typing.Optional[RequestOptions] = None
+    ) -> DeleteAssemblyResponse:
+        """
+        Parameters
+        ----------
+        id : str
+            Assembly ID.
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        DeleteAssemblyResponse
+            Assembly deleted successfully
+
+        Examples
+        --------
+        from autoassembler import AutoAssembler
+
+        client = AutoAssembler(
+            token="YOUR_TOKEN",
+        )
+        client.assemblies.delete_assembly(
+            id="id",
+        )
+        """
+        _response = self._raw_client.delete_assembly(id, request_options=request_options)
+        return _response.data
+
+    def process(
+        self,
+        namespace: ProcessRequestNamespace,
+        id: str,
+        *,
+        attributes: typing.Optional[typing.Dict[str, typing.Sequence[str]]] = OMIT,
+        force: typing.Optional[bool] = OMIT,
+        clear_cache: typing.Optional[bool] = OMIT,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> ProcessAssemblyResponse:
+        """
+        Parameters
+        ----------
+        namespace : ProcessRequestNamespace
+            Assembly URL namespace. `user`, `shared`, and `public` are routed through the same assembly lookup.
+
+        id : str
+            Assembly ID.
+
+        attributes : typing.Optional[typing.Dict[str, typing.Sequence[str]]]
+            Attribute patterns for marking occurrences during parsing. Keys are attribute names (e.g. `consolidated`); values are glob patterns.
+
+        force : typing.Optional[bool]
+            Force reprocessing even if already processed.
+
+        clear_cache : typing.Optional[bool]
+            Clear cached planning data for this assembly.
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        ProcessAssemblyResponse
+            Processing request accepted or skipped
+
+        Examples
+        --------
+        from autoassembler import AutoAssembler
+
+        client = AutoAssembler(
+            token="YOUR_TOKEN",
+        )
+        client.assemblies.process(
+            namespace="user",
+            id="id",
+        )
+        """
+        _response = self._raw_client.process(
+            namespace, id, attributes=attributes, force=force, clear_cache=clear_cache, request_options=request_options
+        )
+        return _response.data
+
+    def get_status(
+        self, namespace: GetStatusRequestNamespace, id: str, *, request_options: typing.Optional[RequestOptions] = None
+    ) -> GetStatusResponse:
+        """
+        Parameters
+        ----------
+        namespace : GetStatusRequestNamespace
+            Assembly URL namespace. `user`, `shared`, and `public` are routed through the same assembly lookup.
+
+        id : str
+            Assembly ID.
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        GetStatusResponse
+            Current processing status of the assembly
+
+        Examples
+        --------
+        from autoassembler import AutoAssembler
+
+        client = AutoAssembler(
+            token="YOUR_TOKEN",
+        )
+        client.assemblies.get_status(
+            namespace="user",
+            id="id",
+        )
+        """
+        _response = self._raw_client.get_status(namespace, id, request_options=request_options)
+        return _response.data
+
+    def get_structure(
+        self,
+        namespace: GetStructureRequestNamespace,
+        id: str,
+        *,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> AssemblyJsonResponse:
+        """
+        Parameters
+        ----------
+        namespace : GetStructureRequestNamespace
+            Assembly URL namespace. `user`, `shared`, and `public` are routed through the same assembly lookup.
+
+        id : str
+            Assembly ID.
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        AssemblyJsonResponse
+            Assembly metadata and structure.
+
+        Examples
+        --------
+        from autoassembler import AutoAssembler
+
+        client = AutoAssembler(
+            token="YOUR_TOKEN",
+        )
+        client.assemblies.get_structure(
+            namespace="user",
+            id="id",
+        )
+        """
+        _response = self._raw_client.get_structure(namespace, id, request_options=request_options)
+        return _response.data
+
+    def list_connections(
+        self,
+        namespace: ListConnectionsRequestNamespace,
+        id: str,
+        *,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> AssemblyConnectionsResponse:
+        """
+        Returns physical connections between occurrences. Each connection is a contact or interference relationship.
+
+        Parameters
+        ----------
+        namespace : ListConnectionsRequestNamespace
+            Assembly URL namespace. `user`, `shared`, and `public` are routed through the same assembly lookup.
+
+        id : str
+            Assembly ID.
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        AssemblyConnectionsResponse
+            Assembly connections.
+
+        Examples
+        --------
+        from autoassembler import AutoAssembler
+
+        client = AutoAssembler(
+            token="YOUR_TOKEN",
+        )
+        client.assemblies.list_connections(
+            namespace="user",
+            id="id",
+        )
+        """
+        _response = self._raw_client.list_connections(namespace, id, request_options=request_options)
+        return _response.data
+
+    def get_assembly_info(
+        self,
+        namespace: GetAssemblyInfoRequestNamespace,
+        id: str,
+        *,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> AssemblyInfo:
+        """
+        Parameters
+        ----------
+        namespace : GetAssemblyInfoRequestNamespace
+            Assembly URL namespace. `user`, `shared`, and `public` are routed through the same assembly lookup.
+
+        id : str
+            Assembly ID.
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        AssemblyInfo
+            Assembly metadata fields.
+
+        Examples
+        --------
+        from autoassembler import AutoAssembler
+
+        client = AutoAssembler(
+            token="YOUR_TOKEN",
+        )
+        client.assemblies.get_assembly_info(
+            namespace="user",
+            id="id",
+        )
+        """
+        _response = self._raw_client.get_assembly_info(namespace, id, request_options=request_options)
+        return _response.data
+
+    def update_assembly_info(
+        self,
+        namespace: UpdateAssemblyInfoRequestNamespace,
+        id: str,
+        *,
+        name: typing.Optional[str] = OMIT,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> Assembly:
+        """
+        Currently only `name` is writable.
+
+        Parameters
+        ----------
+        namespace : UpdateAssemblyInfoRequestNamespace
+            Assembly URL namespace. `user`, `shared`, and `public` are routed through the same assembly lookup.
+
+        id : str
+            Assembly ID.
+
+        name : typing.Optional[str]
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        Assembly
+            Updated assembly record.
+
+        Examples
+        --------
+        from autoassembler import AutoAssembler
+
+        client = AutoAssembler(
+            token="YOUR_TOKEN",
+        )
+        client.assemblies.update_assembly_info(
+            namespace="user",
+            id="id",
+        )
+        """
+        _response = self._raw_client.update_assembly_info(namespace, id, name=name, request_options=request_options)
+        return _response.data
+
+    def list_assembly_versions(
+        self,
+        namespace: ListAssemblyVersionsRequestNamespace,
+        id: str,
+        *,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> typing.List[AssemblyVersionSummary]:
+        """
+        Returns other assemblies that share this assembly's `externalId` (for example an Onshape document). Empty when `externalId` is unset.
+
+        Parameters
+        ----------
+        namespace : ListAssemblyVersionsRequestNamespace
+            Assembly URL namespace. `user`, `shared`, and `public` are routed through the same assembly lookup.
+
+        id : str
+            Assembly ID.
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        typing.List[AssemblyVersionSummary]
+            Version list.
+
+        Examples
+        --------
+        from autoassembler import AutoAssembler
+
+        client = AutoAssembler(
+            token="YOUR_TOKEN",
+        )
+        client.assemblies.list_assembly_versions(
+            namespace="user",
+            id="id",
+        )
+        """
+        _response = self._raw_client.list_assembly_versions(namespace, id, request_options=request_options)
+        return _response.data
+
+    def download_assembly_cad(
+        self,
+        namespace: DownloadAssemblyCadRequestNamespace,
+        id: str,
+        *,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> typing.Iterator[bytes]:
+        """
+        Parameters
+        ----------
+        namespace : DownloadAssemblyCadRequestNamespace
+            Assembly URL namespace. `user`, `shared`, and `public` are routed through the same assembly lookup.
+
+        id : str
+            Assembly ID.
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration. You can pass in configuration such as `chunk_size`, and more to customize the request and response.
+
+        Returns
+        -------
+        typing.Iterator[bytes]
+            CAD file bytes (attachment download).
+
+        Examples
+        --------
+        from autoassembler import AutoAssembler
+
+        client = AutoAssembler(
+            token="YOUR_TOKEN",
+        )
+        client.assemblies.download_assembly_cad(
+            namespace="user",
+            id="id",
+        )
+        """
+        with self._raw_client.download_assembly_cad(namespace, id, request_options=request_options) as r:
+            yield from r.data
+
+
+class AsyncAssembliesClient:
+    def __init__(self, *, client_wrapper: AsyncClientWrapper):
+        self._raw_client = AsyncRawAssembliesClient(client_wrapper=client_wrapper)
+
+    @property
+    def with_raw_response(self) -> AsyncRawAssembliesClient:
+        """
+        Retrieves a raw implementation of this client that returns raw responses.
+
+        Returns
+        -------
+        AsyncRawAssembliesClient
+        """
+        return self._raw_client
+
+    async def upload(
+        self, *, file: typing.Optional[core.File] = OMIT, request_options: typing.Optional[RequestOptions] = None
+    ) -> UploadResponse:
+        """
+        Parameters
+        ----------
+        file : typing.Optional[core.File]
+            See core.File for more documentation
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        UploadResponse
+            Successful upload
+
+        Examples
+        --------
+        import asyncio
+
+        from autoassembler import AsyncAutoAssembler
+
+        client = AsyncAutoAssembler(
+            token="YOUR_TOKEN",
+        )
+
+
+        async def main() -> None:
+            await client.assemblies.upload()
+
+
+        asyncio.run(main())
+        """
+        _response = await self._raw_client.upload(file=file, request_options=request_options)
+        return _response.data
+
+    async def search(
+        self,
+        *,
+        offset: typing.Optional[int] = OMIT,
+        limit: typing.Optional[int] = OMIT,
+        filters: typing.Optional[typing.Sequence[Filter]] = OMIT,
+        sort: typing.Optional[Sort] = OMIT,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> SearchAssembliesResponse:
+        """
+        Parameters
+        ----------
+        offset : typing.Optional[int]
+
+        limit : typing.Optional[int]
+
+        filters : typing.Optional[typing.Sequence[Filter]]
+
+        sort : typing.Optional[Sort]
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        SearchAssembliesResponse
+            Search results
+
+        Examples
+        --------
+        import asyncio
+
+        from autoassembler import AsyncAutoAssembler
+
+        client = AsyncAutoAssembler(
+            token="YOUR_TOKEN",
+        )
+
+
+        async def main() -> None:
+            await client.assemblies.search()
+
+
+        asyncio.run(main())
+        """
+        _response = await self._raw_client.search(
+            offset=offset, limit=limit, filters=filters, sort=sort, request_options=request_options
+        )
+        return _response.data
+
+    async def diff(
+        self,
+        *,
+        reference_id: str,
+        target_id: str,
+        context_n_hops: typing.Optional[int] = OMIT,
+        async_: typing.Optional[bool] = OMIT,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> DiffReport:
+        """
+        Compares a baseline assembly (`referenceId`) with another assembly
+        revision (`targetId`) and returns a structured report describing what
+        changed.
+
+        Typical UI mapping:
+        - Use `summary` for aggregate counts and badges.
+        - Use `details.geomDiffNodes.reference` for parts present only in the baseline.
+        - Use `details.geomDiffNodes.target` for parts present only in the target.
+        - Use `details.movedPosePairs` for matching parts that changed position or orientation.
+        - Use `details.swaps` for likely replacements, swaps, or renamed parts.
+        - Treat `flags` as supporting metadata for explanations, filters, or diagnostics.
+
+        Set `async` to `true` to get `202` with the operation computing the diff
+        (AIP-151): poll `GET /api/v4/operations/{id}` until it is `done`, then fetch
+        `resultUrl` for the `DiffReport`.
+
+        **Deprecated:** calling without `async: true`, which blocks until the diff is
+        computed and answers `200` with the report, with a `Deprecation` header
+        (RFC 9745). Pass `async: true` and wait on the operation instead; a later
+        version will always answer `202`.
+
+        Parameters
+        ----------
+        reference_id : str
+            Baseline assembly ID.
+
+        target_id : str
+            Target assembly ID.
+
+        context_n_hops : typing.Optional[int]
+            Graph radius used to collect surviving parts that define each added, removed, or swapped part's liaison context.
+
+        async_ : typing.Optional[bool]
+            When true, queues the diff and returns 202 with the operation computing it. Omitting it (or `false`) is deprecated.
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        DiffReport
+            Deprecated: the diff report, when called without `async: true`. Pass `async: true` and wait on the operation instead.
+
+        Examples
+        --------
+        import asyncio
+
+        from autoassembler import AsyncAutoAssembler
+
+        client = AsyncAutoAssembler(
+            token="YOUR_TOKEN",
+        )
+
+
+        async def main() -> None:
+            await client.assemblies.diff(
+                reference_id="referenceId",
+                target_id="targetId",
+            )
+
+
+        asyncio.run(main())
+        """
+        _response = await self._raw_client.diff(
+            reference_id=reference_id,
+            target_id=target_id,
+            context_n_hops=context_n_hops,
+            async_=async_,
+            request_options=request_options,
+        )
+        return _response.data
+
+    async def delete_assembly(
+        self, id: str, *, request_options: typing.Optional[RequestOptions] = None
+    ) -> DeleteAssemblyResponse:
+        """
+        Parameters
+        ----------
+        id : str
+            Assembly ID.
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        DeleteAssemblyResponse
+            Assembly deleted successfully
+
+        Examples
+        --------
+        import asyncio
+
+        from autoassembler import AsyncAutoAssembler
+
+        client = AsyncAutoAssembler(
+            token="YOUR_TOKEN",
+        )
+
+
+        async def main() -> None:
+            await client.assemblies.delete_assembly(
+                id="id",
+            )
+
+
+        asyncio.run(main())
+        """
+        _response = await self._raw_client.delete_assembly(id, request_options=request_options)
+        return _response.data
+
+    async def process(
+        self,
+        namespace: ProcessRequestNamespace,
+        id: str,
+        *,
+        attributes: typing.Optional[typing.Dict[str, typing.Sequence[str]]] = OMIT,
+        force: typing.Optional[bool] = OMIT,
+        clear_cache: typing.Optional[bool] = OMIT,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> ProcessAssemblyResponse:
+        """
+        Parameters
+        ----------
+        namespace : ProcessRequestNamespace
+            Assembly URL namespace. `user`, `shared`, and `public` are routed through the same assembly lookup.
+
+        id : str
+            Assembly ID.
+
+        attributes : typing.Optional[typing.Dict[str, typing.Sequence[str]]]
+            Attribute patterns for marking occurrences during parsing. Keys are attribute names (e.g. `consolidated`); values are glob patterns.
+
+        force : typing.Optional[bool]
+            Force reprocessing even if already processed.
+
+        clear_cache : typing.Optional[bool]
+            Clear cached planning data for this assembly.
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        ProcessAssemblyResponse
+            Processing request accepted or skipped
+
+        Examples
+        --------
+        import asyncio
+
+        from autoassembler import AsyncAutoAssembler
+
+        client = AsyncAutoAssembler(
+            token="YOUR_TOKEN",
+        )
+
+
+        async def main() -> None:
+            await client.assemblies.process(
+                namespace="user",
+                id="id",
+            )
+
+
+        asyncio.run(main())
+        """
+        _response = await self._raw_client.process(
+            namespace, id, attributes=attributes, force=force, clear_cache=clear_cache, request_options=request_options
+        )
+        return _response.data
+
+    async def get_status(
+        self, namespace: GetStatusRequestNamespace, id: str, *, request_options: typing.Optional[RequestOptions] = None
+    ) -> GetStatusResponse:
+        """
+        Parameters
+        ----------
+        namespace : GetStatusRequestNamespace
+            Assembly URL namespace. `user`, `shared`, and `public` are routed through the same assembly lookup.
+
+        id : str
+            Assembly ID.
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        GetStatusResponse
+            Current processing status of the assembly
+
+        Examples
+        --------
+        import asyncio
+
+        from autoassembler import AsyncAutoAssembler
+
+        client = AsyncAutoAssembler(
+            token="YOUR_TOKEN",
+        )
+
+
+        async def main() -> None:
+            await client.assemblies.get_status(
+                namespace="user",
+                id="id",
+            )
+
+
+        asyncio.run(main())
+        """
+        _response = await self._raw_client.get_status(namespace, id, request_options=request_options)
+        return _response.data
+
+    async def get_structure(
+        self,
+        namespace: GetStructureRequestNamespace,
+        id: str,
+        *,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> AssemblyJsonResponse:
+        """
+        Parameters
+        ----------
+        namespace : GetStructureRequestNamespace
+            Assembly URL namespace. `user`, `shared`, and `public` are routed through the same assembly lookup.
+
+        id : str
+            Assembly ID.
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        AssemblyJsonResponse
+            Assembly metadata and structure.
+
+        Examples
+        --------
+        import asyncio
+
+        from autoassembler import AsyncAutoAssembler
+
+        client = AsyncAutoAssembler(
+            token="YOUR_TOKEN",
+        )
+
+
+        async def main() -> None:
+            await client.assemblies.get_structure(
+                namespace="user",
+                id="id",
+            )
+
+
+        asyncio.run(main())
+        """
+        _response = await self._raw_client.get_structure(namespace, id, request_options=request_options)
+        return _response.data
+
+    async def list_connections(
+        self,
+        namespace: ListConnectionsRequestNamespace,
+        id: str,
+        *,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> AssemblyConnectionsResponse:
+        """
+        Returns physical connections between occurrences. Each connection is a contact or interference relationship.
+
+        Parameters
+        ----------
+        namespace : ListConnectionsRequestNamespace
+            Assembly URL namespace. `user`, `shared`, and `public` are routed through the same assembly lookup.
+
+        id : str
+            Assembly ID.
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        AssemblyConnectionsResponse
+            Assembly connections.
+
+        Examples
+        --------
+        import asyncio
+
+        from autoassembler import AsyncAutoAssembler
+
+        client = AsyncAutoAssembler(
+            token="YOUR_TOKEN",
+        )
+
+
+        async def main() -> None:
+            await client.assemblies.list_connections(
+                namespace="user",
+                id="id",
+            )
+
+
+        asyncio.run(main())
+        """
+        _response = await self._raw_client.list_connections(namespace, id, request_options=request_options)
+        return _response.data
+
+    async def get_assembly_info(
+        self,
+        namespace: GetAssemblyInfoRequestNamespace,
+        id: str,
+        *,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> AssemblyInfo:
+        """
+        Parameters
+        ----------
+        namespace : GetAssemblyInfoRequestNamespace
+            Assembly URL namespace. `user`, `shared`, and `public` are routed through the same assembly lookup.
+
+        id : str
+            Assembly ID.
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        AssemblyInfo
+            Assembly metadata fields.
+
+        Examples
+        --------
+        import asyncio
+
+        from autoassembler import AsyncAutoAssembler
+
+        client = AsyncAutoAssembler(
+            token="YOUR_TOKEN",
+        )
+
+
+        async def main() -> None:
+            await client.assemblies.get_assembly_info(
+                namespace="user",
+                id="id",
+            )
+
+
+        asyncio.run(main())
+        """
+        _response = await self._raw_client.get_assembly_info(namespace, id, request_options=request_options)
+        return _response.data
+
+    async def update_assembly_info(
+        self,
+        namespace: UpdateAssemblyInfoRequestNamespace,
+        id: str,
+        *,
+        name: typing.Optional[str] = OMIT,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> Assembly:
+        """
+        Currently only `name` is writable.
+
+        Parameters
+        ----------
+        namespace : UpdateAssemblyInfoRequestNamespace
+            Assembly URL namespace. `user`, `shared`, and `public` are routed through the same assembly lookup.
+
+        id : str
+            Assembly ID.
+
+        name : typing.Optional[str]
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        Assembly
+            Updated assembly record.
+
+        Examples
+        --------
+        import asyncio
+
+        from autoassembler import AsyncAutoAssembler
+
+        client = AsyncAutoAssembler(
+            token="YOUR_TOKEN",
+        )
+
+
+        async def main() -> None:
+            await client.assemblies.update_assembly_info(
+                namespace="user",
+                id="id",
+            )
+
+
+        asyncio.run(main())
+        """
+        _response = await self._raw_client.update_assembly_info(
+            namespace, id, name=name, request_options=request_options
+        )
+        return _response.data
+
+    async def list_assembly_versions(
+        self,
+        namespace: ListAssemblyVersionsRequestNamespace,
+        id: str,
+        *,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> typing.List[AssemblyVersionSummary]:
+        """
+        Returns other assemblies that share this assembly's `externalId` (for example an Onshape document). Empty when `externalId` is unset.
+
+        Parameters
+        ----------
+        namespace : ListAssemblyVersionsRequestNamespace
+            Assembly URL namespace. `user`, `shared`, and `public` are routed through the same assembly lookup.
+
+        id : str
+            Assembly ID.
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        typing.List[AssemblyVersionSummary]
+            Version list.
+
+        Examples
+        --------
+        import asyncio
+
+        from autoassembler import AsyncAutoAssembler
+
+        client = AsyncAutoAssembler(
+            token="YOUR_TOKEN",
+        )
+
+
+        async def main() -> None:
+            await client.assemblies.list_assembly_versions(
+                namespace="user",
+                id="id",
+            )
+
+
+        asyncio.run(main())
+        """
+        _response = await self._raw_client.list_assembly_versions(namespace, id, request_options=request_options)
+        return _response.data
+
+    async def download_assembly_cad(
+        self,
+        namespace: DownloadAssemblyCadRequestNamespace,
+        id: str,
+        *,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> typing.AsyncIterator[bytes]:
+        """
+        Parameters
+        ----------
+        namespace : DownloadAssemblyCadRequestNamespace
+            Assembly URL namespace. `user`, `shared`, and `public` are routed through the same assembly lookup.
+
+        id : str
+            Assembly ID.
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration. You can pass in configuration such as `chunk_size`, and more to customize the request and response.
+
+        Returns
+        -------
+        typing.AsyncIterator[bytes]
+            CAD file bytes (attachment download).
+
+        Examples
+        --------
+        import asyncio
+
+        from autoassembler import AsyncAutoAssembler
+
+        client = AsyncAutoAssembler(
+            token="YOUR_TOKEN",
+        )
+
+
+        async def main() -> None:
+            await client.assemblies.download_assembly_cad(
+                namespace="user",
+                id="id",
+            )
+
+
+        asyncio.run(main())
+        """
+        async with self._raw_client.download_assembly_cad(namespace, id, request_options=request_options) as r:
+            async for _chunk in r.data:
+                yield _chunk