René's URL Explorer Experiment

{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"bug: `merge_init_into_class` renders inherited `__init__` source (leaks site-packages paths)","articleBody":"### Description of the bug\n\nWith `merge_init_into_class: true`, the `source` block in\n`templates/material/_base/class.html.jinja` unconditionally prefers\n`all_members[\"__init__\"]` over the class itself:\n\n```jinja\n{% if config.merge_init_into_class %}\n  {% if \"__init__\" in all_members and all_members[\"__init__\"].source %}\n```\n\n`all_members` includes inherited members, so when a class does not\ndefine `__init__` itself (e.g. any pydantic `BaseModel` subclass, with\n`preload_modules: [pydantic]` so griffe can resolve the base), the\nrendered source block is `pydantic.BaseModel.__init__` with a summary\nlike:\n\n> Source code in `.venv/lib/python3.10/site-packages/pydantic/main.py`\n\ninstead of the documented class's own file. Two problems:\n\n1. The environment-specific `.venv/...` path leaks into published docs.\n2. The source shown is the base class's `__init__`, which is not the\n   documented object's code at all.\n\nAdditionally, when the merged `__init__` has no source, the block\nrenders nothing rather than falling back to the class source.\n\n### To Reproduce\n\nVerified with mkdocs 1.6.1, mkdocstrings 1.0.4, mkdocstrings-python\n2.0.5, griffe 2.1.0, pydantic 2.13.4 on Python 3.10.\n\n```sh\nmkdir -p repro/src/pkg repro/docs && cd repro\npython -m venv .venv && . .venv/bin/activate\npip install mkdocs mkdocs-material \"mkdocstrings[python]\" pydantic\n```\n\n`src/pkg/__init__.py`:\n\n```python\nfrom pydantic import BaseModel\n\n\nclass Model(BaseModel):\n    \"\"\"A pydantic model without its own `__init__`.\"\"\"\n\n    x: int = 0\n```\n\n`docs/index.md`:\n\n```markdown\n::: pkg.Model\n```\n\n`mkdocs.yml`:\n\n```yaml\nsite_name: repro\ntheme:\n  name: material\nplugins:\n  - mkdocstrings:\n      handlers:\n        python:\n          paths: [src]\n          options:\n            merge_init_into_class: true\n            preload_modules: [pydantic]\n            show_source: true\n```\n\nBuild and inspect the rendered source block:\n\n```console\n$ mkdocs build\n$ grep -o \"Source code in \u003ccode>[^\u003c]*\u003c/code>\" site/index.html\nSource code in \u003ccode>.venv/lib/python3.10/site-packages/pydantic/main.py\u003c/code>\n```\n\nExpected: `src/pkg/__init__.py`.\n\nThe mechanism, shown at the griffe level (run from the same directory):\n\n```python\nimport sysconfig\n\nimport griffe\n\nloader = griffe.GriffeLoader(\n    search_paths=[\"src\", sysconfig.get_paths()[\"purelib\"]]\n)\nloader.load(\"pydantic\")\npkg = loader.load(\"pkg\")\nloader.resolve_aliases()\n\ncls = pkg[\"Model\"]\ninit = cls.all_members[\"__init__\"]\nprint(cls.relative_filepath)   # src/pkg/__init__.py\nprint(init.inherited)          # True\nprint(init.relative_filepath)  # .venv/lib/python3.10/site-packages/pydantic/main.py\n```\n\n### Expected behavior\n\nOnly use `__init__`'s source when the class defines it itself\n(griffe exposes `inherited` on the member); otherwise fall back to the\nclass's own source.\n\n### Environment information\n\n```bash\npython -m mkdocstrings_handlers.python._internal.debug  # | xclip -selection clipboard\n```\n\n- __System__: macOS-26.5.1-arm64-arm-64bit\n- __Python__: cpython 3.10.20 (\u003credacted>/.venv/bin/python3)\n- __Environment variables__:\n- __Installed packages__:\n  - `mkdocstrings-python` v2.0.5\n\n### Additional context\n\nI'm using a template override in\n`docs/templates/python/materialx/class.html.jinja`, wired\nup via the `custom_templates` option in `mkdocs.yaml`:\n\n```jinja\n{% extends \"_base/class.html.jinja\" %}\n\n{% block source %}\n  {% import \"language.html.jinja\" as lang with context %}\n  {% if config.show_source %}\n    {% if config.merge_init_into_class\n        and \"__init__\" in all_members\n        and not all_members[\"__init__\"].inherited\n        and all_members[\"__init__\"].source %}\n      {% with init = all_members[\"__init__\"] %}\n        \u003cdetails class=\"mkdocstrings-source\">\n          \u003csummary>{{ lang.t(\"Source code in\") }} \u003ccode>\n            {%- if init.relative_filepath.is_absolute() -%}\n              {{ init.relative_package_filepath }}\n            {%- else -%}\n              {{ init.relative_filepath }}\n            {%- endif -%}\n          \u003c/code>\u003c/summary>\n          {{ init.source|highlight(language=\"python\", linestart=init.lineno or 0, linenums=True) }}\n        \u003c/details>\n      {% endwith %}\n    {% elif class.source %}\n      \u003cdetails class=\"mkdocstrings-source\">\n        \u003csummary>{{ lang.t(\"Source code in\") }} \u003ccode>\n          {%- if class.relative_filepath.is_absolute() -%}\n            {{ class.relative_package_filepath }}\n          {%- else -%}\n            {{ class.relative_filepath }}\n          {%- endif -%}\n        \u003c/code>\u003c/summary>\n        {{ class.source|highlight(language=\"python\", linestart=class.lineno or 0, linenums=True) }}\n      \u003c/details>\n    {% endif %}\n  {% endif %}\n{% endblock source %}\n```","author":{"url":"https://github.com/cdwilson","@type":"Person","name":"cdwilson"},"datePublished":"2026-07-09T15:37:45Z","url":"https://github.com/mkdocstrings/python/issues/333"}