Skip to main content

Advanced console UI framework for Python with colors, layouts, animations, themes, developer tools and interactive menus

Project description

🎨 FULLUI --- Console UI System

Build beautiful, interactive terminal apps --- fast.

FULLUI is a powerful and lightweight console UI framework for Python, designed to transform boring CLI programs into visually rich experiences.


✨ Features

  • 🎨 ANSI + RGB color system
  • 🌈 Advanced gradients
  • ✨ Text styling system
  • 🧱 Decorative boxes
  • 📝 Layout System
  • 🎮 Flexible alias-based system
  • ⚡ Terminal animations
  • 🎭 Plug & Play Theme Engine
  • 🛠 Developer Tools Panel
  • 📦 Modular architecture
  • ✅ 100% editable interfaces

🆕 New in v0.2.4

Improvements & Refinements

  • Fixed some problems
  • Functions arranged in scripts
  • More flexible custom color gradients
  • Internal optimizations
  • Functions implemented to create books and quizzes

🎯 Perfect For

  • Console games
  • CLI tools
  • Interactive terminal apps
  • UI prototyping
  • Terminal dashboards

📦 Installation

pip install fullui

✨ Verify Installation

python -c "import fullui; fullui.banner()"

🚀 Quick Start

from fullui import *

banner()

menu(
    t="Main Menu",
    op=[
        "Play",
        "Settings"
    ]
)

🧩 Recommended Import Style

from fullui.colors import C,S
from fullui.ui import menu
from fullui.layouts import panel

panel(
   "Profile",
   "Level 12"
)

choice = menu(
   t="Menu",
   op=["Start","Exit"]
)

🧠 Menu Behavior

  • Loops until valid input
  • Returns int
  • Invalid input handled automatically
  • Returns None on exit
choice = menu(
    t="Game",
    op=["Play","Settings"]
)

if choice == 1:
    print("Play")
elif choice is None:
    print("Exit")

🧠 Book Behavior

  • Pages interactive for commands
  • Long texts
  • Layout system
choice = book(
    pages = [
        "TEXT1"
        "TEXT2"
        "TEXT3"
    ]
    width= 60 
)

🧠 Quiz Behavior

  • Multiples uestions
  • Correct answer system
  • Result layout
quiz(
    t="QUIZ",
    
    qs=[
        {
            "question": "¿...?",
            "options": ["A", "B", "C"],
            "correct": 2
        },
        {
            "question": "¿?",
            "options": ["1", "2", "3"],
            "correct": 2
        },
        {
            "question": "¿?",
            "options": ["@", "#", "&"],
            "correct": 1
        }
    ],

    twn="¡Wonderfull!",
    tf="Fail",
    tmid="no bad"
)

🎨 Themes

from fullui import *

set_theme(NEON)

menu(
 t="Styled Menu",
 op=["Option A","Option B"]
)

Custom:

my_theme = create_theme(
    titleColor=C.r,
    inputColor=C.g
)

set_theme(my_theme)

📝 Layout System

Panel

panel(
 "Player",
 "HP:100\nMana:50"
)

Columns

columns(
 [
   "Inventory",
   "Map",
   "Stats"
 ]
)

Dashboard

dashboard([
 "CPU 40%",
 "RAM 62%",
 "ONLINE"
])

🎨 Colors

print(C.r+"Red"+S.rs)
print(S.bd+"Bold"+S.rs)

🌈 Gradients

print(rainbow("FULLUI"))

🎬 Animations

spinner()
glitch("ERROR")
progress_fill()
loading_dots()

🖥 UI Alias System

menu(
 t="Menu",
 st="Info",
 op=["A","B"]
)

Aliases:

t, st, op, bs...


🔧 Utilities

line_break # is "\n"
lb = line_break

p() #Print
clear() #Clear Console
pause() #Input pause

🧩 Full Import

from fullui import *

Everything exposed through __all__.


📄 License

MIT License


👨‍💻 Author

Leonardo Farid Porras Bendezú
aka LeonardX007

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

fullui-0.2.4.tar.gz (22.9 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

fullui-0.2.4-py3-none-any.whl (21.8 kB view details)

Uploaded Python 3

File details

Details for the file fullui-0.2.4.tar.gz.

File metadata

  • Download URL: fullui-0.2.4.tar.gz
  • Upload date:
  • Size: 22.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.4

File hashes

Hashes for fullui-0.2.4.tar.gz
Algorithm Hash digest
SHA256 e0531f79f6586ec4daeb1b568fe944fc4582d74c37c057138c88cf7dbe03c3cc
MD5 3ae399e7ab3c125db20bf058fd1ea14c
BLAKE2b-256 b126e22f4a659fec057d4cf78cc63f65f7a74b8e1ef85cdfb0cc6996eb00cc7c

See more details on using hashes here.

File details

Details for the file fullui-0.2.4-py3-none-any.whl.

File metadata

  • Download URL: fullui-0.2.4-py3-none-any.whl
  • Upload date:
  • Size: 21.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.4

File hashes

Hashes for fullui-0.2.4-py3-none-any.whl
Algorithm Hash digest
SHA256 6166f349e21b85d747cd47a761dfbb336998f46fdb14bf211bc94a6d9edcfcbd
MD5 a4cea15d675aa28becdf9d2da43eeddc
BLAKE2b-256 5c129da7d700d18ed169e22552ee54f09050ebbea0c4f1c27625571d8cdc698f

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page