ospathbasenameusrlocalbin

os.path.basename is a function in Python’s standard library used to extract the final component of a pathname. It is part of the os.path module and is commonly employed to obtain a file name from a full path.

The function accepts a path as a string (or, on some platforms, as bytes) and returns the final path component after removing any trailing separators. Behavior is platform-aware: on POSIX systems it recognizes forward slashes, while on Windows it handles both backslashes and forward slashes. The operation is purely string-based and does not access the filesystem.

In terms of edge cases, trailing separators are ignored, so a path like '/foo/bar/' yields 'bar'. If the path represents a root location (such as '/' or 'C:\\'), basename may return an empty string. When given bytes, the function returns bytes, preserving the input type.

Examples illustrate its use: os.path.basename('/path/to/file.txt') returns 'file.txt', and os.path.basename('C:\\path\\to\\file.txt') returns 'file.txt' on Windows. For developers using the pathlib module, Path.name provides a similar result in an object-oriented form.

Related functions include os.path.split, which separates a path into the directory part and the final component, and os.path.dirname, which returns the directory portion without the final component. Since Python 3.4, pathlib.Path.name offers an equivalent semantics within the pathlib API.