Contributing to CRUDAdmin

Thank you for your interest in contributing to CRUDAdmin! This guide is meant to make it easy for you to get started.

Setting Up Your Development Environment

Cloning the Repository

Start by forking and cloning the CRUDAdmin repository:

git clone https://github.com/igorbenav/crudadmin.git

Using UV for Dependency Management

CRUDAdmin uses UV for managing dependencies. If you don't have UV installed, follow the instructions on the official UV website.

Once UV is installed, navigate to the cloned repository.

Activating the Virtual Environment

UV can a virtual environment for your project. Activate it using:

uv venv

Then

source .venv/bin/activate

Making Contributions

Coding Standards

• Follow PEP 8 guidelines.
• Write meaningful tests for new features or bug fixes.

Testing with Pytest

CRUDAdmin uses pytest for testing. Run tests using:

uv run pytest

Linting

Use mypy for type checking:

uv run mypy crudadmin

Use ruff for style:

uv run ruff check --fix
uv run ruff format

Ensure your code passes linting before submitting.

Submitting Your Contributions

Creating a Pull Request

After making your changes:

• Push your changes to your fork.
• Open a pull request with a clear description of your changes.
• Update the README.md if necessary.

Code Reviews

• Address any feedback from code reviews.
• Once approved, your contributions will be merged into the main branch.

Code of Conduct

Please adhere to our Code of Conduct to maintain a welcoming and inclusive environment.

Thank you for contributing to CRUDAdmin🚀