Metadata-Version: 2.1
Name: natlas-libnmap
Version: 0.7.1
Summary: Python NMAP library enabling you to start async nmap tasks, parse and compare/diff scan results
Home-page: http://pypi.python.org/pypi/natlas-libnmap/
Author: 0xdade
Author-email: dade@actualcrimes.org
License: Creative Common "Attribution" license (CC-BY) v3
Description: # natlas-libnmap
        
        ## Code status
        
        [![Maintainability](https://api.codeclimate.com/v1/badges/9f7ca0cbe454b240f660/maintainability)](https://codeclimate.com/github/natlas/natlas-libnmap/maintainability)
        [![Release](https://img.shields.io/github/release/natlas/natlas-libnmap.svg)](https://github.com/natlas/natlas-libnmap/releases/latest)
        ![Last Commit](https://img.shields.io/github/last-commit/natlas/natlas-libnmap.svg)
        ![Total Downloads](https://img.shields.io/github/downloads/natlas/natlas-libnmap/total.svg)
        ![Code Size](https://img.shields.io/github/languages/code-size/natlas/natlas-libnmap.svg)
        [![Contributors](https://img.shields.io/github/contributors/natlas/natlas-libnmap.svg)](https://github.com/natlas/natlas-libnmap/graphs/contributors)
        
        ## 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](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:
        
        ```bash
        pip install git+https://github.com/natlas/natlas-libnmap
        ```
        
        or via git:
        
        ```bash
        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.
        
        [savon-noir]: https://github.com/savon-noir
        [python-libnmap]: https://github.com/savon-noir/python-libnmap
        [read the docs]: https://libnmap.readthedocs.org
        [documentation]: https://libnmap.readthedocs.org
        
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Console
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.6
Classifier: Topic :: System :: Networking
Description-Content-Type: text/markdown
