Как я опубликовал / развернул свой пакет Python в Pypi.

Первоначально опубликовано blog.mphomphego.co.za 16 апреля 2019 года.

я люблю читать Средний Опубликовать время во времени, но никогда не хватает времени между школой жонглирования, работами и семьей. Мечта о чтении ежедневных постов просто происходит, чтобы исчезнуть в пропасть со временем. И ссылки на посты, которые интересуют меня, продолжайте накапливаться вверх, а в моем Google сохраняются.

Со временем я не мог больше его принять Поэтому я решил создать сценарий Python, который экспортирует бы сообщения в блоге (используя Docker Image ) в mp3 Файлы для меня, чтобы прослушать, вместо этого заняты другими скучными материалами, которые делают скучные люди.

В этом посте я пойду через вас, как мне удалось опубликовать/развернуть мой пакет на Pypi.

Сначала я всегда думал, что развертывание/упаковку вашего пакета Python была громоздкой до сих пор. Теперь проще, чем когда-либо, и ниже я расскажу вам все об этом.

Некоторые из преимуществ написания вашего первого пакета Python и развертывание его в PYPI будут:

• Быть вынужденным думать гораздо более модульно.
• Написать код с учетом тестов.
• Думая о том, чтобы сделать API достаточно просто для других, чтобы интуитивно понять и повторно использовать свою работу.
• Изучение новых инструментов, которые приходят вместе с написанием тестов.

До того, как я отвлекся, вам может быть интересно, что это за пики Я говорю!

Что такое pypi?

Ну, согласно их Сайт Отказ

Индекс пакета Python (Pypi) – это репозиторий программного обеспечения для языка программирования Python. PYPI помогает вам найти и установить программное обеспечение, разработанное и совместному сообщению Python. Узнайте о установке пакетов. Авторы пакета используют PYPI для распространения их программного обеспечения. Узнайте, как упаковать свой код Python для PYPI. Если вы используете Пип Команда, вы уже используете PYPI.

Когда вы, наконец, попадаете в Pypi, каждый может установить и использовать его с знакомой простой командой:

pip install {package_name}

Если вы все еще читаете, то я уверен, что вы похоже, это довольно круто.

Итак, чтобы получить наш пакет Pypi, нам нужно будет выполнить следующие шаги:

• Создайте Python Code и сделать его публикации-готовым I.E. Создайте пакет Python, добавьте файлы, необходимые для PYPI.
• Создайте учетную запись PYPI, если у вас нет.
• Генерация архивов распространения и загрузка в Pypi.
• Установите свой собственный пакет, используя пипс

Шаг № 1: сделайте свой код публикации – готов.

В этом посте я возьму тебя через мою посылку под названием Среднее речь как реальный пример. Вы можете найти это здесь На Pypi исходный код – здесь на Github.

Вещи, чтобы заметить, прежде чем развертывать:

• Удалите все оператор печати из вашего кода. Если вы хотите сообщить или войти что-то, используйте Python Регистрация модуль.
• Удалите весь код, который остается за пределами класса или функции. Такой код (если действительно необходимо), положите его под __main__ Функция:

if __name__ == "__main__":
    # code outside of a class or function goes here

Создать пакет Python

Readme: -слоги

В основном стандартизированы Значки/щиты Значки GitHub являются одним из первых вещей, которые видит посетитель, когда они прокручивают вниз. Значки статуса сборки описывают стабильность проекта. В моем случае у меня есть значок Python Version, который поддерживается, какая версия Python поддерживается, значок лицензии, значок выпуска версии Pypi, количество загрузок пакетов из PYPI, а также Спасибо …| значок. Значки не являются обязательными, но очень похожи на GIFS/MEMES, они являются огромным бонусом.

Shields.io У вас есть API для создания собственных значков, если вы хотите создать свои собственные значки SVG на месте, есть пакет Python, принадлежащий Google под названием пищевые .

Узнайте больше о значках и файлах Readme здесь

Шаг № 2: Создайте учетную запись PYPI.

Теперь, когда вы пакет готовы к развертыванию, нам нужно будет зарегистрироваться на учетной записи PYPI. Если у вас нет учетной записи Pypi, перейдите здесь и зарегистрироваться.

Шаг 3: Создайте архивы Dist и загрузить в Pypi.

Теперь, что для финала. Во-первых, откройте свой CLI И перейдите в вашу папку, в которой у вас есть все ваши файлы и ваш пакет.

Вам нужно будет установить шпагат который загрузит наш пакет в Pypi.

pip install -U twine

Затем запустите следующую команду:

Если вы хотите погрузиться, как все это работает здесь .

python setup.py upload

# To see more options, hit:
# python setup.py --help-commands

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

После успешной загрузки перейдите на веб-сайт PYPI в соответствии с вашим проектом, вы можете найти опубликованный пакет.

Мой публичный список – здесь

Шаг № 4: Установите свой собственный пакет, используя PIP

Хорошо, теперь давайте проверим это. Откройте свой CLI и введите следующую команду:

pip install "yourpackagename"

В моем случае это:

pip install -U medium-speech

Когда это закончено установка, откройте Python/iPython Оболочка и импортируйте свой пакет.

Шаг № 5 (необязательно): изменения в вашей упаковке

Если вы хорошо поддерживаете пакет, вам нужно время от времени изменить исходный код. Просто сделайте изменения и Не забудьте изменить номер версии под {mypackage}/___ version__.py , совершить и толчок Ваши изменения в Github.

Затем запустите Шаг 3 Загрузить новый выпуск в Pypi.

Наконец, обновите пакет через PIP, чтобы увидеть, работают ли ваши изменения:

pip install -U "yourpackagename"

Вот и все. Наслаждайтесь зданием и поделившись своими пакетами Python!

Извините за длинный пост, вот картошка!

Если вы нашли этот пост интересно, пожалуйста, оставьте комментарий или emoji.

• Как написать свой собственный пакет Python и опубликовать его на Pypi
• Создание вашего первого пакета Python
• Как написать потрясающий github readme
• Руководство для начинающих, чтобы написать kackass Readme

Оригинал: “https://dev.to/mmphego/how-i-published-deployed-my-python-package-to-pypi-easily-3hio”