fr-docs 2.3.0__tar.gz → 2.5.0__tar.gz

{fr_docs-2.3.0 → fr_docs-2.5.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fr-docs
-Version: 2.3.0
+Version: 2.5.0
 Summary: Fast static documentation generator with search, versioning, and zero-config setup
 Author: Omena0
 License: # PolyForm Noncommercial License 1.0.0
@@ -175,7 +175,6 @@ Generate fast, fully featured, modern documentation pages from markdown for GitH
 - [Quickstart](https://omena0.dev/fr-docs/quickstart)
 - [Configuration](https://omena0.dev/fr-docs/config.json)
 - [Showcase](https://omena0.dev/fr-docs/showcase)
-- [Pagespeed](https://omena0.dev/fr-docs/pagespeed) — performance metrics
 
 ## Overview
 
@@ -183,43 +182,26 @@ Fr-docs is a generic, configurable documentation builder for Python projects. It
 
 ### Key Features
 
-- **Config-driven**: All settings defined in `config.json`
-  - Project name, URL, description, and sidebar structure
-  - Search, code references, auto-linking, and related pages
-  - Build options: workers, minification, zstd level, and HTML optimization
+- **Toggleable features**: Disable any features in the config.
+- **Search**: Search pages, headers, source code files, or symbols. Fuzzy matching included.
+- **Markdown features**: Feature-complete markdown features, including:
+  - **Code highlighting**: Highlight code blocks with `fastpylight`
+  - **Copy code blocks**: Copy buttons on multiline code blocks, inline copy code blocks.
+  - **Tables**: Auto convert markdown tables
+  - **Frontmatter metadata**: Title and description as optional frontmatter.
+  - **Hover previews**: Hover a link to see the title and description, hover a code ref to see a code preview.
+  - **Code references**: Link to a source code files, lines, line ranges, or symbols. Automatically generates a clickable code ref.
+  - **Custom tags**: Highlight tags such as `[ext]` automatically across the site.
+- **Auto versioned**: Automatically switch to older documentation based on github tags.<br>
+<sup><sub>(requires site/ to be commited into the repo)</sup></sub>
+- **Auto minification**: Minifies HTML, CSS and JS and inlines Critical CSS.
+- **Same-origin fonts**: Serve fonts from the same origin. Download once before build, serve forever.
+- **Page preloading**: Preload page links for faster browsing.
+- **Configurable elements**: Configure project name, icon, copyright, topbar links, etc.
 
-- **Zero-config setup**: Works out of the box with sensible defaults
-- **Search**: Full-text search with Zstandard-compressed index
-  - Symbol-level search across all source files
-  - File index for browsing source code
-  - Per-file source highlights with caching
-
-- **Optimized**: HTML minification, critical CSS/JS inlining, Zstd compression
-  - Critical CSS extracted and inlined for both mobile and desktop viewports
-  - JavaScript and CSS minified with `terser` and `html-minifier-next`
-  - Zstd-compressed search index, source files, highlights, and metadata
-  - Adaptive zstd level selection (scans 1..configured, picks the smallest)
-
-- **Multi-environment**: Different configs for production, staging, development
-- **Parallel builds**: Threaded page generation for faster builds
-- **Git integration**: Automatic metadata extraction from git commits
-  - Version options derived from commit messages (e.g. `4D - fix bug` → `4.4.0`)
-  - Commit SHA and message embedded in the version selector
-
-- **Local font serving**: Fonts downloaded at build time and served from the site's own origin
-  - No third-party font round-trips or 404s when Google changes the URL scheme
-  - `font-display: swap` with metric-compatible `font-ascent-descent` fallbacks
-  - Primary body font weight preloaded for faster first paint
-
-- **Sidebar**: Collapsible sections with auto-expansion
-  - The section containing the current page is expanded on load
-  - Single-page sections and single-section sites are expanded by default
-
-- **Inline copy commands**: Prefix inline code with `c` to create copy-on-click links
-- **Code references**: Auto-link bare filename references to their source files
-- **Backlinks and related pages**: Automatically generated navigation between related content
 
 ### Projects that use fr-docs
 
 - [Fr-docs](https://omena0.dev/fr-docs/)
 - [PyJavaBridge](https://omena0.dev/PyJavaBridge)
+<sub><sup>(Legacy)</sup></sub>

fr_docs-2.5.0/README.md

@@ -0,0 +1,47 @@
+
+# Fr-docs
+
+Generate fast, fully featured, modern documentation pages from markdown for GitHub pages and static hosting.
+
+[![Lint](https://github.com/Omena0/fr-docs/actions/workflows/lint.yml/badge.svg)](https://github.com/Omena0/fr-docs/actions/workflows/lint.yml)
+[![Docs](https://github.com/Omena0/fr-docs/actions/workflows/pages.yml/badge.svg)](https://github.com/Omena0/fr-docs/actions/workflows/pages.yml)
+[![PyPi](https://github.com/Omena0/fr-docs/actions/workflows/publish.yml/badge.svg)](https://github.com/Omena0/fr-docs/actions/workflows/publish.yml)
+[![CodeQL](https://github.com/Omena0/fr-docs/actions/workflows/github-code-scanning/codeql/badge.svg)](https://github.com/Omena0/fr-docs/actions/workflows/github-code-scanning/codeql)
+
+## Documentation
+
+- [Getting Started](https://omena0.dev/fr-docs/)
+- [Installation](https://omena0.dev/fr-docs/installation)
+- [Quickstart](https://omena0.dev/fr-docs/quickstart)
+- [Configuration](https://omena0.dev/fr-docs/config.json)
+- [Showcase](https://omena0.dev/fr-docs/showcase)
+
+## Overview
+
+Fr-docs is a generic, configurable documentation builder for Python projects. It converts Markdown source files into a searchable, optimized static HTML site with zero-config setup.
+
+### Key Features
+
+- **Toggleable features**: Disable any features in the config.
+- **Search**: Search pages, headers, source code files, or symbols. Fuzzy matching included.
+- **Markdown features**: Feature-complete markdown features, including:
+  - **Code highlighting**: Highlight code blocks with `fastpylight`
+  - **Copy code blocks**: Copy buttons on multiline code blocks, inline copy code blocks.
+  - **Tables**: Auto convert markdown tables
+  - **Frontmatter metadata**: Title and description as optional frontmatter.
+  - **Hover previews**: Hover a link to see the title and description, hover a code ref to see a code preview.
+  - **Code references**: Link to a source code files, lines, line ranges, or symbols. Automatically generates a clickable code ref.
+  - **Custom tags**: Highlight tags such as `[ext]` automatically across the site.
+- **Auto versioned**: Automatically switch to older documentation based on github tags.<br>
+<sup><sub>(requires site/ to be commited into the repo)</sup></sub>
+- **Auto minification**: Minifies HTML, CSS and JS and inlines Critical CSS.
+- **Same-origin fonts**: Serve fonts from the same origin. Download once before build, serve forever.
+- **Page preloading**: Preload page links for faster browsing.
+- **Configurable elements**: Configure project name, icon, copyright, topbar links, etc.
+
+
+### Projects that use fr-docs
+
+- [Fr-docs](https://omena0.dev/fr-docs/)
+- [PyJavaBridge](https://omena0.dev/PyJavaBridge)
+<sub><sup>(Legacy)</sup></sub>

fr_docs-2.5.0/fr_docs/__main__.py

@@ -0,0 +1,114 @@
+"""Entry point for fr-docs CLI.
+
+Usage:
+    python -m fr_docs build [--production] [--symlink] [--config CONFIG]
+    fr-docs build [--production] [--symlink] [--config CONFIG]
+    python -m fr_docs init [DIR] [config|fonts]
+    fr-docs init [DIR] [config|fonts]
+"""
+
+import argparse
+import sys
+
+from .build import main as build_main
+from .init import main as init_main
+
+
+def main() -> None:
+    parser = argparse.ArgumentParser(
+        prog="fr-docs",
+        description="Fast static documentation generator",
+    )
+    subparsers = parser.add_subparsers(
+        dest="command",
+        help="Available commands",
+    )
+
+    # Build command
+    build_parser = subparsers.add_parser(
+        "build",
+        help="Build the documentation site",
+    )
+    build_parser.add_argument(
+        "--production",
+        action="store_true",
+        help="Rewrite internal links to site-root absolute paths for deployed docs.",
+    )
+    build_parser.add_argument(
+        "--symlink",
+        action="store_true",
+        help=(
+            "Create a {site_prefix}/ symlink dir under site/ so a local "
+            "production build can be opened in a browser. Off by default: "
+            "in CI the whole docs/site/ tree is deployed as-is, and a nested "
+            "fr-docs/ symlink folder would show up as "
+            "omena0.dev/fr-docs/fr-docs/."
+        ),
+    )
+    build_parser.add_argument(
+        "--config",
+        help="Path to the configuration JSON file.",
+    )
+
+    # Init command
+    init_parser = subparsers.add_parser(
+        "init",
+        help="Initialize a new documentation project",
+    )
+    init_parser.add_argument(
+        "dir",
+        nargs="?",
+        default="docs",
+        help="Directory to initialize (default: docs)",
+    )
+    init_parser.add_argument(
+        "target",
+        nargs="?",
+        choices=["config", "fonts"],
+        default=None,
+        help="Initialize only the configuration or download fonts.",
+    )
+
+    args = parser.parse_args(sys.argv[1:])
+
+    if args.command == "build":
+        build_argv: list[str] = []
+
+        if args.production:
+            build_argv.append("--production")
+
+        if args.symlink:
+            build_argv.append("--symlink")
+
+        if args.config:
+            build_argv.extend(["--config", args.config])
+
+        build_main(build_argv)
+        return
+
+    if args.command == "init":
+        # If first arg is "config" or "fonts" with no explicit dir, use current directory
+        if args.dir in ("config", "fonts") and args.target is None:
+            init_main(".", args.dir)
+            return
+
+        init_main(args.dir, args.target)
+        return
+
+    # Default to build for backwards compatibility.
+    if len(sys.argv) > 1 and sys.argv[1] in (
+        "--production",
+        "--symlink",
+        "--config",
+        "--help",
+        "-h",
+    ):
+        build_main(sys.argv[1:])
+        return
+
+    parser.print_help()
+    sys.exit(1)
+
+
+if __name__ == "__main__":
+    main()

{fr_docs-2.3.0 → fr_docs-2.5.0}/fr_docs/build.py

@@ -6,6 +6,8 @@ Converts Markdown source files into a static HTML site using configuration.
 
 import argparse
 import concurrent.futures
+import contextlib
+import glob
 import json
 import os
 import re
@@ -25,10 +27,12 @@ from .config_accessors import (
     project_name,
     search_index_filename,
     sidebar,
-    src_dir,
     workers,
     zstd_level,
 )
+from .config_accessors import (
+    src_dir as config_src_dir,
+)
 from .git import build_version_options, collect_git_metadata
 from .html_pipeline import build_page, minify_all_pages, optimize_all_pages
 from .search import build_search_index, search_include_config
@@ -42,7 +46,7 @@ from .utils import normalized_site_prefix
 
 def _compute_hash(data: str) -> str:
     """Compute xxhash hash of string data."""
-    return xxhash.xxh3_128_hexdigest(data.encode("utf-8"))
+    return xxhash.xxh3_128_hexdigest(data.encode())
 
 
 def _best_zstd_level(raw: bytes, configured: int) -> int:
@@ -78,8 +82,8 @@ def _minify_static_asset(config, src: Path, dst: Path, name: str) -> None:
         terser_bin = node_modules / ".bin" / "terser"
         cmd = [
             str(terser_bin) if terser_bin.exists() else "npx",
-            "--yes" if not terser_bin.exists() else "",
-            *(["terser"] if not terser_bin.exists() else []),
+            "" if terser_bin.exists() else "--yes",
+            *([] if terser_bin.exists() else ["terser"]),
             str(src),
             "--compress",
             "warnings=false",
@@ -107,8 +111,8 @@ def _minify_static_asset(config, src: Path, dst: Path, name: str) -> None:
         wrapper.write_text(wrapped, encoding="utf-8")
         cmd = [
             str(minifier_bin) if minifier_bin.exists() else "npx",
-            "--yes" if not minifier_bin.exists() else "",
-            *(["html-minifier-next"] if not minifier_bin.exists() else ""),
+            "" if minifier_bin.exists() else "--yes",
+            *("" if minifier_bin.exists() else ["html-minifier-next"]),
             "--minify-css=true",
             "--remove-comments",
             "--output",
@@ -121,27 +125,22 @@ def _minify_static_asset(config, src: Path, dst: Path, name: str) -> None:
         )
         if result.returncode == 0 and min_out.exists():
             out = min_out.read_text(encoding="utf-8")
-            m = re.search(r"<style>([\s\S]*)</style>", out)
-            if m:
-                dst.write_text(m.group(1), encoding="utf-8")
+            if m := re.search(r"<style>([\s\S]*)</style>", out):
+                dst.write_text(m[1], encoding="utf-8")
                 return
         print(f"  ! minify failed for {name}, copying raw: {result.stderr[-300:]}")
     finally:
-        try:
+        with contextlib.suppress(OSError):
             wrapper.unlink()
-        except OSError:
-            pass
-        try:
+        with contextlib.suppress(OSError):
             min_out.unlink()
-        except OSError:
-            pass
     shutil.copyfile(src, dst)
 
 
 class BuildCache:
     """Manage caching of build data to avoid unnecessary regeneration."""
 
-    def __init__(self, cache_path: str):
+    def __init__(self, cache_path: str) -> None:
         self.cache_path = Path(cache_path)
         self.cache = self._load_cache()
 
@@ -150,14 +149,14 @@ class BuildCache:
         if not self.cache_path.exists():
             return {}
         try:
-            with open(self.cache_path, "r", encoding="utf-8") as f:
+            with self.cache_path.open() as f:
                 return json.load(f)
         except json.JSONDecodeError, OSError:
             return {}
 
-    def _save_cache(self):
+    def _save_cache(self) -> None:
         """Save the build cache to disk."""
-        with open(self.cache_path, "w", encoding="utf-8") as f:
+        with self.cache_path.open("w") as f:
             json.dump(self.cache, f, separators=(",", ":"))
 
     def needs_regeneration(self, key: str, current_hash: str) -> bool:
@@ -165,7 +164,7 @@ class BuildCache:
         cached_hash = self.cache.get(key)
         return True if cached_hash is None else cached_hash != current_hash
 
-    def update_cache(self, key: str, new_hash: str):
+    def update_cache(self, key: str, new_hash: str) -> None:
         """Update cache with new hash."""
         self.cache[key] = new_hash
         self._save_cache()
@@ -194,9 +193,39 @@ def _write_zstd_json(config, filename, value):
     return len(raw), len(compressed)
 
 
+def _should_skip_file(rel_path, ignore_dirs, seen_paths):
+    """Check if a file should be skipped based on hidden dirs, ignore dirs, or duplicates."""
+    rel_parts = rel_path.parts
+    if any(p.startswith(".") for p in rel_parts):
+        return True
+    if any(p in ignore_dirs for p in rel_parts):
+        return True
+    rel_str = str(rel_path)
+    return rel_str in seen_paths
+
+
+def _process_pattern(pattern, search_dir, ignore_dirs, seen_paths, source_files):
+    """Process a single glob pattern within a search directory."""
+    for match in glob.glob(str(search_dir / pattern), recursive=True):
+        file_path = Path(match)
+        if not file_path.is_file():
+            continue
+
+        try:
+            rel_path = file_path.relative_to(search_dir)
+        except ValueError:
+            continue
+
+        if _should_skip_file(rel_path, ignore_dirs, seen_paths):
+            continue
+
+        seen_paths.add(str(rel_path))
+        with contextlib.suppress(OSError, UnicodeDecodeError):
+            source_files[str(rel_path)] = file_path.read_text(encoding="utf-8")
+
+
 def collect_source_files(config):
     """Collect source code files for code reference feature using glob patterns."""
-    import glob as glob_module
 
     source_files = {}
     docs_path = Path(config["_docs_dir"])
@@ -299,50 +328,19 @@ def collect_source_files(config):
     for search_dir in search_dirs:
         if not search_dir.exists():
             continue
-        try:
+        with contextlib.suppress(OSError):
             for pattern in patterns:
-                # Use glob with the search directory as base
-                for match in glob_module.glob(
-                    str(search_dir / pattern), recursive=True
-                ):
-                    file_path = Path(match)
-                    if not file_path.is_file():
-                        continue
-
-                    # Get relative path from search_dir for key
-                    try:
-                        rel_path = file_path.relative_to(search_dir)
-                    except ValueError:
-                        continue
-
-                    rel_str = str(rel_path)
-
-                    # Skip hidden directories in the relative path
-                    rel_parts = rel_path.parts
-                    if any(p.startswith(".") for p in rel_parts):
-                        continue
-                    if any(p in ignore_dirs for p in rel_parts):
-                        continue
-
-                    # Deduplicate by relative path string
-                    if rel_str in seen_paths:
-                        continue
-                    seen_paths.add(rel_str)
-
-                    try:
-                        content = file_path.read_text(encoding="utf-8")
-                        source_files[rel_str] = content
-                    except OSError, UnicodeDecodeError:
-                        pass
-        except OSError:
-            pass
+                _process_pattern(
+                    pattern, search_dir, ignore_dirs, seen_paths, source_files
+                )
 
     return source_files
 
 
-def main(argv=None):
+def main(argv=None) -> None:
     if argv is not None and argv and argv[0] == "build":
         argv = argv[1:]
+
     elif argv is None and (
         Path(sys.argv[0]).name == "fr-docs"
         and len(sys.argv) > 1
@@ -375,7 +373,7 @@ def main(argv=None):
     config["production"] = bool(args.production)
 
     print(f"📖 Building {project_name(config)} docs...")
-    print(f"   Source: {src_dir(config)}")
+    print(f"   Source: {config_src_dir(config)}")
     print(f"   Output: {out_dir(config)}")
     print(f"   Mode: {'production' if args.production else 'development'}")
     if args.production:
@@ -395,7 +393,7 @@ def main(argv=None):
 
     # Copy static assets (minifying JS/CSS when production)
     docs_path = Path(config["_docs_dir"])
-    os.makedirs(Path(config["_out_dir"]), exist_ok=True)
+    Path(config["_out_dir"]).mkdir(parents=True, exist_ok=True)
     for legacy_name in (
         "file_index.json",
         "git_meta.json",
@@ -414,7 +412,7 @@ def main(argv=None):
             else:
                 shutil.copyfile(src, dst)
         except FileNotFoundError:
-            print(f"File not found: {os.getcwd()}, {src}->{dst}")
+            print(f"File not found: {Path.cwd()}, {src}->{dst}")
         except OSError as e:
             print(f"OSError: {e}")
 
@@ -433,13 +431,12 @@ def main(argv=None):
     slugs = get_all_slugs(config)
 
     # Also check for any .md files not in the sidebar
-    if os.path.isdir(config["_src_dir"]):
-        for dirpath, _dirnames, filenames in os.walk(config["_src_dir"]):
+    src_dir = Path(config["_src_dir"])
+    if src_dir.is_dir():
+        for dirpath, _dirnames, filenames in os.walk(src_dir):
             for fname in filenames:
                 if fname.endswith(".md"):
-                    rel = os.path.relpath(
-                        os.path.join(dirpath, fname), config["_src_dir"]
-                    )
+                    rel = os.path.relpath(Path(dirpath, fname), src_dir)
                     s = rel[:-3]
                     if s not in slugs:
                         slugs.append(s)
@@ -453,16 +450,13 @@ def main(argv=None):
     config["_search_index"] = search_index
 
     # Compress search index
-    search_json = json.dumps(search_index, separators=(",", ":"))
-    search_raw = search_json.encode("utf-8")
-    cctx = zstandard.ZstdCompressor(
+    search_raw = json.dumps(search_index, separators=(",", ":")).encode("utf-8")
+    compressed = zstandard.ZstdCompressor(
         level=_best_zstd_level(search_raw, zstd_level(config))
-    )
-    compressed = cctx.compress(search_raw)
-    search_index_path = os.path.join(config["_out_dir"], search_index_filename(config))
-    os.makedirs(os.path.dirname(search_index_path), exist_ok=True)
-    with open(search_index_path, "wb") as sf:
-        sf.write(compressed)
+    ).compress(search_raw)
+    search_index_path = Path(config["_out_dir"], search_index_filename(config))
+    search_index_path.parent.mkdir(parents=True, exist_ok=True)
+    search_index_path.write_bytes(compressed)
 
     if args.production:
         config["_search_index_inline"] = ""
@@ -471,7 +465,7 @@ def main(argv=None):
 
         config["_search_index_inline"] = (
             '<script id="zstd-data" type="text/plain">'
-            f"{base64.b64encode(compressed).decode('ascii')}"
+            f"  {base64.b64encode(compressed).decode('ascii')}"
             "</script>"
         )
 
@@ -523,10 +517,9 @@ def main(argv=None):
                 cache.update_cache(cache_key, content_hash)
             else:
                 # Load from per-file cache
-                with open(highlight_cache_file, "rb") as f:
-                    compressed = f.read()
+                compressed = highlight_cache_file.read_bytes()
                 decompressed = zstandard.ZstdDecompressor().decompress(compressed)
-                source_highlights[path] = json.loads(decompressed.decode("utf-8"))
+                source_highlights[path] = json.loads(decompressed.decode())
 
         # Write the highlights to zstd
         if source_highlights:
@@ -576,8 +569,8 @@ def main(argv=None):
     # Build pages
     slugs_to_build = []
     for slug in slugs:
-        src = os.path.join(config["_src_dir"], f"{slug}.md")
-        if os.path.exists(src):
+        src = Path(config["_src_dir"], f"{slug}.md")
+        if src.exists():
             slugs_to_build.append(slug)
 
     if slugs_to_build:
@@ -617,7 +610,7 @@ def main(argv=None):
         except Exception as e:  # noqa: BLE001
             print(f"   ✗ Minification failed: {e}")
 
-# Create a {site_prefix}/ directory under site/ and symlink every
+        # Create a {site_prefix}/ directory under site/ and symlink every
         # file into it, so a production build works locally (the HTML
         # references absolute paths like /fr-docs/style.css). Without
         # this, running `python -m fr_docs build --production` and then
@@ -636,7 +629,9 @@ def main(argv=None):
                 for f in sorted(Path(config["_out_dir"]).iterdir()):
                     if f.is_file() and not f.name.startswith("."):
                         (prefix_dir / f.name).symlink_to(f.resolve())
-                print(f"   ✓ Symlinked {len(list(prefix_dir.iterdir()))} files into {prefix}/")
+                print(
+                    f"   ✓ Symlinked {len(list(prefix_dir.iterdir()))} files into {prefix}/"
+                )
             except OSError as e:
                 print(f"   ✗ Failed to create {prefix}/ symlinks: {e}")
 

{fr_docs-2.3.0 → fr_docs-2.5.0}/fr_docs/config.py

@@ -1,6 +1,8 @@
 #!/usr/bin/env python3
 """Configuration loading for the fr-docs documentation builder."""
 
+from __future__ import annotations
+
 import json
 from pathlib import Path
 
@@ -58,7 +60,10 @@ def _merge(base, override):
 
 
 def load_config(config_path=None):
-    """Load and validate the documentation builder configuration."""
+    """Load and validate the documentation builder configuration.\n
+    :param config_path: Optional path to config file
+    :type config_path: str | Path | None
+    """
     if config_path is None:
         config_path = Path.cwd() / "config.json"
         if not config_path.exists():
@@ -71,17 +76,31 @@ def load_config(config_path=None):
     config = DEFAULT_CONFIG
     project_name_specified = False
     if config_path.exists():
-        with open(config_path, "r", encoding="utf-8") as f:
+        with open(config_path, encoding="utf-8") as f:
             loaded = json.load(f)
         config = _merge(DEFAULT_CONFIG, loaded)
         project_name_specified = "project_name" in loaded
 
     config_path = config_path.resolve()
-    docs_dir = (
-        Path(config["docs_dir"]).resolve() if config["docs_dir"] else config_path.parent
-    )
+    if docs_dir_raw := config["docs_dir"]:
+        docs_dir_path = Path(docs_dir_raw)
+        docs_dir = (
+            docs_dir_path
+            if docs_dir_path.is_absolute()
+            else (config_path.parent / docs_dir_path).resolve()
+        )
+
+    else:
+        docs_dir = config_path.parent
+
     src_dir = docs_dir / config["src_dir"] if config["src_dir"] else docs_dir / "src"
-    out_dir = docs_dir / config["out_dir"] if config["out_dir"] else docs_dir / "site"
+
+    out_dir_raw = (
+        config.get("build", {}).get("out_dir") or config.get("out_dir") or "site"
+    )
+    out_dir = (
+        Path(out_dir_raw) if Path(out_dir_raw).is_absolute() else docs_dir / out_dir_raw
+    )
 
     config["_project_name_specified"] = project_name_specified
     config["_config_path"] = str(config_path)