tooly-dev 1.5.0

Lightweight terminal utilities

tooly

Lightweight but powerful terminal utilities for Python developers.

---

Installation

pip install tooly-dev

---

Overview

tooly provides a collection of utilities to improve CLI applications:

• Colored output
• Interactive input & menus
• Logging & debugging
• Progress & visualization
• System helpers
• Scheduling & retries
• File saves & temp tools
• Data generation (lorem)

---

Quick Start

import tooly

colors = tooly.ColorSystem()
print(colors.info("Hello, Tooly!"))

---

Features

🎨 Colors & Text

colors = tooly.ColorSystem()

print(colors.info("Info"))
print(colors.success("Success"))
print(colors.error("Error"))

text = "Some interesting text"
print(colors.highlight(text, ["interesting"], "yellow"))

print(colors.indent("folder/", 0))
print(colors.indent("file.py", 1))

---

⌨️ Input & Interaction

userinput

name = tooly.userinput("Name: ", validator=str.isalpha)

menu

choice = tooly.menu(["Start", "Stop", "Exit"])

confirm

if tooly.confirm("Continue?"):
    pass

password

pwd = tooly.password("Password: ", confirm=True)

---

⏱️ Execution Helpers

typewrite

tooly.typewrite("Hello", delay=0.05)

measure

with tooly.measure("Task"):
    pass

spinner

with tooly.spinner("Loading"):
    pass

countdown

tooly.countdown(5)

---

🔍 Diff

tooly.diff_highlight(a, b, tooly.DiffMode.WORD)
tooly.diff_highlight(a, b, tooly.DiffMode.CHAR)
tooly.diff_highlight(a, b, tooly.DiffMode.LINE)

---

📊 Visualization

progress

for i in tooly.progress(range(100)):
    pass

sparkline

print(tooly.sparkline([1, 5, 3]))

calendar

tooly.calendar(title="Commits")

---

🧠 Logging

tooly.log.set_file("app.log")

tooly.log.info("Info")
tooly.log.success("Success")
tooly.log.warn("Warning")
tooly.log.error("Error")
tooly.log.debug("Debug")

---

🔁 Retry

@tooly.retry(attempts=3)
def fetch():
    pass

---

🔔 System & OS

cls

tooly.cls()

on_platform

tooly.on_platform(windows=lambda: "win")

notify

tooly.notify("Title", "Message")

---

📦 Files & Environment

env

url = tooly.env("DATABASE_URL", required=True)

run

tooly.run("ls -la")

tempdir

with tooly.tempdir() as tmp:
    pass

---

💾 Saves (Persistence)

# save
tooly.saves.save("test", data)

# load
data = tooly.saves.load("test")

# exists
tooly.saves.exists("test")

# delete
tooly.saves.delete("test")

# list
tooly.saves.list()

# info
tooly.saves.info("test")

# find
tooly.saves.find("test")

# clear all
tooly.saves.clear()

---

📈 Humanize

tooly.humanize(1500000, "bytes")
tooly.humanize(3600, "seconds")

---

🧪 Data Generation (Lorem)

lorem = tooly.Lorem()

lorem.words(10)
lorem.sentences(3)
lorem.paragraph(5)

lorem.name()
lorem.email()
lorem.phone()

---

⏰ Scheduler

@tooly.every(seconds=2)
def job():
    print("tick")

Control:

job.stop()
job.pause()
job.resume()

---

🎬 Recorder

with tooly.recorder("session.log"):
    print("recorded")

---

📺 Watch

def get_time():
    return "time"


tooly.watch(get_time, interval=1)

---

🎨 Banner

tooly.banner("Tooly")

---

License

MIT