Reference¶
Look things up here: what a word means, every key of the files a session reads, the variables it sets, where it writes its logs, the API and the release notes.
Glossary¶
- Glossary: the words the documentation uses, each defined once
Files¶
- Session file: every key of a session file
- Plugin manifest: every key of the manifest of a plugin
Hook points¶
- Hook points: the moments a session calls its hook providers at, their order, and what a failure does
Command line¶
- The
redsuncommand: its options, the example session it opens, and its exit codes
Environment¶
- Environment variables: what a session sets for its services and for itself, and what it reads
Log files¶
- Log files: where a session writes its records, and what a record looks like
API by task¶
| To | Look up |
|---|---|
| declare the components of a session | Declaring components |
| check what a component must have | What a component is held to |
| act at a moment of the build | Hook points |
| change one step of the build | Build steps |
| share a value, or ask the session for one | redsun.injection, redsun.registry |
| connect a signal to a slot | redsun.ports |
| describe a plan and build its controls | redsun.presenter, Qt widgets |
| run a plan, or one that runs until stopped | redsun.engine |
| place a view in the window | Placements |
| keep a setting between runs | Settings |
| choose where files go | redsun.path_provider |
| launch or attach to a service | redsun.services |
serve a fastcs controller over shared memory and build its device |
redsun.services.sharedbox, redsun.device.sharedbox |
| test a plugin's components and services | redsun.testing |
| log from a component | redsun.log |
| catch what a session raises | redsun.errors |
API by module¶
Find a class or a function by the module you import it from.
redsun: everything a component or a session importsredsun.aio: run a coroutine on the event loop the session sharesredsun.catalog: the catalog of runs a session keepsredsun.device: devices a session builds from what a service servesredsun.device.sharedbox: a device filled from the boxes of afastcscontroller
redsun.engine: theRunEnginethat runs the plans of a presenterredsun.engine.actions: plans that run until stopped, and the actions a user takes while they runredsun.engine.plan_stubs: steps a plan uses to wait for an action
redsun.errors: the exceptions a session raisesredsun.injection: how a component says what it needs and what it offersredsun.log: the logger, and the records of a sessionredsun.path_provider: where the acquisition files of a session goredsun.ports: slots, and the connections a session makesredsun.presenter: descriptions of plans, for the widgets that show themredsun.presenter.plan_spec: the description of a plan's parametersredsun.presenter.utils: helpers that inspect those parameters
redsun.qt: the Qt session, its placements and its menusredsun.registry: the values every component may ask forredsun.services: the servers devices talk toredsun.services.sharedbox: afastcscontroller served as boxes in shared memory
redsun.session: the session, and how components are declaredredsun.testing:pytestfixtures for testing a pluginredsun.utils: general helpersredsun.utils.descriptors: reading the keys ofblueskydescriptors and readings
redsun.view: where a view asks to be shownredsun.view.qt: Qt widgets views share
redsun.writers: writing a derived product