Release History

1.4.0 (2025-05-19)

IMPORTANT NOTE: Please see the announcement about the new python release support policy.

new: add check name to Check constructor (Simon Meggle)
change: drop support for Python 3.4, 3.5, and 3.6 (#65)
change: add support for Python 3.11, 3.12, and 3.13 (#65)
fix: correct reference to class ~.performace.Performance in Context.performance docstring (Josef Friedrich)
fix: tests use importlib where available in place of deprecated pkg_resources (#50)
fix: build environment updates to support py2.7 (#64)
doc: additional text explaining the naming of the Warn state class (#26)
doc: updated document building for newer Sphinx (#72)
doc: updated document building for new readthedocs.io deployment process (#79)
linting: replaced some elif statements occluded by return statements (no-else-return)
linting: cleaned up “inconsistent-return-statements” errors
linting: replace flake8 with ruff (#60)
linting: add security tests with pip-audit and bandit (#61)

Include doc and tests directories in source distribution to support Gentoo package building tests (#22)
Update official python support to 2.7, 3.4+ in README

Add optional keyword parameter verbose to Runtime.guarded(). This parameter allows to set verbose level in the early execution phase (#13).
Allow Context.evaluate() return either a Result or ServiceState object. In case the latter is returned, it gets automatically wrapped in a Result object (#6).

Fix bug that caused a UnicodeDecodeError when using non-ASCII characters in fmt_metric (#12).
Print perfdata always on a single line (even in multi-line mode) to improve compatibility with various monitoring systems (#11).

Mention that nagiosplugin also runs with Python 3.4 (no code changes necessary).
Make name prefix in status output optional by allowing to assign None to Check.name.
Accept bare metric as return value from Resource.probe().
Fix bug where Context.describe() was not used to obtain metric description (#13162).

New Summary.empty method is called if there are no results present (#11593).
Improve range violation wording (#11597).
Ensure that nagiosplugin install correctly with current setuptools (#12660).
Behave and do not attach anything to the root logger.
Add debugging topic guide. Explain how to disable the timeout when using pdb (#11592).

LogTail returns lines as byte strings in Python 3 to avoid codec issues (#11564).
LogTail gives a line-based iterator instead of a file object (#11564).
Basic API docs for the most important classes (#11612).
Made compatible with Python 2.7 (#11533).
Made compatible with Python 3.3.

Improve error reporting for missing contexts.
Exit with code 3 if no metrics have been generated.
Improve default Summary.verbose() to list all threshold violations.
Move main source repository to https://bitbucket.org/gocept/nagiosplugin/ (#11561).

Completely reworked API. The new API is not compatible with the old 0.4 API so you must update your plugins.
Python 3 support.
The Cookie class is now basically a persistent dict and accepts key/value pairs. Cookie are stored as JSON files by default so they can be inspected by the system administrator (#9400).
New LogTail class which provides convenient access to constantly growing log files which are eventually rotated.

Bugfix release to fix issues reported by users.