graphsense-python 2.11.0__tar.gz → 2.13.0__tar.gz

{graphsense_python-2.11.0 → graphsense_python-2.13.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: graphsense-python
-Version: 2.11.0
+Version: 2.13.0
 Summary: GraphSense API
 Author-email: Iknaio Cryptoasset Analytics GmbH <contact@iknaio.com>
 License-Expression: MIT
@@ -15,6 +15,10 @@ Requires-Dist: urllib3<3.0.0,>=2.1.0
 Requires-Dist: python-dateutil>=2.8.2
 Requires-Dist: pydantic>=2
 Requires-Dist: typing-extensions>=4.7.1
+Provides-Extra: cli
+Requires-Dist: rich-click>=1.7; extra == "cli"
+Requires-Dist: jmespath>=1.0; extra == "cli"
+Requires-Dist: pygments>=2.15; extra == "cli"
 
 # graphsense-python
 GraphSense API provides programmatic access to blockchain analytics data across
@@ -41,8 +45,8 @@ for details.
 
 This Python package is automatically generated by the [OpenAPI Generator](https://openapi-generator.tech) project:
 
-- API version: 2.11.0
-- Package version: 2.11.0
+- API version: 2.13.0
+- Package version: 2.13.0
 - Generator version: 7.19.0
 - Build package: org.openapitools.codegen.languages.PythonClientCodegen
 For more information, please visit [https://www.iknaio.com/](https://www.iknaio.com/)
@@ -52,37 +56,39 @@ For more information, please visit [https://www.iknaio.com/](https://www.iknaio.
 Python 3.9+
 
 ## Installation & Usage
-### pip install
 
-If the python package is hosted on a repository, you can install directly using:
+This project uses [uv](https://docs.astral.sh/uv/) for environment and
+dependency management.
+
+### Add to a uv project
 
 ```sh
-pip install git+https://github.com/GIT_USER_ID/GIT_REPO_ID.git
+uv add graphsense-python
+# or, to include the optional `[cli]` extra (installs the `graphsense` CLI):
+uv add 'graphsense-python[cli]'
 ```
-(you may need to run `pip` with root permission: `sudo pip install git+https://github.com/GIT_USER_ID/GIT_REPO_ID.git`)
 
-Then import the package:
-```python
-import graphsense
-```
+### Install from git
 
-### Setuptools
+```sh
+uv add 'git+https://github.com/GIT_USER_ID/GIT_REPO_ID.git'
+```
 
-Install via [Setuptools](http://pypi.python.org/pypi/setuptools).
+### One-off script usage
 
 ```sh
-python setup.py install --user
+uv run --with graphsense-python python my_script.py
 ```
-(or `sudo python setup.py install` to install the package for all users)
 
 Then import the package:
+
 ```python
 import graphsense
 ```
 
 ### Tests
 
-Execute `pytest` to run the tests.
+Execute `uv run pytest` to run the tests.
 
 ## Getting Started
 
@@ -137,6 +143,7 @@ All URIs are relative to *https://api.iknaio.com*
 Class | Method | HTTP request | Description
 ------------ | ------------- | ------------- | -------------
 *AddressesApi* | [**get_address**](docs/AddressesApi.md#get_address) | **GET** /{currency}/addresses/{address} | Get an address
+*AddressesApi* | [**get_address_cluster**](docs/AddressesApi.md#get_address_cluster) | **GET** /{currency}/addresses/{address}/cluster | Get the cluster for an address
 *AddressesApi* | [**get_address_entity**](docs/AddressesApi.md#get_address_entity) | **GET** /{currency}/addresses/{address}/entity | Get the entity for an address
 *AddressesApi* | [**get_tag_summary_by_address**](docs/AddressesApi.md#get_tag_summary_by_address) | **GET** /{currency}/addresses/{address}/tag_summary | Get address attribution tag summary
 *AddressesApi* | [**list_address_links**](docs/AddressesApi.md#list_address_links) | **GET** /{currency}/addresses/{address}/links | List transactions between two addresses
@@ -277,3 +284,11 @@ Authentication schemes defined for the API:
 contact@iknaio.com
 
 
+## Using the high-level wrapper or CLI
+
+- **Python** — [`README_EXT.md`](README_EXT.md) documents
+  `graphsense.ext.GraphSense`, a single facade that removes boilerplate and
+  bundles commonly-paired calls (ships with the base install).
+- **Shell** — [`README_CLI.md`](README_CLI.md) documents the `graphsense` CLI
+  (installed via `uv add 'graphsense-python[cli]'`): pipe-friendly,
+  JSON/CSV I/O, auto-bulk.

{graphsense_python-2.11.0 → graphsense_python-2.13.0}/README.md

@@ -23,8 +23,8 @@ for details.
 
 This Python package is automatically generated by the [OpenAPI Generator](https://openapi-generator.tech) project:
 
-- API version: 2.11.0
-- Package version: 2.11.0
+- API version: 2.13.0
+- Package version: 2.13.0
 - Generator version: 7.19.0
 - Build package: org.openapitools.codegen.languages.PythonClientCodegen
 For more information, please visit [https://www.iknaio.com/](https://www.iknaio.com/)
@@ -34,37 +34,39 @@ For more information, please visit [https://www.iknaio.com/](https://www.iknaio.
 Python 3.9+
 
 ## Installation & Usage
-### pip install
 
-If the python package is hosted on a repository, you can install directly using:
+This project uses [uv](https://docs.astral.sh/uv/) for environment and
+dependency management.
+
+### Add to a uv project
 
 ```sh
-pip install git+https://github.com/GIT_USER_ID/GIT_REPO_ID.git
+uv add graphsense-python
+# or, to include the optional `[cli]` extra (installs the `graphsense` CLI):
+uv add 'graphsense-python[cli]'
 ```
-(you may need to run `pip` with root permission: `sudo pip install git+https://github.com/GIT_USER_ID/GIT_REPO_ID.git`)
 
-Then import the package:
-```python
-import graphsense
-```
+### Install from git
 
-### Setuptools
+```sh
+uv add 'git+https://github.com/GIT_USER_ID/GIT_REPO_ID.git'
+```
 
-Install via [Setuptools](http://pypi.python.org/pypi/setuptools).
+### One-off script usage
 
 ```sh
-python setup.py install --user
+uv run --with graphsense-python python my_script.py
 ```
-(or `sudo python setup.py install` to install the package for all users)
 
 Then import the package:
+
 ```python
 import graphsense
 ```
 
 ### Tests
 
-Execute `pytest` to run the tests.
+Execute `uv run pytest` to run the tests.
 
 ## Getting Started
 
@@ -119,6 +121,7 @@ All URIs are relative to *https://api.iknaio.com*
 Class | Method | HTTP request | Description
 ------------ | ------------- | ------------- | -------------
 *AddressesApi* | [**get_address**](docs/AddressesApi.md#get_address) | **GET** /{currency}/addresses/{address} | Get an address
+*AddressesApi* | [**get_address_cluster**](docs/AddressesApi.md#get_address_cluster) | **GET** /{currency}/addresses/{address}/cluster | Get the cluster for an address
 *AddressesApi* | [**get_address_entity**](docs/AddressesApi.md#get_address_entity) | **GET** /{currency}/addresses/{address}/entity | Get the entity for an address
 *AddressesApi* | [**get_tag_summary_by_address**](docs/AddressesApi.md#get_tag_summary_by_address) | **GET** /{currency}/addresses/{address}/tag_summary | Get address attribution tag summary
 *AddressesApi* | [**list_address_links**](docs/AddressesApi.md#list_address_links) | **GET** /{currency}/addresses/{address}/links | List transactions between two addresses
@@ -259,3 +262,11 @@ Authentication schemes defined for the API:
 contact@iknaio.com
 
 
+## Using the high-level wrapper or CLI
+
+- **Python** — [`README_EXT.md`](README_EXT.md) documents
+  `graphsense.ext.GraphSense`, a single facade that removes boilerplate and
+  bundles commonly-paired calls (ships with the base install).
+- **Shell** — [`README_CLI.md`](README_CLI.md) documents the `graphsense` CLI
+  (installed via `uv add 'graphsense-python[cli]'`): pipe-friendly,
+  JSON/CSV I/O, auto-bulk.

{graphsense_python-2.11.0 → graphsense_python-2.13.0}/graphsense/__init__.py

@@ -12,7 +12,7 @@
 """
 
 
-__version__ = "2.11.0"
+__version__ = "2.13.0"
 
 # Define package exports
 __all__ = [

{graphsense_python-2.11.0 → graphsense_python-2.13.0}/graphsense/api/addresses_api.py

@@ -20,6 +20,7 @@ from typing_extensions import Annotated
 from graphsense.models.address import Address
 from graphsense.models.address_tags import AddressTags
 from graphsense.models.address_txs import AddressTxs
+from graphsense.models.cluster import Cluster
 from graphsense.models.entity import Entity
 from graphsense.models.links import Links
 from graphsense.models.neighbor_addresses import NeighborAddresses
@@ -433,6 +434,305 @@ class AddressesApi:
 
 
 
+    @validate_call_compat
+    def get_address_cluster(
+        self,
+        currency: Annotated[StrictStr, Field(description="The cryptocurrency code (e.g., btc)")],
+        address: Annotated[StrictStr, Field(description="The cryptocurrency address")],
+        include_actors: Annotated[Optional[StrictBool], Field(description="Whether to include actor information")] = None,
+        _request_timeout: Union[
+            None,
+            Annotated[StrictFloat, Field(gt=0)],
+            Tuple[
+                Annotated[StrictFloat, Field(gt=0)],
+                Annotated[StrictFloat, Field(gt=0)]
+            ]
+        ] = None,
+        _request_auth: Optional[Dict[StrictStr, Any]] = None,
+        _content_type: Optional[StrictStr] = None,
+        _headers: Optional[Dict[StrictStr, Any]] = None,
+        _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
+    ) -> Cluster:
+        """Get the cluster for an address
+
+        Returns the address cluster that contains the given address.
+
+        :param currency: The cryptocurrency code (e.g., btc) (required)
+        :type currency: str
+        :param address: The cryptocurrency address (required)
+        :type address: str
+        :param include_actors: Whether to include actor information
+        :type include_actors: bool
+        :param _request_timeout: timeout setting for this request. If one
+                                 number provided, it will be total request
+                                 timeout. It can also be a pair (tuple) of
+                                 (connection, read) timeouts.
+        :type _request_timeout: int, tuple(int, int), optional
+        :param _request_auth: set to override the auth_settings for an a single
+                              request; this effectively ignores the
+                              authentication in the spec for a single request.
+        :type _request_auth: dict, optional
+        :param _content_type: force content-type for the request.
+        :type _content_type: str, Optional
+        :param _headers: set to override the headers for a single
+                         request; this effectively ignores the headers
+                         in the spec for a single request.
+        :type _headers: dict, optional
+        :param _host_index: set to override the host_index for a single
+                            request; this effectively ignores the host_index
+                            in the spec for a single request.
+        :type _host_index: int, optional
+        :return: Returns the result object.
+        """ # noqa: E501
+
+        _param = self._get_address_cluster_serialize(
+            currency=currency,
+            address=address,
+            include_actors=include_actors,
+            _request_auth=_request_auth,
+            _content_type=_content_type,
+            _headers=_headers,
+            _host_index=_host_index
+        )
+
+        _response_types_map: Dict[str, Optional[str]] = {
+            '200': "Cluster",
+            '404': None,
+            '422': "HTTPValidationError",
+        }
+        response_data = self.api_client.call_api(
+            *_param,
+            _request_timeout=_request_timeout
+        )
+        response_data.read()
+        return self.api_client.response_deserialize(
+            response_data=response_data,
+            response_types_map=_response_types_map,
+        ).data
+
+
+    @validate_call_compat
+    def get_address_cluster_with_http_info(
+        self,
+        currency: Annotated[StrictStr, Field(description="The cryptocurrency code (e.g., btc)")],
+        address: Annotated[StrictStr, Field(description="The cryptocurrency address")],
+        include_actors: Annotated[Optional[StrictBool], Field(description="Whether to include actor information")] = None,
+        _request_timeout: Union[
+            None,
+            Annotated[StrictFloat, Field(gt=0)],
+            Tuple[
+                Annotated[StrictFloat, Field(gt=0)],
+                Annotated[StrictFloat, Field(gt=0)]
+            ]
+        ] = None,
+        _request_auth: Optional[Dict[StrictStr, Any]] = None,
+        _content_type: Optional[StrictStr] = None,
+        _headers: Optional[Dict[StrictStr, Any]] = None,
+        _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
+    ) -> ApiResponse[Cluster]:
+        """Get the cluster for an address
+
+        Returns the address cluster that contains the given address.
+
+        :param currency: The cryptocurrency code (e.g., btc) (required)
+        :type currency: str
+        :param address: The cryptocurrency address (required)
+        :type address: str
+        :param include_actors: Whether to include actor information
+        :type include_actors: bool
+        :param _request_timeout: timeout setting for this request. If one
+                                 number provided, it will be total request
+                                 timeout. It can also be a pair (tuple) of
+                                 (connection, read) timeouts.
+        :type _request_timeout: int, tuple(int, int), optional
+        :param _request_auth: set to override the auth_settings for an a single
+                              request; this effectively ignores the
+                              authentication in the spec for a single request.
+        :type _request_auth: dict, optional
+        :param _content_type: force content-type for the request.
+        :type _content_type: str, Optional
+        :param _headers: set to override the headers for a single
+                         request; this effectively ignores the headers
+                         in the spec for a single request.
+        :type _headers: dict, optional
+        :param _host_index: set to override the host_index for a single
+                            request; this effectively ignores the host_index
+                            in the spec for a single request.
+        :type _host_index: int, optional
+        :return: Returns the result object.
+        """ # noqa: E501
+
+        _param = self._get_address_cluster_serialize(
+            currency=currency,
+            address=address,
+            include_actors=include_actors,
+            _request_auth=_request_auth,
+            _content_type=_content_type,
+            _headers=_headers,
+            _host_index=_host_index
+        )
+
+        _response_types_map: Dict[str, Optional[str]] = {
+            '200': "Cluster",
+            '404': None,
+            '422': "HTTPValidationError",
+        }
+        response_data = self.api_client.call_api(
+            *_param,
+            _request_timeout=_request_timeout
+        )
+        response_data.read()
+        return self.api_client.response_deserialize(
+            response_data=response_data,
+            response_types_map=_response_types_map,
+        )
+
+
+    @validate_call_compat
+    def get_address_cluster_without_preload_content(
+        self,
+        currency: Annotated[StrictStr, Field(description="The cryptocurrency code (e.g., btc)")],
+        address: Annotated[StrictStr, Field(description="The cryptocurrency address")],
+        include_actors: Annotated[Optional[StrictBool], Field(description="Whether to include actor information")] = None,
+        _request_timeout: Union[
+            None,
+            Annotated[StrictFloat, Field(gt=0)],
+            Tuple[
+                Annotated[StrictFloat, Field(gt=0)],
+                Annotated[StrictFloat, Field(gt=0)]
+            ]
+        ] = None,
+        _request_auth: Optional[Dict[StrictStr, Any]] = None,
+        _content_type: Optional[StrictStr] = None,
+        _headers: Optional[Dict[StrictStr, Any]] = None,
+        _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
+    ) -> RESTResponseType:
+        """Get the cluster for an address
+
+        Returns the address cluster that contains the given address.
+
+        :param currency: The cryptocurrency code (e.g., btc) (required)
+        :type currency: str
+        :param address: The cryptocurrency address (required)
+        :type address: str
+        :param include_actors: Whether to include actor information
+        :type include_actors: bool
+        :param _request_timeout: timeout setting for this request. If one
+                                 number provided, it will be total request
+                                 timeout. It can also be a pair (tuple) of
+                                 (connection, read) timeouts.
+        :type _request_timeout: int, tuple(int, int), optional
+        :param _request_auth: set to override the auth_settings for an a single
+                              request; this effectively ignores the
+                              authentication in the spec for a single request.
+        :type _request_auth: dict, optional
+        :param _content_type: force content-type for the request.
+        :type _content_type: str, Optional
+        :param _headers: set to override the headers for a single
+                         request; this effectively ignores the headers
+                         in the spec for a single request.
+        :type _headers: dict, optional
+        :param _host_index: set to override the host_index for a single
+                            request; this effectively ignores the host_index
+                            in the spec for a single request.
+        :type _host_index: int, optional
+        :return: Returns the result object.
+        """ # noqa: E501
+
+        _param = self._get_address_cluster_serialize(
+            currency=currency,
+            address=address,
+            include_actors=include_actors,
+            _request_auth=_request_auth,
+            _content_type=_content_type,
+            _headers=_headers,
+            _host_index=_host_index
+        )
+
+        _response_types_map: Dict[str, Optional[str]] = {
+            '200': "Cluster",
+            '404': None,
+            '422': "HTTPValidationError",
+        }
+        response_data = self.api_client.call_api(
+            *_param,
+            _request_timeout=_request_timeout
+        )
+        return response_data.response
+
+
+    def _get_address_cluster_serialize(
+        self,
+        currency,
+        address,
+        include_actors,
+        _request_auth,
+        _content_type,
+        _headers,
+        _host_index,
+    ) -> RequestSerialized:
+
+        _host = None
+
+        _collection_formats: Dict[str, str] = {
+        }
+
+        _path_params: Dict[str, str] = {}
+        _query_params: List[Tuple[str, str]] = []
+        _header_params: Dict[str, Optional[str]] = _headers or {}
+        _form_params: List[Tuple[str, str]] = []
+        _files: Dict[
+            str, Union[str, bytes, List[str], List[bytes], List[Tuple[str, bytes]]]
+        ] = {}
+        _body_params: Optional[bytes] = None
+
+        # process the path parameters
+        if currency is not None:
+            _path_params['currency'] = currency
+        if address is not None:
+            _path_params['address'] = address
+        # process the query parameters
+        if include_actors is not None:
+            
+            _query_params.append(('include_actors', include_actors))
+            
+        # process the header parameters
+        # process the form parameters
+        # process the body parameter
+
+
+        # set the HTTP header `Accept`
+        if 'Accept' not in _header_params:
+            _header_params['Accept'] = self.api_client.select_header_accept(
+                [
+                    'application/json'
+                ]
+            )
+
+
+        # authentication setting
+        _auth_settings: List[str] = [
+            'api_key'
+        ]
+
+        return self.api_client.param_serialize(
+            method='GET',
+            resource_path='/{currency}/addresses/{address}/cluster',
+            path_params=_path_params,
+            query_params=_query_params,
+            header_params=_header_params,
+            body=_body_params,
+            post_params=_form_params,
+            files=_files,
+            auth_settings=_auth_settings,
+            collection_formats=_collection_formats,
+            _host=_host,
+            _request_auth=_request_auth
+        )
+
+
+
+
     @validate_call_compat
     def get_address_entity(
         self,
@@ -452,9 +752,9 @@ class AddressesApi:
         _headers: Optional[Dict[StrictStr, Any]] = None,
         _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
     ) -> Entity:
-        """Get the entity for an address
+        """(Deprecated) Get the entity for an address
 
-        Returns the clustered entity that contains the given address.
+        Deprecated alias for `GET /{currency}/addresses/{address}/cluster`. Returns the address cluster that contains the given address.
 
         :param currency: The cryptocurrency code (e.g., btc) (required)
         :type currency: str
@@ -483,6 +783,7 @@ class AddressesApi:
         :type _host_index: int, optional
         :return: Returns the result object.
         """ # noqa: E501
+        warnings.warn("GET /{currency}/addresses/{address}/entity is deprecated.", DeprecationWarning)
 
         _param = self._get_address_entity_serialize(
             currency=currency,
@@ -529,9 +830,9 @@ class AddressesApi:
         _headers: Optional[Dict[StrictStr, Any]] = None,
         _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
     ) -> ApiResponse[Entity]:
-        """Get the entity for an address
+        """(Deprecated) Get the entity for an address
 
-        Returns the clustered entity that contains the given address.
+        Deprecated alias for `GET /{currency}/addresses/{address}/cluster`. Returns the address cluster that contains the given address.
 
         :param currency: The cryptocurrency code (e.g., btc) (required)
         :type currency: str
@@ -560,6 +861,7 @@ class AddressesApi:
         :type _host_index: int, optional
         :return: Returns the result object.
         """ # noqa: E501
+        warnings.warn("GET /{currency}/addresses/{address}/entity is deprecated.", DeprecationWarning)
 
         _param = self._get_address_entity_serialize(
             currency=currency,
@@ -606,9 +908,9 @@ class AddressesApi:
         _headers: Optional[Dict[StrictStr, Any]] = None,
         _host_index: Annotated[StrictInt, Field(ge=0, le=0)] = 0,
     ) -> RESTResponseType:
-        """Get the entity for an address
+        """(Deprecated) Get the entity for an address
 
-        Returns the clustered entity that contains the given address.
+        Deprecated alias for `GET /{currency}/addresses/{address}/cluster`. Returns the address cluster that contains the given address.
 
         :param currency: The cryptocurrency code (e.g., btc) (required)
         :type currency: str
@@ -637,6 +939,7 @@ class AddressesApi:
         :type _host_index: int, optional
         :return: Returns the result object.
         """ # noqa: E501
+        warnings.warn("GET /{currency}/addresses/{address}/entity is deprecated.", DeprecationWarning)
 
         _param = self._get_address_entity_serialize(
             currency=currency,

{graphsense_python-2.11.0 → graphsense_python-2.13.0}/graphsense/api_client.py

@@ -95,7 +95,7 @@ class ApiClient:
             self.default_headers[header_name] = header_value
         self.cookie = cookie
         # Set default User-Agent.
-        self.user_agent = 'OpenAPI-Generator/2.11.0/python'
+        self.user_agent = 'OpenAPI-Generator/2.13.0/python'
         self.client_side_validation = configuration.client_side_validation
 
     def __enter__(self):

graphsense_python-2.13.0/graphsense/cli/__init__.py

@@ -0,0 +1 @@
+"""graphsense CLI — requires the [cli] extra (`pip install graphsense-python[cli]`)."""

graphsense_python-2.13.0/graphsense/cli/__main__.py

@@ -0,0 +1,4 @@
+from graphsense.cli.main import cli
+
+if __name__ == "__main__":
+    cli()

graphsense_python-2.13.0/graphsense/cli/bulk_cmd.py

@@ -0,0 +1,95 @@
+"""`graphsense bulk <operation>` — direct access to /bulk.json / /bulk.csv."""
+
+from __future__ import annotations
+
+from typing import Optional
+
+import rich_click as click
+
+from graphsense.cli.context import CliContext
+from graphsense.ext import io as io_mod
+from graphsense.ext import output as out_mod
+
+pass_ctx = click.make_pass_decorator(CliContext)
+
+
+@click.command(name="bulk")
+@click.argument("operation")
+@click.argument("currency")
+@click.argument("keys", nargs=-1)
+@click.option(
+    "--key-field",
+    default="address",
+    help="Field name the bulk operation expects (address, tx_hash, cluster, ...).",
+)
+@click.option("--num-pages", type=int, default=1)
+@pass_ctx
+def bulk_command(
+    ctx: CliContext,
+    operation: str,
+    currency: str,
+    keys: tuple[str, ...],
+    key_field: str,
+    num_pages: int,
+) -> None:
+    """Call /bulk.json/<operation> or /bulk.csv/<operation> for a list of keys.
+
+    Keys come from positionals, --input, or stdin (JSON/CSV/lines, with
+    --address-jq / --address-col).
+    Output format follows --format (default json).
+    """
+    ids = _collect_keys(ctx, keys)
+    if not ids:
+        raise click.UsageError("no keys provided for bulk")
+
+    fmt = (ctx.format or "json").lower()
+    gs = ctx.gs()
+    result = gs.bulk(
+        operation,
+        ids,
+        currency=currency,
+        format="csv" if fmt == "csv" else "json",
+        num_pages=num_pages,
+        key_field=key_field,
+    )
+
+    if fmt == "csv":
+        _write_raw(ctx, result)
+    else:
+        out_mod.write(
+            result,
+            output=ctx.output,
+            directory=ctx.directory,
+            format=ctx.format,
+            color=ctx.color,
+        )
+
+
+def _collect_keys(ctx: CliContext, positional: tuple[str, ...]) -> list[str]:
+    if positional:
+        return list(positional)
+    text = ctx.read_input_text()
+    if text is None:
+        return []
+    return io_mod.parse_input(
+        text,
+        input_format=ctx.input_format,
+        jq=ctx.address_jq,
+        col=ctx.address_col,
+    )
+
+
+def _write_raw(ctx: CliContext, payload) -> None:
+    """For CSV bulk output, the server already returns flat rows; pass through."""
+    text: Optional[str]
+    if isinstance(payload, (bytes, bytearray)):
+        text = payload.decode("utf-8")
+    elif isinstance(payload, str):
+        text = payload
+    else:
+        # Some generated clients deserialize the CSV as {"value": "...raw..."}
+        text = str(payload)
+    with out_mod.open_out(ctx.output) as fh:
+        fh.write(text)
+        if not text.endswith("\n"):
+            fh.write("\n")