PyTermint 0.0.2__tar.gz → 0.0.4__tar.gz

{pytermint-0.0.2 → pytermint-0.0.4}/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: PyTermint
-Version: 0.0.2
-Summary: A terminal interface that abstracts it into a tilemap with 3 bit rgb support for charecter fore/background.
+Version: 0.0.4
+Summary: A simple, light weight (under 27k), and 'No Dependencies' (except in linux but has auto fallbacks) terminal interface that abstracts complex ansi codes into a tilemap with 3 bit rgb support for charecter fore/background.
 Project-URL: Homepage, https://github.com/Antlar256/PyTerm
 Project-URL: Issues, https://github.com/Antlar256/PyTerm/issues
 Author-email: Antlar256 <antonio0granell2@gmail.com>
@@ -12,8 +12,8 @@ Classifier: Programming Language :: Python :: 3
 Requires-Python: >=3.9
 Description-Content-Type: text/markdown
 
-# PyTerm
-This is a cross-platform terminal abstraction that converts a tile map to a non-flickering terminal output with 3 bit rgb support using escape codes. It also has significant amounts of input automation for things like typing and movement. It clocks in at around 26.5k bytes (k is 1024) and has no significant dependencies outside of the [***Python Standard Library***](https://docs.python.org/3/library/index.html) (*other than evdev for linux input but it handles the lack of this automatically*).
+# PyTermint
+This is a cross-platform terminal abstraction that converts a tile map to a non-flickering terminal output with 3 bit rgb support using escape codes. It also has significant amounts of input automation for things like typing and movement. It clocks in at just under 27k bytes (k is 1024) *(uncompressed, It goes down to 16k just with windows file compression)* and has no significant dependencies outside of the [***Python Standard Library***](https://docs.python.org/3/library/index.html) (*other than evdev for linux input but it handles the lack of this automatically*). While ~27k bytes sounds like a lot this is boiler plate not in your project which means a full colored snake game comes in at around 2.2k bytes. It also has a large amount of graphics macros for things like drawing a window, a line, a rectangle or a text_box. Through gplot() the horozontal and vertical resolution are doubled into a 1bpp bitmap with 2x2 pixel 3bpp rgb attribute coloring. The array is edited and read through screen[y][x].
 ***
 * **Install with "*pip install PyTermint*"** 
 * **Import as "*import PyTerm*"**
@@ -21,8 +21,8 @@ This is a cross-platform terminal abstraction that converts a tile map to a non-
 * **Create a *tick()* command that takes as inputs *tick(screen, vars, keys)*. Screen is an array, vars is the dict you initialized in *init* and keys which is a set of every key thats pressed**
 * **Call the *run(tick_func, init_func)***
 ***
-```i
-mport PyTerm as pt
+```w
+import PyTerm as pt
 from PyTerm import clear, blit, color, TILE_SET, HEIGHT, WIDTH, pressed
 
 def init(screen):

{pytermint-0.0.2 → pytermint-0.0.4}/README.md

@@ -1,5 +1,5 @@
-# PyTerm
-This is a cross-platform terminal abstraction that converts a tile map to a non-flickering terminal output with 3 bit rgb support using escape codes. It also has significant amounts of input automation for things like typing and movement. It clocks in at around 26.5k bytes (k is 1024) and has no significant dependencies outside of the [***Python Standard Library***](https://docs.python.org/3/library/index.html) (*other than evdev for linux input but it handles the lack of this automatically*).
+# PyTermint
+This is a cross-platform terminal abstraction that converts a tile map to a non-flickering terminal output with 3 bit rgb support using escape codes. It also has significant amounts of input automation for things like typing and movement. It clocks in at just under 27k bytes (k is 1024) *(uncompressed, It goes down to 16k just with windows file compression)* and has no significant dependencies outside of the [***Python Standard Library***](https://docs.python.org/3/library/index.html) (*other than evdev for linux input but it handles the lack of this automatically*). While ~27k bytes sounds like a lot this is boiler plate not in your project which means a full colored snake game comes in at around 2.2k bytes. It also has a large amount of graphics macros for things like drawing a window, a line, a rectangle or a text_box. Through gplot() the horozontal and vertical resolution are doubled into a 1bpp bitmap with 2x2 pixel 3bpp rgb attribute coloring. The array is edited and read through screen[y][x].
 ***
 * **Install with "*pip install PyTermint*"** 
 * **Import as "*import PyTerm*"**
@@ -7,8 +7,8 @@ This is a cross-platform terminal abstraction that converts a tile map to a non-
 * **Create a *tick()* command that takes as inputs *tick(screen, vars, keys)*. Screen is an array, vars is the dict you initialized in *init* and keys which is a set of every key thats pressed**
 * **Call the *run(tick_func, init_func)***
 ***
-```i
-mport PyTerm as pt
+```w
+import PyTerm as pt
 from PyTerm import clear, blit, color, TILE_SET, HEIGHT, WIDTH, pressed
 
 def init(screen):

{pytermint-0.0.2 → pytermint-0.0.4}/pyproject.toml

@@ -1,10 +1,10 @@
 [project]
 name = "PyTermint"
-version = "0.0.2"
+version = "0.0.4"
 authors = [
   { name="Antlar256", email="antonio0granell2@gmail.com" },
 ]
-description = "A terminal interface that abstracts it into a tilemap with 3 bit rgb support for charecter fore/background."
+description = "A simple, light weight (under 27k), and 'No Dependencies' (except in linux but has auto fallbacks) terminal interface that abstracts complex ansi codes into a tilemap with 3 bit rgb support for charecter fore/background."
 readme = "README.md"
 requires-python = ">=3.9"
 classifiers = [

{pytermint-0.0.2 → pytermint-0.0.4}/src/PyTermint/PyTerm.py

@@ -1,8 +1,8 @@
 #PyTerm.py
 """
-This is a terminal engine which is desined to be imported by other python files to use its features.\
+This is a terminal engine which is desined to be imported by other python files to use its features. The array is edited and read through screen[y][x]
 init(screen); return bg_buffer, {vars dict}, "optional command string"
-tick(screen, vars, keys); return None
+tick(screen, vars, keys): return None
 
 """
 import sys, time, os, random, collections, re, ctypes
@@ -231,10 +231,8 @@ def handle_input(v, keys, multiline=True, cursor_pos_name="cpos", use_text_from_
             
     if pressed(keys, 'delete'):
         if cx < len(lines[ly]):
-            # Remove character at current cursor position
             lines[ly] = lines[ly][:cx] + lines[ly][cx+1:]
         elif ly < len(lines) - 1:
-            # At end of line: pull the line below up to this line
             lines[ly] += lines[ly+1]
             lines.pop(ly + 1)
 
@@ -257,33 +255,6 @@ def handle_input(v, keys, multiline=True, cursor_pos_name="cpos", use_text_from_
     if use_text_from_vars: v[text_name] = "\n".join(lines)
     else: return "\n".join(lines)
 
-def draw_window(arr, x, y, sx, sy, color_offset=0, char=None):
-    if isinstance(char, int):
-        for xi in range(x, sx):
-            for yi in range(y, sy):
-                if inside(arr, (xi, yi)):
-                    arr[yi][xi] = char
-    for i in range(x, x + sx):
-        if inside(arr, (i, y)):
-            arr[y][i] = 101 + color_offset
-    for i in range(y, y + sy):
-        if inside(arr, (x, i)):
-            arr[i][x] = 100 + color_offset
-    for i in range(x, x + sx):
-        if inside(arr, (i, y + sy)):
-            arr[y + sy][i] = 101 + color_offset
-    for i in range(y, y + sy):
-        if inside(arr, (x + sx, i)):
-            arr[i][x + sx] = 100 + color_offset
-    if inside(arr, (x, y)):
-        arr[y][x] = 96 + color_offset
-    if inside(arr, (x + sx, y)):
-        arr[y][x + sx] = 99 + color_offset
-    if inside(arr, (x + sx, y + sy)):
-        arr[y + sy][x + sx] = 97 + color_offset
-    if inside(arr, (x, y + sy)):
-        arr[y + sy][x] = 98 + color_offset
-
 
 # --- sound ---
 
@@ -409,6 +380,7 @@ def bin_to_csv(bin_path):
 
 # Dim: gets the dimensions of an array
 def dim(arr): 
+    """returns the length of an array as (width, height)"""
     try: return len(arr[0]), len(arr)
     except: return (0, 0)
 
@@ -446,7 +418,7 @@ for index, char in enumerate(TILE_SET):
 # ANSI Colors (Foreground/background): Defualt 0, Black 1, White 2, Red 3, Green 4, Yellow 5, Blue 6, Magenta 7, Cyan 8
 ANSI_COLORS = ["0","30","37","31","32","33","34","35","36"]
 
-def color(tile, fg=2 , bg=1, invert=False):
+def color(tile=0, fg=2 , bg=1, invert=False):
     if isinstance(tile, str):
         temp_tile = []
         for char in list(tile):
@@ -479,50 +451,73 @@ def plot(screen, char, x, y, color=0):
 def gplot(screen, x, y, state, color_idx):
     tx, ty = x // 2, y // 2
     if not inside(screen, (tx, ty)): return
-    t_len = len(TILE_SET);current_val = screen[ty][tx];char_idx = current_val % t_len
-    color_bits = current_val // t_len;curr_fg = (color_bits >> 4) & 0xF
-    curr_bg = color_bits & 0xF
+    t_len = len(TILE_SET); current_val = screen[ty][tx]
+    char_idx = current_val % t_len; color_bits = current_val // t_len
+    if (not (char_idx >= 64 and char_idx <= 78)) and inside(screen, (x, y)):
+        tbgc = getbg(screen, (x, y)); screen[y][x] = color(char_idx, color_idx, tbgc)
+    curr_fg = (color_bits >> 4) & 0xF; curr_bg = color_bits & 0xF
     raw_matrix = ilow_res.get(char_idx, ((0,0),(0,0)))
     matrix = [list(row) for row in raw_matrix] 
     if state:
-        if matrix == [[0,0],[0,0]]:
-            curr_fg = color_idx
-        elif color_idx == curr_bg and color_idx != curr_fg:
+        if color_idx == curr_bg:
             curr_fg, curr_bg = curr_bg, curr_fg
-            for row in range(2):
-                for col in range(2): matrix[row][col] = 1 - matrix[row][col]
-        elif color_idx != curr_fg: curr_fg = color_idx
+            for r in range(2):
+                for c in range(2): 
+                    matrix[r][c] = 1 - matrix[r][c]
+        curr_fg = color_idx
     matrix[y % 2][x % 2] = 1 if state else 0
     lookup_matrix = tuple(tuple(row) for row in matrix)
-    new_char_idx = low_res.get(lookup_matrix, 0)
-    new_color_bits = (curr_fg << 4) | curr_bg
+    new_char_idx = low_res.get(lookup_matrix, 0); new_color_bits = (curr_fg << 4) | curr_bg
     screen[ty][tx] = new_char_idx + (t_len * new_color_bits)
 
-def draw_box(arr, start_x, start_y, width, height, fg=0, bg=1, invert=False):
+def draw_box(arr, start_x, start_y, width, height, fg=2, bg=1, invert=False, vertical_border=0, horozontal_border=0):
     """Draws a box."""
     for y in range(start_y, start_y + height):
         if 0 <= y < len(arr):
-            if 0 <= start_x < len(arr[y]): arr[y][start_x] = color(5, fg, bg, invert)
-            if 0 <= start_x + 1 < len(arr[y]): arr[y][start_x + 1] = color(5, fg, bg, invert)
-            if 0 <= start_x + width - 2 < len(arr[y]): arr[y][start_x + width - 2] = color(5, fg, bg, invert)
-            if 0 <= start_x + width - 1 < len(arr[y]): arr[y][start_x + width - 1] = color(5, fg, bg, invert)
+            if 0 <= start_x < len(arr[y]): arr[y][start_x] = color(vertical_border, fg, bg, invert)
+            if 0 <= start_x + 1 < len(arr[y]): arr[y][start_x + 1] = color(vertical_border, fg, bg, invert)
+            if 0 <= start_x + width - 2 < len(arr[y]): arr[y][start_x + width - 2] = color(vertical_border, fg, bg, invert)
+            if 0 <= start_x + width - 1 < len(arr[y]): arr[y][start_x + width - 1] = color(vertical_border, fg, bg, invert)
     for x in range(start_x, start_x + width):
-        if 0 <= start_y < len(arr) and 0 <= x < len(arr[0]): arr[start_y][x] = color(13, fg, bg, invert)
-        if 0 <= start_y + height - 1 < len(arr) and 0 <= x < len(arr[0]): arr[start_y + height - 1][x] = color(13, fg, bg, invert)
+        if 0 <= start_y < len(arr) and 0 <= x < len(arr[0]): arr[start_y][x] = color(horozontal_border, fg, bg, invert)
+        if 0 <= start_y + height - 1 < len(arr) and 0 <= x < len(arr[0]): arr[start_y + height - 1][x] = color(horozontal_border, fg, bg, invert)
+    for y in range(start_y, start_y + height):
+        for x in range(start_x, start_x + width):
+            if inside(arr, (x, y)):
+                arr[y][x] = color(0, fg, bg)
+
+    
 
 def draw_tri(arr, sx, sy, ph, color_ = 0):
     for o in range(ph):
         if inside(arr, (sx, sy)): arr[sy][sx] = 3 + color_
-        sx += 1
-        sy -= 1
+        sx += 1; sy -= 1
         
     if inside(arr, (sx, sy)): arr[sy][sx] = 3 + color_
     sx += 1
     for o in range(ph):
         if inside(arr, (sx, sy)): arr[sy][sx] = 4 + color_
-        sx += 1
-        sy += 1
+        sx += 1; sy += 1
     if inside(arr, (sx, sy)): arr[sy][sx] = 4 + color_
+
+def draw_window(arr, x, y, sx, sy, color_offset=0, char=None):
+    if isinstance(char, int):
+        for xi in range(x, x +sx):
+            for yi in range(y, y + sy):
+                if inside(arr, (xi, yi)): arr[yi][xi] = char
+    for i in range(x, x + sx):
+        if inside(arr, (i, y)): arr[y][i] = 101 + color_offset
+    for i in range(y, y + sy):
+        if inside(arr, (x, i)): arr[i][x] = 100 + color_offset
+    for i in range(x, x + sx):
+        if inside(arr, (i, y + sy)): arr[y + sy][i] = 101 + color_offset
+    for i in range(y, y + sy):
+        if inside(arr, (x + sx, i)): arr[i][x + sx] = 100 + color_offset
+    if inside(arr, (x, y)): arr[y][x] = 96 + color_offset
+    if inside(arr, (x + sx, y)): arr[y][x + sx] = 99 + color_offset
+    if inside(arr, (x + sx, y + sy)): arr[y + sy][x + sx] = 97 + color_offset
+    if inside(arr, (x, y + sy)): arr[y + sy][x] = 98 + color_offset
+
 def blit(arr0, arr1, sx, sy):
     w, h = dim(arr1)
     for y in range(h):
@@ -531,6 +526,32 @@ def blit(arr0, arr1, sx, sy):
                 t = arr1[y][x]
                 if t >= 0: arr0[y + sy][x + sx] = t
 
+def draw_text_box(arr, x, y, text, text_color, box_color=0):
+    text_array = str_to_arr(text, text_color)
+    w, h = dim(text_array)
+    draw_window(arr, x, y, w + 1, h + 1, box_color)
+    blit(arr, text_array, x + 1, y + 1)
+
+def draw_line(arr, x0, y0, x1, y1, color_offset):
+    dx = abs(x1 - x0)
+    dy = -abs(y1 - y0)
+    sx = 1 if x0 < x1 else -1
+    sy = 1 if y0 < y1 else -1
+    err = dx + dy
+
+    while True:
+        gplot(arr, x0, y0, 1, color_offset)
+        if x0 == x1 and y0 == y1:
+            break
+        
+        e2 = 2 * err
+        if e2 >= dy:
+            err += dy
+            x0 += sx
+        if e2 <= dx:
+            err += dx
+            y0 += sy
+
 def getfg(arr, xy):
     """Returns the foreground color index of a tile at (x, y)."""
     x, y = xy
@@ -545,7 +566,7 @@ def getbg(arr, xy):
     x, y = xy
     if not inside(arr, xy): return 1
     val = arr[y][x];t_len = len(TILE_SET)
-    if val < t_len:return 1
+    if val < t_len:return 0
     color_bits = val // t_len;bg_idx = color_bits & 0xF
     return bg_idx