xtools-py 0.1.0

A set of useful utilities for Python developers

XTools

XTools — это мощная библиотека с полезными утилитами для Python-разработчиков, предназначенная для упрощения рутинных задач. Включает в себя инструменты для работы с конфигурационными файлами, матрицами, валидацией данных, кешированием, поиском информации и многим другим.

🚀 Установка

Установить библиотеку можно через pip:

pip install xtools

📌 Возможности

• Поиск данных (Find) — быстрый поиск в структурах данных.
• Работа с матрицами (Matrix) — удобные операции с матрицами.
• Конфигурационные файлы (Config) — работа с JSON, YAML и INI файлами.
• Валидация данных (Validator) — проверка строк, чисел и других типов данных.
• Кеширование (Cache) — простой и эффективный кеш.
• Работа с датами и временем (DateTimeUtils) — удобные функции для работы с датами.
• Математические функции (MathUtils) — расширенные математические операции.
• Работа с цветами (ColorUtils) — преобразование и обработка цветов.
• Шифрование (Encryption) — базовые функции шифрования и хеширования.
• Работа с текстом (TextUtils) — удобные текстовые манипуляции.
• Конвертация единиц измерения (Unit) — перевод величин между разными системами.

📖 Использование

1. Работа с конфигурацией

from xtools import Config

config = Config("config.json")
config.set("app.debug", True)
config.save()

2. Поиск данных

from xtools import Find

data = ["apple", "banana", "cherry"]
result = Find.get_max(data)  # banana

numbers = [123, 321, 213]
result = Find.get_max(numbers) # 321

3. Работа с кешем

from xtools import Cache

cache = Cache()
cache.set("key", "value", ttl=60)  # Хранится 60 секунд
print(cache.get("key"))  # value

4. Работа с датами

from xtools.utils import DateTimeUtils

print(DateTimeUtils.current_timestamp())
print(DateTimeUtils.format_date("2025-02-08", "%d.%m.%Y"))

5. Работа с цветами

from xtools.utils import ColorUtils

print(ColorUtils.hex_to_rgb("#FFFFFF"))  # (255, 255, 255)
print(ColorUtils.rgb_to_hex(255, 255, 255))  # #FFFFFF

6. Конвертация единиц измерения

from xtools import UnitConverter

print(UnitConverter.celsius_to_fahrenheit(25))  # 77.0
print(UnitConverter.meters_to_kilometers(1000))  # 1.0

7. Шифрование и дешифрование

from xtools import EncryptionUtils

key = EncryptionUtils.generate_key()
encrypted = EncryptionUtils.encrypt("Hello, World!", key)
decrypted = EncryptionUtils.decrypt(encrypted, key)

print(encrypted)
print(decrypted)  # Hello, World!

💡 Roadmap

• Добавление поддержки Redis для кеша
• Добавление поддержки S3 Storage для логирования
• Расширенные возможности валидации
• Улучшенные математические функции

📜 Лицензия

Проект распространяется под лицензией MIT.

🤝 Контрибьютинг

Если у вас есть идеи для улучшения библиотеки, создайте issue или pull request на GitHub.

🔗 Связь

• 📧 Email: [e-mail]
• 💻 GitHub: SikWeet

---

📌 XTools — инструменты, которые делают разработку проще! 🚀