|
| 1 | +# Contributing to Python WireMock |
| 2 | + |
| 3 | +[](https://slack.wiremock.org/) |
| 4 | + |
| 5 | +WireMock exists and continues to thrive due to the efforts of over 150 contributors, and we continue to welcome contributions to its evolution. Regardless of your expertise and time you could dedicate, there’re opportunities to participate and help the project! |
| 6 | + |
| 7 | +This page covers contributing to _Python WireMock_. |
| 8 | +For generic guidelines and links to other technology stacks, |
| 9 | +see [this page](https://wiremock.org/docs/participate/). |
| 10 | + |
| 11 | +## Get Started |
| 12 | + |
| 13 | +1. Join us ion the `#wiremock-python` channel on the [WireMock Slack](https://slack.wiremock.org/) |
| 14 | +2. Check out the GitHub issues! |
| 15 | + |
| 16 | +## Pull Requests |
| 17 | + |
| 18 | +All patches to the repository are done via pull requests. |
| 19 | +No special prerequisites exist, you can just submit the patches! |
| 20 | +General expectations: |
| 21 | + |
| 22 | +- All Tests and static checkers must pass |
| 23 | +- Code coverage shouldn't decrease |
| 24 | +- All Pull Requests should be rebased against master **before** submitting the PR. |
| 25 | +- The Pull Request titles represent the change well for users or developers |
| 26 | + |
| 27 | +## Development |
| 28 | + |
| 29 | +We use [Poetry](https://python-poetry.org/) for packaging and dependency management. |
| 30 | + |
| 31 | +After forking and cloning the repository, |
| 32 | +run the following command to setup the project: |
| 33 | + |
| 34 | +`poetry install` |
| 35 | + |
| 36 | +Then use your favorite IDE for development and testing. |
| 37 | + |
| 38 | +## Contributing examples |
| 39 | + |
| 40 | +Please submit new examples as a pull requests to the [examples directory](./examples/). |
| 41 | +You can also also add links to external examples and tutorials to the `README.md` |
| 42 | +file in the directory. |
| 43 | + |
| 44 | +When adding new examples, |
| 45 | +make sure to update the [documentation site page](./examples.md) too. |
| 46 | + |
| 47 | +## Working on Documentation |
| 48 | + |
| 49 | +The documentation is powered by [MkDocs](https://www.mkdocs.org/) and [ReadTheDocs](https://readthedocs.org/). |
| 50 | +All the necessary dependencies are included into the Poetry definition. |
| 51 | +To build the docs locally: |
| 52 | + |
| 53 | +```bash |
| 54 | +poetry run mkdocs build --site-dir=html |
| 55 | +``` |
| 56 | + |
| 57 | +MkDocs also comes with a built-in dev-server that lets you preview your documentation as you work on it by running the `mkdocs serve` command. |
| 58 | +By default, it will deploy the live documentation site to `http://localhost:8000`. |
| 59 | + |
| 60 | +## See also |
| 61 | + |
| 62 | +- [Contributing to WireMock](https://wiremock.org/docs/participate/) |
0 commit comments