pyegeria 0.7.15__tar.gz → 0.7.17__tar.gz

{pyegeria-0.7.15 → pyegeria-0.7.17}/PKG-INFO

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

{pyegeria-0.7.15 → pyegeria-0.7.17}/examples/widgets/cli/egeria.py

@@ -24,6 +24,7 @@ from examples.widgets.cat.list_projects import display_project_list
 from examples.widgets.cat.list_tech_types import display_tech_types
 from examples.widgets.cat.list_todos import display_to_dos
 from examples.widgets.cli.ops_config import Config
+from examples.widgets.cat.list_relationships import list_relationships
 
 from examples.widgets.ops.engine_actions import start_server as start_engine_host, \
     stop_server as stop_engine_host
@@ -51,7 +52,8 @@ from examples.widgets.tech.list_relationship_types import display_relationship_t
 from examples.widgets.tech.list_tech_templates import display_templates_spec
 from examples.widgets.tech.list_valid_metadata_values import display_metadata_values
 from examples.widgets.tech.list_elements import list_elements
-from examples.widgets.cat.list_relationships import list_relationships
+from examples.widgets.tech.list_related_specification import display_related_specification
+
 
 @tui()
 # @tui('menu', 'menu', 'A textual command line interface')
@@ -275,6 +277,17 @@ def show_registered_services(ctx, services):
     display_registered_svcs(services, c.view_server, c.view_server_url,
                             c.userid, c.password, c.jupyter, c.width)
 
+@show.command('related-specifications')
+@click.pass_context
+@click.argument('element-guid')
+def show_related_specifications(ctx, element_guid):
+    """List specifications related to the given Element"""
+    c = ctx.obj
+    display_related_specification(element_guid, c.view_server, c.view_server_url,
+                            c.userid, c.password, c.jupyter, c.width)
+
+
+
 
 @show.command('relationship-types')
 @click.option('--rel-type', default='AssetOwner', help='Relationship type to get information about')

{pyegeria-0.7.15 → pyegeria-0.7.17}/examples/widgets/cli/egeria_tech.py

@@ -23,6 +23,7 @@ from examples.widgets.tech.list_tech_templates import display_templates_spec
 from examples.widgets.tech.list_valid_metadata_values import display_metadata_values
 from examples.widgets.cat.get_tech_type_template import template_viewer
 from examples.widgets.tech.list_elements import list_elements
+from examples.widgets.tech.list_related_specification import display_related_specification
 
 
 
@@ -216,7 +217,14 @@ def get_element_info(ctx, om_type):
     list_elements(om_type, c.view_server, c.view_server_url,
                             c.userid, c.password,  c.jupyter, c.width)
 
-
+@show.command('related-specifications')
+@click.pass_context
+@click.argument('element-guid')
+def show_related_specifications(ctx, element_guid):
+    """List specifications related to the given Element"""
+    c = ctx.obj
+    display_related_specification(element_guid,c.view_server, c.view_server_url,
+                            c.userid, c.password, c.jupyter, c.width)
 
 #
 #  Tell

{pyegeria-0.7.15 → pyegeria-0.7.17}/examples/widgets/ops/engine_actions.py

@@ -4,15 +4,9 @@ Copyright Contributors to the ODPi Egeria project.
 
 
 
-This script restarts an integration daemon.
+Execute engine actions.
 
 """
-
-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, Platform

{pyegeria-0.7.15 → pyegeria-0.7.17}/examples/widgets/ops/list_catalog_targets.py

@@ -3,10 +3,10 @@
 SPDX-License-Identifier: Apache-2.0
 Copyright Contributors to the ODPi Egeria project.
 
-Unit tests for the Utils helper functions using the Pytest framework.
 
 
 List catalog targets
+
 """
 import argparse
 import os

pyegeria-0.7.17/examples/widgets/tech/list_related_specification.py

@@ -0,0 +1,144 @@
+#!/usr/bin/env python3
+"""
+SPDX-License-Identifier: Apache-2.0
+Copyright Contributors to the ODPi Egeria project.
+
+List elements related to given element guid by the specified relationship type. Optionally filter by a specified
+open metadata type.
+
+"""
+import argparse
+import os
+import sys
+import time
+
+from rich import box
+from rich.console import Console
+from rich.markdown import Markdown
+from rich.prompt import Prompt
+from rich.table import Table
+
+from pyegeria import (InvalidParameterException, PropertyServerException, UserNotAuthorizedException,
+                      print_exception_response, ClassificationManager)
+
+console = Console()
+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_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')
+EGERIA_JUPYTER = bool(os.environ.get('EGERIA_JUPYTER', 'False'))
+EGERIA_WIDTH = int(os.environ.get('EGERIA_WIDTH', '200'))
+
+
+def display_related_specification(element_guid: str, server: str, url: str, username: str, password: str,
+                                  jupyter: bool = EGERIA_JUPYTER, width: int = EGERIA_WIDTH):
+    c_client = ClassificationManager(server, url, user_id=username, user_pwd=password)
+    token = c_client.create_egeria_bearer_token()
+    rel_el = c_client.get_related_elements(element_guid, 'SpecificationPropertyAssignment', None)
+
+    if type(rel_el) is str:
+        print(f"\n\nWas not able list related specifications for {element_guid}\n\n")
+        sys.exit(0)
+
+    related_elements: dict = {}
+
+    def generate_table() -> Table:
+        """Make a new table."""
+        table = Table(title=f"Specifications related to: {element_guid}  @ {time.asctime()}",
+            style="bold bright_white on black", row_styles=["bold bright_white on black"],
+            header_style="white on dark_blue", title_style="bold bright_white on black", caption_style="white on black",
+            show_lines=True, box=box.ROUNDED, caption=f"Elements from Server '{server}' @ Platform - {url}",
+            expand=True, # width=500
+        )
+
+        table.add_column("Name", justify='center', style="bold bright_white")
+        table.add_column("Specification", justify='center', style="bold bright_white")
+
+        for element in rel_el:
+            relationship_props = element["relationshipProperties"]['propertyType']
+            related_elements[relationship_props] = []
+
+        for element in rel_el:
+            relationship_props = element["relationshipProperties"]['propertyType']
+
+            rel_element = element['relatedElement']
+            el = rel_element["properties"]
+            re: dict = {}
+
+            re['case'] = el.get("isCaseSensitive", '---')
+            re['name'] = el.get("preferredValue", '---')
+            re['description'] = el.get("description", '---')
+            add = el.get("additionalProperties", '---')
+            if type(add) is str:
+                re['additional'] = add
+            else:
+                add_md = ""
+                for k in add.keys():
+                    add_md += f"* {k}: {add[k]}\n"
+                re['additional'] = Markdown(add_md)
+
+            related_elements[relationship_props].append(re)
+
+        for kind in related_elements.keys():
+
+            spec_table = Table(expand=False, show_lines=True)
+            spec_table.add_column('Name')
+            spec_table.add_column('Case Sensitive?')
+            spec_table.add_column('Description')
+            spec_table.add_column('Additional Properties')
+
+            for spec_row in related_elements[kind]:
+                name = spec_row['name']
+                case = spec_row['case']
+                desc = spec_row['description']
+                additional_props = spec_row['additional']
+                spec_table.add_row(name, case, desc, additional_props)
+
+            table.add_row(kind, spec_table)
+
+        return table
+
+    try:
+        console = Console(width=width, force_terminal=not jupyter)
+
+        with console.pager(styles=True):
+            console.print(generate_table())
+
+    except (InvalidParameterException, PropertyServerException, UserNotAuthorizedException) as e:
+        print_exception_response(e)
+        assert e.related_http_code != "200", "Invalid parameters"
+    finally:
+        c_client.close_session()
+
+
+def main():
+    parser = argparse.ArgumentParser()
+    parser.add_argument("--server", help="Name of the server to display status for")
+    parser.add_argument("--url", help="URL Platform to connect to")
+    parser.add_argument("--userid", help="User Id")
+    parser.add_argument("--password", help="Password")
+
+    args = parser.parse_args()
+
+    server = args.server if args.server is not None else EGERIA_VIEW_SERVER
+    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
+    password = args.password if args.password is not None else EGERIA_USER_PASSWORD
+    guid = None
+
+    try:
+        element_guid = Prompt.ask("Enter an Element GUID find relationships for")
+
+        display_related_specification(element_guid, server, url, userid, password)
+    except(KeyboardInterrupt):
+        pass
+
+
+if __name__ == "__main__":
+    main()

pyegeria-0.7.17/examples/widgets/tech/x_list_related_elements.py

@@ -0,0 +1,145 @@
+#!/usr/bin/env python3
+"""
+SPDX-License-Identifier: Apache-2.0
+Copyright Contributors to the ODPi Egeria project.
+
+List elements related to given element guid by the specified relationship type. Optionally filter by a specified
+open metadata type.
+
+"""
+import argparse
+import os
+import sys
+import time
+
+from rich import box
+from rich.console import Console
+from rich.markdown import Markdown
+from rich.prompt import Prompt
+from rich.table import Table
+
+from pyegeria import (
+    InvalidParameterException,
+    PropertyServerException,
+    UserNotAuthorizedException,
+    print_exception_response,
+    ClassificationManager
+)
+
+console = Console()
+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_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')
+EGERIA_JUPYTER = bool(os.environ.get('EGERIA_JUPYTER', 'False'))
+EGERIA_WIDTH = int(os.environ.get('EGERIA_WIDTH', '200'))
+
+
+def display_related_elements(element_guid: str, relationship: str, om_type: str, server: str,
+                             url: str, username: str, password: str, jupyter: bool = EGERIA_JUPYTER,
+                             width: int = EGERIA_WIDTH
+                             ):
+    c_client = ClassificationManager(server, url, user_id=username, user_pwd=password)
+    token = c_client.create_egeria_bearer_token()
+    rel_el = c_client.get_related_elements(element_guid, relationship, om_type)
+
+    if type(rel_el) is str:
+        print(f"\n\nWas not able find related elements for {element_guid} with relationship {relationship}\n\n")
+        sys.exit(0)
+
+    def generate_table() -> Table:
+        """Make a new table."""
+        table = Table(
+            title=f"Elements Related to guid: {element_guid} by relationship: {relationship}  @ {time.asctime()}",
+            style="bold bright_white on black",
+            row_styles=["bold bright_white on black"],
+            header_style="white on dark_blue",
+            title_style="bold bright_white on black",
+            caption_style="white on black",
+            show_lines=True,
+            box=box.ROUNDED,
+            caption=f"Elements from Server '{server}' @ Platform - {url}",
+            expand=True,
+            # width=500
+        )
+
+        table.add_column("Relationship Properties")
+        table.add_column("Preferred Value")
+        table.add_column("Case Sensitive")
+        table.add_column("Description")
+        table.add_column("Additional Properties")
+
+        for related_element in rel_el:
+            relationship_props = related_element["relationshipProperties"]
+
+            rel_prop_md = ''
+            for key in relationship_props.keys():
+                rel_prop_md += f"{key}: {relationship_props[key]}\n"
+            # rel_prop_out = Markdown(rel_prop_md)
+
+            rel_element = related_element['relatedElement']
+            el = rel_element["properties"]
+            for prop in el:
+                el_case = el.get("isCaseSensitive", '---')
+                el_pref = el.get("preferredValue", '---')
+                el_desc = el.get("description", '---')
+                el_add = el.get("additionalProperties", '---')
+
+                el_add_md = ''
+                el_add_f = el_add.replace('\u003d',':')
+                s = el_add.strip('{}').strip()
+                pairs = [i.split('=') for i in s.split(', ')]
+                # d_add_prop = dict(pairs)
+                # for key in d_add_prop.keys():
+                #     el_add_md += f"{key}: {d_add_prop[key]}\n"
+                # el_add_out = Markdown(el_add_md)
+
+            table.add_row(rel_prop_md, el_pref, el_case, el_desc, s)
+
+        return table
+
+    try:
+        console = Console(width=width, force_terminal=not jupyter)
+
+        with console.pager(styles=True):
+            console.print(generate_table())
+
+    except (InvalidParameterException, PropertyServerException, UserNotAuthorizedException) as e:
+        print_exception_response(e)
+        assert e.related_http_code != "200", "Invalid parameters"
+    finally:
+        c_client.close_session()
+
+
+def main():
+    parser = argparse.ArgumentParser()
+    parser.add_argument("--server", help="Name of the server to display status for")
+    parser.add_argument("--url", help="URL Platform to connect to")
+    parser.add_argument("--userid", help="User Id")
+    parser.add_argument("--password", help="Password")
+
+    args = parser.parse_args()
+
+    server = args.server if args.server is not None else EGERIA_VIEW_SERVER
+    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
+    password = args.password if args.password is not None else EGERIA_USER_PASSWORD
+    guid = None
+
+    try:
+        element_guid = Prompt.ask("Enter an Element GUID find relationships for")
+        relationship = Prompt.ask("Enter the relationship to search", default="SpecificationPropertyAssignment")
+        om_type = Prompt.ask("Enter an optional Open Metadata Type", default=None)
+        display_related_elements(element_guid, relationship, om_type, server, url, userid, password)
+    except(KeyboardInterrupt):
+        pass
+
+
+if __name__ == "__main__":
+    main()

{pyegeria-0.7.15 → pyegeria-0.7.17}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "pyegeria"
-version = "0.7.15"
+version = "0.7.17"
 license = 'Apache 2.0'
 authors = ["Dan Wolfson <dan.wolfson@pdr-associates.com>"]
 readme = "README.md"
@@ -100,5 +100,6 @@ pytest = "^8.2.2"
     list_tech_templates = "examples.widgets.tech.list_tech_templates:main"
     get_element_info = "examples.widgets.tech.get_element_info:main"
     list_elements = "examples.widgets.tech.list_elements:main"
+    list_related_specification = "examples.widgets.tech.list_related_specification:main"
 
     list_valid_metadata_values = "examples.widgets.tech.list_valid_metadata_values:main"