feat: Bootstrap experimental, toggleable high-performance backend for Quil programs.

.gitignore

@@ -53,6 +53,7 @@ coverage.xml
 *,cover
 .hypothesis/
 .pytest_cache/
+prof/
 
 # Translations
 *.mo
@@ -189,3 +190,8 @@ fabric.properties
 
 
 node_modules/
+
+
+# Added by cargo
+
+/target

Makefile

@@ -90,3 +90,8 @@ docs/quil/grammars/Quil.g4:
 .PHONY: generate-parser
 generate-parser: docs/quil/grammars/Quil.g4
 	cd docs/quil/grammars && antlr -Dlanguage=Python3 -o ../../../pyquil/_parser/gen3 Quil.g4
+
+.PHONY: benchmark
+benchmark:
+	pytest -v test/bench --benchmark-only --profile
+

pyproject.toml

@@ -1,3 +1,19 @@
+[project]
+name = "pyquil"
+requires-python = ">=3.8"
+classifiers = [
+    "Programming Language :: Rust",
+    "Programming Language :: Python :: Implementation :: CPython",
+    "Programming Language :: Python :: Implementation :: PyPy",
+    "Development Status :: 5 - Production/Stable",
+    "License :: OSI Approved :: Apache Software License",
+    "Programming Language :: Python :: 3.8",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+]
+
 [tool.poetry]
 name = "pyquil"
 version = "4.10.1"
@@ -12,7 +28,6 @@ classifiers = [
   "License :: OSI Approved :: Apache Software License",
   "Programming Language :: Python :: 3.8",
   "Programming Language :: Python :: 3.9",
-  "Operating System :: OS Independent",
 ]
 keywords = ["quantum", "quil", "programming", "hybrid"]
 packages = [{ include = "pyquil" }]
@@ -31,6 +46,8 @@ tenacity = "^8.2.2"
 types-python-dateutil = "^2.8.19"
 types-retry = "^0.9.9"
 packaging = "^23.1"
+deprecated = "^1.2.13"
+types-deprecated = "^1.2.9.2"
 
 # latex extra
 ipython = { version = "^7.21.0", optional = true }
@@ -44,24 +61,24 @@ pandoc = {version = "2.4b0", optional = true}
 matplotlib = {version = "^3.7.1", optional = true}
 matplotlib-inline = {version = "^0.1.6", optional = true}
 seaborn = {version = "^0.12.2", optional = true}
-deprecated = "^1.2.13"
-types-deprecated = "^1.2.9.2"
 
 [tool.poetry.dev-dependencies]
 black = "^22.8.0"
 flake8 = "^3.8.1"
 pytest = "^7.4.0"
 pytest-cov = "^4.1.0"
 mypy = "^1.5.0"
+ruff = "^0.3.2"
 toml = "^0.10.2"
 pytest-xdist = "^3.3.1"
 pytest-rerunfailures = "^12.0.0"
 pytest-timeout = "^1.4.2"
 pytest-mock = "^3.11.1"
+pytest-benchmark = "^4.0.0"
+pytest-profiling = "^1.7.0"
 respx = "^0.20"
-nest-asyncio = "^1.5.6"
-mock = { version = "^4.0", python = "<3.8" }
 syrupy = "^3.0.6"
+maturin = "^1.5.0"
 
 [tool.poetry.extras]
 latex = ["ipython"]
@@ -71,9 +88,6 @@ docs = ["Sphinx", "sphinx-rtd-theme", "nbsphinx", "recommonmark", "pandoc", "mat
 setuptools = {version = "^69.0.2", python = ">=3.12"}
 mypy = "^1.8.0"
 
-[tool.ruff]
-line-length = 120
-
 [tool.black]
 line-length = 120
 target-version = ['py38']
@@ -99,6 +113,61 @@ exclude = '''
 )
 '''
 
+[tool.ruff]
+# Exclude a variety of commonly ignored directories.
+exclude = [
+    ".bzr",
+    ".direnv",
+    ".eggs",
+    ".git",
+    ".git-rewrite",
+    ".hg",
+    ".ipynb_checkpoints",
+    ".mypy_cache",
+    ".nox",
+    ".pants.d",
+    ".pyenv",
+    ".pytest_cache",
+    ".pytype",
+    ".ruff_cache",
+    ".svn",
+    ".tox",
+    ".venv",
+    ".vscode",
+    "__pypackages__",
+    "_build",
+    "buck-out",
+    "build",
+    "dist",
+    "node_modules",
+    "site-packages",
+    "venv",
+]
+# Same as Black.
+line-length = 120
+indent-width = 4
+# Assume Python 3.8
+target-version = "py38"
+
+[tool.ruff.lint]
+select = ["D", "E4", "E7", "E9", "F", "I", "B", "S", "W"]
+ignore = []
+# Allow fix for all enabled rules (when `--fix`) is provided.
+fixable = ["ALL"]
+unfixable = []
+# Allow unused variables when underscore-prefixed.
+dummy-variable-rgx = "^(_+|(_+[a-zA-Z0-9_]*[a-zA-Z0-9]+?))$"
+
+[tool.ruff.format]
+# Like Black, use double quotes for strings.
+quote-style = "double"
+# Like Black, indent with spaces, rather than tabs.
+indent-style = "space"
+# Like Black, respect magic trailing commas.
+skip-magic-trailing-comma = false
+# Like Black, automatically detect the appropriate line ending.
+line-ending = "auto"
+
 [tool.pytest.ini_options]
 filterwarnings = ["ignore::DeprecationWarning:pyquil.*:", "ignore::DeprecationWarning:test.unit.*:"]
 

pyquil/__init__.py

@@ -1,5 +1,14 @@
+import os
+
 from pyquil._version import pyquil_version
-from pyquil.quil import Program
-from pyquil.api import list_quantum_computers, get_qc
+from pyquil.api import get_qc, list_quantum_computers
+
+if os.environ.get("PYQUIL_EXPERIMENTAL_BACKEND", False):
+    from pyquil._core import *
+    from pyquil._core.program import Program
+else:
+    from pyquil.quil import Program
 
 __version__ = pyquil_version
+
+__all__ = ["__version__", "Program", "get_qc", "list_quantum_computers"]