Создание новой версии nbdime

Расширение может быть опубликовано в PyPI и npm вручную или с помощью Jupyter Releaser.

Вручную

Python пакет

Это расширение можно распространять как Python пакеты. Все инструкции по упаковке Python находятся в файле pyproject.toml для обёртки вашего расширения в Python пакет. Перед генерацией пакета вам нужно установить некоторые инструменты:

pip install build twine hatch

Увеличьте версию используя скрипт:

python scripts/bump_version.py <новая_версия>

<новая_версия> может быть сегментом типа major, minor, patch, alpha, ...

Убедитесь, что вы очистили все файлы разработки перед сборкой пакета:

jlpm clean:all

Вы также можете очистить локальный git репозиторий:

git clean -dfX

Чтобы создать Python исходный пакет (.tar.gz) и двоичный пакет (.whl) в директории dist/, выполните:

python -m build

python setup.py sdist bdist_wheel устарел и не будет работать для этого пакета.

Затем чтобы загрузить пакет на PyPI, выполните:

twine upload dist/*

NPM пакет

Чтобы опубликовать фронтенд часть расширения как NPM пакет, выполните:

npm login
npm publish --access public

Автоматизация выпуска с использованием Jupyter Releaser

Репозиторий расширения уже должен быть совместимым с Jupyter Releaser.

См. документацию по рабочим процессам для получения дополнительной информации.Вот краткое описание шагов для создания новой версии:

• Добавьте токены в GitHub Secrets в репозитории:
  • ADMIN_GITHUB_TOKEN (с правами доступа "public_repo" и "repo:status"); см. документацию
  • NPM_TOKEN (с правами доступа "automation"); см. документацию
• Настройте PyPI

map:
  repo1: token1
  repo2: token2

Если у вас есть несколько пакетов Python в одном репозитории, вы можете указывать на них следующим образом:

```text
owner1/repository1/path/to/package1,token1
owner1/repository1/path/to/package2,token2
```

Опубликование на conda-forge

Если пакет ещё не находится на конда-фордж, проверьте документацию, чтобы узнать, как его добавить: https://conda-forge.org/docs/maintainer/adding_pkgs.html

В противном случае бот должен автоматически обнаружить новую версию, опубликовать её на PyPI и открыть новый запрос на слияние в репозитории feedstock.