Skip to content

Commit 6a63fb6

Browse files
authored
Merge pull request #104 from igorbenav/igorbenav-patch-1
Create CONTRIBUTING.md
2 parents 415e179 + e0d9b8c commit 6a63fb6

File tree

1 file changed

+73
-0
lines changed

1 file changed

+73
-0
lines changed

CONTRIBUTING.md

Lines changed: 73 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,73 @@
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

Comments
 (0)