Metadata-Version: 2.4
Name: oaknut-econet-station
Version: 13.6.1
Summary: The Econet service host for oaknut: a Station that dispatches inbound packets by port to registered Services, the foundation for Econet applications.
Author-email: Robert Smallshire <robert@smallshire.org.uk>
License-Expression: MIT
Project-URL: Homepage, https://github.com/rob-smallshire/oaknut/tree/master/packages/oaknut-econet-station
Project-URL: Repository, https://github.com/rob-smallshire/oaknut
Project-URL: Issues, https://github.com/rob-smallshire/oaknut/issues
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: System :: Networking
Requires-Python: >=3.12
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: oaknut-econet-core>=10.0
Requires-Dist: oaknut-exception>=10.0
Requires-Dist: oaknut-extension>=10.0
Dynamic: license-file

# oaknut-econet-station

The Econet **service host** for the `oaknut-econet` family.

A `Station` is one network identity — an address plus an `EconetTransport` —
that hosts one or more `Service`s. It owns the inbound loop and dispatches each
received packet, **by port**, to the service registered for it, running each as
an independent `asyncio` task. A service replies by initiating a fresh transmit
to the reply port the client nominated.

This is the application-layer foundation: a file server, a print server, a DSCP
server, or a key-value store are each just a `Service` registered on a
`Station`. Several services run on one station concurrently — the thing
single-tasking 6502 hardware never could.

```python
station = Station(transport, address=Address(0, 254))
station.register(FileServer(...))  # claims port &99
station.register(PrintServer(...))  # claims the print ports
await station.serve()  # dispatch inbound packets by port
```

See `docs/dev/econet-design.md` §13 for the design, including process
granularity and the station-broker pattern for multi-process services.
