A package for accessing and analysing MalariaGEN data.
Project description
malariagen_data - analyse MalariaGEN data from Python
This Python package provides methods for accessing and analysing data from MalariaGEN.
Installation
The malariagen_data Python package is available from the Python
package index (PyPI) and can be installed via pip, e.g.:
pip install malariagen-data
Documentation
Documentation of classes and methods in the public API are available from the following locations:
Release notes (change log)
See GitHub releases for release notes.
Developer setup
To get setup for development, see this video and the instructions below.
Fork and clone this repo:
git clone git@github.com:[username]/malariagen-data-python.git
Install Python 3.8 (current recommended version for local development), e.g.:
sudo add-apt-repository ppa:deadsnakes/ppa
sudo apt install python3.8 python3.8-venv
Install pipx, e.g.:
python3.8 -m pip install --user pipx
python3.8 -m pipx ensurepath
Install poetry, e.g.:
pipx install poetry==1.4.1 --python=/usr/bin/python3.8
Create development environment:
cd malariagen-data-python
poetry use 3.8
poetry install
Activate development environment:
poetry shell
Install pre-commit and pre-commit hooks:
pipx install pre-commit --python=/usr/bin/python3.8
pre-commit install
Run pre-commit checks (isort, black, blackdoc, flake8, ...) manually:
pre-commit run --all-files
Run tests:
poetry run pytest -v
Tests will run slowly the first time, as data required for testing will be read from GCS. Subsequent runs will be faster as data will be cached locally in the "gcs_cache" folder.
Release process
Create a new GitHub release. That's it. This will automatically trigger publishing of a new release to PyPI and a new version of the documentation via GitHub Actions.
The version switcher for the documentation can then be updated by
modifying the docs/source/_static/switcher.json file accordingly.
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file malariagen_data-8.8.0.tar.gz.
File metadata
- Download URL: malariagen_data-8.8.0.tar.gz
- Upload date:
- Size: 131.4 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: poetry/1.7.1 CPython/3.10.12 Linux/6.5.0-1016-azure
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | be2c813a7ce8d5e90537efda738ecefb34635dcf27855970e5d935149032b63d |
|
| MD5 | af410bc6c215007d99a2c7d78669a28f |
|
| BLAKE2b-256 | 3f1703292e4a92999ebcda62b8f068d4eb7dff41fc62f4d8599fc4ab2462b868 |
Provenance
File details
Details for the file malariagen_data-8.8.0-py3-none-any.whl.
File metadata
- Download URL: malariagen_data-8.8.0-py3-none-any.whl
- Upload date:
- Size: 158.9 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: poetry/1.7.1 CPython/3.10.12 Linux/6.5.0-1016-azure
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | b48d44d167ddeff8f8cfd33dd4c9d509c7da808c7ff4d9ac3c646e4616aae970 |
|
| MD5 | 7c785c19898b7f924622afaaab7f0fe5 |
|
| BLAKE2b-256 | 2c98f07dc2ab6ea2034f524ef541f37f46ec325c3b6fcdb69bc491ac84e7fd24 |
