Method _module_and_class

Tools/clinic/libclinic/app.py:243–268

fields should be an iterable of field names. returns a tuple of (module, class). the module object could actually be self (a clinic object). this function is only ever used to find the parent of where a new class/module should go.

(
        self, fields: Sequence[str]
    )

        return printer.f.getvalue()

    def _module_and_class(
        self, fields: Sequence[str]
    ) -> tuple[Module | Clinic, Class | None]:
        """
        fields should be an iterable of field names.
        returns a tuple of (module, class).
        the module object could actually be self (a clinic object).
        this function is only ever used to find the parent of where
        a new class/module should go.
        """
        parent: Clinic | Module | Class = self
        module: Clinic | Module = self
        cls: Class | None = None

        for idx, field in enumerate(fields):
            fullname = ".".join(fields[:idx + 1])
            if not isinstance(parent, Class):
                if fullname in parent.modules:
                    parent = module = parent.modules[fullname]
                    continue
            if field in parent.classes:
                parent = cls = parent.classes[field]
            else:
                fail(f"Parent class or module {fullname!r} does not exist.")

        return module, cls

    def __repr__(self) -> str:
        return "<clinic.Clinic object>"