Skip to content

Update LiquidHandlerBackend Naming: Part 1 - Trigger Warning #464

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged

Conversation

BioCam
Copy link
Contributor

@BioCam BioCam commented Apr 13, 2025

Hi everyone,

Currently PLR's main LiquidHandlerBackends are named directly what their liquid handler is called.
This generates a problem:

We would like to call frontend class (parameterized) definition functions the full name, since the frontend represents these machines in their entirety, i.e. the physical definition (/resource) + their programmatic control (/backend).

In this small PR I am proposing renaming these:

  • class STAR() -> STARBackend()
  • class Vantage() -> VantageBackend()
  • class EVO() -> EVOBackend()

(I was not sure about how the OT2 is implemented, I would like to ask for a volunteer to check its compliance with these changes)

...this is in accordance with the updated documentation of the "PLR Architecture" in the latest docs rehaul:
2504_PLR_architecture

Note: In this PR I am purposefully not deleting the old naming completely because (I would imagine) the vast majority of PLR-based automated protocols uses these LiquidHandlerBackend classes.
Instead I am proposing a 1 month transition period in which instantiation of the old classes will still work but trigger a warning, informing the user to update their code.
After 1 month of warnings I propose we remove the warning and replace it with an error message that forces users to transition to the new class names.

@BioCam BioCam changed the title Update Liquid Handler Naming: Part 1 - with Warning Update Liquid Handler Backend Naming: Part 1 - with Warning Apr 13, 2025
@BioCam BioCam changed the title Update Liquid Handler Backend Naming: Part 1 - with Warning Update LiquidHandlerBackend Naming: Part 1 - with Warning Apr 13, 2025
@BioCam BioCam changed the title Update LiquidHandlerBackend Naming: Part 1 - with Warning Update LiquidHandlerBackend Naming: Part 1 - Trigger Warning Apr 13, 2025
@rickwierenga rickwierenga merged commit 697ac37 into PyLabRobot:main Apr 30, 2025
6 checks passed
@BioCam BioCam deleted the Update-Liquid-Handler-Backend-Names branch May 1, 2025 08:28
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.

2 participants