The plugin contract, the model task and the tools roledesk imports, copied rather than reached through an editable install of news, which also exposes a package named pipeline. news stays the source of truth for desk. Refreshed from news/desk at a275c38a1aa0fe80a7ec7dd5781ecccf683f71c6 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
34 lines
1.7 KiB
Python
34 lines
1.7 KiB
Python
"""The shared core: what any desk-shaped app is built from.
|
|
|
|
An app here is something that pulls things in from sources, runs work over
|
|
them as jobs, asks a model for the parts a model is good at, and shows the
|
|
result. newsdesk is the first one. A library of things added by hand and a
|
|
board of job postings are the next two, and they share everything in this
|
|
package and nothing outside it.
|
|
|
|
tools/ machinery with no opinion about the app: a model, an
|
|
encoder, an HTTP session, a video read as text
|
|
sources/ the plugin contract, the registry that finds plugins on
|
|
disk, and the built-in sources
|
|
models.py the shapes an app hands round — an item, a link — plus the
|
|
queue's own, re-exported from `pipeline.models`
|
|
modeltask.py a job that needs a model: chunk the batch, ask, apply the
|
|
answers, and give up on a row no model will settle rather
|
|
than paying for it every run
|
|
notices.py which failures newsdesk will interrupt you about, and the
|
|
sentence it uses. The queue's half of this is
|
|
`pipeline/notices.py`
|
|
config.py the settings sections an app composes into its own config
|
|
|
|
The job queue used to be `desk/pipeline/`. It is `pipeline/` at the top of
|
|
the repository now, one tree below this one, because it turned out to be the
|
|
part worth copying into other projects and a folder cannot be copied if it
|
|
imports the tree above it. `docs/pipeline-package.md` is why and how.
|
|
|
|
Nothing in here imports from an app. `tests/test_architecture.py` holds it
|
|
to that, and to one door per package: from outside, `desk.sources` is
|
|
imported by that name and nothing behind it.
|
|
"""
|
|
|
|
__version__ = "0.1.0"
|