'.format(str(request.cookies))
113 | response.set_cookie('cookie_name', 'cookie_value')
114 | return response, 404
115 |
116 | # 获取 JSON 格式的内容
117 | @ew.route('/json')
118 | def cookie2(request):
119 | # 访问网页的 /json
120 | return {'type': 'json', 'num': 123}
121 |
122 | ew.run()
123 | print('======END======') # 访问 /stop
124 | ```
--------------------------------------------------------------------------------
/web/wifi.html:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 |
5 |
6 |
7 | 配置页面
8 |
70 |
71 |
72 |
73 |
128 |
129 |
130 |
--------------------------------------------------------------------------------
/README.md:
--------------------------------------------------------------------------------
1 | [简体中文 (Chinese)](./README.ZH-CN.md)
2 | # micropython-easyweb
3 |
4 | 
5 | - A simple and versatile web server library for `Micropython`, easy to use.
6 |
7 | ### Features
8 | - Aims to mimic the style of the Flask framework as much as possible
9 | - Integrates common functionalities such as GET request parameter parsing, form parsing, HTML rendering, file sending, cookie setting, cookie retrieval, dynamic routing, and more.
10 |
11 | ### Instructions
12 | - There are three versions of the project files, please choose the one that suits your needs:
13 | - `thread`: `/lib/easyweb_thread.py` - implemented with multithreading
14 | - `asyncio`: `/lib/easyweb.py` - implemented with asynchronous support, provides better compatibility and reliability
15 | - `single`: `/lib/easyweb_single.py` - implemented with a single thread loop, provides good compatibility
16 |
17 | ### Compatibility
18 | #### Tested Devices
19 | - `ESP-01S`: `single`
20 | - `ESP32`: `single`, `thread`, `asyncio`
21 | - `ESP32-C3`: `single`, `thread`, `asyncio`
22 | - `ESP32-S3`: `single`, `thread`, `asyncio`
23 |
24 | ### Sample Code
25 | - Here we use [micropython-easynetwork](https://github.com/funnygeeker/micropython-easynetwork) as an example to connect to the local network (it can also work in AP mode, allowing other devices to connect to the development board).
26 | ```python
27 | import time
28 | from lib.easynetwork import Client
29 | from lib.easyweb import EasyWeb, render_template, send_file, make_response
30 |
31 | client = Client()
32 | client.connect("ssid", "password") # or client.connect("ssid", "")
33 |
34 | while not client.isconnected():
35 | pass
36 | print('IP Address: {}'.format(client.ifconfig()[0]))
37 |
38 | ew = EasyWeb() # Initialize EasyWeb
39 |
40 | # Add routes
41 | @ew.route('/')
42 | def home(request):
43 | print("=======[request]=======")
44 | print('URL: ', request.url)
45 | print('Args: ', request.args)
46 | print('Form: ', request.form)
47 | print('Host: ', request.host)
48 | print('Json: ', request.json)
49 | print('Path: ', request.path)
50 | print('Header: ', request.headers)
51 | print('Cookies: ', request.cookies)
52 | print('Full_Path: ', request.full_path)
53 | return render_template("/web/wifi.html")
54 |
55 | # Send file
56 | @ew.route('/easyweb.png')
57 | def img(request):
58 | # Try accessing /easyweb.png on the website
59 | return send_file("/web/EasyWeb_256px.png")
60 |
61 | # Download file
62 | @ew.route('/download')
63 | def download(request):
64 | # Try accessing /easyweb.png on the website
65 | # as_attachment: Whether to send the file as an attachment, it will be downloaded when sent as an attachment
66 | # attachment_filename: The filename displayed to the user when downloading. If not provided, the original filename will be used
67 | return send_file("/web/EasyWeb_256px.png", as_attachment=True, attachment_filename='easyweb.png')
68 |
69 | # Stop EasyWeb
70 | @ew.route('/stop')
71 | def stop(request):
72 | ew.stop()
73 |
74 | # Get string
75 | @ew.route('/user/')
76 | def user(request):
77 | # Try accessing /user/123456 on the website
78 | return "
Hello {}
".format(request.match)
79 |
80 | # Get path
81 | @ew.route('/path/')
82 | def path(request):
83 | # Try accessing /path/123/456 on the website
84 | return "
Path {}
".format(request.match)
85 |
86 | # Render HTML
87 | @ew.route('/time')
88 | def the_time(request):
89 | # Access /time on the website and refresh the page a few times to observe the changes on the webpage
90 | return render_template("/web/time.html", time=time.time())
91 |
92 | # Get and set Cookies
93 | @ew.route('/cookie')
94 | def cookie(request):
95 | # Access /cookie on the website and refresh the page a few times to observe the changes on the webpage
96 | response = make_response('
Cookies: {}
'.format(str(request.cookies)))
97 | response.set_cookie('cookie_name', 'cookie_value')
98 | return response
99 |
100 | # Custom status code
101 | @ew.route('/404')
102 | def status_code(request):
103 | # Access /404 on the website, open the developer tools to observe the status code
104 | return '
404 Not Found
', 404
105 |
106 | # Get and set Cookies, while customizing the status code
107 | @ew.route('/cookie2')
108 | def cookie2(request):
109 | # Access /cookie on the website and refresh the page a few times to observe the changes on the webpage
110 | response = make_response() # You can also assign a value to response.data later instead of initializing it during initialization
111 | response.data = '