summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
-rw-r--r--Lib/pathlib.py7
-rw-r--r--Lib/test/test_pathlib.py27
-rw-r--r--Misc/NEWS6
3 files changed, 40 insertions, 0 deletions
diff --git a/Lib/pathlib.py b/Lib/pathlib.py
index d03aede..a1e0a82 100644
--- a/Lib/pathlib.py
+++ b/Lib/pathlib.py
@@ -690,6 +690,13 @@ class PurePath(object):
self._parts) or '.'
return self._str
+ @property
+ def path(self):
+ try:
+ return self._str
+ except AttributeError:
+ return str(self)
+
def as_posix(self):
"""Return the string representation of the path with forward (/)
slashes."""
diff --git a/Lib/test/test_pathlib.py b/Lib/test/test_pathlib.py
index 5ee22ad..138550f 100644
--- a/Lib/test/test_pathlib.py
+++ b/Lib/test/test_pathlib.py
@@ -477,6 +477,22 @@ class _BasePurePathTest(object):
self.assertEqual(P('a/b.py').name, 'b.py')
self.assertEqual(P('/a/b.py').name, 'b.py')
+ def test_path_common(self):
+ P = self.cls
+ def check(arg, expected=None):
+ if expected is None:
+ expected = arg
+ self.assertEqual(P(arg).path, expected.replace('/', self.sep))
+ check('', '.')
+ check('.')
+ check('/')
+ check('a/b')
+ check('/a/b')
+ check('/a/b/', '/a/b')
+ check('/a/b/.', '/a/b')
+ check('a/b.py')
+ check('/a/b.py')
+
def test_suffix_common(self):
P = self.cls
self.assertEqual(P('').suffix, '')
@@ -899,6 +915,17 @@ class PureWindowsPathTest(_BasePurePathTest, unittest.TestCase):
self.assertEqual(P('//My.py/Share.php').name, '')
self.assertEqual(P('//My.py/Share.php/a/b').name, 'b')
+ def test_path(self):
+ P = self.cls
+ self.assertEqual(P('c:').path, 'c:')
+ self.assertEqual(P('c:/').path, 'c:\\')
+ self.assertEqual(P('c:a/b').path, 'c:a\\b')
+ self.assertEqual(P('c:/a/b').path, 'c:\\a\\b')
+ self.assertEqual(P('c:a/b.py').path, 'c:a\\b.py')
+ self.assertEqual(P('c:/a/b.py').path, 'c:\\a\\b.py')
+ self.assertEqual(P('//My.py/Share.php').path, '\\\\My.py\\Share.php\\')
+ self.assertEqual(P('//My.py/Share.php/a/b').path, '\\\\My.py\\Share.php\\a\\b')
+
def test_suffix(self):
P = self.cls
self.assertEqual(P('c:').suffix, '')
diff --git a/Misc/NEWS b/Misc/NEWS
index d39a1c6..fd22bbb 100644
--- a/Misc/NEWS
+++ b/Misc/NEWS
@@ -41,6 +41,12 @@ Core and Builtins
Library
-------
+- Issue #22570: Add 'path' attribute to pathlib.Path objects,
+ returning the same as str(), to make it more similar to DirEntry.
+ Library code can now write getattr(p, 'path', p) to get the path as
+ a string from a Path, a DirEntry, or a plain string. This is
+ essentially a small one-off protocol.
+
- Issue #26012: Don't traverse into symlinks for ** pattern in
pathlib.Path.[r]glob().