pyegeria 0.7.17__tar.gz → 0.7.19__tar.gz

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

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

pyegeria-0.7.19/examples/widgets/cat/get_project_dependencies.py

@@ -0,0 +1,135 @@
+#!/usr/bin/env python3
+"""
+SPDX-License-Identifier: Apache-2.0
+Copyright Contributors to the ODPi Egeria project.
+
+A simple viewer for project dependencies - provide the root and we display the dependency tree
+
+"""
+
+import argparse
+import os
+
+from rich import print
+from rich.console import Console
+from rich.markdown import Markdown
+from rich.panel import Panel
+from rich.prompt import Prompt
+from rich.tree import Tree
+
+from pyegeria import (ProjectManager, UserNotAuthorizedException, PropertyServerException, InvalidParameterException)
+from pyegeria._exceptions import (print_exception_response, )
+
+disable_ssl_warnings = True
+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 project_dependency_viewer(root: str, server_name: str, platform_url: str, user: str, user_password: str,
+                             jupyter: bool = EGERIA_JUPYTER, width: int = EGERIA_WIDTH, timeout: int = 30):
+    """ A simple collection viewer"""
+
+    def walk_project_hierarchy(project_client: ProjectManager, project_name: str, tree: Tree,
+                               root: bool = False) -> None:
+        """Recursively build a Tree with collection contents."""
+        t = None
+        style = "bright_white on black"
+
+        project = project_client.get_projects_by_name(project_name)
+        if type(project) is list:
+            proj_guid = project[0]['elementHeader']['guid']
+            proj_props = project[0]['properties']
+
+            proj_type = proj_props.get('typeName', '---')
+            proj_unique = proj_props.get('qualifiedName', '---')
+            proj_identifier = proj_props.get('identifier', '---')
+            proj_name = proj_props.get('name', '---')
+            proj_desc = proj_props.get('description', '---')
+            proj_status = proj_props.get('projectStatus', '---')
+            proj_priority = proj_props.get('priority', '---')
+            proj_start = proj_props.get('startDate', '---')[:-10]
+            proj_props_md = (f"* Name: {proj_name}\n"
+                             f"* Identifier: {proj_identifier}\n"
+                             f"* Type: {proj_type}\n"
+                             f"* Status: {proj_status}\n"
+                             f"* priority: {proj_priority}\n"
+                             f"* Start:    {proj_start}\n"
+                             f"* Description: {proj_desc}\n"
+                             f"* GUID: {proj_guid}")
+        else:
+            return
+
+        team = project_client.get_project_team(proj_guid)
+        member_md = ""
+        if type(team) is list:
+            for member in team:
+                member_guid = member['member']['guid']
+                member_unique = member['member']['uniqueName']
+                member_md += f"* Member Unique Name: {member_unique}\n* Member GUID: {member_guid}"
+            proj_props_md += f"\n### Team Members\n {member_md}"
+
+        proj_props_out = Markdown(proj_props_md)
+        p = Panel.fit(proj_props_out, style=style, title=project_name)
+        t = tree.add(p)
+
+        linked_projects = project_client.get_linked_projects(proj_guid)
+        if type(linked_projects) is list:
+            for proj in linked_projects:
+                child_md = ""
+                child_guid = proj['elementHeader']['guid']
+                child_name = proj['properties']['name']
+                relationship = proj['relatedElement']['relationshipHeader']['type']['typeName']
+                if relationship != 'ProjectDependency':
+                    continue
+                walk_project_hierarchy(project_client, child_name, t)
+
+        else:
+            return t
+
+    try:
+        console = Console(width=width, force_terminal=not jupyter)
+        tree = Tree(f"[bold bright green on black]{root}", guide_style="bold bright_blue")
+        p_client = ProjectManager(server_name, platform_url, user_id=user)
+
+        token1 = p_client.create_egeria_bearer_token(user, user_password)
+
+        walk_project_hierarchy(p_client, root, tree, root=True)
+        print(tree)
+
+    except (InvalidParameterException, PropertyServerException, UserNotAuthorizedException) as e:
+        print_exception_response(e)
+
+
+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="User 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
+    user_pass = args.password if args.password is not None else EGERIA_USER_PASSWORD
+
+    try:
+        root_project = Prompt.ask("Enter the Root Project to start from:", default="Sustainability Campaign")
+        project_dependency_viewer(root_project, server, url, userid, user_pass)
+    except (KeyboardInterrupt):
+        pass
+
+
+if __name__ == "__main__":
+    main()

{pyegeria-0.7.17 → pyegeria-0.7.19}/examples/widgets/cat/get_project_structure.py

@@ -88,6 +88,9 @@ def project_structure_viewer(root: str, server_name: str, platform_url: str, use
                 child_md = ""
                 child_guid = proj['elementHeader']['guid']
                 child_name = proj['properties']['name']
+                relationship = proj['relatedElement']['relationshipHeader']['type']['typeName']
+                if relationship != 'ProjectHierarchy':
+                    continue
                 walk_project_hierarchy(project_client, child_name, t)
 
         else:

{pyegeria-0.7.17 → pyegeria-0.7.19}/examples/widgets/cat/list_todos.py

@@ -15,6 +15,7 @@ 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
 
@@ -40,7 +41,7 @@ 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_to_dos(search_string: str, server: str, url: str, username: str, user_pass:str,
+def display_to_dos(search_string: str, status_filter: str, server: str, url: str, username: str, user_pass:str,
                    jupyter:bool=EGERIA_JUPYTER, width:int = EGERIA_WIDTH):
 
     m_client = MyProfile(server, url, user_id=username)
@@ -60,15 +61,16 @@ def display_to_dos(search_string: str, server: str, url: str, username: str, use
 
         table.add_column("Name")
         table.add_column("Type Name")
-
+        table.add_column("GUID", no_wrap=True)
         table.add_column("Created")
         table.add_column("Priority")
         table.add_column("Due")
         table.add_column("Completion")
         table.add_column("Status")
         table.add_column("Sponsor")
+        table.add_column("Assigned")
 
-        todo_items = m_client.find_to_do(search_string)
+        todo_items = m_client.find_to_do(search_string,status = status_filter)
 
         if type(todo_items) is str:
             name = " "
@@ -80,18 +82,27 @@ def display_to_dos(search_string: str, server: str, url: str, username: str, use
 
             status = " "
             sponsor = " "
+            assigned_out = ''
         else:
             for item in todo_items:
+                guid = item['elementHeader']['guid']
                 props = item["properties"]
                 name = props["name"]
                 type_name = props.get("toDoType", " ")
-                created = props.get("creationTime", " ")
+                created = props.get("creationTime", " ")[:-19]
                 priority = str(props.get("priority", " "))
-                due = props.get("dueTime", " ")
-                completed = props.get("completionTime", " ")
-                status = props.get("status")
-                # assigned_actors = item["assignedActors"]
-                # sponsor = assigned_actors[0].get("uniqueName", " ")
+                due = props.get("dueTime", "          ")[:-19]
+                completed = props.get("completionTime", "           ")[:-10]
+                status = props.get("toDoStatus")
+
+                assigned_out = ''
+                assigned_actors = item["assignedActors"]
+                if type(assigned_actors) is list:
+                    assigned_md = ''
+                    for actor in assigned_actors:
+                        assigned_md += f"* {actor['uniqueName'].split(',')[0]}\n"
+                    assigned_out = Markdown(assigned_md)
+
                 sponsor = "erinoverview"
                 if status in ("WAITING", "OPEN"):
                     status = f"[yellow]{status}"
@@ -101,7 +112,7 @@ def display_to_dos(search_string: str, server: str, url: str, username: str, use
                     status = f"[red]{status}"
 
                 table.add_row(
-                    name, type_name, created, priority, due, completed, status, sponsor
+                    name, type_name, guid, created, priority, due, completed, status, sponsor, assigned_out
                 )
 
         m_client.close_session()
@@ -140,8 +151,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
     try:
-        search_string = Prompt.ask("Enter the ToDo you are searching for:", default="*")
-        display_to_dos(search_string, server, url, userid, user_pass)
+        search_string = Prompt.ask("Enter the ToDo you are searching for", default="*")
+        status_filter = Prompt.ask("Enter an optional status filter ['OPEN','IN_PROGRESS','WAITING','COMPLETE',"
+                                   "'ABANDONED', 'None']", default=None)
+        display_to_dos(search_string, status_filter,server, url, userid, user_pass)
     except KeyboardInterrupt:
         pass
 

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

@@ -13,6 +13,7 @@ import click
 from trogon import tui
 
 from examples.widgets.cat.get_project_structure import project_structure_viewer
+from examples.widgets.cat.get_project_dependencies import project_dependency_viewer
 from examples.widgets.cat.list_cert_types import display_certifications
 from examples.widgets.cat.get_asset_graph import asset_viewer
 from examples.widgets.cat.get_collection import collection_viewer
@@ -22,7 +23,7 @@ from examples.widgets.cat.list_assets import display_assets
 from examples.widgets.cat.list_glossary import display_glossary_terms
 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.cat.list_todos import display_to_dos as list_todos
 from examples.widgets.cli.ops_config import Config
 from examples.widgets.cat.list_relationships import list_relationships
 
@@ -52,6 +53,7 @@ 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.tech.get_element_info import display_elements
 from examples.widgets.tech.list_related_specification import display_related_specification
 
 
@@ -199,11 +201,20 @@ def show(ctx):
     pass
 
 
-@show.command("list-elements")
+@show.command("get-elements")
 @click.pass_context
 @click.option('--om_type', default='Project', help='Metadata type to query')
 def get_element_info(ctx, om_type):
-    """Display the valid metadata values for a property and type"""
+    """Display the elements for an Open Metadata Type"""
+    c = ctx.obj
+    display_elements(om_type, c.view_server, c.view_server_url,
+                            c.userid, c.password,  c.jupyter, c.width)
+
+@show.command("list-elements")
+@click.pass_context
+@click.option('--om_type', default='Project', help='Metadata type to query')
+def list_element_info(ctx, om_type):
+    """Display the elements for an Open Metadata Type"""
     c = ctx.obj
     list_elements(om_type, c.view_server, c.view_server_url,
                             c.userid, c.password,  c.jupyter, c.width)
@@ -405,11 +416,23 @@ def show_certification_types(ctx, search_string):
               help="Enter the root project to start from")
 @click.pass_context
 def show_project_structure(ctx, project):
-    """Show the structure of the project starting from a root project"""
+    """Show the organization structure of the project starting from a root project"""
     c = ctx.obj
     project_structure_viewer(project, c.view_server, c.view_server_url, c.userid,
                            c.password, c.jupyter, c.width, c.timeout)
 
+@show.command('project-dependencies')
+@click.option('--project', default = 'Clinical Trials Management',
+              help="Enter the root project to start from")
+@click.pass_context
+def show_project_dependencies(ctx, project):
+    """Show the dependencies of a project starting from a root project"""
+    c = ctx.obj
+    project_dependency_viewer(project, c.view_server, c.view_server_url, c.userid,
+                           c.password, c.jupyter, c.width, c.timeout)
+
+
+
 @show.command('relationships')
 @click.option('--relationship', default = 'Certification',
               help="Relationship type name to search for.")
@@ -490,11 +513,13 @@ def show_projects(ctx, search_string):
 @show.command('to-dos')
 @click.option('--search-string', default='*',
               help='View the list of To-Do items')
+@click.option('--status', type=click.Choice(['OPEN','IN_PROGRESS','WAITING','COMPLETE', 'ABANDONED', 'None'],
+               case_sensitive='False'), help = 'Enter an optional status filter', required=False, default=None)
 @click.pass_context
-def show_todos(ctx, search_string):
+def show_todos(ctx, search_string, status):
     """Display a tree graph of information about an asset """
     c = ctx.obj
-    display_to_dos(search_string, c.view_server, c.view_server_url, c.userid,
+    list_todos(search_string, status, c.view_server, c.view_server_url, c.userid,
                    c.password, c.jupyter, c.width)
 
 

{pyegeria-0.7.17 → pyegeria-0.7.19}/examples/widgets/cli/egeria_cat.py

@@ -20,8 +20,9 @@ from examples.widgets.cat.list_assets import display_assets
 from examples.widgets.cat.list_glossary import display_glossary_terms
 from examples.widgets.cat.list_tech_types import display_tech_types
 from examples.widgets.cat.list_projects import display_project_list
-from examples.widgets.cat.list_todos import display_to_dos
+from examples.widgets.cat.list_todos import display_to_dos as list_todos
 from examples.widgets.cat.get_project_structure import project_structure_viewer
+from examples.widgets.cat.get_project_dependencies import project_dependency_viewer
 from examples.widgets.cat.list_cert_types import display_certifications
 from examples.widgets.cat.list_relationships import list_relationships
 
@@ -207,11 +208,23 @@ def show_certification_types(ctx, search_string):
               help="Enter the root project to start from")
 @click.pass_context
 def show_project_structure(ctx, project):
-    """Show the structure of the project starting from a root project"""
+    """Show the organization structure of the project starting from a root project"""
     c = ctx.obj
     project_structure_viewer(project, c.view_server, c.view_server_url, c.userid,
                            c.password, c.jupyter, c.width, c.timeout)
 
+@show.command('project-dependencies')
+@click.option('--project', default = 'Clinical Trials Management',
+              help="Enter the root project to start from")
+@click.pass_context
+def show_project_dependencies(ctx, project):
+    """Show the dependencies of a project starting from a root project"""
+    c = ctx.obj
+    project_dependency_viewer(project, c.view_server, c.view_server_url, c.userid,
+                           c.password, c.jupyter, c.width, c.timeout)
+
+
+
 @show.command('relationships')
 @click.option('--relationship', default = 'Certification',
               help="Relationship type name to search for.")
@@ -227,12 +240,14 @@ def show_relationships(ctx, relationship):
 @show.command('to-dos')
 @click.option('--search-string', default='*',
               help='View the list of To-Do items')
+@click.option('--status', type=click.Choice(['OPEN','IN_PROGRESS','WAITING','COMPLETE', 'ABANDONED', 'None'],
+               case_sensitive='False'), help = 'Enter an optional status filter', required=False, default=None)
 @click.pass_context
-def show_todos(ctx, search_string):
+def show_todos(ctx, search_string, status):
     """Display a tree graph of information about an asset """
     c = ctx.obj
-    display_to_dos(search_string, c.view_server, c.view_server_url, c.userid,
-                      c.password, c.jupyter, c.width)
+    list_todos(search_string, status, c.view_server, c.view_server_url, c.userid,
+                   c.password, c.jupyter, c.width)
 
 #
 #  Tell

{pyegeria-0.7.17 → pyegeria-0.7.19}/examples/widgets/cli/egeria_my.py

@@ -12,13 +12,15 @@ This is an emerging capability based on the **click** package. Feedback welcome!
 import click
 from trogon import tui
 
+from examples.widgets.cat import list_todos
 from examples.widgets.cli.ops_config import Config
 
 from examples.widgets.my.monitor_open_todos import display_todos
 from examples.widgets.my.monitor_my_todos import display_my_todos
 from examples.widgets.my.list_my_profile import display_my_profile
 from examples.widgets.my.list_my_roles import display_my_roles
-
+from examples.widgets.my.todo_actions import create_todo, delete_todo, change_todo_status, mark_todo_complete, \
+    reassign_todo
 
 
 # class Config(object):
@@ -148,6 +150,11 @@ def show_open_todos(ctx):
 def tell(ctx):
     """Perform actions an Egeria Objects"""
     pass
+tell.add_command(create_todo)
+tell.add_command(delete_todo)
+tell.add_command(change_todo_status)
+tell.add_command(mark_todo_complete)
+tell.add_command(reassign_todo)
 
 
 if __name__ == '__main__':

{pyegeria-0.7.17 → pyegeria-0.7.19}/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.get_element_info import display_elements
 from examples.widgets.tech.list_related_specification import display_related_specification
 
 
@@ -111,6 +112,16 @@ def show_guid_infos(ctx, guid):
     display_guid(guid, c.server, c.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('tech-types')
 @click.option('--search-string', default='*', help='Tech type to search for')
@@ -211,20 +222,21 @@ def valid_metadata_values(ctx, property, type_name):
 @show.command('list-elements')
 @click.pass_context
 @click.option('--om_type', default='Organization', help='Metadata type to query')
-def get_element_info(ctx, om_type):
+def list_element_info(ctx, om_type):
     """Display the valid metadata values for a property and type"""
     c = ctx.obj
     list_elements(om_type, c.view_server, c.view_server_url,
                             c.userid, c.password,  c.jupyter, c.width)
 
-@show.command('related-specifications')
+@show.command("get-elements")
 @click.pass_context
-@click.argument('element-guid')
-def show_related_specifications(ctx, element_guid):
-    """List specifications related to the given Element"""
+@click.option('--om_type', default='Project', help='Metadata type to query')
+def get_element_info(ctx, om_type):
+    """Display the elements for an Open Metadata Type"""
     c = ctx.obj
-    display_related_specification(element_guid,c.view_server, c.view_server_url,
-                            c.userid, c.password, c.jupyter, c.width)
+    display_elements(om_type, c.view_server, c.view_server_url,
+                            c.userid, c.password,  c.jupyter, c.width)
+
 
 #
 #  Tell

pyegeria-0.7.19/examples/widgets/my/todo_actions.py

@@ -0,0 +1,160 @@
+"""
+SPDX-License-Identifier: Apache-2.0
+Copyright Contributors to the ODPi Egeria project.
+
+
+
+Execute ToDo actions.
+
+"""
+import json
+import time
+
+import click
+# from ops_config import Config, pass_config
+from pyegeria import ServerOps, AutomatedCuration, INTEGRATION_GUIDS, MyProfile
+from pyegeria._exceptions import (
+    InvalidParameterException,
+    PropertyServerException,
+    UserNotAuthorizedException,
+    print_exception_response,
+)
+
+erins_guid = "a588fb08-ae09-4415-bd5d-991882ceacba"
+peter_guid	="a187bc48-8154-491f-97b4-a2f3c3f1a00e"
+tanya_guid	="26ec1614-bede-4b25-a2a3-f8ed26db3aaa"
+
+
+@click.command('create-todo')
+@click.option('--name',prompt='Todo Name',help='Name of Todo', required=True)
+@click.option('--description',prompt='Description',help='Brief description of To Do item', required=True)
+@click.option('--type',prompt='Todo Type',help='Type of Todo', required=True, default = 'forMe')
+@click.option('--priority',prompt='Todo Priority',type = int, help='Priority of Todo', required=True, default= 0)
+@click.option('--due',prompt='Due Date',help='Due date of Todo (yyyy-mm-dd)', required=True)
+@click.option('--assigned-to',prompt='Assigned to',help='Party the Todo is assigned to', required=True,
+              default = 'Peter')
+@click.pass_context
+def create_todo(ctx,name,description,type,priority,due,assigned_to):
+    """Create a new ToDo item"""
+    c = ctx.obj
+    m_client = MyProfile(c.view_server, c.view_server_url, user_id=c.userid, user_pwd=c.password)
+    token = m_client.create_egeria_bearer_token()
+    try:
+        body = {
+            "properties": {
+                "class": "ToDoProperties",
+                "qualifiedName": f"{name}-{time.asctime()}",
+                "name": name,
+                "description": description,
+                "toDoType": type,
+                "priority": priority,
+                "dueTime": due,
+                "status": "OPEN"
+            },
+            "assignToActorGUID": peter_guid
+        }
+
+        resp = m_client.create_to_do(body)
+        # if type(resp) is str:
+        click.echo(f"Response was {resp}")
+        # elif type(resp) is dict:
+        #     click.echo(json.dumps(resp), indent = 2)
+
+    except (InvalidParameterException, PropertyServerException) as e:
+        print_exception_response(e)
+    finally:
+        m_client.close_session()
+
+
+
+@click.command('delete-todo')
+@click.argument('todo-guid')
+@click.pass_context
+def delete_todo(ctx, todo_guid):
+    """Delete the todo item specified """
+    c = ctx.obj
+    m_client = MyProfile(c.view_server, c.view_server_url, user_id=c.userid, user_pwd=c.password)
+    token = m_client.create_egeria_bearer_token()
+    try:
+        m_client.delete_to_do(todo_guid)
+
+        click.echo(f"Deleted Todo item {todo_guid}")
+
+    except (InvalidParameterException, PropertyServerException) as e:
+        print_exception_response(e)
+    finally:
+        m_client.close_session()
+
+@click.command('change-todo-status')
+@click.argument('todo-guid')
+@click.option('--new-status', type=click.Choice(['OPEN','IN_PROGRESS','WAITING','COMPLETE', 'ABANDONED'],
+               case_sensitive='False'), help = 'Enter the new ToDo item status', required=True)
+@click.pass_context
+def change_todo_status(ctx, todo_guid, new_status):
+    """Update a ToDo item status"""
+    c = ctx.obj
+    m_client = MyProfile(c.view_server, c.view_server_url, user_id=c.userid, user_pwd=c.password)
+    token = m_client.create_egeria_bearer_token()
+    try:
+
+
+        body = {
+            "properties": {
+                "class": "ToDoProperties",
+                "toDoStatus": new_status
+            },
+        }
+        m_client.update_to_do(todo_guid, body, is_merge_update=True)
+
+        click.echo(f"Marked todo item {todo_guid} as complete.")
+
+    except (InvalidParameterException, PropertyServerException) as e:
+        print_exception_response(e)
+    finally:
+        m_client.close_session()
+
+@click.command('mark-todo-complete')
+@click.argument('todo-guid')
+@click.pass_context
+def mark_todo_complete(ctx, todo_guid):
+    """Mark the specified todo as complete"""
+    try:
+        c = ctx.obj
+        m_client = MyProfile(c.view_server, c.view_server_url, user_id=c.userid, user_pwd=c.password)
+        token = m_client.create_egeria_bearer_token()
+        body = {
+            "properties": {
+                "class": "ToDoProperties",
+                "completionTime" : time.asctime(),
+                "toDoStatus": "COMPLETE"
+            },
+        }
+        m_client.update_to_do(todo_guid, body, is_merge_update=True)
+
+        click.echo(f"Marked todo item {todo_guid} as complete.")
+
+    except (InvalidParameterException, PropertyServerException) as e:
+        print_exception_response(e)
+    finally:
+        m_client.close_session()
+        
+
+@click.command('reassign-todo')
+@click.argument('todo-guid')
+@click.argument('new-actor-guid')
+@click.pass_context
+def reassign_todo(ctx, todo_guid, new_actor_guid):
+    """Reassign ToDo item to new actor"""
+    c = ctx.obj
+    m_client = MyProfile(c.view_server, c.view_server_url, user_id=c.userid, user_pwd=c.password)
+    token = m_client.create_egeria_bearer_token()
+    try:
+
+        m_client.reassign_to_do(todo_guid, new_actor_guid)
+
+        click.echo(f"Reassigned Todo item {todo_guid} to {new_actor_guid}")
+
+    except (InvalidParameterException, PropertyServerException) as e:
+        print_exception_response(e)
+    finally:
+        m_client.close_session()

pyegeria-0.7.19/examples/widgets/tech/get_element_info.py

@@ -0,0 +1,119 @@
+#!/usr/bin/env python3
+"""
+SPDX-Lic
+ense-Identifier: Apache-2.0
+Copyright Contributors to the ODPi Egeria project.
+
+
+A simple display of elements for an Open Metadata Type in tree form.
+"""
+import argparse
+import json
+import os
+import sys
+
+from rich import print, box
+from rich.console import Console
+from rich.markdown import Markdown
+from rich.panel import Panel
+
+from rich.prompt import Prompt
+from rich.text import Text
+from rich.tree import Tree
+
+from pyegeria import (
+    InvalidParameterException,
+    PropertyServerException,
+    UserNotAuthorizedException,
+    Client, ClassificationManager
+)
+
+
+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_elements(om_type: str, server: str, url: str, username: str, user_password: str,
+                 jupyter: bool = EGERIA_JUPYTER, width: int = EGERIA_WIDTH
+                 ):
+    c = ClassificationManager(server, url, user_id=username, user_pwd=user_password)
+
+    bearer_token = c.create_egeria_bearer_token(username, user_password)
+
+    try:
+        console = Console(width=width, force_terminal=not jupyter, style="bold white on black")
+        r = c.get_elements(om_type)
+        if type(r) is not list:
+            print(f"\n\n\tno elements found: {r}")
+            sys.exit(1)
+
+        tree = Tree(f"Elements for Open Metadata Type:{om_type}\n* There are {len(r)} elements", style="bold bright_white on black",
+                    guide_style="bold bright_blue")
+        t = tree.add(f"Elements for {om_type}", style="bold bright_white on black")
+        for element in r:
+            header = element['elementHeader']
+            el_type = header["type"]['typeName']
+            el_home = header['origin']['homeMetadataCollectionName']
+            el_create_time = header['versions']['createTime']
+            el_guid = header['guid']
+
+            el_md = (f"#### Element Basics\n"
+                     f"* **Type**: {el_type}\n"
+                     f"* **Home**: {el_home}\n"
+                     f"* **Created**: {el_create_time}\n"
+                     f"* **GUID**: {el_guid}\n ---\n")
+            for prop in element['properties'].keys():
+                el_md += f"* **{prop}**: {element['properties'][prop]}\n"
+
+            el_out = Markdown(el_md)
+            p = Panel.fit(el_out, title=element['properties']['qualifiedName'],
+                  style = "bold white on black")
+            t = tree.add(p)
+
+        print(tree)
+
+        c.close_session()
+
+    except (InvalidParameterException, PropertyServerException, UserNotAuthorizedException, ValueError) as e:
+        if type(e) is str:
+            console.print_exception()
+        else:
+            # console.print_exception(show_locals=True)
+            console.print(f"\n ===> Looks like the type {om_type} isn't known...\n")
+
+
+
+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="User Password")
+
+    # parser.add_argument("--sponsor", help="Name of sponsor to search")
+    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_VIEW_SERVER_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:
+        om_type = Prompt.ask("Enter the Open Metadata Type to find Elements for", default=None)
+        display_elements(om_type, server, url, userid, user_pass)
+    except (KeyboardInterrupt):
+        pass
+
+
+if __name__ == "__main__":
+    main()

{pyegeria-0.7.17 → pyegeria-0.7.19}/examples/widgets/tech/list_related_specification.py

@@ -43,7 +43,7 @@ def display_related_specification(element_guid: str, server: str, url: str, user
     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")
+        print(f"\n\nDid not find related specifications for {element_guid}\n\n")
         sys.exit(0)
 
     related_elements: dict = {}

{pyegeria-0.7.17 → pyegeria-0.7.19}/pyegeria/my_profile_omvs.py

@@ -392,7 +392,7 @@ class MyProfile(Client):
         response = await self._async_make_request("POST", url, body)
         return response.json().get("guid", "No guid returned")
 
-    def create_to_do(self, body: dict, server_name: str = None) -> None:
+    def create_to_do(self, body: dict, server_name: str = None) -> str:
         """ Create a To-Do item.
             Parameters
             ----------
@@ -534,10 +534,12 @@ class MyProfile(Client):
         if server_name is None:
             server_name = self.server_name
 
+        is_merge_update_t = str(is_merge_update).lower()
+
         validate_name(todo_guid)
 
         url = (f"{self.my_profile_command_root}/{server_name}/api/open-metadata/my-profile/to-dos/"
-               f"{todo_guid}?merge-update={is_merge_update}")
+               f"{todo_guid}?isMergeUpdate={is_merge_update_t}")
 
         await self._async_make_request("POST", url, body)
         return
@@ -576,14 +578,12 @@ class MyProfile(Client):
         loop.run_until_complete(self._async_update_to_do(todo_guid, body, is_merge_update, server_name))
         return
 
-    async def _async_delete_to_do(self, todo_guid: str, status: str = "OPEN", server_name: str = None) -> None:
+    async def _async_delete_to_do(self, todo_guid: str, server_name: str = None) -> None:
         """ Delete a To-Do item. Async version.
             Parameters
             ----------
             todo_guid: str
               Identifier of the To-Do item.
-            status: str
-                Filter items to match this status. Defaults to "OPEN"
             server_name : str, optional
              The name of the server where the to-do item will be created. If not provided,
              the default server name associated with the instance of the class will be used.
@@ -606,21 +606,19 @@ class MyProfile(Client):
             server_name = self.server_name
 
         validate_name(todo_guid)
-        body = {"status": status}
 
-        url = f"{self.my_profile_command_root}/{server_name}/api/open-metadata/my-profile/to-dos/{todo_guid}"
 
-        await self._async_make_request("POST", url, body)
+        url = f"{self.my_profile_command_root}/{server_name}/api/open-metadata/my-profile/to-dos/{todo_guid}/delete"
+
+        await self._async_make_request("POST", url)
         return
 
-    def delete_to_do(self, todo_guid: str, status: str = "OPEN", server_name: str = None) -> None:
+    def delete_to_do(self, todo_guid: str, server_name: str = None) -> None:
         """ Delete a To-Do item.
             Parameters
             ----------
             todo_guid: str
               Identifier of the To-Do item.
-            status: str
-                Filter items to match this status. Defaults to "OPEN"
             server_name : str, optional
              The name of the server where the to-do item will be created. If not provided,
              the default server name associated with the instance of the class will be used.
@@ -640,7 +638,7 @@ class MyProfile(Client):
             The principle specified by the user_id does not have authorization for the requested action
             """
         loop = asyncio.get_event_loop()
-        loop.run_until_complete(self._async_delete_to_do(todo_guid, status, server_name))
+        loop.run_until_complete(self._async_delete_to_do(todo_guid, server_name))
         return
 
     async def _async_reassign_to_do(self, todo_guid: str, actor_guid: str, status: str = "OPEN",
@@ -934,7 +932,7 @@ class MyProfile(Client):
         validate_name(action_target_guid)
 
         url = (f"{self.my_profile_command_root}/{server_name}/api/open-metadata/my-profile/to-dos/"
-               f"action-targets/{action_target_guid}?is_merge_update={is_merge_update_t}")
+               f"action-targets/{action_target_guid}?isMergeUpdate={is_merge_update_t}")
 
         await self._async_make_request("POST", url, body)
         return
@@ -971,3 +969,4 @@ class MyProfile(Client):
                                                                             body, is_merge_update,
                                                                             server_name))
         return
+

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

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "pyegeria"
-version = "0.7.17"
+version = "0.7.19"
 license = 'Apache 2.0'
 authors = ["Dan Wolfson <dan.wolfson@pdr-associates.com>"]
 readme = "README.md"
@@ -63,6 +63,7 @@ pytest = "^8.2.2"
     list_todos = "examples.widgets.cat.list_todos:main"
     list_cert_types = "examples.widgets.cat.list_cert_types:main"
     get_project_structure = "examples.widgets.cat.get_project_structure:main"
+    get_project_dependencies = "examples.widgets.cat.get_project_dependencies:main"
     list_relationships = "examples.widgets.cat.list_relationships:main"
 
     monitor_asset_events = "examples.widgets.ops.monitor_asset_events:main"
@@ -85,6 +86,11 @@ pytest = "^8.2.2"
     list_my_profile = "examples.widgets.my.list_my_profile:main"
     monitor_open_todos = "examples.widgets.my.monitor_open_todos:main"
     monitor_my_todos = "examples.widgets.my.monitor_my_todos:main"
+    create_todo = "examples.widgets.my.todo_actions:create_todo"
+    delete_todo = "examples.widgets.my.todo_actions:delete_todo"
+    change_todo_status = "examples.widgets.my.todo_actions:change_todo_status"
+    mark_todo_complete = "examples.widgets.my.todo_actions:mark_todo_complete"
+    reassign_todo = "examples.widgets.my.todo_actions:reassign_todo"
 
     hey_egeria_ops = "examples.widgets.cli.egeria_ops:cli"
     hey_egeria_cat = "examples.widgets.cli.egeria_cat:cli"