Представляем Instiz, моя первая опубликованная библиотека на PYPI

Здравствуйте, я бы хотел представить instiz , обертка в Сайт Ichart Chart Для Python 3+. Ichart-это веб-сайт в реальном времени для корейской музыки.

Chromadream/Instiz

Библиотека только Python3 для баллов Ichart K-POP.

Монтаж

PIP установить Instiz

Начиная

Начать работу легко. Следующий пример – получить 10 лучших на графике в реальном времени Ichart.

from instiz import iChart
ichart = iChart()
top_10 = ichart.realtime_top_10()

Тип подсказка

Если вы используете функцию подсказок типа Python 3.7+, тип, используемый для возврата типа диаграммы, может быть импортирован из instiz.models модуль.

from instiz.models import Entry
def get_name(entry: Entry) -> str
    return entry.title

Имя художника

Теперь можно легко получить корейское имя и английское название художника, вместе с названием «Сырой артист», предоставленного с сайта Ичарта. Хорошая собственность титула всегда вернет английское имя, если только недоступен. Если одно из имен недоступно, свойство вернет пустую строку.

from instiz

Фон

Я недавно начал вносить свой вклад в /r/kpop как технический модератор. Взгляд на организацию может показать, что для сообщества Reddit довольно необычно использовать этот большой код, но это действительно помогло работой модератора и обеспечивает добавление ценности пользователям сообщества.

Почему существует Instiz?

Subreddit имеет виджет песен в реальном времени, который был соскоблен от Ichart ежечасно.

Однако, поскольку Reddit выдвигает редизайн, требуется порт виджета для редизайна, так что между пользователями старого сайта и нового сайта не существует. Итак, я начал попытку порта. Тем не менее, взгляд на исходный код в настоящее время в настоящее время выявляет ужасно вложенный беспорядок. Мало того, что скребок и синтаксис тесно связаны с фактической функцией обновления.

instiz Первоначально создан для того, чтобы обеспечить разделение беспокойства между процессом очистки и процессом обновления виджетов. Его также можно использовать для любых сценариев, ботов или любых программ, которые используют данные Ichart.

Функции

Несмотря на то, что основная функциональность instiz довольно прост, который состоит в том, чтобы очистить и обрабатывать данные из Ichart, в нем есть некоторые примечательные дополнительные функции.

Разменяемость имени художника.

На сайте Ichart имена художников не соответствуют отформатированию. Примеры включают 제니 (Дженни) , Дважды (트와이스) , 아이유 (iu) и Королева (퀸) Анкет Instiz гарантирует, что корейские и английские имена предварительно обработаны и могут быть легко извлечены пользователем библиотеки без необходимости дополнительной обработки.

Пример кода:

from instiz import iChart

ichart = iChart()
first_place = ichart.get_next_entry()
nice_title = first_place.nice_title # "JENNIE - SOLO"
raw_artist_name = first_place.artist.raw_name # "제니 (JENNIE)"
english_artist_name = first_place.artist.english_name # "JENNIE"
korean_artist_name = first_place.artist.korean_name # "제니"

API обновление.

Предоставляется функция обновления, так что разработчику не нужно инициализировать новый экземпляр класса каждый раз, когда необходим новый набор данных.

Пример кода:

from instiz import iChart

ichart = iChart()
top_10 = ichart.realtime_top_10()
ichart.refresh()
top_10 = ichart.realtime_top_10()

Он полностью открыт.

instiz опубликовано под MIT, и есть некоторые «хорошие первые проблемы» для людей, желающих начать работать над культурой с открытым исходным кодом. Тем не менее, я понял, что есть некоторые предметы, которые обычно находятся в проекте с открытым исходным кодом, отсутствующим в инстиз . Пожалуйста, помогите мне выполнить это, сделав запрос на тягу.

Спасибо.

Спасибо, что прочитали этот пост до конца. Я очень ценю это. Хорошего дня.

Оригинал: “https://dev.to/chromadream/introducing-instiz-my-first-published-library-on-pypi-2okl”