Metadata-Version: 1.0
Name: dhclientlist
Version: 0.0.4
Summary: DHClientList is a tool to get the current client list of a DHCP server. With it one can check who is connected to the local network. To do this one must provide the DHCP server address (IP in local network and port), username and password. The resulting list items contains the host name, MAC address, IP and lease time.
Home-page: https://github.com/leonardosantos/dhclientlist
Author: Leonardo Santos
Author-email: lsantos@inoa.com.br
License: LICENSE.txt
Description: DHClientList
        ============
        
        DHClientList is a tool to get the current client list of a DHCP server. With it one can check who is connected to the local network. To do this one must provide the DHCP server address (IP in local network and port), username and password. The resulting list items contains the host name, MAC address, IP and lease time.
        
        ## Installation ##
        	pip install dhclientlist
        
        **Note:** The pyOpenSSL==0.13 library is required to enable the HTTPS server mode.
        
        ## Usage ##
        
        ### Command-line: ###
        
            usage: dhclientlist print [-h] [-d DRIVERNAME] [-a ADDRESS] [-u USERNAME]
                                      [-p PASSWORD] [-f {json,texttable}]
        
            optional arguments:
              -h, --help            show this help message and exit
              -d DRIVERNAME, --driver DRIVERNAME
                                    specify a driver to be used
              -a ADDRESS, --address ADDRESS
                                    local dhcp server's address. (default: 192.168.0.1:80)
              -u USERNAME, --username USERNAME
                                    local dhcp server's username. (default: admin)
              -p PASSWORD, --password PASSWORD
                                    local dhcp server's password.
              -f {json,texttable}, --format {json,texttable}
                                    the format of the output list. (default: texttable)
        
        ### HTTP(S) Server: ###
        	
        	usage: dhclientlist serve [-h] [-d DRIVERNAME] [-a ADDRESS] [-u USERNAME]
        	                          [-p PASSWORD] [--http-username HTTP_USERNAME]
        	                          [--http-password HTTP_PASSWORD] [-i] [--debug]
        	                          port
        	
        	positional arguments:
        	  port                  port that the dhclientlist HTTP(S) server will bind
        	
        	optional arguments:
        	  -h, --help            show this help message and exit
        	  -d DRIVERNAME, --driver DRIVERNAME
        	                        specify a driver to be used
        	  -a ADDRESS, --address ADDRESS
        	                        local dhcp server's address. (default: 192.168.0.1:80)
        	  -u USERNAME, --username USERNAME
        	                        local dhcp server's username. (default: admin)
        	  -p PASSWORD, --password PASSWORD
        	                        local dhcp server's password.
        	  --http-username HTTP_USERNAME
        	                        dhclientlist server username.
        	  --http-password HTTP_PASSWORD
        	                        dhclientlist server password.
        	  -i, --insecure        use HTTP instead of HTTPS
        	  --debug               runs the server in debug mode
        
        ### Python lib: ###
        
        	import dhclientlist
        	dhclientlist.get(address, username, password)  # optionally the 4th parameter: driver
        
        ## Drivers ##
        	 
        The connection with DHCP server is made by a _driver_, a python module inside the **dhclientlist.drivers** package (or in any of its sub-packages) that has a get(address, username, password) function which return a list of dicts; each dict containing the following key-value pairs:
        	
        	("name", name_str),    # name of the guest connected to the dhcp server
        	("mac", mac_str),      # MAC address of the guest connected to the dhcp server
        	("ip", ip_str),        # IP address of the guest connected to the dhcp server
        	("lease", lease_str)   # time in the format hh:mm:ss until this registry is updated in the dhcp server
        
        The **dhclientlist.util.find_driver** function will try to find the appropriate driver for the local DHCP server. However, the number of drivers is quite small at the moment, and dhclientlist may not succeed with the local DHCP server. In this case, one is welcome to contribute by forking this project and developing a driver to the local DHCP server.
        
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Topic :: Utilities
Classifier: License :: OSI Approved :: BSD License
