cmem-cmemc 25.5.0rc1__py3-none-any.whl → 26.1.0rc1__py3-none-any.whl

cmem_cmemc/completion.py

@@ -4,11 +4,13 @@
 import os
 import pathlib
 from collections import OrderedDict
+from collections.abc import Callable
 from contextlib import suppress
+from functools import wraps
 from typing import Any
 
 import requests.exceptions
-from click import Argument, ClickException, Context
+from click import Argument, Context
 from click.shell_completion import CompletionItem, split_arg_string
 from cmem.cmempy.dp.authorization.conditions import (
     fetch_all_acls,
@@ -31,7 +33,7 @@ from cmem.cmempy.workspace import (
 )
 from cmem.cmempy.workspace.projects.datasets.dataset import get_dataset
 from cmem.cmempy.workspace.projects.project import get_projects
-from cmem.cmempy.workspace.projects.resources import get_all_resources
+from cmem.cmempy.workspace.projects.resources import get_all_resources, get_resources
 from cmem.cmempy.workspace.projects.variables import get_all_variables
 from cmem.cmempy.workspace.python import list_packages
 from cmem.cmempy.workspace.search import list_items
@@ -39,6 +41,7 @@ from natsort import natsorted, ns
 
 from cmem_cmemc.constants import NS_ACL, NS_ACTION, NS_GROUP, NS_USER
 from cmem_cmemc.context import ApplicationContext
+from cmem_cmemc.exceptions import CmemcError
 from cmem_cmemc.placeholder import QueryPlaceholder, get_placeholders_for_query
 from cmem_cmemc.smart_path import SmartPath as Path
 from cmem_cmemc.utils import (
@@ -53,6 +56,43 @@ SORT_BY_KEY = 0
 SORT_BY_DESC = 1
 
 
+def suppress_completion_errors(
+    func: Callable[..., list[CompletionItem]],
+) -> Callable[..., list[CompletionItem]]:
+    """Safely handle errors in shell completion functions.
+
+    When shell completion encounters connection errors (server down, network issues, etc.),
+    this decorator catches specific exceptions and returns an empty list instead of
+    propagating the error to the terminal.
+
+    Currently catches:
+        - requests.exceptions.ConnectionError: Server connection failures
+
+    Usage:
+    ------
+        @suppress_completion_errors
+        def my_completion_func(ctx, param, incomplete):
+            # code that might fail (e.g., server calls)
+            return completion_items
+
+    Returns
+    -------
+        Wrapped function that returns [] on caught exceptions
+
+    """
+
+    @wraps(func)
+    def wrapper(*args, **kwargs) -> list[CompletionItem]:  # noqa: ANN002, ANN003
+        try:
+            return func(*args, **kwargs)
+        except requests.exceptions.ConnectionError:
+            # Silently fail during shell completion - return empty list
+            # This prevents error messages from appearing during tab completion
+            return []
+
+    return wrapper
+
+
 def finalize_completion(
     candidates: list,
     incomplete: str = "",
@@ -82,7 +122,7 @@ def finalize_completion(
 
     """
     if sort_by not in (SORT_BY_KEY, SORT_BY_DESC, NOT_SORTED):
-        raise ClickException("sort_by should be -1, 0 or 1.")
+        raise CmemcError("sort_by should be -1, 0 or 1.")
     incomplete = incomplete.lower()
     if len(candidates) == 0:
         return candidates
@@ -127,7 +167,7 @@ def finalize_completion(
             )
         return [CompletionItem(value=element[0], help=element[1]) for element in sorted_list]
 
-    raise ClickException(
+    raise CmemcError(
         "Candidates should be a list of strings or a list of tuples." f" Got {candidates}"
     )
 
@@ -160,6 +200,7 @@ def add_metadata_parameter(list_: list | None = None) -> list:
     return list_
 
 
+@suppress_completion_errors
 def acl_ids(ctx: Context, param: Argument, incomplete: str) -> list[CompletionItem]:
     """Prepare a list of access condition identifier"""
     ApplicationContext.set_connection_from_params(ctx.find_root().params)
@@ -174,6 +215,7 @@ def acl_ids(ctx: Context, param: Argument, incomplete: str) -> list[CompletionIt
     return finalize_completion(candidates=options, incomplete=incomplete, sort_by=SORT_BY_DESC)
 
 
+@suppress_completion_errors
 def acl_actions(ctx: Context, param: Argument, incomplete: str) -> list[CompletionItem]:
     """Prepare a list of access condition actions"""
     ApplicationContext.set_connection_from_params(ctx.find_root().params)
@@ -198,6 +240,7 @@ def acl_actions(ctx: Context, param: Argument, incomplete: str) -> list[Completi
     return finalize_completion(candidates=options, incomplete=incomplete, sort_by=SORT_BY_DESC)
 
 
+@suppress_completion_errors
 def acl_users(ctx: Context, param: Argument, incomplete: str) -> list[CompletionItem]:
     """Prepare a list of access condition users"""
     ApplicationContext.set_connection_from_params(ctx.find_root().params)
@@ -219,6 +262,7 @@ def acl_users(ctx: Context, param: Argument, incomplete: str) -> list[Completion
     return finalize_completion(candidates=options, incomplete=incomplete, sort_by=SORT_BY_DESC)
 
 
+@suppress_completion_errors
 def acl_groups(ctx: Context, param: Argument, incomplete: str) -> list[CompletionItem]:
     """Prepare a list of access condition groups"""
     ApplicationContext.set_connection_from_params(ctx.find_root().params)
@@ -267,6 +311,7 @@ def add_read_only_and_uri_property_parameters(list_: list | None = None) -> list
     return list_
 
 
+@suppress_completion_errors
 def dataset_parameter(ctx: Context, param: Argument, incomplete: str) -> list[CompletionItem]:
     """Prepare a list of dataset parameters for a dataset type."""
     ApplicationContext.set_connection_from_params(ctx.find_root().params)
@@ -317,6 +362,7 @@ def dataset_parameter(ctx: Context, param: Argument, incomplete: str) -> list[Co
     return [CompletionItem(value=option[0], help=option[1]) for option in options]
 
 
+@suppress_completion_errors
 def dataset_types(ctx: Context, param: Argument, incomplete: str) -> list[CompletionItem]:
     """Prepare a list of dataset types."""
     ApplicationContext.set_connection_from_params(ctx.find_root().params)
@@ -336,6 +382,7 @@ def dataset_types(ctx: Context, param: Argument, incomplete: str) -> list[Comple
     return finalize_completion(candidates=options, incomplete=incomplete, sort_by=SORT_BY_DESC)
 
 
+@suppress_completion_errors
 def dataset_ids(ctx: Context, param: Argument, incomplete: str) -> list[CompletionItem]:
     """Prepare a list of projectid:datasetid dataset identifier."""
     ApplicationContext.set_connection_from_params(ctx.find_root().params)
@@ -345,43 +392,19 @@ def dataset_ids(ctx: Context, param: Argument, incomplete: str) -> list[Completi
     return finalize_completion(candidates=options, incomplete=incomplete)
 
 
-def dataset_list_filter(ctx: Context, param: Argument, incomplete: str) -> list[CompletionItem]:
-    """Prepare a list of filter names and values for dataset list filter."""
-    filter_names = [
-        ("project", "Filter by project ID."),
-        ("regex", "Filter by regular expression on the dataset label."),
-        ("tag", "Filter by tag label."),
-        ("type", "Filter by dataset type."),
-    ]
-    filter_regex = [
-        ("^Final:", "Example: Dataset label starts with 'Final:'."),
-        (
-            r"[12][0-9][0-9][0-9]-[0-9][0-9]-[0-9][0-9]",
-            "Example: Dataset label contains a date-like string.",
-        ),
-    ]
-    options = []
-    args = get_completion_args(incomplete)
-    if args[len(args) - 1] == "--filter":
-        options = finalize_completion(candidates=filter_names, incomplete=incomplete)
-    if args[len(args) - 1] == "type":
-        options = dataset_types(ctx, param, incomplete)
-    if args[len(args) - 1] == "project":
-        options = project_ids(ctx, param, incomplete)
-    if args[len(args) - 1] == "tag":
-        options = tag_labels(ctx, param, incomplete, "dataset")
-    if args[len(args) - 1] == "regex":
-        options = finalize_completion(candidates=filter_regex, incomplete=incomplete)
-    return options
-
-
+@suppress_completion_errors
 def resource_ids(ctx: Context, param: Argument, incomplete: str) -> list[CompletionItem]:
     """Prepare a list of projectid:resourceid resource identifier."""
     ApplicationContext.set_connection_from_params(ctx.find_root().params)
-    options = [_["id"] for _ in get_all_resources()]
+    options = []
+    for _ in get_all_resources():
+        if check_option_in_params(_["id"], ctx.params.get(str(param.name))):
+            continue
+        options.append(_["id"])
     return finalize_completion(candidates=options, incomplete=incomplete, sort_by=SORT_BY_DESC)
 
 
+@suppress_completion_errors
 def scheduler_ids(ctx: Context, param: Argument, incomplete: str) -> list[CompletionItem]:
     """Prepare a list of projectid:schedulerid scheduler identifier."""
     ApplicationContext.set_connection_from_params(ctx.find_root().params)
@@ -417,11 +440,13 @@ def vocabularies(
     return finalize_completion(candidates=options, incomplete=incomplete, sort_by=SORT_BY_DESC)
 
 
+@suppress_completion_errors
 def installed_vocabularies(ctx: Context, param: Argument, incomplete: str) -> list[CompletionItem]:
     """Prepare a list of installed vocabulary graphs."""
     return vocabularies(ctx, param, incomplete, filter_="installed")
 
 
+@suppress_completion_errors
 def installable_vocabularies(
     ctx: Context, param: Argument, incomplete: str
 ) -> list[CompletionItem]:
@@ -444,6 +469,7 @@ def file_list(
     return finalize_completion(candidates=options, incomplete=incomplete, sort_by=SORT_BY_KEY)
 
 
+@suppress_completion_errors
 def workflow_io_ids(ctx: Context, param: Argument, incomplete: str) -> list[CompletionItem]:
     """Prepare a list of io workflows."""
     ApplicationContext.set_connection_from_params(ctx.find_root().params)
@@ -455,11 +481,13 @@ def workflow_io_ids(ctx: Context, param: Argument, incomplete: str) -> list[Comp
     return finalize_completion(candidates=options, incomplete=incomplete, sort_by=SORT_BY_DESC)
 
 
+@suppress_completion_errors
 def replay_files(ctx: Context, param: Argument, incomplete: str) -> list[CompletionItem]:
     """Prepare a list of JSON replay files."""
     return file_list(incomplete=incomplete, suffix=".json", description="JSON query replay file")
 
 
+@suppress_completion_errors
 def installed_package_names(ctx: Context, param: Argument, incomplete: str) -> list[CompletionItem]:
     """Prepare a list of installed packages."""
     ApplicationContext.set_connection_from_params(ctx.find_root().params)
@@ -467,6 +495,7 @@ def installed_package_names(ctx: Context, param: Argument, incomplete: str) -> l
     return finalize_completion(candidates=options, incomplete=incomplete, sort_by=SORT_BY_KEY)
 
 
+@suppress_completion_errors
 def published_package_names(ctx: Context, param: Argument, incomplete: str) -> list[CompletionItem]:
     """List of plugin packages scraped from pypi.org."""
     options = [(_.name, f"{_.version}: {_.description}") for _ in get_published_packages()]
@@ -483,6 +512,7 @@ def python_package_files(ctx: Context, param: Argument, incomplete: str) -> list
     )
 
 
+@suppress_completion_errors
 def installable_packages(ctx: Context, param: Argument, incomplete: str) -> list[CompletionItem]:
     """Installable packages from files and pypi.org."""
     return python_package_files(ctx, param, incomplete) + published_package_names(
@@ -490,6 +520,7 @@ def installable_packages(ctx: Context, param: Argument, incomplete: str) -> list
     )
 
 
+@suppress_completion_errors
 def workflow_io_output_files(
     ctx: Context, param: Argument, incomplete: str
 ) -> list[CompletionItem]:
@@ -504,6 +535,7 @@ def workflow_io_output_files(
     )
 
 
+@suppress_completion_errors
 def workflow_io_input_files(ctx: Context, param: Argument, incomplete: str) -> list[CompletionItem]:
     """Prepare a list of acceptable workflow io input files."""
     files = []
@@ -548,6 +580,7 @@ def get_dataset_file_mapping() -> dict[str, dict[str, str]]:
     }
 
 
+@suppress_completion_errors
 def dataset_files(ctx: Context, param: Argument, incomplete: str) -> list[CompletionItem]:
     """Prepare a list of dataset files."""
     files = []
@@ -570,6 +603,7 @@ def dataset_files(ctx: Context, param: Argument, incomplete: str) -> list[Comple
     return files + filtered_multicsv
 
 
+@suppress_completion_errors
 def project_files(ctx: Context, param: Argument, incomplete: str) -> list[CompletionItem]:
     """Prepare a list of workspace files."""
     return file_list(
@@ -579,11 +613,23 @@ def project_files(ctx: Context, param: Argument, incomplete: str) -> list[Comple
     )
 
 
+@suppress_completion_errors
 def ini_files(ctx: Context, param: Argument, incomplete: str) -> list[CompletionItem]:
     """Prepare a list of workspace files."""
     return file_list(incomplete=incomplete, suffix=".ini", description="INI file")
 
 
+@suppress_completion_errors
+def acl_files(ctx: Context, param: Argument, incomplete: str) -> list[CompletionItem]:
+    """Prepare a list of ACL files."""
+    return file_list(
+        incomplete=incomplete,
+        suffix=".acls.json",
+        description="eccenca Corporate Memory ACL backup file",
+    )
+
+
+@suppress_completion_errors
 def workspace_files(ctx: Context, param: Argument, incomplete: str) -> list[CompletionItem]:
     """Prepare a list of workspace files."""
     return file_list(
@@ -600,6 +646,7 @@ def sparql_files(ctx: Context, param: Argument, incomplete: str) -> list[Complet
     ) + file_list(incomplete=incomplete, suffix=".rq", description="SPARQL query file")
 
 
+@suppress_completion_errors
 def triple_files(ctx: Context, param: Argument, incomplete: str) -> list[CompletionItem]:
     """Prepare a list of triple files."""
     return (
@@ -620,6 +667,7 @@ def triple_files(ctx: Context, param: Argument, incomplete: str) -> list[Complet
     )
 
 
+@suppress_completion_errors
 def sparql_accept_types(ctx: Context, param: Argument, incomplete: str) -> list[CompletionItem]:
     """Prepare a list of commonly used SPARQL accept content types."""
     examples = [
@@ -634,6 +682,7 @@ def sparql_accept_types(ctx: Context, param: Argument, incomplete: str) -> list[
     return finalize_completion(candidates=examples, incomplete=incomplete)
 
 
+@suppress_completion_errors
 def placeholder(ctx: Context, param: Argument, incomplete: str) -> list[CompletionItem]:
     """Prepare a list of placeholder from the to-be executed queries."""
     args = get_completion_args(incomplete)
@@ -683,6 +732,7 @@ def remote_queries(ctx: Context, param: Argument, incomplete: str) -> list[Compl
     return finalize_completion(candidates=options, incomplete=incomplete, sort_by=SORT_BY_DESC)
 
 
+@suppress_completion_errors
 def remote_queries_and_sparql_files(
     ctx: Context, param: Argument, incomplete: str
 ) -> list[CompletionItem]:
@@ -692,6 +742,7 @@ def remote_queries_and_sparql_files(
     return remote + files
 
 
+@suppress_completion_errors
 def workflow_ids(ctx: Context, param: Argument, incomplete: str) -> list[CompletionItem]:
     """Prepare a list of projectid:taskid workflow identifier."""
     ApplicationContext.set_connection_from_params(ctx.find_root().params)
@@ -706,6 +757,7 @@ def workflow_ids(ctx: Context, param: Argument, incomplete: str) -> list[Complet
     return finalize_completion(candidates=options, incomplete=incomplete, sort_by=SORT_BY_DESC)
 
 
+@suppress_completion_errors
 def marshalling_plugins(ctx: Context, param: Argument, incomplete: str) -> list[CompletionItem]:
     """Prepare a list of supported workspace/project import/export plugins."""
     ApplicationContext.set_connection_from_params(ctx.find_root().params)
@@ -721,6 +773,7 @@ def marshalling_plugins(ctx: Context, param: Argument, incomplete: str) -> list[
     )
 
 
+@suppress_completion_errors
 def project_ids(ctx: Context, param: Argument, incomplete: str) -> list[CompletionItem]:
     """Prepare a list of project IDs for auto-completion."""
     ApplicationContext.set_connection_from_params(ctx.find_root().params)
@@ -728,7 +781,7 @@ def project_ids(ctx: Context, param: Argument, incomplete: str) -> list[Completi
     options = []
     for _ in projects:
         project_id = _["name"]
-        label = _["metaData"]["label"]
+        label = _["metaData"].get("label", "")
         # do not add project if already in the command line
         if check_option_in_params(project_id, ctx.params.get(str(param.name))):
             continue
@@ -757,6 +810,7 @@ def _prepare_graph_options(
     return options
 
 
+@suppress_completion_errors
 def graph_uris_skip_check(
     ctx: Context, param: Argument, incomplete: str, writeable: bool = True, readonly: bool = True
 ) -> list[CompletionItem]:
@@ -767,6 +821,7 @@ def graph_uris_skip_check(
     return finalize_completion(candidates=options, incomplete=incomplete, sort_by=SORT_BY_DESC)
 
 
+@suppress_completion_errors
 def graph_uris(
     ctx: Context, param: Argument, incomplete: str, writeable: bool = True, readonly: bool = True
 ) -> list[CompletionItem]:
@@ -775,6 +830,7 @@ def graph_uris(
     return finalize_completion(candidates=options, incomplete=incomplete, sort_by=SORT_BY_DESC)
 
 
+@suppress_completion_errors
 def ignore_graph_uris(ctx: Context, param: Argument, incomplete: str) -> list[CompletionItem]:
     """Prepare a list of import graphs for auto-completion."""
     data_graph = ctx.args[0]
@@ -785,11 +841,13 @@ def ignore_graph_uris(ctx: Context, param: Argument, incomplete: str) -> list[Co
     return finalize_completion(candidates=options, incomplete=incomplete, sort_by=SORT_BY_DESC)
 
 
+@suppress_completion_errors
 def writable_graph_uris(ctx: Context, param: Argument, incomplete: str) -> list[CompletionItem]:
     """Prepare a list of writable graphs for auto-completion."""
     return graph_uris(ctx, param, incomplete, writeable=True, readonly=False)
 
 
+@suppress_completion_errors
 def graph_uris_with_all_graph_uri(
     ctx: Context, param: Argument, incomplete: str
 ) -> list[CompletionItem]:
@@ -806,6 +864,7 @@ def graph_uris_with_all_graph_uri(
     return options
 
 
+@suppress_completion_errors
 def connections(ctx: Context, param: Argument, incomplete: str) -> list[CompletionItem]:
     """Prepare a list of config connections for auto-completion."""
     # since ctx does not have an obj here, we re-create the object
@@ -814,6 +873,7 @@ def connections(ctx: Context, param: Argument, incomplete: str) -> list[Completi
     return finalize_completion(candidates=options, incomplete=incomplete)
 
 
+@suppress_completion_errors
 def graph_export_templates(ctx: Context, param: Argument, incomplete: str) -> list[CompletionItem]:
     """Prepare a list of example templates for the graph export command."""
     examples = [
@@ -828,6 +888,7 @@ def graph_export_templates(ctx: Context, param: Argument, incomplete: str) -> li
     return finalize_completion(candidates=examples, incomplete=incomplete)
 
 
+@suppress_completion_errors
 def project_export_templates(
     ctx: Context, param: Argument, incomplete: str
 ) -> list[CompletionItem]:
@@ -840,6 +901,7 @@ def project_export_templates(
     return finalize_completion(candidates=examples, incomplete=incomplete)
 
 
+@suppress_completion_errors
 def workspace_export_templates(
     ctx: Context, param: Argument, incomplete: str
 ) -> list[CompletionItem]:
@@ -852,30 +914,7 @@ def workspace_export_templates(
     return finalize_completion(candidates=examples, incomplete=incomplete)
 
 
-def graph_list_filter(ctx: Context, param: Argument, incomplete: str) -> list[CompletionItem]:
-    """Prepare a list of filter names and values for graph list filter."""
-    filter_names = [
-        (
-            "access",
-            "List only graphs which have a certain access condition " "(readonly or writeable).",
-        ),
-        ("imported-by", "List only graphs which are in the import tree of a " "specified graph."),
-    ]
-    filter_values_access = [
-        ("readonly", "List only graphs which are NOT writable for the current user."),
-        ("writeable", "List only graphs which ARE writeable for the current user."),
-    ]
-    args = get_completion_args(incomplete)
-    options = []
-    if args[len(args) - 1] == "--filter":
-        options = finalize_completion(candidates=filter_names, incomplete=incomplete)
-    if args[len(args) - 1] == "access":
-        options = finalize_completion(candidates=filter_values_access, incomplete=incomplete)
-    if args[len(args) - 1] == "imported-by":
-        options = graph_uris(ctx, param, incomplete)
-    return options
-
-
+@suppress_completion_errors
 def variable_ids(ctx: Context, param: Argument, incomplete: str) -> list[CompletionItem]:
     """Prepare a list of variables IDs for auto-completion."""
     ApplicationContext.set_connection_from_params(ctx.find_root().params)
@@ -893,55 +932,7 @@ def variable_ids(ctx: Context, param: Argument, incomplete: str) -> list[Complet
     return finalize_completion(candidates=options, incomplete=incomplete, sort_by=SORT_BY_KEY)
 
 
-def variable_list_filter(ctx: Context, param: Argument, incomplete: str) -> list[CompletionItem]:
-    """Prepare a list of filter names and values for variable list filter."""
-    filter_names = [
-        ("project", "Filter for variables from a specific project."),
-        (
-            "regex",
-            "Filter for variables with a regular expression search over "
-            "id, value and description.",
-        ),
-    ]
-    filter_values_regex = [
-        ("ending$", "Variables name ends with 'ending'."),
-        ("^starting", "Variables name starts with 'starting'."),
-    ]
-    args = get_completion_args(incomplete)
-    if args[len(args) - 1] == "--filter":
-        return [CompletionItem(value=f[0], help=f[1]) for f in filter_names]
-    if args[len(args) - 1] == "regex":
-        return finalize_completion(candidates=filter_values_regex, incomplete=incomplete)
-    if args[len(args) - 1] == "project":
-        return project_ids(ctx, param, incomplete)
-    return []
-
-
-def resource_list_filter(ctx: Context, param: Argument, incomplete: str) -> list[CompletionItem]:
-    """Prepare a list of filter names and values for resource list filter."""
-    filter_names = [
-        ("project", "Filter for file resources from a specific project."),
-        (
-            "regex",
-            "Filter for file resources with a regular expression search on " "the name field.",
-        ),
-    ]
-    filter_values_regex = [
-        ("csv$", "File resources which name ends with .csv"),
-        ("2021-10-[0-9][0-9]", "File resources which name has a date from 2021-10 in it"),
-    ]
-    args = get_completion_args(incomplete)
-    if args[len(args) - 1] == "--filter":
-        return [CompletionItem(value=f[0], help=f[1]) for f in filter_names]
-    if args[len(args) - 1] == "project":
-        return finalize_completion(
-            candidates=project_ids(ctx, param, incomplete), incomplete=incomplete
-        )
-    if args[len(args) - 1] == "regex":
-        return finalize_completion(candidates=filter_values_regex, incomplete=incomplete)
-    return []
-
-
+@suppress_completion_errors
 def workflow_list_filter(ctx: Context, param: Argument, incomplete: str) -> list[CompletionItem]:
     """Prepare a list of filter names and values for workflow list filter."""
     filter_names = [
@@ -979,6 +970,7 @@ def workflow_list_filter(ctx: Context, param: Argument, incomplete: str) -> list
     return finalize_completion(candidates=options, incomplete=incomplete)
 
 
+@suppress_completion_errors
 def tag_labels(
     ctx: Context, param: Argument, incomplete: str, item_type: str
 ) -> list[CompletionItem]:
@@ -999,6 +991,7 @@ def tag_labels(
     )
 
 
+@suppress_completion_errors
 def status_keys(ctx: Context, param: Argument, incomplete: str) -> list[CompletionItem]:
     """Prepare a list of status keys for the admin status command."""
     os.environ["CMEMPY_IS_CHATTY"] = "false"
@@ -1008,6 +1001,7 @@ def status_keys(ctx: Context, param: Argument, incomplete: str) -> list[Completi
     return finalize_completion(candidates=options, incomplete=incomplete)
 
 
+@suppress_completion_errors
 def user_ids(ctx: Context, param: Argument, incomplete: str) -> list[CompletionItem]:
     """Prepare a list of username for admin update/delete/password command."""
     ApplicationContext.set_connection_from_params(ctx.find_root().params)
@@ -1015,6 +1009,7 @@ def user_ids(ctx: Context, param: Argument, incomplete: str) -> list[CompletionI
     return finalize_completion(candidates=options, incomplete=incomplete, sort_by=SORT_BY_DESC)
 
 
+@suppress_completion_errors
 def user_group_ids(ctx: Context, param: Argument, incomplete: str) -> list[CompletionItem]:
     """Prepare a list of group name for admin user update --(un)assign-group parameter"""
     ApplicationContext.set_connection_from_params(ctx.find_root().params)
@@ -1041,6 +1036,7 @@ def user_group_ids(ctx: Context, param: Argument, incomplete: str) -> list[Compl
     return finalize_completion(candidates=options, incomplete=incomplete, sort_by=SORT_BY_DESC)
 
 
+@suppress_completion_errors
 def client_ids(ctx: Context, param: Argument, incomplete: str) -> list[CompletionItem]:
     """Prepare a list of client ids for admin secret and update command."""
     ApplicationContext.set_connection_from_params(ctx.find_root().params)
@@ -1048,6 +1044,7 @@ def client_ids(ctx: Context, param: Argument, incomplete: str) -> list[Completio
     return finalize_completion(candidates=options, incomplete=incomplete, sort_by=SORT_BY_DESC)
 
 
+@suppress_completion_errors
 def transformation_task_ids(ctx: Context, param: Argument, incomplete: str) -> list[CompletionItem]:
     """Prepare a list of projectId:transformation task identifier."""
     ApplicationContext.set_connection_from_params(ctx.find_root().params)
@@ -1055,3 +1052,23 @@ def transformation_task_ids(ctx: Context, param: Argument, incomplete: str) -> l
     datasets = results["results"]
     options = [(f"{_['projectId']}:{_['id']}", _["label"]) for _ in datasets]
     return finalize_completion(candidates=options, incomplete=incomplete, sort_by=SORT_BY_DESC)
+
+
+@suppress_completion_errors
+def resource_paths(ctx: Context, param: Argument, incomplete: str) -> list[CompletionItem]:
+    """Prepare a list of file resource paths within a project.
+
+    Returns the full path of file resources (not including the project ID prefix).
+    If a project_id is available in context, lists resources from that project.
+    If only one project exists, automatically uses that project.
+    """
+    ApplicationContext.set_connection_from_params(ctx.find_root().params)
+    project_id = ctx.params.get("project_id")
+    if not project_id:
+        projects = get_projects()
+        if len(projects) == 1:
+            project_id = projects[0]["name"]
+    if project_id is None:
+        return []
+    options = [_["fullPath"] for _ in list(get_resources(project_id))]
+    return finalize_completion(candidates=options, incomplete=incomplete, sort_by=SORT_BY_DESC)