pygettext.py crashes with UnicodeEncodeError when writing .pot files containing emoji
@StanFromIreland is already working on this.
Since Oct 10, 2025.
- Dominant language
- Python
- Stars
- 77.2k
- Forks
- 35.9k
- PR merge metrics
- PR metrics pending
Description
Bug report
Bug description:
Summary:
pygettext.py fails with a UnicodeEncodeError when generating .pot files that contain Unicode characters such as emoji (e.g. ✅). This happens on Windows systems where the default encoding is cp1252, which cannot represent many Unicode symbols.
Steps to Reproduce:
- Add a translatable string with an emoji to a Python file:
_("Operation complete ✅") - Run pygettext.py to generate the .pot file:
python pygettext.py -d messages -o messages.pot your_script.py - Observe the crash:
UnicodeEncodeError: 'charmap' codec can't encode character '\u2705' in position 1: character maps to
Cause:
The .pot file is opened using:
fp = open(output_file, 'w')
This defaults to the system encoding (cp1252 on Windows), which cannot encode emoji or other extended Unicode characters.
Suggested Fix:
Update the file-writing line in pygettext.py to explicitly use UTF-8:
fp = open(output_file, 'w', encoding='utf-8')
This ensures compatibility with all Unicode characters and aligns with modern Python practices.
Environment:
- Python version: 3.14
- OS: Windows 10
- Locale: pt_BR
- Default encoding: cp1252
Related Pull Request:
This issue appears related to PR #132244, which discusses encoding behavior in pygettext.py. However, the PR focuses on testing and does not yet address the default encoding used when writing .pot files.
CPython versions tested on:
3.14
Operating systems tested on:
Windows
Linked PRs
- gh-139915
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Assessment
This issue has not been assessed yet.