Skip to content
This repository has been archived by the owner on Feb 18, 2024. It is now read-only.

Latest commit

 

History

History
67 lines (40 loc) · 2.53 KB

CONTRIBUTING.md

File metadata and controls

67 lines (40 loc) · 2.53 KB

Contribution Guidelines

This document contains information for maintainers and contributing developers. It has everything you need to know to make doppel-cli awesome.

Table of Contents

Integrations

GitHub Actions

GitHub Actions is used to perform CI tasks in Linux and Mac OS environments. This integration is the most important one for doppel-cli.

configuration: .github/workflows/ci.yml

readthedocs

readthedocs is used for free creation and hosting of the documentation for doppel-cli. The documentation at https://doppel-cli.readthedocs.io/en/latest/index.html# is created automatically, for free, from the main branch of this repository.

configuration: .readthedocs.yml

Testing

Finding bugs using smoke tests

A set of smoke tests are available that you can use to help find bugs in doppel-cli.

To see if doppel-cli works for Python and R packages it has been shown to work for in the past, run

./smoke_tests/run.sh

To try running doppel-cli against all R packages installed on your system (in random order), run

./smoke_tests/all_r_packages.sh

If anything breaks, create an issue that includes the logs of the run and the results of running Rscript -e 'sessionInfo()'.

Documentation

Releases

Releasing to PyPi

PyPi is the official package manager used for distributing Python packages.

Releases to PyPi are done automatically by GitHub Actions whenever a new release is created on the Releases page.

Releasing to conda-forge

The recipe for the conda package is maintained at https://github.com/conda-forge/doppel-cli-feedstock.

Within a few hours of a new release to PyPI, conda-forge's automation creates a pull request in that repo.

To release a new version to conda-forge, just merge that PR.