cmem-cmemc 25.6.0__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,
@@ -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)
@@ -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,53 +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 project_ids(ctx, param, 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 = [
@@ -977,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]:
@@ -997,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"
@@ -1006,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)
@@ -1013,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)
@@ -1039,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)
@@ -1046,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,6 +1054,7 @@ def transformation_task_ids(ctx: Context, param: Argument, incomplete: str) -> l
     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.
 

cmem_cmemc/context.py

@@ -15,7 +15,9 @@ from shutil import which
 import click
 import cmem.cmempy.config as cmempy_config
 import urllib3
+from cmem.cmempy.config import get_cmem_base_uri
 from cmem.cmempy.health import get_di_version, get_explore_version
+from cmem_client.client import Client
 from pygments import highlight
 from pygments.formatters import get_formatter_by_name
 from pygments.lexers import get_lexer_by_name
@@ -55,6 +57,34 @@ KNOWN_SECRET_KEYS = ("OAUTH_PASSWORD", "OAUTH_CLIENT_SECRET", "OAUTH_ACCESS_TOKE
 SSL_VERIFY_WARNING = "SSL verification is disabled (SSL_VERIFY=False)."
 
 
+def build_caption(
+    count: int,
+    item_name: str,
+    instance: str | None = None,
+    filtered: bool = False,
+    plural: str | None = None,
+) -> str:
+    """Build a standardized caption for table outputs.
+
+    Args:
+    ----
+        count: Number of items in the table
+        item_name: Name of the items (e.g., "file", "project", "query")
+        instance: Instance URI (if None, uses get_cmem_base_uri())
+        filtered: Whether the results are filtered
+        plural: Optional Plural form of the item_name (e.g. "queries"), with giving
+                a plural form, simply a 's' is added for plural.
+
+    Returns:
+    -------
+        Caption string in format: "X thing(s) of INSTANCE (filtered)"
+
+    """
+    term = (plural if plural else f"{item_name}s") if count != 1 else item_name
+    base = f"{count} {term} of {instance or get_cmem_base_uri()}"
+    return f"{base} (filtered)" if filtered else base
+
+
 class ApplicationContext:
     """Context of the command line interface."""
 
@@ -72,9 +102,6 @@ class ApplicationContext:
     console: Console
     console_width: int | None = None
 
-    # pylint: disable=too-many-instance-attributes
-    # pylint: disable=too-many-public-methods
-
     def __init__(
         self,
         config_file: str,
@@ -93,6 +120,11 @@ class ApplicationContext:
         self.console = Console(markup=True, emoji_variant="emoji")
         self.update_console_width()
 
+    @property
+    def client(self) -> Client:
+        """The cmem_client Client object."""
+        return Client.from_cmempy()
+
     @staticmethod
     def from_params(params: dict) -> "ApplicationContext":
         """Create an ApplicationContext instance from a dictionary.
@@ -273,9 +305,9 @@ class ApplicationContext:
             return
         if section_string not in self.get_config():
             raise InvalidConfigurationError(
-                self,
                 f"There is no connection '{section_string}' configured in "
                 f"config '{self.config_file}'.",
+                app=self,
             )
         self.connection = section_string
 
@@ -294,10 +326,10 @@ class ApplicationContext:
             config.read(self.get_config_file(), encoding="utf-8")
         except configparser.Error as error:
             raise InvalidConfigurationError(
-                self,
                 "The following config parser error needs to be fixed with your config file:\n"
                 f"{error!s}\n"
                 "You can use the 'config edit' command to fix this.",
+                app=self,
             ) from error
         except Exception as error:  # noqa: BLE001
             self.echo_debug(f"Could not read config file - provide empty config: {error!s}")
@@ -337,7 +369,6 @@ class ApplicationContext:
         2024-05-17: also allows list of strings now
         2024-05-17: new prepend_line parameter
         """
-        # pylint: disable=invalid-name
         click.echo("") if prepend_line is True else None
         messages: list[str] = [message] if isinstance(message, str) else message
         for _ in messages:
@@ -434,6 +465,7 @@ class ApplicationContext:
         )
         if caption is not None:
             table.caption = caption
+            table.min_width = len(caption)
         for header in headers:
             table.add_column(header, overflow="fold")
         for row_source in rows:
@@ -450,13 +482,11 @@ class ApplicationContext:
 
     def echo_success(self, message: str, nl: bool = True, condition: bool = True) -> None:
         """Output success message, if not suppressed by --quiet."""
-        # pylint: disable=invalid-name
         self.echo_info(message, fg="green", nl=nl, condition=condition)
 
     @staticmethod
     def echo_result(message: str, nl: bool = True) -> None:
         """Output result message, can NOT be suppressed by --quiet."""
-        # pylint: disable=invalid-name
         click.echo(message, nl=nl)
 
     def check_concrete_version(self, name: str, version: str, target_version: str) -> None: