Files
marqdo/examples/web-net-site/index.mq.md
T
cflmyandCursor 7645dd4c1f Extend network stack: session/auth, WebSocket, cookie/multipart primitives
Add the network-extension wave to lib/net and the web ABI plugin:
- lib/net cookie_parse / multipart_parse host primitives (EN/ZH)
- plugins/web session store + /admin login gate + WebSocket client/server
- ext/web author surface (EN/ZH) for session, auth, ws
- form update flow and page-level validation echo tests
- fix string escapes: \xHH, \u{...}, unknown escapes kept verbatim
- map Chinese component slots (导航/侧栏/页脚) so sidebar renders
- resolve relative static/db paths against the entry script dir (entry_dir)
- new tutorial chapter 14, EN/ZH example sites, and gold tests

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-08-25 14:58:46 +08:00

4.4 KiB


title: web-net-site description: Home + /about + /new (form) + /tools (net lib) + /admin (auth) + /live (WebSocket). import web:ext/web/web.mq.md import net:lib/net.mq.md import text:lib/text.mq.md import shell:styles/shell.mq.md import nav:components/nav.mq.md import side:components/side.mq.md import foot:components/foot.mq.md import articles:db/articles.mq.md import db:db/index.mq.md

main

home =

组件 样式
nav.nav shell.topnav
side.side shell.side_panel
foot.foot

index =

属性 值 样式
title articles.articles.title shell.card_title
body articles.articles.body shell.card_body

Home intro also embeds the live WebSocket widget (HTML is served raw).

store = > db.open page = > web.page title="Marqdo Net Site" intro="

Net Site

Articles from SQLite, a live WebSocket widget, login-gated admin, and net-library parsing tools.

<h2 id="live">Live WebSocket<p id="live-status">connecting…

<input id="live-msg" placeholder="type a message…"><button id="live-send" disabled>send<div id="live-out"><script src="/static/live.js"></script>"
page = > page.compose_components components=home page = > page.compose_main main=index

About page: same shell.

about = > web.page title="About" intro="

About

Demonstrates the network-extended web library: sessions, auth, WebSocket, multipart/cookie parsing.

" about = > about.compose_components components=home

Parse a Cookie request header with the standard library.

parsed_req = > net.cookie_parse text="session=abc123; theme=dark" req_cookie = parsed_req[^1]

Parse a Set-Cookie response header.

parsed_resp = > net.cookie_parse text="id=42; Path=/; HttpOnly; SameSite=Lax" is_response=True resp_cookie = parsed_resp[^1]

Parse a multipart/form-data body.

_b = net-boundary

_body = "--_b\nContent-Disposition: form-data; name="title"\n\nHello\n--_b\nContent-Disposition: form-data; name="cover"; filename="pic.png"\nContent-Type: image/png\n\n\n--_b--\n"

mp = > net.multipart_parse body=_body boundary=_b mp_title = mp[^1] mp_cover = mp[^2]

Build the tools page as one HTML intro (intro is served raw).

tools_parts =

段

Net tools

Parsing demos powered by lib/net: cookie_parse and multipart_parse.

req_cookie[^name]=req_cookie[^value]

resp_cookie[^name]=resp_cookie[^value] · HttpOnly=resp_cookie[^http_only]

Multipart field

mp_title[^name]=mp_title[^value]

Multipart file

mp_cover[^name] · mp_cover[^filename] · mp_cover[^content_type]

tools_intro = > text.str_join xs=tools_parts sep="" tools = > web.page title="Tools" intro=tools_intro tools = > tools.compose_components components=home

Article create form: field table + rules table.

article_fields =

字段 标签 类型 必填 默认
title Title text true
body Body textarea false

article_rules =

字段 规则 消息
title required Title is required
title max:120 Title is too long
body max:8000 Body is too long

article_form = > web.form table="articles" action="insert" article_form = > article_form.fields fields=article_fields article_form = > article_form.rules rules=article_rules

New article page: form embedded in the main slot.

new = > web.page title="Publish" intro="

Publish

Form inserts into articles.

" new = > new.compose_components components=home new = > new.compose_form id="article" form=article_form

Admin users table (english + chinese column headers both work).

admins =

行 username password
1 admin secret

app = > web.app page=page db=store admin=True host="127.0.0.1" port=18083 app = > app.route path="/about" page=about app = > app.route path="/new" page=new app = > app.route path="/tools" page=tools app = > app.static dir="public" mount="/static" app = > app.route_ws path="/live" echo=True app = > app.auth users=admins session_ttl=3600

app.listen