kalido 1.0.0__tar.gz

kalido-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 SurfyGalaxy
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

kalido-1.0.0/PKG-INFO

@@ -0,0 +1,105 @@
+Metadata-Version: 2.4
+Name: kalido
+Version: 1.0.0
+Summary: A terminal colouriser
+Author-email: SurfyGalaxy <surfygalaxy@proton.me>
+License: MIT License
+        
+        Copyright (c) 2026 SurfyGalaxy
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+        
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pyyaml
+Dynamic: license-file
+
+# Kalido
+
+A python-based colouriser inspired by `lolcat` and `kekcat`, capable of handling both escape sequences and streamed input
+
+## Installation
+
+Kalido is easily downloaded, simply run:
+```bash
+pip install kalido
+```
+
+## Arguments
+
+```bash
+--stops <list> # Default = "random"
+--count <int> # Default = 5
+--size <int> # Default = 1
+```
+<br><hr><br>
+
+### --stops
+
+Define a list of hex codes which the gradient will go between, or alternatively use a premade template
+
+#### Examples:
+  `--stops "#000000" "#FFFFFF"` 
+  Creates a gradient between black and white
+
+  `--stops "#FFD800" "#790293" "#FFD800"`
+  Creates a gradient between yellow and purple, before returning to yellow
+
+  `--stops aroace`
+  Uses the premade gradient of the aroace flag
+
+#### Presets:
+- Rainbow
+- Lesbian
+- Gay (MLM)
+- Bisexual
+- Transgender
+- Queer
+- Intersex
+- Aroace
+- All (Combines every flag end-to-end)
+- Random (Will pick any preset)
+
+<hr>
+
+### --count
+
+Define how many additional colours the gradient will have between your stops
+
+Use `0` if you want there to be no additional colours added
+
+<hr>
+
+### --size
+
+Define how many characters each colour will cover.
+
+<br><hr><br>
+
+## Known bugs
+
+- Interactive programs sometimes will leak escape sequences
+
+## AI Disclaimer
+
+No AI was used to generate code nor this README

kalido-1.0.0/README.md

@@ -0,0 +1,69 @@
+# Kalido
+
+A python-based colouriser inspired by `lolcat` and `kekcat`, capable of handling both escape sequences and streamed input
+
+## Installation
+
+Kalido is easily downloaded, simply run:
+```bash
+pip install kalido
+```
+
+## Arguments
+
+```bash
+--stops <list> # Default = "random"
+--count <int> # Default = 5
+--size <int> # Default = 1
+```
+<br><hr><br>
+
+### --stops
+
+Define a list of hex codes which the gradient will go between, or alternatively use a premade template
+
+#### Examples:
+  `--stops "#000000" "#FFFFFF"` 
+  Creates a gradient between black and white
+
+  `--stops "#FFD800" "#790293" "#FFD800"`
+  Creates a gradient between yellow and purple, before returning to yellow
+
+  `--stops aroace`
+  Uses the premade gradient of the aroace flag
+
+#### Presets:
+- Rainbow
+- Lesbian
+- Gay (MLM)
+- Bisexual
+- Transgender
+- Queer
+- Intersex
+- Aroace
+- All (Combines every flag end-to-end)
+- Random (Will pick any preset)
+
+<hr>
+
+### --count
+
+Define how many additional colours the gradient will have between your stops
+
+Use `0` if you want there to be no additional colours added
+
+<hr>
+
+### --size
+
+Define how many characters each colour will cover.
+
+<br><hr><br>
+
+## Known bugs
+
+- Interactive programs sometimes will leak escape sequences
+
+## AI Disclaimer
+
+No AI was used to generate code nor this README

kalido-1.0.0/pyproject.toml

@@ -0,0 +1,25 @@
+[build-system]
+requires = ["setuptools>=77.0.3", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "kalido"
+version = "1.0.0"
+authors = [
+    {name = "SurfyGalaxy", email = "surfygalaxy@proton.me"},
+]
+description = "A terminal colouriser"
+readme = "README.md"
+requires-python = ">=3.8"
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+]
+license = {file = "LICENSE"}
+dependencies = [
+    "pyyaml",
+]
+
+[project.scripts]
+kalido = "kalido.__main__:main"

kalido-1.0.0/setup.cfg

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

kalido-1.0.0/src/kalido/__init__.py

@@ -0,0 +1 @@
+__version__ = "1.0.0"

kalido-1.0.0/src/kalido/__main__.py

@@ -0,0 +1,113 @@
+"""
+- Escape sequences start with \x1b
+- CSI sequences usually start with \x1b[
+- CSI sequences end with a single final byte in @ A-Z [ \\ ] ^ _ ` a-z ~
+- If the final byte is 'm', the sequence is a colour/style code (SGR)
+    → discard the entire sequence
+- Otherwise, preserve the sequence unchanged
+- Everything outside escape sequences is normal printable text
+"""
+
+import sys
+import os
+import pathlib
+import yaml
+from kalido import functions as func
+import argparse
+import random
+
+script_dir = pathlib.Path(__file__).parent
+presets_path = script_dir / "presets.yaml"
+with open(presets_path) as f: # Copied from my other project, Clide
+    presets = yaml.safe_load(f)
+
+STATE = "NORMAL"
+seq = ""
+rgb_stops = []
+
+sys.stdout.reconfigure(line_buffering=True)
+parser = argparse.ArgumentParser()
+
+parser.add_argument(
+    "--stops",
+    nargs="+",
+    default=["random"],
+    help="gradient color stops (hex values)",
+)
+parser.add_argument(
+    "--count",
+    type=int,
+    default=5,
+    help="The amount of intermediate values to add between stops",
+)
+parser.add_argument(
+    "--size",
+    type=int,
+    default=1,
+    help="How large each colour is before moving to next colour"
+)
+args = parser.parse_args()
+stops = args.stops
+count = args.count
+size = args.size
+# This is a list of hex codes with the # still
+
+if stops[0] in presets:
+    stops = presets[stops[0]]
+elif stops[0] == "random":
+    random_flag = random.choice(list(presets.keys()))
+    stops = presets[random_flag]
+
+    
+
+stops = func.create_gradient(stops, count)
+index = 0
+size_index = size
+
+while True:
+    c = sys.stdin.read(1)
+    if not c:
+        break
+
+    if STATE == "NORMAL":
+        if c == "\x1b":
+            STATE = "ESC"
+            seq = c
+        else:
+            sys.stdout.write(func.colourise(stops, c, index))
+            sys.stdout.flush()
+            if size_index != 1:
+                size_index -= 1
+            else:
+                if index == len(stops) -1:
+                    index = 0
+                else:
+                    index += 1
+                size_index = size
+
+    elif STATE == "ESC":
+        seq += c
+
+        if c == "[":
+            STATE = "CSI"
+        else:
+            # not CSI, just output and reset
+            sys.stdout.write(seq)
+            sys.stdout.flush()
+            STATE = "NORMAL"
+
+    elif STATE == "CSI":
+        seq += c
+
+        if '@' <= c <= '~':  # final byte
+
+            if c != "m":
+                sys.stdout.write(seq)  # keep non-colour sequences
+                sys.stdout.flush()
+
+            # always reset once
+            STATE = "NORMAL"
+            seq = ""
+
+sys.stdout.write('\n')
+sys.stdout.flush()

kalido-1.0.0/src/kalido/functions.py

@@ -0,0 +1,53 @@
+def hex_to_rbg(stops):
+    rgb_stops = []
+    stops = [code[1:] for code in stops] # Strip the leading # to make my life easier
+
+    for code in stops:
+        red = int(code[:2], 16)
+        green = int(code[2:4], 16)
+        blue = int(code[4:], 16)
+        rgb_stops.append((red, green, blue))
+    return rgb_stops
+
+def rgb_to_hex(stops):
+    hex_list = []
+    index = 0
+    for rgb in stops:
+        hex_colour = "#{:02X}{:02X}{:02X}".format(*stops[index])
+        hex_list.append(hex_colour)
+        index += 1
+    return hex_list
+    
+
+
+def create_gradient(stops, count):
+    stops = hex_to_rbg(stops) # to get pure RGB
+    percent = 1 / (count + 1)
+    gradient = [] 
+    segments = len(stops) - 1 # to count how many we need to generate
+
+    for index in range(segments):
+        red_1, green_1, blue_1 = stops[index]
+        red_2, green_2, blue_2 = stops[index + 1]
+
+        # Actually generate the parts
+        for step in range(count):
+            # Percent raises to fill out the gap
+            percent = step / count
+            
+            red = int(red_1 + (percent * (red_2 - red_1)))
+            green = int(green_1 + (percent * (green_2 - green_1)))
+            blue = int(blue_1 + (percent * (blue_2 - blue_1)))
+            
+            gradient.append((red, green, blue))
+            
+    # Tidy it up
+    gradient.append(stops[-1])
+    return gradient
+
+def colour_char(char: str, colour: tuple) -> str:
+    return f"\x1b[38;2;{colour[0]};{colour[1]};{colour[2]}m{char}\x1b[0m"
+
+def colourise(stops, char, index):
+    colour = stops[index]
+    return colour_char(char, colour)

kalido-1.0.0/src/kalido.egg-info/PKG-INFO

@@ -0,0 +1,105 @@
+Metadata-Version: 2.4
+Name: kalido
+Version: 1.0.0
+Summary: A terminal colouriser
+Author-email: SurfyGalaxy <surfygalaxy@proton.me>
+License: MIT License
+        
+        Copyright (c) 2026 SurfyGalaxy
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+        
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pyyaml
+Dynamic: license-file
+
+# Kalido
+
+A python-based colouriser inspired by `lolcat` and `kekcat`, capable of handling both escape sequences and streamed input
+
+## Installation
+
+Kalido is easily downloaded, simply run:
+```bash
+pip install kalido
+```
+
+## Arguments
+
+```bash
+--stops <list> # Default = "random"
+--count <int> # Default = 5
+--size <int> # Default = 1
+```
+<br><hr><br>
+
+### --stops
+
+Define a list of hex codes which the gradient will go between, or alternatively use a premade template
+
+#### Examples:
+  `--stops "#000000" "#FFFFFF"` 
+  Creates a gradient between black and white
+
+  `--stops "#FFD800" "#790293" "#FFD800"`
+  Creates a gradient between yellow and purple, before returning to yellow
+
+  `--stops aroace`
+  Uses the premade gradient of the aroace flag
+
+#### Presets:
+- Rainbow
+- Lesbian
+- Gay (MLM)
+- Bisexual
+- Transgender
+- Queer
+- Intersex
+- Aroace
+- All (Combines every flag end-to-end)
+- Random (Will pick any preset)
+
+<hr>
+
+### --count
+
+Define how many additional colours the gradient will have between your stops
+
+Use `0` if you want there to be no additional colours added
+
+<hr>
+
+### --size
+
+Define how many characters each colour will cover.
+
+<br><hr><br>
+
+## Known bugs
+
+- Interactive programs sometimes will leak escape sequences
+
+## AI Disclaimer
+
+No AI was used to generate code nor this README

kalido-1.0.0/src/kalido.egg-info/SOURCES.txt

@@ -0,0 +1,12 @@
+LICENSE
+README.md
+pyproject.toml
+src/kalido/__init__.py
+src/kalido/__main__.py
+src/kalido/functions.py
+src/kalido.egg-info/PKG-INFO
+src/kalido.egg-info/SOURCES.txt
+src/kalido.egg-info/dependency_links.txt
+src/kalido.egg-info/entry_points.txt
+src/kalido.egg-info/requires.txt
+src/kalido.egg-info/top_level.txt

kalido-1.0.0/src/kalido.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

kalido-1.0.0/src/kalido.egg-info/entry_points.txt

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

kalido-1.0.0/src/kalido.egg-info/requires.txt

@@ -0,0 +1 @@
+pyyaml

kalido-1.0.0/src/kalido.egg-info/top_level.txt

@@ -0,0 +1 @@
+kalido