Merge branch 'master' into master

Author: Flashing-Blinkenlights

CHANGELOG.md

@@ -2,7 +2,13 @@
 
 Compatible with GDMC-HTTP **>=1.0.0, <2.0.0** and Minecraft **1.20.2**.
 
+
+# 7.3.0
+
+Compatible with GDMC-HTTP **>=1.0.0, <2.0.0** and Minecraft **1.20.2**.
+
 **Additions:**
+- Added ZERO_2D/ZERO_3D/ZERO constants to `vector_tools`. (Thanks [Flashing-Blinkenlights](https://github.com/Flashing-Blinkenlights)!)
 - Added various ordered vector list constants to `vector_tools`. (Thanks [Flashing-Blinkenlights](https://github.com/Flashing-Blinkenlights)!)
 - Added `utils.rotateSequence`. (Thanks [Flashing-Blinkenlights](https://github.com/Flashing-Blinkenlights)!)
 

src/gdpc/__init__.py

@@ -13,7 +13,7 @@
 __maintainer_email__ = "[email protected]"
 __license__          = "MIT"
 __copyright__        = "Copyright 2022-2024 Arthur van der Staaij, Copyright 2021-2022 Blinkenlights, Copyright 2020-2021 Nils Gawlik"
-__version__          = "7.2.0"
+__version__          = "7.3.0"
 
 
 from .vector_tools import Rect, Box

src/gdpc/vector_tools.py

@@ -75,6 +75,7 @@ def __iter__(self) -> Iterator[bool]: ...
 # == constants ==
 
 
+ZERO_2D = ivec2(0, 0)
 X_2D = ivec2(1, 0)
 Y_2D = ivec2(0, 1)
 XY_2D: ivec2 = X_2D + Y_2D
@@ -121,7 +122,7 @@ def _spiraloidDirections3D(
     if include_up:     yield UP_3D                                        # ...the UP vector...
     if top_pattern:    yield from (UP_3D + c for c in top_pattern)        # ...the upward diagonal vectors...
     if center_pattern: yield from center_pattern[:len(center_pattern)//2] # ...the first half of the horizontal vectors...
-    if include_center: yield ivec3(0, 0, 0)                               # ...the origin...
+    if include_center: yield ZERO_3D                                      # ...the origin...
     if center_pattern: yield from center_pattern[len(center_pattern)//2:] # ...the second half of the horizontal vectors...
     if bottom_pattern: yield from (DOWN_3D + c for c in bottom_pattern)   # ...the downward diagonal vectors...
     if include_down:   yield DOWN_3D                                      # ...and the DOWN vector.
@@ -147,6 +148,8 @@ def _symmetricSpiraloidDirections3D(
 # == constants ==
 
 
+ZERO_3D = ivec3(0, 0, 0)
+
 X_3D = ivec3(1, 0, 0)
 Y_3D = ivec3(0, 1, 0)
 Z_3D = ivec3(0, 0, 1)
@@ -211,6 +214,7 @@ def _symmetricSpiraloidDirections3D(
 # ==== aliases ====
 
 
+ZERO: ivec3 = ZERO_3D
 X: ivec3 = X_3D
 Y: ivec3 = Y_3D
 Z: ivec3 = Z_3D