Home/Examples/examples/symmetry

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 the make test targets). 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)

FileSymmetry it demonstratesCatalogued objects (conducted methods)
System.sleelaRoll-up: HTTP + FTP server rule == client mirror (8/8 agree)System, Service, Protocol
core/Symmetry.sleelaMirror + round-trip laws (mirror(mirror(x))==x)Service, Channel
core/Channel.sleelaThe shared medium: a spawned writer's frames are read back in order (mailbox send/recv)Channel, Pipe, Stream
core/Message.sleelaRequest/Response framing: sender frame size == receiver frame sizeMessage, Request, Response
http/HttpServer.sleelaServer maps (method, path) → statusService, Router, Session
http/HttpClient.sleelaClient mirrors the server's status table; 2xx success classGateway, Retry
http/Router.sleelaBijective dispatch: toPath(toHandler(p)) == p (3/3)Router, Middleware, Pipeline
ftp/FtpServer.sleelaServer maps command → reply codeService, Connector
ftp/FtpClient.sleelaClient mirrors reply codes; proceed vs abortGateway, Session
ftp/Session.sleelaBalanced lifecycle: opens and closes must net to depth 0Session, StateMachine, Watchdog

How the style sheet drives the build

Two views of the conducted methods

Each source also names catalogued SHEET.sheet objects through Sleela's conducted methods (role, route, congruent, sysdepth, degreemax):

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).