guppylang-internals 0.21.0__tar.gz → 0.21.1__tar.gz

guppylang_internals-0.21.1/CHANGELOG.md

@@ -0,0 +1,28 @@
+# Changelog
+
+First release of `guppylang_internals` package containing refactored out internal components
+from `guppylang`.
+
+## [0.21.1](https://github.com/CQCL/guppylang/compare/guppylang-internals-v0.21.0...guppylang-internals-v0.21.1) (2025-08-05)
+
+
+### Bug Fixes
+
+* **guppylang-internals:** Fix circular import for custom decorators ([#1146](https://github.com/CQCL/guppylang/issues/1146)) ([d8474d8](https://github.com/CQCL/guppylang/commit/d8474d8af3d394275268cd3d0754ff06ecb9bcc2)), closes [#1145](https://github.com/CQCL/guppylang/issues/1145)
+* Support `None` value ([#1149](https://github.com/CQCL/guppylang/issues/1149)) ([7f606c7](https://github.com/CQCL/guppylang/commit/7f606c778d98312a0d1c4a9c7a27448c24d80585)), closes [#1148](https://github.com/CQCL/guppylang/issues/1148)
+
+
+### Documentation
+
+* Fix docs build ([#1142](https://github.com/CQCL/guppylang/issues/1142)) ([4dfd575](https://github.com/CQCL/guppylang/commit/4dfd575bcdfdf1e2db4e61f2f406fff27e0c08f7))
+
+## [0.21.0](https://github.com/CQCL/guppylang/compare/guppylang-internals-v0.20.0...guppylang-internals-v0.21.0) (2025-08-04)
+
+
+### ⚠ BREAKING CHANGES
+
+* All compiler-internal and non-userfacing functionality is moved into a new `guppylang_internals` package
+
+### Code Refactoring
+
+* Split up into `guppylang_internals` package ([#1126](https://github.com/CQCL/guppylang/issues/1126)) ([81d50c0](https://github.com/CQCL/guppylang/commit/81d50c0a24f55eca48d62e4b0275ef2126c5e626))

{guppylang_internals-0.21.0 → guppylang_internals-0.21.1}/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: guppylang-internals
-Version: 0.21.0
-Summary: Copmiler internals for `guppylang` package.
+Version: 0.21.1
+Summary: Compiler internals for `guppylang` package.
 Author-email: Mark Koch <mark.koch@quantinuum.com>, TKET development team <tket-support@quantinuum.com>
 Maintainer-email: Mark Koch <mark.koch@quantinuum.com>, TKET development team <tket-support@quantinuum.com>
 License:                                  Apache License

{guppylang_internals-0.21.0 → guppylang_internals-0.21.1}/pyproject.toml

@@ -1,8 +1,8 @@
 [project]
 name = "guppylang-internals"
-version = "0.21.0"
+version = "0.21.1"
 requires-python = ">=3.10,<4"
-description = "Copmiler internals for `guppylang` package."
+description = "Compiler internals for `guppylang` package."
 license = { file = "LICENCE" }
 readme = "README.md"
 authors = [

{guppylang_internals-0.21.0 → guppylang_internals-0.21.1}/src/guppylang_internals/__init__.py

@@ -1,3 +1,3 @@
 # This is updated by our release-please workflow, triggered by this
 # annotation: x-release-please-version
-__version__ = "0.21.0"
+__version__ = "0.21.1"

{guppylang_internals-0.21.0 → guppylang_internals-0.21.1}/src/guppylang_internals/checker/expr_checker.py

@@ -1365,6 +1365,8 @@ def python_value_to_guppy_type(
             return TupleType(cast(list[Type], tys))
         case list():
             return _python_list_to_guppy_type(v, node, globals, type_hint)
+        case None:
+            return NoneType()
         case _:
             return None
 

{guppylang_internals-0.21.0 → guppylang_internals-0.21.1}/src/guppylang_internals/compiler/expr_compiler.py

@@ -828,6 +828,8 @@ def python_value_to_hugr(v: Any, exp_ty: Type, ctx: CompilerContext) -> hv.Value
                 return hugr.std.collections.static_array.StaticArrayVal(
                     vs, elem_ty.to_hugr(ctx), name=f"static_pyarray.{next(tmp_vars)}"
                 )
+        case None:
+            return hugr.val.Unit
         case _:
             return None
     return None

{guppylang_internals-0.21.0 → guppylang_internals-0.21.1}/src/guppylang_internals/decorator.py

@@ -1,16 +1,11 @@
-import builtins
+from __future__ import annotations
+
 import inspect
-from collections.abc import Callable, Sequence
-from types import FrameType
-from typing import ParamSpec, TypeVar
+from typing import TYPE_CHECKING, ParamSpec, TypeVar
 
 from hugr import ops
 from hugr import tys as ht
 
-from guppylang.defs import (
-    GuppyDefinition,
-    GuppyFunctionDefinition,
-)
 from guppylang_internals.compiler.core import (
     CompilerContext,
     GlobalConstId,
@@ -27,6 +22,7 @@ from guppylang_internals.definition.custom import (
 )
 from guppylang_internals.definition.ty import OpaqueTypeDef, TypeDef
 from guppylang_internals.definition.wasm import RawWasmFunctionDef
+from guppylang_internals.dummy_decorator import _dummy_custom_decorator, sphinx_running
 from guppylang_internals.engine import DEF_STORE
 from guppylang_internals.std._internal.checker import WasmCallChecker
 from guppylang_internals.std._internal.compiler.wasm import (
@@ -34,12 +30,9 @@ from guppylang_internals.std._internal.compiler.wasm import (
     WasmModuleDiscardCompiler,
     WasmModuleInitCompiler,
 )
-from guppylang_internals.tys.arg import Argument
 from guppylang_internals.tys.builtin import (
     WasmModuleTypeDef,
 )
-from guppylang_internals.tys.param import Parameter
-from guppylang_internals.tys.subst import Inst
 from guppylang_internals.tys.ty import (
     FuncInput,
     FunctionType,
@@ -48,6 +41,16 @@ from guppylang_internals.tys.ty import (
     NumericType,
 )
 
+if TYPE_CHECKING:
+    import builtins
+    from collections.abc import Callable, Sequence
+    from types import FrameType
+
+    from guppylang.defs import GuppyDefinition, GuppyFunctionDefinition
+    from guppylang_internals.tys.arg import Argument
+    from guppylang_internals.tys.param import Parameter
+    from guppylang_internals.tys.subst import Inst
+
 T = TypeVar("T")
 P = ParamSpec("P")
 
@@ -78,6 +81,7 @@ def custom_function(
     that case, the function signature can be omitted if a custom call compiler is
     provided.
     """
+    from guppylang.defs import GuppyFunctionDefinition
 
     def dec(f: Callable[P, T]) -> GuppyFunctionDefinition[P, T]:
         call_checker = checker or DefaultCallChecker()
@@ -119,6 +123,7 @@ def hugr_op(
 
 def extend_type(defn: TypeDef) -> Callable[[type], type]:
     """Decorator to add new instance functions to a type."""
+    from guppylang.defs import GuppyDefinition
 
     def dec(c: type) -> type:
         for val in c.__dict__.values():
@@ -147,6 +152,8 @@ def custom_type(
     For generic types, a callable may be passed that takes the type arguments of a
     concrete instantiation.
     """
+    from guppylang.defs import GuppyDefinition
+
     mk_hugr_ty = (
         (lambda args, ctx: hugr_ty) if isinstance(hugr_ty, ht.Type) else hugr_ty
     )
@@ -176,6 +183,8 @@ def custom_type(
 def wasm_module(
     filename: str, filehash: int
 ) -> Callable[[builtins.type[T]], GuppyDefinition]:
+    from guppylang.defs import GuppyDefinition
+
     def dec(cls: builtins.type[T]) -> GuppyDefinition:
         # N.B. Only one module per file and vice-versa
         wasm_module = WasmModuleTypeDef(
@@ -229,6 +238,8 @@ def wasm_module(
 
 
 def wasm(f: Callable[P, T]) -> GuppyFunctionDefinition[P, T]:
+    from guppylang.defs import GuppyFunctionDefinition
+
     func = RawWasmFunctionDef(
         DefId.fresh(),
         f.__name__,
@@ -243,4 +254,11 @@ def wasm(f: Callable[P, T]) -> GuppyFunctionDefinition[P, T]:
     return GuppyFunctionDefinition(func)
 
 
-# TODO sphinx hack for custom decorators
+# Override decorators with dummy versions if we're running a sphinx build
+if not TYPE_CHECKING and sphinx_running():
+    custom_function = _dummy_custom_decorator
+    hugr_op = _dummy_custom_decorator
+    extend_type = _dummy_custom_decorator
+    custom_type = _dummy_custom_decorator
+    wasm_module = _dummy_custom_decorator
+    wasm = _dummy_custom_decorator()

{guppylang_internals-0.21.0 → guppylang_internals-0.21.1}/src/guppylang_internals/dummy_decorator.py

@@ -64,6 +64,11 @@ class _DummyGuppy:
         return None
 
 
+def _dummy_custom_decorator(*args: Any, **kwargs: Any) -> Any:
+    """Dummy version of custom decorators that are used during Sphinx builds."""
+    return lambda f: f
+
+
 def sphinx_running() -> bool:
     """Checks if guppylang was imported during a sphinx build."""
     # This is the most general solution available at the moment.

guppylang_internals-0.21.0/CHANGELOG.md

@@ -1,15 +0,0 @@
-# Changelog
-
-First release of `guppylang_internals` package containing refactored out internal components
-from `guppylang`.
-
-## [0.21.0](https://github.com/CQCL/guppylang/compare/guppylang-internals-v0.20.0...guppylang-internals-v0.21.0) (2025-08-04)
-
-
-### ⚠ BREAKING CHANGES
-
-* All compiler-internal and non-userfacing functionality is moved into a new `guppylang_internals` package
-
-### Code Refactoring
-
-* Split up into `guppylang_internals` package ([#1126](https://github.com/CQCL/guppylang/issues/1126)) ([81d50c0](https://github.com/CQCL/guppylang/commit/81d50c0a24f55eca48d62e4b0275ef2126c5e626))