upload-to-pypi-and-conda.md

Upload Package to PyPI and Conda

• Publishing to PyPI Manually
  • Resources
  • Workflow
• Contributing to Conda Manually
  • Resources
  • Workflow

Publishing to PyPI Manually

Resources

• The official guide for building Python packages from scratch:
  • Python Packaging User Guide » Tutorials » Packaging Python Projects
• The Python project manager, Hatch, for building and publishing packages:
  • Hatch: a modern, extensible Python project manager

Workflow

• Create README.md in the directory root
• Create LICENSE in the directory root
• Create setup.py in the directory root
• Put Python modules in a subdirectory, src or whatever
• Put Python tests in a subdirectory, tests or whatever
• Create __init__.py in the subdirectory to make it discoverable
• Initialise the package with Hatch: hatch new --init
  • This creates pyproject.toml
• Build the package with Hatch: hatch build
  • Before running this hatch version x.y.z to set the version number
  • This creates dist/
• Upload the package to PyPI with Hatch: hatch publish -u __token__ -a TOKEN
  • the username is __token__ and the authentication token is created on PyPI

Contributing to Conda Manually

Resources

• The official guide for building conda packages that are independent of PyPI:
  • User guide / Tutorials / Building conda packages from scratch
• Description of the meta.yaml file which is the core of a conda package:
  • Resources / Defining metadata (meta.yaml)

Workflow

• conda install conda-build
• conda install anaconda-client
• Create meta.yaml in a folder named conda-recipe or whatever
• Build the package by conda build .
• Upload the package to Anaconda Cloud by anaconda upload /g/kreshuk/yu/miniconda3/envs/ENV_NAME/conda-bld/noarch/PACKAGE_NAME-pypy_1.tar.bz2