logfore 2.1.3.1

A colorful and feature-rich logging library for Python

logfore

A colorful, feature-rich logging library for Python with support for styled output, loading animations, ASCII banners, and auto-updates.

Installation

pip install logfore

Quick Start

from logfore import Logger, Loader, Home, LogLevel

# Basic logger (colorful style)
log = Logger(prefix="MyApp")

log.info("Application started")
log.success("Task completed")
log.warning("Low memory")
log.failure("Connection lost")
log.error("Something went wrong")
log.debug("Debug message")
log.critical("Fatal error occurred")  # exits program

# Simple/minimal style
log2 = Logger(style=2, prefix="MyApp")
log2.info("Simple style log")

Features

Logger Styles

Style	Description
style=1	Colorful logger with pink/cyan/magenta theme (default)
style=2	Minimal simple logger with arrow prefix

Logger Options

log = Logger(
    style=1,                          # 1 = ColorLogger, 2 = SimpleLogger
    prefix="MyApp",                   # Prefix shown in brackets
    github_repository="user/repo",    # Displays repo info on start
    level=LogLevel.DEBUG,             # Minimum log level to display
    log_file="logs/app.log"           # Optional file logging
)

Log Levels

from logfore import LogLevel

# Available levels (in order):
LogLevel.DEBUG
LogLevel.INFO
LogLevel.WARNING
LogLevel.SUCCESS
LogLevel.FAILURE
LogLevel.CRITICAL

Timing Support

All log methods support optional timing:

import time

start = time.time()
# ... do work ...
end = time.time()

log.success("Done!", start=start, end=end)
# Output: ... [Success] -> Done! In 1.234 Seconds

Loading Spinner

from logfore import Loader

# As context manager
with Loader(prefix="MyApp", desc="Processing...", end="Done!"):
    time.sleep(2)

# Manual control
loader = Loader(desc="Loading...")
loader.start()
# ... do work ...
loader.stop()

ASCII Banner (Home Screen)

from logfore import Home

home = Home(
    text="LOGFORE",
    align="center",       # "left", "center", "right"
    adinfo1="v1.0.0",
    adinfo2="by Author",
    credits="GitHub: user",
    clear=True            # Clear terminal before display
)
home.display()

Auto Updater

from logfore import AutoUpdater, Logger

log = Logger()
updater = AutoUpdater("your-pypi-package-name", log)
updater.check_for_updates()

File Logging

log = Logger(log_file="logs/myapp.log")
log.info("This is saved to file too")

Questions / Input

answer = log.question("What is your name? ")
print(f"Hello, {answer}!")

Requirements

• Python 3.10+
• colorama
• pystyle
• requests
• packaging