gdtest_config_exclude — Synthetic Package Details

#016 gdtest_config_exclude OK CONFIG

Config-level exclusion via great-docs.yml exclude list

All four exports are in __all__, but great-docs.yml excludes helper_func and InternalClass. On the Reference page you should see only PublicAPI and transform — the excluded items must be absent. The key test: config-level exclusion via the exclude list in great-docs.yml.

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

A1 B5 C4 D1 E6 F6 G1 H7

A1Flat layoutlayout

B5Config excludeexports

C4Mixed class+funcobjects

D1NumPydocstrings

E6No directivesdirectives

F6No user guideuser_guide

G1README.mdlanding

H7No extrasextras

Source Files

📁 gdtest_config_exclude/

📄 __init__.py

"""A test package with config-level exclusions."""

__version__ = "0.1.0"
__all__ = ["PublicAPI", "transform", "helper_func", "InternalClass"]


class PublicAPI:
    """
    The main public API class.

    Parameters
    ----------
    name
        API name.
    """

    def __init__(self, name: str):
        self.name = name

    def call(self) -> str:
        """
        Call the API.

        Returns
        -------
        str
            API response.
        """
        return f"response from {self.name}"


class InternalClass:
    """
    An internal class excluded via config.

    This should NOT appear in documentation.
    """

    def __init__(self):
        pass


def transform(data: str) -> str:
    """
    Transform data.

    Parameters
    ----------
    data
        Input data.

    Returns
    -------
    str
        Transformed data.
    """
    return data.upper()


def helper_func() -> None:
    """
    A helper function excluded via config.

    This should NOT appear in documentation.
    """
    pass

📄 README.md

# gdtest-config-exclude

A synthetic test package testing config-based exclusion.

📄 great-docs.yml

exclude:
  - helper_func
  - InternalClass