pix8 0.0.1__tar.gz

pix8-0.0.1/PKG-INFO

@@ -0,0 +1,5 @@
+Metadata-Version: 2.4
+Name: pix8
+Version: 0.0.1
+Summary: Tiny fantasy console
+Requires-Dist: pygame

pix8-0.0.1/README.md

@@ -0,0 +1,77 @@
+# **📦 PIX-8 — Tiny Fantasy Console**
+
+PIX-8 is a minimal, retro-style fantasy console written in Python.  
+ It lets you create **tiny games** with a simple PEP-8-inspired Python cartridge format.
+
+---
+
+## **⚡ Features**
+
+* 128×128 pixel display
+
+* 16-color palette
+
+* Simple drawing API: `cls()`, `pset()`, `rectfill()`
+
+* Input: arrow keys \+ `Z/X` as buttons
+
+* PEP-8–style cartridges (`init(pix)`, `update(pix)`, `draw(pix)`)
+
+* Runs as a single Python file (`pix8.py`)
+
+---
+
+## **🏁 Installation**
+
+`git clone <repo-url>`  
+`cd pix8`  
+`pip install .`
+
+Or if you just want to run it locally without pip:
+
+`python pix8.py game.py`
+
+---
+
+## **🎮 Writing a Cartridge**
+
+Create a Python file, for example `game.py`:
+
+`metadata = {"title": "Tiny Demo"}`
+
+`def init(pix):`  
+    `pix.x = 60`  
+    `pix.y = 60`
+
+`def update(pix):`  
+    `if pix.btn("left"):`  
+        `pix.x -= 1`  
+    `if pix.btn("right"):`  
+        `pix.x += 1`
+
+`def draw(pix):`  
+    `pix.cls(1)`  
+    `pix.rectfill(pix.x, pix.y, 8, 8, 8)`
+
+Run it:
+
+`pix8 game.py`
+
+---
+
+## **🔑 API Reference**
+
+| Function | Description |
+| ----- | ----- |
+| `pix.cls(color=0)` | Clear the screen |
+| `pix.pset(x, y, color=7)` | Draw a single pixel |
+| `pix.rectfill(x, y, w, h, color=7)` | Draw a filled rectangle |
+| `pix.btn("left")` | Check if a button is pressed (`left`, `right`, `up`, `down`, `a`, `b`) |
+| `pix.flip()` | Update the screen and tick FPS |
+
+---
+
+## **📄 License**
+
+MIT License — free to use, modify, and share.
+

pix8-0.0.1/pix8/__main__.py

@@ -0,0 +1,164 @@
+"""
+PIX-8 Fantasy Console
+One-file edition
+"""
+
+import sys
+import pygame
+import importlib.util
+
+# ======================
+# HARDWARE SPEC
+# ======================
+
+WIDTH = 128
+HEIGHT = 128
+SCALE = 4
+FPS = 30
+
+PALETTE = [
+    (0, 0, 0),       # 0 black
+    (29, 43, 83),    # 1 dark blue
+    (126, 37, 83),   # 2 dark purple
+    (0, 135, 81),    # 3 dark green
+    (171, 82, 54),   # 4 brown
+    (95, 87, 79),    # 5 dark gray
+    (194, 195, 199), # 6 light gray
+    (255, 241, 232), # 7 white
+    (255, 0, 77),    # 8 red
+    (255, 163, 0),   # 9 orange
+    (255, 236, 39),  # 10 yellow
+    (0, 228, 54),    # 11 green
+    (41, 173, 255),  # 12 blue
+    (131, 118, 156), # 13 indigo
+    (255, 119, 168), # 14 pink
+    (255, 204, 170), # 15 peach
+]
+
+KEYMAP = {
+    "left": pygame.K_LEFT,
+    "right": pygame.K_RIGHT,
+    "up": pygame.K_UP,
+    "down": pygame.K_DOWN,
+    "a": pygame.K_z,
+    "b": pygame.K_x,
+    "start": pygame.K_RETURN,
+}
+
+# ======================
+# PIX-8 CONSOLE
+# ======================
+
+class Pix8:
+    """
+    Fantasy console object passed to cartridges.
+    Cartridges may attach arbitrary state to this object.
+    """
+
+    def __init__(self):
+        pygame.init()
+        self.window = pygame.display.set_mode(
+            (WIDTH * SCALE, HEIGHT * SCALE)
+        )
+        pygame.display.set_caption("PIX-8")
+
+        self.surface = pygame.Surface((WIDTH, HEIGHT))
+        self.clock = pygame.time.Clock()
+        self.keys = None
+
+    # ---- VIDEO API ----
+
+    def cls(self, color=0):
+        self.surface.fill(PALETTE[color % 16])
+
+    def pset(self, x, y, color=7):
+        if 0 <= x < WIDTH and 0 <= y < HEIGHT:
+            self.surface.set_at((int(x), int(y)), PALETTE[color % 16])
+
+    def rect(self, x, y, w, h, color=7):
+        pygame.draw.rect(
+            self.surface,
+            PALETTE[color % 16],
+            (x, y, w, h),
+            1,
+        )
+
+    def rectfill(self, x, y, w, h, color=7):
+        pygame.draw.rect(
+            self.surface,
+            PALETTE[color % 16],
+            (x, y, w, h),
+        )
+
+    # ---- INPUT API ----
+
+    def btn(self, name):
+        if self.keys is None:
+            return False
+        key = KEYMAP.get(name)
+        return bool(self.keys[key]) if key else False
+
+    # ---- FRAME END ----
+
+    def flip(self):
+        scaled = pygame.transform.scale(
+            self.surface,
+            self.window.get_size(),
+        )
+        self.window.blit(scaled, (0, 0))
+        pygame.display.flip()
+        self.clock.tick(FPS)
+
+# ======================
+# CARTRIDGE LOADER
+# ======================
+
+def load_cartridge(path):
+    spec = importlib.util.spec_from_file_location("cartridge", path)
+    module = importlib.util.module_from_spec(spec)
+    spec.loader.exec_module(module)
+    return module
+
+# ======================
+# RUNTIME
+# ======================
+
+def run(cart_path):
+    pix = Pix8()
+    cart = load_cartridge(cart_path)
+
+    if hasattr(cart, "metadata"):
+        title = cart.metadata.get("title", "PIX-8")
+        pygame.display.set_caption(title)
+
+    if hasattr(cart, "init"):
+        cart.init(pix)
+
+    running = True
+    while running:
+        pix.keys = pygame.key.get_pressed()
+
+        for event in pygame.event.get():
+            if event.type == pygame.QUIT:
+                running = False
+
+        if hasattr(cart, "update"):
+            cart.update(pix)
+
+        if hasattr(cart, "draw"):
+            cart.draw(pix)
+
+        pix.flip()
+
+    pygame.quit()
+
+# ======================
+# CLI ENTRY
+# ======================
+
+if __name__ == "__main__":
+    if len(sys.argv) < 2:
+        print("Usage: python pix8.py cartridge.py")
+        sys.exit(1)
+
+    run(sys.argv[1])

pix8-0.0.1/pix8.egg-info/PKG-INFO

@@ -0,0 +1,5 @@
+Metadata-Version: 2.4
+Name: pix8
+Version: 0.0.1
+Summary: Tiny fantasy console
+Requires-Dist: pygame

pix8-0.0.1/pix8.egg-info/SOURCES.txt

@@ -0,0 +1,9 @@
+README.md
+pyproject.toml
+pix8/__main__.py
+pix8.egg-info/PKG-INFO
+pix8.egg-info/SOURCES.txt
+pix8.egg-info/dependency_links.txt
+pix8.egg-info/entry_points.txt
+pix8.egg-info/requires.txt
+pix8.egg-info/top_level.txt

pix8-0.0.1/pix8.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

pix8-0.0.1/pix8.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+pix8 = pix8.__main__:main

pix8-0.0.1/pix8.egg-info/requires.txt

@@ -0,0 +1 @@
+pygame

pix8-0.0.1/pix8.egg-info/top_level.txt

@@ -0,0 +1 @@
+pix8

pix8-0.0.1/pyproject.toml

@@ -0,0 +1,8 @@
+[project]
+name = "pix8"
+version = "0.0.1"
+description = "Tiny fantasy console"
+dependencies = ["pygame"]
+
+[project.scripts]
+pix8 = "pix8.__main__:main"

pix8-0.0.1/setup.cfg

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