Metadata-Version: 1.0
Name: userv
Version: 0.4.2
Summary: Minimalistic core for webserver on microcontroler
Home-page: https://github.com/SvenMatzke/userv
Author: SvenMatzke
Author-email: matzke.sven@googlemail.com
License: MIT
Description: The catch
        =========
        The first start for every webserver is routing and parsing html.
        This is the core.
        
        
        Routing
        =======
        Router objects are simple and are input to the server instances.
        Example:
        ::
        
            from userv.routing import Router, text_response
        
            router = Router()
        
            def test(request):
                return text_response("some text")
        
            router.add("/resturl", test, method="GET")
        
        you can get function test again with:
        ::
        
            router.get('/resturl', method="GET")
        
        
        for creating swagger and so on there is a also a list command:
        ::
        
            router.list()
        
        With these object all server are instances and we have full control even without
        an server instance.
        
        Response types
        ==============
        There are a few build in response types text, json, serving static files although has to be
        determined by async or normal file pointer usage. There fore these are
        in the appropriate packages.
        
        The general gist of the response functions is to create a generator
        which will be used to consumed by your server.
        
        if you want to have full control about your memory flow or need to write a few
        memory hungry responses feel free to write an response yourself.
        
        Little hint make sure to use the response_header function and end the response with
        an "\\r\\n".
        
        
        Serve static files
        ==================
        It is pretty simple just add the address with the file you want to serve.
        
        Example:
        ::
        
            from userv.routing import static_file
        
            router.add("/index", static_file('boot.py'))
        
        Although the example should never expose your code. It is a prety simple and fast test.
        
        
        Further packages & webserver
        ============================
        Atm there is an implementation for an socketserver which runs even on on esp8266::
        
            pip install userv.socket_server
        
        And an async server with an exchangable interface.::
        
            pip install userv.async_server
        
        
        
Platform: UNKNOWN
