Working tox and basic testing

Author: allRisc

.github/workflows/ci.yml

@@ -14,7 +14,7 @@ jobs:
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        python-version: ["3.8", "3.9", "3.10", "3.11", "3.12", "3.13"]
+        python-version: ["3.9", "3.10", "3.11", "3.12", "3.13"]
 
     steps:
       - name: Checkout Code
@@ -38,5 +38,8 @@ jobs:
       - name: Run Unit Tests
         run: uv run pytest -v
 
+      - name: Run StubTest
+        run: uv run stubtest pyslang --allowlist allowlist.txt
+
       - name: Test Package Build
         run: uv build

pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "uv_build"
 
 [project]
 name = "pyslang-stubs"
-version = "9.0.0"
+version = "9.0.0.20250901-b0"
 description = "Typing stubs for the excellent pyslang library"
 readme = "README.md"
 authors = [
@@ -16,7 +16,7 @@ classifiers = [
     "Classifier: Typing :: Stubs Only"
 ]
 
-requires-python = ">=3.13"
+requires-python = ">=3.9"
 dependencies = [
     "typing-extensions>=4.15.0",
 ]
@@ -57,7 +57,7 @@ typeCheckingMode = "basic"
 line-length = 100
 indent-width = 4
 
-target-version = "py38"
+target-version = "py39"
 show-fixes = true
 
 src = ["src"]
@@ -84,10 +84,10 @@ ignore = [
 
 [tool.tox]
 env_list = [
-    "py3.13", "py3.12", "py3.11", "py3.10", "py3.9", "py3.8",
+    "py3.13", "py3.12", "py3.11", "py3.10", "py3.9",
     "style",
     "typing",
-    # "docs",
+    "stubs",
 ]
 
 [tool.tox.env_run_base]
@@ -97,7 +97,7 @@ package = "wheel"
 wheel_build_env = ".pkg"
 constrain_package_deps = true
 use_frozen_constraints = true
-dependency_groups = ["tests"]
+dependency_groups = ["dev"]
 
 commands = [[
     "pytest", "-v", "--tb=short", "--basetemp={env_tmp_dir}",
@@ -116,3 +116,11 @@ dependency_groups = ["dev"]
 commands = [
     ["mypy"],
 ]
+
+[tool.tox.env.stubs]
+description = "run stub checking"
+dependency_groups = ["dev"]
+set_env = {MYPYPATH = "./stubs/"}
+commands = [
+    ["stubtest", "pyslang", "--allowlist", "allowlist.txt"]
+]

src/pyslang-stubs/__init__.pyi

@@ -11,11 +11,9 @@ from typing import Any, ClassVar, Final
 from typing_extensions import Self
 
 try:
-    from pybind11_builtins import (  # pyright: ignore[reportMissingImports]
-        pybind11_type as _metaclass,
-    )
+    from pybind11_builtins import pybind11_type as _metaclass  # type: ignore
 except ImportError:
-    _metaclass = type
+    _metaclass = type  # type: ignore
 
 class ASTFlags(metaclass=_metaclass):
     AllowClockingBlock: ClassVar[ASTFlags]
@@ -6766,7 +6764,7 @@ class ScopedNameSyntax(NameSyntax):
 
 class ScriptSession(metaclass=_metaclass):
     def __init__(self) -> None: ...
-    def eval(self, text: str) -> Any: ...
+    def eval(self, text: str) -> ConstantValue: ...
     def evalExpression(self, expr: Any) -> Any: ...
     def evalStatement(self, expr: Any) -> None: ...
     def getDiagnostics(self) -> Any: ...

tests/test_typing.py

@@ -0,0 +1,12 @@
+from __future__ import annotations
+
+
+import pyslang
+
+
+def test_script_session():
+    evaluation = pyslang.ScriptSession()
+    assert isinstance(evaluation, pyslang.ScriptSession)
+
+    result = evaluation.eval("8'hFF")
+    assert isinstance(result, pyslang.ConstantValue)