Metadata-Version: 2.1
Name: ssdp-upnp
Version: 0.0.1
Summary: ssdp server and client of upnp
Home-page: https://github.com/tw7613781/ssdp_upnp
Author: tw7613781
Author-email: tw7613781@gmail.com
License: UNKNOWN
Description: # ssdp_upnp
        
        ## Introduction   
        The acticle [Exploring UPnP with Python](https://www.electricmonk.nl/log/2016/07/05/exploring-upnp-with-python/) gives a realy good insight of UPNP. SSDP is one of it's implementation.
        
        The packege includes two individual Classes, one is ssdp server, one is ssdp client. They inherits from Class threading.Thread class, thus the two class instance runs on a single thread of own. They will not block main thread. After the ssdp client find a peer with same product name, it can communicate with main thread by **queue**. 
        
        The logic of server is just listen a broadcast address with port 1900. If it received a "M-SEARCH" message, it will responce it's service infomation. The client just send a broadcast message with "M-SEARCH", and get server's service infomation.
        
        The package can be used in blockchain solution where peers to find each other in LAN environment. 
        
        ## example
        
            import sys
            from ssdp_upnp.ssdp import Server, Client
            from ssdp_upnp.ssdp import gen_logger
            from queue import Queue
        
            logger = gen_logger('sample')
        
            if __name__ == '__main__':
                try:
                    if sys.argv[1] == 'server':
                        upnpServer  = Server(8048, 'blockchain', 'main')
                        upnpServer.start()
                    elif sys.argv[1] == 'client':
                        queue = Queue()
                        upnpClient = Client('blockchain', 'main', queue)
                        upnpClient.start()
                        logger.info(queue.get())
                    else:
                        logger.warning('need params server or clinet')
                except Exception as e:
                    logger.error(e)
        
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Description-Content-Type: text/markdown
