🔵 🔵 🔵


Primary

၊၊||၊|။

PurePath.with_stem() ⚬|Documentation|1st|20260122195929-00-⌔

pathlib — Object-oriented filesystem paths — Python 3.14.2 documentation#pathlib.PurePath.with_stem

PurePath.with_stem(stem)

Return a new path with the stem changed. If the original path doesn’t have a name, ValueError is raised:

>>> p = PureWindowsPath('c:/Downloads/draft.txt')
>>> p.with_stem('final')
PureWindowsPath('c:/Downloads/final.txt')
>>> p = PureWindowsPath('c:/Downloads/pathlib.tar.gz')
>>> p.with_stem('lib')
PureWindowsPath('c:/Downloads/lib.gz')
>>> p = PureWindowsPath('c:/')
>>> p.with_stem('')
Traceback (most recent call last):
 File "<stdin>", line 1, in <module>
 File "/home/antoine/cpython/default/Lib/pathlib.py", line 861, in with_stem
   return self.with_name(stem + self.suffix)
 File "/home/antoine/cpython/default/Lib/pathlib.py", line 851, in with_name
   raise ValueError("%r has an empty name" % (self,))
ValueError: PureWindowsPath('c:/') has an empty name

Added in version 3.9.

Printed 2026-06-28.

(echo:: @ )

Link to original

Secondary

• • •