>>> from shelltools import path

>>> path('/var/log')
/var/log

>>> path('/var', 'log')
/var/log

>>> path('/var/log').own
'766'

>>> path('/var/log').is_dir()
True

>>> for e in path('/var/log'):
...     print e
/var/log/boot.log
/var/log/dmesg
/var/log/faillog
/var/log/kern.log
/var/log/gdm

>>> path('/var/log/').ls('*log')
[/var/log/boot.log, /var/log/faillog, /var/log/kern.log]

>>> path('/var/log') / 'syslog'
/var/log/syslog

>>> (path('/var/log') / 'syslog').exists

>>> path('/var/log','syslog').open('r')
<open file '/var/log/syslog', mode 'r' at 0x294c5d0>

>>> path('/var/log').cp('copy', r=True)
copy

>>> path('/home/user/test_tmp_directory').replace('_', '-')
'/home/user/test-tmp-directory'

>>> location = path('/home/user/test_tmp_directory')
>>> location.mv( location.replace('_', '-') )

>>> from shelltools import run

>>> print run('uname -r').stdout
3.7.0-7-generic

>>> run('uname -a').status
0

>>> print run('rm not_existing_directory').stderr
rm: cannot remove `not_existing_directory': No such file or directory

>>> print run('ls -la', 'wc -l', 'wc -c')
3

>>> print run('ls -la').stdout.lines
['total 20',
 'drwxrwxr-x 3 user user 4096 Dec 20 22:55 .',
 'drwxrwxr-x 5 user user 4096 Dec 20 22:57 ..',
 'drwxrwxr-x 2 user user 4096 Dec 20 22:37 dir',
 '-rw-rw-r-- 1 user user    0 Dec 20 22:52 file']

from shelltools import run

run('grep something', data=run.stdin)

>>> print wrap("Lorem ipsum dolor sit amet, consectetur adipiscing elit. Duis sollicitudin ", 30)
Lorem ipsum dolor sit amet,
consectetur adipiscing elit.
Duis sollicitudin

>>> print text_list(["black", "red", "blue", "green"])
black, red, blue or green

>>> print text_list(["black", "red", "blue", "green"], "and")
black, red, blue and green

from shelltools.text import progress

for i in progress(range(100)):
    sleep( 0.2)