[Docutils-develop] [docutils:bugs] #495 locale.Error: unsupported locale setting

[Günter M. <mi...@us...>]

- **status**: open --> pending-remind
- **Comment**:

Thank you for the report.

The error for the `locale`  shell command: "locale: Cannot set LC_ALL to default locale: No such file or directory" shows that on your system , the locale setup for LC_ALL is missing something or invalid. It may be related to the rather uncommon locale for Silesian Polish.

OTOH, all Docutils command line tools set up the user's default locale in the way recommended in the documentation of the "locale" standard module https://docs.python.org/3/library/locale.html#locale.setlocale. The locale value is, e.g. used for formatting with certain values in the ["date" substitution directive](https://docutils.sourceforge.io/docs/ref/rst/directives.html#date).

A small web search shows, that "unsupported locale setting" is a quite common problem for Python apps (e.g. https://stackoverflow.com/questions/14547631/python-locale-error-unsupported-locale-setting). 

The best fix would be to get a stable and complet "locale" support on your system (silencing the errors from the `locale` command).
As a workaround, you may experiment with `export LC_ALL=C` or `export LC_ALL=pl_PL.UTF-8` before calling the Docutils command line tools.

OTOH, as locale settings are no core part of Docutils processing, it may be an ideo to catch the `locale.Error` report it as a warning and proceed with the Python default.




---

**[bugs:#495] locale.Error: unsupported locale setting**

**Status:** pending-remind
**Created:** Tue Oct 08, 2024 11:34 AM UTC by Artur Stępniak
**Last Updated:** Tue Oct 08, 2024 11:34 AM UTC
**Owner:** nobody


I'm getting "locale.Error: unsupported locale setting" when running e.g. rst2man docs/man/openvpn3-log.1.rst  | groff -Tutf8 -man

Full output:
~~~
Traceback (most recent call last):
  File "/usr/bin/rst2man", line 8, in <module>
    sys.exit(rst2man())
             ^^^^^^^^^
  File "/usr/lib/python3.12/site-packages/docutils/core.py", line 760, in rst2man
    rst2something('manpage', 'Unix manual (troff)', 'user/manpage.html')
  File "/usr/lib/python3.12/site-packages/docutils/core.py", line 739, in rst2something
    locale.setlocale(locale.LC_ALL, '')
  File "/usr/lib/python3.12/locale.py", line 615, in setlocale
    return _setlocale(category, locale)
           ^^^^^^^^^^^^^^^^^^^^^^^^^^^^
locale.Error: unsupported locale setting
~~~

my locale setting:
~~~
locale
locale: Cannot set LC_CTYPE to default locale: No such file or directory
locale: Cannot set LC_MESSAGES to default locale: No such file or directory
locale: Cannot set LC_ALL to default locale: No such file or directory
LANG=szl_PL.UTF-8
LC_CTYPE="szl_PL.UTF-8"
LC_NUMERIC=pl_PL.UTF-8
LC_TIME=pl_PL.UTF-8
LC_COLLATE="szl_PL.UTF-8"
LC_MONETARY=pl_PL.UTF-8
LC_MESSAGES="szl_PL.UTF-8"
LC_PAPER=pl_PL.UTF-8
LC_NAME=pl_PL.UTF-8
LC_ADDRESS=pl_PL.UTF-8
LC_TELEPHONE=pl_PL.UTF-8
LC_MEASUREMENT=pl_PL.UTF-8
LC_IDENTIFICATION=pl_PL.UTF-8
LC_ALL=
~~~


---

Sent from sourceforge.net because doc...@li... is subscribed to https://sourceforge.net/p/docutils/bugs/

To unsubscribe from further messages, a project admin can change settings at https://sourceforge.net/p/docutils/admin/bugs/options.  Or, if this is a mailing list, you can unsubscribe from the mailing list.