Metadata-Version: 2.1
Name: pop-tree
Version: 9.0.0
Summary: Visualize POP hub/sub structures
Home-page: UNKNOWN
Author: Tyler Johnson
Author-email: tjohnson@saltstack.com
License: UNKNOWN
Platform: UNKNOWN
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Development Status :: 5 - Production/Stable
Requires-Python: >=3.6
Description-Content-Type: text/x-rst
Requires-Dist: pop
Provides-Extra: full
Requires-Dist: scipy ; extra == 'full'
Requires-Dist: rend ; extra == 'full'
Requires-Dist: matplotlib ; extra == 'full'
Requires-Dist: networkx ; extra == 'full'
Provides-Extra: nx
Requires-Dist: scipy ; extra == 'nx'
Requires-Dist: matplotlib ; extra == 'nx'
Requires-Dist: networkx ; extra == 'nx'
Provides-Extra: rend
Requires-Dist: rend ; extra == 'rend'

********
POP-TREE
********
**POP hub and sub visualization tool**

INSTALLATION
============

Bare installation with no dependencies

.. code-block:: bash

    pip install pop-tree

Installation for pretty yaml output

.. code-block:: bash

    pip install pop-tree\[rend\]

Installation for incredible graphs

.. code-block:: bash

    pip install pop-tree\[networkx\]

Install everything

.. code-block:: bash

    pip install pop-tree\[full\]

INSTALLATION FOR DEVELOPMENT
============================

Clone the `pop-tree` repo and install with pip


.. code-block:: bash

    git clone https://gitlab.com/Akm0d/pop-tree.git
    pip install -e pop-tree\[full\]

Pop-doc
=======

Another cli tool that comes with pop-tree is pop-doc.
You can use this to grab the documentation for specific references on the hub.

.. code-block:: bash

    pop-doc tree.init.refs

output:

.. code-block:: yaml

    ref:
        tree.init.refs
    doc:
        Return all the references available on the hub by reference first
    contracts:
        pre:
        call:
        post:
    parameters:
        hub:
        tree:

            annotation:
                typing.Dict[str, typing.Any]

    return_annotation:


EXECUTION
=========

After installation the `pop-tree` command should now be available.

Running `pop-tree` by itself will only show things that the `pop-tree` project added to the hub.
Naming a dynamic namespace will add it's dyne_name to the hub and show only that namespace

.. code-block:: bash

    pop-tree exec


OUTPUT
------

If you installed pop-tree with the [rend] extras, then `--output` can be used to specify an outputter from the `rend` project
To see which outputters are available, just run

.. code-block:: bash

    pop-tree output

Which will dynamically load the `output` dynamic namespace from the `rend` project and print the subs loaded immediately beneath it.

.. code-block:: bash

    pop-tree --output nested

GRAPH
-----

There are many different graphing plugins, some print to the terminal, and some open a shiny graph in a new window.
To list the available graphing plugins, run

.. code-block:: bash

    pop-tree graph

A graph plugin can be specified with the `--graph` option.

.. code-block:: bash

    pop-tree --graph networkx

Which should print off a beautiful matplotlib plot to visualize your pop ecosystem.
Use these arguments together to create impressive visuals for your project.

.. image:: hub.png


