Skip to content

Commit ff91079

Browse files
committed
chore: update docs & branding, push requirements
1 parent 7f4d661 commit ff91079

11 files changed

+132
-65
lines changed

Diff for: AUTHORS.rst

+6-1
Original file line numberDiff line numberDiff line change
@@ -5,9 +5,14 @@ Credits
55
Development Lead
66
----------------
77

8-
* Ralph Offinger <[email protected]>
8+
* Christian Jonak-Möchel <[email protected]>
99

1010
Contributors
1111
------------
1212

1313
* Thomas Fischer <[email protected]>
14+
15+
Special Thanks
16+
-------------
17+
18+
* Ralph Offinger <[email protected]> - For starting this project and having done most of the work

Diff for: CONTRIBUTING.rst

+9-12
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,7 @@ Types of Contributions
1313
Report Bugs
1414
~~~~~~~~~~~
1515

16-
Report bugs at https://github.com/ralph-hm/nagios_check_paloalto/issues.
16+
Report bugs at https://github.com/TeraIT-at/check_paloalto_ng/issues.
1717

1818
If you are reporting a bug, please include:
1919

@@ -36,14 +36,14 @@ is open to whoever wants to implement it.
3636
Write Documentation
3737
~~~~~~~~~~~~~~~~~~~
3838

39-
nagios_check_paloalto could always use more documentation, whether as part of the
40-
official nagios_check_paloalto docs, in docstrings, or even on the web in blog posts,
39+
check_paloalto_ng could always use more documentation, whether as part of the
40+
official check_paloalto_ng docs, in docstrings, or even on the web in blog posts,
4141
articles, and such.
4242

4343
Submit Feedback
4444
~~~~~~~~~~~~~~~
4545

46-
The best way to send feedback is to file an issue at https://github.com/ralph-hm/nagios_check_paloalto/issues.
46+
The best way to send feedback is to file an issue at https://github.com/TeraIT-at/check_paloalto_ng/issues.
4747

4848
If you are proposing a feature:
4949

@@ -55,17 +55,17 @@ If you are proposing a feature:
5555
Get Started!
5656
------------
5757

58-
Ready to contribute? Here's how to set up `nagios_check_paloalto` for local development.
58+
Ready to contribute? Here's how to set up `check_paloalto_ng` for local development.
5959

60-
1. Fork the `nagios_check_paloalto` repo on GitHub.
60+
1. Fork the `check_paloalto_ng` repo on GitHub.
6161
2. Clone your fork locally::
6262

63-
$ git clone [email protected]:your_name_here/nagios_check_paloalto.git
63+
$ git clone [email protected]:your_name_here/check_paloalto_ng.git
6464

6565
3. Install your local copy into a virtualenv. Assuming you have virtualenvwrapper installed, this is how you set up your fork for local development::
6666

67-
$ mkvirtualenv nagios_check_paloalto
68-
$ cd nagios_check_paloalto/
67+
$ mkvirtualenv check_paloalto_ng
68+
$ cd check_paloalto_ng
6969
$ python setup.py develop
7070

7171
4. Create a branch for local development::
@@ -104,6 +104,3 @@ Before you submit a pull request, check that it meets these guidelines:
104104
2. If the pull request adds functionality, the docs should be updated. Put
105105
your new functionality into a function with a docstring, and add the
106106
feature to the list in README.rst.
107-
3. The pull request should work for Python 2.6, 2.7, 3.3, and 3.4, and for PyPy. Check
108-
https://travis-ci.org/ralph-hm/nagios_check_paloalto/pull_requests
109-
and make sure that the tests pass for all supported Python versions.

Diff for: README.rst

+13-19
Original file line numberDiff line numberDiff line change
@@ -1,59 +1,53 @@
11
=============================================
2-
nagios_check_paloalto: a Nagios/Icinga Plugin
2+
check_paloalto_ng: a Nagios/Icinga Plugin
33
=============================================
4-
nagios_check_paloalto is a **Nagios/Icinga plugin** for Palo Alto Next Generation Firewalls.
4+
check_paloalto_ng is a **Nagios/Icinga plugin** for Palo Alto Next Generation Firewalls, that was initially developed by ralpha089 (https://github.com/ralph089/nagios_check_paloalto)
55
It is written in Python and based on the PA REST API.
66

7+
78
Tested on:
89

910
- PA-500 v6.0.1 - v6.0.9
1011
- PA-3050 v6.0.9 - 7.1.9
1112

12-
.. image:: https://travis-ci.org/ralph-hm/nagios_check_paloalto.svg?branch=master
13-
:target: https://travis-ci.org/ralph-hm/nagios_check_paloalto?branch=master
14-
15-
.. image:: https://coveralls.io/repos/github/ralph-hm/nagios_check_paloalto/badge.svg?branch=master
16-
:target: https://coveralls.io/github/ralph-hm/nagios_check_paloalto?branch=master
17-
18-
.. image:: https://badge.fury.io/py/check_paloalto.svg
19-
:target: https://badge.fury.io/py/check_paloalto
2013

2114
Documentation
2215
-------------
23-
http://nagios-check-paloalto.readthedocs.org/en/latest/
16+
https://check-paloalto-ng.readthedocs.io/en/latest/
2417

2518
Quickstart
2619
----------
2720
Please make sure you have python-dev and libxslt1-dev installed on your machine.
2821

29-
To install nagios_check_paloalto::
22+
To install check_paloalto_ng::
3023

31-
$ pip install check_paloalto --upgrade
24+
$ pip install check_paloalto_ng --upgrade
3225

3326
or use::
3427

35-
$ pip3 install check_paloalto --upgrade
28+
$ pip3 install check_paloalto_ng --upgrade
3629

3730
The plugin requires a token to get information from the PA-REST-API. Please see the following link for more information:
38-
http://nagios-check-paloalto.readthedocs.org/en/latest/configuration.html#token
31+
https://check-paloalto-ng.readthedocs.io/en/latest//configuration.html#token
3932

4033
Usage
4134
-----
4235
Command-line usage::
4336

44-
usage: check_paloalto [-h] -H HOST -T TOKEN [-v] [-t TIMEOUT] [--reset]
37+
usage: check_paloalto_ng [-h] -H HOST -T TOKEN [-v] [-t TIMEOUT] [--reset]
4538
[--version]
4639
{diskspace,certificates,load,useragent,environmental,sessinfo,thermal,throughput}
4740
...
4841

4942
positional arguments:
50-
{diskspace,certificates,load,useragent,environmental,sessinfo,thermal,throughput}
43+
{diskspace,certificates,load,useragent,environmental,powersupply,pppoe,sessinfo,thermal,throughput}
5144
diskspace check used diskspace.
52-
certificates check the certificate store for expiring certificates:
53-
Outputs is a warning, if a certificate is in range.
45+
certificates check the certificate store for expiring certificates: Outputs is a warning, if a certificate is in range.
5446
load check the CPU load.
5547
useragent check for running useragents.
5648
environmental check if an alarm is found.
49+
powersupply check present power supplies.
50+
pppoe check the pppoe interface.
5751
sessinfo check important session parameters.
5852
thermal check the temperature.
5953
throughput check the throughput.

Diff for: docs/check_pa.modules.rst

+16
Original file line numberDiff line numberDiff line change
@@ -28,6 +28,22 @@ check_pa.modules.environmental module
2828
:undoc-members:
2929
:show-inheritance:
3030

31+
check_pa.modules.powersupply module
32+
-------------------------------------
33+
34+
.. automodule:: check_pa.modules.powersupply
35+
:members:
36+
:undoc-members:
37+
:show-inheritance:
38+
39+
check_pa.modules.pppoe module
40+
-------------------------------------
41+
42+
.. automodule:: check_pa.modules.pppoe
43+
:members:
44+
:undoc-members:
45+
:show-inheritance:
46+
3147
check_pa.modules.load module
3248
----------------------------
3349

Diff for: docs/conf.py

+8-8
Original file line numberDiff line numberDiff line change
@@ -55,8 +55,8 @@
5555
master_doc = 'index'
5656

5757
# General information about the project.
58-
project = u'nagios_check_paloalto'
59-
copyright = u'2015, Ralph Offinger'
58+
project = u'check_paloalto_ng'
59+
copyright = u'2022, Christian Jonak-Möchel'
6060

6161
# The version info for the project you're documenting, acts as replacement
6262
# for |version| and |release|, also used in various other places throughout
@@ -209,8 +209,8 @@
209209
# [howto/manual]).
210210
latex_documents = [
211211
('index', 'check_paloalto.tex',
212-
u'nagios_check_paloalto Documentation',
213-
u'Ralph Offinger', 'manual'),
212+
u'check_paloalto_ng Documentation',
213+
u'Christian Jonak-Möchel', 'manual'),
214214
]
215215

216216
# The name of an image file (relative to this directory) to place at
@@ -240,8 +240,8 @@
240240
# (source start file, name, description, authors, manual section).
241241
man_pages = [
242242
('index', 'check_paloalto',
243-
u'nagios_check_paloalto Documentation',
244-
[u'Ralph Offinger'], 1)
243+
u'check_paloalto_ng Documentation',
244+
[u'Christian Jonak-Möchel'], 1)
245245
]
246246

247247
# If true, show URL addresses after external links.
@@ -255,8 +255,8 @@
255255
# dir menu entry, description, category)
256256
texinfo_documents = [
257257
('index', 'check_paloalto',
258-
u'nagios_check_paloalto Documentation',
259-
u'Ralph Offinger',
258+
u'check_paloalto_ng Documentation',
259+
u'Christian Jonak-Möchel',
260260
'check_paloalto',
261261
'Checks PaloAlto Firewall Systems',
262262
'Miscellaneous'),

Diff for: docs/index.rst

+1-1
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
Welcome to nagios_check_paloalto's documentation!
1+
Welcome to check_paloalto_ng's documentation!
22
======================================
33

44
Contents:

Diff for: docs/installation.rst

+2-2
Original file line numberDiff line numberDiff line change
@@ -4,8 +4,8 @@ Installation
44

55
Simply install check_paloalto::
66

7-
$ pip install check_paloalto
7+
$ pip install check_paloalto_ng
88

99
or use::
1010

11-
$ pip3 install check_paloalto
11+
$ pip3 install check_paloalto_ng

Diff for: docs/usage.rst

+37-3
Original file line numberDiff line numberDiff line change
@@ -10,13 +10,14 @@ Command-line usage::
1010
...
1111

1212
positional arguments:
13-
{diskspace,certificates,load,useragent,environmental,sessinfo,thermal,throughput}
13+
{diskspace,certificates,load,useragent,environmental,powersupply,pppoe,sessinfo,thermal,throughput}
1414
diskspace check used diskspace.
15-
certificates check the certificate store for expiring certificates:
16-
Outputs is a warning, if a certificate is in range.
15+
certificates check the certificate store for expiring certificates: Outputs is a warning, if a certificate is in range.
1716
load check the CPU load.
1817
useragent check for running useragents.
1918
environmental check if an alarm is found.
19+
powersupply check present power supplies.
20+
pppoe check the pppoe interface.
2021
sessinfo check important session parameters.
2122
thermal check the temperature.
2223
throughput check the throughput.
@@ -108,6 +109,39 @@ example::
108109
$ check_paloalto -H HOST -T TOKEN environmental
109110
$ ENVIRONMENTAL OK - No alarms found.
110111

112+
powersupply
113+
-------------
114+
usage::
115+
116+
usage: check_paloalto powersupply [-h] [-m MIN]
117+
118+
optional arguments:
119+
-h, --help show this help message and exit
120+
-m MIN, --min MIN Warning if functional PSU is lower than specified. (default: 1)
121+
122+
example::
123+
124+
$ check_paloalto -H HOST -T TOKEN powersupply
125+
$ POWERSUPPLY OK - 2 working power supplies. | 'Functional Power Supplies'=2;;@0 'Slot 1-Power Supply #1-Alarm'=0 'Slot 1-Power Supply #1-Inserted'=1 'Slot 1-Power Supply #2-Alarm'=0 'Slot 1-Power Supply #2-Inserted'=1
126+
127+
pppoe
128+
-------------
129+
usage::
130+
131+
usage: check_paloalto pppoe [-h] -i [INTERFACE] [--expect-down] [-m MTU]
132+
133+
optional arguments:
134+
-h, --help show this help message and exit
135+
-i [INTERFACE], --interface [INTERFACE]
136+
PA interface name
137+
--expect-down Expect PPPOE session to be down. (default: False)
138+
-m MTU, --mtu MTU Minimum expected MTU (default: 1492)
139+
140+
example::
141+
142+
$ check_paloalto -H HOST -T TOKEN pppoe -i ethernet1/1
143+
PPPOEINTERFACE OK - ethernet1/1: PPPoE is UP, PPP is UP, MTU is 1492 | 'ethernet1/1-pppoe-mtu'=1492;;1492 'ethernet1/1-pppoe-ppp-state'=1;;True 'ethernet1/1-pppoe-pppoe-state'=1;;True
144+
111145

112146
sessinfo
113147
--------

Diff for: requirements.txt

+30-11
Original file line numberDiff line numberDiff line change
@@ -1,11 +1,30 @@
1-
mock==2.0.0
2-
pytest==2.9.1
3-
tox==2.3.1
4-
python-coveralls==2.7.0
5-
pytest-cov==2.2.1
6-
nagiosplugin==1.2.4
7-
beautifulsoup4==4.4.1
8-
lxml==3.6.0
9-
requests==2.10.0
10-
responses==0.5.1
11-
wheel==0.29.0
1+
attrs==21.4.0
2+
beautifulsoup4==4.11.1
3+
certifi==2021.10.8
4+
charset-normalizer==2.0.12
5+
coverage==6.3.2
6+
distlib==0.3.4
7+
filelock==3.6.0
8+
idna==3.3
9+
iniconfig==1.1.1
10+
lxml==4.8.0
11+
mock==4.0.3
12+
nagiosplugin==1.3.3
13+
packaging==21.3
14+
platformdirs==2.5.2
15+
pluggy==1.0.0
16+
py==1.11.0
17+
pyparsing==3.0.8
18+
pytest==7.1.2
19+
pytest-cov==3.0.0
20+
python-coveralls==2.9.3
21+
PyYAML==6.0
22+
requests==2.27.1
23+
responses==0.20.0
24+
six==1.16.0
25+
soupsieve==2.3.2.post1
26+
toml==0.10.2
27+
tomli==2.0.1
28+
tox==3.25.0
29+
urllib3==1.26.9
30+
virtualenv==20.14.1

Diff for: setup.py

+9-7
Original file line numberDiff line numberDiff line change
@@ -22,14 +22,14 @@
2222
'flake8'
2323
]
2424

25-
setup(name='check_paloalto',
25+
setup(name='check_paloalto_ng',
2626
version='0.3.2',
27-
description="check_paloalto is a Nagios/Icinga plugin for Palo Alto Next Generation Firewalls. It is written in "
27+
description="check_paloalto_ng is a Nagios/Icinga plugin for Palo Alto Next Generation Firewalls. It is written in "
2828
"Python and based on the PA REST API.",
2929
long_description=readme + '\n\n' + history,
30-
author="Ralph Offinger",
31-
author_email='[email protected]',
32-
url='https://github.com/ralph-hm/nagios_check_paloalto',
30+
author="Christian Jonak-Möchel",
31+
author_email='[email protected]',
32+
url='https://github.com/TeraIT-at/check_paloalto_ng',
3333
install_requires=requirements,
3434
packages=['check_pa', 'check_pa.modules'],
3535
entry_points={
@@ -44,12 +44,14 @@
4444
'Intended Audience :: System Administrators',
4545
'Topic :: System :: Monitoring',
4646
'License :: OSI Approved :: Common Public License',
47-
'Programming Language :: Python :: 2',
48-
'Programming Language :: Python :: 2.7',
4947
'Programming Language :: Python :: 3',
5048
'Programming Language :: Python :: 3.3',
5149
'Programming Language :: Python :: 3.4',
5250
'Programming Language :: Python :: 3.5',
51+
'Programming Language :: Python :: 3.6',
52+
'Programming Language :: Python :: 3.7',
53+
'Programming Language :: Python :: 3.8',
54+
'Programming Language :: Python :: 3.9',
5355
],
5456
keywords='paloalto icinga nagios check',
5557
zip_safe=False,

Diff for: tox.ini

+1-1
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
[tox]
2-
envlist = py27, py33, py34, py35
2+
envlist = py33, py34, py35, py36, py37, py38, py39
33
toxworkdir={homedir}
44

55
[testenv]

0 commit comments

Comments
 (0)