Metadata-Version: 2.4
Name: pycraft-tools
Version: 1.1.1
Summary: Универсальный помощник на Python: голос, музыка, автоматизация, базы данных, ИИ, скачивание музыки
Home-page: https://github.com/Naruto456y/help-tools
Author: Yusuf Guseinov
Author-email: yusufvaleh@gmail.com
License: MIT
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: POSIX :: Linux
Classifier: Operating System :: MacOS
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Utilities
Classifier: Natural Language :: Russian
Classifier: Natural Language :: English
Requires-Python: >=3.7
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: gtts
Requires-Dist: pydub
Requires-Dist: SpeechRecognition
Requires-Dist: pygame
Requires-Dist: requests
Requires-Dist: beautifulsoup4
Requires-Dist: python-vlc
Requires-Dist: opencv-python-headless
Requires-Dist: keyboard
Requires-Dist: mouse
Requires-Dist: pyautogui
Requires-Dist: yandex-music
Requires-Dist: python-dotenv
Requires-Dist: deepface
Requires-Dist: easyocr
Requires-Dist: mss
Requires-Dist: Pillow
Requires-Dist: numpy
Requires-Dist: psutil
Requires-Dist: youtube-search
Requires-Dist: pyperclip
Requires-Dist: PyPDF2
Requires-Dist: plyer
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: license
Dynamic: license-file
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

# 🛠️ pycraft-tools — универсальный модуль-помощник на Python

Модуль, который объединяет десятки функций и классов для работы с голосом, музыкой, автоматизацией, базами данных и искусственным интеллектом. Всё в одном файле — просто подключи и используй.

## 🚀 Возможности

### 🎙️ Голос и звук (`Manager`)
- Распознавание речи (speech-to-text)
- Озвучка текста (TTS) через Google
- Воспроизведение MP3/WAV/OGG
- Кроссплатформенные звуковые сигналы

### 🎵 Музыкальный плеер (`Music`)
- Поиск и воспроизведение треков из Яндекс.Музыки
- Управление очередью (добавление, переключение, очистка)
- Пауза, регулировка громкости, перемотка
- Запуск «Моей волны» (случайные треки из избранного)
- **Скачивание всех треков из избранного в папку**
- Кэширование ссылок и избранного (2 часа)

### 🌐 Парсинг и погода (`Manager`)
- Извлечение текста с веб-страниц по CSS-классу
- Получение текущей погоды для любого города (OpenWeatherMap)

### 🖥️ Консоль (`Console`)
- Цветной вывод (16 цветов + стили)
- Управление курсором, прогресс-бары
- Скрытие/показ окна консоли (Windows)
- Быстрые сообщения (success, error, warning, info)

### 🗄️ База данных SQLite (`BazaDB`)
- Создание таблиц, вставка, поиск (точный и LIKE), обновление, удаление
- Статистика и список таблиц

### 🧠 Распознавание лиц и эмоций (`Face`)
- Определение эмоции через веб-камеру (DeepFace)
- Обнаружение улыбки
- Автоматический запуск музыки под настроение

### 🖱️ Автоматизация (`Auto`)
- Клики, двойные клики, перетаскивание, скроллинг
- Нажатие и удержание клавиш
- Эмуляция печати текста
- Скриншоты и системные уведомления

### 💻 Системные команды (`System`)
- Выключение, перезагрузка, сон, блокировка экрана (Windows)

### ℹ️ Информация о системе (`Info`)
- Уровень заряда батареи, загрузка CPU, использование RAM, тип ОС

### 🖥️ Распознавание экрана (`ScreenReader`)
- Поиск изображения на экране (OpenCV)
- Поиск пикселя по цвету
- Чтение текста с экрана (EasyOCR)
- Выделение найденных объектов рамкой
- Ожидание появления изображения

### 🤖 Искусственный интеллект (`GigaChat`)
- Подключение к GigaChat Сбера
- Очистка распознанной речи от слов-паразитов и шума

### 🔧 Дополнительные утилиты
- **Буфер обмена** (`Clipboard`) — копирование/вставка
- **Математика** (`MathHelper`) — факториал, среднее, медиана, перевод систем, школьное округление
- **Файлы** (`FileUtils`) — чтение, запись, подсчёт строк
- **Изображения** (`ImageUtils`) — ресайз, кроп, поворот
- **PDF** (`PDFUtils`) — извлечение текста
- **Генератор паролей** (`PasswordGen`)
- **Конвертер единиц** (`UnitConverter`) — температура, расстояние, вес
- **Фоновые потоки** (`ThreadManager`)

## 📦 Установка

```bash
pip install pycraft-tools
```

## 🚀 Быстрый старт

```python
from help_manager import Manager, Music, Auto, Console, BazaDB, Face

# Голос
Manager.say("Привет, мир!")

# Погода
weather = Manager.get_weather("Москва")
print(weather["Температура"])

# Музыка (требуется токен Яндекс.Музыки)
player = Music(token="y0_...")
player.play("Imagine Dragons")
player.download_favorites("C:/MyMusic")  # скачать всё избранное

# Автоматизация
Auto.click(500, 300)
Auto.screenshot("screen.png")

# Консоль
Console.success("Операция выполнена!")
Console.progress_bar(100, "Загрузка")

# База данных
db = BazaDB("test.db")
db.create_table("users", ["name", "age"])
db.insert("users", {"name": "Юсуф", "age": "12"})

# Распознавание лиц
emotion = Face.detect_emotion()
print(f"Эмоция: {emotion}")
