summaryrefslogtreecommitdiffstats
path: root/web/input/development.md
blob: 9bd128b4dda805b46a5df3fa0e665fc804e1b3d3 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
title: Development
parent: Home
menu: 6
---

# Development

## Software Repositories

The [Monitoring Plugins Development Team][team] takes care of three projects:

* Monitoring Plugins — the core bundle of standard plugins.
* Monitoring::Plugin — a module used by plugins written in Perl.
* NagiosMIB — SNMP MIB files for traps sent from [Nagios][nagios].

These projects are maintained in separate repositories on [GitHub][github]:

* <https://github.com/monitoring-plugins/repositories>

Contributions are always welcome!  If you'd like to provide patches, please
[fork][fork] the desired repository and submit a [pull request][pull].  In
case you're not familiar with Git, you might want to look into our [short
introduction][git-intro] or [some other Git documentation][git-ref], first.

## Tests

### Integration Tests

Our development workflow includes [continuous integration
tests][travis-project] hosted by [Travis CI][travis] and [static code
analysis][coverity-project] performed by [Coverity Scan][coverity].

* Travis CI build status ([master branch][master-branch]): ![Build Status master][master-img]{: .travis }
* Travis CI build status ([maint branch][maint-branch]): ![Build Status maint][maint-img]{: .travis }
* Coverity metric ([coverity branch][coverity-branch]): ![Coverity Metric][coverity-img]{: .travis }

### Bundled Test Suite

The Monitoring Plugins bundle comes with an extensive test suite.  Some of the
tests require [libtap][libtap], a copy of which is shipped with the Monitoring
Plugins source tarball.  In order to execute all tests, issue the following
commands:

    $ ./tools/setup # When building from Git.
    $ ./configure --enable-libtap
    $ make
    $ make test

Also see our testing-related [development FAQs][dev-faq].

Regular tests of the latest code are scheduled automatically on various
platforms, the results can be [viewed online][tests].

[team]: team.html "Monitoring Plugins Development Team"
[nagios]: http://www.nagios.org/ "Nagios"
[github]: https://github.com/ "GitHub"
[fork]: https://help.github.com/articles/fork-a-repo "Fork Documentation"
[pull]: https://help.github.com/articles/using-pull-requests "Pull Request Documentation"
[git-intro]: doc/faq/git.html "Quick Git Introduction"
[git-ref]: doc/faq/git.html#references "Git References"
[master-branch]: https://github.com/monitoring-plugins/monitoring-plugins/tree/master "Branch master"
[maint-branch]: https://github.com/monitoring-plugins/monitoring-plugins/tree/maint "Branch maint"
[coverity-branch]: https://github.com/monitoring-plugins/monitoring-plugins/tree/coverity "Branch coverity"
[master-img]: https://api.travis-ci.org/monitoring-plugins/monitoring-plugins.png?branch=master "Build Status master"
[maint-img]: https://api.travis-ci.org/monitoring-plugins/monitoring-plugins.png?branch=maint "Build Status maint"
[coverity-img]: https://scan.coverity.com/projects/1435/badge.svg?flat=1 "Coverity Metric"
[libtap]: http://jc.ngo.org.uk/trac-bin/trac.cgi/wiki/LibTap "LibTap Homepage"
[dev-faq]: doc/faq/#development "Development FAQs"
[travis]: https://travis-ci.org/ "Travis CI"
[travis-project]: https://travis-ci.org/monitoring-plugins/monitoring-plugins "Monitoring Plugins at Travis CI"
[coverity]: https://scan.coverity.com/ "Coverity Scan"
[coverity-project]: https://scan.coverity.com/projects/1435 "Monitoring Plugins at Coverity Scan"
[tests]: tests.html "Test Results"

<!--% # vim:set filetype=markdown textwidth=78 joinspaces expandtab: # %-->