chore: set up Django for development and testing

Author: paduszyk

.pre-commit-config.yaml

@@ -27,6 +27,8 @@ repos:
     rev: "v1.11.2"
     hooks:
       - id: mypy
+        additional_dependencies:
+          - django-stubs[compatible-mypy] ~= 5.0
 
 ci:
   autofix_commit_msg: "style: fix issues from Pre-commit hooks"

pyproject.toml

@@ -16,6 +16,10 @@ keywords = [
   "django-management-commands",
 ]
 classifiers = [
+  "Framework :: Django",
+  "Framework :: Django :: 4.2",
+  "Framework :: Django :: 5.0",
+  "Framework :: Django :: 5.1",
   "Intended Audience :: Developers",
   "License :: OSI Approved :: MIT License",
   "Operating System :: OS Independent",
@@ -30,16 +34,19 @@ classifiers = [
 ]
 requires-python = ">= 3.9"
 dependencies = [
+  "django >= 4.2, < 5.2",
+  "django-appconf ~= 1.0",
   "typing-extensions ~= 4.12",
 ]
 dynamic = ["version"]
 
 [project.optional-dependencies]
 dev = [
-  "mypy ~= 1.11",
+  "django-stubs[compatible-mypy] ~= 5.0",
   "pre-commit ~= 3.8",
   "pytest ~= 8.3",
   "pytest-custom-exit-code ~= 0.3",
+  "pytest-django ~= 4.9",
   "pytest-mock ~= 3.14",
   "pytest-randomly ~= 3.15",
   "ruff ~= 0.6",
@@ -66,24 +73,49 @@ known-first-party = ["management_commands"]
 required-imports = [
   "from __future__ import annotations",
 ]
+section-order = [
+  "future",
+  "standard-library",
+  "third-party",
+  "django",
+  "first-party",
+  "local-folder",
+]
+
+[tool.ruff.lint.isort.sections]
+"django" = ["django"]
 
 [tool.ruff.lint.pydocstyle]
 convention = "google"
 
 [tool.mypy]
 mypy_path = "src/"
 strict = true
+plugins = [
+  "mypy_django_plugin.main",
+]
+
+[[tool.mypy.overrides]]
+module = [
+  "appconf",
+]
+ignore_missing_imports = true
 
 [[tool.mypy.overrides]]
 module = [
   "tests.*",
 ]
 disallow_untyped_decorators = false
 
+[tool.django-stubs]
+django_settings_module = "tests.settings"
+strict_settings = false
+
 [tool.pytest.ini_options]
 addopts = [
   "-ra",
   "--suppress-no-test-exit-code",
+  "--ds=tests.settings",
 ]
 pythonpath = [".", "src/"]
 testpaths = ["tests/"]

tests/settings.py

@@ -0,0 +1 @@
+from __future__ import annotations