Merge pull request #51 from apple1417/master

bump to python 3.13

.cruft.json

@@ -1,6 +1,6 @@
 {
   "template": "git@github.com:bl-sdk/common_dotfiles.git",
-  "commit": "6b31480199099e9957b18918373a75d979951919",
+  "commit": "d03eee713ad436d20033d0598eb88f1529c56ca8",
   "checkout": null,
   "context": {
     "cookiecutter": {

CMakePresets.json

@@ -7,7 +7,7 @@
       "binaryDir": "${sourceDir}/out/build/${presetName}",
       "installDir": "${sourceDir}/out/install/${presetName}",
       "cacheVariables": {
-        "EXPLICIT_PYTHON_VERSION": "3.12.3"
+        "EXPLICIT_PYTHON_VERSION": "3.13.0"
       }
     },
     {

pyproject.toml

@@ -1,14 +1,16 @@
 [tool.pyright]
-pythonVersion = "3.12"
+pythonVersion = "3.13"
 typeCheckingMode = "strict"
+pythonPlatform = "Windows"
 
 include = ["stubs"]
 
 [tool.ruff]
-target-version = "py312"
+target-version = "py313"
 line-length = 100
 
 [tool.ruff.lint]
+# Last time rules scrutinised: ruff 0.6.9 / 2024-10-08
 select = [
     "F",
     "W",

src/pyunrealsdk/hook.cpp

@@ -149,9 +149,8 @@ void register_module(py::module_& mod) {
         "\n"
         "To block execution, return the sentinel `Block` type, (or an instance thereof),\n"
         "either by itself or as the first element of a tuple. Any other value will allow\n"
-        "execution continue - suggest using Ellipsis when a value's required. If there\n"
-        "are multiple hooks on the same function, execution is blocked if any hook\n"
-        "requests it.\n"
+        "execution continue - though generally just use None. If there are multiple hooks\n"
+        "on the same function, execution is blocked if any hook requests it.\n"
         "\n"
         "To overwrite the return value, return it as the second element of a tuple. The\n"
         "the sentinel `Unset` type will prevent an override, while using Ellipsis will\n"

stubs/unrealsdk/hooks/__init__.pyi

@@ -4,7 +4,6 @@ from __future__ import annotations
 
 from collections.abc import Callable
 from enum import EnumMeta
-from types import EllipsisType
 from typing import Any, ClassVar, Literal, overload
 
 from unrealsdk.unreal import BoundFunction, UObject, WrappedStruct
@@ -71,7 +70,7 @@ class Unset:
     return value will be used.
     """
 
-type _HookBlockSignal = None | EllipsisType | Block | type[Block]
+type _HookBlockSignal = None | Block | type[Block]
 type _PreHookCallback = Callable[
     [UObject, WrappedStruct, Any, BoundFunction],
     _HookBlockSignal | tuple[_HookBlockSignal, Any],
@@ -122,9 +121,8 @@ def add_hook(
 
     To block execution, return the sentinel `Block` type, (or an instance thereof),
     either by itself or as the first element of a tuple. Any other value will allow
-    execution continue - suggest using Ellipsis when a value's required. If there
-    are multiple hooks on the same function, execution is blocked if any hook
-    requests it.
+    execution continue - though generally just use None. If there are multiple hooks
+    on the same function, execution is blocked if any hook requests it.
 
     To overwrite the return value, return it as the second element of a tuple. The
     the sentinel `Unset` type will prevent an override, while using Ellipsis will