Home

Awesome

replicant - a repl for adb

Gem Version Build Status

replicant is an interactive shell (a REPL) for adb, the Android Debug Bridge. It was originally based on Chris Wanstrath's excellent repl command line wrapper.

repl

Overview

Working with the adb tool directly to target connected emulators and devices is verbose and cumbersome. replicant simplifies this process in a number of ways:

Install

replicant requires Ruby 1.9 or newer and a UNIX/Linux compatible shell such as bash or zsh. For the best experience, I strongly recommend to install rlwrap to get command history and tab-completion, although it's not a requirement. replicant integrates with rlwrap automatically; it's sufficient for it to just be installed.

If all requirements are met, you can install replicant as a Ruby gem:

$ gem install replicant-adb

Contributing

Please hack on replicant and make it better and more feature complete! Here's a general list of guidelines you should follow:

After checking out the project, change into the project dir and do

$ bundle install

to make sure all dependencies are installed. After making local changes, you can install locally using

$ rake install

And don't forget to regularly

$ rake test

Copyright

Copyright (c) 2013-2014 Matthias Kaeppler. See LICENSE.txt for further details.