libqasm 0.5.2__cp311-cp311-macosx_10_10_universal2.whl → 0.6.1__cp311-cp311-macosx_10_10_universal2.whl

{libqasm-0.5.2.dist-info → libqasm-0.6.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: libqasm
-Version: 0.5.2
+Version: 0.6.1
 Summary: libQasm Python Package
 Home-page: https://github.com/QuTech-Delft/libqasm
 Author: QuTech, TU Delft
@@ -9,48 +9,38 @@ Classifier: Operating System :: POSIX :: Linux
 Classifier: Operating System :: MacOS
 Classifier: Operating System :: Microsoft :: Windows
 Classifier: Programming Language :: Python :: 3 :: Only
-Classifier: Programming Language :: Python :: 3.5
-Classifier: Programming Language :: Python :: 3.6
-Classifier: Programming Language :: Python :: 3.7
-Classifier: Programming Language :: Python :: 3.8
 Classifier: Topic :: Scientific/Engineering
 Description-Content-Type: text/markdown
 License-File: LICENSE.md
 Requires-Dist: numpy
 
-# libQASM: Library to parse cQASM v1.0 files
+# 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/)
-[![Anaconda](https://anaconda.org/qutech/libqasm/badges/version.svg)](https://anaconda.org/qutech/libqasm/)
-[![API docs](https://readthedocs.org/projects/libqasm/badge/?version=latest)](https://libqasm.readthedocs.io/en/latest/)
 
 ## File organization
 
-The original paper and BNF specification for the cQASM v1.0 are located in the `doc/v10` directory.
-Please note however that the language has changed to some degree since then,
-and the `qasm.bnf` has never fully corresponded with the flex/bison grammar.
+For development, see:
 
-There are currently two C++ API versions contained in this repository:
-a new API (v1.2) and the original API (v1.0) maintained for backward compatibility purposes.
-The new API lives in `v1x` directories, and the older API in `v10` directories.
+- `include`: public headers.
+- `src`: source files.
+- `test`: test files.
+- `python`: SWIG interface.
+- `res`: resource files, for testing.
 
-- `src/v1x`: sources of the new API, and the grammar files for flex/bison.
-- `include/v1x`: headers of the new API.
-- `include/v10`: compatibility layer for the original API, now built on top of the new API instead of the original flex/bison parser.
-- `test/v1x`: tests for the new API.
-- `test/v10`: tests for the original API, as well as its Python bindings.
+For build process, continuous integration, and documentation:
 
-The following folders may be generated:
+- `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/<build type>`: the C++ library output files generated by Conan.<br/>
-- `pybuild`: the Python library output files generated by `setup.py`.
-
-### WIP: cQASM v3.0
+Build outputs may go into:
 
-We have started working on the parsing of cQASM v3.0 files, and that's why you will also see some `v3x` folders around.
-
-However, the development of the new parser is still in a very early stage so its use through the API is completely unsupported.
+- `build/<build type>`: the C++ library output files generated by Conan.
+- `pybuild`: the Python library output files generated by `setup.py`.
 
 ## Dependencies
 
@@ -62,12 +52,10 @@ However, the development of the new parser is still in a very early stage so its
   
 ### ARM specific dependencies
 
-We are having problems when using the `m4` and `zulu-opendjk` Conan packages on an ARMv8 architecture.
-`m4` is required by Flex/Bison and `zulu-openjdk` provides the Java JRE required by the ANTLR generator.
-So, for the time being, we are installing Flex/Bison and Java manually for this platform.
+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.
 
-* `Flex` >= 2.6.4
-* `Bison` >= 3.0
 * `Java JRE` >= 11
 
 ## Build
@@ -81,7 +69,7 @@ The installation of dependencies, as well as the compilation, can be done in one
 git clone https://github.com/QuTech-Delft/libqasm.git
 cd libqasm
 conan profile detect
-conan build . -pr=conan/profiles/tests-debug -b missing
+conan build . -pr:a=conan/profiles/tests-debug -b missing
 ```
 
 Notice:
@@ -104,16 +92,14 @@ All the profiles set the C++ standard to 20. All the `tests` profiles enable Add
 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/*:asan_enabled=True -o libqasm/*:build_tests=True -o libqasm/*:compat=False -b missing
+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/*:asan_enabled={True,False}`: enables Address Sanitizer.
-- `libqasm/*:compat={True,False}`: enables installation of the headers for the original API,
-on top of the ones for the new API.
 - `libqasm/*:shared={True,False}`: builds a shared object library instead of a static library, if applicable.
 
 ## Install
@@ -126,13 +112,6 @@ Install from the project root directory as follows:
 python3 -m pip install --verbose .
 ```
 
-or if you'd rather use conda:
-
-```
-conda build python/conda
-conda install libqasm --use-local
-```
-
 You can test if it works by running:
 
 ```
@@ -144,7 +123,7 @@ python3 -m pytest
 The `CMakeLists.txt` file in the root directory includes install targets:
 
 ```
-conan create --version 0.4.1 . -pr=tests-debug -b missing
+conan create --version 0.5.2 . -pr=tests-debug -b missing
 ```
 
 You can test if it works by doing:
@@ -176,10 +155,8 @@ target_include_directories(<your target> SYSTEM PRIVATE "${cqasm_SOURCE_DIR}/inc
 target_link_libraries(<your target> PUBLIC cqasm)
 ```
 
-Note that the following dependencies are required for `libqasm` to build:
+Note that the following dependency is required for `libqasm` to build:
 
-* `Flex` >= 2.6.4
-* `Bison` >= 3.0
 * `Java JRE` >= 11
 
 The original API headers are *not* included by default.
@@ -199,3 +176,15 @@ If you are having trouble with this just create new clone of this repository usi
 ```
 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.1.dist-info/RECORD

@@ -0,0 +1,16 @@
+cqasm/__init__.py,sha256=MsSFjiLMLJZ7QhUPpVBWKiyDnCzryquRyr329NoCACI,2
+cqasm/v3x/__init__.py,sha256=vZyVREhVeJdxipgSMSHGhKfyg70x1ISKn1v2bFO2734,2785
+cqasm/v3x/ast.py,sha256=bo4yd7N9LMdvo63xNF1kfm_xpdZ74y9B6wQ3URmV0J0,412186
+cqasm/v3x/instruction.py,sha256=AEOwKV2riafpyTiJvgq7azwOhyhhZfpKV12uWWJ5M2A,1177
+cqasm/v3x/primitives.py,sha256=ESCsMHP1GeuKh2gHQSP0ha24Abp453U-I7JSGK9dZas,1664
+cqasm/v3x/semantic.py,sha256=8zWB24LKxPymLW4lPgxmURGol2LXh7mqBKtZWo1GNKs,86535
+cqasm/v3x/types.py,sha256=NBp3uh23nnGNzKHtOrJBafDJ2wKqhQJ5eJSJtsr0uMk,51593
+cqasm/v3x/values.py,sha256=YY_41YQ7iU2te7FqtstGnQJd4W3CFH7LmkawSKh5e_A,61680
+libQasm/__init__.py,sha256=qxoyhS4wo8oA5cwO4IIbrLuCHztOJAT2MrpCOR2mSF4,727
+libQasm/_libQasm.cpython-311-darwin.so,sha256=CODVlnyi06Ew1KhEpOg_lTS77uScdk7gomU1eLf6f2o,4124320
+libQasm/libQasm.py,sha256=hzX-iSOvyoM2FBHbKvvol76Mt1lS2F3FweDm37Y-3RM,30595
+libqasm-0.6.1.dist-info/LICENSE.md,sha256=duRlJgy46W8Cw_IQjOmud5xJUvgJkX6pkBmBJkoKi4I,566
+libqasm-0.6.1.dist-info/METADATA,sha256=WUEIXx7Eg87TjR5_nhpinoZabjgveZU129_d1QZAXxc,5913
+libqasm-0.6.1.dist-info/WHEEL,sha256=4F58ZCesPOUjwzTHMKuwuydHHOQLmBKJtTM5AtvBHqQ,116
+libqasm-0.6.1.dist-info/top_level.txt,sha256=w7QwYbOjqjU8FE8PSUGSKMILn4kqQEJWKNLvab5ehEg,14
+libqasm-0.6.1.dist-info/RECORD,,

{libqasm-0.5.2.dist-info → libqasm-0.6.1.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: bdist_wheel (0.42.0)
+Generator: bdist_wheel (0.43.0)
 Root-Is-Purelib: false
 Tag: cp311-cp311-macosx_10_10_universal2
 

cqasm/v1x/__init__.py

@@ -1,65 +0,0 @@
-import cqasm.v1x.ast as ast
-import cqasm.v1x.semantic as semantic
-import libQasm
-
-
-class Analyzer(libQasm.V1xAnalyzer):
-    # parse_file and parse_string are static methods because they do not change the status of the analyzer
-    # Instead, they just invoke free functions that create a temporary instance of a parser
-    # analyze_file and analyze_string are not static methods because they change the status of the analyzer
-
-    # parse_file, parse_string, analyze_file, and analyze_string return a vector of strings
-    # If the length of the vector is 1, the string is a serialization of the AST
-    # Otherwise, it is a list of errors
-
-    @staticmethod
-    def parse_file(*args):
-        ret = libQasm.V1xAnalyzer.parse_file(*args)
-        if len(ret) == 1:
-            serialized_ast_str = str(ret[0])
-            serialized_ast_bytes = serialized_ast_str.encode(encoding='utf-8', errors="surrogateescape")
-            deserialized_ast = ast.Root.deserialize(serialized_ast_bytes)
-            return deserialized_ast
-        return [str(error) for error in ret[1:]]
-
-    @staticmethod
-    def parse_string(*args):
-        ret = libQasm.V1xAnalyzer.parse_string(*args)
-        if len(ret) == 1:
-            serialized_ast_str = str(ret[0])
-            serialized_ast_bytes = serialized_ast_str.encode(encoding='utf-8', errors="surrogateescape")
-            deserialized_ast = ast.Root.deserialize(serialized_ast_bytes)
-            return deserialized_ast
-        return [str(error) for error in ret[1:]]
-
-    def analyze_file(self, *args):
-        ret = super().analyze_file(*args)
-        if len(ret) == 1:
-            serialized_ast_str = str(ret[0])
-            serialized_ast_bytes = serialized_ast_str.encode(encoding='utf-8', errors="surrogateescape")
-            deserialized_ast = semantic.Program.deserialize(serialized_ast_bytes)
-            return deserialized_ast
-        return [str(error) for error in ret[1:]]
-
-    def analyze_string(self, *args):
-        ret = super().analyze_string(*args)
-        if len(ret) == 1:
-            serialized_ast_str = str(ret[0])
-            serialized_ast_bytes = serialized_ast_str.encode(encoding='utf-8', errors="surrogateescape")
-            deserialized_ast = semantic.Program.deserialize(serialized_ast_bytes)
-            return deserialized_ast
-        return [str(error) for error in ret[1:]]
-
-    @staticmethod
-    def parse_file_to_json(*args):
-        return libQasm.V1xAnalyzer.parse_file_to_json(*args)
-
-    @staticmethod
-    def parse_string_to_json(*args):
-        return libQasm.V1xAnalyzer.parse_string_to_json(*args)
-
-    def analyze_file_to_json(self, *args):
-        return super().analyze_file_to_json(*args)
-
-    def analyze_string_to_json(self, *args):
-        return super().analyze_string_to_json(*args)