[mkdocs.yml,docs] Prepare to generate doc site ; [cdd/shared/defaults_utils.py] Fix default handling for doc site ; [cdd/tests/test_compound/test_doctrans_utils.py] Test new default handling ; [*.py] Run with latest black

Author: SamuelMarks

.gitignore

@@ -151,3 +151,4 @@ dmypy.json
 
 # Docs
 _docs
+reports

LICENSE-APACHE

@@ -187,7 +187,7 @@
       same "printed page" as the copyright notice for easier
       identification within third-party archives.
 
-   Copyright 2020–2023 Samuel Marks (for Offscale.io)
+   Copyright 2020–2025 Samuel Marks (for Offscale.io)
 
    Licensed under the Apache License, Version 2.0 (the "License");
    you may not use this file except in compliance with the License.

LICENSE-MIT

@@ -1,4 +1,4 @@
-Copyright 2020–2023 Samuel Marks (for Offscale.io)
+Copyright 2020–2025 Samuel Marks (for Offscale.io)
 
 Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
 

cdd/compound/exmod_utils.py

@@ -1,4 +1,4 @@
-""" Exmod utils """
+"""Exmod utils"""
 
 import sys
 from ast import AST, Assign, Expr, ImportFrom, List, Load, Module, Name, Store, alias

cdd/shared/defaults_utils.py

@@ -175,6 +175,24 @@ def extract_default(
 
     default = default.strip(" \t`")
 
+    if default.count('"') & 1:
+        default = default.strip('"')
+    if default.count("'") & 1:
+        default = default.strip("'")
+
+    # Correct for parsing errors where a quote is captured at the start or end, but not both
+    if len(default) > 0:
+        if default.count('"') == 1 and default.count("'") == 0:
+            if default.startswith('"'):
+                default = default + '"'
+            elif default.endswith('"'):
+                default = '"' + default
+        elif default.count("'") == 1 and default.count('"') == 0:
+            if default.startswith("'"):
+                default = default + "'"
+            elif default.endswith("'"):
+                default = "'" + default
+
     return _parse_out_default_and_doc(
         _start_idx,
         start_rest_offset,
@@ -228,28 +246,35 @@ def _parse_out_default_and_doc(
     :rtype: Tuple[str, Optional[str]]
     """
     if typ is not None and typ in simple_types and default not in none_types:
-        lit = (
-            ast.AST()
-            if typ != "str"
-            and any(
-                map(
-                    partial(contains, frozenset(("*", "^", "&", "|", "$", "@", "!"))),
-                    default,
+        if typ == "str":
+            from cdd.shared.pure_utils import unquote
+
+            default = unquote(default)
+        else:
+            lit = (
+                ast.AST()
+                if any(
+                    map(
+                        partial(
+                            contains, frozenset(("*", "^", "&", "|", "$", "@", "!"))
+                        ),
+                        default,
+                    )
                 )
+                else literal_eval("({default})".format(default=default))
+            )
+            default = (
+                "```{default}```".format(default=default)
+                if isinstance(lit, ast.AST)
+                else {
+                    "bool": bool,
+                    "int": int,
+                    "float": float,
+                    "complex": complex,
+                }[
+                    typ
+                ](lit)
             )
-            else literal_eval("({default})".format(default=default))
-        )
-        default = (
-            "```{default}```".format(default=default)
-            if isinstance(lit, ast.AST)
-            else {
-                "bool": bool,
-                "int": int,
-                "float": float,
-                "complex": complex,
-                "str": str,
-            }[typ](lit)
-        )
     elif default.isdecimal():
         default = int(default)
     elif default in frozenset(("True", "False")):
@@ -261,8 +286,15 @@ def _parse_out_default_and_doc(
         return line, default
     else:
         stop_tokens = frozenset((" ", "\t", "\n", "\n", "."))
-        end = line[: _start_idx - 1]
-        extra_offset = int(end[-1] in frozenset((" ", "\t", "\n", "\n")) if end else 0)
+        if _start_idx == 0:
+            fst = ""
+            extra_offset = 0
+        else:
+            end = line[: _start_idx - 1]
+            extra_offset = int(
+                end[-1] in frozenset((" ", "\t", "\n", "\n")) if end else 0
+            )
+            fst = line[: _start_idx - 1 - extra_offset]
 
         if rstrip_default:
             offset: int = count_iter_items(
@@ -273,7 +305,6 @@ def _parse_out_default_and_doc(
             )
             start_rest_offset += offset
 
-        fst = line[: _start_idx - 1 - extra_offset]
         rest = line[
             start_rest_offset : (
                 (-extra_offset if extra_offset > 0 else None)

cdd/tests/mocks/eval.py

@@ -1,4 +1,4 @@
-""" eval.py for testing with `sync_properties` """
+"""eval.py for testing with `sync_properties`"""
 
 import sys
 

cdd/tests/mocks/exmod.py

@@ -1,4 +1,4 @@
-""" Exmod mocks """
+"""Exmod mocks"""
 
 from ast import Assign, ImportFrom, List, Load, Module, Name, Store, alias
 from itertools import chain

cdd/tests/test_cli/test_cli.py

@@ -1,4 +1,4 @@
-""" Tests for CLI (__main__.py) """
+"""Tests for CLI (__main__.py)"""
 
 import os
 from argparse import ArgumentParser

cdd/tests/test_cli/test_cli_doctrans.py

@@ -1,4 +1,4 @@
-""" Tests for CLI doctrans subparser (__main__.py) """
+"""Tests for CLI doctrans subparser (__main__.py)"""
 
 from os import path
 from tempfile import TemporaryDirectory

cdd/tests/test_cli/test_cli_exmod.py

@@ -1,4 +1,4 @@
-""" Tests for CLI exmod subparser (__main__.py) """
+"""Tests for CLI exmod subparser (__main__.py)"""
 
 from unittest import TestCase
 from unittest.mock import MagicMock, patch