console-garland

console-garland – это CLI-приложение, имитирующее работу цветной ёлочной гирлянды. Реализовано на Python с использованием библиотеки colorama.

Простенький проект был написан для создания небольшой 🎅🎄новогодней🎁✨ атмосферы в простом терминале или тайловом менеджере.

📌 Особенности

• 🔢 Множество режимов: От классического "Статичного" до медитативного "Заполнения" и хаотичной "Дискотеки". В проекте присутствуют 9 режимов, основанные на алгоритмах реальных гирлянд.
• 🖥️ Полная кроссплатформенность: Код адаптирован для работы на Windows, Linux и macOS. Используются нативные методы ввода для каждой ОС (msvcrt / termios).
• 📊 Интерфейс-статусбар: Строка состояния показывает текущий режим, статус авто-переключения и подсказки по управлению.
• 📏 Настраиваемая длина: Длину гирлянды можно задать при запуске через аргументы командной строки (-). По умолчанию в гирлянде 40 лампочек.
• 👴🏻 Поддержка старых терминалов: Специальный режим --no-emoji заменяет иконки интерфейса (🎄/🌟) на простые ASCII-символы (Ѧ/☆) для корректного отображения в терминале.
• 📸 Zero-Flicker Print: Используются ANSI-коды и управления "кареткой" (\r, \033[A) для достижения плавной анимации без мерцания очистки экрана.
• 🛠️ Читаемый и простой код: Проект имеет модульную архитектуру и полностью закомментирован — его легко кастомизировать и расширять.

🚀 Установка и запуск

Important

Предварительные требования:

• Python 3.x
• Терминал с поддержкой цветов (практически любой)

Шаги:

1. Клонируйте репозиторий:

   git clone https://github.com/n1xsi/console-garland.git
   cd console-garland

2. Установите библиотеку:

   pip install colorama

   или

   apt install python3-colorama

3. "Зажгите огни":

   • Стандартный запуск (по умолчанию – гирлянда из 40 лампочек):

   python garland.py

   • Запуск с настройкой длины (флаг -l или --length):

   python garland.py -l 50

   • Запуск без эмодзи в интерфейсе (для старых консолей при отображении ⍰ вместо иконок):

   python garland.py --no-emoji

   Пример некорректного отображения

   

Примечание для Linux/Mac:

Если курсор терминала "скачет" или перехват клавиш работает некорректно, попробуйте запустить скрипт с правами суперпользователя: sudo python3 garland.py.

🎮 Управление

В проекте присутствуют горячие клавиши для управления гирляндой (подсказки отображаются в верхней строке программы):

Клавиша	Действие	Описание
ENTER	Смена режима	Переключает режим анимации гирлянды на следующий.
Ctrl+C	Выход	Выключение гирлянды (сбрасывая "окрашивание" консоли).
A	Auto-Mode	Вкл/Выкл автоматическую смену режима (переключение каждые 5 секунд).
H	Скрыть UI	Скрыть/Показать верхнюю строку состояния (для чистого вида).

📄 Лицензия

Этот проект распространяется под лицензией MIT. Подробности смотрите в файле LICENSE.

С наступающим Новым годом и счастливого Рождества! 🎅🎄🎁