🔧 chore: Update pre-commit config

- Add pyproject.toml config hook
- Add tox.ini config hook
- Add pyupgrade hook
- Add blacken docs hook for docs

.pre-commit-config.yaml

@@ -2,6 +2,9 @@ repos:
   - repo: https://github.com/pre-commit/pre-commit-hooks
     rev: v4.3.0
     hooks:
+      - id: check-toml
+      - id: check-yaml
+        files: \.yaml$
       - id: trailing-whitespace
         exclude: (migrations/|tests/|docs/|static/|media/).*
       - id: end-of-file-fixer
@@ -15,6 +18,21 @@ repos:
       - id: check-docstring-first
         exclude: (migrations/|tests/|docs/|static/|media/).*
 
+  - repo: https://github.com/tox-dev/pyproject-fmt
+    rev: 2.2.1
+    hooks:
+    - id: pyproject-fmt
+
+  - repo: https://github.com/tox-dev/tox-ini-fmt
+    rev: 1.3.1
+    hooks:
+    - id: tox-ini-fmt
+
+  - repo: https://github.com/asottile/pyupgrade
+    rev: v3.17.0
+    hooks:
+    -   id: pyupgrade
+
   - repo: https://github.com/charliermarsh/ruff-pre-commit
     rev: v0.5.5
     hooks:
@@ -39,7 +57,6 @@ repos:
     rev: v3.28.0
     hooks:
       - id: commitizen
-        exclude: (migrations/|tests/|docs/|static/|media/).*
 
   - repo: https://github.com/PyCQA/bandit
     rev: 1.7.4
@@ -56,6 +73,14 @@ repos:
         args: ["--in-place", "--recursive", "--blank"]
         exclude: (migrations/|tests/|docs/|static/|media/).*
 
+  - repo: https://github.com/adamchainz/blacken-docs
+    rev: 1.18.0
+    hooks:
+    - id: blacken-docs
+      additional_dependencies:
+      - black==24.4.2
+      files: '\.rst$'
+
   - repo: https://github.com/rstcheck/rstcheck
     rev: "v6.2.4"
     hooks:

docs/pytest_guide.rst

@@ -44,14 +44,17 @@ Example File Structure
     pytestmark = [
         pytest.mark.django_db,
         pytest.mark.admin,
-        pytest.mark.skipif(sys.version_info < (3, 8), reason="Python 3.8 or higher required")
+        pytest.mark.skipif(
+            sys.version_info < (3, 8), reason="Python 3.8 or higher required"
+        ),
     ]
 
     User = get_user_model()
 
+
     class TestMyModelAdmin:
         """Class for testing MyModelAdmin functionality."""
-        
+
         def test_some_functionality(self) -> None:
             # Test logic goes here
             pass
@@ -76,7 +79,9 @@ Example of pytestmark
     pytestmark = [
         pytest.mark.django_db,
         pytest.mark.admin,
-        pytest.mark.skipif(sys.version_info < (3, 8), reason="Python 3.8 or higher required")
+        pytest.mark.skipif(
+            sys.version_info < (3, 8), reason="Python 3.8 or higher required"
+        ),
     ]
 
 Docstrings
@@ -149,14 +154,17 @@ Admin Model Test Example
     pytestmark = [
         pytest.mark.django_db,
         pytest.mark.admin,
-        pytest.mark.skipif(sys.version_info < (3, 8), reason="Python 3.8 or higher required")
+        pytest.mark.skipif(
+            sys.version_info < (3, 8), reason="Python 3.8 or higher required"
+        ),
     ]
 
     User = get_user_model()
 
+
     class TestMyModelAdmin:
         """Class for testing MyModelAdmin functionality."""
-        
+
         def test_formfield_for_foreignkey_sets_queryset(self) -> None:
             """
             Test that the formfield for the ForeignKey correctly sets the queryset.
@@ -165,12 +173,18 @@ Admin Model Test Example
             """
             admin_site = AdminSite()
             request = HttpRequest()
-            request.user = User.objects.create_superuser('admin', '[email protected]', 'password')
-            
+            request.user = User.objects.create_superuser(
+                "admin", "[email protected]", "password"
+            )
+
             model_admin = MyModelAdmin(model=MyModel, admin_site=admin_site)
-            db_field = MyModel._meta.get_field('related_model')
-            
-            with patch.object(MyModelAdmin, 'get_field_queryset', return_value=MyModel.objects.filter(name="Test")) as mock_get_field_queryset:
+            db_field = MyModel._meta.get_field("related_model")
+
+            with patch.object(
+                MyModelAdmin,
+                "get_field_queryset",
+                return_value=MyModel.objects.filter(name="Test"),
+            ) as mock_get_field_queryset:
                 formfield = model_admin.formfield_for_foreignkey(db_field, request)
                 mock_get_field_queryset.assert_called_once_with(None, db_field, request)
                 assert isinstance(formfield.widget, widgets.ForeignKeyRawIdWidget)
@@ -189,12 +203,15 @@ Settings Check Test Example
 
     pytestmark = [
         pytest.mark.settings_checks,
-        pytest.mark.skipif(sys.version_info < (3, 8), reason="Python 3.8 or higher required")
+        pytest.mark.skipif(
+            sys.version_info < (3, 8), reason="Python 3.8 or higher required"
+        ),
     ]
 
+
     class TestMyAppConfig:
         """Test MyApp configuration and settings."""
-        
+
         def test_check_my_app_config_correct_settings(self, settings) -> None:
             """
             Test the MyApp configuration checker with correct settings.
@@ -204,7 +221,7 @@ Settings Check Test Example
             settings.MY_SETTING_ENABLED = True
             errors = check_my_app_config({})
             assert len(errors) == 0
-        
+
         def test_check_my_app_config_invalid_type(self, settings) -> None:
             """
             Test the MyApp configuration checker with invalid type settings.

docs/quick_start.rst

@@ -12,9 +12,8 @@ Quick Start
    .. code-block:: python
 
        INSTALLED_APPS = [
-           ...
-           'iranian_cities',
-           ...
+           ## Other apps
+           "iranian_cities",
        ]
 
 3. **Run migrations to apply model changes**:

docs/usage.rst

@@ -10,6 +10,7 @@ You can use the provided fields and admin mixin in your Django models:
         from django.db import models
         from iranian_cities.fields import ProvinceField
 
+
         class TestModel(models.Model):
             province = ProvinceField()
 
@@ -29,6 +30,7 @@ You can use the provided fields and admin mixin in your Django models:
         from iranian_cities.admin import IranianCitiesAdmin
         from test_app.models import TestModel
 
+
         @admin.register(TestModel)
         class TestModelAdmin(IranianCitiesAdmin):
             pass