docs: clarify Claro v1 status and validation
This commit is contained in:
@@ -0,0 +1,54 @@
|
||||
# Claro Web Server Plan
|
||||
|
||||
Current release: **Claro v1.18.26**
|
||||
|
||||
Claro currently has beginner HTTP client commands and offline `claro://` test URLs. A web server API is not complete yet.
|
||||
|
||||
## Ready now
|
||||
|
||||
- `HTTP CHECK`
|
||||
- `HTTP GET`
|
||||
- `HTTP SAVE`
|
||||
- offline `claro://hello` and related lesson/test URLs
|
||||
- `LASTHTTP`
|
||||
- real `http://` and `https://` requests through `curl` when available
|
||||
|
||||
## Web server goals
|
||||
|
||||
A beginner web server should make tiny local apps possible without exposing learners to unsafe network defaults.
|
||||
|
||||
Desired properties:
|
||||
- localhost-only by default
|
||||
- readable route syntax
|
||||
- simple request/response values
|
||||
- friendly port-in-use errors
|
||||
- easy stop behavior
|
||||
- examples that work offline
|
||||
|
||||
## Possible future syntax sketch
|
||||
|
||||
```claro
|
||||
WEB START LOCAL PORT 8080
|
||||
|
||||
WHEN GET "/"
|
||||
WEB SAY "Hello from Claro"
|
||||
END
|
||||
|
||||
WEB WAIT
|
||||
```
|
||||
|
||||
This is a sketch, not a committed syntax.
|
||||
|
||||
## Needed before implementation
|
||||
|
||||
- route syntax decision
|
||||
- request value model
|
||||
- response helpers
|
||||
- safe defaults for host/port
|
||||
- tests for port conflicts and malformed requests
|
||||
- docs explaining localhost vs public internet
|
||||
|
||||
See also:
|
||||
- `V1_17_NETWORKING.md`
|
||||
- `CURRENT_STATUS.md`
|
||||
- `ROADMAP.md`
|
||||
Reference in New Issue
Block a user