René's URL Explorer Experiment

{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"bug: `filters: []` not usable when `group_by_category` is set to `false`","articleBody":"### To Reproduce\nHere is a simple module with a public and a protected function.\n```\ndef test():\n    \"\"\"test.\"\"\"\n    pass\n\ndef _test():\n    \"\"\"_test.\"\"\"\n    pass\n```\n\nOther options can be set to default values as follows.\n```yaml\nplugins:\n  - mkdocstrings:\n      default_handler: python\n      handlers:\n        python:\n          options:\n            group_by_category: false\n            filters: []\n```\n\nThen, the `_test()` method is not appeared in the generated document.\n\n### Full traceback\n\u003cdetails>\u003csummary>Full traceback\u003c/summary>\n\n```python\nDEBUG   -  mkdocstrings_handlers: python\\templates\\material\\function.html.jinja: Rendering mod.test.test\nDEBUG   -  mkdocstrings_handlers: python\\templates\\material\\signature.html.jinja: Rendering signature\nDEBUG   -  mkdocstrings_handlers: python\\templates\\material\\docstring.html.jinja: Rendering docstring\n\n# the following lines won't appear if `group_by_category` is set to `false`\nDEBUG   -  mkdocstrings_handlers: python\\templates\\material\\function.html.jinja: Rendering mod.test._test\nDEBUG   -  mkdocstrings_handlers: python\\templates\\material\\signature.html.jinja: Rendering signature\nDEBUG   -  mkdocstrings_handlers: python\\templates\\material\\docstring.html.jinja: Rendering docstring\n```\n\n\u003c/details>\n\n### Expected behavior\n\u003c!-- Please provide a clear and concise description of what you expected to happen. -->\n\n### Environment information\n- __System__: Windows 10\n- __Python__: cpython 3.10.11\n- __Environment variables__:\n- __Installed packages__:\n  - `mkdocstrings-python` v2.0.0\n\n### Additional context\nI have tried to pinpoint the issue in `children.html.jinja`, and find the following lines:\n```python\n{% if config.group_by_category %}\n... irrelevant codes here ...\n    {% else %}\n\n      {% for child in obj.all_members\n          |filter_objects(\n            filters=config.filters,\n            members_list=members_list,\n            inherited_members=config.inherited_members,\n            keep_no_docstrings=config.show_if_no_docstring,\n            )\n          |order_members(config.members_order, members_list)\n        %}\n\n        {% if not (obj.is_class and child.name == \"__init__\" and config.merge_init_into_class) %}\n\n          {% if config.filters == \"public\" or members_list is not none or child.is_public %}\n          ... rendering codes here ...\n          {% endif %}\n\n        {% endif %}\n\n      {% endfor %}\n\n    {% endif %}\n```\n\nI validate the filtering part, and the results are correct, so the problem may be inside the rendering part. Comparing with the similar codes in the `if`-branch, there is a significant difference in the code:\n```python\n{% if config.filters == \"public\" or members_list is not none or (not child.is_imported or child.is_public) %}\n```\n\nAfter adding these lines, the problem will be resolved on my device.","author":{"url":"https://github.com/T0nyX1ang","@type":"Person","name":"T0nyX1ang"},"datePublished":"2025-12-03T09:56:23Z","url":"https://github.com/mkdocstrings/python/issues/324"}