Issue #19673: Add pathlib to the stdlib as a provisional module (PEP 428).

Doc/library/filesys.rst

@@ -12,6 +12,7 @@ in this chapter is:
 
 .. toctree::
 
+   pathlib.rst
    os.path.rst
    fileinput.rst
    stat.rst

Doc/library/glob.rst

@@ -25,6 +25,10 @@ For a literal match, wrap the meta-characters in brackets.
 For example, ``'[?]'`` matches the character ``'?'``.
 
 
+.. seealso::
+   The :mod:`pathlib` module offers high-level path objects.
+
+
 .. function:: glob(pathname)
 
    Return a possibly-empty list of path names that match *pathname*, which must be

Doc/library/os.path.rst

@@ -22,6 +22,11 @@ Functions such as :func:`expanduser` and :func:`expandvars` can be invoked
 explicitly when an application desires shell-like path expansion.  (See also
 the :mod:`glob` module.)
 
+
+.. seealso::
+   The :mod:`pathlib` module offers high-level path objects.
+
+
 .. note::
 
    All of these functions accept either only bytes or only string objects as

Doc/whatsnew/3.4.rst

@@ -93,6 +93,7 @@ New library modules:
 * :mod:`asyncio`: New provisonal API for asynchronous IO (:pep:`3156`).
 * :mod:`enum`: Support for enumeration types (:pep:`435`).
 * :mod:`ensurepip`: Bootstrapping the pip installer (:pep:`453`).
+* :mod:`pathlib`: Object-oriented filesystem paths (:pep:`428`).
 * :mod:`selectors`: High-level and efficient I/O multiplexing, built upon the
   :mod:`select` module primitives.
 * :mod:`statistics`: A basic numerically stable statistics library (:pep:`450`).
@@ -318,6 +319,23 @@ compatible enumeration values.
       implemented by Ethan Furman.
 
 
+pathlib
+-------
+
+The new :mod:`pathlib` module offers classes representing filesystem paths
+with semantics appropriate for different operating systems.  Path classes are
+divided between *pure paths*, which provide purely computational operations
+without I/O, and *concrete paths*, which inherit from pure paths but also
+provide I/O operations.
+
+For Python 3.4, this module is considered a :term:`provisional API`.
+
+.. seealso::
+
+   :pep:`428` - The pathlib module -- object-oriented filesystem paths
+      PEP written and implemented by Antoine Pitrou.
+
+
 selectors
 ---------
 

Misc/NEWS

@@ -65,6 +65,8 @@ Core and Builtins
 Library
 -------
 
+- Issue #19673: Add pathlib to the stdlib as a provisional module (PEP 428).
+
 - Issue #17916: Added dis.Bytecode.from_traceback() and
   dis.Bytecode.current_offset to easily display "current instruction"
   markers in the new disassembly API (Patch by Claudiu Popa).