automatic import of python-jaqalpaq

1 files changed, 596 insertions, 0 deletions

diff --git a/python-jaqalpaq.spec b/python-jaqalpaq.spec
new file mode 100644
index 0000000..5cec47e
--- /dev/null
+++ b/python-jaqalpaq.spec
@@ -0,0 +1,596 @@
+%global _empty_manifest_terminate_build 0
+Name:		python-JaqalPaq
+Version:	1.1.1
+Release:	1
+Summary:	Python tools for Jaqal
+License:	Apache
+URL:		https://qscout.sandia.gov
+Source0:	https://mirrors.nju.edu.cn/pypi/web/packages/d5/77/67bca74ef0dc0595e742337465aa3d373194404288bd723c0f4c4dc85e67/JaqalPaq-1.1.1.tar.gz
+BuildArch:	noarch
+
+Requires:	python3-sly
+Requires:	python3-Sphinx
+Requires:	python3-sphinx-rtd-theme
+Requires:	python3-JaqalPaq[pygsti-integration]
+Requires:	python3-JaqalPaq-extras[projectq,pyquil,pytket,qiskit]
+Requires:	python3-openfermion
+Requires:	python3-pyscf
+Requires:	python3-openfermionpyscf
+Requires:	python3-h5py
+Requires:	python3-pyGSTi
+Requires:	python3-pytest
+
+%description
+JaqalPaq is a python package used to parse, manipulate, emulate, and generate
+quantum assembly code written in [Jaqal](https://qscout.sandia.gov/jaqal)
+(Just another quantum assembly language).  JaqalPaq can be installed with
+optional transpilers that convert code written in other quantum assembly
+languages to a version of Jaqal whose native gates are relevant for
+[QSCOUT](https://qscout.sandia.gov/) (Quantum Scientific Computing Open User
+Testbed).
+## Code
+JaqalPaq is available on [GitLab](https://gitlab.com/jaqal/jaqalpaq) under
+the Apache 2.0 License.
+## Installation
+> **TLDR**: Inside a venv/conda env:
+>
+> ```bash
+> pip install --upgrade Cython numpy pip wheel
+> pip install ipykernel JaqalPaq'[pygsti-integration]' QSCOUT-gatemodels
+> ipython kernel install --name=jaqal --user
+> ```
+### Step 0: Prepare base dependencies
+JaqalPaq requires Python 3.6 (or later), but Python 3.7 (or later) is
+recommended.  To check your installed version, run
+```bash
+python3 --version
+```
+Windows users are encouraged to install under WSL2.  You may also consider
+[conda](https://conda.io), which provides a platform-independent Python
+installation.
+We also recommend having a functional C compiler and Python headers installed.
+Depending on your Python version and platform, this may be entirely
+unneccessary.  You can confirm the presence of these headers by running
+```bash
+python3-config --includes
+```
+When properly configured, this will output a list of include directives that
+will be passed to your compiler, e.g.,
+```
+-I/usr/include/python3.6m
+```
+On apt-based systems, these dependencies can be installed by running (as root)
+```bash
+apt install python3-dev build-essential
+```
+On rpm-based ones,
+```bash
+yum install python3-devel gcc gcc-c++
+```
+Mac users may need to install XCode to ensure they have a functional C++
+compiler.  Similarly Windows users may need to install VS build tools.
+Conda users should have these header files and compilers installed
+automatically.
+### Step 1: (recommended) Prepare a virtual environment
+> **WARNING**: JaqalPaq's dependencies may sometimes conflict with each other.
+> Upgrading may introduce incompatible versions, and for this reason we
+> STRONGLY recommend installing within some kind of virtual environment.
+To create a Python virtual environment, run
+```bash
+python3 -m venv /path/to/venv
+```
+The location of the venv is left to your discretion, but please be aware that
+a full installation will be ~100s of megabytes.
+To create a conda virtual environment, run
+```bash
+conda create --name your-preferred-name python=3.9
+```
+To enter the virtual environment, run
+```bash
+source /path/to/venv/bin/activate
+```
+or
+```bash
+conda activate your-preferred-name
+```
+respectively.
+> **NOTE**: All following steps should be performed inside the virtual
+> environment.  If you close your terminal, you will have to enter the virtual
+> environment again, using the appropriate command above.
+If you are using a venv, upgrade pip and install wheel:
+```bash
+pip install --upgrade pip wheel
+```
+[Jupyter](https://jupyter.org/) users can install a kernel to access this
+virtual environment by running
+```bash
+pip install ipykernel
+ipython kernel install --name=preferred-name --user
+```
+> **NOTE**: Restart the Jupyter server.  A new kernel will be available.
+If you no longer want that kernel, you can remove it with
+```bash
+jupyter kernelspec remove pip-jaqal
+```
+> **NOTE**: Unlike every other command, this must be performed from the
+> environment in which Jupyter is installed, and NOT the JaqalPaq environment.
+### Step 2: Install JaqalPaq and friends
+JaqalPaq packages are provided with [pip](https://pip.pypa.io/en/stable/).
+> **WARNING**: Some dependencies may conflict with each other.  Be sure to
+> include all desired dependencies on this line.  It is safe to re-run the
+> whole command with a new desired feature set.
+```bash
+pip install JaqalPaq'[pygsti-integration,notebooks]' QSCOUT-gatemodels \
+    JaqalPaq-extras'[qiskit,pyquil,cirq,projectq,pytket,tutorial]'
+```
+ - `pygsti-integration` provides the emulator.
+ - `notebooks` installs all dependencies for the chemistry example notebook
+ - `QSCOUT-gatemodels` provides the native gates of the
+   [QSCOUT](https://qscout.sandia.gov/) project , which are modeled as
+   pure-state  preparations, unitary transformations, and destructive
+   measurements. See
+   [QSCOUT-gatemodels](https://pypi.org/project/QSCOUT-gatemodels/) for
+   details.
+ - The five transpiler targets for JaqalPaq-extras each install a compatible
+   version of the respective third-party package.
+ - `tutorial` installs an additional dependency required for the
+   JaqalPaq-extras tutorial notebook to run.
+> **NOTE**: The `notebooks`, `qiskit`, `pyquil`, `cirq`, `projectq`, `pytket`,
+> and `tutorial` targets will install a large number of third-party packages.
+> You should consider only installing the subset of these packages that you
+> plan on using.
+## Usage
+The following simple example is from `examples/usage_example.py`
+```python
+import jaqalpaq
+from jaqalpaq.parser import parse_jaqal_file
+from jaqalpaq.emulator import run_jaqal_circuit
+from jaqalpaq.generator import generate_jaqal_program
+JaqalCircuitObject = parse_jaqal_file("jaqal/Sxx_circuit.jaqal")
+JaqalCircuitResults = run_jaqal_circuit(JaqalCircuitObject)
+print(f"Probabilities: {JaqalCircuitResults.subcircuits[0].probability_by_str}")
+JaqalProgram = generate_jaqal_program(JaqalCircuitObject)
+```
+The Jaqal file processed by this example, `examples/jaqal/Sxx_circuit.jaqal`, is
+```python
+from qscout.v1.std usepulses *
+register q[2]
+prepare_all
+Sxx q[1] q[0]
+measure_all
+```
+More extensive examples, including detailed Jupyter notebooks implementing the
+variational quantum eigensolver (VQE) quantum algorithm for some simple
+molecules, can be found in the `examples` directory.
+For information on the JaqalPaq emulator's command-line interface, run the
+following in your shell:
+```bash
+jaqal-emulate --help
+```
+## Testing and examples
+Underneath your environment prefix, navigate to `share/jaqalpaq`.  Inside a
+venv, run
+```bash
+cd "$VIRTUAL_ENV/share/jaqalpaq"
+```
+or, inside a conda environment,
+```bash
+cd "$CONDA_PREFIX/share/jaqalpaq"
+```
+Example Jaqal files, as well as tutorials and example quantum chemistry
+calculations are in the `examples/` directory.  To run the tests, first
+install pytest,
+```bash
+pip install pytest
+```
+and then run it on the `tests/` directory:
+```bash
+pytest tests
+```
+## Documentation
+Online documentation is hosted on [Read the Docs](https://jaqalpaq.readthedocs.io).
+## License
+[Apache 2.0](https://choosealicense.com/licenses/apache-2.0/)
+## Questions?
+For help and support, please contact [qscout@sandia.gov](mailto:qscout@sandia.gov).
+
+%package -n python3-JaqalPaq
+Summary:	Python tools for Jaqal
+Provides:	python-JaqalPaq
+BuildRequires:	python3-devel
+BuildRequires:	python3-setuptools
+BuildRequires:	python3-pip
+%description -n python3-JaqalPaq
+JaqalPaq is a python package used to parse, manipulate, emulate, and generate
+quantum assembly code written in [Jaqal](https://qscout.sandia.gov/jaqal)
+(Just another quantum assembly language).  JaqalPaq can be installed with
+optional transpilers that convert code written in other quantum assembly
+languages to a version of Jaqal whose native gates are relevant for
+[QSCOUT](https://qscout.sandia.gov/) (Quantum Scientific Computing Open User
+Testbed).
+## Code
+JaqalPaq is available on [GitLab](https://gitlab.com/jaqal/jaqalpaq) under
+the Apache 2.0 License.
+## Installation
+> **TLDR**: Inside a venv/conda env:
+>
+> ```bash
+> pip install --upgrade Cython numpy pip wheel
+> pip install ipykernel JaqalPaq'[pygsti-integration]' QSCOUT-gatemodels
+> ipython kernel install --name=jaqal --user
+> ```
+### Step 0: Prepare base dependencies
+JaqalPaq requires Python 3.6 (or later), but Python 3.7 (or later) is
+recommended.  To check your installed version, run
+```bash
+python3 --version
+```
+Windows users are encouraged to install under WSL2.  You may also consider
+[conda](https://conda.io), which provides a platform-independent Python
+installation.
+We also recommend having a functional C compiler and Python headers installed.
+Depending on your Python version and platform, this may be entirely
+unneccessary.  You can confirm the presence of these headers by running
+```bash
+python3-config --includes
+```
+When properly configured, this will output a list of include directives that
+will be passed to your compiler, e.g.,
+```
+-I/usr/include/python3.6m
+```
+On apt-based systems, these dependencies can be installed by running (as root)
+```bash
+apt install python3-dev build-essential
+```
+On rpm-based ones,
+```bash
+yum install python3-devel gcc gcc-c++
+```
+Mac users may need to install XCode to ensure they have a functional C++
+compiler.  Similarly Windows users may need to install VS build tools.
+Conda users should have these header files and compilers installed
+automatically.
+### Step 1: (recommended) Prepare a virtual environment
+> **WARNING**: JaqalPaq's dependencies may sometimes conflict with each other.
+> Upgrading may introduce incompatible versions, and for this reason we
+> STRONGLY recommend installing within some kind of virtual environment.
+To create a Python virtual environment, run
+```bash
+python3 -m venv /path/to/venv
+```
+The location of the venv is left to your discretion, but please be aware that
+a full installation will be ~100s of megabytes.
+To create a conda virtual environment, run
+```bash
+conda create --name your-preferred-name python=3.9
+```
+To enter the virtual environment, run
+```bash
+source /path/to/venv/bin/activate
+```
+or
+```bash
+conda activate your-preferred-name
+```
+respectively.
+> **NOTE**: All following steps should be performed inside the virtual
+> environment.  If you close your terminal, you will have to enter the virtual
+> environment again, using the appropriate command above.
+If you are using a venv, upgrade pip and install wheel:
+```bash
+pip install --upgrade pip wheel
+```
+[Jupyter](https://jupyter.org/) users can install a kernel to access this
+virtual environment by running
+```bash
+pip install ipykernel
+ipython kernel install --name=preferred-name --user
+```
+> **NOTE**: Restart the Jupyter server.  A new kernel will be available.
+If you no longer want that kernel, you can remove it with
+```bash
+jupyter kernelspec remove pip-jaqal
+```
+> **NOTE**: Unlike every other command, this must be performed from the
+> environment in which Jupyter is installed, and NOT the JaqalPaq environment.
+### Step 2: Install JaqalPaq and friends
+JaqalPaq packages are provided with [pip](https://pip.pypa.io/en/stable/).
+> **WARNING**: Some dependencies may conflict with each other.  Be sure to
+> include all desired dependencies on this line.  It is safe to re-run the
+> whole command with a new desired feature set.
+```bash
+pip install JaqalPaq'[pygsti-integration,notebooks]' QSCOUT-gatemodels \
+    JaqalPaq-extras'[qiskit,pyquil,cirq,projectq,pytket,tutorial]'
+```
+ - `pygsti-integration` provides the emulator.
+ - `notebooks` installs all dependencies for the chemistry example notebook
+ - `QSCOUT-gatemodels` provides the native gates of the
+   [QSCOUT](https://qscout.sandia.gov/) project , which are modeled as
+   pure-state  preparations, unitary transformations, and destructive
+   measurements. See
+   [QSCOUT-gatemodels](https://pypi.org/project/QSCOUT-gatemodels/) for
+   details.
+ - The five transpiler targets for JaqalPaq-extras each install a compatible
+   version of the respective third-party package.
+ - `tutorial` installs an additional dependency required for the
+   JaqalPaq-extras tutorial notebook to run.
+> **NOTE**: The `notebooks`, `qiskit`, `pyquil`, `cirq`, `projectq`, `pytket`,
+> and `tutorial` targets will install a large number of third-party packages.
+> You should consider only installing the subset of these packages that you
+> plan on using.
+## Usage
+The following simple example is from `examples/usage_example.py`
+```python
+import jaqalpaq
+from jaqalpaq.parser import parse_jaqal_file
+from jaqalpaq.emulator import run_jaqal_circuit
+from jaqalpaq.generator import generate_jaqal_program
+JaqalCircuitObject = parse_jaqal_file("jaqal/Sxx_circuit.jaqal")
+JaqalCircuitResults = run_jaqal_circuit(JaqalCircuitObject)
+print(f"Probabilities: {JaqalCircuitResults.subcircuits[0].probability_by_str}")
+JaqalProgram = generate_jaqal_program(JaqalCircuitObject)
+```
+The Jaqal file processed by this example, `examples/jaqal/Sxx_circuit.jaqal`, is
+```python
+from qscout.v1.std usepulses *
+register q[2]
+prepare_all
+Sxx q[1] q[0]
+measure_all
+```
+More extensive examples, including detailed Jupyter notebooks implementing the
+variational quantum eigensolver (VQE) quantum algorithm for some simple
+molecules, can be found in the `examples` directory.
+For information on the JaqalPaq emulator's command-line interface, run the
+following in your shell:
+```bash
+jaqal-emulate --help
+```
+## Testing and examples
+Underneath your environment prefix, navigate to `share/jaqalpaq`.  Inside a
+venv, run
+```bash
+cd "$VIRTUAL_ENV/share/jaqalpaq"
+```
+or, inside a conda environment,
+```bash
+cd "$CONDA_PREFIX/share/jaqalpaq"
+```
+Example Jaqal files, as well as tutorials and example quantum chemistry
+calculations are in the `examples/` directory.  To run the tests, first
+install pytest,
+```bash
+pip install pytest
+```
+and then run it on the `tests/` directory:
+```bash
+pytest tests
+```
+## Documentation
+Online documentation is hosted on [Read the Docs](https://jaqalpaq.readthedocs.io).
+## License
+[Apache 2.0](https://choosealicense.com/licenses/apache-2.0/)
+## Questions?
+For help and support, please contact [qscout@sandia.gov](mailto:qscout@sandia.gov).
+
+%package help
+Summary:	Development documents and examples for JaqalPaq
+Provides:	python3-JaqalPaq-doc
+%description help
+JaqalPaq is a python package used to parse, manipulate, emulate, and generate
+quantum assembly code written in [Jaqal](https://qscout.sandia.gov/jaqal)
+(Just another quantum assembly language).  JaqalPaq can be installed with
+optional transpilers that convert code written in other quantum assembly
+languages to a version of Jaqal whose native gates are relevant for
+[QSCOUT](https://qscout.sandia.gov/) (Quantum Scientific Computing Open User
+Testbed).
+## Code
+JaqalPaq is available on [GitLab](https://gitlab.com/jaqal/jaqalpaq) under
+the Apache 2.0 License.
+## Installation
+> **TLDR**: Inside a venv/conda env:
+>
+> ```bash
+> pip install --upgrade Cython numpy pip wheel
+> pip install ipykernel JaqalPaq'[pygsti-integration]' QSCOUT-gatemodels
+> ipython kernel install --name=jaqal --user
+> ```
+### Step 0: Prepare base dependencies
+JaqalPaq requires Python 3.6 (or later), but Python 3.7 (or later) is
+recommended.  To check your installed version, run
+```bash
+python3 --version
+```
+Windows users are encouraged to install under WSL2.  You may also consider
+[conda](https://conda.io), which provides a platform-independent Python
+installation.
+We also recommend having a functional C compiler and Python headers installed.
+Depending on your Python version and platform, this may be entirely
+unneccessary.  You can confirm the presence of these headers by running
+```bash
+python3-config --includes
+```
+When properly configured, this will output a list of include directives that
+will be passed to your compiler, e.g.,
+```
+-I/usr/include/python3.6m
+```
+On apt-based systems, these dependencies can be installed by running (as root)
+```bash
+apt install python3-dev build-essential
+```
+On rpm-based ones,
+```bash
+yum install python3-devel gcc gcc-c++
+```
+Mac users may need to install XCode to ensure they have a functional C++
+compiler.  Similarly Windows users may need to install VS build tools.
+Conda users should have these header files and compilers installed
+automatically.
+### Step 1: (recommended) Prepare a virtual environment
+> **WARNING**: JaqalPaq's dependencies may sometimes conflict with each other.
+> Upgrading may introduce incompatible versions, and for this reason we
+> STRONGLY recommend installing within some kind of virtual environment.
+To create a Python virtual environment, run
+```bash
+python3 -m venv /path/to/venv
+```
+The location of the venv is left to your discretion, but please be aware that
+a full installation will be ~100s of megabytes.
+To create a conda virtual environment, run
+```bash
+conda create --name your-preferred-name python=3.9
+```
+To enter the virtual environment, run
+```bash
+source /path/to/venv/bin/activate
+```
+or
+```bash
+conda activate your-preferred-name
+```
+respectively.
+> **NOTE**: All following steps should be performed inside the virtual
+> environment.  If you close your terminal, you will have to enter the virtual
+> environment again, using the appropriate command above.
+If you are using a venv, upgrade pip and install wheel:
+```bash
+pip install --upgrade pip wheel
+```
+[Jupyter](https://jupyter.org/) users can install a kernel to access this
+virtual environment by running
+```bash
+pip install ipykernel
+ipython kernel install --name=preferred-name --user
+```
+> **NOTE**: Restart the Jupyter server.  A new kernel will be available.
+If you no longer want that kernel, you can remove it with
+```bash
+jupyter kernelspec remove pip-jaqal
+```
+> **NOTE**: Unlike every other command, this must be performed from the
+> environment in which Jupyter is installed, and NOT the JaqalPaq environment.
+### Step 2: Install JaqalPaq and friends
+JaqalPaq packages are provided with [pip](https://pip.pypa.io/en/stable/).
+> **WARNING**: Some dependencies may conflict with each other.  Be sure to
+> include all desired dependencies on this line.  It is safe to re-run the
+> whole command with a new desired feature set.
+```bash
+pip install JaqalPaq'[pygsti-integration,notebooks]' QSCOUT-gatemodels \
+    JaqalPaq-extras'[qiskit,pyquil,cirq,projectq,pytket,tutorial]'
+```
+ - `pygsti-integration` provides the emulator.
+ - `notebooks` installs all dependencies for the chemistry example notebook
+ - `QSCOUT-gatemodels` provides the native gates of the
+   [QSCOUT](https://qscout.sandia.gov/) project , which are modeled as
+   pure-state  preparations, unitary transformations, and destructive
+   measurements. See
+   [QSCOUT-gatemodels](https://pypi.org/project/QSCOUT-gatemodels/) for
+   details.
+ - The five transpiler targets for JaqalPaq-extras each install a compatible
+   version of the respective third-party package.
+ - `tutorial` installs an additional dependency required for the
+   JaqalPaq-extras tutorial notebook to run.
+> **NOTE**: The `notebooks`, `qiskit`, `pyquil`, `cirq`, `projectq`, `pytket`,
+> and `tutorial` targets will install a large number of third-party packages.
+> You should consider only installing the subset of these packages that you
+> plan on using.
+## Usage
+The following simple example is from `examples/usage_example.py`
+```python
+import jaqalpaq
+from jaqalpaq.parser import parse_jaqal_file
+from jaqalpaq.emulator import run_jaqal_circuit
+from jaqalpaq.generator import generate_jaqal_program
+JaqalCircuitObject = parse_jaqal_file("jaqal/Sxx_circuit.jaqal")
+JaqalCircuitResults = run_jaqal_circuit(JaqalCircuitObject)
+print(f"Probabilities: {JaqalCircuitResults.subcircuits[0].probability_by_str}")
+JaqalProgram = generate_jaqal_program(JaqalCircuitObject)
+```
+The Jaqal file processed by this example, `examples/jaqal/Sxx_circuit.jaqal`, is
+```python
+from qscout.v1.std usepulses *
+register q[2]
+prepare_all
+Sxx q[1] q[0]
+measure_all
+```
+More extensive examples, including detailed Jupyter notebooks implementing the
+variational quantum eigensolver (VQE) quantum algorithm for some simple
+molecules, can be found in the `examples` directory.
+For information on the JaqalPaq emulator's command-line interface, run the
+following in your shell:
+```bash
+jaqal-emulate --help
+```
+## Testing and examples
+Underneath your environment prefix, navigate to `share/jaqalpaq`.  Inside a
+venv, run
+```bash
+cd "$VIRTUAL_ENV/share/jaqalpaq"
+```
+or, inside a conda environment,
+```bash
+cd "$CONDA_PREFIX/share/jaqalpaq"
+```
+Example Jaqal files, as well as tutorials and example quantum chemistry
+calculations are in the `examples/` directory.  To run the tests, first
+install pytest,
+```bash
+pip install pytest
+```
+and then run it on the `tests/` directory:
+```bash
+pytest tests
+```
+## Documentation
+Online documentation is hosted on [Read the Docs](https://jaqalpaq.readthedocs.io).
+## License
+[Apache 2.0](https://choosealicense.com/licenses/apache-2.0/)
+## Questions?
+For help and support, please contact [qscout@sandia.gov](mailto:qscout@sandia.gov).
+
+%prep
+%autosetup -n JaqalPaq-1.1.1
+
+%build
+%py3_build
+
+%install
+%py3_install
+install -d -m755 %{buildroot}/%{_pkgdocdir}
+if [ -d doc ]; then cp -arf doc %{buildroot}/%{_pkgdocdir}; fi
+if [ -d docs ]; then cp -arf docs %{buildroot}/%{_pkgdocdir}; fi
+if [ -d example ]; then cp -arf example %{buildroot}/%{_pkgdocdir}; fi
+if [ -d examples ]; then cp -arf examples %{buildroot}/%{_pkgdocdir}; fi
+pushd %{buildroot}
+if [ -d usr/lib ]; then
+	find usr/lib -type f -printf "/%h/%f\n" >> filelist.lst
+fi
+if [ -d usr/lib64 ]; then
+	find usr/lib64 -type f -printf "/%h/%f\n" >> filelist.lst
+fi
+if [ -d usr/bin ]; then
+	find usr/bin -type f -printf "/%h/%f\n" >> filelist.lst
+fi
+if [ -d usr/sbin ]; then
+	find usr/sbin -type f -printf "/%h/%f\n" >> filelist.lst
+fi
+touch doclist.lst
+if [ -d usr/share/man ]; then
+	find usr/share/man -type f -printf "/%h/%f.gz\n" >> doclist.lst
+fi
+popd
+mv %{buildroot}/filelist.lst .
+mv %{buildroot}/doclist.lst .
+
+%files -n python3-JaqalPaq -f filelist.lst
+%dir %{python3_sitelib}/*
+
+%files help -f doclist.lst
+%{_docdir}/*
+
+%changelog
+* Thu May 18 2023 Python_Bot <Python_Bot@openeuler.org> - 1.1.1-1
+- Package Spec generated