cmem-cmemc 25.3.0__py3-none-any.whl → 25.4.0__py3-none-any.whl

cmem_cmemc/commands/query.py

@@ -10,8 +10,8 @@ from time import sleep, time
 from uuid import uuid4
 
 import click
-from click import ClickException, UsageError
 from click.shell_completion import CompletionItem
+from cmem.cmempy.config import get_cmem_base_uri
 from cmem.cmempy.queries import (
     QueryCatalog,
     SparqlQuery,
@@ -91,12 +91,12 @@ class ReplayStatistics:
                 iri = query_["iri"]
                 catalog_entry = self.catalog.get_query(iri)
                 if catalog_entry is None:
-                    raise ClickException(f"measure_query - query {iri} is not in catalog.")
+                    raise click.ClickException(f"measure_query - query {iri} is not in catalog.")
                 return catalog_entry
             query_string = query_["queryString"]
             return SparqlQuery(text=query_string)
         except KeyError as error:
-            raise ClickException(
+            raise click.ClickException(
                 "measure_query - given input dict has no queryString key."
             ) from error
 
@@ -330,6 +330,13 @@ def _output_query_status_details(app: ApplicationContext, status_dict: dict) ->
 
 
 @click.command(cls=CmemcCommand, name="list")
+@click.option(
+    "--catalog-graph",
+    default="https://ns.eccenca.com/data/queries/",
+    show_default=True,
+    shell_complete=completion.graph_uris,
+    help="The used query catalog graph.",
+)
 @click.option(
     "--id-only",
     is_flag=True,
@@ -337,13 +344,13 @@ def _output_query_status_details(app: ApplicationContext, status_dict: dict) ->
     "This is useful for piping the ids into other cmemc commands.",
 )
 @click.pass_obj
-def list_command(app: ApplicationContext, id_only: bool) -> None:
+def list_command(app: ApplicationContext, catalog_graph: str, id_only: bool) -> None:
     """List available queries from the catalog.
 
     Outputs a list of query URIs which can be used as reference for
     the query execute command.
     """
-    queries = QueryCatalog().get_queries().items()
+    queries = QueryCatalog(graph=catalog_graph).get_queries().items()
     if id_only:
         # sort dict by short_url - https://docs.python.org/3/howto/sorting.html
         for _, sparql_query in sorted(queries, key=lambda k: k[1].short_url.lower()):
@@ -359,7 +366,12 @@ def list_command(app: ApplicationContext, id_only: bool) -> None:
             ]
             table.append(row)
         app.echo_info_table(
-            table, headers=["Query URI", "Type", "Placeholder", "Label"], sort_column=3
+            table,
+            headers=["Query URI", "Type", "Placeholder", "Label"],
+            sort_column=3,
+            empty_table_message="There are no query available in the "
+            f"selected catalog ({catalog_graph}).",
+            caption=f"Queries from {catalog_graph} ({get_cmem_base_uri()})",
         )
 
 
@@ -367,6 +379,13 @@ def list_command(app: ApplicationContext, id_only: bool) -> None:
 @click.argument(
     "QUERIES", nargs=-1, required=True, shell_complete=completion.remote_queries_and_sparql_files
 )
+@click.option(
+    "--catalog-graph",
+    default="https://ns.eccenca.com/data/queries/",
+    show_default=True,
+    shell_complete=completion.graph_uris,
+    help="The used query catalog graph.",
+)
 @click.option(
     "--accept",
     default="default",
@@ -420,6 +439,7 @@ def list_command(app: ApplicationContext, id_only: bool) -> None:
 def execute_command(  # noqa: PLR0913
     app: ApplicationContext,
     queries: tuple[str, ...],
+    catalog_graph: str,
     accept: str,
     no_imports: bool,
     base64: bool,
@@ -453,9 +473,14 @@ def execute_command(  # noqa: PLR0913
     app.echo_debug("Parameter: " + str(placeholder))
     for file_or_uri in queries:
         app.echo_debug(f"Start of execution: {file_or_uri} with " f"placeholder {placeholder}")
-        executed_query: SparqlQuery = QueryCatalog().get_query(file_or_uri, placeholder=placeholder)
+        executed_query: SparqlQuery = QueryCatalog(graph=catalog_graph).get_query(
+            file_or_uri, placeholder=placeholder
+        )
         if executed_query is None:
-            raise ClickException(f"{file_or_uri} is neither a (readable) file nor a query URI.")
+            raise click.UsageError(
+                f"{file_or_uri} is neither a (readable) file nor "
+                f"a query URI in the catalog graph {catalog_graph}"
+            )
         app.echo_debug(
             f"Execute ({executed_query.query_type}): "
             f"{executed_query.label} < {executed_query.url}"
@@ -499,8 +524,15 @@ def execute_command(  # noqa: PLR0913
 @click.argument(
     "QUERIES", nargs=-1, required=True, shell_complete=completion.remote_queries_and_sparql_files
 )
+@click.option(
+    "--catalog-graph",
+    default="https://ns.eccenca.com/data/queries/",
+    show_default=True,
+    shell_complete=completion.graph_uris,
+    help="The used query catalog graph.",
+)
 @click.pass_obj
-def open_command(app: ApplicationContext, queries: tuple[str, ...]) -> None:
+def open_command(app: ApplicationContext, queries: tuple[str, ...], catalog_graph: str) -> None:
     """Open queries in the editor of the query catalog in your browser.
 
     With this command, you can open (remote) queries from the query catalog in
@@ -512,10 +544,13 @@ def open_command(app: ApplicationContext, queries: tuple[str, ...]) -> None:
     opening multiple browser tabs.
     """
     for file_or_uri in queries:
-        opened_query = QueryCatalog().get_query(file_or_uri)
+        opened_query = QueryCatalog(graph=catalog_graph).get_query(file_or_uri)
         if opened_query is None:
-            raise ClickException(f"{file_or_uri} is neither a (readable) file nor a query URI.")
-        open_query_uri = opened_query.get_editor_url()
+            raise click.UsageError(
+                f"{file_or_uri} is neither a (readable) file nor "
+                f"a query URI in the catalog graph {catalog_graph}"
+            )
+        open_query_uri = opened_query.get_editor_url(graph=catalog_graph)
         app.echo_debug(f"Open {file_or_uri}: {open_query_uri}")
         click.launch(open_query_uri)
 
@@ -571,7 +606,7 @@ def status_command(
         queries = query_status_list.apply_filters(ctx=ctx, filter_=filter_)
 
     if query_id and len(queries) == 0:
-        raise UsageError(f"Query with ID '{query_id}' does not exist (anymore).")
+        raise click.UsageError(f"Query with ID '{query_id}' does not exist (anymore).")
 
     if raw:
         app.echo_info_json(queries)
@@ -666,14 +701,14 @@ def replay_command(  # noqa: PLR0913
     other data.
     """
     if loops <= 0:
-        raise UsageError("Please set a positive loops integer value (>=1).")
+        raise click.UsageError("Please set a positive loops integer value (>=1).")
     try:
         with Path(replay_file).open(encoding="utf8") as _:
             input_queries = load(_)
     except JSONDecodeError as error:
-        raise ClickException(f"File {replay_file} is not a valid JSON document.") from error
+        raise click.ClickException(f"File {replay_file} is not a valid JSON document.") from error
     if len(input_queries) == 0:
-        raise ClickException(f"File {replay_file} contains no queries.")
+        raise click.ClickException(f"File {replay_file} contains no queries.")
     app.echo_debug(f"File {replay_file} contains {len(input_queries)} queries.")
 
     statistic = ReplayStatistics(app=app, label=run_label)

cmem_cmemc/commands/store.py

@@ -10,6 +10,7 @@ from cmem.cmempy.dp.admin import create_showcase_data, delete_bootstrap_data, im
 from cmem.cmempy.dp.admin.backup import get_zip, post_zip
 from cmem.cmempy.dp.workspace import migrate_workspaces
 from cmem.cmempy.health import get_dp_info
+from cmem.cmempy.workspace import reload_workspace
 from jinja2 import Template
 
 from cmem_cmemc.command import CmemcCommand
@@ -53,7 +54,7 @@ def bootstrap_command(app: ApplicationContext, import_: bool, remove: bool) -> N
 
     Note: The import part of this command is equivalent to the 'bootstrap-data' migration recipe
     """
-    if import_ and remove or not import_ and not remove:
+    if (import_ and remove) or (not import_ and not remove):
         raise UsageError("Either use the --import or the --remove option.")
     if import_:
         app.echo_info("Update or import bootstrap data ... ", nl=False)
@@ -99,12 +100,15 @@ def showcase_command(app: ApplicationContext, scale: int, create: bool, delete:
         raise UsageError("Either use the --create or the --delete flag.")
     if delete:
         raise NotImplementedError(
-            "This feature is not implemented yet. " "Please delete the graphs manually."
+            "This feature is not implemented yet. Please delete the graphs manually."
         )
     if create:
         app.echo_info(f"Create showcase data with scale factor {scale} ... ", nl=False)
         create_showcase_data(scale_factor=scale)
         app.echo_success("done")
+        app.echo_info("Reload workspace  ... ", nl=False)
+        reload_workspace()
+        app.echo_success("done")
 
 
 @click.command(cls=CmemcCommand, name="export")

cmem_cmemc/completion.py

@@ -643,10 +643,11 @@ def placeholder(ctx: Context, param: Argument, incomplete: str) -> list[Completi
     args = get_completion_args(incomplete)
     # setup configuration
     ApplicationContext.set_connection_from_params(ctx.find_root().params)
+    catalog_graph = ctx.params.get("catalog_graph")
     # extract placeholder from given queries in the command line
     options = []
     placeholders: dict[str, QueryPlaceholder] = {}
-    catalog = QueryCatalog()  # fetch all queries
+    catalog = QueryCatalog(graph=catalog_graph) if catalog_graph else QueryCatalog()
     for _, arg in enumerate(args):
         query = catalog.get_query(arg)
         if query is not None:
@@ -654,7 +655,7 @@ def placeholder(ctx: Context, param: Argument, incomplete: str) -> list[Completi
             placeholders = placeholders | get_placeholders_for_query(iri=query.url)
             # collect all placeholder keys
             options.extend(list(query.get_placeholder_keys()))
-    # look if cursor is in value position of the -p option and
+    # look if the cursor is in value position of the -p option and
     # use placeholder value completion, in case it is
     if args[len(args) - 2] in ("-p", "--parameter"):
         key = args[len(args) - 1]
@@ -676,8 +677,10 @@ def placeholder(ctx: Context, param: Argument, incomplete: str) -> list[Completi
 def remote_queries(ctx: Context, param: Argument, incomplete: str) -> list[CompletionItem]:
     """Prepare a list of query URIs."""
     ApplicationContext.set_connection_from_params(ctx.find_root().params)
+    catalog_graph = ctx.params.get("catalog_graph")
+    catalog = QueryCatalog(graph=catalog_graph) if catalog_graph else QueryCatalog()
     options = []
-    for query in QueryCatalog().get_queries().values():
+    for query in catalog.get_queries().values():
         url = query.short_url
         label = query.label
         options.append((url, label))

cmem_cmemc/context.py

@@ -29,9 +29,9 @@ from cmem_cmemc.exceptions import InvalidConfigurationError
 from cmem_cmemc.string_processor import StringProcessor, process_row
 from cmem_cmemc.utils import is_enabled, str_to_bool
 
-DI_TARGET_VERSION = "v25.1.0"
+DI_TARGET_VERSION = "v25.2.0"
 
-EXPLORE_TARGET_VERSION = "v25.1.0"
+EXPLORE_TARGET_VERSION = "v25.2.0"
 
 KNOWN_CONFIG_KEYS = {
     "CMEM_BASE_URI": cmempy_config.get_cmem_base_uri,

cmem_cmemc/manual_helper/multi_page.py

@@ -31,6 +31,7 @@ def get_icon_for_command_group(full_name: str) -> str:
         "project variable": "material/variable-box",
         "query": "eccenca/application-queries",
         "graph": "eccenca/artefact-dataset-eccencadataplatform",
+        "graph imports": "material/family-tree",
         "graph validation": "octicons/verified-16",
         "vocabulary": "eccenca/application-vocabularies",
         "vocabulary cache": "eccenca/application-vocabularies",
@@ -58,6 +59,7 @@ def get_tags_for_command_group(full_name: str) -> str:
         "project variable": ["Variables", "cmemc"],
         "query": ["SPARQL", "cmemc"],
         "graph": ["KnowledgeGraph", "cmemc"],
+        "graph imports": ["KnowledgeGraph", "cmemc"],
         "graph validation": ["KnowledgeGraph", "Validation", "cmemc"],
         "vocabulary": ["Vocabulary", "cmemc"],
         "vocabulary cache": ["Vocabulary", "cmemc"],

{cmem_cmemc-25.3.0.dist-info → cmem_cmemc-25.4.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: cmem-cmemc
-Version: 25.3.0
+Version: 25.4.0
 Summary: Command line client for eccenca Corporate Memory
 License: Apache-2.0
 Author: eccenca
@@ -30,7 +30,7 @@ Requires-Dist: certifi (>=2024.2.2)
 Requires-Dist: click (>=8.1.8,<8.2.0)
 Requires-Dist: click-didyoumean (>=0.3.1,<0.4.0)
 Requires-Dist: click-help-colors (>=0.9.4,<0.10.0)
-Requires-Dist: cmem-cmempy (==25.2.0)
+Requires-Dist: cmem-cmempy (==25.3.0)
 Requires-Dist: configparser (>=7.2.0,<8.0.0)
 Requires-Dist: jinja2 (>=3.1.6,<4.0.0)
 Requires-Dist: junit-xml (>=1.9,<2.0)

{cmem_cmemc-25.3.0.dist-info → cmem_cmemc-25.4.0.dist-info}/RECORD

@@ -16,24 +16,24 @@ cmem_cmemc/commands/metrics.py,sha256=pIBRTq90f7MEI99HLdFLN3D1xQ2Z2u6VKUeTIz0X7D
 cmem_cmemc/commands/migration.py,sha256=y9v4Be7WELGjDGDBZrfLBeqU_G_JH1fnP5UVG9qjB3g,9638
 cmem_cmemc/commands/project.py,sha256=zHqs7XBsRjzTO6EGxaN_TgZ_rsqyIPF59aObuMhsfmA,20593
 cmem_cmemc/commands/python.py,sha256=7ExdKr7nTED5ZZGjeBk5UngNI3F_KNcavwUgwaxApV0,11965
-cmem_cmemc/commands/query.py,sha256=XtWZHu7BhQfAHEh3gbFTeJwI88mUhHFvMCyrFRVVSVs,27601
+cmem_cmemc/commands/query.py,sha256=etDC1Vg9W1eu5qYuWABozzRZFBW4i0N0Gmiu_rNPgWo,28801
 cmem_cmemc/commands/resource.py,sha256=74cn_yqMv3a6xOQAPpNCuluTWEH-_2PGENJnl7y8qz4,7778
 cmem_cmemc/commands/scheduler.py,sha256=zYeO1-Hlxh9D-I9JIweQ-SEA0la0wv0EicY_UY7rNCg,8751
-cmem_cmemc/commands/store.py,sha256=19otpzsOv2F-mH2cuq4Oz2i2vAHYdfSIQm2ec81yIFg,10429
+cmem_cmemc/commands/store.py,sha256=W_6LXq98If50-X-XYZUQsYodVwUjOSm3_jyMp62pFuA,10599
 cmem_cmemc/commands/user.py,sha256=ANZpeOBA46xiqOcNPrueComsCV0gEBbav-vOL9VgyX4,12535
 cmem_cmemc/commands/validation.py,sha256=Fv5yBIXzqy8FyjIzo-wJkv_7H5bhtcQhMxFIlJEVoBw,29495
 cmem_cmemc/commands/variable.py,sha256=aLRH_rFe0h7JBpKIqzcevbk26vczgUGokIDY8g6LPxA,11576
 cmem_cmemc/commands/vocabulary.py,sha256=fdXsG7gspA6HeOasXis1ky9UIZG-qRYP-NiFcvzCTKM,17840
 cmem_cmemc/commands/workflow.py,sha256=HSgEMbK_anYZpme4yiQ4-pxGfQcL4YWa29lrm0aT8Nk,25777
 cmem_cmemc/commands/workspace.py,sha256=IcZgBsvtulLRFofS70qpln6oKQIZunrVLfSAUeiFhCA,4579
-cmem_cmemc/completion.py,sha256=NTNJWK5nllXVebACAC68NnKKru_VU4lhLA-shgzJH7Y,45092
+cmem_cmemc/completion.py,sha256=W43pH-WbHmj2-vMcu1kNkJbFhcPXr4OFIHZyHdw6PSM,45313
 cmem_cmemc/config_parser.py,sha256=NduwOT-BB_uAk3pz1Y-ex18RQJW-jjHzkQKCEUUK6Hc,1276
 cmem_cmemc/constants.py,sha256=pzZYbSaTDUiWmE-VOAHB20oivHew5_FP9UTejySsVK4,550
-cmem_cmemc/context.py,sha256=jIta2wgQ3wHviLpzaHKlt-6_Ur7M04I6fBtIIF7s4Cs,22247
+cmem_cmemc/context.py,sha256=giSw-5BYQtf_Tw0x33JlpzoZY5wP4IMaaoSJMvYzMSc,22247
 cmem_cmemc/exceptions.py,sha256=0lsGOfXhciNGJloJGERMbbPuBbs5IwIIJ_5YnY9qQ-8,546
 cmem_cmemc/manual_helper/__init__.py,sha256=G3Lqw2aPxo8x63Tg7L0aa5VD9BMaRzZDmhrog7IuEPg,43
 cmem_cmemc/manual_helper/graph.py,sha256=HU04NYWeJ6LmW4UC7qHr1v1qsm2Md61pJ-pgWUHFmHY,3647
-cmem_cmemc/manual_helper/multi_page.py,sha256=EkP-7TdDKRnZbh1FYDaHv-goxfx1nQwan-EcpV0M3So,12235
+cmem_cmemc/manual_helper/multi_page.py,sha256=_nw5yFVo7K1e9n5qETJcbkq12ru_Fq9TH0u8EzyyRz4,12338
 cmem_cmemc/manual_helper/single_page.py,sha256=0mMn_IJwFCe-WPKAmxGEStb8IINLpQRxAx_F1pIxg1E,1526
 cmem_cmemc/migrations/__init__.py,sha256=i6Ri7qN58ou_MwOzm2KibPkXOD7u-1ELky-nUE5LjAA,24
 cmem_cmemc/migrations/abc.py,sha256=UGJzrvMzUFdp2-sosp49ObRI-SrUSzLJqLEhvB4QTzg,3564
@@ -53,8 +53,8 @@ cmem_cmemc/smart_path/clients/http.py,sha256=3clZu2v4uuOvPY4MY_8SVSy7hIXJDNooahF
 cmem_cmemc/string_processor.py,sha256=kSVePdgFmf2ekurKj6TbDJn6ur82VGLwCsTJ9ODfBEU,2879
 cmem_cmemc/title_helper.py,sha256=7frjAR54_Xc1gszOWXfzSmKFTawNJQ7kkXhZcHmQLyw,1250
 cmem_cmemc/utils.py,sha256=PkDFDISz7uemJCmyIWmtCcjfR_gRnRBL8ao76Ex-py8,14669
-cmem_cmemc-25.3.0.dist-info/LICENSE,sha256=z8d0m5b2O9McPEK1xHG_dWgUBT6EfBDz6wA0F7xSPTA,11358
-cmem_cmemc-25.3.0.dist-info/METADATA,sha256=aGWBNWxM2mPs_3OrXPVnGWUIiqBcexhEnIvTnl6sN_c,5642
-cmem_cmemc-25.3.0.dist-info/WHEEL,sha256=IYZQI976HJqqOpQU6PHkJ8fb3tMNBFjg-Cn-pwAbaFM,88
-cmem_cmemc-25.3.0.dist-info/entry_points.txt,sha256=2G0AWAyz501EHpFTjIxccdlCTsHt80NT0pdUGP1QkPA,45
-cmem_cmemc-25.3.0.dist-info/RECORD,,
+cmem_cmemc-25.4.0.dist-info/LICENSE,sha256=z8d0m5b2O9McPEK1xHG_dWgUBT6EfBDz6wA0F7xSPTA,11358
+cmem_cmemc-25.4.0.dist-info/METADATA,sha256=SXMr4rUBE2nGtL-eKPcpwPtWTI-FJafD8EcDJwdi6l8,5642
+cmem_cmemc-25.4.0.dist-info/WHEEL,sha256=IYZQI976HJqqOpQU6PHkJ8fb3tMNBFjg-Cn-pwAbaFM,88
+cmem_cmemc-25.4.0.dist-info/entry_points.txt,sha256=2G0AWAyz501EHpFTjIxccdlCTsHt80NT0pdUGP1QkPA,45
+cmem_cmemc-25.4.0.dist-info/RECORD,,