Metadata-Version: 2.4
Name: oaknut-econet-aun
Version: 13.6.1
Summary: AUN (Acorn Universal Networking) transport for oaknut-econet: logical Econet over UDP/IP, with optional mDNS station discovery.
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-aun
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
Provides-Extra: mdns
Requires-Dist: zeroconf>=0.130; extra == "mdns"
Dynamic: license-file

# oaknut-econet-aun

The **AUN** (Acorn Universal Networking) transport for the `oaknut-econet`
family — logical Econet carried over UDP/IP.

AUN was Acorn's bridge from Econet to Ethernet. It collapses the Econet
four-way handshake into a two-packet UDP exchange (a typed datagram plus an
`Ack`/`Nack`), with a 4-byte handle for correlation. Station addresses
`(network, station)` are resolved to and from IP `(host, port)` by a peer map;
the AUN header itself carries no station numbers.

This package provides:

- the AUN wire codec (`AunPacket` / `AunType`),
- the mapping between `oaknut.econet.core.EconetPacket` and AUN packets,
- `AunTransport`, an `EconetTransport` over an `asyncio` UDP endpoint, and
- optional mDNS station advertisement/discovery (the vendor-neutral
  `_aun._udp` convention), available with the `mdns` extra.

It registers on the `oaknut.econet.transport` extension axis as `aun`, so an
application can load it by name. It is the easiest transport to run with no
hardware — pure UDP — and is the reference against which the `EconetTransport`
abstraction is validated. See `docs/dev/econet-design.md` for the design.
