Skip to content

Commit

Permalink
readme: developing docs
Browse files Browse the repository at this point in the history
  • Loading branch information
dhimmel committed Apr 4, 2021
1 parent 4e4585c commit bca4a71
Show file tree
Hide file tree
Showing 2 changed files with 27 additions and 18 deletions.
2 changes: 2 additions & 0 deletions .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,8 @@ dist/
.cache
.pytest_cache/
.ipynb_checkpoints/
env/
pip-wheel-metadata/

# System specific files

Expand Down
43 changes: 25 additions & 18 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -80,21 +80,28 @@ We welcome feature suggestions and community contributions.
Currently, only reading OBO files is supported.
Please open an issue if you're interested in writing OBO files in Python.

## Release instructions

This section is only relevant for project maintainers.
Travis CI deployments are used to upload releases to [PyPI](https://pypi.org/project/hetio).
To create a new release, do the following:

1. Bump the `__version__` in [`obonet/__init__.py`](https://github.com/dhimmel/obonet/blob/master/obonet/__init__.py).

3. Run the following commands:

```sh
TAG=v`python setup.py --version`
git add obonet/__init__.py
git commit --message="Upgrade version to $TAG"
git push
git tag --annotate $TAG --message="Release $TAG"
git push --tags
```
## Develop

Some development commands:

```bash
# create virtual environment
python3 -m venv ./env

# activate virtual environment
source env/bin/activate

# editable installation for development
pip install --editable ".[dev]"

# install pre-commit hooks
pre-commit install

# run all pre-commit checks
pre-commit run --all

# run tests
pytest
```

Maintainers can make a new release at <https://github.com/dhimmel/obonet/releases/new>.

0 comments on commit bca4a71

Please sign in to comment.