[Python-checkins] gh-98366: use sphinx.locale._ as gettext() in pyspecific.py (#98437)

Thu Nov 10 20:18:17 EST 2022

https://github.com/python/cpython/commit/d26ee8a0a552de111b8245ef0de63e3f3f535d9f
commit: d26ee8a0a552de111b8245ef0de63e3f3f535d9f
branch: main
author: Wei-Hsiang (Matt) Wang <mattwang44 at gmail.com>
committer: ezio-melotti <ezio.melotti at gmail.com>
date: 2022年11月11日T02:18:11+01:00
summary:
gh-98366: use sphinx.locale._ as gettext() in pyspecific.py (#98437)
fix(doc-tools): use sphinx.locale._ as gettext() for backward-compatibility in pyspecific.py
[why] spinix 5.3 changed locale.translators from a defaultdict(gettext.NullTranslations) to a dict, which leads to failure of pyspecific.py. Use sphinx.locale._ as gettext to fix the issue.
files:
M Doc/tools/extensions/pyspecific.py

diff --git a/Doc/tools/extensions/pyspecific.py b/Doc/tools/extensions/pyspecific.py
index 3b9f7442f75b..db7bb3b44219 100644
--- a/Doc/tools/extensions/pyspecific.py
+++ b/Doc/tools/extensions/pyspecific.py
@@ -26,7 +26,7 @@
 from sphinx.errors import NoUri
 except ImportError:
 from sphinx.environment import NoUri
-from sphinx.locale import translators
+from sphinx.locale import _ as sphinx_gettext
 from sphinx.util import status_iterator, logging
 from sphinx.util.nodes import split_explicit_title
 from sphinx.writers.text import TextWriter, TextTranslator
@@ -104,7 +104,7 @@ class ImplementationDetail(Directive):
 def run(self):
 self.assert_has_content()
 pnode = nodes.compound(classes=['impl-detail'])
- label = translators['sphinx'].gettext(self.label_text)
+ label = sphinx_gettext(self.label_text)
 content = self.content
 add_text = nodes.strong(label, label)
 self.state.nested_parse(content, self.content_offset, pnode)
@@ -252,7 +252,7 @@ def run(self):
 else:
 args = []
 
- label = translators['sphinx'].gettext(self._label[min(2, len(args))])
+ label = sphinx_gettext(self._label[min(2, len(args))])
 text = label.format(name="``{}``".format(name),
 args=", ".join("``{}``".format(a) for a in args if a))
 
@@ -431,7 +431,7 @@ def run(self):
 else:
 label = self._removed_label
 
- label = translators['sphinx'].gettext(label)
+ label = sphinx_gettext(label)
 text = label.format(deprecated=self.arguments[0], removed=self.arguments[1])
 if len(self.arguments) == 3:
 inodes, messages = self.state.inline_text(self.arguments[2],
