[C API] Add PyBytes_Join() function

[vstinner]

Feature or enhancement

Python 3.13 alpha 1 removed the private _PyBytes_Join(sep, iterable) function which calls sep.join(iterable).

mypyc uses it. Since we already have PyUnicode_Join(sep, iterable), I propose to add a new PyBytes_Join() function.

In practice, it's just about renaming _PyBytes_Join() to PyBytes_Join().

Linked PRs

• gh-121645: Add PyBytes_Join() function #121646
• gh-121645: Fix typo in PyBytes_Join() doc #123783

[vstinner]

mypyc uses it.

A code search on PyPI top 7,500 projects found 6 projects using the private _PyBytes_Join() function:

• Cython (3.0.9)
• dbnd (1.0.22.9)
• dulwich (0.21.7)
• mod_wsgi (5.0.0)
• mpi4py (3.1.5)
• mypy (1.9.0)

[vstinner]

mypyc uses it

Sorry, I forgot to add a reference to the mypy issue: issue gh-121489.

[ZeroIntensity]

Additionally, many repositories use _PyBytes_Resize as well. Perhaps that's something that should go public?

[vstinner]

Additionally, many repositories use _PyBytes_Resize as well. Perhaps that's something that should go public?

IMO _PyBytes_Resize() is a bad pattern, it uses a bytes object which is incomplete/inconsistent: see capi-workgroup/api-evolution#36.

Instead, I created #121710: [C API] Add PyBytesWriter API.

[vstinner]

Implemented by the change 3d60dfb.