tipy-asm 1.0.0__py3-none-any.whl

ti84/__init__.py

@@ -0,0 +1,5 @@
+"""Editor-facing API declarations for TIpy calculator programs.
+
+Calculator source is compiled with ``ti84py``; this package is provided for
+editor completion and type checking, not for execution on a desktop Python.
+"""

ti84/__init__.pyi

@@ -0,0 +1,14 @@
+"""Built-in TIpy calculator libraries (editor declarations)."""
+
+from . import color as color
+from . import file as file
+from . import font as font
+from . import graph as graph
+from . import graphics as graphics
+from . import keyboard as keyboard
+from . import math as math
+from . import random as random
+from . import sprite as sprite
+from . import storage as storage
+
+__all__ = ["color", "file", "font", "graph", "graphics", "keyboard", "math", "random", "sprite", "storage"]

ti84/color.pyi

@@ -0,0 +1,37 @@
+"""Color library type stubs for TIpy calculator programs.
+
+These stubs describe the color library API for editor completion and type
+checking. They do not provide desktop Python runtime implementations.
+"""
+
+# RGB565 color constants
+BLACK: int
+WHITE: int
+RED: int
+GREEN: int
+BLUE: int
+YELLOW: int
+CYAN: int
+MAGENTA: int
+ORANGE: int
+PURPLE: int
+GRAY: int
+LIGHT_GRAY: int
+DARK_GRAY: int
+PALE_YELLOW: int
+PALE_PINK: int
+PALE_MINT: int
+PEACH: int
+MINT: int
+
+# Monochrome constants
+MONO_BLACK: int
+MONO_WHITE: int
+
+def from_rgb(r: int, g: int, b: int) -> int: ...
+def to_grayscale(rgb565: int) -> int: ...
+def to_mono(rgb565: int) -> int: ...
+def from_mono(mono: int) -> int: ...
+def is_valid(value: int) -> bool: ...
+def invert(rgb565: int) -> int: ...
+def blend(color1: int, color2: int, factor: float = 0.5) -> int: ...

ti84/file.pyi

@@ -0,0 +1,11 @@
+"""Persistent byte files backed by calculator AppVars (CE Flash Apps)."""
+
+def exists(name: str) -> bool: ...
+def size(name: str) -> int: ...
+def create(name: str, size: int) -> None: ...
+def delete(name: str) -> None: ...
+def clear(name: str) -> None: ...
+def read_byte(name: str, offset: int) -> int: ...
+def write_byte(name: str, offset: int, value: int) -> None: ...
+def read_u16(name: str, offset: int) -> int: ...
+def write_u16(name: str, offset: int, value: int) -> None: ...

ti84/font.pyi

@@ -0,0 +1,13 @@
+"""Color constants only. FontLibC fonts are not implemented; use graphics.text()."""
+
+BLACK: int
+WHITE: int
+RED: int
+GREEN: int
+BLUE: int
+YELLOW: int
+CYAN: int
+MAGENTA: int
+ORANGE: int
+PURPLE: int
+GRAY: int

ti84/graph.pyi

@@ -0,0 +1,4 @@
+"""Graphics drawing lifecycle functions."""
+
+def begin() -> None: ...
+def end() -> None: ...

ti84/graphics.pyi

@@ -0,0 +1,60 @@
+"""Screen drawing. This stub is the union of APIs from both backends.
+
+Backend-only functions are annotated below. Pixel coordinates use (0, 0) at
+the top left by default.
+"""
+
+from typing import Literal
+
+BLACK: int
+WHITE: int
+RED: int
+GREEN: int
+BLUE: int
+YELLOW: int
+CYAN: int
+MAGENTA: int
+ORANGE: int
+PINK: int
+PURPLE: int
+MINT: int
+PEACH: int
+PALE_YELLOW: int
+PALE_PINK: int
+PALE_MINT: int
+GRAY: int
+
+# Run `tipy-asm api graphics` to see which targets support each call.
+def begin() -> None: ...
+def end() -> None: ...
+def clear() -> None: ...
+# Flash App backend only; on assembly targets, pass a color to each drawing call.
+def set_color(color: int) -> int: ...
+def fill_screen(color: int = ...) -> None: ...
+def pixel(x: int, y: int, color: int = ...) -> None: ...
+# Assembly targets only; Flash App sprite support is not implemented.
+def sprite(pixels: tuple[tuple[int | None, ...], ...], x: int, y: int) -> None: ...
+# CE assembly and Flash App only.
+def get_pixel(x: int, y: int) -> int: ...
+def line(x1: int, y1: int, x2: int, y2: int, color: int = ...) -> None: ...
+def rect(x: int, y: int, width: int, height: int, color: int = ...) -> None: ...
+def rectangle(x: int, y: int, width: int, height: int, color: int = ...) -> None: ...
+def fill_rect(x: int, y: int, width: int, height: int, color: int = ...) -> None: ...
+def fill_rectangle(x: int, y: int, width: int, height: int, color: int = ...) -> None: ...
+def triangle(x1: int, y1: int, x2: int, y2: int, x3: int, y3: int, color: int = ...) -> None: ...
+def circle(x: int, y: int, radius: int, color: int = ...) -> None: ...
+def fill_circle(x: int, y: int, radius: int, color: int = ...) -> None: ...
+def horiz_line(x: int, y: int, length: int, color: int = ...) -> None: ...
+def vert_line(x: int, y: int, length: int, color: int = ...) -> None: ...
+def text(string: str, x: int, y: int, color: int = ..., *, origin: Literal["center", "top_left"] = ...) -> None: ...
+# CE assembly and Flash App only.
+def text_int(value: int, x: int, y: int, color: int = ...) -> None: ...
+# Assembly targets only; a simple delay loop.
+def delay(count: int) -> None: ...
+def wait_key() -> None: ...
+# Flash App backend only.
+def save_cursor(x: int, y: int) -> None: ...
+def restore_cursor() -> None: ...
+# Available on both backends; values depend on the selected target.
+width: int
+height: int

ti84/keyboard.pyi

@@ -0,0 +1,73 @@
+"""Calculator keypad input and key scan-code constants."""
+
+DOWN: int
+LEFT: int
+RIGHT: int
+UP: int
+ENTER: int
+ADD: int
+SUB: int
+MUL: int
+DIV: int
+POWER: int
+CLEAR: int
+CHS: int
+DECPNT: int
+VARS: int
+RPAREN: int
+TAN: int
+GRAPHVAR: int
+STORE: int
+LN: int
+LOG: int
+SQUARE: int
+RECIP: int
+MATH: int
+ALPHA: int
+COS: int
+PRGM: int
+STAT: int
+LPAREN: int
+SIN: int
+APPS: int
+COMMA: int
+KEY_0: int
+KEY_1: int
+KEY_2: int
+KEY_3: int
+KEY_4: int
+KEY_5: int
+KEY_6: int
+KEY_7: int
+KEY_8: int
+KEY_9: int
+GRAPH: int
+TRACE: int
+ZOOM: int
+WINDOW: int
+YEQU: int
+SECOND: int
+MODE: int
+DEL: int
+KEY_DOWN: int
+KEY_LEFT: int
+KEY_RIGHT: int
+KEY_UP: int
+KEY_ENTER: int
+KEY_ADD: int
+KEY_SUB: int
+KEY_MUL: int
+KEY_DIV: int
+KEY_POWER: int
+KEY_CLEAR: int
+KEY_GRAPH: int
+KEY_TRACE: int
+KEY_ZOOM: int
+KEY_WINDOW: int
+KEY_YEQU: int
+KEY_SECOND: int
+KEY_MODE: int
+KEY_DEL: int
+def read() -> int: ...
+def get() -> int: ...
+def is_down(key: int) -> bool: ...

ti84/math.pyi

@@ -0,0 +1,11 @@
+"""Integer math helpers. Available functions depend on the selected backend."""
+
+def abs(value: int) -> int: ...
+def min(a: int, b: int) -> int: ...
+def max(a: int, b: int) -> int: ...
+def clamp(value: int, low: int, high: int) -> int: ...
+def sqrt(value: int) -> int: ...
+def pow(base: int, exponent: int) -> int: ...
+def sign(value: int) -> int: ...
+def sin(degrees: int) -> int: ...
+def cos(degrees: int) -> int: ...

ti84/py.typed

@@ -0,0 +1 @@
+

ti84/random.pyi

@@ -0,0 +1,5 @@
+"""Deterministic pseudo-random helpers."""
+
+def seed(value: int) -> None: ...
+def randrange(limit: int) -> int: ...
+def randint(low: int, high: int) -> int: ...

ti84/sprite.pyi

@@ -0,0 +1,10 @@
+"""Sprites stored in AppVars, built by a project's [[tool.tipy.assets]]. CE assembly only.
+
+A sprite value is the address of its data, or 0 if the AppVar was not found.
+Use graphics.sprite() for literal sprites on the classic target.
+"""
+
+def load(name: str) -> int: ...
+def draw(sprite: int, x: int, y: int) -> None: ...
+def width(sprite: int) -> int: ...
+def height(sprite: int) -> int: ...

ti84/storage.pyi

@@ -0,0 +1,11 @@
+"""Byte storage backed by named calculator AppVars.
+
+exists(), size(), and delete() are assembly-only; ti84.file has them on both backends.
+"""
+
+def create(name: str, size: int) -> None: ...
+def exists(name: str) -> bool: ...
+def size(name: str) -> int: ...
+def delete(name: str) -> None: ...
+def read_byte(name: str, offset: int) -> int: ...
+def write_byte(name: str, offset: int, value: int) -> None: ...

ti84asm/__init__.py

@@ -0,0 +1 @@
+"""Compiler core package for TIpy-asm."""

ti84asm/__main__.py

@@ -0,0 +1,3 @@
+from .cli import main
+
+raise SystemExit(main())

ti84asm/cedev_config.py

@@ -0,0 +1,58 @@
+"""Wrapper for CEdev's cedev-config tool.
+
+This provides a pure-Python interface to query CEdev configuration,
+falling back to calling the actual cedev-config binary when needed.
+"""
+
+from __future__ import annotations
+
+import subprocess
+import sys
+from pathlib import Path
+
+from .errors import CompileError
+
+
+def _call_cedev_config(*args: str) -> str:
+    """Call the cedev-config binary and return its stdout."""
+    try:
+        cedev_config = "cedev-config"
+        if sys.platform == "win32":
+            # Try to find it in common locations on Windows
+            for path in ["C:\\CEDev\\bin\\cedev-config.exe", "C:\\CEDev\\cedev-config.exe"]:
+                if Path(path).is_file():
+                    cedev_config = path
+                    break
+        result = subprocess.run([cedev_config, *args], capture_output=True, text=True, check=True)
+        return result.stdout.strip()
+    except (subprocess.CalledProcessError, FileNotFoundError) as exc:
+        raise CompileError(f"cedev-config not found or failed: {exc}") from exc
+
+
+def get_version() -> str:
+    """Get the CE C/C++ Toolchain version."""
+    return _call_cedev_config("--version")
+
+
+def get_prefix() -> str:
+    """Get the installation prefix."""
+    return _call_cedev_config("--prefix")
+
+
+def get_makefile() -> str:
+    """Get the path to the core toolchain makefile."""
+    return _call_cedev_config("--makefile")
+
+
+def run(args: list[str]) -> str:
+    """Run cedev-config with the given arguments and return stdout."""
+    if not args:
+        raise CompileError("cedev-config requires at least one option")
+    return _call_cedev_config(*args)
+
+
+def add_arguments(parser):
+    """Add cedev-config command arguments."""
+    parser.add_argument("option", nargs="?",
+                        choices=["--version", "--prefix", "--makefile", "--help"],
+                        help="configuration option to query")