Metadata-Version: 2.1
Name: avd-compose
Version: 0.5.5
Summary: Define and run android virtual devices
Home-page: https://github.com/f9n/avd-compose
License: GPL-3.0
Author: Fatih Sarhan
Author-email: f9n@protonmail.com
Requires-Python: >=3.4,<4.0
Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Requires-Dist: PyYAML (>=5.1,<6.0)
Requires-Dist: click (>=7.0,<8.0)
Requires-Dist: delegator.py (>=0.1.1,<0.2.0)
Project-URL: Repository, https://github.com/f9n/avd-compose
Description-Content-Type: text/markdown

# avd-compose [![PyPi version](https://img.shields.io/pypi/v/avd-compose.svg)](https://pypi.python.org/pypi/avd-compose/) [![PyPI pyversions](https://img.shields.io/pypi/pyversions/avd-compose.svg)](https://pypi.python.org/pypi/avd-compose/) [![](https://img.shields.io/github/license/f9n/avd-compose.svg)](https://github.com/f9n/avd-compose/blob/master/LICENSE)

Define and run android virtual devices

# Requirements

- android-studio
- python3.4+
- pip3

# Notes

Make sure that the `ANDROID_HOME` environment variable is set.

```bash
$ echo $ANDROID_HOME

$ export ANDROID_HOME=$HOME/Android/Sdk
$ echo $ANDROID_HOME
/home/f9n/Android/Sdk
```

# Install

```bash
$ pip3 install --user avd-compose
```

# Usage

```bash
$ avd-compose --help
$ avd-compose version
$ cat <<EOF >avd-compose.yml
version: 1

platforms:
  - name: My_Nexus_5
    avd:
      package: "system-images;android-27;google_apis_playstore;x86"
      device: Nexus 5
    emulator:

  - name: My_Nexus_One
    avd:
      package: "system-images;android-27;google_apis_playstore;x86"
      device: Nexus One
    emulator:

EOF
$ # Create all of them
$ avd-compose create
$ # Create one of them
$ avd-compose create --name My_Nexus_One
$ # Destroy all of them
$ avd-compose destroy
$ # Destroy one of them
$ avd-compose destroy --name My_Nexus_One
$ avd-compose up --name My_Nexus_5
```

# Examples

Look up the [examples](https://github.com/f9n/avd-compose/tree/master/examples) directory.

# Credits

- [Docker Compose](https://github.com/docker/compose)
- [Vagrant](https://github.com/hashicorp/vagrant)

