VertexEngine-CLI 1.0__tar.gz

vertexengine_cli-1.0/PKG-INFO

@@ -0,0 +1,138 @@
+Metadata-Version: 2.4
+Name: VertexEngine-CLI
+Version: 1.0
+Summary: An Offical CLI library for VertexEngine.
+Author-email: Tyrel Miguel <annbasilan0828@gmail.com>
+License: MIT
+Project-URL: Documentation, https://vertexenginedocs.netlify.app/
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: pygame>=2.0
+Requires-Dist: PyQt6>=6.7
+Requires-Dist: pyinstaller>=6.5.0
+Requires-Dist: VertexEngine>=1.0.1
+
+# VertexEngine/Vertex
+VertexEngine is a GUI and Game Engine for python applications, it works best if you use py installer
+
+## Change Logs (1.0rc1 - 1.1rc4), NEW!
+### 1.1rc4
+- FINAL RC!
+- Added 2 New Libraries:
+    ~ VertexEngine.WebEngine
+    ~ VertexEngine.WebView
+### 1.1rc3
+- Revamped Input System!
+- DEMO GAMES!
+- Updated Scene Docs
+### Version 1.1rc2
+- Documentation Expansion!
+   ~ Fixed the Changelogs
+- New Input System!
+- Old System (Qt) depreceated and not recomended for use.
+### Version 1.1rc1
+- New Library! (And Modules)!:
+    ~ InputSystem
+       ~ Buttons (Mouse and Widget)
+       ~ Keyboard Input
+### Version 1.0.1
+- Added Changelogs!
+### Version 1.0
+- Added 2 New Libraries:
+    ~ VertexEngine.SimpleGUI
+    ~ VertexEngine.VertexScreenModifiers
+### Version 1.0rc2
+- Final Release Candidate
+- Added 1 New Library!:
+    ~ VertexUI
+
+### Version 1.0rc1
+- Size Compression
+- Added 1 New Library!:
+    ~ VertexScreen
+
+## How to install Pyinstaller
+Step 1. Type in:
+pip install pyinstaller
+
+Step 2. Wait a few min, don't worry if it takes 1 hr or more, it will finish
+
+Step 3. How to use pyinstaller
+type:
+python -m PyInstaller --onefile *.py
+
+There are flags:
+--noconsole > disables the console when you run the app
+--onefile > compress all of the code into one file
+--icon > the *.ico file after you type it will be set as the app icon.
+
+## How to install VertexEngine/Vertex:
+
+Step 1:
+Type in
+pip install VertexEngine
+
+Step 2: Wait a few min, don't worry if it takes 1 hr or more, it will finish
+
+Step 3: Where to start?
+Read the documentations. Also copy the following template:
+-------------------------------------------------------
+from VertexEngine.engine import GameEngine
+from VertexEngine import VertexScreen
+from VertexEngine.audio import AudioManager
+from VertexEngine.scenes import Scene
+import pygame
+import sys
+from PyQt6.QtGui import QIcon
+from PyQt6.QtWidgets import QApplication
+
+class Main(Scene):
+    def __init__(self, engine):
+        super().__init__(engine)
+        self.width = engine.width
+        self.height = engine.height
+
+    def update(self):
+        pass
+
+    def draw(self, surface):
+        VertexScreen.Draw.rect(VertexScreen.Draw, surface, (0, 255, 0), (-570, 350, 5000, 500))
+
+if __name__ == '__main__':
+    app = QApplication(sys.argv) # <- create app
+    engine = GameEngine(fps=60, width=1920, height=1080, title="Screen.com/totally-not-virus") # <- initialize a1080p window at 60 FPS
+
+    engine.setWindowTitle('Screen.com/totally-not-virus') # <- name the app
+    engine.setWindowIcon(QIcon('snake.ico')) # <- icon
+    engine.show() # <- show window
+
+    main_scene = Main(engine) # <- intialize the scene
+    engine.scene_manager.add_scene('main', main_scene) # <- name scene
+    engine.scene_manager.switch_to('main') # <- switch to the main scene pls
+
+    app.exec()
+
+The following template creates a window with a green rectangle (the ground.)
+
+Pygame or PyQt6 systems are compatible with Vertex so you can use pygame collision system or PyQt6's UI system in VertexEngine.
+
+## Help
+The documentation is in the following link:
+[Project Documentation](https://vertexenginedocs.netlify.app/) for help.
+
+## Dependencies
+Vertex obviously has heavy dependencies since it's a game engine, the following requirements are:
+
+| Dependency       | Version                              |
+|------------------|--------------------------------------|
+| PyQt6            | >=6.7                                |   
+| Pygame           | >=2.0                                |
+| Python           | >=3.10                               |
+
+## About Me ❔
+I Am a solo developer in Diliman, Quezon City that makes things for fun :)
+77 Rd 1, 53 Rd 3 Bg-Asa QC
+Email:
+FinalFacility0828@gmail.com
+## 📄 License
+VertexEngine/Vertex is Managed by the MIT License. This license allows others to tweak the code. However, I would like my name be in the credits if you choose this as your starting ground for your next library.

vertexengine_cli-1.0/README.md

@@ -0,0 +1,124 @@
+# VertexEngine/Vertex
+VertexEngine is a GUI and Game Engine for python applications, it works best if you use py installer
+
+## Change Logs (1.0rc1 - 1.1rc4), NEW!
+### 1.1rc4
+- FINAL RC!
+- Added 2 New Libraries:
+    ~ VertexEngine.WebEngine
+    ~ VertexEngine.WebView
+### 1.1rc3
+- Revamped Input System!
+- DEMO GAMES!
+- Updated Scene Docs
+### Version 1.1rc2
+- Documentation Expansion!
+   ~ Fixed the Changelogs
+- New Input System!
+- Old System (Qt) depreceated and not recomended for use.
+### Version 1.1rc1
+- New Library! (And Modules)!:
+    ~ InputSystem
+       ~ Buttons (Mouse and Widget)
+       ~ Keyboard Input
+### Version 1.0.1
+- Added Changelogs!
+### Version 1.0
+- Added 2 New Libraries:
+    ~ VertexEngine.SimpleGUI
+    ~ VertexEngine.VertexScreenModifiers
+### Version 1.0rc2
+- Final Release Candidate
+- Added 1 New Library!:
+    ~ VertexUI
+
+### Version 1.0rc1
+- Size Compression
+- Added 1 New Library!:
+    ~ VertexScreen
+
+## How to install Pyinstaller
+Step 1. Type in:
+pip install pyinstaller
+
+Step 2. Wait a few min, don't worry if it takes 1 hr or more, it will finish
+
+Step 3. How to use pyinstaller
+type:
+python -m PyInstaller --onefile *.py
+
+There are flags:
+--noconsole > disables the console when you run the app
+--onefile > compress all of the code into one file
+--icon > the *.ico file after you type it will be set as the app icon.
+
+## How to install VertexEngine/Vertex:
+
+Step 1:
+Type in
+pip install VertexEngine
+
+Step 2: Wait a few min, don't worry if it takes 1 hr or more, it will finish
+
+Step 3: Where to start?
+Read the documentations. Also copy the following template:
+-------------------------------------------------------
+from VertexEngine.engine import GameEngine
+from VertexEngine import VertexScreen
+from VertexEngine.audio import AudioManager
+from VertexEngine.scenes import Scene
+import pygame
+import sys
+from PyQt6.QtGui import QIcon
+from PyQt6.QtWidgets import QApplication
+
+class Main(Scene):
+    def __init__(self, engine):
+        super().__init__(engine)
+        self.width = engine.width
+        self.height = engine.height
+
+    def update(self):
+        pass
+
+    def draw(self, surface):
+        VertexScreen.Draw.rect(VertexScreen.Draw, surface, (0, 255, 0), (-570, 350, 5000, 500))
+
+if __name__ == '__main__':
+    app = QApplication(sys.argv) # <- create app
+    engine = GameEngine(fps=60, width=1920, height=1080, title="Screen.com/totally-not-virus") # <- initialize a1080p window at 60 FPS
+
+    engine.setWindowTitle('Screen.com/totally-not-virus') # <- name the app
+    engine.setWindowIcon(QIcon('snake.ico')) # <- icon
+    engine.show() # <- show window
+
+    main_scene = Main(engine) # <- intialize the scene
+    engine.scene_manager.add_scene('main', main_scene) # <- name scene
+    engine.scene_manager.switch_to('main') # <- switch to the main scene pls
+
+    app.exec()
+
+The following template creates a window with a green rectangle (the ground.)
+
+Pygame or PyQt6 systems are compatible with Vertex so you can use pygame collision system or PyQt6's UI system in VertexEngine.
+
+## Help
+The documentation is in the following link:
+[Project Documentation](https://vertexenginedocs.netlify.app/) for help.
+
+## Dependencies
+Vertex obviously has heavy dependencies since it's a game engine, the following requirements are:
+
+| Dependency       | Version                              |
+|------------------|--------------------------------------|
+| PyQt6            | >=6.7                                |   
+| Pygame           | >=2.0                                |
+| Python           | >=3.10                               |
+
+## About Me ❔
+I Am a solo developer in Diliman, Quezon City that makes things for fun :)
+77 Rd 1, 53 Rd 3 Bg-Asa QC
+Email:
+FinalFacility0828@gmail.com
+## 📄 License
+VertexEngine/Vertex is Managed by the MIT License. This license allows others to tweak the code. However, I would like my name be in the credits if you choose this as your starting ground for your next library.

vertexengine_cli-1.0/pyproject.toml

@@ -0,0 +1,27 @@
+[build-system]
+requires = ["setuptools>=64", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "VertexEngine-CLI"
+version = "1.0"
+description = "An Offical CLI library for VertexEngine."
+authors = [
+  { name = "Tyrel Miguel", email = "annbasilan0828@gmail.com" }
+]
+readme = "README.md"
+license = { text = "MIT" }
+requires-python = ">=3.10"
+
+dependencies = [
+  "pygame>=2.0",
+  "PyQt6>=6.7",
+  "pyinstaller>=6.5.0",
+  "VertexEngine>=1.0.1"
+]
+
+[project.urls]
+Documentation = "https://vertexenginedocs.netlify.app/"
+
+[tool.setuptools.packages.find]
+where = ["src"]

vertexengine_cli-1.0/setup.cfg

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

vertexengine_cli-1.0/src/VertexEngine_CLI.egg-info/PKG-INFO

@@ -0,0 +1,138 @@
+Metadata-Version: 2.4
+Name: VertexEngine-CLI
+Version: 1.0
+Summary: An Offical CLI library for VertexEngine.
+Author-email: Tyrel Miguel <annbasilan0828@gmail.com>
+License: MIT
+Project-URL: Documentation, https://vertexenginedocs.netlify.app/
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: pygame>=2.0
+Requires-Dist: PyQt6>=6.7
+Requires-Dist: pyinstaller>=6.5.0
+Requires-Dist: VertexEngine>=1.0.1
+
+# VertexEngine/Vertex
+VertexEngine is a GUI and Game Engine for python applications, it works best if you use py installer
+
+## Change Logs (1.0rc1 - 1.1rc4), NEW!
+### 1.1rc4
+- FINAL RC!
+- Added 2 New Libraries:
+    ~ VertexEngine.WebEngine
+    ~ VertexEngine.WebView
+### 1.1rc3
+- Revamped Input System!
+- DEMO GAMES!
+- Updated Scene Docs
+### Version 1.1rc2
+- Documentation Expansion!
+   ~ Fixed the Changelogs
+- New Input System!
+- Old System (Qt) depreceated and not recomended for use.
+### Version 1.1rc1
+- New Library! (And Modules)!:
+    ~ InputSystem
+       ~ Buttons (Mouse and Widget)
+       ~ Keyboard Input
+### Version 1.0.1
+- Added Changelogs!
+### Version 1.0
+- Added 2 New Libraries:
+    ~ VertexEngine.SimpleGUI
+    ~ VertexEngine.VertexScreenModifiers
+### Version 1.0rc2
+- Final Release Candidate
+- Added 1 New Library!:
+    ~ VertexUI
+
+### Version 1.0rc1
+- Size Compression
+- Added 1 New Library!:
+    ~ VertexScreen
+
+## How to install Pyinstaller
+Step 1. Type in:
+pip install pyinstaller
+
+Step 2. Wait a few min, don't worry if it takes 1 hr or more, it will finish
+
+Step 3. How to use pyinstaller
+type:
+python -m PyInstaller --onefile *.py
+
+There are flags:
+--noconsole > disables the console when you run the app
+--onefile > compress all of the code into one file
+--icon > the *.ico file after you type it will be set as the app icon.
+
+## How to install VertexEngine/Vertex:
+
+Step 1:
+Type in
+pip install VertexEngine
+
+Step 2: Wait a few min, don't worry if it takes 1 hr or more, it will finish
+
+Step 3: Where to start?
+Read the documentations. Also copy the following template:
+-------------------------------------------------------
+from VertexEngine.engine import GameEngine
+from VertexEngine import VertexScreen
+from VertexEngine.audio import AudioManager
+from VertexEngine.scenes import Scene
+import pygame
+import sys
+from PyQt6.QtGui import QIcon
+from PyQt6.QtWidgets import QApplication
+
+class Main(Scene):
+    def __init__(self, engine):
+        super().__init__(engine)
+        self.width = engine.width
+        self.height = engine.height
+
+    def update(self):
+        pass
+
+    def draw(self, surface):
+        VertexScreen.Draw.rect(VertexScreen.Draw, surface, (0, 255, 0), (-570, 350, 5000, 500))
+
+if __name__ == '__main__':
+    app = QApplication(sys.argv) # <- create app
+    engine = GameEngine(fps=60, width=1920, height=1080, title="Screen.com/totally-not-virus") # <- initialize a1080p window at 60 FPS
+
+    engine.setWindowTitle('Screen.com/totally-not-virus') # <- name the app
+    engine.setWindowIcon(QIcon('snake.ico')) # <- icon
+    engine.show() # <- show window
+
+    main_scene = Main(engine) # <- intialize the scene
+    engine.scene_manager.add_scene('main', main_scene) # <- name scene
+    engine.scene_manager.switch_to('main') # <- switch to the main scene pls
+
+    app.exec()
+
+The following template creates a window with a green rectangle (the ground.)
+
+Pygame or PyQt6 systems are compatible with Vertex so you can use pygame collision system or PyQt6's UI system in VertexEngine.
+
+## Help
+The documentation is in the following link:
+[Project Documentation](https://vertexenginedocs.netlify.app/) for help.
+
+## Dependencies
+Vertex obviously has heavy dependencies since it's a game engine, the following requirements are:
+
+| Dependency       | Version                              |
+|------------------|--------------------------------------|
+| PyQt6            | >=6.7                                |   
+| Pygame           | >=2.0                                |
+| Python           | >=3.10                               |
+
+## About Me ❔
+I Am a solo developer in Diliman, Quezon City that makes things for fun :)
+77 Rd 1, 53 Rd 3 Bg-Asa QC
+Email:
+FinalFacility0828@gmail.com
+## 📄 License
+VertexEngine/Vertex is Managed by the MIT License. This license allows others to tweak the code. However, I would like my name be in the credits if you choose this as your starting ground for your next library.

vertexengine_cli-1.0/src/VertexEngine_CLI.egg-info/SOURCES.txt

@@ -0,0 +1,11 @@
+README.md
+pyproject.toml
+src/VertexEngine_CLI.egg-info/PKG-INFO
+src/VertexEngine_CLI.egg-info/SOURCES.txt
+src/VertexEngine_CLI.egg-info/dependency_links.txt
+src/VertexEngine_CLI.egg-info/requires.txt
+src/VertexEngine_CLI.egg-info/top_level.txt
+src/vertex/__init__.py
+src/vertex/__main__.py
+src/vertex/minicli.py
+src/vertex/templates.py

vertexengine_cli-1.0/src/VertexEngine_CLI.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

vertexengine_cli-1.0/src/VertexEngine_CLI.egg-info/requires.txt

@@ -0,0 +1,4 @@
+pygame>=2.0
+PyQt6>=6.7
+pyinstaller>=6.5.0
+VertexEngine>=1.0.1

vertexengine_cli-1.0/src/VertexEngine_CLI.egg-info/top_level.txt

@@ -0,0 +1 @@
+vertex

vertexengine_cli-1.0/src/vertex/__main__.py

@@ -0,0 +1,68 @@
+# __main__.py
+from pathlib import Path
+import os
+
+from PyInstaller.__main__ import run as pyinstaller_run
+
+from .minicli import CLI
+from .templates import TEMPLATES
+
+
+def main():
+    cli = CLI()
+
+    # ------------------
+    # build command
+    # ------------------
+    @cli.command("build")
+    def build_executable(
+        script_path: str,
+        onefile: bool = False,
+        windowed: bool = False,
+    ):
+        """
+        Build an executable from a Python script using PyInstaller.
+        """
+        if not os.path.isfile(script_path):
+            raise FileNotFoundError(f"Script not found: {script_path}")
+
+        args = ["--clean"]
+
+        if onefile:
+            args.append("--onefile")
+        if windowed:
+            args.append("--windowed")
+
+        args.append(script_path)
+
+        print(f"Running PyInstaller with args: {args}")
+        pyinstaller_run(args)
+
+    # ------------------
+    # init command
+    # ------------------
+    @cli.command("init")
+    def init(kind: str = "game"):
+        """Initialize a project template"""
+        if kind not in TEMPLATES:
+            print("Available templates:", ", ".join(TEMPLATES))
+            return
+
+        for rel_path, content in TEMPLATES[kind].items():
+            path = Path.cwd() / rel_path
+            path.parent.mkdir(parents=True, exist_ok=True)
+
+            if path.exists():
+                print(f"Skipped existing file: {rel_path}")
+                continue
+
+            path.write_text(content, encoding="utf-8")
+            print(f"Created {rel_path}")
+
+        print(f"Template '{kind}' initialized ✔")
+
+    cli.run()
+
+
+if __name__ == "__main__":
+    main()

vertexengine_cli-1.0/src/vertex/minicli.py

@@ -0,0 +1,58 @@
+# cli.py
+import sys
+import inspect
+from typing import Callable, Dict
+
+
+class Command:
+    def __init__(self, func: Callable, name: str):
+        self.func = func
+        self.name = name
+        self.help = func.__doc__ or ""
+        self.signature = inspect.signature(func)
+
+    def run(self, argv: list[str]):
+        params = list(self.signature.parameters.values())
+        args = []
+
+        for i, param in enumerate(params):
+            if i < len(argv):
+                args.append(argv[i])
+            elif param.default is not inspect.Parameter.empty:
+                args.append(param.default)
+            else:
+                raise SystemExit(f"Missing argument: {param.name}")
+
+        self.func(*args)
+
+
+class CLI:
+    def __init__(self):
+        self.commands: Dict[str, Command] = {}
+
+    def command(self, name: str | None = None):
+        def decorator(func: Callable):
+            cmd_name = name or func.__name__
+            self.commands[cmd_name] = Command(func, cmd_name)
+            return func
+        return decorator
+
+    def run(self, argv=None):
+        argv = argv or sys.argv[1:]
+
+        if not argv or argv[0] in {"-h", "--help"}:
+            self.help()
+            return
+
+        cmd, *args = argv
+        if cmd not in self.commands:
+            print(f"Unknown command: {cmd}\n")
+            self.help()
+            return
+
+        self.commands[cmd].run(args)
+
+    def help(self):
+        print("Available commands:\n")
+        for name, cmd in self.commands.items():
+            print(f"  {name:<12} {cmd.help}")

vertexengine_cli-1.0/src/vertex/templates.py

@@ -0,0 +1,49 @@
+# templates.py
+from textwrap import dedent
+
+TEMPLATES: dict[str, dict[str, str]] = {
+    "game": {
+        "main.py": dedent(
+            """\
+            from VertexEngine.engine import GameEngine
+            from VertexEngine import VertexScreen
+            from VertexEngine.scenes import Scene
+            import sys
+            from PyQt6.QtGui import QIcon
+            from PyQt6.QtWidgets import QApplication
+
+
+            class Main(Scene):
+                def __init__(self, engine):
+                    super().__init__(engine)
+                    self.width = engine.width
+                    self.height = engine.height
+
+                def update(self):
+                    pass
+
+                def draw(self, surface):
+                    VertexScreen.Draw.rect(
+                        VertexScreen.Draw,
+                        surface,
+                        (0, 255, 0),
+                        (-570, 350, 5000, 500),
+                    )
+
+
+            if __name__ == "__main__":
+                app = QApplication(sys.argv)
+                engine = GameEngine(fps=60, width=1920, height=1080)
+                engine.setWindowTitle("Template")
+                engine.show()
+
+                main_scene = Main(engine)
+                engine.scene_manager.set_scene(main_scene)
+
+                app.exec()
+            """
+        ),
+        "README.md": "# VertexEngine Game\n\nGenerated with MiniCLI ✨\n",
+        ".gitignore": "__pycache__/\n.env\n",
+   },
+}