Skip to content

Latest commit

 

History

History
132 lines (101 loc) · 3.66 KB

CONTRIBUTING.md

File metadata and controls

132 lines (101 loc) · 3.66 KB

Developer Contribution Guide

Contribute to the repository by opening a pull request.

Local

Develop code locally by cloning the source code, creating a development environment and installing it.

  1. Install mamba, then launch the Miniforge Prompt.

  2. Clone the main branch of eqt locally, and navigate into where it has been cloned:

# Clone (download) source code
git clone [email protected]:TomographicImaging/eqt.git
cd eqt
  1. Create the mamba environment using the following command:
# Create environment
mamba env create -f recipe/eqt_env.yml

eqt uses the qtpy abstraction layer for Qt bindings, meaning that it works with either PySide or PyQt bindings. Thus, eqt_env does not depend on either. The environment can be updated with either pyside2 or pyqt5, as follows.

mamba env update --name eqt_env --file pyside_env.yml

or

mamba env update --name eqt_env --file pyqt_env.yml
  1. Activate the environment:
mamba activate eqt_env
  1. Install the dependencies:
# Install test dependencies
pip install .[dev]

Merge the main Branch

Conflicts may exist if your branch is behind the main branch. To resolve conflicts between branches, merge the main branch into your current working branch:

git merge main

Run Tests

Before merging a pull request, all tests must pass. These can be run locally from the repository folder:

pytest

Install and Run pre-commit

Adhere to our styling guide by installing pre-commit in your local eqt environment:

pip install pre-commit
pre-commit install

From your local repository folder, run pre-commit on all the files before committing:

pre-commit run -a

OR,

Run pre-commit on a single file by specifying its file path:

pre-commit run --files [path]

The .pre-commit-config.yaml config file indicates the repositories and the hooks which will be applied automatically.

Continuous Integration

GitHub Actions automatically runs a subset of the unit tests on every commit via test.yml.

Testing

Runs pytest.

Building

Runs automatically after tests (above) succeed.

Builds binary (*.whl) & source (*.tar.gz) distributions.

Releasing

Runs automatically -- when an annotated tag is pushed -- after builds (above) succeed.

Publishes to PyPI.

⚠️ The annotated tag's title must be Version <number without v-prefix> (separated by a blank line) and the body must contain release notes, e.g.:

git tag v1.33.7 -a
Version 1.33.7

<body>

The <body> should be taken from the changelog (below).

Changelog

Located in CHANGELOG.md.

Changelog Style

The changelog file needs to be updated manually every time a pull request (PR) is submitted:

  • Itemise the message with "-".
  • Be concise by explaining the overall changes in only a few words.
  • Mention the relevant PR in brackets.

Example:

# Version x.x.x
- Add `title` to `FormDockWidget` & update tests/examples (#102)