README.rst

ansible-modules
###############

A repository of Ansible modules.

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

To use these modules, add a git submodule under the :code:`library` directory
at the root of the playbooks directory

.. code:: shell

    mkdir library
    touch library/__init__.py
    git submodule add https://www.shore.co.il/git/ansible-modules library/shore master
    sudo pip install -r library/shore/requirements.txt

To update the submodule

.. code:: shell

    git submodule update --remote library/shore

Remember to commit :code:`.gitmodules`!

Modules
-------

- collectd_facts
- ldap_attr
- nginx_facts
- dhparams

License
-------

This software is licensed under the AGPL v3+ license (see the
:code:`LICENSE.txt` file).

Testing
-------

Currently the only tests are `pre-commit <http://www.pre-commit.com/>`_ hooks.

Author
------

Nimrod Adar, `contact me <nimrod@shore.co.il>`_ or visit my `website
<https://www.shore.co.il/>`_. Patches are welcome via `git send-email
<http://git-scm.com/book/en/v2/Git-Commands-Email>`_. The repository is located
at: https://www.shore.co.il/git/.

TODO
----

- Test installation and update instructions.