libqasm 0.6.0__cp312-cp312-win_amd64.whl

libqasm-0.6.0.dist-info/LICENSE.md

@@ -0,0 +1,13 @@
+Copyright [2018] [QCA Lab, QuTech, TU Delft]
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.

libqasm-0.6.0.dist-info/METADATA

@@ -0,0 +1,190 @@
+Metadata-Version: 2.1
+Name: libqasm
+Version: 0.6.0
+Summary: libQasm Python Package
+Home-page: https://github.com/QuTech-Delft/libqasm
+Author: QuTech, TU Delft
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Topic :: Scientific/Engineering
+Description-Content-Type: text/markdown
+License-File: LICENSE.md
+Requires-Dist: numpy
+
+# libQASM: Library to parse cQASM v3.0 files
+
+[![CI](https://github.com/QuTech-Delft/libqasm/workflows/Test/badge.svg)](https://github.com/qutech-delft/libqasm/actions)
+[![PyPI](https://badgen.net/pypi/v/libqasm)](https://pypi.org/project/libqasm/)
+
+## File organization
+
+For development, see:
+
+- `include`: public headers.
+- `src`: source files.
+- `test`: test files.
+- `python`: SWIG interface.
+- `res`: resource files, for testing.
+
+For build process, continuous integration, and documentation:
+
+- `conan`: Conan profiles.
+- `emscripten`: bindings and test for the emscripten binaries.
+- `scripts`: helper scripts used during the build process.
+- `.github`: GitHub Actions configuration files.
+- `doc`: documentation.
+
+Build outputs may go into:
+
+- `build/<build type>`: the C++ library output files generated by Conan.
+- `pybuild`: the Python library output files generated by `setup.py`.
+
+## Dependencies
+
+* C++ compiler with C++20 support (gcc 11, clang 14, msvc 17)
+* `CMake` >= 3.12
+* `git`
+* `Python` 3.x plus `pip`, with the following package:
+  * `conan` >= 2.0
+  
+### ARM specific dependencies
+
+We are having problems when using the `zulu-opendjk` Conan package on an ARMv8 architecture.
+`zulu-openjdk` provides the Java JRE required by the ANTLR generator.
+So, for the time being, we are installing Java manually for this platform.
+
+* `Java JRE` >= 11
+
+## Build
+
+This version of `libqasm` can only be compiled via the Conan package manager.
+You'll need to create a default profile before using it for the first time.
+
+The installation of dependencies, as well as the compilation, can be done in one go.
+
+```
+git clone https://github.com/QuTech-Delft/libqasm.git
+cd libqasm
+conan profile detect
+conan build . -pr:a=conan/profiles/tests-debug -b missing
+```
+
+Notice:
+- the `conan profile` command only has to be run only once, and not before every build.
+- the `conan build` command is building `libqasm` in Debug mode with tests using the `tests-debug` profile.
+- the `-b missing` parameter asks `conan` to build packages from sources
+in case it cannot find the binary packages for the current configuration (platform, OS, compiler, build type...). 
+
+### Build profiles
+
+A group of predefined profiles is provided under the `conan/profiles` folder.
+They follow the `[tests-](debug|release)[-compat]` naming convention. For example:
+  - `release` is a Release build without tests and compatibility with the original API.
+  - `tests-debug-compat` is a Debug build with tests and compatibility enabled.
+
+All the profiles set the C++ standard to 20. All the `tests` profiles enable Address Sanitizer.
+
+### Build options
+
+Profiles are a shorthand for command line options. The command above could be written as well as: 
+
+```
+conan build . -s:h compiler.cppstd=20 -s:h libqasm/*:build_type=Debug -o libqasm/*:build_tests=True -o libqasm/*:asan_enabled=True -b missing
+```
+
+These are the list of options that could be specified whether in a profile or in the command line:
+
+- `libqasm/*:asan_enabled={True,False}`: enables Address Sanitizer.
+- `libqasm/*:build_tests={True,False}`: builds tests or not.
+- `libqasm/*:build_type={Debug,Release}`: builds in debug or release mode.
+- `libqasm/*:shared={True,False}`: builds a shared object library instead of a static library, if applicable.
+
+## Install
+
+### From Python
+
+Install from the project root directory as follows:
+
+```
+python3 -m pip install --verbose .
+```
+
+You can test if it works by running:
+
+```
+python3 -m pytest
+```
+
+### From C++
+
+The `CMakeLists.txt` file in the root directory includes install targets:
+
+```
+conan create --version 0.5.2 . -pr=tests-debug -b missing
+```
+
+You can test if it works by doing:
+
+```
+cd test/Debug
+ctest -C Debug --output-on-failure
+```
+
+## Use from another project
+
+### From Python
+
+After installation, you should be able to use the bindings for the original API by just `import libQasm`.
+The new API doesn't have Python bindings yet.
+
+### From C++
+
+The easiest way to use `libqasm` in a CMake project is to fetch the library and then link against it.
+
+```
+include(FetchContent)
+FetchContent_Declare(cqasm
+    GIT_REPOSITORY https://github.com/QuTech-Delft/libqasm.git
+    GIT_TAG "<a given cqasm git tag>"
+)
+FetchContent_MakeAvailable(cqasm)
+target_include_directories(<your target> SYSTEM PRIVATE "${cqasm_SOURCE_DIR}/include")
+target_link_libraries(<your target> PUBLIC cqasm)
+```
+
+Note that the following dependency is required for `libqasm` to build:
+
+* `Java JRE` >= 11
+
+The original API headers are *not* included by default.
+To enable those, pass <code><nobr>-o libqasm/*:compat=True</nobr></code> as a build option to Conan.
+
+## Docker
+
+This tests the library in a container with the bare minimum requirements for `libqasm`.
+
+```
+docker build .
+```
+
+**Note for Windows users:** The above might fail on Windows to the autocrlf transformation that git does.
+If you are having trouble with this just create new clone of this repository using:
+
+```
+git clone --config core.autocrlf=input git@github.com:QuTech-Delft/libqasm.git
+```
+
+## Emscripten
+
+The generation of emscripten binaries has been tested as a cross-compilation from an ubuntu/x64 platform.
+
+```
+conan build . -pr=conan/profiles/emscripten -pr:b=conan/profiles/release -b missing
+```
+
+The output of this build lives in `build/Release/emscripten`:
+- `cqasm_emscripten.js`.
+- `cqasm_emscripten.wasm`.

libqasm-0.6.0.dist-info/RECORD

@@ -0,0 +1,16 @@
+cqasm/__init__.py,sha256=_6Yl-eMBve0mGQA-aiFg4qvQ7GUCV5eGvIcoRf4mEPw,3
+cqasm/v3x/__init__.py,sha256=6U8aKKMEfPjZmuptOiZ3MUqJ8PL-oRkb6hdO1TeK51s,2850
+cqasm/v3x/ast.py,sha256=Eba-aqEaudn3GKDsXm-EkrVT3s_SDGUMQ8MVTIXOcBM,423200
+cqasm/v3x/instruction.py,sha256=VAOqFpCH94CrutgMUZnQq8JXFIq_-C-ndTOjHLsg6_8,1219
+cqasm/v3x/primitives.py,sha256=feY0IqRBzQOcpECaR7lX4BV38pxZY_WmQgsgLxHFzWw,2232
+cqasm/v3x/semantic.py,sha256=J5dgSs_sZE0nc7FuMuZf6r3b4cGNXrJiVDc-FMtKAQU,88893
+cqasm/v3x/types.py,sha256=mWLUtWn6MZsPmTu14X0uloC147PJxHdZQ9uQIXLNQMo,53029
+cqasm/v3x/values.py,sha256=SfKw6zIjpMrXJggvN_QGPqsoZXDR7HwUjgUMOBnIzuo,63394
+libQasm/__init__.py,sha256=2ZK4Wm7x8jrq819w9T7aHNbD598Btj-8YJzdYLaxUG8,752
+libQasm/_libQasm.cp312-win_amd64.pyd,sha256=pq08EIKUlwkbS6n-j7siTQkcAWbRfDRia-0DQ6qtqFk,2276352
+libQasm/libQasm.py,sha256=b4z05kHt-VsL2hKYcyfjCPMoJ0zj3ljPb6j_ZhJHh2E,31677
+libqasm-0.6.0.dist-info/LICENSE.md,sha256=395F6Sje50f5Too7yWFAoS_owYO4aOtjbMeQd_go_sk,579
+libqasm-0.6.0.dist-info/METADATA,sha256=XGuOsqiGzXdVSvIVKGggS9hxHuGC70_VaQmdDZbaEeM,6103
+libqasm-0.6.0.dist-info/WHEEL,sha256=fZWyj_84lK0cA-ZNCsdwhbJl0OTrpWkxInEn424qrSs,102
+libqasm-0.6.0.dist-info/top_level.txt,sha256=w7QwYbOjqjU8FE8PSUGSKMILn4kqQEJWKNLvab5ehEg,14
+libqasm-0.6.0.dist-info/RECORD,,

libqasm-0.6.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: bdist_wheel (0.43.0)
+Root-Is-Purelib: false
+Tag: cp312-cp312-win_amd64
+

libqasm-0.6.0.dist-info/top_level.txt

@@ -0,0 +1,2 @@
+cqasm
+libQasm