examples/symmetry
43 file(s) under examples/symmetry
build.sst
sleela build.sst
README.md
markdown README.md
Channel.sleela
sleela src/core/Channel.sleela
Message.sleela
sleela src/core/Message.sleela
Symmetry.sleela
sleela src/core/Symmetry.sleela
dns_admin_monitor.c
c src/dns/admin/dns_admin_monitor.c
DnsAdminMonitor.java
java src/dns/admin/DnsAdminMonitor.java
System.sleela
sleela src/dns/admin/System.sleela
dns_client.c
c src/dns/client/dns_client.c
DnsClient.java
java src/dns/client/DnsClient.java
System.sleela
sleela src/dns/client/System.sleela
README.md
markdown src/dns/README.md
dns_server.c
c src/dns/server/dns_server.c
dns_server.h
c src/dns/server/dns_server.h
DnsServer.java
java src/dns/server/DnsServer.java
System.sleela
sleela src/dns/server/System.sleela
email_admin_monitor.c
c src/email/admin/email_admin_monitor.c
EmailAdminMonitor.java
java src/email/admin/EmailAdminMonitor.java
System.sleela
sleela src/email/admin/System.sleela
email_client.c
c src/email/client/email_client.c
EmailClient.java
java src/email/client/EmailClient.java
System.sleela
sleela src/email/client/System.sleela
README.md
markdown src/email/README.md
email_server.c
c src/email/server/email_server.c
EmailServer.java
java src/email/server/EmailServer.java
System.sleela
sleela src/email/server/System.sleela
FtpClient.sleela
sleela src/ftp/FtpClient.sleela
FtpServer.sleela
sleela src/ftp/FtpServer.sleela
Session.sleela
sleela src/ftp/Session.sleela
HttpClient.sleela
sleela src/http/HttpClient.sleela
HttpServer.sleela
sleela src/http/HttpServer.sleela
Router.sleela
sleela src/http/Router.sleela
proxy_admin_monitor.c
c src/proxy/admin/proxy_admin_monitor.c
ProxyAdminMonitor.java
java src/proxy/admin/ProxyAdminMonitor.java
System.sleela
sleela src/proxy/admin/System.sleela
proxy_client.c
c src/proxy/client/proxy_client.c
ProxyClient.java
java src/proxy/client/ProxyClient.java
System.sleela
sleela src/proxy/client/System.sleela
README.md
markdown src/proxy/README.md
proxy_server.c
c src/proxy/server/proxy_server.c
ProxyServer.java
java src/proxy/server/ProxyServer.java
System.sleela
sleela src/proxy/server/System.sleela
System.sleela
sleela src/System.sleela
About this collection
<img align="right" src="https://github.com/mearvk/SLeeLa/blob/master/images/debian/debian-logo.png" width="75" height="75" alt="SLeeLa">
<img src="https://github.com/mearvk/SLeeLa/blob/master/images/sleela/sleela-logo-004.jpg" alt="SLeeLa">
system-symmetry — Sleela sources driven by a .sst style sheet
This module demonstrates server/client system symmetry across two protocols
(HTTP and FTP) over one protocol-neutral core, written in Sleela and
driven entirely by a Nordshrift .sst style sheet (build.sst).
The .sst sheet is the control surface: it names the sources (source: glob
**/*.sleela), selects the target (target-language sleela — runs on the C
core), sequences the passes (pipeline:), and states the analysis posture
(rules:/effects:/derive:/guards:/interop:). The .sleela files —
Wrapper™ files (the .sleela file type: Sleela source carrying the
metadocument addend) — are the program. Flip target-language to java or
c to retarget the same sources.
Run it
cd impl && make # builds build/sleela and build/nordshrift
export SLEELA_SHEET=$PWD/../SHEET.sheet # binds the SHEET.sheet catalog
# run from the repo root against this top-level examples/ copy:
./impl/build/nordshrift check examples/symmetry/build.sst # validate the sheet
./impl/build/nordshrift build examples/symmetry/build.sst # transpile + run all sources
A mirror of this module also lives under
impl/nordshrift/examples/symmetry/(wired into themake testtargets). Both copies are identical.
build transpiles every source the sheet names and, because the target is
sleela, runs each on the Sleela core.
The sources (10 files)
| File | Symmetry it demonstrates | Catalogued objects (conducted methods) |
|---|---|---|
System.sleela | Roll-up: HTTP + FTP server rule == client mirror (8/8 agree) | System, Service, Protocol |
core/Symmetry.sleela | Mirror + round-trip laws (mirror(mirror(x))==x) | Service, Channel |
core/Channel.sleela | The shared medium: a spawned writer's frames are read back in order (mailbox send/recv) | Channel, Pipe, Stream |
core/Message.sleela | Request/Response framing: sender frame size == receiver frame size | Message, Request, Response |
http/HttpServer.sleela | Server maps (method, path) → status | Service, Router, Session |
http/HttpClient.sleela | Client mirrors the server's status table; 2xx success class | Gateway, Retry |
http/Router.sleela | Bijective dispatch: toPath(toHandler(p)) == p (3/3) | Router, Middleware, Pipeline |
ftp/FtpServer.sleela | Server maps command → reply code | Service, Connector |
ftp/FtpClient.sleela | Client mirrors reply codes; proceed vs abort | Gateway, Session |
ftp/Session.sleela | Balanced lifecycle: opens and closes must net to depth 0 | Session, StateMachine, Watchdog |
How the style sheet drives the build
source:— one glob (**/*.sleela) enumerates all ten files undersrc/; the sheet'sexcludepatterns keep stubs/legacy out.target:—target-language sleelasends the transpiled output to the C core for execution; change it tojava/cto retarget with no source edits.pipeline:/rules:/effects:— declare the pass order and the symmetric contract posture (e.g. the request/response cycle as an explicit effect surface:RequestEmit/ResponseEmit,SocketRead/SocketWrite).
Two views of the conducted methods
Each source also names catalogued SHEET.sheet objects through Sleela's
conducted methods (role, route, congruent, sysdepth, degreemax):
- Run through
nordshrift build(no catalog bound) the conducted-method lines resolve against an empty catalog (role(...)→"",sysdepth()→0) — the computed symmetry output is unaffected and fully deterministic. - Run a single file through
sleela runwithSLEELA_SHEETset, the catalog resolves for real:./impl/build/sleela run examples/symmetry/src/core/Symmetry.sleela # system depth = 3024 # degree max = 4 # Service role = root # Channel role = conversation # Request/Response congruent = true
So the sources are demonstrably driven by both the .sst style sheet (which
selects and runs them) and the SHEET.sheet catalog (which backs their
conducted methods).