This repo originated as a fork of python-libnmap after several months of unresponsiveness regarding fixing an XML parsing vulnerability. It has been simplified to focus purely on parsing nmap results and doing diffs on pairs of scans. The backend functionality has been removed, as has the nmap process management functionality. By removing this extraneous functionality, we can focus on making the parsing functionality the best at what it does without worrying about updating support for various backends.
libnmap is a python library enabling python developers to manipulate nmap data.
libnmap is what you were looking for if you need to implement the following:
- manipulate nmap scans results to do reporting
- compare and diff nmap scans to generate graphs
- batch process scan reports
The above uses cases will be easy to implement with the help of the libnmap modules.
The lib currently offers the following modules:
- parse: enables you to parse nmap XML reports from a file, a string,...
- report: enables you to manipulate a parsed scan result and de/serialize scan results in a json format
- diff: enables you to see what changed between two scans
- common: contains basic nmap objects like NmapHost and NmapService. It is to note that each object can be "diff()ed" with another similar object.
All the documentation is available on read the docs. This documentation contains small code samples that you directly reuse.
libnmap dependencies are captured in Pipfile.
The old version of libnmap supported many versions of python going back to 2.7. Since python 2.7 is no longer supported, this library will only support Python >= 3.6.
- Python 3.6
- Python 3.7
- Python 3.8
pipenv install natlas-libnmapor via git:
git clone https://github.com/natlas/natlas-libnmap.git
cd natlas-libnmap
python setup.py installSome codes samples are available in the examples directory or in the documentation.
Ronald "savon-noir" Bister for the original work on python-libnmap.
