Metadata-Version: 2.1
Name: mtly
Version: 14.1.1
Summary: 
Author: Макс
Author-email: rumyantsev1m0s1@gmail.com
Requires-Python: >=3.12,<4.0
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Requires-Dist: colorama (>=0.4.6,<0.5.0)
Requires-Dist: twine (>=6.0.1,<7.0.0)
Description-Content-Type: text/markdown

# ***mtly***
### - *Библиотека для кастомизации текста*
#
##
# **Быстрый старт**
> # ```pip install mtly```
#
##
# **Примеры использования**
### *Давайте запустим следующий код:*
```python
from mtly import *


print(motley(text="HELLO WORLD", color=Colors.GREEN, style=Styles.BOLD_ITALIC))
print(motley(text="HELLO WORLD", color=Colors.DARK_GREEN, style=Styles.BOLD_ITALIC))
print(motley(text="HELLO WORLD", color=Colors.LIGHT_BLUE, style=Styles.BOLD_ITALIC))
print(motley(text="HELLO WORLD", color=Colors.BLUE, style=Styles.BOLD_ITALIC))
print(motley(text="HELLO WORLD", color=Colors.DARK_BLUE, style=Styles.BOLD_ITALIC))
print(motley(text="HELLO WORLD", color=Colors.YELLOW, style=Styles.BOLD_ITALIC))
print(motley(text="HELLO WORLD", color=Colors.ORANGE, style=Styles.BOLD_ITALIC))
print(motley(text="HELLO WORLD", color=Colors.RED, style=Styles.BOLD_ITALIC))
print(motley(text="HELLO WORLD", color=Colors.PINK, style=Styles.BOLD_ITALIC))
print(motley(text="HELLO WORLD", color=Colors.DARK_PINK, style=Styles.BOLD_ITALIC))
print(motley(text="HELLO WORLD", color=Colors.PURPLE, style=Styles.BOLD_ITALIC))
print(motley(text="HELLO WORLD", color=Colors.DARK_PURPLE, style=Styles.BOLD_ITALIC))
print(motley(text="HELLO WORLD", color=Colors.GREY, style=Styles.BOLD_ITALIC))
print(motley(text="HELLO WORLD", color=Colors.BLACK, style=Styles.BOLD_ITALIC))
print(motley(text="HELLO WORLD", color=Colors.WHITE, style=Styles.BOLD_ITALIC))


(
    print(), print(motley(text=".", color=Colors.RED, style=Styles.BOLD_ITALIC)*5,
               motley(text=".", color=Colors.GREEN, style=Styles.BOLD_ITALIC)*5,
               motley(text=".", color=Colors.RED, style=Styles.BOLD_ITALIC)*5,
               motley(text=".", color=Colors.GREEN, style=Styles.BOLD_ITALIC)*5),
 print(motley(text=".", color=Colors.GREEN, style=Styles.BOLD_ITALIC)*5,
       motley(text=".", color=Colors.RED, style=Styles.BOLD_ITALIC)*5,
       motley(text=".", color=Colors.GREEN, style=Styles.BOLD_ITALIC)*5,
       motley(text=".", color=Colors.RED, style=Styles.BOLD_ITALIC)*5),
     print()
)


print(motley(text="WASSUP", color_combo=ColorCombos.VOLCANO, style=Styles.BOLD))
print(motley(text="WASSUP", color_combo=ColorCombos.FRESH, style=Styles.BOLD))
print(motley(text="WASSUP", color_combo=ColorCombos.NIGHT, style=Styles.BOLD))


(
    print(), print(motley(text=".", color=Colors.RED, style=Styles.BOLD_ITALIC)*5,
               motley(text=".", color=Colors.GREEN, style=Styles.BOLD_ITALIC)*5,
               motley(text=".", color=Colors.RED, style=Styles.BOLD_ITALIC)*5,
               motley(text=".", color=Colors.GREEN, style=Styles.BOLD_ITALIC)*5),
 print(motley(text=".", color=Colors.GREEN, style=Styles.BOLD_ITALIC)*5,
       motley(text=".", color=Colors.RED, style=Styles.BOLD_ITALIC)*5,
       motley(text=".", color=Colors.GREEN, style=Styles.BOLD_ITALIC)*5,
       motley(text=".", color=Colors.RED, style=Styles.BOLD_ITALIC)*5),
     print()
)


print(motley(text="INTERESTING", color=Colors.BLUE,
             color_combo=ColorCombos.FRESH, style=Styles.ITALIC))
```
## **На выходе получим нечто прекрасное:**
![](https://iimg.su/s/19/3Nt0cxXPnWPmv6A7ewnYsV7g5VW7PRIbBjZ6xOuy.png)
> ## **Здесь мы наблюдаем 15 цветов, 3 цветовые комбинации и 3 стиля в действии**
####
> > ### *За каждым из необязательных параметров функции motley стоит специальный класс:*
> ###
> > ### **Colors - отвечает за все цвета**
> > ###
> > #### *зеленый, темно-зеленый, светло-синий, синий, темно-синий,* 
> > #### *желтый, оранжевый, красный, розовый, темно-розовый (лососевый),*
> > #### *фиолетовый, темно-фиолетовый, серый, черный, белый*
> ### 
> > ### **ColorCombos - отвечает за все цветовые комбинации**
> > #####
> > #### *вулкан, свежий, ночь*
> ### 
> > ### **Styles - отвечает за все стили**
> > ##### 
> > #### *курсив, жирный, жирный курсив, нормальный*
#### 
> ## **Вы можете их использовать так, как захотите!**
# 
## 
# **FAQ**
## `Чем mtly лучше colorama???`
> ### *В отличие от нее, mtly - удобная библиотека*
> > ### *При использовании colorama вы сталкиваетесь со множеством проблем:*
> > ###
> > ### *1) Несоответствие цветов*
> > #### *- из того, что сразу приходит в голову: белый цвет вдруг стал темно-фиолетовым,*
> > #### *- огромные несостыковки с тёплыми цветами*
> > ###
> > ### *2) Непонятные название классов и констант классов*
> > #### *- зачем класс, которые отвечает за цвета, называть Fore (англ. "Передний")?*
> > #### *- опять-таки, из того, что сразу приходит на ум: жирный шрифт почему-то стал ярким*
> > ### 
> > ### *3) Громоздкость использования*
> > #### *- чтобы применить какой-либо цвет/стиль, мне нужно прописать некую конструкцию,*
> > #### *где нужно соблюсти определённый порядок, о котором я, как пользователь, не имею ни малейшего понятия*
> > #### *(пример: стиль не будет применён к тексту, если записать конструкцию как "текст" + "стиль",*
> > #### *нужно написать "стиль" + "текст")*
> > ###
> > ### *4) Функционал*
> > #### *я захожу на минное поле, но всё же попытаюсь аргументировать свою позицию:*
> > #### *- в "колораме" нет никаких цветовых комбинаций, а вследствие и доп функции (цвет + комбо)*
> > #### *- в ней также нет таких шрифтов (стилей) как: курсив, жирный курсив*
> #
> ### *Однако, в colorama есть огромное количество функций, которых нет в mtly*
> ###
> #### *И я бы рассматривал свою библиотеку как урезанную и усовершенствованную копию вышеупомянутой "колорамы"*
> #### *Так как функции в моей реализации (так скажем) покрывают большинство нужд пользователей, решивших увидеть в консоли что-нибудь цветное*

