updates to README.md addition of CONTRIBUTING.md work on tests and requirments-dev.txt

This commit is contained in:
2025-04-18 16:31:05 -05:00
parent 3113fb953f
commit 39a972d688
8 changed files with 414 additions and 38 deletions

106
CONTRIBUTING.md Normal file
View File

@@ -0,0 +1,106 @@
# Contributing to Django AWS SES
Thank you for your interest in contributing to Django AWS SES! This guide outlines how to set up the project, run tests, and submit changes.
## Getting Started
1. **Clone the Repository**:
```bash
git clone https://git-vault.zeeksgeeks.com/zeeksgeeks/django_aws_ses
cd django_aws_ses
```
2. **Set Up a Virtual Environment**:
```bash
python -m venv venv
source venv/bin/activate # On Windows: venv\Scripts\activate
```
3. **Install Dependencies**:
```bash
pip install -r requirements.txt
pip install -r requirements-dev.txt
```
4. **Configure a Test Django Project**:
- Create a Django project or use an existing one.
- Add `'django_aws_ses'` to `INSTALLED_APPS` in `settings.py`.
- Apply migrations:
```bash
python manage.py migrate
```
## Running Tests
1. Ensure test dependencies are installed:
```bash
pip install -r requirements-dev.txt
```
2. Run the test suite:
```bash
python manage.py test django_aws_ses
```
3. Check test coverage (optional):
```bash
pytest --cov=django_aws_ses
```
## Making Changes
1. **Create a Feature Branch**:
```bash
git checkout -b feature/your-feature-name
```
2. **Follow Coding Guidelines**:
- Write clear, concise code with docstrings.
- Ensure compatibility with Python 3.8+ and Django 3.2+.
- Add tests for new functionality.
3. **Test Your Changes**:
- Run the full test suite to ensure no regressions.
- Test manually in a Django project if needed.
4. **Commit Changes**:
```bash
git add .
git commit -m "Add your descriptive commit message"
```
5. **Push and Create a Pull Request**:
```bash
git push origin feature/your-feature-name
```
- Create a pull request on the repository.
- Describe your changes and reference any related issues.
## Reporting Issues
- Use the repositorys issue tracker to report bugs or suggest features.
- Provide detailed information, including steps to reproduce and environment details.
## License
By contributing, you agree that your contributions will be licensed under the MIT License.
## Contact
For questions, contact Ray Jessop at development@zeeksgeeks.com.