Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

16 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

CuteSymbols πŸ”₯

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!

✨ Features

  • πŸš€ 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

🎯 Available Symbol Categories

State βœ…

  • CHECK βœ… - Success indicator
  • CROSS ❌ - Error indicator
  • WARNING ⚠️ - Warning indicator
  • INFO ℹ️ - Information indicator
  • SUCCESS βœ”οΈ - Success marker
  • FAILURE βœ–οΈ - Failure marker
  • QUESTION ❓ - Question marker

Activity πŸš€

  • ROCKET πŸš€ - Launch/start indicator
  • LOOP πŸ”„ - Process/refresh indicator
  • CLOCK ⏱️ - Timing indicator
  • HOURGLASS ⏳ - Loading indicator
  • FLASH ⚑ - Speed/power indicator

Emotion πŸ’‘

  • THINK πŸ€” - Thinking indicator
  • BRAIN 🧠 - Intelligence indicator
  • LIGHT πŸ’‘ - Idea indicator
  • FIRE πŸ”₯ - Hot/trending indicator
  • MAGIC ✨ - Special indicator
  • STAR ⭐ - Favorite indicator
  • EYES πŸ‘€ - Attention indicator

Objects πŸ› οΈ

  • FOLDER πŸ“ - Directory indicator
  • GEAR βš™οΈ - Settings indicator
  • TOOL πŸ› οΈ - Tool/utility indicator
  • BUG 🐞 - Bug/issue indicator

πŸ“š Quick Start

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 πŸ’‘

πŸ”§ Core Methods

Direct Symbol Access (Case-Insensitive) 🎯

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}") # 🐞

Search Functionality πŸ”

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 pattern

Reverse Lookup πŸ”„

Find 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

List All Symbols πŸ“‹

# 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()

🎨 Usage Examples

Console Logging

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 high

Progress Indicators

import 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")

Dynamic Symbol Discovery

# 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"

🧠 Advanced Features

Custom Search Flags

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)

Integration with Other Libraries

# 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)

πŸ” Error Handling

# 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}")

πŸš€ Installation

# 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 -v

πŸ“– API Reference

Methods

  • search(pattern, flags=re.IGNORECASE) - Search symbols by pattern
  • info_from_emoji(emoji) - Get name and group from emoji
  • name_from_emoji(emoji) - Get symbol name from emoji
  • list_all() - Get all symbols as tuples
  • print_table() - Print formatted symbol table

Properties

Access any symbol directly: symbols.FIRE, symbols.CHECK, etc.

🀝 Contributing

Contributions are welcome! Please feel free to submit issues and pull requests.

πŸ“„ License

This project is licensed under the MIT License.


Made with πŸ’‘ and πŸ”₯ by the CuteSymbols team!

About

A simple library to use cute unicode symbols in a python script

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages