A Python library for managing and accessing cute emoji symbols in your applications. Perfect for adding visual flair to your console output, logging, or user interfaces!
- π Easy Access: Direct access to symbols using simple attribute syntax
- π Smart Search: Powerful regex-based search with case-insensitive matching
- π Organized Categories: Symbols grouped by purpose (State, Activity, Emotion, Objects)
- π Reverse Lookup: Find symbol names and groups from emoji values
- π Complete Listing: List all available symbols with their metadata
- π οΈ Developer Friendly: Full type hints and comprehensive documentation
CHECKβ - Success indicatorCROSSβ - Error indicatorWARNINGβ οΈ - Warning indicatorINFOβΉοΈ - Information indicatorSUCCESSβοΈ - Success markerFAILUREβοΈ - Failure markerQUESTIONβ - Question marker
ROCKETπ - Launch/start indicatorLOOPπ - Process/refresh indicatorCLOCKβ±οΈ - Timing indicatorHOURGLASSβ³ - Loading indicatorFLASHβ‘ - Speed/power indicator
THINKπ€ - Thinking indicatorBRAINπ§ - Intelligence indicatorLIGHTπ‘ - Idea indicatorFIREπ₯ - Hot/trending indicatorMAGICβ¨ - Special indicatorSTARβ - Favorite indicatorEYESπ - Attention indicator
FOLDERπ - Directory indicatorGEARβοΈ - Settings indicatorTOOLπ οΈ - Tool/utility indicatorBUGπ - Bug/issue indicator
from cuteSymbols import CuteSymbols
# Create an instance
symbols = CuteSymbols()
# Access symbols directly
print(f"Task completed {symbols.CHECK}") # Task completed β
print(f"Loading {symbols.HOURGLASS}") # Loading β³ print(f"Great idea {symbols.LIGHT}") # Great idea π‘fire_emoji = symbols.FIRE # π₯ fire_emoji = symbols.fire # π₯ fire_emoji = symbols.Fire # π₯ fire_emoji = symbols.fIrE # π₯
check_emoji = symbols.CHECK # β
check_emoji = symbols.check # β
check_emoji = symbols.Check # β
rocket_emoji = symbols.ROCKET # π rocket_emoji = symbols.rocket # π
# Use in your applications with any case style you prefer
print(f"Deployment started {symbols.rocket}") # π print(f"Tests passed {symbols.SUCCESS}") # βοΈ print(f"Found issue {symbols.bug}") # πThe search() method provides powerful pattern matching:
# Simple text search (case-insensitive by default)
results = CuteSymbols.search("fire")
# Returns: [('Emotion', 'FIRE', 'π₯')]
# Search by emoji
results = CuteSymbols.search("π₯")
# Returns: [('Emotion', 'FIRE', 'π₯')]
# Regex patterns
results = CuteSymbols.search(r"^F") # Symbols starting with 'F'
# Returns: [('Emotion', 'FIRE', 'π₯'), ('State', 'FAILURE', 'βοΈ'), ('Objects', 'FOLDER', 'π')]
# Advanced regex with custom flags
import re results = CuteSymbols.search(r"fire", flags=0) # Case-sensitive results = CuteSymbols.search(r"f.*e$", flags=re.MULTILINE) # Multi-line patternFind information about emojis:
# Get complete info (name and group)
info = CuteSymbols.info_from_emoji("π₯")
# Returns: ('FIRE', 'Emotion')
# Get just the name
name = CuteSymbols.name_from_emoji("β
")
# Returns: 'CHECK'
# Handle unknown emojis
info = CuteSymbols.info_from_emoji("π")
# Returns: None# Get all symbols as tuples (group, name, value)
all_symbols = CuteSymbols.list_all()
# Returns: [('State', 'CHECK', 'β
'), ('State', 'CROSS', 'β'), ...]
# Print a formatted table
CuteSymbols.print_table()from cuteSymbols import CuteSymbols
symbols = CuteSymbols()
def log_status(message, status): if status == "success": print(f"{symbols.CHECK} {message}") elif status == "error": print(f"{symbols.CROSS} {message}") elif status == "warning": print(f"{symbols.WARNING} {message}") else: print(f"{symbols.INFO} {message}")
# Usage
log_status("Database connected", "success") # β
Database connected log_status("Connection timeout", "error") # β Connection timeout log_status("Memory usage high", "warning") # β οΈ Memory usage highimport time from cuteSymbols import CuteSymbols
symbols = CuteSymbols()
def show_progress(task_name): print(f"{symbols.HOURGLASS} Starting {task_name}...") time.sleep(1) print(f"{symbols.LOOP} Processing {task_name}...") time.sleep(1) print(f"{symbols.FLASH} Finalizing {task_name}...") time.sleep(1) print(f"{symbols.CHECK} {task_name} completed!")
show_progress("Data Analysis")# Find all symbols containing "tool"
tools = CuteSymbols.search("tool") for group, name, emoji in tools: print(f"{emoji} {name} (from {group})")
# Find all fire-related symbols
fire_symbols = CuteSymbols.search("fire") print(f"Fire symbols: {[emoji for _, _, emoji in fire_symbols]}")
# Search by pattern
question_symbols = CuteSymbols.search(r".*TION") # Ends with "TION"import re
# Case-sensitive search
results = CuteSymbols.search("Fire", flags=0) # Won't find "FIRE"
# Multi-line patterns
results = CuteSymbols.search(r"^FIRE$", flags=re.MULTILINE)
# Combine multiple flags
results = CuteSymbols.search(r"pattern", flags=re.MULTILINE | re.DOTALL)# With logging
import logging from cuteSymbols import CuteSymbols
symbols = CuteSymbols()
# Custom formatter
class EmojiFormatter(logging.Formatter): def format(self, record): if record.levelno == logging.ERROR: record.msg = f"{symbols.CROSS} {record.msg}" elif record.levelno == logging.WARNING: record.msg = f"{symbols.WARNING} {record.msg}" elif record.levelno == logging.INFO: record.msg = f"{symbols.INFO} {record.msg}" return super().format(record)# Handle search errors
try: results = CuteSymbols.search("[invalid regex") except ValueError as e: print(f"{symbols.CROSS} Search error: {e}")
# Handle missing symbols
try: info = CuteSymbols.info_from_emoji(None) except AttributeError as e: print(f"{symbols.WARNING} {e}")# Clone the repository
git clone [https://github.com/yourusername/cutesymbols.git](https://github.com/yourusername/cutesymbols.git) cd cutesymbols
# Run tests
python -m unittest tests/tests.py -vsearch(pattern, flags=re.IGNORECASE)- Search symbols by patterninfo_from_emoji(emoji)- Get name and group from emojiname_from_emoji(emoji)- Get symbol name from emojilist_all()- Get all symbols as tuplesprint_table()- Print formatted symbol table
Access any symbol directly: symbols.FIRE, symbols.CHECK, etc.
Contributions are welcome! Please feel free to submit issues and pull requests.
This project is licensed under the MIT License.
Made with π‘ and π₯ by the CuteSymbols team!