tractor/docs/guide
Gud Boi 4c507ea13c Add a dedicated-registrar example + discovery guide
Add a runnable `examples/dedicated_registrar.py` + a "A dedicated
registrar" subsection in `guide/discovery.rst` demoing the
registrar decoupled from any app tree's root: boot a bare
`tractor.run_daemon([], registry_addrs=[...])` as its own process
(a root actor that does nothing but hold the registry), point the
app tree at the same `registry_addrs`, and discover a service
*through* that external registrar.

This is the buildable-today form of the #472
"Registrar-as-subsystem (not the root actor)" bullet. Two
constraints are called out inline as follow-ups:
`enable_transports` is single-proto per runtime (no multi-backend
registrar yet), and a registrar can only be a root (no `actor_cls`
hook on `start_actor()` to spawn one as a subactor).

(this patch was generated in some part by [`claude-code`][claude-code-gh])
[claude-code-gh]: https://github.com/anthropics/claude-code
2026-08-28 14:40:01 -04:00
..
asyncio.rst Expose stream subscriber lag policy 2026-08-27 21:18:00 -04:00
cancellation.rst Clarify owned-child hard-reap docs 2026-08-25 15:56:38 -04:00
clustering.rst Clarify `to_actor.run()` ownership 2026-08-21 15:03:34 -04:00
context.rst Clarify `to_actor.run()` ownership 2026-08-21 15:03:34 -04:00
debugging.rst Write the big boi docs content tree 2026-06-28 13:29:01 -04:00
discovery.rst Add a dedicated-registrar example + discovery guide 2026-08-28 14:40:01 -04:00
index.rst Showcase `to_actor.run()` across docs 2026-08-21 15:03:34 -04:00
msging.rst Expand caps-based-msging docs w/ #365, #376 + tests 2026-08-28 14:40:01 -04:00
parallelism.rst Showcase `to_actor.run()` across docs 2026-08-21 15:03:34 -04:00
rpc.rst Polish `to_actor` examples and references 2026-08-25 15:20:34 -04:00
spawning.rst Correct `to_actor.run()` target guidance 2026-08-21 15:03:35 -04:00
streaming.rst Reject concurrent `BroadcastReceiver.receive()` calls 2026-08-27 22:11:55 -04:00
testing.rst Make UDS reaping platform-aware 2026-08-14 10:36:27 -04:00