pyegeria 1.5.1.0.4__py3-none-any.whl → 1.5.1.0.5__py3-none-any.whl

commands/cat/glossary_actions.py

@@ -0,0 +1,221 @@
+"""
+SPDX-License-Identifier: Apache-2.0
+Copyright Contributors to the ODPi Egeria project.
+
+
+
+Execute Glossary actions.
+
+"""
+import os
+import sys
+import time
+from datetime import datetime
+
+import click
+
+# from ops_config import Config, pass_config
+from pyegeria import EgeriaTech, body_slimmer
+from pyegeria._exceptions import (
+    InvalidParameterException,
+    PropertyServerException,
+    print_exception_response,
+)
+
+
+EGERIA_METADATA_STORE = os.environ.get("EGERIA_METADATA_STORE", "active-metadata-store")
+EGERIA_KAFKA_ENDPOINT = os.environ.get("KAFKA_ENDPOINT", "localhost:9092")
+EGERIA_PLATFORM_URL = os.environ.get("EGERIA_PLATFORM_URL", "https://localhost:9443")
+EGERIA_VIEW_SERVER = os.environ.get("VIEW_SERVER", "view-server")
+EGERIA_VIEW_SERVER_URL = os.environ.get(
+    "EGERIA_VIEW_SERVER_URL", "https://localhost:9443"
+)
+EGERIA_INTEGRATION_DAEMON = os.environ.get("INTEGRATION_DAEMON", "integration-daemon")
+EGERIA_INTEGRATION_DAEMON_URL = os.environ.get(
+    "EGERIA_INTEGRATION_DAEMON_URL", "https://localhost:9443"
+)
+EGERIA_ADMIN_USER = os.environ.get("ADMIN_USER", "garygeeke")
+EGERIA_ADMIN_PASSWORD = os.environ.get("ADMIN_PASSWORD", "secret")
+EGERIA_USER = os.environ.get("EGERIA_USER", "erinoverview")
+EGERIA_USER_PASSWORD = os.environ.get("EGERIA_USER_PASSWORD", "secret")
+
+
+@click.command("create-glossary")
+@click.option("--name", prompt="Glossary Name", help="Name of Glossary", required=True)
+@click.option(
+    "--language", prompt="Language", help="Language of Glossary", default="English"
+)
+@click.option(
+    "--description",
+    prompt="Glossary Description",
+    help="Description of Glossary",
+    default="A description goes here",
+)
+@click.option(
+    "--usage",
+    prompt="Glossary Usage",
+    help="Purpose of glossary",
+    default="Definitions",
+)
+@click.option("--server", default=EGERIA_VIEW_SERVER, help="Egeria view server to use.")
+@click.option(
+    "--url", default=EGERIA_VIEW_SERVER_URL, help="URL of Egeria platform to connect to"
+)
+@click.option("--userid", default=EGERIA_USER, help="Egeria user")
+@click.option("--password", default=EGERIA_USER_PASSWORD, help="Egeria user password")
+@click.option("--timeout", default=60, help="Number of seconds to wait")
+def create_glossary(
+    server: str,
+    url: str,
+    userid: str,
+    password: str,
+    timeout: int,
+    name: str,
+    language: str,
+    description: str,
+    usage: str,
+) -> None:
+    """Create a new Glossary"""
+
+    try:
+        m_client = EgeriaTech(server, url, userid, password)
+        token = m_client.create_egeria_bearer_token()
+
+        existing_glossary = m_client.find_glossaries(name)
+        if type(existing_glossary) is list:
+            click.echo(f"\nFound {len(existing_glossary)} existing Glossaries\n")
+            for glossary in existing_glossary:
+                click.echo(
+                    f"\tFound glossary: {glossary['glossaryProperties']['qualifiedName']} with id of {glossary['elementHeader']['guid']}\n"
+                )
+            sys.exit(0)
+
+        glossary_guid = m_client.create_glossary(name, language, description, usage)
+        print(f"New glossary {name} created with id of {glossary_guid}")
+
+    except (InvalidParameterException, PropertyServerException) as e:
+        print_exception_response(e)
+    finally:
+        m_client.close_session()
+
+
+@click.command("delete-glossary")
+@click.option("--server", default=EGERIA_VIEW_SERVER, help="Egeria view server to use")
+@click.option(
+    "--url", default=EGERIA_VIEW_SERVER_URL, help="URL of Egeria platform to connect to"
+)
+@click.option("--userid", default=EGERIA_USER, help="Egeria user")
+@click.option("--password", default=EGERIA_USER_PASSWORD, help="Egeria user password")
+@click.option("--timeout", default=60, help="Number of seconds to wait")
+@click.argument("glossary-guid")
+def delete_glossary(server, url, userid, password, timeout, glossary_guid):
+    """Delete the glossary specified"""
+    m_client = EgeriaTech(server, url, user_id=userid, user_pwd=password)
+    token = m_client.create_egeria_bearer_token()
+    try:
+        m_client.delete_to_do(glossary_guid)
+
+        click.echo(f"Deleted Todo item {glossary_guid}")
+
+    except (InvalidParameterException, PropertyServerException) as e:
+        print_exception_response(e)
+    finally:
+        m_client.close_session()
+
+
+@click.command("create-term")
+@click.option(
+    "--glossary-name", prompt="Glossary Name", help="Name of Glossary", required=True
+)
+@click.option("--term-name", prompt="Term Name", help="Name of Term", required=True)
+@click.option(
+    "--summary",
+    prompt="Summary",
+    help="Summary definition",
+    default="Summary goes here",
+)
+@click.option(
+    "--description",
+    prompt="Description",
+    help="Full description",
+    default="Description goes here",
+)
+@click.option("--abbrev", prompt="Abbreviation", help="Abbreviation", default=None)
+@click.option("--examples", prompt="Examples", help="Example usage", default=None)
+@click.option("--usage", prompt="Usage", help="Usage notes", default=None)
+@click.option("--version", prompt="Version", help="Version", default="1.0")
+@click.option(
+    "--status",
+    prompt="Status",
+    help="Status",
+    type=click.Choice(
+        ["DRAFT", "ACTIVE", "DEPRACATED", "OBSOLETE", "OTHER"], case_sensitive=False
+    ),
+    default="DRAFT",
+)
+@click.option("--server", default=EGERIA_VIEW_SERVER, help="Egeria view server to use.")
+@click.option(
+    "--url", default=EGERIA_VIEW_SERVER_URL, help="URL of Egeria platform to connect to"
+)
+@click.option("--userid", default=EGERIA_USER, help="Egeria user")
+@click.option("--password", default=EGERIA_USER_PASSWORD, help="Egeria user password")
+@click.option("--timeout", default=60, help="Number of seconds to wait")
+def create_term(
+    server,
+    url,
+    userid,
+    password,
+    timeout,
+    glossary_name,
+    term_name,
+    summary,
+    description,
+    abbrev,
+    examples,
+    usage,
+    version,
+    status,
+):
+    """Create a new term"""
+    m_client = EgeriaTech(server, url, user_id=userid, user_pwd=password)
+    token = m_client.create_egeria_bearer_token()
+    try:
+        body = {
+            "class": "ReferenceableRequestBody",
+            "elementProperties": {
+                "class": "GlossaryTermProperties",
+                "qualifiedName": f"GlossaryTerm: {term_name} : {datetime.datetime.now().isoformat()}",
+                "displayName": term_name,
+                "summary": summary,
+                "description": description,
+                "abbreviation": abbrev,
+                "examples": examples,
+                "usage": usage,
+                "publishVersionIdentifier": version,
+            },
+            "initialStatus": status,
+        }
+        exists = False
+        glossary_info = m_client.find_glossaries(glossary_name)
+        if type(glossary_info) is list:
+            for glossary in glossary_info:
+                if glossary["glossaryProperties"]["displayName"] == glossary_name:
+                    exists = True
+                    glossary_guid = glossary["elementHeader"]["guid"]
+
+        if not exists:
+            click.echo(f"The glossary name {glossary_name} was not found..exiting\n")
+            sys.exit(0)
+
+        term_guid = m_client.create_controlled_glossary_term(
+            glossary_guid, body_slimmer(body)
+        )
+
+        click.echo(
+            f"Successfully created term {term_name} with GUID {term_guid}, in glossary {glossary_name}.\n"
+        )
+
+    except (InvalidParameterException, PropertyServerException) as e:
+        print_exception_response(e)
+    finally:
+        m_client.close_session()

commands/cli/egeria.py

@@ -34,7 +34,7 @@ from commands.my.monitor_my_todos import display_my_todos
 from commands.my.monitor_open_todos import display_todos
 from commands.cat.list_deployed_database_schemas import list_deployed_database_schemas
 from commands.cat.list_deployed_catalogs import list_deployed_catalogs
-
+from commands.cat.glossary_actions import create_glossary, delete_glossary, create_term
 
 from commands.ops.gov_server_actions import (
     add_catalog_target,
@@ -957,6 +957,11 @@ def tell(ctx):
     pass
 
 
+tell.add_command(create_glossary)
+tell.add_command(delete_glossary)
+tell.add_command(create_term)
+
+
 @tell.group("survey")
 @click.pass_context
 def survey(ctx):

commands/cli/egeria_cat.py

@@ -29,7 +29,7 @@ from commands.cat.list_user_ids import list_user_ids
 from commands.cat.list_archives import display_archive_list
 from commands.cat.list_deployed_database_schemas import list_deployed_database_schemas
 from commands.cat.list_deployed_catalogs import list_deployed_catalogs
-
+from commands.cat.glossary_actions import create_glossary, delete_glossary, create_term
 
 # from pyegeria import ServerOps
 from commands.cli.ops_config import Config
@@ -537,6 +537,11 @@ def tell(ctx):
     pass
 
 
+tell.add_command(create_glossary)
+tell.add_command(delete_glossary)
+tell.add_command(create_term)
+
+
 @tell.group("survey")
 @click.pass_context
 def survey(ctx):

commands/my/todo_actions.py

@@ -25,7 +25,7 @@ erins_guid = "a588fb08-ae09-4415-bd5d-991882ceacba"
 peter_guid = "a187bc48-8154-491f-97b4-a2f3c3f1a00e"
 tanya_guid = "26ec1614-bede-4b25-a2a3-f8ed26db3aaa"
 
-ERIA_METADATA_STORE = os.environ.get("EGERIA_METADATA_STORE", "active-metadata-store")
+EGERIA_METADATA_STORE = os.environ.get("EGERIA_METADATA_STORE", "active-metadata-store")
 EGERIA_KAFKA_ENDPOINT = os.environ.get("KAFKA_ENDPOINT", "localhost:9092")
 EGERIA_PLATFORM_URL = os.environ.get("EGERIA_PLATFORM_URL", "https://localhost:9443")
 EGERIA_VIEW_SERVER = os.environ.get("VIEW_SERVER", "view-server")
@@ -43,11 +43,11 @@ EGERIA_USER_PASSWORD = os.environ.get("EGERIA_USER_PASSWORD", "secret")
 
 
 @click.command("create-todo")
+@click.option("--server", default=EGERIA_VIEW_SERVER, help="Egeria view server to use.")
 @click.option(
-    "--server", default=EGERIA_VIEW_SERVER, help="Egeria metadata store to load"
-)
-@click.option(
-    "--url", default=EGERIA_VIEW_SERVER_URL, help="URL of Egeria platform to connect to"
+    "--url",
+    default=EGERIA_VIEW_SERVER_URL,
+    help="URL of Egeria platform to connect to.",
 )
 @click.option("--userid", default=EGERIA_USER, help="Egeria user")
 @click.option("--password", default=EGERIA_USER_PASSWORD, help="Egeria user password")

pyegeria/glossary_manager_omvs.py

@@ -1405,6 +1405,17 @@ class GlossaryManager(GlossaryBrowser):
 
         return response
 
+    def load_terms_from_file(
+        self, glossary_name: str, filename: str, upsert: bool = False
+    ) -> str:
+        """This method loads glossary terms into the specified glossary from the indicated file."""
+        # Check that glossary exists and get guid
+
+        # Open file
+
+        # Insert terms into glossary
+        pass
+
     async def _async_create_term_copy(
         self,
         glossary_guid: str,

{pyegeria-1.5.1.0.4.dist-info → pyegeria-1.5.1.0.5.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: pyegeria
-Version: 1.5.1.0.4
+Version: 1.5.1.0.5
 Summary: A python client for Egeria
 Home-page: https://github.com/odpi/egeria-python
 License: Apache 2.0

{pyegeria-1.5.1.0.4.dist-info → pyegeria-1.5.1.0.5.dist-info}/RECORD

@@ -6,6 +6,7 @@ commands/cat/get_project_dependencies.py,sha256=B0JaMSUi0hzVgos1sTY2uUPGy1DzKEJM
 commands/cat/get_project_structure.py,sha256=n2GbNd07w1DTo7jTR8b2ewXRyNcat_2BcCBRyDMldwk,5969
 commands/cat/get_tech_type_elements.py,sha256=-m3Q0BoNqkCtV8h75vMwTcOV-_ymEXmnJcr4Ec7WMAw,6180
 commands/cat/get_tech_type_template.py,sha256=gMFVcgCIm09GQu1Vsc5ZUVH9XLhItAG1eVGZJrcnHeQ,6174
+commands/cat/glossary_actions.py,sha256=aBKMsTAjkwdoMuyuj9ou9QefcdKmkIt4oDlpAVJ_Ymo,7597
 commands/cat/list_archives.py,sha256=83LhNeZWhzRiE-oU6veuIk9ob4XDtDWUoXdGGXaYeE8,5454
 commands/cat/list_assets.py,sha256=bNwSaBDz661hfnc2Rn4j4HPHAugKvz0XwN9L1m4FVQk,6529
 commands/cat/list_cert_types.py,sha256=mbCls_EqC5JKG5rvS4o69k7KgZ6aNXlcqoJ3DtHsTFA,7127
@@ -19,8 +20,8 @@ commands/cat/list_tech_types.py,sha256=20T4v6L5qeebSsaL1nGkFMDAIsy2W3A3SMm1RcgFo
 commands/cat/list_todos.py,sha256=iPxHRyW3X5tiREio4TUOwRPvNPjU0gxm3pVnUI79ir4,6542
 commands/cat/list_user_ids.py,sha256=7JinL7rknPbGusIb8ikXKEaV1vvbuvx_WWtbmlfS_DY,5093
 commands/cli/__init__.py,sha256=hpTVSMP2gnPRhcAZPdeUEsQ-eaDySlXlk239dNWYmng,292
-commands/cli/egeria.py,sha256=DpbQVtVmRjVTwIMC9qJNgk2VolEyhg4chix5JjPcXP0,30475
-commands/cli/egeria_cat.py,sha256=V_wkdV0wxMmdTV-tUUWC7bdT8wfI3t1IyH8IiEz62P4,14023
+commands/cli/egeria.py,sha256=rKRdJ-iKspR3zs-zGjnJI5OGHB_bJttD_tWZ6kNrU9s,30662
+commands/cli/egeria_cat.py,sha256=9uz9uz-ekCdwN6qNwovI4z1faCCqk3eaayaVkCETSdU,14210
 commands/cli/egeria_my.py,sha256=9zIpUDLeA_R-0rgCSQfEZTtVmkxPcEAsYcCTn1wQFrE,6181
 commands/cli/egeria_ops.py,sha256=fxDXYWXRhexx06PdSLCp2FhgUtS13NdDpyg7ea775fc,11531
 commands/cli/egeria_tech.py,sha256=eTDHTHDVEYmr6gUPGfido_Uf7Fec0Nuyxlkhg4KAMAw,13160
@@ -31,7 +32,7 @@ commands/my/list_my_profile.py,sha256=jJaGAHrhFv9VQR9li5pzFN3ihqhHv9LmnAVPiKvPp3
 commands/my/list_my_roles.py,sha256=AhyKXSQxBPDh2QQoL90bPQPkNnu1w7whpk9kZoBxRTQ,5175
 commands/my/monitor_my_todos.py,sha256=YiwyQgtA7YsfW4-Ps-1ymvFjRqp-Egubv9j8iFUMUXE,6601
 commands/my/monitor_open_todos.py,sha256=KDrAjdLPP3j0K9Y3G95BIgr51ktTx3mMlKydLFDF2YQ,5466
-commands/my/todo_actions.py,sha256=uihltirrAPtwYNygnNBAVWgfS0W7acoETz1_h3XW_4o,8369
+commands/my/todo_actions.py,sha256=iazoRhsQ9aecCwJk6r4lWRP-mPD2t-YGU_GmPrFtR-Q,8372
 commands/ops/README.md,sha256=PJsSDcvMv6E6og6y-cwvxFX5lhCII0UCwgKiM1T17MQ,1595
 commands/ops/__init__.py,sha256=SCfzF3-aMx8EpqLWmH7JQf13gTmMAtHRbg69oseLvi8,480
 commands/ops/engine_actions.py,sha256=00s_wkzs0zlZ6PyZ0J5J9lHhw4Viyzbeox7b1K1lmyc,4609
@@ -89,7 +90,7 @@ pyegeria/egeria_tech_client.py,sha256=7NfqpJFft5GR4NPRDVDw22L9caHbXB8fhx0TAf6qEo
 pyegeria/feedback_manager_omvs.py,sha256=B66e3ZCaC_dirb0mcb2Nz3PYh2ZKsoMAYNOb3euNiro,152931
 pyegeria/full_omag_server_config.py,sha256=LBnqUiz1ofBdlKBzECFs_pQbdJwcWigAukWHGJRR2nU,47340
 pyegeria/glossary_browser_omvs.py,sha256=AnBRp6KKw0507ABz_WmknVL94zLzYzJ4saXrghFlpmw,93455
-pyegeria/glossary_manager_omvs.py,sha256=49kiIxypvi5HKI1Ewtk1qp104zDuhcGe5SxBDKB0W8o,111925
+pyegeria/glossary_manager_omvs.py,sha256=LmZWwRsDDrvZsf2Whsayj4XHINlER9nu9z2CNc1YOX8,112262
 pyegeria/mermaid_utilities.py,sha256=GXiS-subb5nJcDqlThZWX2T8WspU1neFfhf4TxRoMh4,8344
 pyegeria/my_profile_omvs.py,sha256=DyECbUFEcgokrIbzdMMNljC3bqfqKGXAF2wZEpzvRYs,34666
 pyegeria/platform_services.py,sha256=CJIOYIFEbcIGwdWlApAQcXxZTsdrhFtpJcm4O3p7dG0,41646
@@ -100,8 +101,8 @@ pyegeria/server_operations.py,sha256=ciH890hYT85YQ6OpByn4w7s3a7TtvWZpIG5rkRqbcI0
 pyegeria/utils.py,sha256=1h6bwveadd6GpbnGLTmqPBmBk68QvxdjGTI9RfbrgKY,5415
 pyegeria/valid_metadata_omvs.py,sha256=tfCGXed5LLt59YA8uZNNtd9UJ-lRZfPU_uZxK31Yux0,65069
 pyegeria/x_action_author_omvs.py,sha256=xu1IQ0YbhIKi17C5a7Aq9u1Az2czwahNPpX9czmyVxE,6454
-pyegeria-1.5.1.0.4.dist-info/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
-pyegeria-1.5.1.0.4.dist-info/METADATA,sha256=aHgZlal0-Qsob6AWvNPwQTyUo89V963lrvTaBvQw2w4,2997
-pyegeria-1.5.1.0.4.dist-info/WHEEL,sha256=sP946D7jFCHeNz5Iq4fL4Lu-PrWrFsgfLXbbkciIZwg,88
-pyegeria-1.5.1.0.4.dist-info/entry_points.txt,sha256=Mbd1WrK70MbB1XA_kVcKFVm9RNkn2H1c0xHzv78K2p4,3824
-pyegeria-1.5.1.0.4.dist-info/RECORD,,
+pyegeria-1.5.1.0.5.dist-info/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
+pyegeria-1.5.1.0.5.dist-info/METADATA,sha256=kcbmI3YiROFo3L_aCQVekhvAx9cPGC0EAkUAEV3KTEg,2997
+pyegeria-1.5.1.0.5.dist-info/WHEEL,sha256=sP946D7jFCHeNz5Iq4fL4Lu-PrWrFsgfLXbbkciIZwg,88
+pyegeria-1.5.1.0.5.dist-info/entry_points.txt,sha256=Pc5kHnxv-vbRpwVMxSSWl66vmf7EZjgzf7nZzz1ow3M,4002
+pyegeria-1.5.1.0.5.dist-info/RECORD,,

{pyegeria-1.5.1.0.4.dist-info → pyegeria-1.5.1.0.5.dist-info}/entry_points.txt

@@ -1,6 +1,9 @@
 [console_scripts]
 change_todo_status=commands.my.todo_actions:change_todo_status
+create_glossary=commands.cat.glossary_actions:create_glossary
+create_term=commands.cat.glossary_actions:create_term
 create_todo=commands.my.todo_actions:create_todo
+delete_glossary=commands.cat.glossary_actions:delete_glossary
 delete_todo=commands.my.todo_actions:delete_todo
 get_asset_graph=commands.cat.get_asset_graph:main
 get_collection=commands.cat.get_collection:main