CONTRIBUTING.md

Contributing to Jupyter Releaser

General Jupyter contributor guidelines

If you're reading this section, you're probably interested in contributing to Jupyter. Welcome and thanks for your interest in contributing!

Please take a look at the Contributor documentation, familiarize yourself with using the Jupyter Server, and introduce yourself on the mailing list and share what area of the project you are interested in working on.

For general documentation about contributing to Jupyter projects, see the Project Jupyter Contributor Documentation

Setting Up a Development Environment

Use the following steps:

python -m pip install --upgrade setuptools pip
git clone https://github.com/jupyter-server/jupyter_releaser
cd jupyter-releaser
pip install -e .[test]

If you are using a system-wide Python installation and you only want to install the package for you, you can add --user to the install commands.

Set up pre-commit hooks for automatic code formatting, etc.

pre-commit install

You can also invoke the pre-commit hook manually at any time with

pre-commit run --all-files --hook-stage manual

Once you have done this, you can launch the main branch of Jupyter Releaser from any directory in your system with::

jupyter-releaser --help

Running Tests

To run the Python tests, use:

hatch run test:test

Documentation

Contributions can also take the form of fixes and improvements to the documentation.

To build the docs, run:

hatch run docs:build

To serve the docs:

hatch run docs:serve

It is also possible to automatically watch the docs with the following command:

hatch run docs:watch

Then open http://localhost:8000 in your browser to view the documentation.