Youtubezilla.ru

Мастер бытовой техники
0 просмотров
Рейтинг статьи
1 звезда2 звезды3 звезды4 звезды5 звезд
Загрузка...

Создаём свой пакет Python

Создаём свой пакет Python

Повторное использование кода — очень полезная штука. Вы экономите время при написание одних и тех же кусков кода, и даже в одном проекте у вас сохраняется модульная структура приложения, что позволяет поддерживать в актуальном состоянии каждый модуль отдельно от других. И в python довольно легко создать структуру приложения так, чтобы было легко его оформить в пакет. Этот гайд поможет вам научиться создавать такие пакеты с нуля так, чтобы другие люди могли воспользоваться им в своих приложениях.

Структура пакета

Файл с расширением ‘.py’ — это модуль. Вы можете создать в нём классы, функции и переменные с таким же именем, как у файла. А если в папку положить несколько модулей и создать файл ‘__init__.py’, вы создадите тем самым пакет с именем как у папки. Вот примерная файловая иерархия обычного пакета:

Создаём свой пакет Python

Сборка пакета

Теперь когда мы знаем структуру пакета, поговорим про его сборку. Самое важное здесь — конфигурационный файл ‘setup.py’. Основной смысл в нём — хранение метаданных о пакете. Вот пример такого файла:

Более подробно об этом файле можно прочитать в документации.

Указываем зависимости

Для того, чтобы с пакетом можно было работать сразу после установки, вы должны указать в его конфигурации, от каких пакетов он зависит, чтобы они были сразу же установлены. Нужно просто вставить ‘install_requires=[…]’ в функцию setup. Можно также задать версию зависимости:

Эти зависимости — общедоступные пакеты, которые можно установить с помощью утилиты pip. Но если ваши зависимости не перечислены в каталоге pypi, укажите их так:

Дополнительные файлы

Иногда бывает необходимость вложить в пакет другие типы файлов. Для этого:

  1. Задайте ‘include_package_data=True’
  2. Создайте файл MANIFEST.in в папке с setup.py
  3. Добавьте путь до файла в MANIFEST как ‘include /path/to/test.json’, путь при этом относительный. Также можно использовать поисковый шаблон типа ‘*.json’.
Читайте так же:
Как отменить отправленный подарок в одноклассниках
Сборка

Теперь у нас всё готово, приступаем к сборке пакета. Это значит, что мы создадим дистрибутив исходного кода (напр., tar.gz) или бинарный файл (напр., wheel). Это очень просто.

В результате у нас в папке ‘./dist’ появятся оба формата. при этом имя дистрибутива будет присвоено исходя из имени пакета и его версии.

Распространение пакета

Поздравляю, вы создали замечательный пакет! Теперь необходимо выложить его для общего доступа. Мы загрузим его на Pypi, поэтому в будущем можно будет его установить командой ‘pip install’.

Для начала создайте учётную запись на сайте pypi.

При этом файлы из папки ‘dist/’ выгрузятся в каталог pypi. Также вы можете явно указать только определённый файл для выгрузки. Twine это специальная утилита для работы с pypi. При первой загрузке пакета она зарегистрирует пакет в pypi.

Работа с пакетом

Теперь ваш пакет опубликован в pypi. Для его установки достаточно набрать ‘pip install my_package’, а затем в коде ‘import my_package’.

При локальной разработке пакета для его тестирования добавьте путь к нему в $PYTHONPATH. Но если вы не хотите трогать переменные окружения, установите его командой ‘pip install -e .’ из папки с пакетом.

Шаг 1: установите cURL

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

  1. Перейдите на https://curl.haxx.se/dlwiz/?type=binos=Win64flav=-ver=*cpu=x86_64.
  2. Загрузите пакет curl, который соответствует спецификациям вашей системы (32-бит или 64-бит).
  3. Разархивируйте файл и перейдите в папку bin, вы можете найти там файл curl.exe

Однако это означает, что вы можете использовать команду curl только в этой конкретной папке. Чтобы иметь возможность использовать команду curl из любого места на вашем компьютере, щелкните правой кнопкой мыши curl.exe, выберите «Свойства» и скопируйте значение «Местоположение». После этого щелкните правой кнопкой мыши «Мой компьютер» и выберите «Свойства». На панели параметров слева выберите параметр «Дополнительные параметры системы». Это выделено на скриншоте ниже.

Читайте так же:
Суммирование столбцов в Microsoft Excel

Использование команды curl

В появившемся окне нажмите «Переменные среды» в правом нижнем углу. Это выделено на скриншоте ниже:

Установка cURL

В следующем окне найдите и дважды щелкните пользовательскую переменную с именем «Путь», затем нажмите «Создать». В этом окне будет создано новое текстовое поле. Вставьте значение «Местоположение» для файла «curl.exe», который вы скопировали ранее, а затем нажмите «ОК».

cURL теперь должен быть доступен из любой точки вашей системы. Подтвердите установку, выполнив команду ниже:

Перейдем к следующему шагу.

Step 3: Installing Pip on Windows

Once you have confirmed that Python is installed correctly, we can proceed with installing Pip.

  1. Download get-pip.py to a folder on your computer.
  2. Open a command prompt and navigate to the folder containing the get-pip.py installer.
  3. Run the following command:

Pip should now be installed successfully. If we receive a “file not found” error, double check the directory path to the file. You can use the dir command to view the entire contents of a directory. It should be noted that Pip is installed by default with Python versions Python 2.7.9+ and Python 3.4+. As a side note, Pip also sets up both the virtualenv and pyvenv virtual environments when installed.

Шаг 3. Создание виртуального окружения

Виртуальное окружение (virtualenv) необходимо, чтобы изолировать фреймворк Django для каждого проекта. Это предотвратит возможное изменения в одном проекте при редактировании другого, а также позволит использовать разные версии Django для разных проектов.

Мы рекомендуем выполнять данный шаг, хотя его можно и пропустить. Но лучше уже при обучении всё делать правильно и «по уму».

Для установки виртуального окружения выполним несколько шагов:

Создание директории и переход в неё в командной строке Windows

    Откройте командную строку и перейдите в директорию, где хотите создать проект.

Читайте так же:
Как обновить браузер Opera

Здесь мы создали директорию djangoset1 и осуществили переход в неё.

Установка виртуальный среды в Python 3

Линия и точечная диаграмма

Мы можем создать более сложные и информативные графики, такие как график линейного разброса, аналогичным образом, как указано выше:

Давайте посмотрим на результат этой программы:

Пример точечной диаграммы

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

Пример plotly line

Проверьте, правильно ли установлены ваш pip и setuptools.

Перед обновлением вы должны проверить, установлены ли в вашей системе pip и setuptools. Он также показывает номера версий для обоих. Вы можете узнать, устарела ли ваша версия программы или setuptools, из-за которой у вас возникла ошибка. Выполните следующие шаги, чтобы проверить установленные версии:

  1. Откройте командную строку, выполнив поиск с помощью функции поиска Windows.
  2. Введите следующую команду, чтобы получить список установленных пакетов. Pip list.Проверка установленных пакетов
  3. Если инструменты установки доступны в списке пакетов, это означает, что они уже установлены в вашей системе. Вы можете проверить версию и сравнить ее с последней версией.

5. Загрузка дистрибутивных файлов

Пришло время загрузить эти файлы в PyPi. Прежде чем мы это сделаем, нужно сначала создать там учетную запись. Одна деталь: PyPi предлагает тестовую среду для публикации пакетов, так что вы можете поиграть с этим процессом перед публикацией по-настоящему. Я предоставлю обе регистрационные формы. Также я рекомендовал бы поработать с тестовым сайтом, прежде чем публиковать на живой сервер.

Приведу примеры публикации в обеих средах.

После регистрации пришло время установить последний инструмент:

Как только twine установится, можно использовать его для загрузки пакета в PyPi. Выполните эту команду на корневом уровне проекта:

Читайте так же:
Скачать драйвера для NVIDIA GeForce 210

Если они не работают, поместите перед ними python или python3 .

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

Image for postЗагрузка завершена!

Он даже даст вам ссылку в конце, чтобы показать, что пакет был опубликован для конкретной версии. Вот ссылки, которые были сгенерированы во время этого упражнения, представляющие TEST и PROD соответственно:

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

Также можно опустить -i https//test.pypi.org/simple/ , если хотите загружать из производственной версии PyPi, которая аналогична pip .

Image for postУра!

Теперь, когда мы установили пакет, проверим, что он был установлен правильно.

Откройте интерпретатор Python и импортируйте модуль hello_world , созданный в этой статье.

Image for postОшибок нет!

Наш интерпретатор должен распознать импорт без каких-либо проблем.

голоса
Рейтинг статьи
Ссылка на основную публикацию
Adblock
detector