Merge pull request #6 from troublegum/dev

Release 1.3

Author: troublegum

README.md

@@ -11,12 +11,31 @@ Use Thonny IDE or other IDE for upload your code in ESP8266/ESP32 board.
 
 ## Quick start
 
+### Typical Wi-Fi connection code for ESP board
+```
+import network
+
+wlan_id = "your wi-fi"
+wlan_pass = "your password"
+
+wlan = network.WLAN(network.STA_IF)
+wlan.active(True)
+
+while not wlan.isconnected():
+    wlan.connect(wlan_id, wlan_pass)
+print("Connected... IP: " + wlan.ifconfig()[0])  
+```
+
 
 ### Hello world example
 
+Type in browser http://IP_ADDRESS_ESP/ and you will see "HELLO WORLD" text.
+
 ```
 from micropyserver import MicroPyServer
 
+''' there should be a wi-fi connection code here '''
+
 def hello_world(request):
     ''' request handler '''
     server.send("HELLO WORLD!")
@@ -29,9 +48,14 @@ server.start()
 ```
 
 ### Add some routes
+
+Type in browser http://IP_ADDRESS_ESP/ or http://IP_ADDRESS_ESP/another_action and your will see text "THIS IS INDEX PAGE!" or "THIS IS ANOTHER ACTION!".
+
 ```
 from micropyserver import MicroPyServer
 
+''' there should be a wi-fi connection code here '''
+
 def show_index(request):
     ''' main request handler '''
     server.send("THIS IS INDEX PAGE!")
@@ -50,10 +74,14 @@ server.start()
 
 ### Send JSON response example
 
+Type in browser http://IP_ADDRESS_ESP/ and you will see JSON response.
+
 ```
 from micropyserver import MicroPyServer
 import json
 
+''' there should be a wi-fi connection code here '''
+
 def return_json(request):
     ''' request handler '''
     json_str = json.dumps({"param_one": 1, "param_two": 2})
@@ -69,17 +97,22 @@ server.start()
 ```
 
 ### Access denied example
+
+Type in browser http://IP_ADDRESS_ESP/ and you will see "THIS IS INDEX PAGE!" text or "ACCESS DENIED!" if your IP not equal "127.0.0.1".
+
 ```
 from micropyserver import MicroPyServer
 
+''' there should be a wi-fi connection code here '''
+
 def show_index(request):
     ''' main request handler '''
     server.send("THIS IS INDEX PAGE!")
     
 def on_request_handler(request, address):
-    if str(address[0]) != '127.0.0.1':
+    if str(address[0]) != "127.0.0.1":
         server.send("HTTP/1.0 403\r\n\r\n")
-        server.send('ACCESS DENIED!')
+        server.send("ACCESS DENIED!")
         return False        
     return True
 
@@ -95,7 +128,7 @@ server.start()
 
 ### Turn ON / OFF a LED example
 
-You can remote control a LED via internet.
+You can remote control a LED via internet. Use your browser for on/off LED. Type in browser http://IP_ADDRESS_ESP/on or http://IP_ADDRESS_ESP/off.
 
 ![schema](https://habrastorage.org/webt/jb/xu/aj/jbxuaj0nr8fnqllbq27p_vfx3bw.png)
 
@@ -150,6 +183,8 @@ server.start()
 from micropyserver import MicroPyServer
 import utils
 
+''' there should be a wi-fi connection code here '''
+
 def hello_world(request):
     ''' request handler '''
     utils.send_response(server, "HELLO WORLD!")
@@ -188,3 +223,5 @@ Set handler on server error - server.on_error(handler)
 ## Utils methods
 
 Send response to client - utils.send_response(server, response, http_code=200, content_type="text/html", extend_headers=None)
+
+Get HTTP request method - utils.get_request_method(request)

utils.py

@@ -26,6 +26,8 @@
 THE SOFTWARE.
 """
 
+import re
+
 """ HTTP response codes """
 HTTP_CODES = {
     100: 'Continue',
@@ -98,3 +100,9 @@ def send_response(server, response, http_code=200, content_type="text/html", ext
             server.send(header + "\r\n")
     server.send("\r\n")
     server.send(response)
+
+
+def get_request_method(request):
+    """ return http request method """
+    lines = request.split("\r\n")
+    return re.search("^([A-Z]+)", lines[0]).group(1)