René's URL Explorer Experiment

{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"`pospell` fails with code entries","articleBody":"For 3.13, there was a change in the documentation that now snippets were marked as translatable.\r\nThis means that there is a large number of \"new entries\" that are snippets from the documentation page.\r\n\r\nEven though I believe this is a great thing, the tooling around might need to be adapted.\r\nRecently I discovered that in some cases, `pospell` fails to parse and handle such entries.\r\n\r\nFor example:\r\n\r\n```\r\n#: ../Doc/library/typing.rst:3167\r\nmsgid \"\"\r\n\"@type_check_only\\n\"\r\n\"class Response:  # private or not available at runtime\\n\"\r\n\"    code: int\\n\"\r\n\"    def get_header(self, name: str) -\u003e str: ...\\n\"\r\n\"\\n\"\r\n\"def fetch_response() -\u003e Response: ...\"\r\nmsgstr \"\"\r\n\"@type_check_only\\n\"\r\n\"class Response:  # privada o no disponible en runtime\\n\"\r\n\"    code: int\\n\"\r\n\"    def get_header(self, name: str) -\u003e str: ...\\n\"\r\n\"\\n\"\r\n\"def fetch_response() -\u003e Response: ...\"\r\n```\r\n\r\nProduces a \r\n```\r\n\u003crst-doc\u003e:3: (ERROR/3) Unexpected indentation. while parsing: @type_check_only\r\nclass Response:  # privada o no disponible en runtime\r\n    code: int\r\n    def get_header(self, name: str) -\u003e str: ...\r\n\r\ndef fetch_response() -\u003e Response: ...\r\n```\r\n\r\nMarking those entries as fuzzy or adding three back-ticks \"```\" doesn't work, so I'm trying to brainstorm a bit how we could solve this.\r\nA couple of ideas would be to:\r\n\r\n1. Just try to fix at the docutils level (which is the source of the parsing error)\r\n2. Introduce a new identifier like `python-format` in order to take the content for granted and avoid parsing it.\r\n\r\nIdeas?\r\n\r\nCC: @JulienPalard ","author":{"url":"https://github.com/cmaureir","@type":"Person","name":"cmaureir"},"datePublished":"2024-11-24T14:01:36.000Z","interactionStatistic":{"@type":"InteractionCounter","interactionType":"https://schema.org/CommentAction","userInteractionCount":2},"url":"https://github.com/3324/python-docs-es/issues/3324"}