docstring-format-checker 1.0.0__tar.gz → 1.1.0__tar.gz

{docstring_format_checker-1.0.0 → docstring_format_checker-1.1.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: docstring-format-checker
-Version: 1.0.0
+Version: 1.1.0
 Summary: A CLI tool to check and validate Python docstring formatting and completeness
 Author: Chris Mahoney
 Author-email: Chris Mahoney <docstring-format-checker@data-science-extensions.com>
@@ -23,11 +23,12 @@ Requires-Dist: typer>=0.9.0
 Requires-Dist: tomli>=2.0.0 ; python_full_version < '3.11'
 Requires-Dist: rich>=13.0.0
 Requires-Dist: toolbox-python==1.*
+Requires-Dist: pyfiglet==1.*
 Maintainer: Chris Mahoney
 Maintainer-email: Chris Mahoney <docstring-format-checker@data-science-extensions.com>
 Requires-Python: >=3.9
 Project-URL: Changelog, https://github.com/data-science-extensions/docstring-format-checker/releases
-Project-URL: Documentation, https://github.com/data-science-extensions/docstring-format-checker/blob/main/README.md
+Project-URL: Documentation, https://data-science-extensions.com/toolboxes/docstring-format-checker/latest/code/
 Project-URL: Homepage, https://github.com/data-science-extensions/docstring-format-checker
 Project-URL: Issues, https://github.com/data-science-extensions/docstring-format-checker/issues
 Project-URL: Repository, https://github.com/data-science-extensions/docstring-format-checker

{docstring_format_checker-1.0.0 → docstring_format_checker-1.1.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "docstring-format-checker"
-version = "v1.0.0"
+version = "1.1.0"
 description = "A CLI tool to check and validate Python docstring formatting and completeness"
 readme = "README.md"
 license = "MIT"
@@ -32,11 +32,12 @@ dependencies = [
     "tomli>=2.0.0;python_version<'3.11'",
     "rich>=13.0.0",
     "toolbox-python==1.*",
+    "pyfiglet==1.*",
 ]
 
 [project.urls]
 Homepage = "https://github.com/data-science-extensions/docstring-format-checker"
-Documentation = "https://github.com/data-science-extensions/docstring-format-checker/blob/main/README.md"
+Documentation = "https://data-science-extensions.com/toolboxes/docstring-format-checker/latest/code/"
 Repository = "https://github.com/data-science-extensions/docstring-format-checker"
 Changelog = "https://github.com/data-science-extensions/docstring-format-checker/releases"
 Issues = "https://github.com/data-science-extensions/docstring-format-checker/issues"
@@ -66,7 +67,7 @@ docs = [
     "mike==2.*",
     "mkdocs==1.*",
     "mkdocs-autorefs==1.*",
-    "mkdocs-coverage==1.*",
+    "mkdocs-coverage==2.*",
     "mkdocs-material==9.*",
     "mkdocstrings==0.*",
     "mkdocstrings-python==1.*",
@@ -77,7 +78,7 @@ test = [
     "parameterized==0.*",
     "pytest==8.*",
     "pytest-clarity==1.*",
-    "pytest-cov==6.*",
+    "pytest-cov==7.*",
     "pytest-icdiff==0.*",
     "pytest-sugar==1.*",
     "pytest-xdist==3.*",
@@ -169,5 +170,5 @@ sections = [
 ]
 
 [build-system]
-requires = ["uv_build>=0.7.19,<0.8.0"]
+requires = ["uv_build>=0.8.17,<0.9.0"]
 build-backend = "uv_build"

{docstring_format_checker-1.0.0 → docstring_format_checker-1.1.0}/src/docstring_format_checker/__init__.py

@@ -4,16 +4,20 @@ Docstring Format Checker.
 A CLI tool to check and validate Python docstring formatting and completeness.
 """
 
-__version__ = "v1.0.0"
-__author__ = "Chris Mahoney"
-__email__ = "docstring-format-checker@data-science-extensions.com"
-
+# ## Python StdLib Imports ----
+from importlib.metadata import metadata
 
 # ## Local First Party Imports ----
 from docstring_format_checker.config import DEFAULT_CONFIG, load_config
 from docstring_format_checker.core import DocstringChecker, SectionConfig
 
 
+_metadata = metadata("docstring-format-checker")
+__name__: str = _metadata["Name"]
+__version__: str = _metadata["Version"]
+__author__: str = _metadata["Author"]
+__email__: str = _metadata.get("Email", "")
+
 __all__: list[str] = [
     "DocstringChecker",
     "SectionConfig",

{docstring_format_checker-1.0.0 → docstring_format_checker-1.1.0}/src/docstring_format_checker/cli.py

@@ -43,12 +43,14 @@
 
 
 # ## Python StdLib Imports ----
+import os
 from functools import partial
 from pathlib import Path
 from textwrap import dedent
 from typing import Optional
 
 # ## Python Third Party Imports ----
+import pyfiglet
 from rich.console import Console
 from rich.panel import Panel
 from rich.table import Table
@@ -160,29 +162,6 @@ def _version_callback(ctx: Context, param: CallbackParam, value: bool) -> None:
         raise Exit()
 
 
-def _help_callback_main(ctx: Context, param: CallbackParam, value: bool) -> None:
-    """
-    !!! note "Summary"
-        Show help and exit.
-
-    Params:
-        ctx (Context):
-            The context object.
-        param (CallbackParam):
-            The parameter object.
-        value (bool):
-            The boolean value indicating if the flag was set.
-
-    Returns:
-        (None):
-            Nothing is returned.
-    """
-    if not value or ctx.resilient_parsing:
-        return
-    echo(ctx.get_help())
-    raise Exit()
-
-
 def _example_callback(ctx: Context, param: CallbackParam, value: Optional[str]) -> None:
     """
     !!! note "Summary"
@@ -211,6 +190,7 @@ def _example_callback(ctx: Context, param: CallbackParam, value: Optional[str])
     else:
         console.print(_red(f"Error: Invalid example type '{value}'. Use 'config' or 'usage'."))
         raise Exit(1)
+    raise Exit()
 
 
 def _show_usage_examples_callback() -> None:
@@ -233,30 +213,31 @@ def _show_usage_examples_callback() -> None:
 
     examples_content: str = dedent(
         f"""
-        {_green("dfc myfile.py")}                   Check a single Python file (list output)
-        {_green("dfc src/")}                        Check all Python files in src/ directory
-        {_green("dfc --output=table myfile.py")}    Check with table output format
-        {_green("dfc -o list myfile.py")}           Check with list output format (default)
-        {_green("dfc --check myfile.py")}           Check and exit with error if issues found
-        {_green("dfc --quiet myfile.py")}           Check quietly, only show pass/fail
-        {_green("dfc --quiet --check myfile.py")}   Check quietly and exit with error if issues found
-        {_green("dfc . --exclude '*/tests/*'")}     Check current directory, excluding tests
-        {_green("dfc . -c custom.toml")}            Use custom configuration file
-        {_green("dfc --example=config")}            Show example configuration
-        {_green("dfc -e usage")}                    Show usage examples (this help)
+        Execute the below commands in any terminal after installing the package.
+
+        {_blue("dfc myfile.py")}                   {_green("# Check a single Python file (list output)")}
+        {_blue("dfc src/")}                        {_green("# Check all Python files in src/ directory")}
+        {_blue("dfc --output=table myfile.py")}    {_green("# Check with table output format")}
+        {_blue("dfc -o list myfile.py")}           {_green("# Check with list output format (default)")}
+        {_blue("dfc --check myfile.py")}           {_green("# Check and exit with error if issues found")}
+        {_blue("dfc --quiet myfile.py")}           {_green("# Check quietly, only show pass/fail")}
+        {_blue("dfc --quiet --check myfile.py")}   {_green("# Check quietly and exit with error if issues found")}
+        {_blue("dfc . --exclude '*/tests/*'")}     {_green("# Check current directory, excluding tests")}
+        {_blue("dfc . -c custom.toml")}            {_green("# Use custom configuration file")}
+        {_blue("dfc --example=config")}            {_green("# Show example configuration")}
+        {_blue("dfc -e usage")}                    {_green("# Show usage examples (this help)")}
         """
     ).strip()
 
     panel = Panel(
         examples_content,
-        title="Examples",
+        title="Usage Examples",
         title_align="left",
         border_style="dim",
         padding=(0, 1),
     )
 
     console.print(panel)
-    raise Exit()
 
 
 def _show_config_example_callback() -> None:
@@ -278,73 +259,84 @@ def _show_config_example_callback() -> None:
     """
 
     example_config: str = dedent(
-        """
-        # Example configuration for docstring-format-checker
-        # Place this in your pyproject.toml file
-
-        [tool.dfc]
-        # or [tool.docstring-format-checker]
-
-        [[tool.dfc.sections]]
-        order = 1
-        name = "summary"
-        type = "free_text"
-        admonition = "note"
-        prefix = "!!!"
-        required = true
-
-        [[tool.dfc.sections]]
-        order = 2
-        name = "details"
-        type = "free_text"
-        admonition = "info"
-        prefix = "???+"
-        required = false
-
-        [[tool.dfc.sections]]
-        order = 3
-        name = "params"
-        type = "list_name_and_type"
-        required = true
-
-        [[tool.dfc.sections]]
-        order = 4
-        name = "returns"
-        type = "list_name_and_type"
-        required = false
-
-        [[tool.dfc.sections]]
-        order = 5
-        name = "yields"
-        type = "list_type"
-        required = false
-
-        [[tool.dfc.sections]]
-        order = 6
-        name = "raises"
-        type = "list_type"
-        required = false
-
-        [[tool.dfc.sections]]
-        order = 7
-        name = "examples"
-        type = "free_text"
-        admonition = "example"
-        prefix = "???+"
-        required = false
-
-        [[tool.dfc.sections]]
-        order = 8
-        name = "notes"
-        type = "free_text"
-        admonition = "note"
-        prefix = "???"
-        required = false
+        r"""
+        Place the below config in your `pyproject.toml` file.
+
+        [blue]\[tool.dfc][/blue]
+        [green]# or \[tool.docstring-format-checker][/green]
+        [blue]allow_undefined_sections = false[/blue]
+        [blue]require_docstrings = true[/blue]
+        [blue]check_private = true[/blue]
+        [blue]sections = [[/blue]
+            [blue]{ order = 1, name = "summary",  type = "free_text",          required = true, admonition = "note", prefix = "!!!" },[/blue]
+            [blue]{ order = 2, name = "details",  type = "free_text",          required = false, admonition = "abstract", prefix = "???+" },[/blue]
+            [blue]{ order = 3, name = "params",   type = "list_name_and_type", required = false },[/blue]
+            [blue]{ order = 4, name = "raises",   type = "list_type",          required = false },[/blue]
+            [blue]{ order = 5, name = "returns",  type = "list_name_and_type", required = false },[/blue]
+            [blue]{ order = 6, name = "yields",   type = "list_type",          required = false },[/blue]
+            [blue]{ order = 7, name = "examples", type = "free_text",          required = false, admonition = "example", prefix = "???+" },[/blue]
+            [blue]{ order = 8, name = "notes",    type = "free_text",          required = false, admonition = "note", prefix = "???" },[/blue]
+        [blue]][/blue]
         """
     ).strip()
 
+    panel = Panel(
+        example_config,
+        title="Configuration Example",
+        title_align="left",
+        border_style="dim",
+        padding=(0, 1),
+    )
+
     # Print without Rich markup processing to avoid bracket interpretation
-    console.print(example_config, markup=False)
+    console.print(panel)
+
+
+def _help_callback_main(ctx: Context, param: CallbackParam, value: bool) -> None:
+    """
+    !!! note "Summary"
+        Show help and exit.
+
+    Params:
+        ctx (Context):
+            The context object.
+        param (CallbackParam):
+            The parameter object.
+        value (bool):
+            The boolean value indicating if the flag was set.
+
+    Returns:
+        (None):
+            Nothing is returned.
+    """
+
+    # Early exit if help flag is set
+    if not value or ctx.resilient_parsing:
+        return
+
+    # Determine terminal width for ASCII art
+    try:
+        terminal_width: int = os.get_terminal_size().columns
+    except OSError:
+        terminal_width = 80
+
+    # Determine title based on terminal width
+    title: str = "dfc" if terminal_width < 130 else "docstring-format-checker"
+
+    # Print ASCII art title
+    console.print(
+        pyfiglet.figlet_format(title, font="standard", justify="left", width=140),
+        style="magenta",
+        markup=False,
+    )
+
+    # Show help message
+    echo(ctx.get_help())
+
+    # Show usage and config examples
+    _show_usage_examples_callback()
+    _show_config_example_callback()
+
     raise Exit()
 
 
@@ -704,7 +696,3 @@ def entry_point() -> None:
         Entry point for the CLI scripts defined in pyproject.toml.
     """
     app()
-
-
-if __name__ == "__main__":
-    app()