Package: budgie
budgie======[![Build Status](https://travis-ci.org/puredistortion/budgie.png?branch=master)](https://travis-ci.org/puredistortion/budgie)A pythonic remote control of servers via sshInstallation------------Install the libraryvirtualenv venv && . venv/bin/activate  # optionalpip install shwget https://raw2.github.com/puredistortion/budgie/master/budgie.pyYou need to configure passwordless SSH for your remote hosts:ssh-keygen -q -t rsa -N 'your_password_here' -f ~/.ssh/id_rsassh-copy-id localhost # Repeat this for each hosteval `ssh-agent`ssh-addssh localhost pwd # test connectionNext, create an SSH config file in `~/.ssh/config` describing your hosts:Host localhostUser userHostName localhostIdentityFile ~/.ssh/id_rsa.keyHost osxUser userHostName steve-macIdentityFile ~/.ssh/id_rsa.keyHost projectsUser userHostName 192.168.1.30IdentityFile ~/.ssh/projects.keyHost prodUser produserHostName prod.example.comIdentityFile ~/.ssh/deploy.keyUsage-----Now you can run remote commands using simple python codefrom budgie import localhostprint localhost.hostname(), localhost.uptime()localhost.touch('/tmp/latest')You can also callhosts ing this alternate method if the magic above is to muchimport budgieprint budgie.ssh('localhost'), budgie.ssh('localhost').uptime()budgie.ssh('localhost').touch('/tmp/latest')Passing in SSH Options----------------------budgie will allow the passing in of SSH options. At this time this is done through the bake method in the same way you would pass this into the sh.ssh()budgie.localhost.bake('-o', 'UserKnownHostsFile=/dev/null', '-o',  'StrictHostKeyChecking=no').whoami()orbudgie.ssh().bake('-o', 'UserKnownHostsFile=/dev/null', '-o',  'StrictHostKeyChecking=no', '127.0.0.1').whoami()This does need to be cleaned up to make more logical sense.Using Sudo----------Just as in sh sudo is just treated as another budgie command.So executing a remote command is as simple as:budgie.localhost.sudo.cat('/etc/hosts')You will need to ensure that sudo is either allowing the remote user you connect with to exec the command via /etc/sudoersBudgie Host Groups-----------------budgie offers the ability to bundle ssh hosts for batch command execution. This is done through creating a host group. A host group will take in a list of host names or budgie.ssh instances.web_servers = budgie.HostGroup()web_servers.add('www1.example.com')web_servers.add('www2.example.com')webservers.add(['www1.example.com', 'www2.example.com'])www1 = budgie.ssh('www1.example.com')www2 = budgie.ssh('www2.example.com')webservers.add([www1, www2])orweb_servers.HostGroup(['www1.example.com', 'www2.example.com'])www1 = budgie.ssh('www1.example.com')www2 = budgie.ssh('www2.example.com')web_servers.HostGroup([www1, www2])Once a budgie.HostGroup() is created it can be intereacted with like a standard dictionary.Commands can be executed against the host group and results of execution will be supplied back as a dictionaryresult = web_servers.whoami()Result would contain{'www1': 'www1.example.com', 'www2': 'www2.example.com'}Running Tests-------------`tests.py` can be called via the commandlime and is run on each commit through Travis CIqTests can be called by runningpython tests.pyThis is the current test suite being applied to builds*Import Test*Direct Call Goes to Exception Test*Command Execution (whoami) Test*HostGroup Creation*HostGroup Manipulation (add, remove)*HostGroup Command Execution (whoami) TestCommand execution test uses SSH options that allow for the automatic generation of SSH keypairs and discarding them from known hosts at the conclusion of the connection.