Автор оригинала: Ajay Agrawal.
Помните, как это было захватывающе, когда вы создали свою первую программу “Hello World” на любом языке?
Мой был похож на этот, я получил свой первый шанс написать программу Hello World на языке Си на первом курсе бакалавриата. но это было волшебное чувство, потому что я мог управлять системой и мог печатать что угодно на мониторе. Почему я упомянул эту историю перед повесткой дня, потому что сегодня я тоже чувствовал то же самое. Когда я сделал это успешно. Разница в том, что на этот раз у меня не было наставника, чтобы научить меня, и мне потребовалось 8 испытаний, чтобы сделать это. Но, наконец, это сделано. Так что давайте начнем.
НЕКОТОРЫЕ ПРЕДВАРИТЕЛЬНЫЕ УСЛОВИЯ, ПРЕЖДЕ ЧЕМ МЫ НАЧНЕМ…
- На вашем компьютере должен быть установлен Python3.
- Убедитесь, что у вас есть последняя версия pip. Убедитесь в этом, введя его на своем терминале или в командной строке
python -m pip install -upgrade pip
- Вы должны были установить библиотеку колес и шпагатов. Если нет, то их можно легко установить с помощью следующих команд,
pip install wheel
pip install twine
- У вас должна быть рабочая учетная запись на GitHub.
ШАГ 1: СОЗДАЙТЕ ОТДЕЛЬНУЮ ПУСТУЮ ПАПКУ ДЛЯ НАШЕГО ПАКЕТА
Создайте пустую папку в любом месте на вашем компьютере, вы можете использовать любое имя, потому что это просто контейнер, и имя этой папки не будет использоваться в процессе. Давайте сделаем это с именем “Контейнер”.
ШАГ 2: ПЕРЕЙДИТЕ В СВОЮ ПАПКУ И ЗАПИШИТЕ ФАЙЛЫ PYTHON
Перейдите в “Папку контейнера” и создайте другую папку, это будет ваше имя пакета. Так что выбирайте его с умом, как я выбрал “Крошечную математику” . Зайдите внутрь и сделайте несколько файлов, которые вы хотите загрузить в качестве своей библиотеки. После записи моих файлов моя структура файлов выглядит следующим образом
Теперь я покажу все три файла один за другим, что находится внутри них,
ШАГ 3: НАПИШИТЕ НЕСКОЛЬКО ОФИЦИАЛЬНЫХ ФАЙЛОВ
Теперь мы создали достаточно контента для публикации. Для этого, прежде всего, выйдите из Крошечной математической папки. Нам нужно создать несколько дополнительных файлов для загрузки нашего пакета.
Для этого файла просто измените год, если он вам не подходит, и замените свое имя на мое.
Для этого файла измените имя пакета с крошечного соответствия на имя пакета, имя автора, author_email, описание и URL-адрес. Я знаю, что мы еще ничего не загрузили на GitHub. но, пожалуйста, будьте в потоке, мы сделаем это.
Здесь, как и ожидалось, вы должны описать подпакеты, классы и методы, определенные внутри. Я не очень хорошо разбираюсь в документации. Но вы можете сделать это лучше.
ШАГ 4: ЗАГРУЗКА ФАЙЛОВ В GITHUB
Создайте новый репозиторий на своем GitHub, и имя репозитория должно совпадать с именем вашего пакета. В моем случае это Крошечная математика . Загрузите все файлы папки контейнера и напишите что-нибудь сообщение о фиксации и нажмите кнопку Фиксация изменений .
Если вы нажмете на кнопку “Клонировать” или “Загрузить”, вы увидите ссылку, которую мы использовали в setup.py в поле url, кроме .git и конца. Это для будущих обновлений и улучшений, которые вы сделаете.
ШАГ 5: СКОМПИЛИРУЙТЕ setup.py ФАЙЛ
python setup.py sdist bdist_wheel
используйте эту команду в папке контейнера.
После компиляции вы увидите несколько новых папок с такими именами…
build : информация о пакете сборки. dist : Содержит ваш файл .whole. Файл WHL – это пакет, сохраненный в формате Wheel , который является стандартным форматом встроенного пакета, используемым для дистрибутивов |/Python|/. Вы можете непосредственно установить a .использование файла whl
pip install some_package.whl
в вашей системе. project.egg.info : Пакет egg содержит скомпилированный байт-код, информацию о пакете, ссылки на зависимости и захватывает информацию, используемую setup.py команда test при выполнении тестов.
Теперь мы готовы загрузить наш пакет в PyPI(индекс пакета Python).
ШАГ 6: СОЗДАЙТЕ УЧЕТНУЮ ЗАПИСЬ В pypi.org И test.pypi.org
Почему два аккаунта на двух сайтах?
Потому что, если вам только интересно знать, как это сделать. Тогда вам следует работать с test.pypi.org потому что это сервер, который привыкает загружать библиотеки, созданные для образовательных целей, любопытства, тестирования и так далее. Но на данный момент используйте pypi.org
Мы можем легко создать новую учетную запись на обоих серверах. Так что сделай один для тебя, который у меня уже есть. Теперь, наконец, вам нужно просто запустить другую команду, и вы закончите загрузку своего пакета. Что отличается для pypi.org и test.pypi.org
Для pypi.org
python -m twine uplaod --repository-url https://upload.pypi.org/legacy/ dist/*
Для test.pypi.org
python -m twine uplaod --repository-url https://test.pypi.org/legacy/ dist/*
Если вы видите такой вывод, то поздравляем вас с тем, что вы опубликовали свой собственный пакет python на сервере PyPI.
Иногда вы можете получить эту ошибку, она появляется, когда пакет загружается кем-то с тем же именем. Поэтому вам нужно просто изменить имя пакета в кодах и изменить имя папки на что-то другое, что в моем случае было крошечной математикой.
ШАГ 7: ПРОВЕРЬТЕ СВОЙ ПАКЕТ pypi.org или test.pypi.org ВСЕ, ЧТО ВЫ ИСПОЛЬЗОВАЛИ
ШАГ 8: УСТАНОВИТЕ ПАКЕТ НА СВОЙ КОМПЬЮТЕР И ПРОТЕСТИРУЙТЕ ЕГО.
ШАГ 9: ВЫПУСК НОВЫХ ВЕРСИЙ
Повторите ШАГИ с 5 по 7 и внесите некоторые изменения в setup.py файл, если они требуются. Как и версия, это ссылка на репозиторий GitHub, который я создал. Вы можете ознакомиться с официальной документацией для получения более подробной информации здесь
Поздравляем вас с первой публикацией пакета python!!!
Если вы нашли эту статью полезной для себя, то можете угостить меня кофе ☕ paypal.me/Ajayff4 здесь, чтобы я мог больше просыпаться и делать больше статей, подобных этой.
Спасибо