diff --git a/brian_polling_manager/cli.py b/brian_polling_manager/cli.py index a3a19129bac3148062e0ef9e7369bd40c02b3443..b2cc6102d1647f0e476b384a91bc556bee8f2dff 100644 --- a/brian_polling_manager/cli.py +++ b/brian_polling_manager/cli.py @@ -1,3 +1,28 @@ +""" +This script queries Inventory Provider for changes +and configures Sensu with the snmp polling checks +required by BRIAN. + +.. code-block:: console + + % python brian_polling_manager/cli.py --help + Usage: cli.py [OPTIONS] + + Update BRIAN snmp checks based on Inventory Provider data. + + Options: + --config TEXT configuration filename + --force / --no-force update even if inventory hasn't been updated + --help Show this message and exit. + + +The required configuration file must be +formatted according to the following schema: + +.. asjson:: + brian_polling_manager.cli.CONFIG_SCHEMA + +""" import json import logging import os @@ -194,6 +219,9 @@ def _validate_config(ctx, param, value): default=False, help="update even if inventory hasn't been updated") def main(config, force): + """ + Update BRIAN snmp checks based on Inventory Provider data. + """ state = State(config['statedir']) last = inventory.last_update_timestamp(config['inventory']) diff --git a/docs/source/cli.rst b/docs/source/cli.rst new file mode 100644 index 0000000000000000000000000000000000000000..0255ffa9daada3086ede5f35c2504d5d15e289d5 --- /dev/null +++ b/docs/source/cli.rst @@ -0,0 +1,6 @@ + +cli +=================================================== + +.. automodule:: brian_polling_manager.cli + diff --git a/docs/source/index.rst b/docs/source/index.rst index 474893bbdbc74aaf9b52856fa1642bb0ee555298..d87a4b83d0b48564ca2897eb4d64af5692b64444 100644 --- a/docs/source/index.rst +++ b/docs/source/index.rst @@ -3,18 +3,17 @@ You can adapt this file completely to your liking, but it should at least contain the root `toctree` directive. -Welcome to BRIAN Polling Manager's documentation! -================================================= -.. toctree:: - :maxdepth: 2 - :caption: Contents: +BRIAN Polling Manager +====================== +Documentation for BRIAN Polling Manager. +This application queries Inventory Provider and configures +Sensu checks for polling the data required by BRIAN. -Indices and tables -================== +.. toctree:: + :maxdepth: 2 + :caption: Contents: -* :ref:`genindex` -* :ref:`modindex` -* :ref:`search` + cli