fix(api): Fix malformed PAPI error message

[SyntaxColoring]

Overview

This fixes a malformed error message caught by the snapshot tests in #16062:

Nozzle layout configuration of style SINGLE is unsupported in API Versions lower than 2.20. is not yet available in the API version in use.

Test Plan and Hands on Testing

I'm relying on automated tests.

Changelog

• Rework the underlying exceptions so that if you construct them with just a single unnamed string argument, it's used directly as the message, without any surprise concatenation. I think this is least surprising to the caller, given our codebase's existing exception conventions.

Also, for niceness:

• typing.overloads, for clarity.
• In the mode where we generate the exception message automatically from api_element+since_version+current_version, handle some additional cases of partially missing information.

Review requests

None.

Risk assessment

Low.

[codecov]

Codecov Report

Attention: Patch coverage is 11.11111% with 24 lines in your changes missing coverage. Please review.

Please upload report for BASE (chore_release-8.0.0@3d04c5c). Learn more about missing BASE report.

Files	Patch %	Lines
.../python/opentrons_shared_data/errors/exceptions.py	11.11%	24 Missing ⚠️

Additional details and impacted files

@@                  Coverage Diff                   @@
##             chore_release-8.0.0   #16065   +/-   ##
======================================================
  Coverage                       ?   73.27%           
======================================================
  Files                          ?       41           
  Lines                          ?     2945           
  Branches                       ?        0           
======================================================
  Hits                           ?     2158           
  Misses                         ?      787           
  Partials                       ?        0           

Flag	Coverage Δ
shared-data	73.27% <11.11%> (?)

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

Files	Coverage Δ
.../python/opentrons_shared_data/errors/exceptions.py	55.20% <11.11%> (ø)

[SyntaxColoring]

Hmm. Not sure why the snapshot tests on this PR aren't showing a diff.

Verified manually that the fix works:

cd api
pipenv run python -m opentrons.cli analyze ../analyses-snapshot-testing/files/protocols/Flex_S_v2_16_P1000_96_TC_PartialTipPickupSingle.py --human-json-output -

// ...
{
"detail": "APIVersionError [line 16]: Error 4011 INCORRECT_API_VERSION (APIVersionError): Nozzle layout configuration of style SINGLE is not available until API version 2.20. You are currently using API version 2.16.",
}

[sfoster1]

Looks good, though I think that if you wanted to save some diff you could have the new argument be full_message and keep message as the kwarg-only one