plumbum Shell combinators library
Download

plumbum Ranking & Summary

plumbum Tags

Python library Python shell combinators

plumbum Description

Ever wished the wrist-handiness of shell scripts be put into a real language? Say hello to Plumbum Shell Combinators. plumbum is a small yet feature-rich library for shell script-like programs in Python. The motto of the library is you'd never have to resort to shell scripts again, and thus it attempts to mimic the shell syntax (but only where it makes sense) while keeping it cross-platform.Apart from shell-like syntax and nifty shortcuts, the library focuses on local and remote command execution, local and remote paths, and working directory and environment manipulation. But enough with the talk, let's see some code!Basic Usage>>> from plumbum import local>>> from plumbum.local import ls, grep, cat, wc>>>>>> ls()'LICENSE\nREADME.rst\ndist\ndocs\nplumbum\n'>>>>>> chain = ls | wc>>> print chain(C:\Program Files\Git\bin\ls.exe | C:\Program Files\Git\bin\wc.exe '-l')>>> chain()'9\n'>>> notepad = local>>> notepad()''Foregound and Background>>> from plumbum import FG, BG>>> ls & FGtotal 10-rw-r--r-- 1 sebulba Administ 1079 Apr 29 15:34 LICENSE-rw-r--r-- 1 sebulba Administ 1318 Apr 29 16:56 README.rstdrwxr-xr-x 2 sebulba Administ 0 Apr 29 16:59 distdrwxr-xr-x 5 sebulba Administ 4096 Apr 29 23:38 docsdrwxr-xr-x 2 sebulba Administ 4096 Apr 29 16:52 plumbum>>> (ls | wc) & BG>>> f=_>>> f.wait()>>> f.stdout'16\n'Working Directory and Environment>>> with local.cwd("c:\\windows"):... (ls | wc)()...'105\n'>>>>>> with local.env(FOO="BAR"):... with local.env(FOO="SPAM"):... local.python("-c", "import os;print os.environ")... local.python("-c", "import os;print os.environ")...'SPAM\r\n''BAR\r\n'Remote Execution (over SSH)>>> from plumbum import Remote>>> r = Remote.connect("linuxbox.foo.bar")>>> r()'Linux\n'>>> r_ls = r>>> r_ls< SshCommand ssh://linuxbox.foo.bar /bin/ls >>>>>>> with r.cwd("/"):... r_ls()...'bin\nboot\ncdrom\ndev\netc\nhome\ninitrd.img\n'Tunneling (over SSH)>>> r_python = r>>> f = (r_python;s2.send('great success')"] & BG>>> with r.sshctx.tunnel(12222, 16666) as tun:... import socket... s=socket.socket()... s.connect(("localhost",12222))... s.recv(100)...'great success'>>> f.ready()TrueThis is only a teaser; the full documentation can be found at Read the DocsProduct's homepage

plumbum Related Software