Metadata-Version: 2.1
Name: DdnAtlas
Version: 0.1.4
Summary: A command line tool to manage supergrapch technical metadata within Apache Atlas.
Home-page: https://github.com/kenstott/ddn-atlas
Author: Kenneth Stott
Requires-Python: >=3.9,<4.0
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Dist: PyYAML (>=6.0.2,<7.0.0)
Requires-Dist: anthropic (>=0.34.2,<0.35.0)
Requires-Dist: click (>=8.0.3,<9.0.0)
Requires-Dist: pyfiglet (>=0.8.post1,<0.9)
Requires-Dist: python-dotenv (>=0.19.1,<0.20.0)
Requires-Dist: requests (>=2.26.0,<3.0.0)
Project-URL: Repository, https://github.com/kenstott/ddn-atlas
Description-Content-Type: text/markdown

# Hasura DDN to Apache Atlas

This will convert a supergraph into an Apache Atlas data dictionary.

It adds several new types to Atlas including, supergraph, subgraph, query, object_type, data_connector, collection, column and field. 

* It will create lineage between the data_connectors collections and the subgraph object types.

* It will add many relationships to help understand and navigate the components.

* It will add a business name for each element by defaulting to a Title case version of the element's physical name.

* It will create a glossary with categories and terms and associate them with the technical metadata elements, using Anthropic (as a starter to get a glossary off the ground)

* It will derive technical metadata descriptions, if they don't already exist, using Anthropic.
* It will add a data steward business data to the subgraph

There are many flags and features you can use to focus updates to specific technical metadata element types.

To get started - just run `ddnatlas init` to initialize your instance of Apache Atlas with the supergraph types.

Follow up with `ddnatlas update` to add an existing supergraph to Atlas.

## General Instructions

```text
    ____  ____  _   __   ___  ________    ___   _____
   / __ \/ __ \/ | / /  /   |/_  __/ /   /   | / ___/
  / / / / / / /  |/ /  / /| | / / / /   / /| | \__ \ 
 / /_/ / /_/ / /|  /  / ___ |/ / / /___/ ___ |___/ / 
/_____/_____/_/ |_/  /_/  |_/_/ /_____/_/  |_/____/  
                                                     

Usage: ddnatlas [OPTIONS] COMMAND [ARGS]...

  DDN Atlas CLI - A command-line tool for managing supergraph metadata within
  Apache Atlas.

  This tool provides commands to initialize configuration, update metadata,
  and download supergraph metadata from Apache Atlas.

Options:
  --version                 Show the version and exit.
  --atlas-url TEXT          Atlas URL (required if ATLAS_URL env var is not
                            set)  [required]
  --supergraph TEXT         Supergraph identifier (required if SUPERGRAPH env
                            var is not set)  [required]
  --atlas-username TEXT     Atlas username  [default: (admin or ATLAS_USERNAME
                            env var)]
  --atlas-password TEXT     Atlas password  [default: (admin or ATLAS_PASSWORD
                            env var)]
  --anthropic-api-key TEXT  Anthropic API Key
  --anthropic-uri TEXT      Anthropic API URI  [default:
                            (https://api.anthropic.com or ANTHROPIC_URI env
                            var)]
  --anthropic-version TEXT  Anthropic API Version  [default: (2023-06-01 or
                            ANTHROPIC_VERSION env var)]
  --help                    Show this message and exit.

Commands:
  dump    Download the Apache Atlas supergraph metadata.
  init    Initialize the configuration for DDN Atlas.
  update  Update the supergraph metadata in Apache Atlas.

```

## Update Instructions

```text
    ____  ____  _   __   ___  ________    ___   _____
   / __ \/ __ \/ | / /  /   |/_  __/ /   /   | / ___/
  / / / / / / /  |/ /  / /| | / / / /   / /| | \__ \ 
 / /_/ / /_/ / /|  /  / ___ |/ / / /___/ ___ |___/ / 
/_____/_____/_/ |_/  /_/  |_/_/ /_____/_/  |_/____/  
                                                     

Usage: ddnatlas update [OPTIONS]

  Update the supergraph metadata in Apache Atlas.

  This command allows you to update the supergraph metadata stored in Apache
  Atlas. It uses the configuration settings to connect to Atlas and update the
  specified supergraph's metadata.

Options:
  -e, --exclude TEXT  Exclude specific components from the update. Options:
                      subgraph, supergraph, entity, relationship,
                      business_metadata, glossary, data_connector, model,
                      object_type, scalar, descriptions
  -i, --include TEXT  Include specific components in the update. Options:
                      subgraph, supergraph, entity, relationship,
                      business_metadata, glossary, data_connector, model,
                      object_type, scalar, descriptions
  --help              Show this message and exit.

```

