Metadata-Version: 2.1
Name: easy-adb
Version: 0.0.1
Summary: Easy to use ADB commands in Python 3
Home-page: https://github.com/minwook-shin/easy-adb
Author: minwook-shin
Author-email: minwook0106@gmail.com
License: LGPLv3
Project-URL: Homepage, https://github.com/minwook-shin/easy-adb
Project-URL: Bug Reports, https://github.com/minwook-shin/easy-adb/issues
Keywords: python,adb,android
Classifier: License :: OSI Approved :: GNU Lesser General Public License v3 (LGPLv3)
Classifier: Development Status :: 4 - Beta
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.9
Description-Content-Type: text/markdown
Requires-Dist: requests ==2.31.0
Requires-Dist: adb-shell ==0.4.4

# easy-adb

## Introduction

easy-adb is a tool written in Python that simplifies the use of Android Debug Bridge (ADB) commands. 

With this tool, you can easily perform tasks such as starting an ADB server, connecting to an Android device, and executing ADB commands using Python code.

## Installation

If Python >= 3.9 is installed, you can install easy-adb with the following command:

```shell
pip install easy-adb
```

## Usage

easy-adb can be used through a command-line interface (CLI). 

Here is the basic way to use easy-adb:

```shell
python -m easy_adb.cli --ip [device IP] --port [port number] --adb-command [ADB command to execute]
```

replace [device IP], [port number], and [ADB command to execute] with the actual values.

or you can use easy-adb in Python code:

```python
from easy_adb import run_adb_server, set_signer, connect_device, send_command, download_adb_binary

# equivalent to: easy-adb --ip 192.168.0.1 --port=5555 --adb-command="getprop ro.product.model"

download_adb_binary()
run_adb_server()
test_device = connect_device(set_signer(), "192.168.0.1", 5555)
result = send_command(test_device, "getprop ro.product.model")
```

## Features

easy-adb provides the following features:

* ADB Server Management: Start the ADB server from Python code.
* Device Connection Management: Connect to Android devices using WI-FI IP address and port number.
* ADB Command Execution: Execute ADB command and retrieve output.

## License

This project is distributed under the LGPLv3 license. See the [LICENSE](LICENSE) file for details.

## Contact

For bug reports about this project, please submit them through the GitHub issue tracker.
