Function makeprop

tools/generate_proxy_methods.py:295–361

(buf: TextIO, name: str)

        buf.write(textwrap.indent(code, "    "))

    def makeprop(buf: TextIO, name: str) -> None:
        attr = target_cls.__dict__.get(name, None)

        return_type = target_cls.__annotations__.get(name, "Any")
        assert isinstance(return_type, str), (
            "expected string annotations, is from __future__ "
            "import annotations set up?"
        )

        existing_doc = None

        if attr is not None:
            if isinstance(attr, property):
                readonly = attr.fset is None
                existing_doc = attr.__doc__
            elif isinstance(attr, langhelpers.generic_fn_descriptor):
                readonly = True
                existing_doc = attr.__doc__
            elif hasattr(attr, "__get__"):
                readonly = not hasattr(attr, "__set__")
                existing_doc = attr.__doc__
            else:
                # not a descriptor
                readonly = False

        else:
            readonly = False

        if existing_doc:
            doc = textwrap.indent(
                inject_docstring_text(
                    attr.__doc__,
                    textwrap.indent(
                        ".. container:: class_bases\n\n"
                        f"    Proxied for the {target_cls_sphinx_name} "
                        "class \n"
                        f"    on behalf of the {proxy_cls_sphinx_name} "
                        "class.",
                        "    ",
                    ),
                    1,
                ),
                "    ",
            ).lstrip()
        else:
            doc = (
                f"Proxy for the :attr:`{sphinx_symbol}.{name}` "
                "attribute \n"
                f"        on behalf of the {proxy_cls_sphinx_name} "
                "class.\n"
            )

        code = (
            "@property\n"
            "def %(name)s(self) -> %(return_type)s:\n"
            '    r"""%(doc)s\n    """  # noqa: E501\n\n'
            "    return self._proxied.%(name)s\n\n"
        ) % {"name": name, "doc": doc, "return_type": return_type}