semvec/pypi-packages huggingface dataset:
ansible-discover 0.2.1
Discover both dependants and dependencies of Ansible playbooks and roles, respectively
License: MIT
Requires Python: >=3.6
Keywords: ansible,testing,ci

|Build Status| |PyPi Package|

ansible-discover
================

*ansible-discover* is a command line tool to list dependencies and
dependants of `Ansible` roles and playbooks, respectively.

One of its prime uses is in a CI tool like Jenkins. Once a change on,
say a role, is committed, use *ansible-discover* to gather the dependant
roles and playbooks. From this list, the respective CI jobs for playbook
and role validations may then be triggered.

Installation
------------

::

    pip install ansible-discover

Usage
-----

One use case (like outlined above) is to determine all roles (directly
or indirectly) depending on a given set of roles:

::

    ansible-discover roles predecessors PATHS

where ``PATHS`` is a space-delimited list of paths to roles (e.g.,
``roles/my_sample_role``).

In addition to predecessors (i.e., dependants) for roles, you can also
discover

-  successors (i.e., dependencies) of roles:
   ``ansible-discover roles successors``;
-  predecessors for playbooks:
   ``ansible-discover playbooks predecessors``; and
-  successors of playbooks: ``ansible-discover playbooks successors``.

Related tools
-------------

-  `ansigenome`_
-  `ansible-roles-graph`_
-  `ansible-review`_

License
-------

Distributed under the XYZ license. See ``LICENSE.txt`` for more
information.

Contributing
------------

-  Fork it!
-  Create your feature branch: ``git checkout -b my-new-feature``
-  Commit your changes: ``git commit -am 'Add some feature'``
-  Push to the branch: ``git push origin my-new-feature``
-  Submit a pull request :)

.. _Ansible: https://github.com/ansible/ansible
.. _ansigenome: https://github.com/nickjj/ansigenome
.. _ansible-roles-graph: https://github.com/sebn/ansible-roles-graph
.. _ansible-review: https://github.com/willthames/ansible-review

.. |Build Status| image:: https://travis-ci.org/croesnick/ansible-discover.svg?branch=master
   :target: https://travis-ci.org/croesnick/ansible-discover
.. |PyPi Package| image:: https://badge.fury.io/py/ansible-discover.svg
   :target: https://badge.fury.io/py/ansible-discover