g9pdZddlmZddlmZmZddlmZmZm Z m Z m Z ddl m Z ddlZddlZddlZddlmZddlmZdd lmZdd lmZmZmZmZdd lmZmZdd lm Z dd l!m"Z"eeefZ#dZ$ej%e$ej&ej'zZ(e"dddddej)fd%dZ* d&d'd$Z+dS)(z!User interface of qpy serializer.) annotations) JSONEncoder JSONDecoder)UnionListBinaryIOTypeOptional)IterableN)QuantumCircuit) ScheduleBlock) QiskitError)formatscommon binary_io type_keys)"QPYLoadingDeprecatedFeatureWarningQpyError) __version__)deprecate_pulse_arga^ v? (?: (?:(?P[0-9]+)!)? # epoch (?P[0-9]+(?:\.[0-9]+)*) # release segment (?P
                                          # pre-release
            [-_\.]?
            (?P(a|b|c|rc|alpha|beta|pre|preview))
            [-_\.]?
            (?P[0-9]+)?
        )?
        (?P                                         # post release
            (?:-(?P[0-9]+))
            |
            (?:
                [-_\.]?
                (?Ppost|rev|r)
                [-_\.]?
                (?P[0-9]+)?
            )
        )?
        (?P                                          # dev release
            [-_\.]?
            (?Pdev)
            [-_\.]?
            (?P[0-9]+)?
        )?
    )
    (?:\+(?P[a-z0-9]+(?:[-_\.][a-z0-9]+)*))?       # local version
$programsz%Passing `ScheduleBlock` to `programs`c,t|tS)N)
isinstancer
)ps J/granary/edev/quantum/lib/python3.11/site-packages/qiskit/qpy/interface.pyrPs
1m44)deprecation_description	predicateT5Union[List[QPY_SUPPORTED_TYPES], QPY_SUPPORTED_TYPES]file_objrmetadata_serializerOptional[Type[JSONEncoder]]
use_symengineboolversionintct|ts|g}t}|D]$}|t	|%t|dkrt
dtt|}t|trtjj
}tj}	n:|t urtjj}tj}	nt'd|d|
t(j}nLt(j|ks|t(jkr,t/d|dt(jdt(jt0t4}
d	|
d
dD}tj|}t?j tBj"d||d
|d|dt||}
|#|
t)j$||d}|D]0}|tjj
kr	|j%rd}|	|||||1|rtMj'tPddSdS)aWrite QPY binary data to a file

    This function is used to save a circuit to a file for later use or transfer
    between machines. The QPY format is backwards compatible and can be
    loaded with future versions of Qiskit.

    For example:

    .. code-block:: python

        from qiskit.circuit import QuantumCircuit
        from qiskit import qpy

        qc = QuantumCircuit(2, name='Bell', metadata={'test': True})
        qc.h(0)
        qc.cx(0, 1)
        qc.measure_all()

    from this you can write the qpy data to a file:

    .. code-block:: python

        with open('bell.qpy', 'wb') as fd:
            qpy.dump(qc, fd)

    or a gzip compressed file:

    .. code-block:: python

        import gzip

        with gzip.open('bell.qpy.gz', 'wb') as fd:
            qpy.dump(qc, fd)

    Which will save the qpy serialized circuit to the provided file.

    Args:
        programs: QPY supported object(s) to store in the specified file like object.
            QPY supports :class:`.QuantumCircuit` and :class:`.ScheduleBlock`.
            Different data types must be separately serialized.
            Support for :class:`.ScheduleBlock` is deprecated since Qiskit 1.3.0.
        file_obj: The file like object to write the QPY data too
        metadata_serializer: An optional JSONEncoder class that
            will be passed the ``.metadata`` attribute for each program in ``programs`` and will be
            used as the ``cls`` kwarg on the `json.dump()`` call to JSON serialize that dictionary.
        use_symengine: If True, all objects containing symbolic expressions will be serialized
            using symengine's native mechanism. This is a faster serialization alternative,
            but not supported in all platforms. This flag only has an effect if the emitted QPY format
            version is 10, 11, or 12. For QPY format version >= 13 (which is the default starting in
            Qiskit 1.3.0) this flag is no longer used.
        version: The QPY format version to emit. By default this defaults to
            the latest supported format of :attr:`~.qpy.QPY_VERSION`, however for
            compatibility reasons if you need to load the generated QPY payload with an older
            version of Qiskit you can also select an older QPY format version down to the minimum
            supported export version, which only can change during a Qiskit major version release,
            to generate an older QPY format version.  You can access the current QPY version and
            minimum compatible version with :attr:`.qpy.QPY_VERSION` and
            :attr:`.qpy.QPY_COMPATIBILITY_VERSION` respectively.

            .. note::

                If specified with an older version of QPY the limitations and potential bugs stemming
                from the QPY format at that version will persist. This should only be used if
                compatibility with loading the payload with an older version of Qiskit is necessary.

            .. note::

                If serializing a :class:`.QuantumCircuit` or :class:`.ScheduleBlock` that contain
                :class:`.ParameterExpression` objects with ``version`` set low with the intent to
                load the payload using a historical release of Qiskit, it is safest to set the
                ``use_symengine`` flag to ``False``.  Versions of Qiskit prior to 1.2.4 cannot load
                QPY files containing ``symengine``-serialized :class:`.ParameterExpression` objects
                unless the version of ``symengine`` used between the loading and generating
                environments matches.


    Raises:
        QpyError: When multiple data format is mixed in the output.
        TypeError: When invalid data type is input.
        ValueError: When an unsupported version number is passed in for the ``version`` argument
    z^Input programs contain multiple data types. Different data type must be serialized separately.'z' is not supported data type.NzThe specified QPY version z^ is not support for dumping with this version, of Qiskit. The only supported versions between z and c,g|]}t|Sr'.0xs  r
zdump..sOOOSVVOOOrrelease.sQISKITrFT)r"r$r&z[Pulse gates serialization is deprecated as of Qiskit 1.3. It will be removed in Qiskit 2.0.categorymessage))rrsetaddtypelenrnextiter
issubclassrrProgramCIRCUITr
write_circuitr
SCHEDULE_BLOCKwrite_schedule_block	TypeErrorrQPY_VERSIONQPY_COMPATIBILITY_VERSION
ValueErrorVERSION_PATTERN_REGEXsearchrgroupsplitSymExprEncodingassignstructpackrFILE_HEADER_V10_PACKwritewrite_type_key_calibrations_propwarningswarnDeprecationWarning)rr!r"r$r&
program_typesprogramprogram_typetype_keywriter
version_match
version_partsencodingheaderpulse_gatess               rdumpraMszh)):EEM))$w--((((
=A
A

	
]++,,L,//I$,(		&	&$3/GLGGGHHH$		)G	3	3wAS7S7S
$
$
$>D>^
$
$!
$
$

	
*00==MOO]%8%8%C%C%I%I#%N%NOOOM(//
>>H
[$aaaH

		F
NN6
(H---K	
	
y(000W5O0K 3'	
	
	
	
	


'0	
	
	
	
	
	


rFmetadata_deserializerOptional[Type[JSONDecoder]]
trust_payloadreturnList[QPY_SUPPORTED_TYPES]c
tjd|dd}|d|tjkrt
d|d|dkrZtj	tjtj
|tj}nYtj	tjtj
|tj}|jtjdkrt
d	t$t(}d
|ddD}|j|j|jf}|d|dksZ|d|dkr|d|dks6|d|dkra|d|dkrO|d
|d
kr=t5jddd|Ddt(d|jdkrt<jj }nt	j!|}|jdkrd}	n|j"t<j#j$k}	|t<jj kr
tJj&}
nP|t<jj'kr(tJj(}
t5jtRdntUd|dg}tW|j,D]*}|-|
||j||	|+|S)aLoad a QPY binary file

    This function is used to load a serialized QPY Qiskit program file and create
    :class:`~qiskit.circuit.QuantumCircuit` objects or
    :class:`~qiskit.pulse.schedule.ScheduleBlock` objects from its contents.
    For example:

    .. code-block:: python

        from qiskit import qpy

        with open('bell.qpy', 'rb') as fd:
            circuits = qpy.load(fd)

    or with a gzip compressed file:

    .. code-block:: python

        import gzip
        from qiskit import qpy

        with gzip.open('bell.qpy.gz', 'rb') as fd:
            circuits = qpy.load(fd)

    which will read the contents of the qpy and return a list of
    :class:`~qiskit.circuit.QuantumCircuit` objects or
    :class:`~qiskit.pulse.schedule.ScheduleBlock` objects from the file.

    Args:
        file_obj: A file like object that contains the QPY binary
            data for a circuit or pulse schedule.
        metadata_deserializer: An optional JSONDecoder class
            that will be used for the ``cls`` kwarg on the internal
            ``json.load`` call used to deserialize the JSON payload used for
            the ``.metadata`` attribute for any programs in the QPY file.
            If this is not specified the circuit metadata will
            be parsed as JSON with the stdlib ``json.load()`` function using
            the default ``JSONDecoder`` class.
        trust_payload: if set to ``False`` (the default),
            :class:`.ScheduleBlock` objects in the payload that were
            serialized using ``sympy`` are not allowed and will error. This
            is because the ``sympy`` parsing uses :func:`eval`, which
            can allow for arbitrary code execution.
            The flag should only be set
            to ``True`` if you trust the QPY payload you are loading.

    .. warning::

        If ``trust_payload`` is set to ``True`` this can enable arbitrary
        code execution because internally ``sympy`` relies on :func:`eval`.

    Returns:
        The list of Qiskit programs contained in the QPY data.
        A list is always returned, even if there is only 1 program in the QPY data.

    Raises:
        QiskitError: if ``file_obj`` is not a valid QPY file
        TypeError: When invalid data type is loaded.
    z!6sBr)rz#The QPY format version being read, zh, isn't supported by this Qiskit version. Please upgrade your version of Qiskit to load this QPY payload
QISKITz"Input file is not a valid QPY filec,g|]}t|Sr,r-r.s  rr1zload..KsTTTQ#a&&TTTrr2r3r4z;The qiskit version used to generate the provided QPY file, c,g|]}t|Sr,)strr.s  rr1zload..\s>>>!s1vv>>>rz+, is newer than the current qiskit version zj. This may result in an error if the QPY file uses instructions not present in this current qiskit versionFaPulse gates deserialization is deprecated as of Qiskit 1.3 and will be removed in Qiskit 2.0. This is part of the deprecation plan for the entire Qiskit Pulse package. Once Pulse is removed, `ScheduleBlock` sections will be ignored when loading QPY files with pulse data.r5z"Invalid payload format data kind 'z'.)rbr$trust_input).rNunpackreadseekrrErrFILE_HEADER_makeFILE_HEADER_PACKFILE_HEADER_SIZEFILE_HEADER_V10rPFILE_HEADER_V10_SIZEprefacedecodeENCODErHrIrrJrK
major_version
minor_version
patch_versionrTrUjoinqpy_versionrr?r@
read_type_keysymbolic_encodingrL	SYMENGINErread_circuitrBread_schedule_blockrrDrangenum_programsappend)
r!rbrdr&datar\env_qiskit_versionqiskit_versionrZr$loaderr_s
             rloadrsDmFHMM!$4$455a8GMM!###
b'
b
b
b

	

||"((M(

g677



&,,M,

g:;;



|6=))X55>???)00==MTT-*=*=i*H*H*N*Ns*S*STTT($*PQN	1q 111q!^A%666>!;LOabcOd;d;d
q!^A%666q!%7%:::q!$6q$999	

XX>>~>>>??

8C


	
	
	
!$,'11"

.)2K2UU
9$,,,'	Y&5	5	5.
7O	
	
	
	
	
IXIIIJJJH
4$
%
%	
	
F &;+)


	
	
	
	
Or)
rr r!rr"r#r$r%r&r')NF)r!rrbrcrdr%rerf),__doc__
__future__rjsonrrtypingrrrr	r
collections.abcrrNrTreqiskit.circuitrqiskit.pulser
qiskit.exceptionsr
qiskit.qpyrrrrqiskit.qpy.exceptionsrrqiskit.versionrqiskit.utils.deprecate_pulserQPY_SUPPORTED_TYPESVERSION_PATTERNcompileVERBOSE
IGNORECASErHrErarr,rrrs('""""""))))))))88888888888888$$$$$$



				))))))&&&&&&))))))<<<<<<<<<<<<NNNNNNNN&&&&&&<<<<<<NM9:
D#
?BJ4NOOC448<%Y
Y
Y
Y

Y
|:>YYYYYYYr