asana-api-cli 3.2.0__tar.gz → 3.3.0__tar.gz

{asana_api_cli-3.2.0/src/asana_api_cli.egg-info → asana_api_cli-3.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: asana-api-cli
-Version: 3.2.0
+Version: 3.3.0
 Summary: Command-line wrapper around the official Asana Python SDK
 Author: Masanao Izumo
 License-Expression: MIT
@@ -135,7 +135,9 @@ automatically.
 
 The token can be issued from the
 [Asana Developer Console](https://app.asana.com/0/developer-console).
-No token is needed for `--help` or argument validation errors.
+No token is needed for `--help` or command-line parsing errors. (A `--query`
+jq filter is validated against the response, so it surfaces errors only after
+the API call — which does need a token.)
 
 ```bash
 export ASANA_ACCESS_TOKEN="2/12345..."

{asana_api_cli-3.2.0 → asana_api_cli-3.3.0}/README.md

@@ -107,7 +107,9 @@ automatically.
 
 The token can be issued from the
 [Asana Developer Console](https://app.asana.com/0/developer-console).
-No token is needed for `--help` or argument validation errors.
+No token is needed for `--help` or command-line parsing errors. (A `--query`
+jq filter is validated against the response, so it surfaces errors only after
+the API call — which does need a token.)
 
 ```bash
 export ASANA_ACCESS_TOKEN="2/12345..."

{asana_api_cli-3.2.0 → asana_api_cli-3.3.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "asana-api-cli"
-version = "3.2.0"
+version = "3.3.0"
 description = "Command-line wrapper around the official Asana Python SDK"
 authors = [{name = "Masanao Izumo"}]
 readme = "README.md"

{asana_api_cli-3.2.0 → asana_api_cli-3.3.0}/src/asana_api_cli/cli.py

@@ -224,6 +224,7 @@ def _humanize_class_name(name: str) -> str:
 # a release blocker.
 _GROUP_DESCRIPTIONS: dict[str, str] = {
     "AccessRequests": "Manage private-object access requests",
+    "Agents": "Read workspace AI agents (AI Teammates)",
     "Allocations": "Manage user allocations across projects",
     "Attachments": "Upload, list, and remove file attachments",
     "AuditLogAPI": "Read domain audit log events",
@@ -238,6 +239,7 @@ _GROUP_DESCRIPTIONS: dict[str, str] = {
     "Goals": "Manage organizational goals and metrics",
     "Jobs": "Check status of async background jobs",
     "Memberships": "Manage memberships across object types",
+    "OooEntries": "Manage out-of-office (OOO) entries",
     "OrganizationExports": "Trigger and download org-wide exports",
     "PortfolioMemberships": "Read who has access to portfolios",
     "Portfolios": "Manage portfolios (project collections)",
@@ -1383,6 +1385,16 @@ def introspect_to_manifest() -> dict[str, Any]:
                     "positional": list(op.positional),
                     "has_opts": op.has_opts,
                     "paginatable": op.paginatable,
+                    # ``returns_iterator`` (array response → lazy iterator) and
+                    # ``does_upload`` (multipart file upload) pin the two runtime
+                    # classifiers that gate pagination materialization and the
+                    # ``--multibyte-filenames`` flag. Captured here so an SDK bump
+                    # that adds/removes such an endpoint surfaces in this fixture's
+                    # diff (the regen step), instead of in a hand-maintained set.
+                    # ``test_sdk_boilerplate.py`` still proves each classifier
+                    # matches the SDK source on the installed version.
+                    "returns_iterator": op.returns_iterator,
+                    "does_upload": op.does_upload,
                     "params": [
                         {
                             "name": p.name,

{asana_api_cli-3.2.0 → asana_api_cli-3.3.0}/src/asana_api_cli/click_ext.py

@@ -45,7 +45,7 @@ from asana_api_cli.structured_arg import (
 # code path is naturally dead when the flag is hidden. We instantiate
 # ``Configuration()`` because ``retry_strategy`` is an instance attribute
 # set in ``__init__`` — checking ``hasattr`` on the class itself returns
-# False even on 5.2.4.
+# False even on 5.2.5.
 _SDK_HAS_RETRY_STRATEGY: bool = hasattr(asana.Configuration(), "retry_strategy")
 
 
@@ -342,12 +342,22 @@ def _apply_global_to_runtime(name: str, value: Any) -> None:
     option declarations and the dataclass fields are authored together, and the
     inventory tests in ``test_click_ext.py`` (``TestGlobalOptionNamesInventory``)
     pin the ``GLOBAL_OPTION_NAMES`` set against ``_Runtime``'s fields — so a
-    direct ``setattr`` suffices. Every option, ``access_token`` included,
-    follows the same last-wins rule: the command-line value from the deepest
-    level reached overwrites whatever an earlier level wrote. An explicit empty
-    ``--access-token`` therefore clears a value set earlier, and
+    direct ``setattr`` suffices. Every *scalar* option, ``access_token``
+    included, follows the same last-wins rule: the command-line value from the
+    deepest level reached overwrites whatever an earlier level wrote. An
+    explicit empty ``--access-token`` therefore clears a value set earlier, and
     ``AsanaSession.from_env`` then falls back to ``$ASANA_ACCESS_TOKEN``.
 
+    ``default_headers`` is the one exception, because ``--set-default-header`` is
+    the only repeatable (accumulative) global: ``multiple=True`` already merges
+    every occurrence *at one level* into a single dict, so to honor "the later
+    occurrence wins when repeated" (``usage.md``) across levels too, values from
+    different levels are merged per-header rather than replaced wholesale. A
+    header set on the root group thus survives another ``--set-default-header``
+    given at the leaf, and a deeper level's value wins on a key collision. The
+    callback (:func:`structured_arg.default_header_callback`) yields ``None``
+    when the flag is absent, so only non-empty dicts ever reach this branch.
+
     The caller, :func:`_consume_global_options`, only ever passes names drawn
     from ``GLOBAL_OPTION_NAMES`` and only when the parameter source is
     ``ParameterSource.COMMANDLINE``. This is the single application path for
@@ -356,6 +366,9 @@ def _apply_global_to_runtime(name: str, value: Any) -> None:
     tri-state toggles' (``verify_ssl`` / ``assert_hostname`` /
     ``return_page_iterator``) ``None`` default never reaches here.
     """
+    if name == "default_headers":
+        runtime.default_headers = {**(runtime.default_headers or {}), **value}
+        return
     setattr(runtime, name, value)
 
 

{asana_api_cli-3.2.0 → asana_api_cli-3.3.0}/src/asana_api_cli/multibyte_filename.py

@@ -16,7 +16,7 @@ from urllib3.fields import RequestField
 class MultibyteFilenameSupport:
     """Make multipart uploads round-trip filenames with non-ASCII characters.
 
-    In ``python-asana`` 5.2.4 (the latest version checked, and likely later
+    In ``python-asana`` 5.2.5 (the latest version checked, and likely later
     ones too), uploading a file whose name has characters outside ASCII
     stores a garbled (mojibake) name on Asana: the SDK's multipart encoder
     emits only ``filename="..."`` and omits the RFC 5987 ``filename*=``

{asana_api_cli-3.2.0 → asana_api_cli-3.3.0/src/asana_api_cli.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: asana-api-cli
-Version: 3.2.0
+Version: 3.3.0
 Summary: Command-line wrapper around the official Asana Python SDK
 Author: Masanao Izumo
 License-Expression: MIT
@@ -135,7 +135,9 @@ automatically.
 
 The token can be issued from the
 [Asana Developer Console](https://app.asana.com/0/developer-console).
-No token is needed for `--help` or argument validation errors.
+No token is needed for `--help` or command-line parsing errors. (A `--query`
+jq filter is validated against the response, so it surfaces errors only after
+the API call — which does need a token.)
 
 ```bash
 export ASANA_ACCESS_TOKEN="2/12345..."

{asana_api_cli-3.2.0 → asana_api_cli-3.3.0}/tests/test_cli_surface.py

@@ -34,7 +34,7 @@ FIXTURE = Path(__file__).parent / "fixtures" / "cli_surface.json"
 # to diverge. Skip the snapshot tests when the SDK doesn't match rather
 # than failing — the surface drift on older / newer SDKs is informational,
 # not a regression to gate against.
-_SNAPSHOT_ASANA_VERSION = "5.2.4"
+_SNAPSHOT_ASANA_VERSION = "5.2.5"
 _INSTALLED_ASANA_VERSION = version("asana")
 
 pytestmark = pytest.mark.skipif(

{asana_api_cli-3.2.0 → asana_api_cli-3.3.0}/tests/test_click_ext.py

@@ -68,6 +68,35 @@ def _build_cli() -> click.Group:
     return root
 
 
+def _build_cli_echoing_default_headers() -> click.Group:
+    """A 3-level CLI (root → sub → leaf) like :func:`_build_cli` whose leaf echoes
+    the accumulated ``runtime.default_headers``.
+
+    Used to drive the *real* ``--set-default-header`` global through Click
+    parsing at more than one level, so ``_consume_global_options`` and
+    ``_apply_global_to_runtime`` are exercised end-to-end (not called by hand)
+    and the test stays pinned to the option's actual dest.
+    """
+
+    @click.group(cls=GroupWithGlobalOptions)
+    def root() -> None:
+        pass
+
+    @root.group("sub", cls=GroupWithGlobalOptions)
+    def sub() -> None:
+        pass
+
+    @sub.command("act")
+    def act() -> None:
+        h = runtime.default_headers
+        if h is None:
+            click.echo("HEADERS=NONE")
+        else:
+            click.echo("HEADERS=" + "|".join(f"{k}={v}" for k, v in sorted(h.items())))
+
+    return root
+
+
 class TestGlobalOptionsAtAnyLevel:
     def test_debug_on_leaf_command(self) -> None:
         result = make_runner().invoke(_build_cli(), ["tasks", "act", "--debug"])
@@ -225,10 +254,12 @@ class TestGlobalOptionNamesInventory:
 
         # Reverse direction: every global option name must be an actual
         # ``_Runtime`` field. ``_apply_global_to_runtime`` applies values with a
-        # bare ``setattr(runtime, name, value)``; ``_Runtime`` is neither frozen
-        # nor slotted, so a name without a matching field would silently create
-        # a stray attribute (a no-op option) rather than erroring. Pinning the
-        # 1:1 here is what lets that ``setattr`` skip name validation.
+        # bare ``setattr(runtime, name, value)`` (``default_headers`` is the one
+        # exception: it merges into the existing dict, but still writes that same
+        # field); ``_Runtime`` is neither frozen nor slotted, so a name without a
+        # matching field would silently create a stray attribute (a no-op option)
+        # rather than erroring. Pinning the 1:1 here is what lets that ``setattr``
+        # skip name validation.
         runtime_fields = frozenset(f.name for f in dataclasses.fields(_Runtime))
         for name in GLOBAL_OPTION_NAMES:
             assert name in runtime_fields, (
@@ -327,6 +358,58 @@ class TestGlobalOptionsSingleSource:
         )
 
 
+class TestDefaultHeadersMergeAcrossLevels:
+    """``--set-default-header`` is the only repeatable (accumulative) global, so
+    unlike the scalar globals — which are last-wins, see
+    ``TestGlobalOptionsAtAnyLevel.test_leaf_overrides_root`` — headers given at
+    different points in the command path must *merge* per-header rather than the
+    inner level's dict replacing the outer one wholesale.
+
+    Driven through a real ``GroupWithGlobalOptions`` tree, so Click parsing,
+    ``_consume_global_options`` and ``_apply_global_to_runtime`` all run end to
+    end and the assertions track the option's real dest."""
+
+    def test_headers_from_different_levels_merge(self) -> None:
+        result = make_runner().invoke(
+            _build_cli_echoing_default_headers(),
+            [
+                "--set-default-header",
+                "X-Root=root",
+                "--set-default-header",
+                "X-Shared=root",
+                "sub",
+                "act",
+                "--set-default-header",
+                "X-Leaf=leaf",
+                "--set-default-header",
+                "X-Shared=leaf",
+            ],
+        )
+        assert result.exit_code == 0, full_output(result)
+        # X-Root (outer) survives; the X-Shared collision resolves to the deeper
+        # (leaf) value; keys are echoed sorted.
+        assert "HEADERS=X-Leaf=leaf|X-Root=root|X-Shared=leaf" in full_output(result)
+
+    def test_outer_header_not_clobbered_when_inner_omits_flag(self) -> None:
+        """A header set at an outer level must persist when an inner level is
+        reached without its own ``--set-default-header`` (the inner level's
+        DEFAULT-sourced empty value is skipped, so nothing overwrites it)."""
+        result = make_runner().invoke(
+            _build_cli_echoing_default_headers(),
+            ["--set-default-header", "X-Root=root", "sub", "act"],
+        )
+        assert result.exit_code == 0, full_output(result)
+        assert "HEADERS=X-Root=root" in full_output(result)
+
+    def test_no_header_flag_leaves_runtime_unset(self) -> None:
+        """With the flag absent everywhere, the merge branch is never entered:
+        ``runtime.default_headers`` stays at its ``None`` unset sentinel rather
+        than becoming a stray empty dict."""
+        result = make_runner().invoke(_build_cli_echoing_default_headers(), ["sub", "act"])
+        assert result.exit_code == 0, full_output(result)
+        assert "HEADERS=NONE" in full_output(result)
+
+
 def _bash_complete(cmd: click.Command, args: list[str]) -> list[str]:
     """Drive click's bash completion machinery and return the suggested values."""
     from click.shell_completion import ShellComplete

{asana_api_cli-3.2.0 → asana_api_cli-3.3.0}/tests/test_generate_python_snapshots.py

@@ -35,7 +35,7 @@ from asana_api_cli.cli import main
 FIXTURES = Path(__file__).parent / "fixtures" / "generate_python"
 _UPDATE = os.environ.get("UPDATE_GENERATE_SNAPSHOTS") == "1"
 
-_SNAPSHOT_ASANA_VERSION = "5.2.4"
+_SNAPSHOT_ASANA_VERSION = "5.2.5"
 pytestmark = pytest.mark.skipif(
     version("asana") != _SNAPSHOT_ASANA_VERSION,
     reason=(

{asana_api_cli-3.2.0 → asana_api_cli-3.3.0}/tests/test_sdk_boilerplate.py

@@ -19,13 +19,27 @@ bump fails loudly and forces a conscious classification — a global flag
 (Configuration) or a common per-command ``(kwargs: ...)`` option, with the
 matching SDK-destination label (see ``docs/cli-sdk-mapping.md``).
 
-A third guard pins which methods perform a multipart file upload. The CLI
-exposes the ``--multibyte-filenames`` extension flag only on upload commands,
-detected at runtime by a cheap proxy (an op declaring a ``file`` opt — see
-``_Operation.does_upload``). ``test_upload_detection_matches_multipart_population``
-proves that proxy equals the true signal (a source scan for assignment into
-``local_var_files``), so a future SDK that adds or renames an upload endpoint
-fails here rather than silently dropping the flag from a command that needs it.
+Two further guards prove the CLI's runtime *classifiers* still agree with the
+SDK source on the installed version — each derives both sides from the SDK, so
+neither needs maintenance across a bump:
+
+* ``test_upload_detection_matches_multipart_population`` — the
+  ``--multibyte-filenames`` flag is exposed only on upload commands, detected by
+  a cheap proxy (an op declaring a ``file`` opt — see ``_Operation.does_upload``).
+  The test proves that proxy equals the true signal (a source scan for assignment
+  into ``local_var_files``).
+* ``test_iterator_detection_matches_source_construction`` — array-response
+  endpoints return a lazy ``PageIterator`` / ``EventIterator`` the runtime
+  materializes with ``list(...)``; the runtime detects them by a cheap proxy
+  (``:return:`` type ending in ``Array`` — see ``_Operation.returns_iterator``).
+  The test proves that proxy equals the true signal (a source scan for the
+  iterator constructor).
+
+The *which-commands* question — the exact set of upload / iterator endpoints —
+is snapshotted per-command in ``tests/fixtures/cli_surface.json`` (the
+``does_upload`` / ``returns_iterator`` fields), so an SDK bump that adds or
+removes such an endpoint surfaces in that fixture's diff during the normal regen
+step, with no hand-maintained set to update here.
 """
 
 from __future__ import annotations
@@ -40,7 +54,7 @@ import asana
 
 from asana_api_cli.cli import _enumerate_api_classes, _operations_for
 
-# Identical across all ``*_with_http_info`` methods in python-asana 5.2.4.
+# Identical across all ``*_with_http_info`` methods in python-asana 5.2.5.
 EXPECTED_ALL_PARAMS: frozenset[str] = frozenset(
     {
         "async_req",
@@ -98,102 +112,6 @@ EXPECTED_CONFIGURATION_ATTRS: frozenset[str] = frozenset(
     }
 )
 
-# The one python-asana method that performs a multipart file upload — i.e. it
-# assigns into ``local_var_files`` (every other method has only the empty
-# ``local_var_files = {}`` boilerplate). The CLI exposes ``--multibyte-filenames``
-# only on upload commands, detected at runtime by a cheap proxy (an op declaring
-# a ``file`` opt; see ``_Operation.does_upload``). This anchor plus the
-# proxy-equality check below pin that proxy to the true multipart signal.
-EXPECTED_MULTIPART_UPLOAD_METHODS: frozenset[tuple[str, str]] = frozenset(
-    {("AttachmentsApi", "create_attachment_for_object")}
-)
-
-# The python-asana methods whose response is an array — they return a lazy
-# ``PageIterator`` / ``EventIterator`` (built in the ``*_with_http_info`` source)
-# under the default flags, which the CLI materializes with ``list(...)``. The
-# runtime detects them via a cheap proxy (the ``:return:`` type ends in
-# ``Array``; see ``_Operation.returns_iterator``). This anchor plus the
-# proxy-equality check below pin that proxy to the true iterator-construction
-# signal so an SDK bump that adds, removes, or reshapes an array endpoint fails
-# loudly. (73 methods in python-asana 5.2.4.)
-EXPECTED_ITERATOR_RETURNING_METHODS: frozenset[tuple[str, str]] = frozenset(
-    {
-        ("AccessRequestsApi", "get_access_requests"),
-        ("AllocationsApi", "get_allocations"),
-        ("AttachmentsApi", "get_attachments_for_object"),
-        ("AuditLogAPIApi", "get_audit_log_events"),
-        ("BatchAPIApi", "create_batch_request"),
-        ("BudgetsApi", "get_budgets"),
-        ("CustomFieldSettingsApi", "get_custom_field_settings_for_goal"),
-        ("CustomFieldSettingsApi", "get_custom_field_settings_for_portfolio"),
-        ("CustomFieldSettingsApi", "get_custom_field_settings_for_project"),
-        ("CustomFieldSettingsApi", "get_custom_field_settings_for_team"),
-        ("CustomFieldsApi", "get_custom_fields_for_workspace"),
-        ("CustomTypesApi", "get_custom_types"),
-        ("EventsApi", "get_events"),
-        ("GoalRelationshipsApi", "get_goal_relationships"),
-        ("GoalsApi", "get_goals"),
-        ("GoalsApi", "get_parent_goals_for_goal"),
-        ("MembershipsApi", "get_memberships"),
-        ("PortfolioMembershipsApi", "get_portfolio_memberships"),
-        ("PortfolioMembershipsApi", "get_portfolio_memberships_for_portfolio"),
-        ("PortfoliosApi", "get_items_for_portfolio"),
-        ("PortfoliosApi", "get_portfolios"),
-        ("ProjectMembershipsApi", "get_project_memberships_for_project"),
-        ("ProjectPortfolioSettingsApi", "get_project_portfolio_settings_for_portfolio"),
-        ("ProjectPortfolioSettingsApi", "get_project_portfolio_settings_for_project"),
-        ("ProjectStatusesApi", "get_project_statuses_for_project"),
-        ("ProjectTemplatesApi", "get_project_templates"),
-        ("ProjectTemplatesApi", "get_project_templates_for_team"),
-        ("ProjectsApi", "get_projects"),
-        ("ProjectsApi", "get_projects_for_task"),
-        ("ProjectsApi", "get_projects_for_team"),
-        ("ProjectsApi", "get_projects_for_workspace"),
-        ("ProjectsApi", "search_projects_for_workspace"),
-        ("RatesApi", "get_rates"),
-        ("ReactionsApi", "get_reactions_on_object"),
-        ("RolesApi", "get_roles"),
-        ("SectionsApi", "get_sections_for_project"),
-        ("StatusUpdatesApi", "get_statuses_for_object"),
-        ("StoriesApi", "get_stories_for_goal"),
-        ("StoriesApi", "get_stories_for_task"),
-        ("TagsApi", "get_tags"),
-        ("TagsApi", "get_tags_for_task"),
-        ("TagsApi", "get_tags_for_workspace"),
-        ("TaskTemplatesApi", "get_task_templates"),
-        ("TasksApi", "get_dependencies_for_task"),
-        ("TasksApi", "get_dependents_for_task"),
-        ("TasksApi", "get_subtasks_for_task"),
-        ("TasksApi", "get_tasks"),
-        ("TasksApi", "get_tasks_for_project"),
-        ("TasksApi", "get_tasks_for_section"),
-        ("TasksApi", "get_tasks_for_tag"),
-        ("TasksApi", "get_tasks_for_user_task_list"),
-        ("TasksApi", "search_tasks_for_workspace"),
-        ("TeamMembershipsApi", "get_team_memberships"),
-        ("TeamMembershipsApi", "get_team_memberships_for_team"),
-        ("TeamMembershipsApi", "get_team_memberships_for_user"),
-        ("TeamsApi", "get_teams_for_user"),
-        ("TeamsApi", "get_teams_for_workspace"),
-        ("TimePeriodsApi", "get_time_periods"),
-        ("TimeTrackingCategoriesApi", "get_time_tracking_categories"),
-        ("TimeTrackingCategoriesApi", "get_time_tracking_entries_for_time_tracking_category"),
-        ("TimeTrackingEntriesApi", "get_time_tracking_entries"),
-        ("TimeTrackingEntriesApi", "get_time_tracking_entries_for_task"),
-        ("TimesheetApprovalStatusesApi", "get_timesheet_approval_statuses"),
-        ("TypeaheadApi", "typeahead_for_workspace"),
-        ("UsersApi", "get_favorites_for_user"),
-        ("UsersApi", "get_users"),
-        ("UsersApi", "get_users_for_team"),
-        ("UsersApi", "get_users_for_workspace"),
-        ("WebhooksApi", "get_webhooks"),
-        ("WorkspaceMembershipsApi", "get_workspace_memberships_for_user"),
-        ("WorkspaceMembershipsApi", "get_workspace_memberships_for_workspace"),
-        ("WorkspacesApi", "get_workspace_events"),
-        ("WorkspacesApi", "get_workspaces"),
-    }
-)
-
 
 def _all_params_for(func: Any) -> frozenset[str]:
     """Collect the ``all_params.append('x')`` string literals from a method body.
@@ -341,14 +259,6 @@ def test_no_unknown_configuration_settable_attrs() -> None:
 def test_upload_detection_matches_multipart_population() -> None:
     multipart = _methods_populating_local_var_files()
     assert multipart, "no method populates local_var_files — SDK introspection broke"
-    assert multipart == EXPECTED_MULTIPART_UPLOAD_METHODS, (
-        "the set of multipart-upload methods drifted:\n"
-        f"  added:   {sorted(multipart - EXPECTED_MULTIPART_UPLOAD_METHODS)}\n"
-        f"  removed: {sorted(EXPECTED_MULTIPART_UPLOAD_METHODS - multipart)}\n"
-        "A new/renamed upload endpoint must get the per-command "
-        "--multibyte-filenames flag (cli.py:_make_command, gated by "
-        "_Operation.does_upload). See docs/sdk-deviations.md."
-    )
     via_proxy = _upload_ops_via_does_upload()
     assert via_proxy == multipart, (
         "_Operation.does_upload (the 'has a file opt' proxy) no longer matches "
@@ -365,14 +275,6 @@ def test_iterator_detection_matches_source_construction() -> None:
     assert constructed, (
         "no method constructs a PageIterator/EventIterator — SDK introspection broke"
     )
-    assert constructed == EXPECTED_ITERATOR_RETURNING_METHODS, (
-        "the set of iterator-returning methods drifted:\n"
-        f"  added:   {sorted(constructed - EXPECTED_ITERATOR_RETURNING_METHODS)}\n"
-        f"  removed: {sorted(EXPECTED_ITERATOR_RETURNING_METHODS - constructed)}\n"
-        "These are exactly the calls execute_call_plan materializes with "
-        "list(...); review the change and regenerate the set. See "
-        "_Operation.returns_iterator."
-    )
     via_proxy = _iterator_ops_via_returns_iterator()
     assert via_proxy == constructed, (
         "_Operation.returns_iterator (the ':return: *Array' proxy) no longer "