Add a README and a TODO
parent
82b4ba4c71
commit
9d46d14718
@ -0,0 +1,52 @@
|
|||||||
|
CheckLib: A simple wrapper to make implementing Nagios/Icinga checks in Python
|
||||||
|
simple
|
||||||
|
===
|
||||||
|
|
||||||
|
TODO: Write a reasonable Readme :-)
|
||||||
|
|
||||||
|
Documentation
|
||||||
|
---
|
||||||
|
|
||||||
|
Probably only as a part of source code. Currently it is short and aimed
|
||||||
|
at Python developers anyway.
|
||||||
|
|
||||||
|
The primary target are plugins for Icinga 2.
|
||||||
|
|
||||||
|
Documentation of plugin API is at TODO and TODO.
|
||||||
|
|
||||||
|
Project goals (and non-goals)
|
||||||
|
----
|
||||||
|
|
||||||
|
The aim is to make writing _simple_ Python checks _really_ easy, and also to be
|
||||||
|
lightweight. Therefore, only basic and common features will likely be
|
||||||
|
implemented. (And last but not least, it mainly depends on my time :-))
|
||||||
|
|
||||||
|
If you need a fully-featured library, feel free to use
|
||||||
|
[Nagiosplugin](https://pypi.org/project/nagiosplugin/).
|
||||||
|
|
||||||
|
I would like to keep this as a pure vanilla Python code. It lowers the barrier
|
||||||
|
to code inspection and contribution and does not add dependencies, so that this
|
||||||
|
can be used in very limited environments.
|
||||||
|
|
||||||
|
The exact scope is currently not rigorously defined, feel free to contact me
|
||||||
|
if you are not sure.
|
||||||
|
|
||||||
|
Bugs, feedback, ideas, patches, contact &c.
|
||||||
|
-----
|
||||||
|
Please send anything you have on your mind to
|
||||||
|
[checklib@pokemon.ledoian.cz](mailto:checklib@pokemon.ledoian.cz).
|
||||||
|
|
||||||
|
I currently want to know if anyone else has tried to use the code :-)
|
||||||
|
|
||||||
|
(For patches you can use `git send-email` (TODO link to Drew DeVault's site))
|
||||||
|
|
||||||
|
Licence
|
||||||
|
----
|
||||||
|
|
||||||
|
Currently the code is just dumb implementation of the plugin spec,
|
||||||
|
so there is little creative value. So WTFPL it is for now. (I might decide to
|
||||||
|
change it later. Also, if any contributor comes by, they can steer the
|
||||||
|
direction. I want to keep this as Free Software, though)[^Wrote me when this
|
||||||
|
project was marked as private :-)]
|
||||||
|
|
||||||
|
(TODO: Proper licencing, maybe even SPDX info)
|
Loading…
Reference in New Issue