Skip to content

Add documentation for using Tiled at Diamond - #37

Open
ZohebShaikh wants to merge 4 commits into
mainfrom
ZohebShaikh/docs-for-tiled
Open

ZohebShaikh wants to merge 4 commits into
mainfrom
ZohebShaikh/docs-for-tiled

Conversation

@ZohebShaikh

Copy link
Copy Markdown
Contributor

Cover getting started, searching with Tiled queries and Glazed, live streaming, NeXus file creation, the current and central authorization policies, and the per-beamline deployment architecture.

ZohebShaikh and others added 3 commits November 8, 2026 22:06
Cover getting started, searching with Tiled queries and Glazed, live
streaming, NeXus file creation, the current and central authorization
policies, and the per-beamline deployment architecture.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Generate the docs setup from python-copier-template 5.4.0 with
docs_type sphinx and move the pages into its tutorials, how-to and
explanations layout. Publish through the GitHub Pages actions in place
of the template's gh-pages step.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Explain that acquisition comes first and how an outage is handled. Add
an example of reading Tiled from UDC, a workaround for creating a
processed folder that the central authorization migration keeps, how to
request a custom endpoint, and searching with TimeRange.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@codecov

codecov Bot commented Nov 9, 2026 •

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 95.79%. Comparing base (2f8ead1) to head (4d01eec).

Additional details and impacted files
@@           Coverage Diff           @@
##             main      #37   +/-   ##
=======================================
  Coverage   95.79%   95.79%           
=======================================
  Files           5        5           
  Lines         857      857           
=======================================
  Hits          821      821           
  Misses         36       36           

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

@ZohebShaikh
ZohebShaikh marked this pull request as ready for review November 10, 2026 19:34
@ZohebShaikh
ZohebShaikh requested a review from a team November 11, 2026 09:14
| Open Policy Agent | Makes the access decisions. See [Authorization](authorization.md). |
| Redis | Tiled's streaming cache, which live [streaming](streaming.md) requires. |
| Glazed | The [GraphQL interface](searching.md#graphql-with-glazed), a separate service in front of Tiled. |
| oauth2-proxy | Sits in front of Tiled and Glazed, and sends anonymous browsers to log in. |

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This will be remove in a future version to remove this as a single point of failure

Comment thread docs/searching.md Outdated
visit.search(Key("start.blueapi_task_id") == task_id).values().first()

# Everything since a given time
visit.search(Key("start.time") > datetime(2026, 7, 2, 9, 0).timestamp())

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

will change it to bluesky-tiled-plugin

Comment on lines +16 to +18
It needs a recent client: `bluesky-tiled-plugins` 2.0.13 and `tiled` 0.2.21 are
known to work. Older Tiled clients try to create an API key for the connection,
which fails without the `create:apikeys` scope.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Currently prod tiled is stuck on 0.2.18, once updated you will be able to use the tiled_client for websocket.

But the raw websocket connection should still work without the update

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant