term_width() throws Exception on fresh installs

[methical]

Problem

Fresh installing the latest version of beets using pipx results in beets not beeing usable.

11:33:59 chris@fedora ~ → pipx install beets
  installed package beets 2.5.1, installed using Python 3.14.2
  These apps are now globally available
    - beet
done! ✨ 🌟 ✨
11:34:11 chris@fedora ~ → beet config -e
Traceback (most recent call last):
  File "/home/chris/.local/bin/beet", line 5, in <module>
    from beets.ui import main
  File "/home/chris/.local/share/pipx/venvs/beets/lib64/python3.14/site-packages/beets/ui/__init__.py", line 858, in <module>
    indent_str, left, right, separator=" -> ", max_width=term_width()
                                                         ~~~~~~~~~~^^
  File "/home/chris/.local/share/pipx/venvs/beets/lib64/python3.14/site-packages/beets/ui/__init__.py", line 715, in term_width
    buf = fcntl.ioctl(0, termios.TIOCGWINSZ, " " * 4)
SystemError: buffer overflow

Setup

• OS: Fedora Linux 43 (Workstation Edition) x86_64 (Linux 6.17.12-300.fc43.x86_64)
• Python version: 3.14.2
• beets version: 2.5.1
• Turning off plugins made problem go away (yes/no): dnt

My configuration (output of beet config) is non existent

Running beet to create a config file beet config -e results in the above mentioned error

Bugfix

Editing init.py and catching the correct exception (in my case SystemError) in the method term_width() solves the problem and beets lets me edit a fresh config file.

[semohr]

We do not officially support python 3.14 yet.

For the issue at hand please see also #6222

[methical]

Thanks for the reply :) I tried searching the issues here but somehow I haven't found anything related to my problem.
However given from the documentation: https://beets.readthedocs.io/en/stable/guides/installation.html#installation

Beets requires Python 3.9 or later.

Maybe the documentation must be updated then.

[semohr]

I guess we would rather just support python 3.14 in our next release. Python 3.14 is just over a month old, and I think our last release even predates this. Early adoption can always comes with slight issues ;)

Btw we list all supported (tested) python versions in our pyprojet.toml:
https://github.com/beetbox/beets/blob/master/pyproject.toml#L18-L23

Please just be patient for a short while we work on a fix🤞

[methical]

Python 3.14 is just over a month old

I am not that much into the python game to know that. Guess it happens when you keep your Linux up2date.

I am being patient until then and close this issue.

[semohr]

Still a very valid issue! Let's keep it open otherwise it is hard to track.

[plenaerts]

I'm temporarily applying this patch for debian packaging:

--- a/beets/ui/__init__.py
+++ b/beets/ui/__init__.py
@@ -712,7 +712,7 @@
         return fallback

     try:
-        buf = fcntl.ioctl(0, termios.TIOCGWINSZ, " " * 4)
+        buf = fcntl.ioctl(0, termios.TIOCGWINSZ, b'\x00' * 8)
     except OSError:
         return fallback
     try:
--- a/beetsplug/lyrics.py
+++ b/beetsplug/lyrics.py
@@ -745,7 +745,7 @@
     TRANSLATE_URL = "https://api.cognitive.microsofttranslator.com/translate"
     LINE_PARTS_RE = re.compile(r"^(\[\d\d:\d\d.\d\d\]|) *(.*)$")
     SEPARATOR = " | "
-    remove_translations = partial(re.compile(r" / [^\n]+").sub, "")
+    remove_translations = staticmethod(partial(re.compile(r" / [^\n]+").sub, ""))

     _log: Logger
     api_key: str

[snejus]

@plenaerts would you like to submit a PR with the fix?

[plenaerts]

@snejus I can, but I haven't tested every corner of beets. I got the thing to build and run again. The majority of tests run fine as per autopkgtest reports. But I'm not deep into the beets code base... Do you still want the PR? 🙂

Edit: sorry, I was very incomplete... I can't make gstreamer work for py 3.14 too. I disabled that in test_bdp.py and test_replaygain.py. Ref my temporary patch for that. I haven't looked into that too much yet.

Do you still want the PR? ;-)

[ctrueden]

I believe this was already fixed by #6132, no? The relevant point is:

Python 3.14 introduced stricter requirements for input type in low level fnctl.ioctl function which we used to detect the terminal width. I replaced it with high-level, cross-platform shutil.get_terminal_size().

[Keksoj]

I hope this is the right place to report that the same break appears on arch linux since python 3.14 rolled out.

$ python --version                                                                                                                         
Python 3.14.2

$ pacman -Q beets                                                                                                                          
beets 2.5.1-3

$ beet --help
Traceback (most recent call last):
  File "/usr/bin/beet", line 5, in <module>
    from beets.ui import main
  File "/usr/lib/python3.14/site-packages/beets/ui/__init__.py", line 858, in <module>
    indent_str, left, right, separator=" -> ", max_width=term_width()
                                                         ~~~~~~~~~~^^
  File "/usr/lib/python3.14/site-packages/beets/ui/__init__.py", line 715, in term_width
    buf = fcntl.ioctl(0, termios.TIOCGWINSZ, " " * 4)
SystemError: buffer overflow

Looking forward for the next version 😃
I take the opportunity to express my gratitude for your work. Beets is a cool piece of software and a pleasure to use.