asana-api-cli 3.1.0__tar.gz → 3.1.1__tar.gz

{asana_api_cli-3.1.0/src/asana_api_cli.egg-info → asana_api_cli-3.1.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: asana-api-cli
-Version: 3.1.0
+Version: 3.1.1
 Summary: Command-line wrapper around the official Asana Python SDK
 Author: Masanao Izumo
 License-Expression: MIT

{asana_api_cli-3.1.0 → asana_api_cli-3.1.1}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "asana-api-cli"
-version = "3.1.0"
+version = "3.1.1"
 description = "Command-line wrapper around the official Asana Python SDK"
 authors = [{name = "Masanao Izumo"}]
 readme = "README.md"
@@ -35,13 +35,13 @@ asana-api = "asana_api_cli.cli:main"
 
 [dependency-groups]
 dev = [
-    "ruff>=0.6",
-    "basedpyright>=1.13",
+    "ruff>=0.15",
+    "basedpyright>=1.39",
     "pytest>=9,<10",
-    "build>=1,<2",
-    "twine>=6,<7",
-    "vermin>=1.6,<2",
-    "vcrpy>=6",
+    "build>=1.5,<2",
+    "twine>=6.2,<7",
+    "vermin>=1.8,<2",
+    "vcrpy>=8",
     "pytest-recording>=0.13",
 ]
 

{asana_api_cli-3.1.0 → asana_api_cli-3.1.1}/src/asana_api_cli/cli.py

@@ -350,14 +350,14 @@ def _escape_help(text: str) -> str:
 # asana-api label uses parentheses. Six kinds cover the SDK input structure:
 #
 #   (Configuration: <name>)  set on asana.Configuration         (global flags)
-#   (ApiClient: <name>)      set on the ApiClient instance       (user_agent, default_headers)
+#   (ApiClient: <name>)      set on the ApiClient instance       (user_agent, set_default_header)
 #   (args: <name>)           positional method argument          (body / path GID / workspace_gid)
 #   (opts: <name>)           entry in the method ``opts`` dict   (docstring :param)
 #   (kwargs: <name>)         boilerplate **kwargs every method accepts (all_params)
 #   (asana-api: extension)   no SDK counterpart                  (CLI-only)
 #
 # Configuration globals and the two ApiClient-instance globals (--user-agent /
-# --default-header) carry the literal by hand in both ``main`` and
+# --set-default-header) carry the literal by hand in both ``main`` and
 # ``_make_global_option_params`` (kept byte-identical between cli.py and
 # click_ext.py by ``test_click_ext.TestHelpTextSync``); the CLI-only formatter
 # flags (``--output`` / ``--query`` / ``--csv-bom`` and the error-path twins
@@ -1210,7 +1210,7 @@ def _retry_strategy_option(f: Any) -> Any:
     help=("Override the User-Agent header the SDK sends on every request. (ApiClient: user_agent)"),
 )
 @click.option(
-    "--default-header",
+    "--set-default-header",
     "default_headers",
     multiple=True,
     callback=default_header_callback,
@@ -1218,7 +1218,7 @@ def _retry_strategy_option(f: Any) -> Any:
         "Add an HTTP header sent on every request, given as NAME=VALUE; "
         "repeatable. Unlike per-call --header-params it applies to all "
         "calls. Not redacted in --debug output — see SECURITY.md. "
-        "(ApiClient: default_headers)"
+        "(ApiClient: set_default_header)"
     ),
 )
 @_retry_strategy_option

{asana_api_cli-3.1.0 → asana_api_cli-3.1.1}/src/asana_api_cli/click_ext.py

@@ -166,14 +166,14 @@ def _make_global_option_params() -> list[click.Option]:
             ),
         ),
         click.Option(
-            ["--default-header", "default_headers"],
+            ["--set-default-header", "default_headers"],
             multiple=True,
             callback=default_header_callback,
             help=(
                 "Add an HTTP header sent on every request, given as NAME=VALUE; "
                 "repeatable. Unlike per-call --header-params it applies to all "
                 "calls. Not redacted in --debug output — see SECURITY.md. "
-                "(ApiClient: default_headers)"
+                "(ApiClient: set_default_header)"
             ),
         ),
         *(

{asana_api_cli-3.1.0 → asana_api_cli-3.1.1}/src/asana_api_cli/session.py

@@ -222,7 +222,7 @@ class AsanaSession:
 
         # ApiClient-instance settings (not Configuration knobs) applied after
         # construction. ``default_headers`` first, then ``user_agent`` last, so
-        # the dedicated ``--user-agent`` wins over a ``--default-header`` that
+        # the dedicated ``--user-agent`` wins over a ``--set-default-header`` that
         # also targets ``User-Agent`` (both write ``default_headers['User-Agent']``).
         if runtime.default_headers:
             for name, value in runtime.default_headers.items():

{asana_api_cli-3.1.0 → asana_api_cli-3.1.1}/src/asana_api_cli/structured_arg.py

@@ -24,7 +24,7 @@ insensitive). ``1`` / ``0`` are intentionally rejected so int and bool
 fields cannot be confused by readers of the command line.
 
 The module also hosts :func:`default_header_callback`, a separate
-``NAME=VALUE``-per-occurrence parser for the repeatable ``--default-header``
+``NAME=VALUE``-per-occurrence parser for the repeatable ``--set-default-header``
 global. It is deliberately not the hybrid parser above: header values often
 contain commas, which the ``key=value,key=value`` shorthand would mis-split.
 """
@@ -210,7 +210,7 @@ def click_callback(
 def default_header_callback(
     ctx: click.Context, param: click.Parameter, value: tuple[str, ...]
 ) -> dict[str, str] | None:
-    """Click ``callback`` for a repeatable ``--default-header NAME=VALUE`` option.
+    """Click ``callback`` for a repeatable ``--set-default-header NAME=VALUE`` option.
 
     ``multiple=True`` hands the callback a tuple of raw ``NAME=VALUE`` tokens
     (empty when the flag was not given). Returns ``None`` for "not given" so the

{asana_api_cli-3.1.0 → asana_api_cli-3.1.1/src/asana_api_cli.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: asana-api-cli
-Version: 3.1.0
+Version: 3.1.1
 Summary: Command-line wrapper around the official Asana Python SDK
 Author: Masanao Izumo
 License-Expression: MIT

{asana_api_cli-3.1.0 → asana_api_cli-3.1.1}/tests/test_cli_invocation.py

@@ -510,7 +510,7 @@ class TestRetryStrategyReachesSession:
 
 
 class TestHttpHeaderGlobalsReachClient:
-    """``--user-agent`` and ``--default-header`` are ApiClient-instance globals;
+    """``--user-agent`` and ``--set-default-header`` are ApiClient-instance globals;
     they must reach the ``ApiClient`` that issues the request, and (like every
     global) be accepted at the leaf-command level."""
 
@@ -538,7 +538,14 @@ class TestHttpHeaderGlobalsReachClient:
         monkeypatch.setattr(asana.TasksApi, "get_task", patched)
         result = make_runner().invoke(
             cmd,
-            ["--default-header", "X-Foo=bar", "--default-header", "X-Baz=qux", "--task", "T"],
+            [
+                "--set-default-header",
+                "X-Foo=bar",
+                "--set-default-header",
+                "X-Baz=qux",
+                "--task",
+                "T",
+            ],
         )
         assert result.exit_code == 0, full_output(result)
         assert captured[0]["X-Foo"] == "bar"
@@ -547,7 +554,7 @@ class TestHttpHeaderGlobalsReachClient:
     def test_malformed_default_header_is_usage_error(self, monkeypatch: pytest.MonkeyPatch) -> None:
         cmd = _build_command("TasksApi", "get_task")
         _patch(monkeypatch, "TasksApi", "get_task", return_value={"data": {}})
-        result = make_runner().invoke(cmd, ["--default-header", "noequals", "--task", "T"])
+        result = make_runner().invoke(cmd, ["--set-default-header", "noequals", "--task", "T"])
         assert result.exit_code == 2, full_output(result)
         assert "NAME=VALUE" in full_output(result)
 

{asana_api_cli-3.1.0 → asana_api_cli-3.1.1}/tests/test_sdk_boilerplate.py

@@ -53,8 +53,8 @@ EXPECTED_ALL_PARAMS: frozenset[str] = frozenset(
     }
 )
 
-# Public attributes on a default ``asana.Configuration()``. Not every settable
-# attribute is a CLI flag: object-/callable-typed members (``logger*``,
+# Settable attributes the CLI knows about on a default ``asana.Configuration()``.
+# Not every one is a CLI flag: object-/callable-typed members (``logger*``,
 # ``refresh_api_key_hook``) cannot be flags, and the inert auth fields
 # (``username`` / ``password`` / ``api_key`` / ``api_key_prefix``) are
 # deliberately NOT exposed — Asana auth is Bearer-token only, so they are
@@ -62,6 +62,14 @@ EXPECTED_ALL_PARAMS: frozenset[str] = frozenset(
 # set because the SDK's Configuration still declares them; this guard tracks the
 # SDK surface, not the CLI's. ``logger_format`` / ``logger_file`` reach the
 # ``logger*`` members via @property setters.
+#
+# This is the union across the supported asana range (>=5.0.2), pinned at the
+# latest. ``test_no_unknown_configuration_settable_attrs`` checks only one
+# direction — that the installed SDK exposes nothing OUTSIDE this set, since a
+# *new* attribute is the actionable drift (it likely needs a flag). Older SDKs
+# initialize fewer attributes (``access_token`` arrived in 5.0.6,
+# ``retry_strategy`` in 5.1.0); those absences are tolerated so the guard passes
+# on the floor as well as the pinned version.
 EXPECTED_CONFIGURATION_ATTRS: frozenset[str] = frozenset(
     {
         "access_token",
@@ -191,15 +199,15 @@ def test_all_methods_share_expected_all_params() -> None:
     )
 
 
-def test_configuration_settable_attrs_match() -> None:
+def test_no_unknown_configuration_settable_attrs() -> None:
     got = frozenset(k for k in vars(asana.Configuration()) if not k.startswith("_"))
-    assert got == EXPECTED_CONFIGURATION_ATTRS, (
-        "asana.Configuration public attributes drifted:\n"
-        f"  added:   {sorted(got - EXPECTED_CONFIGURATION_ATTRS)}\n"
-        f"  removed: {sorted(EXPECTED_CONFIGURATION_ATTRS - got)}\n"
+    unknown = got - EXPECTED_CONFIGURATION_ATTRS
+    assert not unknown, (
+        "asana.Configuration exposes settable attributes the CLI does not know "
+        f"about: {sorted(unknown)}\n"
         "A newly settable property likely needs a global flag + "
-        "(Configuration: <name>) label in cli.py / click_ext.py. "
-        "See docs/cli-sdk-mapping.md."
+        "(Configuration: <name>) label in cli.py / click_ext.py, then adding it "
+        "to EXPECTED_CONFIGURATION_ATTRS. See docs/cli-sdk-mapping.md."
     )
 
 

{asana_api_cli-3.1.0 → asana_api_cli-3.1.1}/tests/test_session.py

@@ -330,7 +330,7 @@ class TestAsanaSessionPaginationKwargs:
 
 
 # ---------------------------------------------------------------------------
-# ApiClient-instance settings (--user-agent / --default-header)
+# ApiClient-instance settings (--user-agent / --set-default-header)
 # ---------------------------------------------------------------------------
 
 

{asana_api_cli-3.1.0 → asana_api_cli-3.1.1}/tests/test_structured_arg.py

@@ -224,13 +224,13 @@ class TestRetryFieldSchema:
 def _default_headers(*tokens: str) -> dict[str, str] | None:
     """Run ``default_header_callback`` with a real (throwaway) Click context,
     mirroring how ``multiple=True`` hands it a tuple of raw tokens."""
-    param = click.Option(["--default-header"], multiple=True)
+    param = click.Option(["--set-default-header"], multiple=True)
     ctx = click.Context(click.Command("test"))
     return default_header_callback(ctx, param, tokens)
 
 
 class TestDefaultHeaderCallback:
-    """``--default-header NAME=VALUE`` (repeatable) parser."""
+    """``--set-default-header NAME=VALUE`` (repeatable) parser."""
 
     def test_not_given_returns_none(self) -> None:
         # Matches the unset sentinel the other globals use.