Qiskit / qiskit / 6628507089

87%

main: 88%

push

github

Emit a descriptive error when the QPY version is too new (#11094)

* Emit a descriptive error when the QPY version is too new

This commit updates the qpy load() function to ensure we are raising a
descriptive error message when a user attempts to load a qpy version
that's not supported by this version of qiskit. Previously it would fail
but with a hard to understand internal error message which was just
confusing and not helpful. For example, when trying to load a QPY
version 10 payload (the version used by Qiskit 0.45.x) with qiskit-terra
0.25.2 (which only supported up to version 9) it would raise an error
message like:

```
Invalid payload format data kind 'b'p''."
```

which doesn't tell you anything meaningful unless you are intimately
familiar with the QPY file format and how the load() function works.
With this commit it now checks if the version number is supported
immediately and if it's too new it will raise an error message that
says exactly that. So in the above scenario instead of that error
message it will say:

```
The QPY format version being read, 10, isn't supported by this Qiskit
version. Please upgrade your version of Qiskit to load this QPY payload.
```

In addition to fix CI on the stable/0.25 branch this commit puts a hard
cap on the versions we test backwards compatibility with. Previously the
script ran with all tagged releases of Qiskit, but with the recent
release of the 0.45.0rc1 tag we no longer can do that. The QPY format
emitted by 0.45.0rc1 is not something that the 0.25.x release series can
read.

* Fix copy paste error

* Fix attribute access name from named tuple

2 of 2 new or added lines in 1 file covered. (100.0%)

74161 of 84988 relevant lines covered (87.26%)

61041.91 hits per line