pyegeria 0.5.6.5__tar.gz → 0.5.8.0__tar.gz

{pyegeria-0.5.6.5 → pyegeria-0.5.8.0}/PKG-INFO

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

{pyegeria-0.5.6.5 → pyegeria-0.5.8.0}/examples/widgets/catalog_user/get_asset_graph.py

@@ -9,7 +9,6 @@ import argparse
 import os
 import sys
 
-from rich import print
 from rich.console import Console
 from rich.markdown import Markdown
 from rich.panel import Panel
@@ -35,6 +34,7 @@ EGERIA_USER = os.environ.get('EGERIA_USER', 'erinoverview')
 EGERIA_USER_PASSWORD = os.environ.get('EGERIA_USER_PASSWORD', 'secret')
 
 disable_ssl_warnings = True
+
 console = Console(width=200)
 
 
@@ -89,8 +89,6 @@ def asset_viewer(asset_guid: str, server_name:str, platform_url:str, user:str, u
 
     try:
 
-        console = Console(width=200)
-
         a_client = AssetCatalog(server_name, platform_url,
                                      user_id=user)
 
@@ -146,6 +144,7 @@ def asset_viewer(asset_guid: str, server_name:str, platform_url:str, user:str, u
                f"* Asset Origin: {asset_origin}\n{prop_md}\n"
                )
         core_md = Markdown(core_md)
+
         p1 = Panel.fit(core_md, style = "bold bright_white")
         l2 = tree.add(p1)
         if asset_class_md is not None:
@@ -225,9 +224,9 @@ def asset_viewer(asset_guid: str, server_name:str, platform_url:str, user:str, u
                 relationship_panel = Panel.fit(Markdown(relationship_md), style="bold bright_white", title = "Asset Relationships")
                 tree.add(relationship_panel)
 
-
-        print("\n\n")
-        print(tree)
+        with console.screen():
+            print("\n\n")
+            print(tree)
 
     except (
         InvalidParameterException,
@@ -250,9 +249,12 @@ def main():
     url = args.url if args.url is not None else EGERIA_PLATFORM_URL
     userid = args.userid if args.userid is not None else EGERIA_USER
     user_pass = args.password if args.password is not None else EGERIA_USER_PASSWORD
-
-    asset_guid = Prompt.ask("Enter the Asset GUID to view:", default="")
-    asset_viewer(asset_guid,server, url, userid, user_pass)
+    try:
+        asset_guid = Prompt.ask("Enter the Asset GUID to view:", default="")
+        asset_viewer(asset_guid,server, url, userid, user_pass)
+    except (KeyboardInterrupt) as e:
+        # console.print_exception()
+        pass
 
 if __name__ == "__main__":
     main()

{pyegeria-0.5.6.5 → pyegeria-0.5.8.0}/examples/widgets/catalog_user/get_collection.py

@@ -87,8 +87,10 @@ def main():
     userid = args.userid if args.userid is not None else EGERIA_USER
     user_pass = args.password if args.password is not None else EGERIA_USER_PASSWORD
 
-    root_collection = Prompt.ask("Enter the Root Collection to start from:", default="Root Sustainability Collection")
-    collection_viewer(root_collection, server, url, userid, user_pass)
-
+    try:
+        root_collection = Prompt.ask("Enter the Root Collection to start from:", default="Root Sustainability Collection")
+        collection_viewer(root_collection, server, url, userid, user_pass)
+    except (KeyboardInterrupt):
+        pass
 if __name__ == "__main__":
     main()

{pyegeria-0.5.6.5/examples/widgets/operational → pyegeria-0.5.8.0/examples/widgets/catalog_user}/get_tech_type_elements.py

@@ -142,9 +142,12 @@ def main():
     url = args.url if args.url is not None else EGERIA_PLATFORM_URL
     userid = args.userid if args.userid is not None else EGERIA_USER
     user_pass = args.password if args.password is not None else EGERIA_USER_PASSWORD
+    try:
+        tech_name = Prompt.ask("Enter the Asset Name to view:", default="Apache Kafka Server")
+        tech_viewer(tech_name,server, url, userid, user_pass)
+    except (KeyboardInterrupt):
+        pass
 
-    tech_name = Prompt.ask("Enter the Asset Name to view:", default="Apache Kafka Server")
-    tech_viewer(tech_name,server, url, userid, user_pass)
 
 if __name__ == "__main__":
     main()

{pyegeria-0.5.6.5/examples/widgets/operational → pyegeria-0.5.8.0/examples/widgets/catalog_user}/get_tech_type_template.py

@@ -135,8 +135,12 @@ def main():
     userid = args.userid if args.userid is not None else EGERIA_USER
     user_pass = args.password if args.password is not None else EGERIA_USER_PASSWORD
 
-    tech_name = Prompt.ask("Enter the Asset Name to view:", default="Apache Kafka Server")
-    tech_viewer(tech_name,server, url, userid, user_pass)
+    try:
+        tech_name = Prompt.ask("Enter the Asset Name to view:", default="Apache Kafka Server")
+        tech_viewer(tech_name,server, url, userid, user_pass)
+    except(KeyboardInterrupt):
+        pass
+
 
 if __name__ == "__main__":
     main()

{pyegeria-0.5.6.5 → pyegeria-0.5.8.0}/examples/widgets/catalog_user/list_assets.py

@@ -139,9 +139,10 @@ def main():
     userid = args.userid if args.userid is not None else EGERIA_USER
     user_pass = args.password if args.password is not None else EGERIA_USER_PASSWORD
     time_out = args.time_out if args.time_out is not None else 60
-
-    search_string = Prompt.ask("Enter an asset search string:", default="")
-    display_assets(search_string, server, url, userid, user_pass, time_out)
-
+    try:
+        search_string = Prompt.ask("Enter an asset search string:", default="")
+        display_assets(search_string, server, url, userid, user_pass, time_out)
+    except(KeyboardInterrupt):
+        pass
 if __name__ == "__main__":
     main()

{pyegeria-0.5.6.5 → pyegeria-0.5.8.0}/examples/widgets/catalog_user/list_glossary.py

@@ -125,8 +125,10 @@ def main():
     guid = args.guid if args.guid is not None else None
     guid = sus_guid  if args.sustainability else None
 
-    search_string = Prompt.ask("Enter the term you are searching for:", default="*")
-    display_glossary_terms(search_string, guid,server, url, userid, user_pass)
-
+    try:
+        search_string = Prompt.ask("Enter the term you are searching for:", default="*")
+        display_glossary_terms(search_string, guid,server, url, userid, user_pass)
+    except(KeyboardInterrupt):
+        pass
 if __name__ == "__main__":
     main()

{pyegeria-0.5.6.5 → pyegeria-0.5.8.0}/examples/widgets/developer/get_guid_info.py

@@ -18,6 +18,7 @@ from rich.console import Console
 from rich.prompt import Prompt
 from rich.text import Text
 from rich.tree import Tree
+from rich.panel import Panel
 
 from pyegeria import (
     InvalidParameterException,
@@ -46,7 +47,7 @@ def display_guid(guid: str, server: str, url: str, username: str, user_password:
 
 
     try:
-        console = Console(width = 180, style="bold white on black")
+        console = Console(width = 160, style="bold white on black")
         r = c.make_request("GET", url)
         if r.status_code == 200:
             pass
@@ -63,7 +64,7 @@ def display_guid(guid: str, server: str, url: str, username: str, user_password:
         tree = tree.add(type_name)
         tree.add(metadataCollection)
         tree.add(created)
-        tree.add(details)
+        tree.add(Panel(details,title="Element Details", expand=False))
         print(tree)
 
         c.close_session()
@@ -72,8 +73,7 @@ def display_guid(guid: str, server: str, url: str, username: str, user_password:
         if type(e) is str:
            console.print_exception()
         else:
-            console.print(f"\n Looks like the GUID isn't known...detailed message follows\n")
-            console.print_exception()
+            console.print(f"\n Looks like the GUID isn't known...\n")
 
 def main():
 
@@ -90,9 +90,11 @@ def main():
     url = args.url if args.url is not None else EGERIA_PLATFORM_URL
     userid = args.userid if args.userid is not None else EGERIA_USER
     user_pass = args.password if args.password is not None else EGERIA_USER_PASSWORD
-    guid = Prompt.ask("Enter the GUID to retrieve:", default=None)
-
-    display_guid(guid, server, url, userid, user_pass)
 
+    try:
+        guid = Prompt.ask("Enter the GUID to retrieve", default=None)
+        display_guid(guid, server, url, userid, user_pass)
+    except (KeyboardInterrupt):
+        pass
 if __name__ == "__main__":
     main()

{pyegeria-0.5.6.5 → pyegeria-0.5.8.0}/examples/widgets/developer/get_tech_details.py

@@ -111,9 +111,12 @@ def main():
     url = args.url if args.url is not None else EGERIA_PLATFORM_URL
     userid = args.userid if args.userid is not None else EGERIA_USER
     user_pass = args.password if args.password is not None else EGERIA_USER_PASSWORD
+    try:
+        tech = Prompt.ask("Enter the Technology to start from:", default="PostgreSQL Server")
+        tech_viewer(tech,server, url, userid, user_pass)
+    except(KeyboardInterrupt):
+        pass
 
-    tech = Prompt.ask("Enter the Technology to start from:", default="PostgreSQL Server")
-    tech_viewer(tech,server, url, userid, user_pass)
 
 if __name__ == "__main__":
     main()

{pyegeria-0.5.6.5 → pyegeria-0.5.8.0}/examples/widgets/developer/list_registered_services.py

@@ -142,9 +142,12 @@ def main():
     userid = args.userid if args.userid is not None else EGERIA_ADMIN_USER
     password = args.password if args.password is not None else EGERIA_USER_PASSWORD
 
-    svc_kind = Prompt.ask("Enter the service type you are searching for:", default="all")
+    try:
+        svc_kind = Prompt.ask("Enter the service type you are searching for:", default="all")
+        display_registered_svcs(svc_kind, server, url, userid, password=password)
+    except(KeyboardInterrupt):
+        pass
 
-    display_registered_svcs(svc_kind, server, url, userid, password=password)
 
 if __name__ == "__main__":
     main()

{pyegeria-0.5.6.5 → pyegeria-0.5.8.0}/examples/widgets/developer/list_tech_templates.py

@@ -134,9 +134,12 @@ def main():
     password = args.password if args.password is not None else EGERIA_USER_PASSWORD
     guid = None
 
-    search_string = Prompt.ask("Enter the technology you are searching for:", default="*")
+    try:
+        search_string = Prompt.ask("Enter the technology you are searching for:", default="*")
+        display_tech_types(search_string, server, url, userid, password)
+    except(KeyboardInterrupt):
+        pass
 
-    display_tech_types(search_string, server, url, userid, password)
 
 if __name__ == "__main__":
     main()

{pyegeria-0.5.6.5 → pyegeria-0.5.8.0}/examples/widgets/developer/list_tech_types.py

@@ -113,9 +113,12 @@ def main():
     userid = args.userid if args.userid is not None else EGERIA_USER
     user_pass = args.password if args.password is not None else EGERIA_USER_PASSWORD
 
-    search_string = Prompt.ask("Enter the technology you are searching for:", default="*")
+    try:
+        search_string = Prompt.ask("Enter the technology you are searching for:", default="*")
+        display_tech_types(search_string, server, url, userid, user_pass)
+    except (KeyboardInterrupt):
+        pass
 
-    display_tech_types(search_string, server, url, userid, user_pass)
 
 if __name__ == "__main__":
     main()

{pyegeria-0.5.6.5 → pyegeria-0.5.8.0}/examples/widgets/developer/list_valid_metadata_values.py

@@ -132,8 +132,13 @@ def main():
     user_pass = args.password if args.password is not None else EGERIA_USER_PASSWORD
     save_output = args.save_output if args.save_output is not None else False
     property_name = Prompt.ask("Enter the Property to retrieve:", default="projectHealth")
-    type_name = Prompt.ask("Enter the Metadata Type to filter on:", default="Project")
-    display_values(property_name, type_name,server, url, userid, user_pass, save_output)
+
+    try:
+        type_name = Prompt.ask("Enter the Metadata Type to filter on:", default="Project")
+        display_values(property_name, type_name,server, url, userid, user_pass, save_output)
+    except(KeyboardInterrupt):
+        pass
+
 
 if __name__ == "__main__":
     main()

{pyegeria-0.5.6.5 → pyegeria-0.5.8.0}/examples/widgets/operational/__init__.py

@@ -4,4 +4,4 @@ Copyright Contributors to the ODPi Egeria project.
 
 
 """
-import pyegeria
+import pyegeria

pyegeria-0.5.8.0/examples/widgets/operational/egeria_ops.py

@@ -0,0 +1,215 @@
+#!/usr/bin/env python3
+"""
+SPDX-License-Identifier: Apache-2.0
+Copyright Contributors to the ODPi Egeria project.
+
+
+A command line interface for Egeria operations.
+
+This is an emerging capability based on the **click** package. Feedback welcome!
+
+"""
+import click
+from trogon import tui
+from pyegeria import ServerOps
+from ops_config import Config, pass_config
+import monitor_gov_eng_status
+import monitor_server_status
+import monitor_server_list
+import monitor_integ_daemon_status
+import monitor_platform_status
+import monitor_engine_activity
+import refresh_integration_daemon
+import restart_integration_daemon
+import integration_daemon_actions
+import list_catalog_targets
+
+# class Config(object):
+#     def __init__(self, server: str = None, url: str = None, userid:str = None, password:str = None,
+#                  timeout:int = 30, paging: bool = False):
+#         self.server = server
+#         self.url = url
+#         self.userid = userid
+#         self.password = password
+#         self.timeout = timeout
+#         self.paging = paging
+#
+#
+# pass_config = click.make_pass_decorator(Config)
+
+# @tui
+@tui()
+@click.version_option("0.0.1", prog_name="egeria_ops")
+@click.group()
+@click.option('--server', default = 'active-metadata-store', envvar = 'EGERIA_METADATA_STORE',
+              help='Egeria metadata store to work with')
+@click.option('--url', default = 'https://localhost:9443', envvar= 'EGERIA_PLATFORM_URL',
+              help='URL of Egeria metadata store platform to connect to')
+@click.option('--integration-daemon', default = 'integration-daemon', envvar = 'EGERIA_INTEGRATION_DAEMON',
+              help='Egeria integration daemon to work with')
+@click.option('--integration_daemon_url', default = 'https://localhost:9443', envvar= 'EGERIA_INTEGRATION_DAEMON_URL',
+              help='URL of Egeria integration daemon platform to connect to')
+@click.option('--view_server', default = 'view-server', envvar = 'EGERIA_VIEW_SERVER',
+              help='Egeria view server to work with')
+@click.option('--view_server_url', default = 'https://localhost:9443', envvar= 'EGERIA_VIEW_SERVER_URL',
+              help='URL of Egeria view server platform to connect to')
+@click.option('--engine_host', default = 'engine-host', envvar = 'EGERIA_ENGINE_HOST',
+              help='Egeria engine host to work with')
+@click.option('--engine_host_url', default = 'https://localhost:9443', envvar= 'EGERIA_ENGINE_HOST_URL',
+              help='URL of Egeria engine host platform to connect to')
+@click.option('--admin_user', default = 'garygeeke', envvar = 'EGERIA_ADMIN_USER', help='Egeria admin user')
+@click.option('--admin_user_password', default = 'secret', envvar = 'EGERIA_ADMIN_PASSWORD',
+              help='Egeria admin password')
+@click.option('--userid', default = 'garygeeke', envvar = 'EGERIA_USER', help='Egeria user')
+@click.option('--password', default = 'secret', envvar = 'EGERIA_PASSWORD',
+              help='Egeria user password')
+@click.option('--timeout', default = 60, help = 'Number of seconds to wait')
+@click.option('--verbose', is_flag = True, default = False, help = 'Enable verbose mode')
+@click.option('--paging', is_flag = True, default = False, help = 'Enable paging snapshots vs live updates')
+@click.pass_context
+def cli(ctx, server, url, view_server, view_server_url, integration_daemon, integration_daemon_url,
+        engine_host, engine_host_url, admin_user, admin_user_password, userid, password, timeout, paging, verbose):
+    """An Egeria Command Line interface for Operations """
+    ctx.obj = Config(server, url, view_server, view_server_url, integration_daemon,
+                     integration_daemon_url, engine_host, engine_host_url,
+                     admin_user, admin_user_password,userid, password,
+                     timeout, paging, verbose)
+    ctx.max_content_width = 200
+    ctx.ensure_object(Config)
+    if verbose:
+        click.echo(f"we are in verbose mode - server is {server}")
+
+
+@cli.group("show")
+@click.pass_context
+def show(ctx):
+    """Display an Egeria Object"""
+    pass
+
+@show.group('platforms')
+@click.pass_context
+def show_platform(ctx):
+    """Group of commands to show information about Egeria platforms"""
+    pass
+
+@show_platform.command('status')
+@click.pass_context
+def show_platform_status(ctx):
+    """Display a live status view of known platforms"""
+    c = ctx.obj
+    monitor_platform_status.display_status(c.view_server,c.view_server_url,
+                                           c.admin_user,c.admin_user_password)
+
+
+@show.group("servers")
+@click.pass_context
+def show_server(ctx):
+    """Group of commands to show information about Egeria servers"""
+    pass
+
+@show_server.command('status')
+@click.option('--full', is_flag=True, default = False, help='If True, full server descriptions will be shown')
+@click.pass_context
+def show_server_status(ctx, full):
+    """Display a live status view of Egeria servers for the specified Egeria platform"""
+    c = ctx.obj
+    if full:
+        monitor_server_list.display_status(c.metadata_store, c.metadata_store_url, c.admin_user,c.admin_user_password)
+    else:
+        monitor_server_status.display_status(c.metadata_store, c.metadata_store_url, c.admin_user,c.admin_user_password)
+
+@show.group("engines")
+@click.pass_context
+def engine_host(ctx):
+    """Group of commands to show information about Egeria engines"""
+    pass
+
+@engine_host.command("status")
+@click.option('--list', is_flag=True, default = False, help='If True, a paged list will be shown')
+@click.pass_context
+def gov_eng_status(ctx,list):
+    """Display engine-host status information"""
+    c = ctx.obj
+    monitor_gov_eng_status.display_gov_eng_status(c.engine_host, c.engine_host_url,
+                                                                  c.userid, c.password,
+                                                  list)
+
+@engine_host.command('activity')
+@click.option('--list', is_flag=True, default = False, help='If True, a paged list will be shown')
+@click.pass_context
+def eng_activity_status(ctx,list):
+    """Show Governance Activity in engine-host"""
+    c = ctx.obj
+    monitor_engine_activity.display_engine_activity(c.view_server, c.view_server_url,
+                                                      c.userid, c.password,
+                                                      list)
+
+
+@show.group('integrations')
+@click.pass_context
+def integrations(ctx):
+    """Group of commands to show information about Egeria integrations"""
+    pass
+
+@integrations.command("status")
+@click.option('--list', is_flag=True, default = False, help='If True, a paged list will be shown')
+@click.pass_context
+def integrations_status(ctx,list):
+    """Display integration-daemon status information"""
+    c = ctx.obj
+    monitor_integ_daemon_status.display_integration_daemon_status(c.integration_daemon, c.integration_daemon_url,
+                                                                      c.view_server, c.view_server_url,
+                                                                 c.userid, c.password, list)
+
+@integrations.command("targets")
+@click.pass_context
+@click.argument('connector',nargs=1)
+def integrations_status(ctx,connector):
+    """Display Catalog Targets for a connector"""
+    c = ctx.obj
+    list_catalog_targets.display_catalog_targets(connector, c.view_server, c.view_server_url,
+                                                                      c.userid, c.password)
+
+#
+#  Tell
+#
+
+@cli.group('tell')
+@click.pass_context
+def tell(ctx):
+    """Perform actions an Egeria Objects"""
+    pass
+
+@tell.group('integration_daemon')
+@click.pass_context
+def integration_daemon(ctx):
+    """Group of commands to an integration-daemon"""
+    pass
+
+@integration_daemon.command('refresh')
+@click.pass_context
+@click.option('--connector', default = 'all', help="Name of connector to refresh or 'all' to refresh all")
+def refresh_connectors(ctx,connector):
+    """Refresh the specified integration connector or ALL connectors if not specified"""
+    c = ctx.obj
+    refresh_integration_daemon.refresh_connector(connector,c.integration_daemon, c.integration_daemon_url,
+                                   c.userid, c.passwordcatalog_target_actions.py )
+
+@integration_daemon.command('restart')
+@click.pass_context
+@click.option('--connector', default = 'all', help="Name of connector to restart or 'all' to restart all")
+def restart_connectors(ctx,connector):
+    """Restart the specified integration connector or ALL connectors if not specified"""
+    c = ctx.obj
+    restart_integration_daemon.restart_connector(connector,c.integration_daemon, c.integration_daemon_url,
+                                   c.userid, c.password)
+
+integration_daemon.add_command(integration_daemon_actions.add_catalog_target)
+integration_daemon.add_command(integration_daemon_actions.remove_catalog_target)
+integration_daemon.add_command(integration_daemon_actions.update_catalog_target)
+integration_daemon.add_command(integration_daemon_actions.stop_server)
+integration_daemon.add_command(integration_daemon_actions.start_server)
+
+
+if __name__ == '__main__':
+    cli()

pyegeria-0.5.8.0/examples/widgets/operational/engine_actions.py

@@ -0,0 +1,91 @@
+"""
+SPDX-License-Identifier: Apache-2.0
+Copyright Contributors to the ODPi Egeria project.
+
+
+
+This script restarts an integration daemon.
+
+"""
+
+import os
+from rich import print, print_json
+from rich.console import Console
+
+import time
+import click
+from ops_config import Config, pass_config
+from pyegeria import ServerOps, AutomatedCuration, INTEGRATION_GUIDS
+from pyegeria._exceptions import (
+    InvalidParameterException,
+    PropertyServerException,
+    UserNotAuthorizedException,
+    print_exception_response,
+)
+
+
+@click.command('add-target')
+@click.argument('integration-connector')
+@click.argument('metadata-element')
+@click.argument('catalog-target-name')
+@click.pass_context
+def add_catalog_target(ctx, integration_connector: str, metadata_element_guid:str, catalog_target_name:str)-> str:
+    """Add catalog targets to the specified integration connector"""
+    try:
+        if integration_connector not in INTEGRATION_GUIDS.keys():
+            click.echo('Integration connector is not known')
+
+        c = ctx.obj
+        a_client = AutomatedCuration(c.view_server, c.view_server_url, c.userid, c.password)
+        token = a_client.create_egeria_bearer_token()
+
+        guid = a_client.add_catalog_target(INTEGRATION_GUIDS[integration_connector], metadata_element_guid,
+                                           catalog_target_name)
+
+        click.echo(f"Added catalog target to {integration_connector} with a return guid of {guid}")
+
+
+    except (InvalidParameterException, PropertyServerException) as e:
+        print_exception_response(e)
+
+
+
+@click.command('remove-target')
+@click.argument('relationship-guid')
+@click.pass_context
+def remove_catalog_target(ctx, relationship_guid: str):
+    """Remove the catalog target specified by the relationship guidr"""
+    try:
+        c = ctx.obj
+        a_client = AutomatedCuration(c.view_server, c.view_server_url, c.userid, c.password)
+        token = a_client.create_egeria_bearer_token()
+
+        a_client.remove_catalog_target(relationship_guid)
+
+        click.echo(f"Removed catalog target with relationship guid of {relationship_guid}")
+
+
+    except (InvalidParameterException, PropertyServerException) as e:
+        print_exception_response(e)
+
+
+@click.command('update-target')
+@click.argument('relationship-guid')
+@click.argument('catalog-target-name')
+@click.pass_context
+def update_catalog_target(ctx, relationship_guid: str, catalog_target_name:str):
+    """Update the catalog target specified by the relationship guid """
+    try:
+        c = ctx.obj
+        a_client = AutomatedCuration(c.view_server, c.view_server_url, c.userid, c.password)
+        token = a_client.create_egeria_bearer_token()
+
+        guid = a_client.update_catalog_target(relationship_guid, catalog_target_name)
+
+        click.echo(f"Update catalog target with relationship guid of  {relationship_guid} to a catalog target name of "
+                   f"{catalog_target_name} with a return guid of {guid}")
+
+
+    except (InvalidParameterException, PropertyServerException) as e:
+        print_exception_response(e)
+