Add a helper to get action of an operation on a state

[fedimser]

This addresses #3296

See https://github.com/microsoft/qdk/blob/fedimser/test-utils-1/tmp/Demo.ipynb for examples how it can be used to test more complex operations using Q# wrappers.

Usage example without Context:

from qdk import qsharp, code
from qdk.test_utils import dump_operation_on_state

qsharp.eval("""
operation MyOp1(q: Qubit[]) : Unit {
    H(q[0]);
    CNOT(q[0], q[1]);
    Z(q[1]);
}
""")

dump_operation_on_state(code.MyOp1, num_qubits=2)
>>> [(0.7071067811865476+0j), 0.0, 0.0, (-0.7071067811865476-0j)]
dump_operation_on_state(code.MyOp1, num_qubits=2, initial_state=[0,1,0,0])
>>> [0.0, (-0.7071067811865476-0j), (0.7071067811865476+0j), 0.0]

Usage example with Context:

import qdk
from qdk.test_utils import dump_operation_on_state

ctx = qdk.Context()
ctx.eval("""
operation MyOp1(q: Qubit[]) : Unit {
    H(q[0]);
    CNOT(q[0], q[1]);
    Z(q[1]);
}
""")

dump_operation_on_state(ctx.code.MyOp1, num_qubits=2, context=ctx)
>>> [(0.7071067811865476+0j), 0.0, 0.0, (-0.7071067811865476-0j)]

[github-actions]

Change in memory usage detected by benchmark.

Memory Report for 15bca19

Test	This Branch	On Main	Difference
compile core + standard lib	24614955 bytes	24591003 bytes	23952 bytes

[github-actions]

Change in memory usage detected by benchmark.

Memory Report for 15c9cf2

Test	This Branch	On Main	Difference
compile core + standard lib	24614043 bytes	24591003 bytes	23040 bytes

[github-actions]

Change in memory usage detected by benchmark.

Memory Report for 4163a8f

Test	This Branch	On Main	Difference
compile core + standard lib	24614035 bytes	24591003 bytes	23032 bytes

[github-actions]

Change in memory usage detected by benchmark.

Memory Report for a9a7ec4

Test	This Branch	On Main	Difference
compile core + standard lib	24614035 bytes	24591003 bytes	23032 bytes