Описано как работать с ProgressBarManager

This commit is contained in:
Ilia Miheev
2025-07-02 11:46:33 +03:00
parent ed0c8bedaf
commit 0256be554d
+60 -1
View File
@@ -2,7 +2,7 @@
Во время парсинга часто приходится скачивать html-страницы, работать с json- и csv-файлами. Эта библиотека призвана облегчить написание кода для такого рода задач. Библиотека создавалась для удобства работы во время парсинга, но ничто не мешает использовать её просто для работы с json и csv. Во время парсинга часто приходится скачивать html-страницы, работать с json- и csv-файлами. Эта библиотека призвана облегчить написание кода для такого рода задач. Библиотека создавалась для удобства работы во время парсинга, но ничто не мешает использовать её просто для работы с json и csv.
В библиотеке есть три класса для отдельных работ: Pars для работы с запросами и bs4, JsonManager для работы с json и CsvManager для работы с csv. В библиотеке есть три класса для отдельных работ: Pars для работы с запросами и bs4, JsonManager для работы с json и CsvManager для работы с csv. Так же есть один класс для улучшения пользовательского опыта — ProgressBarManager, который создаёт прогресс-бар
Установить библиотеку: Установить библиотеку:
@@ -164,4 +164,63 @@ rows = c.getRows('./data.csv')
# выводим строки таблицы # выводим строки таблицы
c.pprint(rows) c.pprint(rows)
```
## Работа с ProgressBarManager
Класс создаёт прогресс-бар для лучшей видимости выполнения кода. Принимает пять аргументов:
1. **max**: обязательный параметр, который указывает максимальное значение итераций в прогресс-баре
2. **message**: сообщение перед прогресс-баром
3. **color**: цвет прогресс-бара
4. **fill**: заполнитель для сделанной части
5. **width**: размер прогресс-бара в символах
```py
from ipars import ProgressBarManager
bar = ProgressBarManager(100) # Здесь max установлен как 100
```
### Коротко о методах
1. Метод **next** запускает следущую итерацию прогресс-бара
2. Метод **finish** завершает работу прогресс-бара
```py
# Импортируем библиотеки
from ipars import ProgressBarManager
from time import sleep
maxValue = 300
# Создаём прогресс-бар по умолчанию
bar = ProgressBarManager(maxValue)
# Имитируем работу
for _ in range(maxValue//2):
sleep(0.1)
bar.next()
# Выключаем прогресс-бар
bar.finish()
# Создаём более кастомизированный прогресс-бар
bar = ProgressBarManager(
maxValue,
message='Процесс скачивания',
color='red',
width=50
)
# Имитируем работу
for _ in range(maxValue):
sleep(0.1)
bar.next()
# Выключаем прогресс-бар
bar.finish()
``` ```