VertexEngine-CLI 1.0__py3-none-any.whl

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()

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}")

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",
+   },
+}

vertexengine_cli-1.0.dist-info/METADATA

@@ -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.dist-info/RECORD

@@ -0,0 +1,8 @@
+vertex/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+vertex/__main__.py,sha256=E3eoBSHIrM5QSmZKWZQRwjEE7IwNy4dykLZNsu5USfQ,1726
+vertex/minicli.py,sha256=BhpqfYq5eEhwVkAa7I0AycjDmTlQ4q3S0DbSHKxLQgs,1554
+vertex/templates.py,sha256=q4ZLYaieb2GVlgt0t7svo8B8emw_x4Jetca1kprTacI,1532
+vertexengine_cli-1.0.dist-info/METADATA,sha256=g0K7T0VjLcHZPUSWAYKopWhglu98WYK5tCdaYxYwVB4,4526
+vertexengine_cli-1.0.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+vertexengine_cli-1.0.dist-info/top_level.txt,sha256=hUfBmDVpG0gMBhuaAWLQqXDZQkqBdFPWZY7O9NNajVg,7
+vertexengine_cli-1.0.dist-info/RECORD,,

vertexengine_cli-1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.10.2)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

vertexengine_cli-1.0.dist-info/top_level.txt

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