Updated tooling and configuration

Author: coordt

.pre-commit-config.yaml

@@ -1,17 +1,17 @@
 repos:
   - repo: https://github.com/psf/black
-    rev: 24.8.0
+    rev: 24.10.0
     hooks:
       - id: black
   - repo: https://github.com/astral-sh/ruff-pre-commit
     # Ruff version.
-    rev: 'v0.6.2'
+    rev: 'v0.7.4'
     hooks:
       - id: ruff
         args: [--fix, --exit-non-zero-on-fix]
         exclude: test.*
   - repo: https://github.com/pre-commit/pre-commit-hooks
-    rev: v4.6.0
+    rev: v5.0.0
     hooks:
       - id: check-added-large-files
       - id: check-case-conflict
@@ -43,14 +43,14 @@ repos:
     -   id: detect-secrets
         additional_dependencies: ["gibberish-detector"]
   - repo: https://github.com/pre-commit/mirrors-mypy
-    rev: v1.11.2
+    rev: v1.13.0
     hooks:
       - id: mypy
         args: [--no-strict-optional, --ignore-missing-imports]
         additional_dependencies: ["pydantic>2.0", "toml", "types-PyYAML"]
         exclude: "^tests/"
   - repo: https://github.com/jsh9/pydoclint
-    rev: 0.5.6
+    rev: 0.5.9
     hooks:
       - id: pydoclint
         args:

docs/gen_doc_stubs.py

@@ -14,8 +14,8 @@
 
 
 for path in sorted(package_root.rglob("*.py")):
-    module_path = path.with_suffix("")
-    doc_path = path.with_suffix(".md")
+    module_path = path.relative_to(src_root).with_suffix("")
+    doc_path = path.relative_to(src_root).with_suffix(".md")
     full_doc_path = Path("reference/api", doc_path)
 
     parts = tuple(module_path.parts)

mkdocs.yml

@@ -7,15 +7,15 @@ theme:
   logo: assets/logo.svg
   favicon: assets/favicon.png
   features:
-    - navigation.tabs
     - navigation.sections
     - navigation.path
     - navigation.indexes
-    - toc.integrate
+    - navigation.top
     - content.action.edit
     - content.action.view
     - content.code.annotate
     - content.tabs.link
+    - toc.integrate
   palette:
     - media: "(prefers-color-scheme: light)"
       scheme: default

pyproject.toml

@@ -25,6 +25,7 @@ dependencies = [
     "pydantic-settings>=2.4.0",
     "platformdirs>=4.2.2",
     "immutabledict>=4.2.0",
+    "rich-click>=1.8.3",
 ]
 authors = [
     { name = "Calloway Project",  email = "coreyoordt@gmail.com" },
@@ -55,14 +56,32 @@ test = [
     "pytest-sugar",
 ]
 docs = [
+    "black",
+    "markdown-customblocks",
+    "mdx-truly-sane-lists",
+    "mkdocs",
+    "mkdocs-click",
+    "mkdocs-gen-files",
+    "mkdocs-git-authors-plugin",
+    "mkdocs-git-committers-plugin",
+    "mkdocs-git-revision-date-localized-plugin",
+    "mkdocs-include-markdown-plugin",
+    "mkdocs-literate-nav",
+    "mkdocs-material",
+    "mkdocs-section-index",
+    "mkdocstrings[python]",
+    "python-frontmatter",
 ]
 
-#[project.scripts]
-#project-forge = project_forge.cli:cli
+[project.scripts]
+project-forge = "project_forge.cli:cli"
 
 [tool.hatch.version]
 path = "project_forge/__init__.py"
 
+[tool.mypy]
+python_version = "3.12"
+
 [tool.coverage.run]
 branch = true
 omit = ["**/test_*.py", "**/__main__.py"]