This code is licensed under Creative Common "Attribution" license (CC-BY: http://creativecommons.org/licenses/by/3.0/).

You are free to:

- Share: to copy, distribute and transmit the work

- Remix: to adapt the work

- and make commercial use of the work

Under the following conditions:

- Attribution: You must attribute the work in the manner specified by the author or licensor (but not in any way that suggests that they endorse you or your use of the work).

With the understanding that:

Waiver: Any of the above conditions can be waived if you get permission from the copyright holder.

Public Domain: Where the work or any of its elements is in the public domain under applicable law, that status is in no way affected by the license.

Other Rights: In no way are any of the following rights affected by the license:

Your fair dealing or fair use rights, or other applicable copyright exceptions and limitations;

The author's moral rights;

Rights other persons may have either in the work itself or in how the work is used, such as publicity or privacy rights.

The full text is available here: http://creativecommons.org/licenses/by/3.0/legalcode

include *.txt

recursive-include docs *.txt

===========

PY-NMAP

===========

Py-Nmap is a set of librairies that enables you to easily:

* launch Nmap scans

* control event with a callback function

* parse the results of scans

* make use of the results

* import/export scans results from XML files or created via the lib

* make scan report diffs

Code sample:

#!/usr/bin/env python

import sys

from libnmap import NmapProcess

from libnmap import NmapParser, NmapHost

def main(argv):

def mycallback(nmapscan=None, data=""):

if nmapscan.is_running():

print "Progress: %s %% - ETC: %s" % (nmapscan.progress, nmapscan.etc)

nm = NmapProcess("localhost", options="-sT", event_callback=mycallback)

rc = nm.run()

if rc == 0:

print "Scan started {0} {1}".format(nm.starttime, nm.nmap_version)

print "Scan ended {0}: {1}".format(nm.endtime, nm.summary)

np = NmapParser(nm.stdout)

np.parse()

for h in np.get_hosts():

plist = h.get_ports()

for pno in plist:

p = h.get_port(pno)

print "Port: {0}/{1}: {2} ({3})".format(p['port'],

p['protocol'], p['state'], p['name'])

else:

print "Error: {stderr}".format(stderr=nm.stderr)

print "Result: {0}".format(nm.stdout)

if __name__ == '__main__':

main(sys.argv[1:])

__author__ = 'Ronald Bister (mini.pelle@gmail.com'

__version__ = '0.1'

from nmapprocess import *

from nmapparser import *