Skip to content

wake.printers.api module #

Printer class #

Bases: Visitor

Base class for printers.

Attributes:

Name Type Description
paths List[Path]

Paths the printer should operate on. May be empty if a user did not specify any paths, e.g. when running wake print printer-name. In this case, the printer should operate on all paths. May be ignored unless visit_mode is all.
extra Dict[Any, Any]

Extra data set by the execution engine.
Source code in wake/printers/api.py 
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
class Printer(Visitor, metaclass=ABCMeta):
    """
    Base class for printers.

    Attributes:
        paths: Paths the printer should operate on. May be empty if a user did not specify any paths, e.g. when running `wake print printer-name`.
            In this case, the printer should operate on all paths. May be ignored unless [visit_mode][wake.printers.api.Printer.visit_mode] is `all`.
        extra: Extra data set by the execution engine.
    """

    console: Console
    paths: List[Path]
    extra: Dict[Any, Any]
    lsp_provider: Optional[LspProvider]
    execution_mode: Literal["cli", "lsp", "both"] = "cli"  # TODO remove both?

    @property
    def visit_mode(self) -> Literal["paths", "all"]:
        """
        Configurable visit mode of the printer. If set to `paths`, the printer `visit_` methods will be called only for the paths specified by the user.
        If set to `all`, the printer `visit_` methods will be called for all paths. In this case, the printer should use the `paths` attribute to decide what to print.

        Returns:
            Visit mode of the printer.
        """
        return "paths"

    @abstractmethod
    def print(self) -> None:
        """
        Abstract method that must be implemented in every printer. This method is called after all `visit_` methods have been called.
        """
        ...

visit_mode: Literal['paths', 'all'] property #

Configurable visit mode of the printer. If set to paths, the printer visit_ methods will be called only for the paths specified by the user. If set to all, the printer visit_ methods will be called for all paths. In this case, the printer should use the paths attribute to decide what to print.

Returns:

Type Description
Literal['paths', 'all']

Visit mode of the printer.

print() abstractmethod #

Abstract method that must be implemented in every printer. This method is called after all visit_ methods have been called.

Source code in wake/printers/api.py 
69
70
71
72
73
74
@abstractmethod
def print(self) -> None:
    """
    Abstract method that must be implemented in every printer. This method is called after all `visit_` methods have been called.
    """
    ...