v3.0.1

Author: NeoXider

CHANGELOG.md

@@ -5,6 +5,18 @@
 Формат основан на [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 и этот проект придерживается [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [3.0.1]
+
+### Added
+- **Редактор: Save As** — в тулбаре появилась отдельная кнопка `Save As`, а также горячая клавиша `Ctrl+Shift+S` для сохранения сцены в новый JSON-файл.
+
+### Changed
+- **Редактор: пути к изображениям** — при сохранении сцены `sprite_path` теперь автоматически нормализуется относительно JSON-файла, чтобы сцены оставались переносимыми между машинами и каталогами.
+- **Runtime round-trip** — `RuntimeScene.save(...)` теперь тоже пересчитывает пути к изображениям относительно нового JSON, а runtime использует ту же общую логику поиска ассетов, что и редактор.
+- **Версия библиотеки** — релиз обновлён до `3.0.1`.
+
+---
+
 ## [3.0.0]
 
 ### Added

pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "spritepro"
-version = "3.0.0"
+version = "3.0.1"
 authors = [
   { name="NeoXider", email="neoxider@gmail.com" },
 ]

spritePro/__init__.py

@@ -135,7 +135,7 @@
     HOOKS_LIFECYCLE,
     HOOKS_SPRITE,
     HOOKS_SCENE,
-    HOOKS_INPUT
+    HOOKS_INPUT,
 )
 from .builder import SpriteBuilder, ParticleBuilder, particles
 from .asset_watcher import AssetWatcher, HotReloadManager, get_hot_reload_manager
@@ -314,6 +314,22 @@ def sprite(path: str = "") -> SpriteBuilder:
     "save_load",
     "validation",
     "plugins",
+    "validate_color",
+    "validate_vector2",
+    "validate_float",
+    "validate_string",
+    "validate_enum",
+    "validate_list",
+    "validate_dict",
+    "PluginManager",
+    "PluginInfo",
+    "get_plugin_manager",
+    "register_plugin",
+    "hook",
+    "HOOKS_LIFECYCLE",
+    "HOOKS_SPRITE",
+    "HOOKS_SCENE",
+    "HOOKS_INPUT",
     # Scenes
     "Scene",
     "SceneManager",
@@ -341,9 +357,13 @@ def sprite(path: str = "") -> SpriteBuilder:
     "ParticleBuilder",
     "sprite",
     "particles",
+    "AssetWatcher",
+    "HotReloadManager",
+    "get_hot_reload_manager",
     # Global facade
     "get_context",
     "get_game",
+    "get_physics",
     "get_physics_world",
     "physics",
     "register_sprite",

spritePro/asset_watcher.py

@@ -2,12 +2,8 @@
 
 from __future__ import annotations
 
-import os
-import time
 from typing import Callable, Optional, Dict, List, Any
 from pathlib import Path
-from threading import Thread
-import pygame
 
 import spritePro
 

spritePro/builder.py

@@ -6,13 +6,11 @@
 
 from __future__ import annotations
 
-from typing import Optional, Sequence, Tuple, Union, Any, Callable
-from pathlib import Path
+from typing import Optional, Sequence, Tuple, Union, Any
 
 import pygame
 from pygame.math import Vector2
 
-import spritePro
 from .sprite import Sprite
 from .constants import Anchor
 from .particles import ParticleEmitter, ParticleConfig
@@ -397,7 +395,9 @@ def build(self) -> Sprite:
             w, h = img.get_size()
             mask_surf = pygame.Surface((w, h), pygame.SRCALPHA)
             pygame.draw.rect(
-                mask_surf, (255, 255, 255, 255), (0, 0, w, h),
+                mask_surf,
+                (255, 255, 255, 255),
+                (0, 0, w, h),
                 border_radius=min(self._border_radius, w // 2, h // 2),
             )
             out = img.copy()

spritePro/cli_tools/android.py

@@ -79,7 +79,9 @@ def infer_android_version(project_root: Path) -> str:
 
 def infer_android_orientation(project_root: Path) -> str:
     config_text = read_text_if_exists(project_root / "config.py")
-    size_match = re.search(r"""^WINDOW_SIZE\s*=\s*\((\d+)\s*,\s*(\d+)\)\s*$""", config_text, re.MULTILINE)
+    size_match = re.search(
+        r"""^WINDOW_SIZE\s*=\s*\((\d+)\s*,\s*(\d+)\)\s*$""", config_text, re.MULTILINE
+    )
     if not size_match:
         return "all"
     width = int(size_match.group(1))
@@ -173,7 +175,9 @@ def run_android_build(
         logging.info("Using existing buildozer.spec: %s", spec_path)
 
     if mode == "spec":
-        logging.info("Spec generated only. Next step: run inside Linux/WSL -> buildozer android debug")
+        logging.info(
+            "Spec generated only. Next step: run inside Linux/WSL -> buildozer android debug"
+        )
         return 0
 
     if not sys.platform.startswith("linux"):
@@ -184,7 +188,7 @@ def run_android_build(
 
     buildozer_exe = shutil.which("buildozer")
     if buildozer_exe is None:
-        raise RuntimeError('Buildozer не найден в PATH. Установите его: pip install buildozer')
+        raise RuntimeError("Buildozer не найден в PATH. Установите его: pip install buildozer")
 
     if mode == "debug":
         command = [buildozer_exe, "android", "debug"]

spritePro/components/text.py

@@ -200,7 +200,9 @@ def _render_text_multiline(self, text: str, line_spacing: int = 2) -> pygame.Sur
             lines = [""]
         line_surfs = [self.font.render(line or " ", True, self.color) for line in lines]
         max_w = max(s.get_width() for s in line_surfs)
-        total_h = sum(s.get_height() for s in line_surfs) + max(0, len(line_surfs) - 1) * line_spacing
+        total_h = (
+            sum(s.get_height() for s in line_surfs) + max(0, len(line_surfs) - 1) * line_spacing
+        )
         surf = pygame.Surface((max_w, total_h), pygame.SRCALPHA)
         y = 0
         for srf in line_surfs:

spritePro/demoGames/builder_demo.py

@@ -1,4 +1,5 @@
 """Demo: Builder Pattern - Fluent API для создания спрайтов."""
+
 import sys
 
 import pygame
@@ -31,13 +32,7 @@ def __init__(self):
             .build()
         )
 
-        self.coin = (
-            s.sprite("")
-            .position(600, 300)
-            .size(32, 32)
-            .color(255, 215, 0)
-            .build()
-        )
+        self.coin = s.sprite("").position(600, 300).size(32, 32).color(255, 215, 0).build()
         self.coin.set_circle_shape(radius=16, color=(255, 215, 0))
 
         self.emitter = (

spritePro/demoGames/events_rps_demo.py

@@ -47,9 +47,15 @@ def __init__(self, net: s.NetClient, role: str) -> None:
         super().__init__()
         s.multiplayer.init_context(net, role)
         self.ctx = s.multiplayer_ctx
-        self.title = s.TextSprite("Rock / Paper / Scissors", 30, (255, 255, 255), (400, 40), scene=self)
-        self.hint = s.TextSprite("1=Rock  2=Paper  3=Scissors", 20, (200, 200, 200), (400, 80), scene=self)
-        self.status = s.TextSprite("Make your choice...", 20, (220, 220, 220), (400, 120), scene=self)
+        self.title = s.TextSprite(
+            "Rock / Paper / Scissors", 30, (255, 255, 255), (400, 40), scene=self
+        )
+        self.hint = s.TextSprite(
+            "1=Rock  2=Paper  3=Scissors", 20, (200, 200, 200), (400, 80), scene=self
+        )
+        self.status = s.TextSprite(
+            "Make your choice...", 20, (220, 220, 220), (400, 120), scene=self
+        )
         self.my_info = s.TextSprite("You (ID: ?)", 20, (120, 200, 255), (200, 220), scene=self)
         self.other_info = s.TextSprite("Other (ID: ?)", 20, (255, 200, 120), (600, 220), scene=self)
         self.my_choice_text = s.TextSprite("?", 36, (120, 200, 255), (200, 270), scene=self)
@@ -107,7 +113,10 @@ def update(self, dt: float) -> None:
         other_id_label = "?" if self.other_id is None else str(self.other_id)
         self.other_info.set_text(f"Other (ID: {other_id_label})")
 
-        if self.last_result_at is not None and s.time_since_start - self.last_result_at >= self.result_delay:
+        if (
+            self.last_result_at is not None
+            and s.time_since_start - self.last_result_at >= self.result_delay
+        ):
             self.last_result_at = None
             self.my_choice = None
             self.other_choice = None

spritePro/demoGames/fluent_tween_demo.py

@@ -22,7 +22,9 @@ def __init__(self):
         self.box_kill = s.Sprite("", (50, 50), (700, 200), scene=self)
         self.box_kill.set_color((150, 255, 150))
 
-        self.title = s.TextSprite("Fluent Tween API (Do*)", 28, (255, 255, 255), (s.WH_C.x, 24), scene=self)
+        self.title = s.TextSprite(
+            "Fluent Tween API (Do*)", 28, (255, 255, 255), (s.WH_C.x, 24), scene=self
+        )
         hints = [
             "1: DoMove  |  2: DoMoveBy  |  3: DoScale  |  4: DoRotateBy(180)  |  5: DoColor  |  6: DoFadeOut/In",
             "7: DoMove(...).SetEase(Ease.OutCubic).SetDelay(0.3).OnComplete(callback)",
@@ -52,11 +54,15 @@ def reset(self) -> None:
         if self.active_kill_handle:
             self.active_kill_handle.Kill(complete=False)
             self.active_kill_handle = None
-        self.box.set_position(self.base_pos).set_scale(self.base_scale).rotate_to(self.base_angle).set_alpha(
-            self.base_alpha
-        ).set_color(self.base_color)
-        self.box_loop.set_position(self.base_pos_loop).set_scale(1.0).set_color((255, 180, 100)).set_alpha(255)
-        self.box_kill.set_position(self.base_pos_kill).set_scale(1.0).set_color((150, 255, 150)).set_alpha(255)
+        self.box.set_position(self.base_pos).set_scale(self.base_scale).rotate_to(
+            self.base_angle
+        ).set_alpha(self.base_alpha).set_color(self.base_color)
+        self.box_loop.set_position(self.base_pos_loop).set_scale(1.0).set_color(
+            (255, 180, 100)
+        ).set_alpha(255)
+        self.box_kill.set_position(self.base_pos_kill).set_scale(1.0).set_color(
+            (150, 255, 150)
+        ).set_alpha(255)
 
     def update(self, dt: float) -> None:
         if s.input.was_pressed(pygame.K_1):
@@ -96,7 +102,9 @@ def update(self, dt: float) -> None:
                 self.active_loop_handle.Kill(complete=False)
             self.box_loop.set_position(self.base_pos_loop)
             self.box_loop.set_scale(1.0)
-            self.active_loop_handle = self.box_loop.DoMove((450, 450), 1.2).SetLoops(-1).SetYoyo(True)
+            self.active_loop_handle = (
+                self.box_loop.DoMove((450, 450), 1.2).SetLoops(-1).SetYoyo(True)
+            )
 
         if s.input.was_pressed(pygame.K_k):
             if self.active_kill_handle: