feat: Retrieve Liquid Identity Assigned to a Well

[12buntu]

Overview

Currently, the Opentrons Protocol API provides methods to assign a Liquid to a well (e.g., Labware.load_liquid, Labware.load_liquid_by_well) and to retrieve the current liquid volume in a well (e.g., Well.current_liquid_volume()). However, there is no public API function to retrieve the identity (object or name) of the Liquid assigned to a well after it has been loaded.

Use Case

With the new LiquidClass, features, I would like to be able to use Pipette.transfer_with_liquid_class(), choosing a LiquidClass based on the Liquid in the well. Right now, I use a dictionary to track this independently in my protocol, but it would be nice to access it directly through the API.

Proposed Solution

Expose a public method or property on the Well class (and/or Labware class) that returns the Liquid object or its name currently assigned to the well. For example:

Well.get_liquid()  # Returns Liquid object
Well.liquid_name   # Returns a string

or:

Labware.get_liquid_by_well("A1") 

Implementation details

No response

Design

No response

Acceptance criteria

No response