← GDG /

#131 gdtest_rst_danger

#131 gdtest_rst_danger OK CONFIG
Tests danger RST directives in docstrings
Docstrings contain '.. danger::' directives. The built-in handler should produce Quarto important callouts. Two functions have hazard warnings.
View Site → Build Log ๐Ÿงช Test Coverage

Build Mode

● Has great-docs.yml

This package ships a pre-supplied config. The great-docs init step is skipped and great-docs build uses the spec-defined configuration directly. Tests specific config options and their rendered output.

Dimensions

L7
L7.. danger::docstring

Source Files

๐Ÿ“ gdtest_rst_danger/
๐Ÿ“„ __init__.py
"""Package testing danger RST directives."""

__version__ = "0.1.0"
__all__ = ["drop_database", "purge_cache"]


def drop_database(name: str) -> None:
    """
    Drop an entire database by name.

    Parameters
    ----------
    name
        The name of the database to drop.

    Returns
    -------
    None

    .. danger::
        This permanently destroys the database.
    """
    pass


def purge_cache() -> int:
    """
    Purge all entries from the cache.

    Returns
    -------
    int
        The number of cache entries purged.

    .. danger::
        Cannot be reversed. All cached data is lost.
    """
    return 0
๐Ÿ“„ README.md
# gdtest-rst-danger

Tests danger RST directives in docstrings.
๐Ÿ“„ great-docs.yml
parser: sphinx