|
| 1 | +# Contributing to fastapi-user-authentication |
| 2 | + |
| 3 | +Thank you for your interest in contributing! We welcome contributions to improve our project, including bug fixes, new features, documentation updates, and more. |
| 4 | + |
| 5 | +## Table of Contents |
| 6 | + |
| 7 | +- [Getting Started](#getting-started) |
| 8 | +- [Development Workflow](#development-workflow) |
| 9 | +- [Guidelines](#guidelines) |
| 10 | +- [Submitting Contributions](#submitting-contributions) |
| 11 | +- [Code of Conduct](#code-of-conduct) |
| 12 | +- [Contact](#contact) |
| 13 | + |
| 14 | +## Getting Started |
| 15 | + |
| 16 | +1. **Fork the Repository**: Start by forking the repository to your GitHub account. |
| 17 | +2. **Clone Your Fork**: |
| 18 | + ```bash |
| 19 | + git clone https://github.com/VannySothea/fastapi-user-authentication.git |
| 20 | + cd fastapi-user-authentication |
| 21 | + ``` |
| 22 | +3. **Install Dependencies**: |
| 23 | + Ensure you have Python 3.12+ installed. Install the required dependencies: |
| 24 | + ```bash |
| 25 | + pip install -r requirements.txt |
| 26 | + ``` |
| 27 | + |
| 28 | +4. **Set Up Environment**: Configure the necessary environment variables: |
| 29 | + - Copy the `.env.example` file to `.env` and update values as needed. |
| 30 | + |
| 31 | +## Development Workflow |
| 32 | + |
| 33 | +1. **Create a Branch**: Use a descriptive branch name for your feature or fix. |
| 34 | + ```bash |
| 35 | + git checkout -b feature/your-feature-name |
| 36 | + ``` |
| 37 | + |
| 38 | +2. **Make Changes**: Implement your changes following the project's coding standards. |
| 39 | + |
| 40 | +3. **Run Tests**: (Once tests are available) Run tests to ensure your changes don't break existing functionality. |
| 41 | + ```bash |
| 42 | + # Example command to run tests |
| 43 | + pytest |
| 44 | + ``` |
| 45 | + |
| 46 | +4. **Commit Changes**: Write clear, descriptive commit messages. |
| 47 | + ```bash |
| 48 | + git add . |
| 49 | + git commit -m "Add description of changes" |
| 50 | + ``` |
| 51 | + |
| 52 | +5. **Push to Your Fork**: |
| 53 | + ```bash |
| 54 | + git push origin feature/your-feature-name |
| 55 | + ``` |
| 56 | + |
| 57 | +6. **Create a Pull Request (PR)**: Go to the repository on GitHub and create a PR from your branch. |
| 58 | + |
| 59 | +## Guidelines |
| 60 | + |
| 61 | +### Code Style |
| 62 | + |
| 63 | +- Follow **PEP 8** guidelines. |
| 64 | +- Use descriptive variable names and comments where necessary. |
| 65 | +- Ensure consistent formatting, especially in Python files. |
| 66 | + |
| 67 | +### Documentation |
| 68 | + |
| 69 | +- Update the documentation for any new features, modules, or functions you add. |
| 70 | +- Include code comments and docstrings for complex logic. |
| 71 | + |
| 72 | +### Commit Messages |
| 73 | + |
| 74 | +- Use descriptive messages to explain the "why" behind each change. |
| 75 | +- Use the format: `[Type]: Description` (e.g., `feat: add role-based access control`). |
| 76 | + |
| 77 | +### Pull Request Checklist |
| 78 | + |
| 79 | +- Ensure your PR description explains what changes are made and why. |
| 80 | +- Reference any relevant issues by including the issue number. |
| 81 | +- Address any feedback from code reviewers. |
| 82 | + |
| 83 | +## Code of Conduct |
| 84 | + |
| 85 | +This project adheres to a [Code of Conduct](./CODE_OF_CONDUCT.md). By participating, you agree to uphold these standards. |
| 86 | + |
| 87 | +## Contact |
| 88 | + |
| 89 | +If you have any questions or need further guidance, feel free to reach out by creating an issue in the repository or contacting the maintainers. |
0 commit comments