|
| 1 | +# Contributing to FastAPI-boilerplate |
| 2 | + |
| 3 | +Thank you for your interest in contributing to FastAPI-boilerplate! This guide is meant to make it easy for you to get started. |
| 4 | + |
| 5 | +## Setting Up Your Development Environment |
| 6 | + |
| 7 | +### Cloning the Repository |
| 8 | +Start by forking and cloning the FastAPI-boilerplate repository: |
| 9 | + |
| 10 | +```sh |
| 11 | +git clone https://github.com/igorbenav/FastAPI-boilerplate.git |
| 12 | +``` |
| 13 | + |
| 14 | +### Using Poetry for Dependency Management |
| 15 | +FastAPI-boilerplate uses Poetry for managing dependencies. If you don't have Poetry installed, follow the instructions on the [official Poetry website](https://python-poetry.org/docs/). |
| 16 | + |
| 17 | +Once Poetry is installed, navigate to the cloned repository and install the dependencies: |
| 18 | +```sh |
| 19 | +cd FastAPI-boilerplate |
| 20 | +poetry install |
| 21 | +``` |
| 22 | + |
| 23 | +### Activating the Virtual Environment |
| 24 | +Poetry creates a virtual environment for your project. Activate it using: |
| 25 | + |
| 26 | +```sh |
| 27 | +poetry shell |
| 28 | +``` |
| 29 | + |
| 30 | +## Making Contributions |
| 31 | + |
| 32 | +### Coding Standards |
| 33 | +- Follow PEP 8 guidelines. |
| 34 | +- Write meaningful tests for new features or bug fixes. |
| 35 | + |
| 36 | +### Testing with Pytest |
| 37 | +FastAPI-boilerplate uses pytest for testing. Run tests using: |
| 38 | +```sh |
| 39 | +poetry run pytest |
| 40 | +``` |
| 41 | + |
| 42 | +### Linting |
| 43 | +Use mypy for type checking: |
| 44 | +```sh |
| 45 | +mypy src |
| 46 | +``` |
| 47 | + |
| 48 | +Use ruff for style: |
| 49 | +```sh |
| 50 | +ruff check --fix |
| 51 | +ruff format |
| 52 | +``` |
| 53 | + |
| 54 | +Ensure your code passes linting before submitting. |
| 55 | + |
| 56 | +## Submitting Your Contributions |
| 57 | + |
| 58 | +### Creating a Pull Request |
| 59 | +After making your changes: |
| 60 | + |
| 61 | +- Push your changes to your fork. |
| 62 | +- Open a pull request with a clear description of your changes. |
| 63 | +- Update the README.md if necessary. |
| 64 | + |
| 65 | + |
| 66 | +### Code Reviews |
| 67 | +- Address any feedback from code reviews. |
| 68 | +- Once approved, your contributions will be merged into the main branch. |
| 69 | + |
| 70 | +## Code of Conduct |
| 71 | +Please adhere to our [Code of Conduct](CODE_OF_CONDUCT.md) to maintain a welcoming and inclusive environment. |
| 72 | + |
| 73 | +Thank you for contributing to FastAPI-boilerplate🚀 |
0 commit comments