{ "info": { "author": "Christian Kauhaus", "author_email": "kc@flyingcircus.io", "bugtrack_url": null, "classifiers": [ "Development Status :: 5 - Production/Stable", "Environment :: Plugins", "Intended Audience :: Developers", "Intended Audience :: System Administrators", "License :: OSI Approved :: Zope Public License", "Operating System :: Microsoft :: Windows", "Operating System :: POSIX", "Programming Language :: Python :: 2.7", "Programming Language :: Python :: 3.2", "Programming Language :: Python :: 3.3", "Programming Language :: Python :: 3.4", "Topic :: Software Development :: Libraries :: Python Modules", "Topic :: System :: Monitoring" ], "description": "The nagiosplugin library\n========================\n\nAbout\n-----\n\n**nagiosplugin** is a Python class library which helps writing Nagios (or Icinga)\ncompatible plugins easily in Python. It cares for much of the boilerplate code\nand default logic commonly found in Nagios checks, including:\n\n- Nagios 3 Plugin API compliant parameters and output formatting\n- Full Nagios range syntax support\n- Automatic threshold checking\n- Multiple independend measures\n- Custom status line to communicate the main point quickly\n- Long output and performance data\n- Timeout handling\n- Persistent \"cookies\" to retain state information between check runs\n- Resume log file processing at the point where the last run left\n- No dependencies beyond the Python standard library (except for Python 2.6).\n\nnagiosplugin runs on POSIX and Windows systems. It is compatible with Python\n3.4, Python 3.3, Python 3.2, and Python 2.7.\n\n\nFeedback and Suggestions\n------------------------\n\nnagiosplugin is primarily written and maintained by Christian Kauhaus\n. Feel free to contact the author for bugs, suggestions and\npatches.\n\nA public issue tracker can be found at\nhttps://bitbucket.org/flyingcircus/nagiosplugin/issues/.\n\n\nLicense\n-------\n\nThe nagiosplugin package is released under the Zope Public License 2.1 (ZPL), a\nBSD-style Open Source license.\n\n\nDocumentation\n-------------\n\nComprehensive documentation is `available online`_. The examples mentioned in\nthe `tutorials`_ can also be found in the `nagiosplugin/examples` directory of\nthe source distribution.\n\n.. _available online: http://pythonhosted.org/nagiosplugin/\n.. _tutorials: http://pythonhosted.org/nagiosplugin/tutorial/\n\n.. vim: set ft=rst:\n\n\nDevelopment\n===========\n\nGetting the source\n------------------\n\nThe source can be obtained via mercurial from\nhttps://bitbucket.org/gocept/nagiosplugin::\n\n hg clone https://bitbucket.org/gocept/nagiosplugin\n\nThis package supports installation in a virtualenv using `zc.buildout`_.\n\n.. _zc.buildout: https://pypi.python.org/pypi/zc.buildout\n\n\nCreating a build with zc.buildout\n---------------------------------\n\nFirst, create a virtualenv if not already present::\n\n virtualenv -p python3.4 --no-setuptools .\n\nzc.buildout will take care of all required dependencies::\n\n bin/pip3.2 install -U zc.buildout\n bin/buildout\n\nIf you want to use another Python version like 2.7, just the same steps with the\nPython version substituted::\n\n virtualenv -p python2.7 --no-setuptools .\n bin/pip2.7 install -U zc.buildout\n bin/buildout\n\n\nTests\n-----\n\nWhen the buildout succeeds, run the unit test by invoking::\n\n bin/test\n\nOur `build server`_ runs test against the trunk on a regular basis.\n\n.. image:: https://builds.flyingcircus.io/job/nagiosplugin/PYTHON=System-CPython-2.7/badge/icon\n :target: https://builds.flyingcircus.io/job/nagiosplugin/\n.. _build server: https://builds.flyingcircus.io/job/nagiosplugin/\n\nnagiosplugin also includes support for coverage reports. It aims at 100% test\ncoverage where possible. The preferred way to get a coverate report is to use ::\n\n bin/createcoverage\n\nto determine test coverage and open the report in a web browser. Alternatively,\nrun ::\n\n bin/coverage run bin/test\n\nto get a purely text-based coverage report.\n\nYou may run the supplied examples with the local interpreter::\n\n bin/py src/nagiosplugin/examples/check_load.py\n\n\nDocumentation\n-------------\n\nThe documentation uses Sphinx. Build the documentation (buildout should have\nbeen running before to install Sphinx etc.)::\n\n make -C doc html\n\n\nHow to release\n--------------\n\nTo make a release, we prefer `zest.releaser`_. To make a release, follow\nthe standard procedure, which usually boils down to::\n\n fullrelease\n\n`nagiosplugin` tried to obey the semantic version numbering specification\npublished on SemVer_ but adapts it a little bit to be `PEP 386`_ compliant.\n\n.. _zest.releaser: https://pypi.python.org/pypi/zest.releaser/\n.. _SemVer: http://semver.org/\n.. _PEP 386: https://www.python.org/dev/peps/pep-0386/\n\n.. vim: set ft=rst sw=3 sts=3 et:\n\n\nContributors\n============\n\n`nagiosplugin` has become what it is now with the help of many contributors from\nthe community. We want to thank everyone who has invested time and energy to\nmake `nagiosplugin` better:\n\n* Wolfgang Schnerring for thoughts on the design.\n* Thomas Lotze for improving the test infrastructure.\n* Christian Theune for comments and general feedback.\n* Michael Howitz and Andrei Chirila for the\n Python 3 port.\n* Birger Schmidt for bug reports.\n* Florian Lagg for Windows compatibility fixes\n* Jeff Goldschrafe for the Python 2.6 backport.\n* Jos\u00e9 Manuel Fardello for a logging fix.\n* Jordan Metzmeier for build fixes and Debian\n packaging.\n* Andrey Panfilov for a perfdata fix.\n* Mihai Limb\u0103\u0219an for various output formatting fixes.\n\n.. vim: set ft=rst sw=3 sts=3 et:\n\n\nRelease History\n===============\n\n\n1.2.4 (2016-03-12)\n------------------\n\n- Add optional keyword parameter `verbose` to Runtime.guarded(). This parameter\n allows to set verbose level in the early execution phase (#13).\n- Allow Context.evaluate() return either a Result or ServiceState object. In\n case the latter is returned, it gets automatically wrapped in a Result object\n (#6).\n\n\n1.2.3 (2015-10-30)\n------------------\n\n- Fix bug that caused a UnicodeDecodeError when using non-ASCII characters in\n fmt_metric (#12).\n- Print perfdata always on a single line (even in multi-line mode) to improve\n compatibility with various monitoring systems (#11).\n\n\n1.2.2 (2014-05-27)\n------------------\n\n- Mention that nagiosplugin also runs with Python 3.4 (no code changes\n necessary).\n- Make name prefix in status output optional by allowing to assign None to\n Check.name.\n- Accept bare metric as return value from Resource.probe().\n- Fix bug where Context.describe() was not used to obtain metric description\n (#13162).\n\n\n1.2.1 (2014-03-19)\n------------------\n\n- Fix build failures with LANG=C (#13140).\n- Remove length limitation of perfdata labels (#13214).\n- Fix formatting of large integers as Metric values (#13287).\n- Range: allow simple numerals as argument to Range() (#12658).\n- Cookie: allow for empty state file specification (#12788).\n\n\n1.2 (2013-11-08)\n----------------\n\n- New `Summary.empty` method is called if there are no results present (#11593).\n- Improve range violation wording (#11597).\n- Ensure that nagiosplugin install correctly with current setuptools (#12660).\n- Behave and do not attach anything to the root logger.\n- Add debugging topic guide. Explain how to disable the timeout when using pdb\n (#11592).\n\n\n1.1 (2013-06-19)\n----------------\n\n- Identical to 1.1b1.\n\n\n1.1b1 (2013-05-28)\n------------------\n\n- Made compatible with Python 2.6 (#12297).\n- Tutorial #3: check_users (#11539).\n- Minor documentation improvements.\n\n\n1.0.0 (2013-02-05)\n------------------\n\n- LogTail returns lines as byte strings in Python 3 to avoid codec issues\n (#11564).\n- LogTail gives a line-based iterator instead of a file object (#11564).\n- Basic API docs for the most important classes (#11612).\n- Made compatible with Python 2.7 (#11533).\n- Made compatible with Python 3.3.\n\n\n1.0.0b1 (2012-10-29)\n--------------------\n\n- Improve error reporting for missing contexts.\n- Exit with code 3 if no metrics have been generated.\n- Improve default Summary.verbose() to list all threshold violations.\n- Move main source repository to https://bitbucket.org/gocept/nagiosplugin/\n (#11561).\n\n\n1.0.0a2 (2012-10-26)\n--------------------\n\n- API docs for the most important classes (#7939).\n- Added two tutorials (#9425).\n- Fix packaging issues.\n\n\n1.0.0a1 (2012-10-25)\n--------------------\n\n- Completely reworked API. The new API is not compatible with the old 0.4 API so\n you must update your plugins.\n- Python 3 support.\n- The `Cookie` class is now basically a persistent dict and accepts key/value\n pairs. Cookie are stored as JSON files by default so they can be inspected by\n the system administrator (#9400).\n- New `LogTail` class which provides convenient access to constantly growing log\n files which are eventually rotated.\n\n\n0.4.5 (2012-06-18)\n------------------\n\n- Windows port. `nagiosplugin` code now runs under pywin32 (#10899).\n- Include examples in egg release (#9901).\n\n\n0.4.4 (2011-07-18)\n------------------\n\nBugfix release to fix issues reported by users.\n\n- Improve Mac OS X compatibility (#8755).\n- Include examples in distribution (#8555).\n\n\n0.4.3 (2010-12-17)\n------------------\n\n- Change __str__ representation of large numbers to avoid scientific notation.\n\n\n0.4.2 (2010-10-11)\n------------------\n\n- Packaging issues.\n\n\n0.4.1 (2010-09-21)\n------------------\n\n- Fix distribution to install correctly.\n- Documentation: tutorial and topic guides.\n\n\n0.4 (2010-08-17)\n----------------\n\n- Initial public release.\n\n.. vim: set ft=rst sw=3 sts=3 spell spelllang=en:", "description_content_type": null, "docs_url": "https://pythonhosted.org/nagiosplugin/", "download_url": "https://pypi.python.org/pypi/nagiosplugin", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://bitbucket.org/flyingcircus/nagiosplugin", "keywords": "Nagios Icinga plugin check monitoring", "license": "ZPL-2.1", "maintainer": null, "maintainer_email": null, "name": "nagiosplugin", "package_url": "https://pypi.org/project/nagiosplugin/", "platform": "UNKNOWN", "project_url": "https://pypi.org/project/nagiosplugin/", "project_urls": { "Download": "https://pypi.python.org/pypi/nagiosplugin", "Homepage": "https://bitbucket.org/flyingcircus/nagiosplugin" }, "release_url": "https://pypi.org/project/nagiosplugin/1.2.4/", "requires_dist": null, "requires_python": null, "summary": "Class library for writing Nagios (Icinga) plugins", "version": "1.2.4" }, "last_serial": 2003347, "releases": { "0.4": [ { "comment_text": "", "digests": { "md5": "c98d5218276fbb920f3035545a263d28", "sha256": "2c65e0c43d72a28d0c08204e55c867c94564309d7b514c77e63eaca538aec454" }, "downloads": -1, "filename": "nagiosplugin-0.4.tar.gz", "has_sig": false, "md5_digest": "c98d5218276fbb920f3035545a263d28", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 12058, "upload_time": "2010-08-17T21:39:09", "url": "https://files.pythonhosted.org/packages/2d/67/3dbc99bd5915d0fab70cca06ec67e383f12bf7d40a2285aab0b602725ada/nagiosplugin-0.4.tar.gz" } ], "0.4.1": [ { "comment_text": "", "digests": { "md5": "edb75cac214cf2dc108a9bcc44dee0b3", "sha256": "2744d16a038f1f97daa7a121ad50936139a5e770535343d47b005e9ad47886b8" }, "downloads": -1, "filename": "nagiosplugin-0.4.1.tar.gz", "has_sig": false, "md5_digest": "edb75cac214cf2dc108a9bcc44dee0b3", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 13917, "upload_time": "2010-09-21T22:12:26", "url": "https://files.pythonhosted.org/packages/39/cb/820d66fc170694d03d136adfd9592e3bad2056896f5624f14403fc50b7f0/nagiosplugin-0.4.1.tar.gz" } ], "0.4.2": [ { "comment_text": "", "digests": { "md5": "c7a7411c1ef6bd1ae8b50ca722574d9f", "sha256": "791d4bad9324f52109ca5b4ec1cad8ae23f8506a51694cea2115915c5c1b2354" }, "downloads": -1, "filename": "nagiosplugin-0.4.2.tar.gz", "has_sig": false, "md5_digest": "c7a7411c1ef6bd1ae8b50ca722574d9f", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 14314, "upload_time": "2010-10-11T14:15:47", "url": "https://files.pythonhosted.org/packages/37/39/fdb86b24669e07ea3a6e465b1e169699b594898f50bc9c00a3176efd8377/nagiosplugin-0.4.2.tar.gz" } ], "0.4.3": [ { "comment_text": "", "digests": { "md5": "0fc988eb2748f225d6557a2393db1dec", "sha256": "868c75ca8f9f23ab03f4d13ca506f1fc7e9ffd8e771afd9a53493c89efb02eba" }, "downloads": -1, "filename": "nagiosplugin-0.4.3.tar.gz", "has_sig": false, "md5_digest": "0fc988eb2748f225d6557a2393db1dec", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 14522, "upload_time": "2010-12-17T22:09:27", "url": "https://files.pythonhosted.org/packages/cf/43/4704e432b436989af9e890f95ba1f21eb2bfddc0f0a805fae2e59d424067/nagiosplugin-0.4.3.tar.gz" } ], "0.4.4": [ { "comment_text": "", "digests": { "md5": "d1a90ef09be3860dd5d922ae3b8df412", "sha256": "69cf2da60271a2048f41d3de2e0f062f333c6ca3d36a2adad9ba34f7c1476df9" }, "downloads": -1, "filename": "nagiosplugin-0.4.4.tar.gz", "has_sig": false, "md5_digest": "d1a90ef09be3860dd5d922ae3b8df412", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 29667, "upload_time": "2011-07-20T13:20:51", "url": "https://files.pythonhosted.org/packages/48/2f/8257b7a8d50443cbe63979eccd7bd552b9905113a195513e4d9d270597ef/nagiosplugin-0.4.4.tar.gz" } ], "0.4.5": [ { "comment_text": "", "digests": { "md5": "c7cfbbd210f471424bf761470c980ce5", "sha256": "e1aae1811dcc54a7d55486a8eebb898b7675825e816ab4ab2f9ad0c6cb32a662" }, "downloads": -1, "filename": "nagiosplugin-0.4.5.tar.gz", "has_sig": false, "md5_digest": "c7cfbbd210f471424bf761470c980ce5", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 26023, "upload_time": "2012-06-18T16:18:34", "url": "https://files.pythonhosted.org/packages/b7/bf/ea54ff76f0919d769599a93c7e6e3e35b5d5c4496f0f5caa2230b31a7764/nagiosplugin-0.4.5.tar.gz" } ], "1.0.0": [ { "comment_text": "", "digests": { "md5": "02989b93e9da7fec49f1c2c38a20c9dc", "sha256": "7912ac933e5b1a38f6586ee1ffed88b5756464ec3f680f82fd5c84a9b057ebbe" }, "downloads": -1, "filename": "nagiosplugin-1.0.0.tar.gz", "has_sig": false, "md5_digest": "02989b93e9da7fec49f1c2c38a20c9dc", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 47521, "upload_time": "2013-02-05T21:14:04", "url": "https://files.pythonhosted.org/packages/35/84/65010d6bd494b8ce8029166aa74f89ca8422628ee6b5b91ade28bba6cd6d/nagiosplugin-1.0.0.tar.gz" } ], "1.1": [ { "comment_text": "", "digests": { "md5": "cd9f9588dde7deed928494245fbbac2e", "sha256": "65768916b72a58c308a7c9cf84ea2c7b1b230dac6ee20ade8642c2ed88993496" }, "downloads": -1, "filename": "nagiosplugin-1.1.tar.gz", "has_sig": false, "md5_digest": "cd9f9588dde7deed928494245fbbac2e", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 47975, "upload_time": "2013-06-19T20:53:15", "url": "https://files.pythonhosted.org/packages/b8/5d/66215ffc8f6bf47e0f0072f0ad3a05e0373dd8908241c0a5f7c072440d3f/nagiosplugin-1.1.tar.gz" } ], "1.2": [ { "comment_text": "", "digests": { "md5": "2f2d26e8a1b846fd4db936ef00a1a4e3", "sha256": "0fe531336190353cceae9c5e629e3ac300f9d2f0b6633dbce44d67efdead4e95" }, "downloads": -1, "filename": "nagiosplugin-1.2.tar.gz", "has_sig": false, "md5_digest": "2f2d26e8a1b846fd4db936ef00a1a4e3", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 36479, "upload_time": "2014-01-10T09:37:36", "url": "https://files.pythonhosted.org/packages/f1/ec/80f8bdca2005582fe5dce4e88133a98bf1a5a03dc87fc2ab2717a494209e/nagiosplugin-1.2.tar.gz" }, { "comment_text": "", "digests": { "md5": "67abb8909655aebbb3439f8ae3f03901", "sha256": "93a7a2a863ae94d465ad00a3fe178f2aa29627260b2a21f33c1ee15ef537d0fd" }, "downloads": -1, "filename": "nagiosplugin-1.2.zip", "has_sig": false, "md5_digest": "67abb8909655aebbb3439f8ae3f03901", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 58972, "upload_time": "2013-11-08T20:25:37", "url": "https://files.pythonhosted.org/packages/14/a8/12d37b8b42affa0db7a8b3e2f81ece0848f4ce5c4020e1ac12c65e009348/nagiosplugin-1.2.zip" } ], "1.2.1": [ { "comment_text": "", "digests": { "md5": "d81c724525e8e8b290d17046109e71d2", "sha256": "e8891f3f4c113513ccf6cc32104d94ad6a73083ce1f422b35591f1d920860ca1" }, "downloads": -1, "filename": "nagiosplugin-1.2.1.tar.gz", "has_sig": false, "md5_digest": "d81c724525e8e8b290d17046109e71d2", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 35007, "upload_time": "2014-03-19T12:22:03", "url": "https://files.pythonhosted.org/packages/2f/c1/c3619ef71a97727629f9fb1449dec4347b561d5f63be8fce8fae7034049e/nagiosplugin-1.2.1.tar.gz" }, { "comment_text": "", "digests": { "md5": "52f969fcaf1b6352664847e2eb50a3dd", "sha256": "31f1d7f15da54b5e61536bb7df4f6061f736d3ccc679a2e3acf44c2f4cbee95c" }, "downloads": -1, "filename": "nagiosplugin-1.2.1.zip", "has_sig": false, "md5_digest": "52f969fcaf1b6352664847e2eb50a3dd", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 60660, "upload_time": "2014-03-19T12:17:06", "url": "https://files.pythonhosted.org/packages/9c/a8/bd3fa592b97545a0c4f05d086eca93ffd2764663361ec6201c8fed0fbb96/nagiosplugin-1.2.1.zip" } ], "1.2.2": [ { "comment_text": "", "digests": { "md5": "c85e1641492d606d929b02aa262bf55d", "sha256": "b61413410d79fe0785d411365f71af1b2b906a349ba76315f32c451eba12b51f" }, "downloads": -1, "filename": "nagiosplugin-1.2.2.tar.gz", "has_sig": false, "md5_digest": "c85e1641492d606d929b02aa262bf55d", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 39189, "upload_time": "2014-05-27T13:54:03", "url": "https://files.pythonhosted.org/packages/30/15/2445998d1ec62854aa0e6dd57a921250e874e6b101076fdeb1d604382f9d/nagiosplugin-1.2.2.tar.gz" }, { "comment_text": "", "digests": { "md5": "7f39dc55064a0cb9db7117e607e7de1a", "sha256": "e0e2fb0dc38bcdae8496276f702c378d9f80274a02f589478b0d50dcdb24f468" }, "downloads": -1, "filename": "nagiosplugin-1.2.2.zip", "has_sig": false, "md5_digest": "7f39dc55064a0cb9db7117e607e7de1a", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 61393, "upload_time": "2014-05-27T13:53:04", "url": "https://files.pythonhosted.org/packages/9c/1f/17a97faf38624a6a7cba546f9b624521aecf32b75c80c30a4d1f927dafdd/nagiosplugin-1.2.2.zip" } ], "1.2.3": [ { "comment_text": "", "digests": { "md5": "de33b2b8d40301511da5bb0b789254aa", "sha256": "9a1729d6479b71b1c7184e88a6214b00133953921df1be2d14ccb35a94a3c8dd" }, "downloads": -1, "filename": "nagiosplugin-1.2.3.tar.gz", "has_sig": false, "md5_digest": "de33b2b8d40301511da5bb0b789254aa", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 37570, "upload_time": "2015-10-30T15:55:35", "url": "https://files.pythonhosted.org/packages/19/10/c8449cfd951c929aa69636a615ceea0b62f51234fc3bca2f9072d946cba4/nagiosplugin-1.2.3.tar.gz" } ], "1.2.4": [ { "comment_text": "", "digests": { "md5": "f22ee91fc89d0c442803bdf27fab8c99", "sha256": "6b020aca516f3643ad02378866d382f0296bf378fa3874d9b2e1d3cc6135f8bb" }, "downloads": -1, "filename": "nagiosplugin-1.2.4.tar.gz", "has_sig": false, "md5_digest": "f22ee91fc89d0c442803bdf27fab8c99", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 38290, "upload_time": "2016-03-12T18:47:05", "url": "https://files.pythonhosted.org/packages/f0/82/4c54ab5ee763c452350d65ce9203fb33335ae5f4efbe266aaa201c9f30ad/nagiosplugin-1.2.4.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "f22ee91fc89d0c442803bdf27fab8c99", "sha256": "6b020aca516f3643ad02378866d382f0296bf378fa3874d9b2e1d3cc6135f8bb" }, "downloads": -1, "filename": "nagiosplugin-1.2.4.tar.gz", "has_sig": false, "md5_digest": "f22ee91fc89d0c442803bdf27fab8c99", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 38290, "upload_time": "2016-03-12T18:47:05", "url": "https://files.pythonhosted.org/packages/f0/82/4c54ab5ee763c452350d65ce9203fb33335ae5f4efbe266aaa201c9f30ad/nagiosplugin-1.2.4.tar.gz" } ] }