Qiskit / qiskit / 20149522919

push

github

Add ways to retrieve operations from the ``QkTarget`` (#15283)

* Initial: Add `QkTargetOperation` to the C-API
- Add struct ``QkTargetOperation`` which contains an operation type, a name, the number of qubits, and the parameters of the instruction.
    - The struct can only be returned via the usage of `qk_target_op_get` (name subject to change).
- If a user wanted to retreive the operation instance, in this case, a gate, we can use `qk_target_op_try_gate` to retrieve the instance, it is the user's responsibility to check whether this instance's type is `QkOperationKind_Gate`.

* Docs: Add documentation

* Test: Add tests

* Fix: initial review comments
- Rename `QkTargetOperation` to `QkTargetOp`.
- Document that users should not tamper with `CTargetOp` mutably.
- Remove `ExitCode` return from `qk_target_op_get`.
- Rename `target_op_try_gate` to `target_op_gate`.

* Docs: Add release note.

* Fix: Use actual number of parameters for `QkTargetOp`,

* Add: Support for returning variadics
- To support variadics, we added support to retrieve operations typed `QkOperationKind::PythonOp` and setting the number of qubits and parameters as `u32::MAX`.

* Fix: Review items

Co-authored-by: Julien Gacon <gaconju@gmail.com>

* Chore: Rename `COperationKind::PythonOp` to `Unknwon`.

---------

Co-authored-by: Julien Gacon <gaconju@gmail.com>

65 of 98 new or added lines in 2 files covered. (66.33%)

96621 of 109436 relevant lines covered (88.29%)

1203824.79 hits per line