Simple and brief path traversal and filesystem access library. This library is a bit different that other path manipulation libraries - the principles of this library:

• Path are subclasses of strings. You can use them anyhere you would use a string.
• All the function that works with paths from os / os.path / shutil should be available.
• Transparent support for files in .zip files (with limited functionality).
• Readonly functions are available as properties property. If the function would have side-effects (chdir, chroot etc) then it will be a method.
• Original names of the functions are kept. [1]
• Shorthands and brief aliases. Example:
  • os.path.getsize becomes a property named size
  • os.path.getatime becomes a property named atime
  • os.path.getctime becomes a property named ctime
  • os.path.getmtime becomes a property named mtime
  • os.path.basename becomes a property named name
  • os.path.dirname becomes a property named dir
  • os.listdir becomes a property named list
  • Calling a Path object calls open() on the path. Takes any argument open would take (except the filename ofcourse).

Basically it is designed for extreme brevity. It shares Unipath's str-subclassing approach and and it has seamless zip support (like Twisted's ZipPath).

Getting started:

>>> import pth
>>> pth  # the module is a function!
<function pth at ...>
>>> p = pth("a.txt")
>>> p
<Path 'a.txt'>
>>> p
<Path 'a.txt'>

A temporary path:

>>> t = pth.TempPath()
>>> t
<TempPath '/tmp/...'>

>>> with t:
...     with (t/"booo.txt")('w+') as f:
...         _ = f.write("test")
...     print([i for i in t.tree])
[<Path '/tmp/.../booo.txt'>]

>>> t.exists
False