[renovate]

This PR contains the following updates:

Package	Change	Age	Confidence
ophyd_async	==0.19.3 → ==0.21.3

---

Release Notes

bluesky/ophyd-async (ophyd_async)

v0.21.3

Compare Source

What's Changed

• CI: run workflows on merge_group events by @​coretl in #​1411
• Add pixel mask link to odin by @​DominicOram in #​1401
• Add user friendly __str__ and __repr__ to Device by @​oliwenmandiamond in #​1415
• Device.repr and str uses round rather than square brackets by @​coretl in #​1417
• Make driver optional for ADHDFDataLogic by @​jwlodek in #​1419
• Fix typo in pr making driver optional for ADHDFDataLogic by @​jwlodek in #​1420
• Fix the filling of optional TriggerableCommand or Device children by @​coretl in #​1421
• Allow passing strings for directory paths to path providers by @​jwlodek in #​1413
• Pin pyqt6 to <6.10, since 6.10+ needs a version of glibc that is newer than the one shipped with RHEL8. by @​jwlodek in #​1418
• Update SubsetEnum so its behaviour matches its intention by @​tomkane-dls in #​1423

Full Changelog: bluesky/ophyd-async@v0.21.2...v0.21.3

What's Changed

• CI: run workflows on merge_group events by @​coretl in #​1411
• Add pixel mask link to odin by @​DominicOram in #​1401
• Add user friendly __str__ and __repr__ to Device by @​oliwenmandiamond in #​1415
• Device.repr and str uses round rather than square brackets by @​coretl in #​1417
• Make driver optional for ADHDFDataLogic by @​jwlodek in #​1419
• Fix typo in pr making driver optional for ADHDFDataLogic by @​jwlodek in #​1420
• Fix the filling of optional TriggerableCommand or Device children by @​coretl in #​1421
• Allow passing strings for directory paths to path providers by @​jwlodek in #​1413
• Pin pyqt6 to <6.10, since 6.10+ needs a version of glibc that is newer than the one shipped with RHEL8. by @​jwlodek in #​1418
• Update SubsetEnum so its behaviour matches its intention by @​tomkane-dls in #​1423

Full Changelog: bluesky/ophyd-async@v0.21.2...v0.21.3

v0.21.2

Compare Source

What's Changed

• Support explicit derived_datatypes for generic derived_signal by @​oliwenmandiamond in #​1389
• fix: set aquisition ID to before setting file prefix by @​shihab-dls in #​1310
• Only show a warning, rather than raise if a detector data logic doesn't support unbounded mode. by @​jwlodek in #​1364
• Document that mock/soft callbacks accept sync or async callables by @​coretl in #​1396
• tests: stop pinning wall-clock upper bound on signal retry timing by @​coretl in #​1397
• Add ROI binning and NDProcess scaling by @​DominicOram in #​1391
• Add an asyncio crash course to the tutorials by @​JosephDemarest in #​1380
• Loosen type hints for protocols from AsynStatus to AsynStatusBase to allow using WatchableAsyncStatus returns as well by @​jwlodek in #​1392
• Make AsyncStatus generic in its result type by @​coretl in #​1405
• Stop two async operations outliving the event loop they were made on (3.14 CI failures) by @​coretl in #​1384
• Update dependency https://github.com/DiamondLightSource/python-copier-template to v5.4.0 by @​renovate[bot] in #​1398
• Fix SimMotor logic when mock=True and instant=False by @​oliwenmandiamond in #​1407

New Contributors

• @​JosephDemarest made their first contribution in #​1380

Full Changelog: bluesky/ophyd-async@v0.21.1...v0.21.2

What's Changed

• Support explicit derived_datatypes for generic derived_signal by @​oliwenmandiamond in #​1389
• fix: set aquisition ID to before setting file prefix by @​shihab-dls in #​1310
• Only show a warning, rather than raise if a detector data logic doesn't support unbounded mode. by @​jwlodek in #​1364
• Document that mock/soft callbacks accept sync or async callables by @​coretl in #​1396
• tests: stop pinning wall-clock upper bound on signal retry timing by @​coretl in #​1397
• Add ROI binning and NDProcess scaling by @​DominicOram in #​1391
• Add an asyncio crash course to the tutorials by @​JosephDemarest in #​1380
• Loosen type hints for protocols from AsynStatus to AsynStatusBase to allow using WatchableAsyncStatus returns as well by @​jwlodek in #​1392
• Make AsyncStatus generic in its result type by @​coretl in #​1405
• Stop two async operations outliving the event loop they were made on (3.14 CI failures) by @​coretl in #​1384
• Update dependency https://github.com/DiamondLightSource/python-copier-template to v5.4.0 by @​renovate[bot] in #​1398
• Fix SimMotor logic when mock=True and instant=False by @​oliwenmandiamond in #​1407

New Contributors

• @​JosephDemarest made their first contribution in #​1380

Full Changelog: bluesky/ophyd-async@v0.21.1...v0.21.2

v0.21.1

Compare Source

What's Changed

• Add regression test to cover consistency between trigger() and collect_asset_docs() observed collections_written by @​thopkins32 in #​1379
• Fix StandardReadable to work with DeviceMap by @​oliwenmandiamond in #​1382

Full Changelog: bluesky/ophyd-async@v0.21.0...v0.21.1

What's Changed

• Add regression test to cover consistency between trigger() and collect_asset_docs() observed collections_written by @​thopkins32 in #​1379
• Fix StandardReadable to work with DeviceMap by @​oliwenmandiamond in #​1382

Full Changelog: bluesky/ophyd-async@v0.21.0...v0.21.1

v0.21.0

Compare Source

Breaking Changes

StandardFlyer renamed to StandardFlyable, FlyerController to FlyableLogic

Flyers now follow the same logic-object pattern as StandardMovable and StandardDetector: a FlyableLogic holds the signals and the hardware logic, and StandardFlyable is the Device that drives it. The hooks are renamed with an on_ prefix, and state that used to be stashed on the logic between prepare/kickoff/complete is now threaded through an explicit context object that the Device owns.

# old
from ophyd_async.core import FlyerController, StandardFlyer

class MyTriggerLogic(FlyerController[MyInfo]):
    def __init__(self, block: MyBlock) -> None:
        self.block = block

    async def prepare(self, value: MyInfo):
        self._status = None
        ...  # arm the hardware

    async def kickoff(self) -> None:
        self._status = self._start()

    async def complete(self) -> None:
        await self._status

    async def stop(self):
        ...

flyer = StandardFlyer(MyTriggerLogic(block), name="flyer")

# new
from dataclasses import dataclass
from ophyd_async.core import FlyableLogic, StandardFlyable

@dataclass
class MyFlyCtx:
    status: AsyncStatus | None = None

@dataclass
class MyFlyableLogic(FlyableLogic[MyInfo, MyFlyCtx]):
    block: MyBlock

    async def on_prepare(self, value: MyInfo) -> MyFlyCtx:
        ...  # arm the hardware
        return MyFlyCtx()

    async def on_kickoff(self, ctx: MyFlyCtx) -> MyFlyCtx:
        ctx.status = self._start()
        return ctx

    async def on_complete(self, ctx: MyFlyCtx) -> None:
        await ctx.status

    async def stop(self):
        ...

flyer = MyFlyableLogic(block).with_device(name="flyer")

StandardFlyable enforces prepare() -> kickoff() -> complete() ordering and raises if called out of order, so logic classes no longer need to guard against it. Use FlyableLogic[MyInfo, None] for hardware that carries no state between stages. stage()/unstage() call on_stage()/on_unstage(), which both default to stop().

Devices that are always flyers (e.g. a motor controller) mix StandardFlyable into the Device class and provide a flyable_logic @cached_property instead of calling with_device(). The old StandardFlyer.trigger_logic property is now StandardFlyable.flyable_logic. See the new How to write a flying
Device guide.

PandA trigger logics renamed to *FlyableLogic

They are now @dataclasses rather than hand-written __init__s, and are wrapped with with_device() rather than StandardFlyer.

# old
from ophyd_async.core import StandardFlyer
from ophyd_async.fastcs.panda import (
    ScanSpecSeqTableTriggerLogic,
    StaticPcompTriggerLogic,
    StaticSeqTableTriggerLogic,
)

flyer = StandardFlyer(StaticSeqTableTriggerLogic(panda.seq[1]), name="flyer")
flyer = StandardFlyer(StaticPcompTriggerLogic(panda.pcomp[1]), name="flyer")
flyer = StandardFlyer(
    ScanSpecSeqTableTriggerLogic(panda.seq[1], motor_pos_outs), name="flyer"
)

# new
from ophyd_async.fastcs.panda import (
    ScanSpecSeqTableFlyableLogic,
    StaticPcompFlyableLogic,
    StaticSeqTableFlyableLogic,
)

flyer = StaticSeqTableFlyableLogic(panda.seq[1]).with_device(name="flyer")
flyer = StaticPcompFlyableLogic(panda.pcomp[1]).with_device(name="flyer")
flyer = ScanSpecSeqTableFlyableLogic(panda.seq[1], motor_pos_outs).with_device(
    name="flyer"
)

StaticPcompTriggerLogic.complete() took an optional timeout argument; StaticPcompFlyableLogic.on_complete(ctx) does not (it was never passed by the flyer).

PMAC PmacTrajectoryTriggerLogic is now PmacTrajectoryFlyableLogic, and is not a Device

It used to be a Device that implemented Flyable itself, so it was passed straight to bps.prepare. It is now a plain logic object with no name argument, and needs wrapping in a flyer.

# old
from ophyd_async.epics.pmac import PmacTrajectoryTriggerLogic

trajectory = PmacTrajectoryTriggerLogic(pmac, name="trajectory")
yield from bps.prepare(trajectory, PmacScanInfo(...), wait=True)

# new
from ophyd_async.epics.pmac import PmacTrajectoryFlyableLogic

trajectory = PmacTrajectoryFlyableLogic(pmac).with_device(name="trajectory")
yield from bps.prepare(trajectory, PmacScanInfo(...), wait=True)

What's Changed

• StandardFlyer -> StandardFlyable by @​coretl in #​1359
• tests: harden set_and_wait error test against slow-loop flake by @​coretl in #​1375
• tests: harden set_and_wait_for_value happy-path assertions against slow-loop flake by @​coretl in #​1378
• Update scanspec to 1.0.0 by @​coretl in #​1376

Full Changelog: bluesky/ophyd-async@v0.20.1...v0.21.0

What's Changed

• StandardFlyer -> StandardFlyable by @​coretl in #​1359
• tests: harden set_and_wait error test against slow-loop flake by @​coretl in #​1375
• tests: harden set_and_wait_for_value happy-path assertions against slow-loop flake by @​coretl in #​1378
• Update scanspec to 1.0.0 by @​coretl in #​1376

Full Changelog: bluesky/ophyd-async@v0.20.1...v0.21.0

v0.20.1

Compare Source

What's Changed

• Scope the PvSuffix-required note to static EPICS by @​coretl in #​1365
• Speed up the test suite and unhide the adsim system test by @​coretl in #​1363
• Allow PvaCommandBackend to have '?' specifiers by @​olliesilvester in #​1370
• Update dependency https://github.com/DiamondLightSource/python-copier-template to v5.3.0 by @​renovate[bot] in #​1360
• Add opt-outs for the reserved-attr check (#​1028 follow-up) by @​coretl in #​1369

Full Changelog: bluesky/ophyd-async@v0.20.0...v0.20.1

What's Changed

• Scope the PvSuffix-required note to static EPICS by @​coretl in #​1365
• Speed up the test suite and unhide the adsim system test by @​coretl in #​1363
• Allow PvaCommandBackend to have '?' specifiers by @​olliesilvester in #​1370
• Update dependency https://github.com/DiamondLightSource/python-copier-template to v5.3.0 by @​renovate[bot] in #​1360
• Add opt-outs for the reserved-attr check (#​1028 follow-up) by @​coretl in #​1369

Full Changelog: bluesky/ophyd-async@v0.20.0...v0.20.1

v0.20.0

Compare Source

What's Changed

• tests: fix flaky test_signal_lifecycle[a_bool] (deterministic put values) by @​coretl in #​1361
• tests: stop pinning wall-clock upper bound on observe timeout flake by @​coretl in #​1362
• Add DeviceMap and declarative sub-devices (#​1252, #​1182) by @​oliwenmandiamond in #​1282

Full Changelog: bluesky/ophyd-async@v0.19.4...v0.20.0

v0.19.4

Compare Source

What's Changed

• adds a check for motor limit by @​gkalua in #​1289
• Unify OneOfEverything test devices: add SupersetEnum, fix Tango naming by @​coretl in #​1322
• Fix flaky Windows CI: increase Tango test context startup timeout by @​coretl in #​1323
• Fix DeviceVector-of-signals type check in PviDeviceConnector by @​coretl in #​1325
• Rework generic PVI test backend: full mirroring + nested devices by @​coretl in #​1327
• Fix typo in pcomp info confined model by @​jwlodek in #​1331
• StandardMovable cancels move task when stopped by @​oliwenmandiamond in #​1320
• Remove jython cache, update gitignore by @​jwlodek in #​1333
• Add declarative Tango test Device, pairing with the procedural flavour by @​coretl in #​1328
• Add generic Signal-level lifecycle test suite for Tango (item 4, first slice) by @​coretl in #​1332
• Narrow Array1D to genuinely 1-D at the type-checker level by @​coretl in #​1339
• Update standard detector watcher update behavior to match ophyd v1, report in collections instead of events for step scans. by @​jwlodek in #​1334
• Widen Windows-only tolerance for flaky test_motor_moving_well timing by @​coretl in #​1345
• fix: correctly check pmac execution status and messages by @​shihab-dls in #​1235
• Fix flaky timing budget in test_many_individual_device_connects_not_slow by @​coretl in #​1341
• EPICS wholesale Signal-level system test replacement (item 4) by @​coretl in #​1337
• Raise exception if attr name is a bluesky protocol by @​shihab-dls in #​1028
• Add consolidated CLAUDE.md as single agent/contributor guide by @​coretl in #​1347
• Check duplicate keys in merge_gathered_dicts by @​shihab-dls in #​1346
• Fix timeout-clock race in set_and_wait_for_other_value by @​coretl in #​1342
• Tango wholesale Signal-level test replacement (issue #​1321 item 5) by @​coretl in #​1343
• core/soft-signal Signal-level lifecycle test suite (issue #​1321 item 6) by @​coretl in #​1350
• Delete tests/system_tests/fastcs/panda/ (item 7, PandA cleanup half) by @​coretl in #​1351
• Add how-to guide for running a local softIoc/PyTango backend by @​coretl in #​1352
• Make agent STATE.md local-only (git-ignore it) by @​coretl in #​1353
• result to abstract method from property to keep with protocol - resolves #​1306 by @​tomkane-dls in #​1349
• CLAUDE.md: require Fixes #NNN closing line per issue on a PR by @​coretl in #​1355
• Wrap Tango device-proxy connect failures as NotConnectedError by @​coretl in #​1340
• Add additional epics motor record fields for motor/encoder resolution by @​jwlodek in #​1330
• Fix incorrect type for epics motor SREV by @​jwlodek in #​1357
• Bump msgpack from 1.1.2 to 1.2.1 by @​dependabot[bot] in #​1358

New Contributors

• @​tomkane-dls made their first contribution in #​1349

Full Changelog: bluesky/ophyd-async@v0.19.3...v0.19.4

---

Configuration

📅 Schedule: (UTC)

• Branch creation
  • At any time (no schedule defined)
• Automerge
  • At any time (no schedule defined)

🚦 Automerge: Disabled by config. Please merge this manually once you are satisfied.

♻ Rebasing: Whenever PR becomes conflicted, or you tick the rebase/retry checkbox.

🔕 Ignore: Close this PR and you won't be reminded about this update again.

---

• If you want to rebase/retry this PR, check this box

---

This PR was generated by Mend Renovate. View the repository job log.

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 48.18%. Comparing base (902fd74) to head (d0e3a93).

Additional details and impacted files

@@           Coverage Diff           @@
##             main      #72   +/-   ##
=======================================
  Coverage   48.18%   48.18%           
=======================================
  Files          27       27           
  Lines        1459     1459           
=======================================
  Hits          703      703           
  Misses        756      756           

☔ 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.