pyegeria 5.3.6.2.4__py3-none-any.whl → 5.3.6.3__py3-none-any.whl

pyegeria/md_processing_utils.py

@@ -0,0 +1,816 @@
+"""
+
+This file contains functions to parse and process Egeria Markdown (Freddie)
+
+
+"""
+
+import json
+from jupyter_notebook_parser import JupyterNotebookParser
+import nbformat
+import os
+import re
+from pyegeria import EgeriaTech, NO_CATEGORIES_FOUND
+from rich import box, print
+from rich.console import Console
+from rich.markdown import Markdown
+from rich.prompt import Prompt
+from rich.table import Table
+import click
+from pyegeria import EgeriaTech, body_slimmer, NO_GLOSSARIES_FOUND, NO_TERMS_FOUND, NO_ELEMENTS_FOUND, NO_PROJECTS_FOUND
+from pyegeria._exceptions import (InvalidParameterException, PropertyServerException, print_exception_response, )
+import datetime
+
+console = Console(width=120)
+
+commands = ["Create Glossary", "Update Glossary", "Create Term", "Update Term", "Create Personal Project",
+            "Update Personal Project", "Create Category", "Update Category"]
+ERROR = "ERROR-> "
+INFO = "INFO- "
+WARNING = "WARNING-> "
+pre_command = "\n---\n==> Processing command:"
+element_dictionary = {}
+
+
+def is_valid_iso_date(date_text) -> bool:
+    """Checks if the given string is a valid ISO date."""
+    try:
+        datetime.datetime.strptime(date_text, '%Y-%m-%d')
+        return True
+    except ValueError:
+        return False
+
+
+def get_current_datetime_string():
+    """Returns the current date and time as a human-readable string."""
+    now = datetime.datetime.now()
+    return now.strftime("%Y%m%d%H%M%S")
+
+def add_term_to_categories(egeria_client: EgeriaTech, term_guid: str, categories_exist: bool, categories_list: [str], element_dictionary: dict)-> None:
+    if categories_exist is True and categories_list is not None:
+        for category in categories_list:
+            cat_guid = None
+            cat_el = f"category.{category.strip()}"
+            if cat_el in element_dictionary:
+                cat= element_dictionary.get(cat_el, None)
+                cat_guid = cat.get('guid', None) if cat else None
+            if cat_guid is None:
+                cat_guid = egeria_client.__get_guid__(property_name='displayName',display_name=category)
+            egeria_client.add_term_to_category(term_guid, cat_guid)
+
+
+
+def extract_command(block: str) -> str | None:
+    match = re.search(r"#(.*?)(?:##|\n|$)", block)  # Using a non capturing group
+    if match:
+        return match.group(1).strip()
+    return None
+
+
+def extract_attribute(text: str, label: str) -> str | None:
+    """
+        Extracts the glossary name from a string.
+
+        Args:
+            text: The input string.
+            label: The label to search for.
+
+        Returns:
+            The glossary name, or None if not found.
+        """
+    pattern = r"## " + re.escape(label) + r"\n(.*?)(?:##|$)"  # Construct pattern
+    match = re.search(pattern, text, re.DOTALL)
+    if match and not match.group(1).isspace():
+        txt = match.group(1).strip()
+        return txt.strip()
+    return None
+
+
+def update_a_command(txt: str, command: str, obj_type: str, q_name: str, u_guid: str) -> str:
+    u_guid = u_guid if u_guid else " "
+    verb = command.split(' ')[0].strip()
+    action = "Update" if (verb == "Create" and u_guid is not None) else "Create"
+    txt = txt.replace(f"{command}", f'**{action} {obj_type}**\n')  # update the command
+    txt = txt.replace('<GUID>', f'**GUID**\n{u_guid}')  # update with GUID
+    txt = txt.replace('<Qualified Name>', f"**Qualified Name**\n{q_name}")
+    if "Qualified Name" not in txt:
+        txt += f"\n## **Qualified Name**\n{q_name}\n"
+    if "GUID" not in txt:
+        txt += f"\n## **GUID**\n{u_guid}\n"
+
+    # if (command in {"Update Term", "Update Category", 'Update Glossary'}) and ("Update Description" not in txt):
+    #     txt += '\n** Update Description\n\n\n'
+    # elif "Update Description" in txt:
+    #     pattern = r"(## Update Description\n).*?(#)"
+    #     replacement = r"\1\n\n\2"
+    #     txt += re.sub(pattern, replacement, txt)
+
+    status = extract_attribute(txt, "Status")
+    if command in ["Create Term", "Update Term"] and status is None:
+        pattern = r"(## Status\s*\n)(.*?)(#)"
+        replacement = r"\1\n DRAFT\n\n\3"
+        txt = re.sub(pattern, replacement, txt)
+    return txt
+
+
+def process_glossary_upsert_command(egeria_client: EgeriaTech, element_dictionary: dict, txt: str,
+                                    directive: str = "display") -> str | None:
+    """
+    Processes a glossary create or update command by extracting key attributes such as
+    glossary name, language, description, and usage from the given text.
+
+    :param txt: A string representing the input cell to be processed for
+        extracting glossary-related attributes.
+    :param directive: an optional string indicating the directive to be used - display, validate or execute
+    :return: A string summarizing the outcome of the processing.
+    """
+    command = extract_command(txt)
+    object_type = command.split(' ')[1].strip()
+    object_action = command.split(' ')[0].strip()
+
+    glossary_name = extract_attribute(txt, 'Glossary Name')
+    print(Markdown(f"{pre_command} `{command}` for glossary: `\'{glossary_name}\'` with directive: `{directive}` "))
+    language = extract_attribute(txt, 'Language')
+    description = extract_attribute(txt, 'Description')
+    usage = extract_attribute(txt, 'Usage')
+
+    glossary_display = (f"\n* Command: {command}\n\t* Glossary Name: {glossary_name}\n\t"
+                        f"* Language: {language}\n\t* Description:\n{description}\n"
+                        f"* Usage: {usage}\n")
+
+    if object_action == 'Update':
+        q_name = extract_attribute(txt, 'Qualified Name')
+        guid = extract_attribute(txt, 'GUID')
+        glossary_display += f"* Qualified Name: {q_name}\n\t* GUID: {guid}\n\n"
+
+    def validate_glossary(obj_action: str) -> tuple[bool, bool, str | None, str | None]:
+        valid = True
+        msg = ""
+        known_glossary_guid = None
+        known_q_name = None
+
+        glossary_details = egeria_client.get_glossaries_by_name(glossary_name)
+        if glossary_details == NO_GLOSSARIES_FOUND:
+            glossary_exists = False
+        else:
+            glossary_exists = True
+
+        if glossary_name is None:
+            msg = f"* {ERROR}Glossary name is missing\n"
+            valid = False
+        if language is None:
+            msg += f"* {ERROR}Language is missing\n"
+            valid = False
+        if description is None:
+            msg += f"* {INFO}Description is missing\n"
+
+        if len(glossary_details) > 1 and glossary_exists:
+            msg += f"* {ERROR}More than one glossary with name {glossary_name} found\n"
+            valid = False
+        if len(glossary_details) == 1:
+            known_glossary_guid = glossary_details[0]['elementHeader'].get('guid', None)
+            known_q_name = glossary_details[0]['glossaryProperties'].get('qualifiedName', None)
+
+        if obj_action == "Update":
+
+            if not glossary_exists:
+                msg += f"* {ERROR}Glossary {glossary_name} does not exist\n"
+                valid = False
+            # if len(glossary_details) > 1 and glossary_exists:
+            #     msg += f"* {ERROR}More than one glossary with name {glossary_name} found\n"
+            #     valid = False
+            # if len(glossary_details) == 1:
+            #     known_glossary_guid = glossary_details[0]['elementHeader'].get('guid', None)
+            #     known_q_name = glossary_details[0]['glossaryProperties'].get('qualifiedName',None)
+            if q_name is None:
+                msg += f"* {INFO}Qualified Name is missing => can use known qualified name of {known_q_name}\n"
+                valid = True
+            elif q_name != known_q_name:
+                msg += (
+                    f"* {ERROR}Glossary `{glossary_name}` qualifiedName mismatch between {q_name} and {known_q_name}\n")
+                valid = False
+            if valid:
+                msg += glossary_display
+                msg += f"* -->Glossary `{glossary_name}` exists and can be updated\n"
+            else:
+                msg += f"* --> validation failed\n"
+
+            print(Markdown(msg))
+            return valid, glossary_exists, known_glossary_guid, known_q_name
+
+        elif obj_action == "Create":
+            if glossary_exists:
+                msg += f"{ERROR}Glossary {glossary_name} already exists\n"
+
+            elif valid:
+                msg += f"-->It is valid to create Glossary \'{glossary_name}\' with:\n"
+                msg += glossary_display
+
+            print(Markdown(msg))
+            return valid, glossary_exists, known_glossary_guid, known_q_name
+
+    if directive == "display":
+        print(Markdown(glossary_display))
+        return None
+
+    elif directive == "validate":
+        is_valid, exists, known_guid, known_q_name = validate_glossary(object_action)
+        valid = is_valid if is_valid else None
+        return valid
+
+    elif directive == "process":
+        is_valid, exists, known_guid, known_q_name = validate_glossary(object_action)
+        if not is_valid:
+            return None
+        if object_action == "Update":
+            if not exists:
+                print(
+                    f"\n{ERROR}Glossary {glossary_name} does not exist! Updating result document with Create command\n")
+                return update_a_command(txt, command, object_type, known_q_name, known_guid)
+
+            body = {
+                "class": "ReferenceableRequestBody", "elementProperties": {
+                    "class": "GlossaryProperties", "qualifiedName": known_q_name, "description": description,
+                    "language": language, "usage": usage
+                    }
+                }
+            egeria_client.update_glossary(known_guid, body)
+            print(f"\n-->Updated Glossary {glossary_name} with GUID {known_guid}")
+            element_dictionary[f"glossary.{glossary_name}"] = {
+                'guid': known_guid, 'q_name': known_q_name
+                }
+            # return update_a_command(txt, command, object_type, known_q_name, known_guid)
+            return egeria_client.get_glossary_by_guid(known_guid, output_format='md')
+        elif object_action == "Create":
+            glossary_guid = None
+
+            if exists:
+                print(f"\nGlossary {glossary_name} already exists and result document updated\n")
+                return update_a_command(txt, command, object_type, known_q_name, known_guid)
+            else:
+                glossary_guid = egeria_client.create_glossary(glossary_name, description, language, usage)
+                glossary = egeria_client.get_glossary_by_guid(glossary_guid)
+                if glossary == NO_GLOSSARIES_FOUND:
+                    print(f"{ERROR}Just created with GUID {glossary_guid} but Glossary not found\n")
+                    return None
+                qualified_name = glossary['glossaryProperties']["qualifiedName"]
+                element_dictionary[f"glossary.{glossary_name}"] = {
+                    'guid': glossary_guid, 'q_name': qualified_name
+                    }
+                # return update_a_command(txt, command, object_type, qualified_name, glossary_guid)
+                return egeria_client.get_glossary_by_guid(glossary_guid, output_format = 'md')
+
+
+def process_categories_upsert_command(egeria_client: EgeriaTech, element_dictionary: dict, txt: str,
+                                      directive: str = "display") -> str | None:
+    """
+    Processes a glossary category create or update command by extracting key attributes such as
+    category name, qualified, description, and anchor glossary from the given txt..
+
+    :param txt: A string representing the input cell to be processed for
+        extracting category-related attributes.
+    :param directive: an optional string indicating the directive to be used - display, validate or execute
+    :return: A string summarizing the outcome of the processing.
+    """
+    command = extract_command(txt)
+    object_type = command.split(' ')[1].strip()
+    object_action = command.split(' ')[0].strip()
+
+    category_name = extract_attribute(txt, 'Category Name')
+    print(Markdown(f"{pre_command} `{command}` for category: `\'{category_name}\'` with directive: `{directive}` "))
+    owning_glossary = extract_attribute(txt, 'Owning Glossary')
+    description = extract_attribute(txt, 'Description')
+    category_display = (f"\n* Command: {command}\n\t* Category: {category_name}\n\t"
+                        f"* In Glossary: {owning_glossary}\n\t* Description:\n{description}\n")
+    update_description = None
+
+    if object_action == 'Update':
+        q_name = extract_attribute(txt, 'Qualified Name')
+        guid = extract_attribute(txt, 'GUID')
+        update_description = extract_attribute(txt, 'Update Description')
+        category_display += (f"* Qualified Name: {q_name}\n\t* GUID: {guid}\n\n"
+                             f"* Update Description: \n {update_description}\n\t")
+
+    def validate_category(obj_action: str) -> tuple[bool, bool, str | None, str | None, str | None]:
+        valid = True
+        msg = ""
+        known_category_guid = None
+        known_q_name = None
+        glossary_guid = None
+
+        category_details = egeria_client.get_categories_by_name(category_name)
+        if category_details == NO_CATEGORIES_FOUND:
+            category_exists = False
+        else:
+            category_exists = True
+        el_glossary = f"glossary.{owning_glossary}"
+        if owning_glossary is None:
+            msg += f"* {ERROR}Owning Glossary is missing\n"
+            valid = False
+
+        elif el_glossary in element_dictionary:  # Check to see if we already know about this glossary
+            owning_glossary_el = f"glossary.{owning_glossary}"
+            glossary_guid = element_dictionary[owning_glossary_el].get('guid', None)
+            glossary_q_name = element_dictionary[owning_glossary_el].get('q_name', None)
+        else:
+            # need to ask Egeria if it knows the Glossary Name
+            glossary = egeria_client.get_glossaries_by_name(owning_glossary)
+            if glossary == NO_GLOSSARIES_FOUND:
+                msg += f"* {ERROR}Glossary `{owning_glossary}` does not exist\n\n"
+                valid = False
+            else:
+                msg += f"* {INFO}Glossary `{owning_glossary}` exists\n\n"
+                glossary_guid = glossary[0]['elementHeader'].get('guid', None)
+                glossary_q_name = glossary[0]['glossaryProperties'].get('qualifiedName', None)
+                element_dictionary[el_glossary] = {
+                    'guid': glossary_guid, 'q_name': glossary_q_name
+                    }
+
+        if category_name is None:
+            msg = f"* {ERROR}Category name is missing\n"
+            valid = False
+
+        if description is None:
+            msg += f"* {INFO}Description is missing\n"
+
+        if len(category_details) > 1 and category_exists:
+            msg += f"* {ERROR}More than one category with name `{category_name}` found\n"
+            valid = False
+        if len(category_details) == 1:
+            known_category_guid = category_details[0]['elementHeader'].get('guid', None)
+            known_q_name = category_details[0]['glossaryCategoryProperties'].get('qualifiedName', None)
+
+        if obj_action == "Update":
+            if not category_exists:
+                msg += f"* {ERROR}category `{category_name}` does not exist\n"
+                valid = False
+            if q_name is None:
+                msg += f"* {INFO}Qualified Name is missing => can use known qualified name of {known_q_name}\n"
+                valid = True
+            elif q_name != known_q_name:
+                msg += (
+                    f"* {ERROR}category `{category_name}` qualifiedName mismatch between {q_name} and {known_q_name}\n")
+                valid = False
+            if valid:
+                msg += category_display
+                msg += f"* -->category `{category_name}` exists and can be updated\n"
+            else:
+                msg += f"* --> validation failed\n"
+
+            print(Markdown(msg))
+            return valid, category_exists, known_category_guid, known_q_name, glossary_guid
+
+        elif obj_action == "Create":
+            if category_exists:
+                msg += f"{ERROR}category `{category_name}` already exists\n"
+
+            elif valid:
+                msg += f"-->It is valid to create category `{category_name}` with:\n"
+                msg += category_display
+
+            print(Markdown(msg))
+            return valid, category_exists, known_category_guid, known_q_name, glossary_guid
+
+    if directive == "display":
+        print(Markdown(category_display))
+        return None
+
+    elif directive == "validate":
+        is_valid, exists, known_guid, known_q_name, glossary_guid = validate_category(object_action)
+        valid = is_valid if is_valid else None
+        return valid
+
+    elif directive == "process":
+        is_valid, exists, known_guid, known_q_name, glossary_guid = validate_category(object_action)
+        if not is_valid:
+            print(f"{ERROR}Validation checks failed in creating category `{category_name}`")
+            return None
+
+        if object_action == "Update":
+            if not exists:
+                print(
+                    f"\n{ERROR}category `{category_name}` does not exist! Updating result document with Create "
+                    f"command\n")
+                return update_a_command(txt, command, object_type, known_q_name, known_guid)
+
+            egeria_client.update_category(glossary_guid, category_name, description, known_q_name, None,
+                                          update_description)
+            print(f"\n-->Updated category `{category_name}`with GUID {known_guid}")
+            element_dictionary[f"category.{category_name}"] = {
+                'guid': known_guid, 'q_name': known_q_name
+                }
+            # return update_a_command(txt, command, object_type, known_q_name, known_guid)
+            return egeria_client.get_categories_by_guid(known_guid, output_format='md')
+
+        elif object_action == "Create":
+            is_root = False
+
+            if exists:
+                print(f"\ncategory `{category_name}` already exists and result document updated\n")
+                return update_a_command(txt, command, object_type, known_q_name, known_guid)
+            else:
+                category_guid = egeria_client.create_category(glossary_guid, category_name, description, is_root)
+                category = egeria_client.get_categories_by_guid(category_guid)
+
+                if category == NO_CATEGORIES_FOUND:
+                    print(f"{ERROR}Just created with GUID {category_guid} but category not found\n")
+                    return None
+                qualified_name = category['glossaryCategoryProperties']["qualifiedName"]
+                element_dictionary[f"category.{category_name}"] = {
+                    'guid': category_guid, 'q_name': qualified_name
+                    }
+                # return update_a_command(txt, command, object_type, qualified_name, category_guid)
+                return egeria_client.get_categories_by_guid(category_guid, output_format='md')
+
+def process_term_upsert_command(egeria_client: EgeriaTech, element_dictionary: dict, txt: str,
+                                directive: str = "display") -> str | None:
+    """
+    Processes a term create or update command by extracting key attributes such as
+    term name, summary, description, abbreviation, examples, usage, version, and status from the given cell.
+
+    :param txt: A string representing the input cell to be processed for
+        extracting glossary-related attributes.
+    :param directive: an optional string indicating the directive to be used - display, validate or execute
+    :return: A string summarizing the outcome of the processing.
+    """
+
+    command = extract_command(txt)
+    object_type = command.split(' ')[1].strip()
+    object_action = command.split(' ')[0].strip()
+
+    term_name = extract_attribute(txt, 'Term Name')
+    summary = extract_attribute(txt, 'Summary')
+    description = extract_attribute(txt, 'Description')
+    abbreviation = extract_attribute(txt, 'Abbreviation')
+    examples = extract_attribute(txt, 'Examples')
+    usage = extract_attribute(txt, 'Usage')
+    status = extract_attribute(txt, 'Status')
+    version = extract_attribute(txt, 'Version')
+    categories = extract_attribute(txt, 'Categories')
+    categories_list = None
+    cats_exist = True
+
+    glossary_name = extract_attribute(txt, 'Glossary Name')
+
+    print(Markdown(f"{pre_command} `{command}` for term: `\'{term_name}\'` with directive: `{directive}`"))
+
+    def validate_term(obj_action: str) -> tuple[bool, bool, str | None, str | None]:
+        nonlocal version, status, categories, categories_list, cats_exist
+        valid = True
+        msg = ""
+        known_term_guid = None
+        known_q_name = None
+
+        term_details = egeria_client.get_terms_by_name(term_name)
+        if term_details == NO_TERMS_FOUND:
+            term_exists = False
+        else:
+            term_exists = True
+
+        if status is None:
+            msg += f"* {INFO}Term status is missing - will default to DRAFT\n"
+            status = 'DRAFT'
+
+
+        if term_name is None:
+            msg = f"* {ERROR}Term name is missing\n"
+            valid = False
+        if glossary_name is None:
+            msg += f"* {ERROR}Glossary name is missing\n"
+            valid = False
+        else:
+            glossary_el = f"glossary.{glossary_name}"
+            if glossary_el not in element_dictionary:
+                glossary = egeria_client.get_glossaries_by_name(glossary_name)
+                if isinstance(glossary,str):
+                    msg += f"* {ERROR}Glossary `{glossary_name}` is unknown\n "
+                    valid = False
+
+        if categories is None:
+            msg += f"* {INFO}Categories are missing\n"
+        else:
+            categories_list = re.split(r'[,\n]+', categories)
+            categories = ""
+            for category in categories_list:
+                category_el = f"category.{category.strip()}"
+                if category_el not in element_dictionary:
+                    cat = egeria_client.get_categories_by_name(category)
+                    if isinstance(cat,str):
+                        msg += (f"* {WARNING}Category `{category}` is unknown to validate -> "
+                                f"categories for this term won't be processed!\n")
+                        cats_exist = False
+                categories = f"{category}, {categories}"
+            if cats_exist:
+                categories +='\n'
+            else:
+                categories = None
+
+
+        if summary is None:
+            msg += f"* {INFO}Term summary is missing\n"
+
+        if description is None:
+            msg += f"* {INFO}Term description is missing\n"
+
+        if abbreviation is None:
+            msg += f"* {INFO}Term abbreviation is missing\n"
+        if examples is None:
+            msg += f"* {INFO}Term examples is missing\n"
+        if usage is None:
+            msg += f"* {INFO}Term usage is missing\n"
+        if version is None:
+            msg += f"* {INFO}Term version is missing - will default to 0.0.1\n"
+            version = "0.0.1"
+
+        if obj_action == "Update":  # check to see if provided information exists and is consistent with existing info
+            if not term_exists:
+                msg += f"* {ERROR}Term {term_name} does not exist\n"
+                valid = False
+
+            if len(term_details) > 1 and term_exists:
+                msg += f"* {ERROR}More than one term with name {term_name} found\n"
+                valid = False
+            elif len(term_details) == 1:
+                known_term_guid = term_details[0]['elementHeader'].get('guid', None)
+                known_q_name = term_details[0]['glossaryTermProperties'].get('qualifiedName', None)
+            if q_name != known_q_name:
+                msg += (f"* {ERROR}Term {term_name} qualifiedName mismatch between {q_name} and {known_q_name}\n")
+                valid = False
+            else:
+                msg += f"--> * Term {term_name} exists and can be updated\n"
+                msg += term_display
+
+            print(Markdown(msg))
+            return valid, term_exists, known_term_guid, known_q_name
+
+        elif obj_action == 'Create':  # if the command is create, check that it doesn't already exist
+            if term_exists:
+                msg += f"\n{WARNING}Term \'{term_name}\' already exists.\n"
+            elif not valid:
+                msg += f"\n-->Validation checks failed in creating Term \'{term_name}\' with: {term_display}\n"
+            else:
+                msg += f"\n-->It is valid to create Term \'{term_name}\' with: {term_display}\n"
+
+            print(Markdown(msg))
+            return valid, term_exists, known_term_guid, known_q_name
+
+    if object_action == "Update":
+        term_guid = extract_attribute(txt, 'GUID')
+        term_guid = term_guid if term_guid else " "
+        q_name = extract_attribute(txt, 'Qualified Name')
+        q_name = q_name if q_name else " "
+
+        update_description = extract_attribute(txt, 'Update Description')
+        update_description = update_description if update_description else " "
+        term_display = (f"\n* Command: {command}\n\t* Glossary: {glossary_name}\n\t"
+                        f"* Term Name: {term_name}\n\t* Categories: {categories}\n\t* Summary: {summary}"
+                        f"\n\t* Description: {description}\n\t"
+                        f"* Abbreviation: {abbreviation}\n\t* Examples: {examples}\n\t* Usage: {usage}\n\t"
+                        f"* Version: {version}\n\t* Status: {status}\n\t* GUID: {term_guid}\n\t* Qualified Name: "
+                        f"{q_name}"
+                        f"\n\t* Update Description: {update_description}\n")
+    else:
+        term_display = (f"\n* Command: {command}\n\t* Glossary: {glossary_name}\n\t"
+                        f"* Term Name: {term_name}\n\t* Categories: {categories}\n\t* Summary: {summary}\n\t"
+                        f"* Description: {description}\n\t"
+                        f"* Abbreviation: {abbreviation}\n\t* Examples: {examples}\n\t* Usage: {usage}\n\t"
+                        f"* Version: {version}\n\t* Status: {status}\n")
+
+    if directive == "display":
+        print(Markdown(term_display))
+        return None
+    elif directive == "validate":
+        is_valid, exists, known_guid, known_q_name = validate_term(object_action)
+        valid = is_valid if is_valid else None
+        return valid
+    elif directive == "process":
+        try:
+            is_valid, exists, known_guid, known_q_name = validate_term(object_action)
+            if not is_valid:  # First validate the term before we process it
+                return None
+
+            if object_action == "Update" and directive == "process":
+                if not exists:
+                    print(f"\n-->Term {term_name} does not exist")
+                    return None
+                body = {
+                    "class": "ReferenceableRequestBody", "elementProperties": {
+                        "class": "GlossaryTermProperties", "qualifiedName": known_q_name, "summary": summary,
+                        "description": description, "abbreviation": abbreviation, "examples": examples, "usage": usage,
+                        "publishVersionIdentifier": version, "status": status
+                        }, "updateDescription": update_description
+                    }
+                egeria_client.update_term(known_guid, body)
+                # if cats_exist is True and categories_list is not None:
+                #     for category in categories_list:
+                #         cat_guid = element_dictionary.get(f"category.{category}", None)
+                #         if cat_guid is None:
+                #             cat_guid = egeria_client.__get_guid__(display_name=category)
+                #         egeria_client.add_term_to_category(known_guid, cat_guid)
+                add_term_to_categories(
+                    egeria_client, known_guid, cats_exist , categories_list,
+                    element_dictionary)
+                print(f"\n-->Updated Term {term_name} with GUID {known_guid} and categories {categories_list}")
+                return egeria_client.get_terms_by_guid(known_guid, 'md')
+                # return update_a_command(txt, command, object_type, known_q_name, known_guid)
+            elif object_action == "Update" and directive == "validate":
+                return egeria_client.get_terms_by_guid(known_guid, 'md')
+
+            elif object_action == "Create":
+                guid = None
+                q_name = f"GlossaryTerm:{term_name}:{get_current_datetime_string()}"
+                if exists:
+                    print(f"\n{WARNING}Term {term_name} exists and result document updated")
+                    return update_a_command(txt, command, object_type, q_name, known_guid)
+                else:
+                    ## get the guid for the glossary from the name - first look locally
+                    glossary = element_dictionary.get(f"glossary.{glossary_name}", None)
+
+                    if glossary is not None:
+                        glossary_guid = glossary.get('guid', None)
+                        if glossary_guid is None:
+                            print(f"{ERROR}Glossary reference {glossary_name} not found")
+                            return None
+                    else:
+                        glossary_guid = egeria_client.__get_guid__(property_name="displayName", display_name=glossary_name)
+                        if glossary_guid == NO_ELEMENTS_FOUND:
+                            print(f"{ERROR}Glossary {glossary_name} not found")
+                            return None
+                    term_body = {
+                        "class": "ReferenceableRequestBody", "elementProperties": {
+                            "class": "GlossaryTermProperties", "qualifiedName": q_name, "displayName": term_name,
+                            "summary": summary, "description": description, "abbreviation": abbreviation,
+                            "examples": examples, "usage": usage, "publishVersionIdentifier": version
+                            # "additionalProperties":
+                            #     {
+                            #         "propertyName1": "xxxx",
+                            #         "propertyName2": "xxxx"
+                            #         }
+                            }, "initialStatus": status
+                        }
+                    term_guid = egeria_client.create_controlled_glossary_term(glossary_guid, term_body)
+                    if term_guid == NO_ELEMENTS_FOUND:
+                        print(f"{ERROR}Term {term_name} not created")
+                        return None
+                    if cats_exist and categories is not None:
+                        add_term_to_categories(
+                        egeria_client, term_guid, cats_exist, categories_list,
+                        element_dictionary)
+                    print(f"\n-->Created Term {term_name} with GUID {term_guid}")
+                    # element = egeria_client.find_glossary_terms('term_name')
+                    element_dictionary[f"term.{term_name}"] = {'guid': term_guid, 'q_name': q_name}
+                    return egeria_client.get_terms_by_guid(term_guid, 'md')
+                    # return update_a_command(txt, command, object_type, q_name, term_guid)
+        except Exception as e:
+            print(f"{ERROR}Error creating term {term_name}: {e}")
+            console.print_exception(show_locals=True)
+            return None
+
+def process_per_proj_upsert_command(egeria_client: EgeriaTech, element_dictionary: dict, txt: str,
+                                    directive: str = "display") -> str | None:
+    """
+    Processes a personal project create or update command by extracting key attributes such as
+    glossary name, language, description, and usage from the given cell.
+
+    :param txt: A string representing the input cell to be processed for
+        extracting glossary-related attributes.
+    :param directive: an optional string indicating the directive to be used - display, validate or execute
+    :return: A string summarizing the outcome of the processing.
+    """
+    command = extract_command(txt)
+    object = command.split()
+    object_type = f"{object[1]} {object[2]}"
+    object_action = object[0]
+
+    project_name = extract_attribute(txt, 'Project Name')
+    description = extract_attribute(txt, 'Description')
+    project_identifier = extract_attribute(txt, 'Project Identifier')
+    project_status = extract_attribute(txt, 'Project Status')
+    project_phase = extract_attribute(txt, 'Project Phase')
+    project_health = extract_attribute(txt, 'Project Health')
+    start_date = extract_attribute(txt, 'Start Date')
+    planned_end_date = extract_attribute(txt, 'Planned End Date')
+    print(Markdown(f"{pre_command} `\'{command}\'` for project: `{project_name}` with directive: `{directive}` "))
+
+    project_display = (f"\n* Command: {command}\n\t* Project: {project_name}\n\t"
+                       f"* Status: {project_status}\n\t* Description: {description}\n\t"
+                       f"* Phase: {project_phase}\n\t* Health: {project_health}\n\t"
+                       f"* Start Date: {start_date}\n\t* Planned End Date: {planned_end_date}\n")
+
+    def validate_project(obj_action: str) -> tuple[bool, bool, str, str]:
+        valid = True
+        msg = ""
+        known_guid = None
+        known_q_name = None
+
+        project_details = egeria_client.get_projects_by_name(project_name)
+        if project_details == NO_PROJECTS_FOUND:
+            project_exists = False
+        else:
+            project_exists = True
+
+        if project_name is None:
+            msg = f"* {ERROR}Project name is missing\n"
+            valid = False
+        if project_status is None:
+            msg += f"* {INFO}No Project status found\n"
+
+        if description is None:
+            msg += f"* {INFO}No Description found\n"
+
+        if project_identifier is None:
+            msg += f"* {INFO}No Project Identifier found\n"
+
+        if project_phase is None:
+            msg += f"* {INFO}No Project Phase found\n"
+
+        if project_health is None:
+            msg += f"* {INFO}No Project Health found\n"
+
+        if start_date is None:
+            msg += f"* {INFO}No Start Date found\n"
+        elif not is_valid_iso_date(start_date):
+            msg += f"* {ERROR}Start Date is not a valid ISO date of form  YYYY-MM-DD\n"
+            valid = False
+
+        if planned_end_date is None:
+            msg += f"* {INFO} No Planned End Date found\n"
+        elif not is_valid_iso_date(planned_end_date):
+            msg += f"* {ERROR}Planned End Date is not a valid ISO date of form  YYYY-MM-DD\n"
+            valid = False
+
+        if obj_action == "Update":
+            q_name = extract_attribute(txt, 'Qualified Name')
+
+            if not project_exists:
+                msg += f"* {ERROR}Project {project_name} does not exist\n"
+                valid = False
+            if len(project_details) > 1 and project_exists:
+                msg += f"* {ERROR}More than one project with name {project_name} found\n"
+                valid = False
+            if len(project_details) == 1:
+                known_guid = project_details[0]['elementHeader'].get('guid', None)
+                known_q_name = project_details[0]['glossaryProperties'].get('qualifiedName', None)
+            if q_name is None:
+                msg += f"* {INFO}Qualified Name is missing => can use known qualified name of {known_q_name}\n"
+                valid = True
+            elif q_name != known_q_name:
+                msg += (f"* {ERROR}Project {project_name} qualifiedName mismatch between {q_name} and {known_q_name}\n")
+                valid = False
+            if valid:
+                msg += project_display
+                msg += f"* -->Project {project_name} exists and can be updated\n"
+            else:
+                msg += f"* --> validation failed\n"
+            msg += '---'
+            print(Markdown(msg))
+            return valid, project_exists, known_guid, known_q_name
+
+        elif obj_action == "Create":
+            if project_exists:
+                msg += f"\n{ERROR}Project {project_name} already exists"
+            else:
+                msg += f"\n-->It is valid to create Project \'{project_name}\' with:\n"
+            print(Markdown(msg))
+            return valid, project_exists, known_guid, known_q_name
+
+    if directive == "display":
+        print(Markdown(project_display))
+        return None
+
+    elif directive == "validate":
+        is_valid, exists, known_guid, known_q_name = validate_project(object_action)
+        valid = is_valid if is_valid else None
+        return valid
+
+    elif directive == "process":
+        is_valid, exists, known_guid, known_q_name = validate_project(object_action)
+        if not is_valid:
+            return None
+        if object_action == "Update":
+            if not exists:
+                print(f"\n\n-->Project {project_name} does not exist")
+                return None
+
+            egeria_client.update_project(known_guid, known_q_name, project_identifier, project_name, description,
+                                         project_status, project_phase, project_health, start_date, planned_end_date,
+                                         False)
+            print(f"\n-->Updated Project {project_name} with GUID {known_guid}")
+            return update_a_command(txt, command, object_type, known_q_name, known_guid)
+        elif object_action == "Create":
+            guid = None
+            if exists:
+                print(f"Project {project_name} already exists and update document created")
+                return update_a_command(txt, command, object_type, known_q_name, known_guid)
+            else:
+                guid = egeria_client.create_project(None, None, None, False, project_name, description,
+                                                    "PersonalProject", project_identifier, True, project_status,
+                                                    project_phase, project_health, start_date, planned_end_date)
+                project_g = egeria_client.get_project(guid)
+                if project_g == NO_GLOSSARIES_FOUND:
+                    print(f"Just created with GUID {guid} but Project not found")
+                    return None
+
+                q_name = project_g['projectProperties']["qualifiedName"]
+                element_dictionary[f"project.{project_name}"] = {'guid': guid, 'q_name': q_name}
+                return update_a_command(txt, command, object_type, q_name, guid)