Python NMAP library enabling you to start async nmap tasks, parse and compare/diff scan results
Project description
natlas-libnmap
Code status
Summary
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.
Use cases
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.
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.
Documentation
All the documentation is available on read the docs. This documentation contains small code samples that you directly reuse.
Dependencies
libnmap dependencies are captured in Pipfile.
Python Support
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
Install
This version of libnmap has not been packaged for distribution on pypi as of yet. In the meantime, you can install it with pip directly from the git repo like so:
pip install git+https://github.com/natlas/natlas-libnmap
or via git:
git clone https://github.com/natlas/natlas-libnmap.git
cd natlas-libnmap
python setup.py install
Examples
Some codes samples are available in the examples directory or in the documentation.
Contributors
Ronald "savon-noir" Bister for the original work on python-libnmap.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file natlas-libnmap-0.7.1.tar.gz
.
File metadata
- Download URL: natlas-libnmap-0.7.1.tar.gz
- Upload date:
- Size: 27.7 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/3.2.0 pkginfo/1.5.0.1 requests/2.24.0 setuptools/47.3.1 requests-toolbelt/0.9.1 tqdm/4.47.0 CPython/3.8.3
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 30099b8d8556b64df8ffeaa66b8f79103422297264e6a3c05acafbe92e31fb00 |
|
MD5 | 33c59def05582c0dffd4715d54afb13b |
|
BLAKE2b-256 | 9181a4a29f07d0aeb3ef5aeb1bcbd8e3b7aa9cacdc19ddd8d0abec86ca8ffe29 |
File details
Details for the file natlas_libnmap-0.7.1-py3-none-any.whl
.
File metadata
- Download URL: natlas_libnmap-0.7.1-py3-none-any.whl
- Upload date:
- Size: 23.2 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/3.2.0 pkginfo/1.5.0.1 requests/2.24.0 setuptools/47.3.1 requests-toolbelt/0.9.1 tqdm/4.47.0 CPython/3.8.3
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 52195fa1bf56e7b23d5c5a9a1164d5b1e58a9be6dc980cdfc37aefb8c6d1fdd6 |
|
MD5 | 2ba75a134f969e9bdfbb8396681968f1 |
|
BLAKE2b-256 | 527aabb795793b8a99b78b4fd14647072ecf7ba874f7786768aedc818d84853e |