Skip to content
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

docs(api): API reference entries for liquid class methods #17887

Merged
merged 3 commits into from
Apr 9, 2025

Conversation

ecormany
Copy link
Contributor

@ecormany ecormany commented Mar 26, 2025

Overview

Adding methods like transfer_with_liquid_class() to the API reference.

Addresses RTC-610.

Any follow-up edits to these docstrings can be handled in #17992.

Test Plan and Hands on Testing

Sandbox

Changelog

  • Param descriptions for the three main liquid class methods.
  • Unhide the methods
  • Add LiquidClass to the ref.
  • Nitpicks to allow docs to build.

Review requests

Are these "good enough"? Want to get these merged to keep other liquid class docs work moving.

Risk assessment

low, docs

Copy link

codecov bot commented Mar 26, 2025

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 28.90%. Comparing base (39ad078) to head (a49ec8a).

Additional details and impacted files

Impacted file tree graph

@@                 Coverage Diff                  @@
##           chore_release-8.4.0   #17887   +/-   ##
====================================================
  Coverage                28.90%   28.90%           
====================================================
  Files                     3101     3101           
  Lines                   235465   235465           
  Branches                 19131    19131           
====================================================
  Hits                     68066    68066           
  Misses                  167375   167375           
  Partials                    24       24           
Flag Coverage Δ
protocol-designer 18.80% <ø> (ø)
step-generation 4.35% <ø> (ø)

Flags with carried forward coverage won't be shown. Click here to find out more.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
  • 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

@ecormany ecormany added docs papi-v1 Python Protocol API v1 papi-v2 Python API V2 and removed papi-v1 Python Protocol API v1 labels Mar 26, 2025
@ecormany ecormany force-pushed the api-ref-liquid-classes branch from ec94022 to a49ec8a Compare April 8, 2025 19:53
@ecormany ecormany marked this pull request as ready for review April 8, 2025 19:57
@ecormany ecormany requested a review from a team as a code owner April 8, 2025 19:57
@ecormany ecormany requested a review from emilyburghardt April 8, 2025 19:57
Copy link
Collaborator

@emilyburghardt emilyburghardt left a comment

Choose a reason for hiding this comment

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

Left two comments that can also just serve as reminders for me, so yes good to merge to keep docs moving along!


TODO: Add args description.
:param liquid_class: The type of liquid to move. You must specify the liquid class,
Copy link
Collaborator

Choose a reason for hiding this comment

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

question/suggestion here- yes, users must specify the liquid class, but the liquid class load name isn't accepted, only a label you've assigned the liquid class earlier in your protocol, like liquid_1 with define_liquid_class().

Copy link
Contributor Author

Choose a reason for hiding this comment

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

We better make sure people don't try transfer_with_liquid_class(...liquid=define_liquid_class("water")) because that will escalate quickly.

@emilyburghardt emilyburghardt self-requested a review April 8, 2025 20:57
@ecormany ecormany merged commit 8d63591 into chore_release-8.4.0 Apr 9, 2025
24 checks passed
@ecormany ecormany deleted the api-ref-liquid-classes branch April 9, 2025 13:27
y3rsh added a commit that referenced this pull request Apr 9, 2025
…y-path

* chore_release-8.4.0: (30 commits)
  fix(api): make error message clearer for lld issues (#18005)
  chore(locize): sync for translations needed (#18009)
  chore(locize): sync translations (#18009)
  docs(api): API reference entries for liquid class methods (#17887)
  refactor(api): change the names of liquid classes based transfers (#18006)
  feat(app, labware-library): add evotip definition assets (#18007)
  fix(api, shared-data): Flex Stacker engine command optional fields (#17989)
  fix(shared-data): ethanol aspirate position reference (#17991)
  fix(app): Labware setup UI fixes (#17987)
  refactor(app): adjust protocol setup offsets table header (#17985)
  fix(app): do not show post run drop tip prompt if just handled in Error Recovery (#17981)
  fix(app): fix LPC disabled reasons not including fixture mismatch (#17979)
  refactor(app): adjust width on "calibrate now" button (#17978)
  fix(app): fix applying offsets implicitly when navigating on the desktop app (#17967)
  feat(robot-server): Populate `locationSequence` on old runs and make it faster to filter out deleted offsets (#17946)
  feat(app): add inline notification when setting default offsets with a 96ch (#17977)
  fix(app): ER tip selection crashes when trying to get labware def (#17975)
  feat(robot-server,system-server): Return server timing metrics in HTTP responses (#17970)
  fix(app): fix accumulating offsets on run record (#17969)
  fix(app): Fix local state issues when "resetting to default" in LPC (#17965)
  ...
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
docs papi-v2 Python API V2
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants