To get started, sign the Contributor License Agreement.
-
Fork the repository on GitHub.
-
Clone repository
git clone --recursive https://github.com/YourGithubUsername/platformio-core.git
-
Run
pip install tox
-
Go to the root of project where is located
tox.ini
and runtox -e py37
-
Activate current development environment:
- Windows:
.tox\py37\Scripts\activate
- Bash/ZSH:
source .tox/py37/bin/activate
- Fish:
source .tox/py37/bin/activate.fish
- Windows:
-
Make changes to code, documentation, etc.
-
Lint source code
make before-commit
-
Run the tests
make test
-
Build documentation
tox -e docs
(creates a directory _build under docs where you can find the html) -
Commit changes to your forked repository
-
Submit a Pull Request on GitHub.