Skip to content

Latest commit

 

History

History
166 lines (126 loc) · 4.25 KB

CODE_OF_CONDUCT.md

File metadata and controls

166 lines (126 loc) · 4.25 KB
Raw

Contribution Guidelines

Thank you for your interest in contributing to our package! This document outlines the tools and steps to follow to ensure a smooth and consistent workflow.

Contribution Workflow

  1. Fork and Clone: Fork the repository and clone it to your local machine.

    git clone https://github.com/sageteamorg/django-sage-tools.git
cd django-sage-tools

  2. Create a Branch: Create a new branch for your feature or bugfix.

    git checkout -b feature/your-feature-name

  3. Install Dependencies: Use Poetry to install dependencies.

    poetry install

  4. Write Code and Tests: Make your changes and write tests for your new code.

  5. Run Code Quality Checks: Ensure code quality with pre-commit, Ruff, and Pylint.

    ruff check .
ruff check --fix

  6. Run Tests: Ensure all tests pass using Poetry.

    poetry run pytest

  7. Commit Changes: Use Commitizen to commit your changes.

    cz commit

  8. Push and Create a PR: Push your changes and create a pull request.

    git push origin feature/your-feature-name

  9. Bump Version: Use Commitizen to bump the version.

    cz bump

  10. Generate Changelog: Use Commitizen to generate the changelog.

    cz changelog

  11. Export Dependencies: Export dependencies for development and production.

    poetry export -f requirements.txt --output packages/requirements.txt --without-hashes
poetry export -f requirements.txt --dev --output packages/requirements-dev.txt --without-hashes

Commitizen Message Rule

Commitizen follows the Conventional Commits specification. The commit message should be structured as follows:

<type>[optional scope]: <description>

[optional body]

[optional footer(s)]

Here are 10 examples of commit messages following the Commitizen Conventional Commits specification:

1. Initialization of core

feat(core): initialize the core module

- Set up the core structure
- Added initial configurations and settings
- Created basic utility functions

2. Release with build and tag version

chore(release): build and tag version 1.0.0

- Built the project for production
- Created a new tag for version 1.0.0
- Updated changelog with release notes

3. Adding a new feature

feat(auth): add user authentication

- Implemented user login and registration
- Added JWT token generation and validation
- Created middleware for protected routes

4. Fixing a bug

fix(api): resolve issue with data fetching

- Fixed bug causing incorrect data responses
- Improved error handling in API calls
- Added tests for the fixed bug

5. Update a doc (Sphinx)

docs(sphinx): update API documentation

- Updated the Sphinx documentation for API changes
- Added examples for new endpoints
- Fixed typos and formatting issues

6. Update dependencies (packages)

chore(deps): update project dependencies

- Updated all outdated npm packages
- Resolved compatibility issues with new package versions
- Ran tests to ensure no breaking changes

7. Update version for build and publish

chore(version): update version to 2.1.0 for build and publish

- Incremented version number to 2.1.0
- Updated package.json with the new version
- Prepared for publishing the new build

8. Adding unit tests

test(auth): add unit tests for authentication module

- Created tests for login functionality
- Added tests for registration validation
- Ensured 100% coverage for auth module

9. Refactoring codebase

refactor(core): improve code structure and readability

- Refactored core module to enhance readability
- Extracted utility functions into separate files
- Updated documentation to reflect code changes

10. Improving performance

perf(parser): enhance parsing speed

- Optimized parsing algorithm for better performance
- Reduced the time complexity of the parsing function
- Added benchmarks to track performance improvements

These examples cover various types of commits such as feature additions, bug fixes, documentation updates, dependency updates, versioning, testing, refactoring, and performance improvements.