About adbons
A wrapper for the Android adb tool. It's just adb on steroids.
Features
Currently only some basic features are provided. These features should simplify and shorten the required adb commands.
Example workflow to kill an app when multiple devices are connected:
- A default device and app id is set in the config. This information is saved in a
.adbons.yml
file. The file is either stored local (working dir) or global (~/.adbons/
). - Execute the kill command. With saved values, the app is just killed with
adbons kill
instead ofadb -s <device> shell am force-stop <app id>
.
Install
Install adbons with pip for Python 3 (usually pip
or pip3
):
$ pip3 install adbons
Install from source:
$ git clone https://github.com/dbaelz/adbons.git
$ cd adbons
$ pip install .
Usage
See adbons --help
for all currently available commands. The commands provide help pages as well (e.g. adbons config --help
).
Development
adbons is a Python 3.5 (and above) command line tool. It's still work in progress. Any suggestions, feature requests, bug reports or pull requests are very much appreciated.
Getting started
A short introduction how to develop for adbons. If you have any questions feel free to contact me.
- Optional: Create/activate a virtual environment
- Fork and clone adbons
- Switch to a feature branch (usually branched from develop)
- Read the Click documentation
- Add your cool feature/bugfix/whatever
- Create a pull request
Testing
There are some tests for the adbons commands. These tests are executed with python -m unittest
. For information who to write unit tests see the Click documentation.
License
adbons is licensed under the BSD License.