← GDG /

#298 gdtest_ref_inherited_explicit

#298 gdtest_ref_inherited_explicit FAILED (build_failed) CONFIG
Reference config listing inherited methods explicitly.
Reference config listing inherited methods (validate, reset) explicitly in the members list of AdvancedProcessor. The child class page should document all three listed methods even though two are inherited.
Build Log ๐Ÿงช Test Coverage

Error Output

Error: great-docs requires Quarto 1.9.18 or later, but found Quarto 1.8.26. Upgrade Quarto from https://quarto.org/docs/get-started/

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

P9
P9Explicit inherited membersreference

Source Files

๐Ÿ“ gdtest_ref_inherited_explicit/
๐Ÿ“„ __init__.py
"""Package testing explicit inherited member documentation."""

__version__ = "0.1.0"
__all__ = ["BaseProcessor", "AdvancedProcessor"]


class BaseProcessor:
    """
    Base processor with core functionality.

    Parameters
    ----------
    name : str
        Processor name.
    """

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

    def validate(self, data: dict) -> bool:
        """
        Validate input data.

        Parameters
        ----------
        data : dict
            Data to validate.

        Returns
        -------
        bool
            True if valid.
        """
        return bool(data)

    def reset(self) -> None:
        """
        Reset the processor state.

        Returns
        -------
        None
        """
        pass


class AdvancedProcessor(BaseProcessor):
    """
    Advanced processor that inherits validate and reset from Base.

    Parameters
    ----------
    name : str
        Processor name.
    mode : str
        Processing mode.
    """

    def __init__(self, name: str, mode: str = "fast"):
        super().__init__(name)
        self.mode = mode

    def process(self, data: dict) -> dict:
        """
        Process data using the configured mode.

        Parameters
        ----------
        data : dict
            Data to process.

        Returns
        -------
        dict
            Processed results.
        """
        if self.validate(data):
            return {"result": data, "mode": self.mode}
        return {}
๐Ÿ“„ README.md
# gdtest-ref-inherited-explicit

Tests explicit inherited member documentation via reference config.
๐Ÿ“„ great-docs.yml
reference:
  - title: Core
    desc: Core classes
    contents:
      - BaseProcessor
      - name: AdvancedProcessor
        members:
          - process
          - validate
          - reset