Skip to content

Latest commit

 

History

History
112 lines (68 loc) · 2.67 KB

CONTRIBUTING.rst

File metadata and controls

112 lines (68 loc) · 2.67 KB

Contributor Guide

Thank you for your interest in improving this project. This project is open-source under the Apache 2.0 license and welcomes contributions in the form of bug reports, feature requests, and pull requests.

Here is a list of important resources for contributors:

How to report a bug

Report bugs on the Issue Tracker.

When filing an issue, make sure to answer these questions:

  • Which operating system and Python version are you using?
  • Which version of this project are you using?
  • What did you do?
  • What did you expect to see?
  • What did you see instead?

The best way to get your bug fixed is to provide a test case, and/or steps to reproduce the issue.

How to request a feature

Request features on the Issue Tracker.

How to set up your development environment

You need Python 3.9+.

  • Clone the repository:
$ git clone https://github.com/iterative/dvclive
$ cd dvclive
  • Set up a virtual environment:
$ python -m venv .venv
$ source .venv/bin/activate

Install in editable mode including development dependencies:

$ pip install -e .[tests]

If you need to test against a specific framework, you can install it separately:

$ pip install -e .[tests,tf]
$ pip install -e .[tests,optuna]

How to test the project

Run the full test suite:

$ pytest -v tests

Tests are located in the tests directory, and are written using the pytest testing framework.

How to submit changes

Open a pull request to submit changes to this project.

Your pull request needs to meet the following guidelines for acceptance:

  • The test suite must pass without errors and warnings.
  • Include unit tests.
  • If your changes add functionality, update the documentation accordingly.

Feel free to submit early, though—we can always iterate on this.

To run linting and code formatting checks, you can use pre-commit:

$ pre-commit run --all-files

It is recommended to open an issue before starting work on anything. This will allow a chance to talk it over with the owners and validate your approach.