nestifypy 0.1.0__tar.gz

nestifypy-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Pynest Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

nestifypy-0.1.0/PKG-INFO

@@ -0,0 +1,208 @@
+Metadata-Version: 2.4
+Name: nestifypy
+Version: 0.1.0
+Summary: Modern utility and game framework for Python
+Author: rickmviana
+License: MIT
+Project-URL: Homepage, https://github.com/nadezhdkov/nestifypy
+Project-URL: Repository, https://github.com/nadezhdkov/nestifypy
+Project-URL: Bug Tracker, https://github.com/nadezhdkov/nestifypy/issues
+Keywords: game,framework,utility,yaml,pygame,ecs,env
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Games/Entertainment
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: python-dotenv>=1.0
+Requires-Dist: typer>=0.12
+Requires-Dist: watchdog>=4.0
+Requires-Dist: pygame>=2.6.1
+Provides-Extra: game
+Requires-Dist: pygame>=2.5; extra == "game"
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.1; extra == "dev"
+Requires-Dist: ruff>=0.4; extra == "dev"
+Requires-Dist: mypy>=1.10; extra == "dev"
+Requires-Dist: black>=24.0; extra == "dev"
+Dynamic: license-file
+
+<div align="center">
+  <h1>🪺 Nestifypy Framework</h1>
+  <p><strong>A Modern, Declarative Utility and Game Framework for Python 3.10+</strong></p>
+
+  <p>
+    <a href="https://github.com/nestifypy/nestifypy/actions"><img src="https://img.shields.io/badge/build-passing-brightgreen?style=flat-square" alt="Build Status"></a>
+    <a href="https://pypi.org/project/nestifypy/"><img src="https://img.shields.io/badge/python-3.10%2B-blue?style=flat-square&logo=python&logoColor=white" alt="Python Version"></a>
+    <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-green?style=flat-square" alt="License"></a>
+    <a href="https://github.com/astral-sh/ruff"><img src="https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json" alt="Ruff"></a>
+    <a href="SECURITY.md"><img src="https://img.shields.io/badge/security-policy-lightgrey?style=flat-square" alt="Security"></a>
+  </p>
+</div>
+
+---
+
+**Nestifypy** is a production-ready, modular utility and game framework for Python. It provides a highly declarative, decorator-driven approach to application development, focusing on performance, developer ergonomics, and strict type safety.
+
+Whether you are building complex CLI tools, managing intelligent configuration registries, or developing 2D physics-based games, Nestifypy provides a robust foundation.
+
+## 🚀 Key Features
+
+### 🎮 Pyunix Game Engine (`nestifypy.pyunix`)
+A fully declarative, decorator-driven engine built on top of `pygame`. 
+- **No Boilerplate:** Build games using `@Game`, `@Sprite`, and `@Scene` without writing messy `while True` game loops.
+- **ECS-Friendly Architecture:** Build isolated entities and manage them easily via `SpriteGroup`.
+- **Built-in 2D Physics:** High-performance Rigidbody physics with spatial hashing, `BoxCollider` / `CircleCollider`, and collision event hooks (`@Sprite.on_collision_enter`).
+- **Declarative UI & Fonts:** Advanced text rendering system with outlines, shadows, anchors, and caching via the `@Game.text` decorator.
+- **Advanced Systems:** Built-in `Camera` with smooth-follow and screenshake, flexible `Audio` management, and robust `Timer` logic tied to game Delta-Time.
+
+### 🛠️ Core Utilities
+- **Intelligent YAML Registry (`nestifypy.yaml`)**: An advanced configuration engine that automatically scans, caches, and indexes your YAML files, providing instant `O(1)` access via dot-notation (e.g., `yaml.get("server.port")`).
+- **Declarative Environments (`nestifypy.env`)**: Bind `.env` variables directly to class properties using the `EnvProperty` descriptor, or inject them into functions using `@Env.inject`.
+- **System Tools (`nestifypy.os`)**: Cross-platform, memory-efficient generators for file scanning, subprocess management, and directory operations.
+- **CLI Ecosystem (`nestifypy cli`)**: Scaffolding tools to generate professional-grade projects instantly with built-in support for `ruff`, `pytest`, and `mypy`.
+
+---
+
+## 📦 Installation
+
+Nestifypy requires **Python 3.10 or higher**.
+
+To install the core utility framework (without Pygame dependencies):
+```bash
+pip install nestifypy
+```
+
+To install Nestifypy with **full Pyunix Game Framework** capabilities:
+```bash
+pip install "nestifypy[game]"
+```
+
+---
+
+## ⚡ Quick Start
+
+### 1. Initialize a Project
+Use the CLI to scaffold a new project complete with a professional `pyproject.toml` and directory structure.
+```bash
+nestifypy init --name my_app
+```
+
+### 2. Building a Game (Pyunix)
+Building a game loop is as simple as decorating a class. 
+
+```python
+from nestifypy.pyunix import Game, Entity, Rigidbody, BoxCollider, BodyType
+from nestifypy.types import Vector2, Color
+
+# 1. Define your Game
+@Game(title="My Awesome Game", size=(800, 600), fps=60)
+class MyGame:
+    @Game.start
+    def start(self):
+        print("Engine Initialized!")
+        self.player = Player(x=400, y=300)
+
+    @Game.update
+    def update(self, dt: float):
+        # Game logic here
+        pass
+
+    @Game.draw
+    def draw(self, screen):
+        screen.fill(Color.BLACK.to_tuple())
+
+    @Game.text(x=10, y=10, size=24, color="white", outline=True)
+    def score_ui(self):
+        return f"SCORE: 1000"
+
+# 2. Define your Entities with Physics
+class Player(Entity):
+    def __init__(self, x, y):
+        super().__init__(
+            x=x, y=y,
+            layer="player",
+            rigidbody=Rigidbody(body_type=BodyType.DYNAMIC, mass=1.0),
+            collider=BoxCollider(width=32, height=32)
+        )
+
+    @Sprite.update
+    def movement(self, dt):
+        if self.input.is_action_pressed("jump"):
+            self.rigidbody.add_impulse(Vector2(0, -500))
+
+# 3. Run!
+if __name__ == "__main__":
+    game = MyGame()
+    game.run()
+```
+
+### 3. Smart Configuration & Env
+Access parsed configurations instantly across your entire project.
+
+```python
+from nestifypy import yaml
+from nestifypy.env import Env
+
+# Automatically loads .env file
+Env.load()
+api_key = Env.required("API_KEY")
+
+# Fetches value from any scanned .yml file in the project natively
+db_host = yaml.get("database.host") 
+```
+
+---
+
+## 📚 Documentation
+
+Detailed guides and API references for each module can be found in the `docs/` directory:
+
+- 🎮 **[Pyunix Game Framework](docs/pyunix.md)** (Includes Physics & UI guides)
+- ⚙️ **[YAML Intelligent Registry](docs/yaml.md)**
+- 🔒 **[Environment Management](docs/env.md)**
+- 📁 **[OS & File Utilities](docs/os.md)**
+- 📝 **[JSON Tools](docs/json.md)**
+- 🖥️ **[Console Tools](docs/console.md)**
+- 🧱 **[Core Systems (Logger/Plugins)](docs/core.md)**
+- ✨ **[Decorators](docs/decorators.md)**
+- ⏱️ **[Control Flow](docs/flow.md)**
+- 🗃️ **[Collections](docs/collections.md)**
+
+---
+
+## 🤝 Contributing
+
+Nestifypy is built with modern Python tools (`uv`, `ruff`, `pytest`). We welcome contributions!
+
+1. Clone the repository.
+2. Install development dependencies using `uv` or `pip`:
+   ```bash
+   uv pip install -e ".[dev]"
+   ```
+3. Run tests:
+   ```bash
+   pytest
+   ```
+4. Lint code:
+   ```bash
+   ruff check .
+   ```
+
+---
+
+## 🛡️ Security
+
+Please review our [Security Policy](SECURITY.md) for information on reporting vulnerabilities.
+
+## 📜 License
+
+This project is licensed under the [MIT License](LICENSE).

nestifypy-0.1.0/README.md

@@ -0,0 +1,171 @@
+<div align="center">
+  <h1>🪺 Nestifypy Framework</h1>
+  <p><strong>A Modern, Declarative Utility and Game Framework for Python 3.10+</strong></p>
+
+  <p>
+    <a href="https://github.com/nestifypy/nestifypy/actions"><img src="https://img.shields.io/badge/build-passing-brightgreen?style=flat-square" alt="Build Status"></a>
+    <a href="https://pypi.org/project/nestifypy/"><img src="https://img.shields.io/badge/python-3.10%2B-blue?style=flat-square&logo=python&logoColor=white" alt="Python Version"></a>
+    <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-green?style=flat-square" alt="License"></a>
+    <a href="https://github.com/astral-sh/ruff"><img src="https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json" alt="Ruff"></a>
+    <a href="SECURITY.md"><img src="https://img.shields.io/badge/security-policy-lightgrey?style=flat-square" alt="Security"></a>
+  </p>
+</div>
+
+---
+
+**Nestifypy** is a production-ready, modular utility and game framework for Python. It provides a highly declarative, decorator-driven approach to application development, focusing on performance, developer ergonomics, and strict type safety.
+
+Whether you are building complex CLI tools, managing intelligent configuration registries, or developing 2D physics-based games, Nestifypy provides a robust foundation.
+
+## 🚀 Key Features
+
+### 🎮 Pyunix Game Engine (`nestifypy.pyunix`)
+A fully declarative, decorator-driven engine built on top of `pygame`. 
+- **No Boilerplate:** Build games using `@Game`, `@Sprite`, and `@Scene` without writing messy `while True` game loops.
+- **ECS-Friendly Architecture:** Build isolated entities and manage them easily via `SpriteGroup`.
+- **Built-in 2D Physics:** High-performance Rigidbody physics with spatial hashing, `BoxCollider` / `CircleCollider`, and collision event hooks (`@Sprite.on_collision_enter`).
+- **Declarative UI & Fonts:** Advanced text rendering system with outlines, shadows, anchors, and caching via the `@Game.text` decorator.
+- **Advanced Systems:** Built-in `Camera` with smooth-follow and screenshake, flexible `Audio` management, and robust `Timer` logic tied to game Delta-Time.
+
+### 🛠️ Core Utilities
+- **Intelligent YAML Registry (`nestifypy.yaml`)**: An advanced configuration engine that automatically scans, caches, and indexes your YAML files, providing instant `O(1)` access via dot-notation (e.g., `yaml.get("server.port")`).
+- **Declarative Environments (`nestifypy.env`)**: Bind `.env` variables directly to class properties using the `EnvProperty` descriptor, or inject them into functions using `@Env.inject`.
+- **System Tools (`nestifypy.os`)**: Cross-platform, memory-efficient generators for file scanning, subprocess management, and directory operations.
+- **CLI Ecosystem (`nestifypy cli`)**: Scaffolding tools to generate professional-grade projects instantly with built-in support for `ruff`, `pytest`, and `mypy`.
+
+---
+
+## 📦 Installation
+
+Nestifypy requires **Python 3.10 or higher**.
+
+To install the core utility framework (without Pygame dependencies):
+```bash
+pip install nestifypy
+```
+
+To install Nestifypy with **full Pyunix Game Framework** capabilities:
+```bash
+pip install "nestifypy[game]"
+```
+
+---
+
+## ⚡ Quick Start
+
+### 1. Initialize a Project
+Use the CLI to scaffold a new project complete with a professional `pyproject.toml` and directory structure.
+```bash
+nestifypy init --name my_app
+```
+
+### 2. Building a Game (Pyunix)
+Building a game loop is as simple as decorating a class. 
+
+```python
+from nestifypy.pyunix import Game, Entity, Rigidbody, BoxCollider, BodyType
+from nestifypy.types import Vector2, Color
+
+# 1. Define your Game
+@Game(title="My Awesome Game", size=(800, 600), fps=60)
+class MyGame:
+    @Game.start
+    def start(self):
+        print("Engine Initialized!")
+        self.player = Player(x=400, y=300)
+
+    @Game.update
+    def update(self, dt: float):
+        # Game logic here
+        pass
+
+    @Game.draw
+    def draw(self, screen):
+        screen.fill(Color.BLACK.to_tuple())
+
+    @Game.text(x=10, y=10, size=24, color="white", outline=True)
+    def score_ui(self):
+        return f"SCORE: 1000"
+
+# 2. Define your Entities with Physics
+class Player(Entity):
+    def __init__(self, x, y):
+        super().__init__(
+            x=x, y=y,
+            layer="player",
+            rigidbody=Rigidbody(body_type=BodyType.DYNAMIC, mass=1.0),
+            collider=BoxCollider(width=32, height=32)
+        )
+
+    @Sprite.update
+    def movement(self, dt):
+        if self.input.is_action_pressed("jump"):
+            self.rigidbody.add_impulse(Vector2(0, -500))
+
+# 3. Run!
+if __name__ == "__main__":
+    game = MyGame()
+    game.run()
+```
+
+### 3. Smart Configuration & Env
+Access parsed configurations instantly across your entire project.
+
+```python
+from nestifypy import yaml
+from nestifypy.env import Env
+
+# Automatically loads .env file
+Env.load()
+api_key = Env.required("API_KEY")
+
+# Fetches value from any scanned .yml file in the project natively
+db_host = yaml.get("database.host") 
+```
+
+---
+
+## 📚 Documentation
+
+Detailed guides and API references for each module can be found in the `docs/` directory:
+
+- 🎮 **[Pyunix Game Framework](docs/pyunix.md)** (Includes Physics & UI guides)
+- ⚙️ **[YAML Intelligent Registry](docs/yaml.md)**
+- 🔒 **[Environment Management](docs/env.md)**
+- 📁 **[OS & File Utilities](docs/os.md)**
+- 📝 **[JSON Tools](docs/json.md)**
+- 🖥️ **[Console Tools](docs/console.md)**
+- 🧱 **[Core Systems (Logger/Plugins)](docs/core.md)**
+- ✨ **[Decorators](docs/decorators.md)**
+- ⏱️ **[Control Flow](docs/flow.md)**
+- 🗃️ **[Collections](docs/collections.md)**
+
+---
+
+## 🤝 Contributing
+
+Nestifypy is built with modern Python tools (`uv`, `ruff`, `pytest`). We welcome contributions!
+
+1. Clone the repository.
+2. Install development dependencies using `uv` or `pip`:
+   ```bash
+   uv pip install -e ".[dev]"
+   ```
+3. Run tests:
+   ```bash
+   pytest
+   ```
+4. Lint code:
+   ```bash
+   ruff check .
+   ```
+
+---
+
+## 🛡️ Security
+
+Please review our [Security Policy](SECURITY.md) for information on reporting vulnerabilities.
+
+## 📜 License
+
+This project is licensed under the [MIT License](LICENSE).

nestifypy-0.1.0/pyproject.toml

@@ -0,0 +1,103 @@
+[build-system]
+requires = ["setuptools>=69.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "nestifypy"
+dynamic = ["version"]
+description = "Modern utility and game framework for Python"
+readme = "README.md"
+requires-python = ">=3.10"
+license = {text = "MIT"}
+authors = [
+  {name = "rickmviana"}
+]
+keywords = ["game", "framework", "utility", "yaml", "pygame", "ecs", "env"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Topic :: Games/Entertainment",
+]
+
+dependencies = [
+  "pyyaml>=6.0",
+  "python-dotenv>=1.0",
+  "typer>=0.12",
+  "watchdog>=4.0",
+  "pygame>=2.6.1",
+]
+
+[project.optional-dependencies]
+game = ["pygame>=2.5"]
+dev = [
+  "pytest>=8.0",
+  "pytest-cov>=4.1",
+  "ruff>=0.4",
+  "mypy>=1.10",
+  "black>=24.0"
+]
+
+[project.urls]
+Homepage = "https://github.com/nadezhdkov/nestifypy"
+Repository = "https://github.com/nadezhdkov/nestifypy"
+"Bug Tracker" = "https://github.com/nadezhdkov/nestifypy/issues"
+
+[project.scripts]
+nestifypy = "nestifypy.cli:main"
+
+[tool.setuptools]
+package-dir = {"" = "src"}
+zip-safe = false
+
+[tool.setuptools.dynamic]
+version = {attr = "nestifypy.version.__version__"}
+
+[tool.setuptools.packages.find]
+where = ["src"]
+include = ["nestifypy*"]
+exclude = ["tests*"]
+
+[tool.setuptools.package-data]
+nestifypy = ["py.typed"]
+
+[tool.ruff]
+line-length = 88
+target-version = "py310"
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "N", "W", "UP"]
+ignore = ["UP006", "UP007", "E501"] # Keep standard typing for now
+
+[tool.mypy]
+python_version = "3.10"
+strict = true
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+python_files = ["test_*.py"]
+addopts = "-v --cov=nestifypy --cov-report=term-missing"
+
+[tool.coverage.run]
+source = ["src"]
+omit = ["*/tests/*"]
+
+[tool.coverage.report]
+exclude_lines = [
+    "pragma: no cover",
+    "def __repr__",
+    "raise NotImplementedError",
+    "if __name__ == .__main__.:",
+    "except ImportError:"
+]
+
+[dependency-groups]
+dev = [
+    "build>=1.5.0",
+    "twine>=6.2.0",
+]

nestifypy-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

nestifypy-0.1.0/src/nestifypy/__init__.py

@@ -0,0 +1,9 @@
+"""
+nestifypy
+======
+Modern utility and game framework for Python.
+"""
+
+from nestifypy.version import __version__
+
+__all__ = ["__version__"]