scim2-cli 0.4.1__tar.gz → 0.5.0__tar.gz

{scim2_cli-0.4.1 → scim2_cli-0.5.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: scim2-cli
-Version: 0.4.1
+Version: 0.5.0
 Summary: SCIM application development CLI
 Keywords: scim,scim2,provisioning,rfc7643,rfc7644
 Author: Yaal Coop
@@ -217,8 +217,8 @@ Classifier: License :: OSI Approved :: Apache Software License
 Classifier: Environment :: Web Environment
 Classifier: Programming Language :: Python
 Classifier: Operating System :: OS Independent
-Requires-Dist: click>=8.1.7
-Requires-Dist: scim2-client[httpx2]>=0.11.2
+Requires-Dist: click>=8.5.0
+Requires-Dist: scim2-client[httpx2]>=0.13.0
 Requires-Dist: scim2-tester>=0.4.0
 Requires-Dist: sphinx-click-rst-to-ansi-formatter>=0.2.0
 Requires-Dist: pydanclick>=0.5.0

{scim2_cli-0.4.1 → scim2_cli-0.5.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "uv_build"
 
 [project]
 name = "scim2-cli"
-version = "0.4.1"
+version = "0.5.0"
 description = "SCIM application development CLI"
 readme = "README.md"
 keywords = [
@@ -29,8 +29,8 @@ classifiers = [
 ]
 requires-python = ">= 3.11"
 dependencies = [
-    "click>=8.1.7",
-    "scim2-client[httpx2]>=0.11.2",
+    "click>=8.5.0",
+    "scim2-client[httpx2]>=0.13.0",
     "scim2-tester>=0.4.0",
     "sphinx-click-rst-to-ansi-formatter>=0.2.0",
     "pydanclick>=0.5.0",

{scim2_cli-0.4.1 → scim2_cli-0.5.0}/pyproject.toml.orig

@@ -4,7 +4,7 @@ build-backend = "uv_build"
 
 [project]
 name = "scim2-cli"
-version = "0.4.1"
+version = "0.5.0"
 description = "SCIM application development CLI"
 authors = [{name="Yaal Coop", email="contact@yaal.coop"}]
 license = {file = "LICENSE.md"}
@@ -26,8 +26,8 @@ classifiers = [
 
 requires-python = ">= 3.11"
 dependencies = [
-    "click>=8.1.7",
-    "scim2-client[httpx2]>=0.11.2",
+    "click>=8.5.0",
+    "scim2-client[httpx2]>=0.13.0",
     "scim2-tester>=0.4.0",
     "sphinx-click-rst-to-ansi-formatter>=0.2.0",
     "pydanclick>=0.5.0",

{scim2_cli-0.4.1 → scim2_cli-0.5.0}/scim2_cli/__init__.py

@@ -1,5 +1,4 @@
 import json
-import re
 import sys
 from typing import IO
 from typing import Any
@@ -27,7 +26,7 @@ from scim2_cli.test import test_cli
 from scim2_cli.utils import DOC_URL
 from scim2_cli.utils import SCIM_EXCEPTIONS
 from scim2_cli.utils import HeaderType
-from scim2_cli.utils import escape_control_characters
+from scim2_cli.utils import command_name
 from scim2_cli.utils import exception_to_click_error
 from scim2_cli.utils import split_headers
 
@@ -137,14 +136,12 @@ def cli(
     except (*SCIM_EXCEPTIONS, ScimProviderError) as exc:
         raise exception_to_click_error(exc) from exc
 
-    provider = scim_client.provider
     ctx.obj["client"] = scim_client
-    ctx.obj["resource_models"] = {}
-    for resource_type in provider.resource_types:
-        resource_model = provider.model_for(resource_type)
-        assert resource_model is not None
-        name = re.sub(r"\[.*\]", "", resource_model.__name__.lower())
-        ctx.obj["resource_models"][escape_control_characters(name)] = resource_model
+    ctx.obj["resource_types"] = {
+        command_name(resource_type): resource_type
+        for resource_type in scim_client.provider.resource_types
+        if resource_type.name or resource_type.id
+    }
 
     if not sys.stdin.isatty():  # pragma: no cover
         if stdin := sys.stdin.read().strip():

{scim2_cli-0.4.1 → scim2_cli-0.5.0}/scim2_cli/create.py

@@ -2,30 +2,43 @@ from typing import Any
 from typing import cast
 
 import click
-from click import ClickException
 from pydanclick import from_pydantic
+from scim2_client import Me
 from scim2_client.engines.httpx2 import SyncSCIMClient
 from scim2_models import Context
 from scim2_models import Error
 from scim2_models import Resource
+from scim2_models import ResourceType
 from sphinx_click.rst_to_ansi_formatter import make_rst_to_ansi_formatter
 
 from scim2_cli.utils import DOC_URL
 from scim2_cli.utils import SCIM_EXCEPTIONS
 from scim2_cli.utils import ModelCommand
+from scim2_cli.utils import command_name
 from scim2_cli.utils import escape_options_help
 from scim2_cli.utils import exception_to_click_error
 from scim2_cli.utils import formatted_payload
+from scim2_cli.utils import indent_option
+from scim2_cli.utils import inherited
+from scim2_cli.utils import me_option
+from scim2_cli.utils import renamed_fields
 from scim2_cli.utils import unacceptable_fields
 
 
 def create_payload(
-    client: SyncSCIMClient, payload: Resource[Any] | dict[str, Any], indent: bool
+    client: SyncSCIMClient,
+    resource_type: ResourceType | None,
+    payload: Resource[Any] | dict[str, Any],
+    indent: bool,
+    me: bool,
 ) -> None:
     try:
         # Response payloads are always checked, so the client never returns a dict.
         response = cast(
-            "Resource[Any] | Error", client.create(payload, raise_scim_errors=False)
+            "Resource[Any] | Error",
+            client.create(
+                Me if me else resource_type, payload, raise_scim_errors=False
+            ),
         )
 
     except SCIM_EXCEPTIONS as scim_exc:
@@ -34,27 +47,23 @@ def create_payload(
     click.echo(formatted_payload(response.model_dump(), indent))
 
 
-def create_factory(model: type[Resource[Any]] | None) -> click.Command:
-    if not model:
-        raise ClickException("Invalid model")
-
+def create_factory(
+    resource_type: ResourceType, model: type[Resource[Any]]
+) -> click.Command:
     exclude = unacceptable_fields(Context.RESOURCE_CREATION_REQUEST, model)
 
     @click.command(
         cls=make_rst_to_ansi_formatter(DOC_URL),
-        name=model.__name__.lower(),
-    )
-    @click.option(
-        "--indent/--no-indent",
-        is_flag=True,
-        default=True,
-        help="Indent JSON response payloads.",
+        name=command_name(resource_type),
     )
-    @from_pydantic("obj", model, exclude=exclude)
+    @indent_option("cli_indent")
+    @me_option("cli_me")
+    @from_pydantic("obj", model, exclude=exclude, rename=renamed_fields(model, exclude))
     @click.pass_context
     def create_command(
         ctx: click.Context,
-        indent: bool,
+        cli_indent: bool,
+        cli_me: bool,
         obj: Resource[Any] | None,
         *args: Any,
         **kwargs: Any,
@@ -81,6 +90,13 @@ def create_factory(model: type[Resource[Any]] | None) -> click.Command:
 
             echo '{"userName": "bjensen@example.com", "schemas": ["urn:ietf:params:scim:schemas:core:2.0:User"]}' |  create user
 
+        With :code:`--me`, the request is made on the :code:`/Me` endpoint,
+        and the server chooses the resource type:
+
+        .. code-block:: bash
+
+            scim create user --me --user-name "foo"
+
         """
         if obj == model():
             obj = None
@@ -90,7 +106,13 @@ def create_factory(model: type[Resource[Any]] | None) -> click.Command:
             click.echo(ctx.get_help())
             ctx.exit(1)
 
-        create_payload(ctx.obj["client"], payload, indent)
+        create_payload(
+            ctx.obj["client"],
+            resource_type,
+            payload,
+            inherited(ctx, "cli_indent", cli_indent),
+            inherited(ctx, "cli_me", cli_me),
+        )
 
     return escape_options_help(create_command)
 
@@ -102,16 +124,12 @@ def create_factory(model: type[Resource[Any]] | None) -> click.Command:
     invoke_without_command=True,
 )
 @click.pass_context
-@click.option(
-    "--indent/--no-indent",
-    is_flag=True,
-    default=True,
-    help="Indent JSON response payloads.",
-)
-def create_cli(ctx: click.Context, indent: bool) -> None:
+@indent_option("cli_indent")
+@me_option("cli_me")
+def create_cli(ctx: click.Context, cli_indent: bool, cli_me: bool) -> None:
     """Perform a `SCIM POST <https://www.rfc-editor.org/rfc/rfc7644#section-3.3>`_ request on resources endpoint.
 
-    There are subcommands for all the available models, with dynamic attributes.
+    There are subcommands for all the resource types of the server, with dynamic attributes.
     See the attributes for :code:`user` with:
 
     .. code-block:: bash
@@ -124,6 +142,9 @@ def create_cli(ctx: click.Context, indent: bool) -> None:
 
         echo '{"userName": "bjensen@example.com", "schemas": ["urn:ietf:params:scim:schemas:core:2.0:User"]}' |  create
 
+    With :code:`--me`, the request is made on the :code:`/Me` endpoint,
+    and the server chooses the resource type.
+
     """
     if ctx.invoked_subcommand is not None:
         return
@@ -133,4 +154,4 @@ def create_cli(ctx: click.Context, indent: bool) -> None:
         click.echo(ctx.get_help())
         ctx.exit(1)
 
-    create_payload(ctx.obj["client"], payload, indent)
+    create_payload(ctx.obj["client"], None, payload, cli_indent, cli_me)

{scim2_cli-0.4.1 → scim2_cli-0.5.0}/scim2_cli/delete.py

@@ -1,10 +1,13 @@
 import click
 from click import ClickException
+from scim2_client import Me
 from scim2_models import Message
 from scim2_models import Resource
 from sphinx_click.rst_to_ansi_formatter import make_rst_to_ansi_formatter
 
 from scim2_cli.utils import exception_to_click_error
+from scim2_cli.utils import find_target
+from scim2_cli.utils import me_option
 
 from .utils import DOC_URL
 from .utils import SCIM_EXCEPTIONS
@@ -12,8 +15,9 @@ from .utils import formatted_payload
 
 
 @click.command(cls=make_rst_to_ansi_formatter(DOC_URL), name="delete")
-@click.argument("resource-type", required=True)
-@click.argument("id", required=True)
+@click.argument("resource-type", required=False)
+@click.argument("id", required=False)
+@me_option()
 @click.option(
     "--indent/--no-indent",
     is_flag=True,
@@ -21,23 +25,37 @@ from .utils import formatted_payload
     help="Indent JSON response payloads.",
 )
 @click.pass_context
-def delete_cli(ctx: click.Context, resource_type: str, id: str, indent: bool) -> None:
+def delete_cli(
+    ctx: click.Context,
+    resource_type: str | None,
+    id: str | None,
+    me: bool,
+    indent: bool,
+) -> None:
     """Perform a `SCIM DELETE query <https://www.rfc-editor.org/rfc/rfc7644#section-3.6>`_ request.
 
     .. code-block:: bash
 
          delete user 1234
+
+    With :code:`--me`, the request is made on the :code:`/Me` endpoint:
+
+    .. code-block:: bash
+
+         delete --me
     """
-    try:
-        resource_model = ctx.obj["resource_models"][resource_type]
-    except KeyError as exc:
-        ok_values = ", ".join(ctx.obj["resource_models"])
-        raise ClickException(
-            f"Unknown resource type '{resource_type}'. Available values are: {ok_values}'"
-        ) from exc
+    if me and (resource_type or id):
+        raise ClickException("--me cannot be used with a resource type or an id.")
+
+    if not me and not (resource_type and id):
+        raise ClickException("Pass a resource type and an id, or --me.")
+
+    target = (
+        find_target(ctx.obj["resource_types"], resource_type) if resource_type else Me
+    )
 
     try:
-        response = ctx.obj["client"].delete(resource_model, id, raise_scim_errors=False)
+        response = ctx.obj["client"].delete(target, id, raise_scim_errors=False)
 
     except SCIM_EXCEPTIONS as scim_exc:
         raise exception_to_click_error(scim_exc) from scim_exc

{scim2_cli-0.4.1 → scim2_cli-0.5.0}/scim2_cli/query.py

@@ -1,5 +1,9 @@
+from typing import Any
+
 import click
 from click import ClickException
+from scim2_client import Me
+from scim2_models import Resource
 from scim2_models import ResourceType
 from scim2_models import ResponseParameters
 from scim2_models import Schema
@@ -8,11 +12,15 @@ from scim2_models import ServiceProviderConfig
 from sphinx_click.rst_to_ansi_formatter import make_rst_to_ansi_formatter
 
 from scim2_cli.utils import exception_to_click_error
+from scim2_cli.utils import find_target
+from scim2_cli.utils import me_option
 
 from .utils import DOC_URL
 from .utils import SCIM_EXCEPTIONS
 from .utils import formatted_payload
 
+DISCOVERY_MODELS = (Schema, ResourceType, ServiceProviderConfig)
+
 
 @click.command(cls=make_rst_to_ansi_formatter(DOC_URL), name="query")
 @click.pass_context
@@ -33,6 +41,10 @@ from .utils import formatted_payload
     type=int,
     help="An integer indicating the 1-based index of the first query result.",
 )
+@click.option(
+    "--cursor",
+    help="The cursor of the page to read, for cursor-based pagination (RFC 9865). Pass an empty value to read the first page.",
+)
 @click.option(
     "--count",
     type=int,
@@ -49,6 +61,7 @@ from .utils import formatted_payload
     "--sort-order",
     help="A string indicating the order in which the “sortBy” parameter is applied.",
 )
+@me_option()
 @click.option(
     "--indent/--no-indent",
     is_flag=True,
@@ -62,10 +75,12 @@ def query_cli(
     attribute: list[str],
     excluded_attribute: list[str],
     start_index: int | None,
+    cursor: str | None,
     count: int | None,
     filter: str | None,
     sort_by: str | None,
     sort_order: str | None,
+    me: bool,
     indent: bool,
 ) -> None:
     """Perform a `SCIM GET <https://www.rfc-editor.org/rfc/rfc7644#section-3.4.1>`_ request on the :code:`RESOURCE_TYPE` endpoint.
@@ -73,6 +88,7 @@ def query_cli(
     - If :code:`RESOURCE_TYPE` is :code:`user` and :code:`id` is `1234`, then the request will made on the :code:`/Users/1234` endpoint.
     - If :code:`RESOURCE_TYPE` is :code:`user` and :code:`id` is not set, then the request will made on the :code:`/Users` endpoint.
     - If :code:`RESOURCE_TYPE` is not set, then the request will made on the :code:`/` endpoint.
+    - If :code:`--me` is set, then the request will be made on the :code:`/Me` endpoint.
 
     When a single resource is queried, only :code:`--attribute` and :code:`--excluded-attribute` are
     available, as defined in `RFC7644 §3.4.1 <https://www.rfc-editor.org/rfc/rfc7644#section-3.4.1>`_.
@@ -84,24 +100,23 @@ def query_cli(
         echo '{"startIndex": 50, "count": 10}' |  query user
 
     """
-    for discovery_model in (Schema, ResourceType, ServiceProviderConfig):
-        ctx.obj["resource_models"][discovery_model.__name__.lower()] = discovery_model
+    if me and (resource_type or id):
+        raise ClickException("--me cannot be used with a resource type or an id.")
 
-    model = None
+    target: ResourceType | type[Resource[Any]] | None = None
     if resource_type:
-        try:
-            model = ctx.obj["resource_models"][resource_type]
-        except KeyError as exc:
-            ok_values = ", ".join(ctx.obj["resource_models"])
-            raise ClickException(
-                f"Unknown resource type '{resource_type}. Available values are: {ok_values}'"
-            ) from exc
-
-    single_resource = bool(id) or model is ServiceProviderConfig
+        targets: dict[str, ResourceType | type[Resource[Any]]] = {
+            **ctx.obj["resource_types"],
+            **{model.__name__.lower(): model for model in DISCOVERY_MODELS},
+        }
+        target = find_target(targets, resource_type)
+
+    single_resource = me or bool(id) or target is ServiceProviderConfig
     listing_options = [
         name
         for name, value in (
             ("--start-index", start_index),
+            ("--cursor", cursor),
             ("--count", count),
             ("--filter", filter),
             ("--sort-by", sort_by),
@@ -122,8 +137,8 @@ def query_cli(
         check_request_payload = True
         payload = ResponseParameters.model_validate(
             {
-                "attributes": attribute,
-                "excluded_attributes": excluded_attribute,
+                "attributes": attribute or None,
+                "excluded_attributes": excluded_attribute or None,
             }
         )
 
@@ -131,9 +146,10 @@ def query_cli(
         check_request_payload = True
         payload = SearchRequest.model_validate(
             {
-                "attributes": attribute,
-                "excluded_attributes": excluded_attribute,
+                "attributes": attribute or None,
+                "excluded_attributes": excluded_attribute or None,
                 "start_index": start_index,
+                "cursor": cursor,
                 "count": count,
                 "filter": filter,
                 "sort_by": sort_by,
@@ -143,7 +159,7 @@ def query_cli(
 
     try:
         response = ctx.obj["client"].query(
-            model,
+            Me if me else target,
             id,
             query_parameters=payload,
             check_request_payload=check_request_payload,

{scim2_cli-0.4.1 → scim2_cli-0.5.0}/scim2_cli/replace.py

@@ -2,31 +2,44 @@ from typing import Any
 from typing import cast
 
 import click
-from click import ClickException
 from pydanclick import from_pydantic
+from scim2_client import Me
 from scim2_client.engines.httpx2 import SyncSCIMClient
 from scim2_models import Context
 from scim2_models import Error
 from scim2_models import Resource
+from scim2_models import ResourceType
 from sphinx_click.rst_to_ansi_formatter import make_rst_to_ansi_formatter
 
+from scim2_cli.utils import command_name
 from scim2_cli.utils import escape_options_help
 from scim2_cli.utils import exception_to_click_error
+from scim2_cli.utils import indent_option
+from scim2_cli.utils import inherited
+from scim2_cli.utils import me_option
 
 from .utils import DOC_URL
 from .utils import SCIM_EXCEPTIONS
 from .utils import ModelCommand
 from .utils import formatted_payload
+from .utils import renamed_fields
 from .utils import unacceptable_fields
 
 
 def replace_payload(
-    client: SyncSCIMClient, payload: Resource[Any] | dict[str, Any], indent: bool
+    client: SyncSCIMClient,
+    resource_type: ResourceType | None,
+    payload: Resource[Any] | dict[str, Any],
+    indent: bool,
+    me: bool,
 ) -> None:
     try:
         # Response payloads are always checked, so the client never returns a dict.
         response = cast(
-            "Resource[Any] | Error", client.replace(payload, raise_scim_errors=False)
+            "Resource[Any] | Error",
+            client.replace(
+                Me if me else resource_type, payload, raise_scim_errors=False
+            ),
         )
 
     except SCIM_EXCEPTIONS as scim_exc:
@@ -35,28 +48,24 @@ def replace_payload(
     click.echo(formatted_payload(response.model_dump(), indent))
 
 
-def replace_factory(model: type[Resource[Any]] | None) -> click.Command:
-    if not model:
-        raise ClickException("Invalid model")
-
+def replace_factory(
+    resource_type: ResourceType, model: type[Resource[Any]]
+) -> click.Command:
     exclude = unacceptable_fields(Context.RESOURCE_REPLACEMENT_REQUEST, model)
     exclude.remove("id")
 
     @click.command(
         cls=make_rst_to_ansi_formatter(DOC_URL),
-        name=model.__name__.lower(),
-    )
-    @click.option(
-        "--indent/--no-indent",
-        is_flag=True,
-        default=True,
-        help="Indent JSON response payloads.",
+        name=command_name(resource_type),
     )
-    @from_pydantic("obj", model, exclude=exclude)
+    @indent_option("cli_indent")
+    @me_option("cli_me")
+    @from_pydantic("obj", model, exclude=exclude, rename=renamed_fields(model, exclude))
     @click.pass_context
     def replace_command(
         ctx: click.Context,
-        indent: bool,
+        cli_indent: bool,
+        cli_me: bool,
         obj: Resource[Any] | None,
         *args: Any,
         **kwargs: Any,
@@ -84,6 +93,13 @@ def replace_factory(model: type[Resource[Any]] | None) -> click.Command:
 
             echo '{"id": "xxxx-yyyy", "userName": "bjensen@example.com", "schemas": ["urn:ietf:params:scim:schemas:core:2.0:User"]}' |  replace user
 
+        With :code:`--me`, the request is made on the :code:`/Me` endpoint,
+        and :code:`--id` is not needed:
+
+        .. code-block:: bash
+
+            scim replace user --me --user-name "foo"
+
         """
         if obj == model():
             obj = None
@@ -95,8 +111,10 @@ def replace_factory(model: type[Resource[Any]] | None) -> click.Command:
 
         replace_payload(
             ctx.obj["client"],
+            resource_type,
             payload,
-            indent,
+            inherited(ctx, "cli_indent", cli_indent),
+            inherited(ctx, "cli_me", cli_me),
         )
 
     return escape_options_help(replace_command)
@@ -109,16 +127,12 @@ def replace_factory(model: type[Resource[Any]] | None) -> click.Command:
     invoke_without_command=True,
 )
 @click.pass_context
-@click.option(
-    "--indent/--no-indent",
-    is_flag=True,
-    default=True,
-    help="Indent JSON response payloads.",
-)
-def replace_cli(ctx: click.Context, indent: bool) -> None:
+@indent_option("cli_indent")
+@me_option("cli_me")
+def replace_cli(ctx: click.Context, cli_indent: bool, cli_me: bool) -> None:
     """Perform a `SCIM PUT <https://www.rfc-editor.org/rfc/rfc7644#section-3.5.1>`_ request on the resources endpoint.
 
-    There are subcommands for all the available models, with dynamic attributes.
+    There are subcommands for all the resource types of the server, with dynamic attributes.
     See the attributes for :code:`user` with:
 
     .. code-block:: bash
@@ -131,6 +145,9 @@ def replace_cli(ctx: click.Context, indent: bool) -> None:
 
         echo '{"userName": "bjensen@example.com", "schemas": ["urn:ietf:params:scim:schemas:core:2.0:User"], "id": "1234"}' |  replace user
 
+    With :code:`--me`, the request is made on the :code:`/Me` endpoint,
+    and the id is not needed.
+
     """
     if ctx.invoked_subcommand is not None:
         return
@@ -140,8 +157,4 @@ def replace_cli(ctx: click.Context, indent: bool) -> None:
         click.echo(ctx.get_help())
         ctx.exit(1)
 
-    replace_payload(
-        ctx.obj["client"],
-        payload,
-        indent,
-    )
+    replace_payload(ctx.obj["client"], None, payload, cli_indent, cli_me)

{scim2_cli-0.4.1 → scim2_cli-0.5.0}/scim2_cli/search.py

@@ -3,6 +3,7 @@ from scim2_models import SearchRequest
 from sphinx_click.rst_to_ansi_formatter import make_rst_to_ansi_formatter
 
 from scim2_cli.utils import exception_to_click_error
+from scim2_cli.utils import find_target
 
 from .utils import DOC_URL
 from .utils import SCIM_EXCEPTIONS
@@ -11,6 +12,7 @@ from .utils import formatted_payload
 
 @click.command(cls=make_rst_to_ansi_formatter(DOC_URL), name="search")
 @click.pass_context
+@click.argument("resource_type", required=False)
 @click.option(
     "--attribute",
     multiple=True,
@@ -26,6 +28,10 @@ from .utils import formatted_payload
     type=int,
     help="An integer indicating the 1-based index of the first query result.",
 )
+@click.option(
+    "--cursor",
+    help="The cursor of the page to read, for cursor-based pagination (RFC 9865). Pass an empty value to read the first page.",
+)
 @click.option(
     "--count",
     type=int,
@@ -50,16 +56,21 @@ from .utils import formatted_payload
 )
 def search_cli(
     ctx: click.Context,
+    resource_type: str | None,
     attribute: list[str],
     excluded_attribute: list[str],
     start_index: int | None,
+    cursor: str | None,
     count: int | None,
     filter: str | None,
     sort_by: str | None,
     sort_order: str | None,
     indent: bool,
 ) -> None:
-    """Perform a `SCIM GET <https://www.rfc-editor.org/rfc/rfc7644#section-3.4.1>`_ request on the :code:`/.search` endpoint.
+    """Perform a `SCIM POST search <https://www.rfc-editor.org/rfc/rfc7644#section-3.4.3>`_ request.
+
+    - If :code:`RESOURCE_TYPE` is :code:`user`, then the request will be made on the :code:`/Users/.search` endpoint.
+    - If :code:`RESOURCE_TYPE` is not set, then the request will be made on the :code:`/.search` endpoint.
 
     Data passed in JSON format to stdin is sent as request arguments and all the other query arguments are ignored:
 
@@ -68,6 +79,10 @@ def search_cli(
         echo '{"startIndex": 50, "count": 10}' |  search user
 
     """
+    target = (
+        find_target(ctx.obj["resource_types"], resource_type) if resource_type else None
+    )
+
     if ctx.obj.get("stdin"):
         check_request_payload = False
         payload = ctx.obj.get("stdin")
@@ -76,9 +91,10 @@ def search_cli(
         check_request_payload = True
         payload = SearchRequest.model_validate(
             {
-                "attributes": attribute,
-                "excluded_attributes": excluded_attribute,
+                "attributes": attribute or None,
+                "excluded_attributes": excluded_attribute or None,
                 "start_index": start_index,
+                "cursor": cursor,
                 "count": count,
                 "filter": filter,
                 "sort_by": sort_by,
@@ -88,6 +104,7 @@ def search_cli(
 
     try:
         response = ctx.obj["client"].search(
+            target,
             search_request=payload,
             check_request_payload=check_request_payload,
             raise_scim_errors=False,

{scim2_cli-0.4.1 → scim2_cli-0.5.0}/scim2_cli/utils.py

@@ -1,15 +1,21 @@
 import json
 import re
 from collections.abc import Callable
+from collections.abc import Mapping
 from enum import StrEnum
 from typing import Any
+from typing import TypeVar
+from typing import cast
 
 import click
+from click import ClickException
+from click.core import ParameterSource
 from scim2_client import SCIMClientException
 from scim2_models import BaseModel
 from scim2_models import Context
 from scim2_models import Mutability
 from scim2_models import Resource
+from scim2_models import ResourceType
 from scim2_models import SCIMException
 from sphinx_click.rst_to_ansi_formatter import RstToAnsiGroup
 
@@ -18,6 +24,34 @@ INDENTATION_SIZE = 4
 
 SCIM_EXCEPTIONS = (SCIMClientException, SCIMException)
 
+T = TypeVar("T")
+F = TypeVar("F", bound=Callable[..., Any])
+
+COMMAND_OPTIONS = {"me", "indent", "no-indent", "help"}
+
+
+def me_option(*param_decls: str) -> Callable[[F], F]:
+    """Add the --me option, with an optional parameter name."""
+    return click.option(
+        "--me",
+        *param_decls,
+        is_flag=True,
+        default=False,
+        help="Act on the resource of the authenticated client, under /Me (RFC 7644 §3.11).",
+    )
+
+
+def indent_option(*param_decls: str) -> Callable[[F], F]:
+    """Add the --indent option, with an optional parameter name."""
+    return click.option(
+        "--indent/--no-indent",
+        *param_decls,
+        is_flag=True,
+        default=True,
+        help="Indent JSON response payloads.",
+    )
+
+
 CONTROL_CHARACTERS = re.compile(
     "[\x00-\x08\x0b-\x1f\x7f-\x9f\u061c\u200e\u200f\u202a-\u202e\u2066-\u2069]"
 )
@@ -66,6 +100,31 @@ def escape_options_help(command: click.Command) -> click.Command:
     return command
 
 
+def command_name(resource_type: ResourceType) -> str:
+    """Name the commands acting on a resource type after its name, or else its id."""
+    return escape_control_characters(resource_type.name or resource_type.id).lower()
+
+
+def find_target(targets: Mapping[str, T], name: str) -> T:
+    """Find what a resource type argument designates, ignoring the case."""
+    try:
+        return targets[name.lower()]
+    except KeyError as exc:
+        ok_values = ", ".join(targets)
+        raise ClickException(
+            f"Unknown resource type '{escape_control_characters(name)}'. "
+            f"Available values are: {ok_values}"
+        ) from exc
+
+
+def inherited(ctx: click.Context, name: str, value: T) -> T:
+    """Read an option of a subcommand, or else the one passed to its parent command."""
+    parent = ctx.parent
+    if parent is None or ctx.get_parameter_source(name) is not ParameterSource.DEFAULT:
+        return value
+    return cast(T, parent.params[name])
+
+
 def formatted_payload(obj: Any, indent: bool) -> str:
     return json.dumps(obj, indent=INDENTATION_SIZE if indent else None)
 
@@ -82,14 +141,14 @@ def split_headers(headers: list[str]) -> dict[str, str]:
 
 
 class ModelCommand(RstToAnsiGroup):
-    """CLI commands that takes a model subcommand."""
+    """CLI commands that take a subcommand for each resource type."""
 
     base_url = DOC_URL
 
     def __init__(
         self,
         *args: Any,
-        factory: Callable[[type[Resource[Any]] | None], click.Command],
+        factory: Callable[[ResourceType, type[Resource[Any]]], click.Command],
         **kwargs: Any,
     ) -> None:
         super().__init__(*args, **kwargs)
@@ -98,12 +157,15 @@ class ModelCommand(RstToAnsiGroup):
     def list_commands(self, ctx: click.Context) -> list[str]:
         ctx.ensure_object(dict)
         base = super().list_commands(ctx)
-        lazy = sorted(ctx.obj.get("resource_models", {}).keys())
+        lazy = sorted(ctx.obj.get("resource_types", {}).keys())
         return base + lazy
 
-    def get_command(self, ctx: click.Context, cmd_name: str) -> click.Command:
-        model = ctx.obj["resource_models"].get(cmd_name)
-        return self.factory(model)
+    def get_command(self, ctx: click.Context, cmd_name: str) -> click.Command | None:
+        resource_type = ctx.obj["resource_types"].get(cmd_name.lower())
+        if resource_type is None:
+            return None
+        model = ctx.obj["client"].provider.model_for(resource_type)
+        return self.factory(resource_type, model)
 
 
 def is_field_acceptable(
@@ -144,6 +206,16 @@ def unacceptable_fields(context: Context, model: type[BaseModel]) -> list[str]:
     return excluded
 
 
+def renamed_fields(model: type[BaseModel], exclude: list[str]) -> dict[str, str]:
+    """Rename the options of the attributes that collide with the options of the command."""
+    return {
+        field_name: f"--{option}-attribute"
+        for field_name in model.model_fields
+        if field_name not in exclude
+        and (option := field_name.replace("_", "-")) in COMMAND_OPTIONS
+    }
+
+
 def exception_to_click_error(exception: Exception) -> click.ClickException:
     message = str(exception)
     if hasattr(exception, "__notes__"):