tractor/examples
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
..
advanced_faults Include `TransportClosed` in tpt-layer err handling 2026-02-19 13:55:02 -05:00
debugging Name every `ActorNursery` binding `an` in tests/examples 2026-08-25 19:19:28 -04:00
integration Name every `ActorNursery` binding `an` in tests/examples 2026-08-25 19:19:28 -04:00
parallelism Name every `ActorNursery` binding `an` in tests/examples 2026-08-25 19:19:28 -04:00
trio Reduce "ignore cases" script to `trio`-only 2025-09-07 18:49:21 -04:00
__init__.py Make example a subpkg for `python -m <mod>` testing 2022-07-27 11:40:02 -04:00
__main__.py Use trio.run() in windows tests 2021-05-07 11:21:40 -04:00
a_trynamic_first_scene.py Polish `to_actor` examples and references 2026-08-25 15:20:34 -04:00
actor_spawning_and_causality.py Showcase `to_actor.run()` across docs 2026-08-21 15:03:34 -04:00
actor_spawning_and_causality_with_daemon.py Name every `ActorNursery` binding `an` in tests/examples 2026-08-25 19:19:28 -04:00
asynchronous_generators.py Name every `ActorNursery` binding `an` in tests/examples 2026-08-25 19:19:28 -04:00
dedicated_registrar.py Add a dedicated-registrar example + discovery guide 2026-08-28 14:40:01 -04:00
full_fledged_streaming_service.py Final try, drop logging level in streaming example to see if macos can cope.. 2026-03-09 19:46:42 -04:00
infected_asyncio_echo_server.py Name every `ActorNursery` binding `an` in tests/examples 2026-08-25 19:19:28 -04:00
multiple_streams_one_portal.py Update all examples to new streaming API 2021-04-28 12:23:08 -04:00
nested_actor_tree.py Add 5 examples filling doc-tutorial gaps 2026-06-28 13:29:01 -04:00
quick_cluster.py Remove lingering seg=False-flags from examples 2025-08-18 12:03:10 -04:00
remote_error_propagation.py Showcase `to_actor.run()` across docs 2026-08-21 15:03:34 -04:00
rpc_bidir_streaming.py Name every `ActorNursery` binding `an` in tests/examples 2026-08-25 19:19:28 -04:00
service_daemon_discovery.py Add 5 examples filling doc-tutorial gaps 2026-06-28 13:29:01 -04:00
service_discovery.py Rename `Arbiter` -> `Registrar`, mv to `discovery._registry` 2026-04-02 17:59:13 -04:00
streaming_broadcast_fanout.py Add 5 examples filling doc-tutorial gaps 2026-06-28 13:29:01 -04:00
typed_payloads.py Add 5 examples filling doc-tutorial gaps 2026-06-28 13:29:01 -04:00
uds_transport_actor_tree.py Fix UDS addr corruption sans-autobind (macOS) 2026-08-13 15:46:56 -04:00