feat: better devexp with pre-commit hooks and github actions

[HicaroD]

Summary

This PR introduces pre-commit hooks to improve code quality and automate testing in the development workflow.

Changes Made

Pre-commit Hook Setup:

• Added hooks for ruff (linting & formatting), mypy (type checking), and pytest (automated testing)
• Added pre-commit as a development dependency in pyproject.toml

Documentation Updates:

• Updated contributing documentation (CONTRIBUTING.md, CONTRIBUTING-pt.md, and docs/contributing.md) to include instructions for installing and using pre-commit hooks

CI/CD Integration:

• Added new ci command in pyproject.toml for better code quality checking in continuous integration
• Updated GitHub Actions workflow (.github/workflows/code-quality-gate.yaml) to use the new CI command

Code Quality Fixes:

• Fixed type annotations to satisfy mypy linter
• Improved error handling types for mypy compliance

[JoaquimCassano]

Looks good, but I don't really get the changes of the HTTP status types (from literal to int). Why?

[HicaroD]

For some reason, linter was not really happy about those literals, but you could keep it and ignore the linter error.

If you go back to the literal implementation and execute the pre-commit checks, you will see that mypy will complain about it.

[JoaquimCassano]

I think it'd be better, tbh

[HicaroD]

It is certainly cleaner for us humans, I can revert these changes and ignore the linter errors for the sake of readability.

What do you think?

[JoaquimCassano]

I think it would be nice!

[HicaroD]

Done, @JoaquimCassano

So I was able to still use the literals and ensure code quality checks with Mypy without ignoring the linter errors, which is way better.

Note: Also those weird changes on other files were not done by hand, they were caused by Ruff formatting

[almeidazs]

Hey @HicaroD, your PR looks kinda good! I'm merging this rn

[HicaroD]

Hey, brother @almeidazs. Good to see you again.
Thanks for merging it!

[almeidazs]

Good to see you too, brother! Keep going