adbpy / wire-protocol

Android Debug Bridge (ADB) Wire Protocol in Python 3

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

wire-protocol

Build Status codecov Code Climate Issue Count

Documentation Status

Android Debug Bridge (ADB) Wire Protocol

Status

This project is actively maintained and under development.

Installation

To install wire-protocol from pip:

    $ pip install adbwp

To install wire-protocol from source:

    $ git clone git@github.com:adbpy/wire-protocol.git
    $ cd wire-protocol && python setup.py install

Goals/Scope

A standalone library that can be used for building protocol objects while remaining transport/application protocol agnostic. The wire protocol should care about:

  • Byte layout on the wire
  • Model representation of Messages (header + payload)
  • Provide simple API that convert bytes to/from models

The wire protocol should not care, nor have concept of:

  • Synchronous vs. Asynchronous
  • TCP, UDP, USB
  • Sequence of messages required to complete a connection "handshake"
  • Cryptography required to verify endpoints
  • Anything else not explicitly mentioned above...

Contributing

If you would like to contribute, simply fork the repository, push your changes and send a pull request. Pull requests will be brought into the master branch via a rebase and fast-forward merge with the goal of having a linear branch history with no merge commits.

License

Apache 2.0

About

Android Debug Bridge (ADB) Wire Protocol in Python 3

License:Apache License 2.0


Languages

Language:Python 93.8%Language:Makefile 6.2%