{
    "info": {
        "author": "Fr\u00e9d\u00e9ric Mohier",
        "author_email": "frederic.mohier@alignak.net",
        "bugtrack_url": null,
        "classifiers": [
            "Development Status :: 5 - Production/Stable",
            "Environment :: Console",
            "Intended Audience :: Developers",
            "Intended Audience :: System Administrators",
            "License :: OSI Approved :: GNU Affero General Public License v3 or later (AGPLv3+)",
            "Natural Language :: English",
            "Programming Language :: Python",
            "Topic :: System :: Monitoring",
            "Topic :: System :: Systems Administration"
        ],
        "description": "Alignak Example Module\n======================\n\n*Alignak example module*\n\n.. image:: https://travis-ci.org/Alignak-monitoring-contrib/alignak-module-example.svg?branch=develop\n    :target: https://travis-ci.org/Alignak-monitoring-contrib/alignak-module-example\n    :alt: Develop branch build status\n\n.. image:: https://landscape.io/github/Alignak-monitoring-contrib/alignak-module-example/develop/landscape.svg?style=flat\n    :target: https://landscape.io/github/Alignak-monitoring-contrib/alignak-module-example/develop\n    :alt: Development code static analysis\n\n.. image:: https://coveralls.io/repos/Alignak-monitoring-contrib/alignak-module-example/badge.svg?branch=develop\n    :target: https://coveralls.io/r/Alignak-monitoring-contrib/alignak-module-example\n    :alt: Development code tests coverage\n\n.. image:: https://badge.fury.io/py/alignak_module_example.svg\n    :target: https://badge.fury.io/py/alignak-module-example\n    :alt: Most recent PyPi version\n\n.. image:: https://img.shields.io/badge/IRC-%23alignak-1e72ff.svg?style=flat\n    :target: http://webchat.freenode.net/?channels=%23alignak\n    :alt: Join the chat #alignak on freenode.net\n\n.. image:: https://img.shields.io/badge/License-AGPL%20v3-blue.svg\n    :target: http://www.gnu.org/licenses/agpl-3.0\n    :alt: License AGPL v3\n\nShort description\n-----------------\n\nThis module is an example skeleton to build Alignak modules ...\n\n\nPackaging\n---------\n\nFeatures and known issues\n~~~~~~~~~~~~~~~~~~~~~~~~~\n\nModules can be attached to an Alignak daemon thanks to the daemon configuration file. The module defines, in its own properties which daemon it may be attached to and the module documentation will informe the user about this.\n\nRather than Shinken, a module cannot have sub-modules. This feature is not currently well tested and robust enough :) If you really need this feature get in touch with us to discuss the matter.\n\nModules types\n~~~~~~~~~~~~~\n\nAlignak attributes a type to each module that is installed. The idea behind the module type is that it is possible to have several existing modules for the same feature. The current modules types:\n\n* retention, for a module that saves and reloads livestate data between each system restart\n* livestate, for a module that will register the current system state (hosts, services states, ...)\n* configuration, for a module that will provide the monitored objects to the Alignak arbiter\n* passive, for a module that will collect passive checks results (NSCA, ...)\n* logs, for a module that will collect monitoring logs\n* action, for a module that will execute some actions (acknownledge, downtime, ...)\n* poller, for a module that will execute checks in a poller\n\nOld Nagios parameters require that some external modules are installed for the corresponding features to be available. The Arbiter will alert if some features are activated and the corresponding modules are not available in the loaded monitoring configuration.\n\nRepositories\n~~~~~~~~~~~~\n\nAll Alignak modules are stored in their own repository in the `Alignak monitoring contrib`_ Github organization.\n\n\nRepository example\n~~~~~~~~~~~~~~~~~~\nRepository directories and files example::\n\n    README.rst\n    LICENCE\n    AUTHORS\n    requirements.txt\n    setup.py\n    version.py\n\n    alignak_module_EXAMPLE/\n        etc/\n            arbiter/\n                modules/\n                    mod-EXAMPLE.cfg\n        __init__.py\n        EXAMPLE.py\n\nThe content of the directory ``alignak_checks_EXAMPLE/etc`` (including files and sub directories) will be copied to */usr/local/var/etc/alignak*.\n\n\nBuilding\n~~~~~~~~\n\nTo build a new module EXAMPLE2:\n\n    * create a new ``alignak-module-EXAMPLE2`` repository which is a copy of this repository\n\n        * rename the ``alignak_module_EXAMPLE`` directory to ``alignak_module_EXAMPLE2``\n\n    * update the ``version.py`` file\n\n        * edit the ``__pkg_name__`` and the ``module_type`` variables\n\n    * update the ``MANIFEST.in`` file\n\n        * rename the ``alignak_module_EXAMPLE`` directory to ``alignak_module_EXAMPLE2``\n\n    * update the ``README.rst`` file\n\n        * remove this section **Packaging**\n        * search and replace ``EXAMPLE`` with ``EXAMPLE2``\n        * complete the **Documentation** chapter\n\n    * update the ``version.py`` file with all the package information\n\n        * ``__module_type__`` will be used to complete the keywords in PyPI and as the sub-directory to store the pack's files\n        * the file docstring will be used as the package description in PyPI\n\n    * update the ``setup.py`` file (**not recommended**)\n\n        * ``setup.py`` should not be modified for most of the modules ... if necessary, do it with much care!\n\nThe ``example.py`` contains all the possible methods that are to be used in the different daemon types. Remove unuseful functions and adapt the remaining ones to your needs. And that's it!\n\n.. note: If you create an external broker module, do not forget to uncomment the 'main' function :)\n\nThen, to build and make your module available to the community, you must use the standard Python setuptools:\n\n    * run ``setup.py register -r pypi`` to register the new package near PyPI\n    * run ``setup.py sdist -r pypi`` to build the package\n    * run ``sudo pip install . -e`` to make the package installed locally (development mode)\n    * run ``sudo pip uninstall -v . -e`` to remove the development mode\n    * run ``sudo pip install . -v`` to make the package installed locally\n    * run ``sudo pip uninstall -v alignak_module_EXAMPLE`` to uninstall the package\n\nWhen your package is ready and functional:\n\n    * run ``python setup.py sdist upload -r pypi`` to upload the package to `PyPI repository`_.\n\n**Note**: every time you upload a package to PyPI you will need to change the module version in the ``version.py`` file.\n\n\n\n\nUnder this line, keep the content for the new built package. Remove the former *Packaging* section of this document.\n-----\n\n\n\n\nInstallation\n------------\n\nThe installation of this module will copy some configuration files in the Alignak default configuration directory (eg. */usr/local/etc/alignak*). The copied files are located in the default sub-directory used for the modules (eg. *arbiter/modules*).\n\nFrom PyPI\n~~~~~~~~~\nTo install the module from PyPI:\n::\n\n   sudo pip install alignak-module-example\n\n\nFrom source files\n~~~~~~~~~~~~~~~~~\nTo install the module from the source files (for developing purpose):\n::\n\n   git clone https://github.com/Alignak-monitoring-contrib/alignak-module-example\n   cd alignak-module-example\n   sudo pip install . -e\n\n**Note:** *using `sudo python setup.py install` will not correctly manage the package configuration files! The recommended way is really to use `pip`;)*\n\n\nConfiguration\n-------------\n\nOnce installed, this module has its own configuration file in the */usr/local/etc/alignak/arbiter/modules* directory.\nThe default configuration file is *mod-example.cfg*. This file is commented to help configure all the parameters.\n\nTo configure an Alignak daemon to use this module:\n\n- edit your daemon configuration file\n- add your module alias value (`example`) to the `modules` parameter of the daemon\n\nTo set up several instances of the same module:\n\n- copy the default configuration to another file,\n- update the module alias parameter (`example_bis`)\n- edit your daemon configuration file\n- add the new `module_alias` parameter value (`example_bis`) to the `modules` parameter of the daemon\n\n\nBugs, issues and contributing\n-----------------------------\n\nContributions to this project are welcome and encouraged ... `issues in the project repository <https://github.com/alignak-monitoring-contrib/alignak-module-example/issues>`_ are the common way to raise an information.",
        "description_content_type": "",
        "docs_url": null,
        "download_url": "",
        "downloads": {
            "last_day": -1,
            "last_month": -1,
            "last_week": -1
        },
        "home_page": "https://github.com/Alignak-monitoring/alignak-module-example",
        "keywords": "alignak monitoring module example",
        "license": "GNU Affero General Public License, version 3",
        "maintainer": "",
        "maintainer_email": "",
        "name": "alignak_module_EXAMPLE",
        "package_url": "https://pypi.org/project/alignak_module_EXAMPLE/",
        "platform": "",
        "project_url": "https://pypi.org/project/alignak_module_EXAMPLE/",
        "project_urls": {
            "Homepage": "https://github.com/Alignak-monitoring/alignak-module-example"
        },
        "release_url": "https://pypi.org/project/alignak_module_EXAMPLE/0.5.4/",
        "requires_dist": null,
        "requires_python": "",
        "summary": "Alignak - Daemon module as an example to build other modules",
        "version": "0.5.4"
    },
    "last_serial": 3868360,
    "releases": {
        "0.2.0": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "faed1b3457efa29f596dec47e8a34de8",
                    "sha256": "46e20f710a6b1e924e28b86dcd249535de528f31aee059d5450ee51e6f499f2f"
                },
                "downloads": -1,
                "filename": "alignak_module_EXAMPLE-0.2.0.tar.gz",
                "has_sig": false,
                "md5_digest": "faed1b3457efa29f596dec47e8a34de8",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 25265,
                "upload_time": "2016-11-05T09:18:53",
                "url": "https://files.pythonhosted.org/packages/47/6e/39c96864ff799818099e9c927212498d96564e3151c04376f1bee4e75a06/alignak_module_EXAMPLE-0.2.0.tar.gz"
            }
        ],
        "0.2.1": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "a92608cddabab5390414db6a95a03f80",
                    "sha256": "abaa968c02460a4530502c295bbca5c890f180a4757a914f3e58b90ceba767a5"
                },
                "downloads": -1,
                "filename": "alignak_module_EXAMPLE-0.2.1.tar.gz",
                "has_sig": false,
                "md5_digest": "a92608cddabab5390414db6a95a03f80",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 25751,
                "upload_time": "2016-12-31T11:04:37",
                "url": "https://files.pythonhosted.org/packages/f9/a9/385f9f5f76a53977dadc20203532661d46584c863629cbfed6d6b1cda656/alignak_module_EXAMPLE-0.2.1.tar.gz"
            }
        ],
        "0.4.0": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "01cab1cb574801b955910a6169e9e452",
                    "sha256": "5ceb81a6392508873bee0cb0e616db44cd11fab3bbd0dcd2c7c0d49509b5ae54"
                },
                "downloads": -1,
                "filename": "alignak_module_EXAMPLE-0.4.0.tar.gz",
                "has_sig": false,
                "md5_digest": "01cab1cb574801b955910a6169e9e452",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 27232,
                "upload_time": "2017-05-03T13:01:32",
                "url": "https://files.pythonhosted.org/packages/40/9b/a1503b61a1a91ca3d2984c6c22bf225f473a28803e092ba57d75a6c4cac8/alignak_module_EXAMPLE-0.4.0.tar.gz"
            }
        ],
        "0.4.1": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "eb3a4f868af30fcaed355ba66fd696ca",
                    "sha256": "8eb94d9b224f4162d434d4f5d5bd306a811d25f11a6a1be72a12f5e47192375a"
                },
                "downloads": -1,
                "filename": "alignak_module_EXAMPLE-0.4.1.tar.gz",
                "has_sig": false,
                "md5_digest": "eb3a4f868af30fcaed355ba66fd696ca",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 27236,
                "upload_time": "2017-05-04T04:35:13",
                "url": "https://files.pythonhosted.org/packages/8a/97/2c194c1e6fc90a816f3f071c10d613a14a2e35da5794e1c1483291715c50/alignak_module_EXAMPLE-0.4.1.tar.gz"
            }
        ],
        "0.5.0": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "fb7dc75166ac43c375f0226cb4064ca6",
                    "sha256": "e777b529d7bcd4d93a1554496304d562ba8db934b5fc219acc7f37310c62ae3f"
                },
                "downloads": -1,
                "filename": "alignak_module_EXAMPLE-0.5.0.tar.gz",
                "has_sig": false,
                "md5_digest": "fb7dc75166ac43c375f0226cb4064ca6",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 30372,
                "upload_time": "2018-05-08T08:13:33",
                "url": "https://files.pythonhosted.org/packages/a1/55/17eb590107e3506e83a15f2ce8f87f1399783b57b367e4f22c67d7ef95d4/alignak_module_EXAMPLE-0.5.0.tar.gz"
            }
        ],
        "0.5.1": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "527bc46a653f1b3f54cd406c7ae23d8f",
                    "sha256": "a5fe062f7eb48a992918291f92f6602d25edcca36b665ff32ecf0db62a6b43c3"
                },
                "downloads": -1,
                "filename": "alignak_module_EXAMPLE-0.5.1.tar.gz",
                "has_sig": false,
                "md5_digest": "527bc46a653f1b3f54cd406c7ae23d8f",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 30370,
                "upload_time": "2018-05-08T08:16:11",
                "url": "https://files.pythonhosted.org/packages/33/41/7211003f99310a82c830c6467c7efc335f710a056ac8c2bf2fbf0a4d77ff/alignak_module_EXAMPLE-0.5.1.tar.gz"
            }
        ],
        "0.5.2": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "6f80414e4f892e72e2dbde0ad3c7df73",
                    "sha256": "91392f9143eddadf4f31f07d78edde25f63bc4f361639b72b4da1dc9b088d9c3"
                },
                "downloads": -1,
                "filename": "alignak_module_EXAMPLE-0.5.2.tar.gz",
                "has_sig": false,
                "md5_digest": "6f80414e4f892e72e2dbde0ad3c7df73",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 30651,
                "upload_time": "2018-05-08T08:49:47",
                "url": "https://files.pythonhosted.org/packages/df/76/e6de478dd2de9713320a4737f75c3b561d21e05ec59ce247e38c1baa18a4/alignak_module_EXAMPLE-0.5.2.tar.gz"
            }
        ],
        "0.5.3": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "5c2ce997c4280570170cf5c055f0044a",
                    "sha256": "5a8bc7235cabe53181532d604d8b3d7fde0704ddb40c0c22afee58e83b885585"
                },
                "downloads": -1,
                "filename": "alignak_module_EXAMPLE-0.5.3.tar.gz",
                "has_sig": false,
                "md5_digest": "5c2ce997c4280570170cf5c055f0044a",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 30647,
                "upload_time": "2018-05-16T03:36:19",
                "url": "https://files.pythonhosted.org/packages/00/57/f0ff08ac54b2b560da80029551cba8922969616150cf80d079a6208205aa/alignak_module_EXAMPLE-0.5.3.tar.gz"
            }
        ],
        "0.5.4": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "95b0c367771581ae0ed5b99a45297c58",
                    "sha256": "6663f09042fd4f0e420a6df2a174be55d19637aab3c5f1af9c732e3aad4528f8"
                },
                "downloads": -1,
                "filename": "alignak_module_EXAMPLE-0.5.4.tar.gz",
                "has_sig": false,
                "md5_digest": "95b0c367771581ae0ed5b99a45297c58",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 30662,
                "upload_time": "2018-05-16T11:56:15",
                "url": "https://files.pythonhosted.org/packages/8e/b6/d0c957c3f27cba13a4d0911e2c12f6e001e6a2ea23a0ce19759cdb39c8f3/alignak_module_EXAMPLE-0.5.4.tar.gz"
            }
        ]
    },
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "md5": "95b0c367771581ae0ed5b99a45297c58",
                "sha256": "6663f09042fd4f0e420a6df2a174be55d19637aab3c5f1af9c732e3aad4528f8"
            },
            "downloads": -1,
            "filename": "alignak_module_EXAMPLE-0.5.4.tar.gz",
            "has_sig": false,
            "md5_digest": "95b0c367771581ae0ed5b99a45297c58",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": null,
            "size": 30662,
            "upload_time": "2018-05-16T11:56:15",
            "url": "https://files.pythonhosted.org/packages/8e/b6/d0c957c3f27cba13a4d0911e2c12f6e001e6a2ea23a0ce19759cdb39c8f3/alignak_module_EXAMPLE-0.5.4.tar.gz"
        }
    ]
}