avd_manager 1.0.4

package/docs/README.md

@@ -0,0 +1,171 @@
+![AVD Manager CLI Banner](./assets/banner-light.png)
+[![pub version](https://img.shields.io/pub/v/avd_manager.svg)](https://pub.dev/packages/avd_manager)
+[![Buy Me a Coffee](https://img.shields.io/badge/Buy%20Me%20a%20Coffee-%E2%98%95-yellow)](https://buymeacoffee.com/guimbobabag)
+[![Sponsor](https://img.shields.io/badge/sponsor-GitHub-brightgreen)](https://github.com/sponsors/Tdebo21)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![npm version](https://badge.fury.io/js/avd-manager-cli.svg)](https://badge.fury.io/js/avd-manager-cli)
+
+# Welcome :tada: to 📱 AVD Manager CLI
+
+A lightweight DART CLI tool for managing Android Virtual Devices with ease and speed.
+
+## Features
+
+- ✨ Create and manage AVDs programmatically
+- 🚀 List available AVDs and their sizes
+- 🔧 Launch AVDs with custom options
+- 📋 Delete and clean up unused AVDs
+- 🎯 Cross-platform support (macOS, Windows, Linux)
+- :heart: Open source
+
+## 📦 Installation
+
+You can install **AVD Manager CLI** using your preferred package manager, from Pub.dev, or by downloading the binary from the releases page.
+
+```bash
+# Example installation using Homebrew (macOS)
+
+brew tap Tdebo21/avd_manager
+brew install avd_manager
+```
+
+# Get help
+
+```bash
+avdm --help
+```
+
+- **Installing from Pub.dev**
+
+### Prerequisites
+
+- **Dart SDK** 3.0 or higher ([Install Dart](https://dart.dev/get-dart))
+- **Android SDK** with emulator tools ([Install Android Studio](https://developer.android.com/studio))
+- **Java JDK** 11 or higher
+
+### macOS
+
+```bash
+# Install from pub.dev
+dart pub global activate avdm_manager
+
+# Verify installation
+avdm --version
+```
+
+### Windows
+
+```powershell
+# Using pub.dev
+dart pub global activate avdm_manager
+
+# Add Dart global bin to PATH if not already done:
+# %APPDATA%\Pub\Cache\bin
+
+# Verify installation
+avdm --version
+```
+
+### Linux
+
+```bash
+# Using pub.dev
+dart pub global activate avdm_manager
+
+# Add Dart global bin to PATH (usually automatic, but verify):
+# ~/.pub-cache/bin
+
+# Verify installation
+avdm --version
+```
+
+- **Installing using npm**
+
+```bash
+npm install -g avd-manager-cli
+```
+
+- **Installing from GitHub Releases (Binaries)** -
+  Users without Dart SDK can download executable from the releases page, add to PATH.
+
+## 📚 Commands Overview
+
+See the sidebar for detailed command documentation.
+
+- **[list](commands/list.md)** – Show available AVDs
+- **[create](commands/create.md)** – Create a new AVD
+- **[launch](commands/launch.md)** – Start a virtual device
+- **[delete](commands/delete.md)** – Remove an AVD
+
+## License
+
+MIT License - See [LICENSE](https://github.com/Tdebo21/avd_manager/blob/main/LICENSE)
+
+## Usage
+
+Once installed, simply run:
+
+```bash
+avdm --help
+```
+
+You’ll see a list of available commands and options.
+
+```bash
+avdm list [options]
+```
+
+## Options
+
+- `--sort [size|name]` - Sort AVDs by size or name
+- `--min-size <size>` - Only show AVDs larger than this size (e.g., 500MB, 1GB)
+- `-h, --help` - Show help information
+
+## Examples Usage
+
+```bash
+# List all AVDs
+avdm list
+
+# Sort by name
+avdm list --sort name
+
+# Filter by minimum size
+avdm list --min-size 1GB
+
+# Create a new AVD
+avdm create Pixel_API_35 --device pixel --api 35
+
+# Delete an AVD
+avdm delete Pixel_API_35
+
+# Launch a specific AVD with defaults
+avdm launch TestDevice
+```
+
+## 🧩 Troubleshooting
+
+If you encounter issues:
+
+- Ensure Android SDK tools are installed
+- Verify that avdmanager and sdkmanager are available in your PATH
+
+## 📝 Changelog
+
+See the full changelog in `CHANGELOG.md` for version history and updates by visiting the GitHub Repository - [![GitHub](https://img.shields.io/badge/GitHub-avd_manager-blue)](https://github.com/Tdebo21/avd_manager)
+
+## ❤️ Support & Sponsorship
+
+If this tool saves you time or improves your workflow, consider supporting the project:
+
+⭐ Star the repository
+
+🐛 Submit issues
+
+🤝 Contribute pull requests
+
+☕ Sponsor development
+
+Your support keeps the project growing.
+[![Buy Me a Coffee](https://img.shields.io/badge/Buy%20Me%20a%20Coffee-%E2%98%95-yellow)](https://buymeacoffee.com/guimbobabag)
+[![Sponsor](https://img.shields.io/badge/sponsor-GitHub-blue)](https://github.com/sponsors/Tdebo21)

package/docs/_coverpage.md

@@ -0,0 +1,8 @@
+![Logo](./assets/logo.png)
+
+# AVD Manager CLI
+
+> Manage Android Virtual Devices from your terminal
+
+[Get Started](getting-started.md)
+[View on GitHub](https://github.com/Tdebo21/avd_manager)

package/docs/_sidebar.md

@@ -0,0 +1,15 @@
+- [Home](README.md)
+- [Getting Started](getting-started.md)
+
+* **Commands**
+  - [List AVDs](./commands/list.md)
+  - [Create AVD](./commands/create.md)
+  - [Delete AVD](./commands/delete.md)
+  - [Launch AVD](./commands/launch.md)
+* **Links**
+  - [![GitHub](https://img.shields.io/badge/GitHub-avd_manager-blue)](https://github.com/Tdebo21/avd_manager)
+  - [![Pub.dev](https://img.shields.io/badge/Pub.dev-avd_manager-blue)](https://pub.dev/packages/avd_manager)
+
+```
+
+```

package/docs/commands/create.md

@@ -0,0 +1,24 @@
+# 🛠 Create AVD
+
+The `create` command sets up a new Android Virtual Device using a given system image and name.
+
+## 🔧 Usage
+
+```bash
+avdm create <avd-name> --api image "<system-image>"
+````
+
+## 🏷 Options
+
+| Flag      | Description                            |
+| --------- | -------------------------------------- |
+| `--api`  | API level (e.g. 28)                  |
+| `--abi` | ABI for the system image (e.g. x86, x86_64, arm64-v8a) |
+
+✅ **Tip:** Use `sdkmanager --list` to find available system images.
+
+## ✅ Example
+
+```bash
+ avdm create Pixel_24 --api=24 image "system-images;android-24;google_apis;x86_64"
+```

package/docs/commands/delete.md

@@ -0,0 +1,18 @@
+# 🗑 Delete AVD
+
+The `delete` command removes an AVD from your system permanently.
+
+## ⚠️ Caution
+
+This operation **cannot be undone**.
+
+## 🔧 Usage
+
+```bash
+avdm delete <avd_name>
+````
+## ✅ Example
+
+```bash
+avdm delete Pixel_34
+```

package/docs/commands/launch.md

@@ -0,0 +1,17 @@
+# 🚀 Launch AVD
+
+The `launch` command boots up the specified AVD in the emulator.
+
+## 🔧 Usage
+
+```bash
+avdm launch <avd-name>
+````
+
+## ✅ Example
+
+```bash
+avdm  launch <existing_avdm_name> (i.e avdm launch Pixel_34)
+```
+
+This launches the emulator window for the specified device.

package/docs/commands/list.md

@@ -0,0 +1,32 @@
+# 📋 List AVDs
+
+The `list` command shows all available Android Virtual Devices (AVDs) on your system.
+
+## 🔧 Usage
+
+```bash
+avdm list [--sort name|size] [--min-size 1GB]
+```
+
+## 🏷 Options
+
+| Flag         | Description                                        |
+| ------------ | -------------------------------------------------- |
+| `--sort`     | Sort AVDs by `name` or `size`                      |
+| `--min-size` | Show only AVDs larger than given size (e.g. `2GB`) |
+
+## ✅ Examples
+
+```bash
+# List all AVDs
+avdm list
+
+# List and sort by size
+avdm list --sort size
+
+# List only AVDs > 2GB
+avdm list --min-size 2GB
+
+# List and sort by name
+avdm list --sort name
+```

package/docs/getting-started.md

@@ -0,0 +1,135 @@
+# Getting Started
+
+Welcome to **AVD Manager CLI** — a simple and efficient command-line tool for managing Android Virtual Devices (AVDs) directly from your terminal.
+
+This quick-start guide will help you install, configure, and use the CLI in just a few steps.
+
+---
+
+## 🧩 Prerequisites
+
+Before you begin, make sure you have:
+
+- **Android SDK** installed
+- **Java JDK 11+**
+- **Android SDK tools** (`avdmanager`, `sdkmanager`) available in your PATH
+- **Node.js** (if installing via npm)
+- **Homebrew** (if installing via Homebrew)
+
+---
+
+## ⚙️ Installation
+
+### Using npm
+
+You can install AVD Manager CLI globally using npm:
+
+```bash
+npm install -g avd-manager-cli
+```
+
+Or clone the repository manually:
+
+```bash
+git clone https://github.com/Tdbo21/avd_manager.git
+cd avd_manager
+npm install
+```
+
+### Using Homebrew
+
+Alternatively, using Homebrew (macOS users):
+
+### Tap Homebrew repository
+
+```bash
+brew tap Tdebo21/avd_manager
+```
+
+### Install the tool
+
+```bash
+brew install avd_manager
+```
+
+### Use it
+
+```bash
+avdm --help
+```
+
+### To update
+
+```bash
+brew upgrade avd_manager
+```
+
+### Uninstall (if needed)
+
+```bash
+brew uninstall avd_manager
+```
+
+### Using Dart (pub.dev)
+
+```bash
+dart pub global activate avd_manager
+```
+
+## 🚀 First Run
+
+After installation, verify the CLI is working:
+
+```bash
+avdm --help
+```
+
+You should see a list of available commands and their usage.
+
+## 🧭 Common Commands
+
+| Command                                                  | Description              |
+| -------------------------------------------------------- | ------------------------ |
+| `avdm `list                                              | Lists all available AVDs |
+| `avdm `create `Pixel_API_35 `--device `pixel `--api `35` | Creates a new AVD        |
+| `avdm `delete `Pixel_API_35`                             | Deletes an existing AVD  |
+| `avdm `launch `Pixel_API_35`                             | Launches an existing AVD |
+
+## 🧪 Example Workflow
+
+List existing AVDs
+
+```bash
+avdm list
+```
+
+Create a new AVD
+
+```bash
+avdm create Pixel_API_35 --device pixel --api 35
+```
+
+Delete an AVD
+
+```bash
+avdm delete Pixel_API_35
+```
+
+Launch an AVD
+
+```bash
+avdm launch Pixel_API_35
+```
+
+## 🧰 Troubleshooting
+
+If you encounter issues:
+
+- Ensure your Android SDK path is correctly set
+- Check permissions for the .android directory
+
+## 🧩 Next Steps
+
+- Explore the [README](README.md)section for detailed usage
+- Visit the GitHub Repository - [![GitHub](https://img.shields.io/badge/GitHub-avd_manager-blue)](https://github.com/Tdebo21/avd_manager)
+- Contribute or open issues to improve the tool

package/docs/index.html

@@ -0,0 +1,105 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>AVD Manager (avdm) - CLI Documentation</title>
+    <link
+      rel="stylesheet"
+      href="https://cdn.jsdelivr.net/npm/docsify@4/lib/themes/vue.css"
+    />
+    <link rel="icon" href="./assets/favicon.png" type="image/png" />
+    <link rel="stylesheet" href="./theme.css" />
+    <style>
+      :root {
+        --primary-color: #007bff;
+        --text-color: #333;
+        --border-color: #eee;
+        --code-theme-bg: #f4f4f4;
+      }
+      body {
+        font-family:
+          -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Oxygen, Ubuntu,
+          sans-serif;
+      }
+    </style>
+    <!-- Prism for Syntax Highlighting and Copy Button -->
+    <link
+      rel="stylesheet"
+      href="https://cdnjs.cloudflare.com/ajax/libs/prism/1.29.0/prism.min.css"
+    />
+    <link
+      rel="stylesheet"
+      href="https://cdnjs.cloudflare.com/ajax/libs/prism/1.29.0/plugins/toolbar/prism-toolbar.min.css"
+    />
+    <link
+      rel="stylesheet"
+      href="https://cdnjs.cloudflare.com/ajax/libs/prism/1.29.0/plugins/copy-to-clipboard/prism-copy-to-clipboard.min.css"
+    />
+  </head>
+  <body>
+    <div id="app"></div>
+    <div id="theme-toggle">🌗 Toggle Theme</div>
+    <script>
+      const toggle = document.getElementById("theme-toggle");
+      const currentTheme = localStorage.getItem("theme");
+
+      if (currentTheme) {
+        document.documentElement.setAttribute("data-theme", currentTheme);
+      }
+
+      toggle.addEventListener("click", () => {
+        const theme =
+          document.documentElement.getAttribute("data-theme") === "dark"
+            ? "light"
+            : "dark";
+
+        document.documentElement.setAttribute("data-theme", theme);
+        localStorage.setItem("theme", theme);
+      });
+    </script>
+    <!-- Docsify Configuration -->
+    <script>
+      window.$docsify = {
+        name: "AVD Manager (avdm) CLI",
+        repo: "https://github.com/Tdebo21/avd_manager",
+        loadSidebar: true,
+        alias: { "/.*/_sidebar.md": "/_sidebar.md" },
+        homepage: "README.md",
+        coverpage: true,
+        subMaxLevel: 2,
+        sidebarDisplayLevel: 1,
+        search: true,
+        themeColor: "#007bff",
+        notFoundPage: "404.html",
+        auto2top: true,
+        maxLevel: 3,
+        // Code highlighting
+        highlight: {
+          style: "atom-one-dark",
+        },
+        // Plugins
+        plugins: [
+          function (hook, vm) {
+            hook.doneEach(function () {
+              // Re-initialize Prism after content loads
+              if (window.Prism) {
+                Prism.highlightAll();
+              }
+            });
+          },
+        ],
+      };
+    </script>
+    <script src="https://cdn.jsdelivr.net/npm/docsify@4/lib/docsify.min.js"></script>
+    <script src="https://cdn.jsdelivr.net/npm/docsify@4/lib/plugins/search.min.js"></script>
+    <!-- Prism Syntax Highlighting -->
+    <script src="https://cdnjs.cloudflare.com/ajax/libs/prism/1.29.0/prism.min.js"></script>
+    <script src="https://cdnjs.cloudflare.com/ajax/libs/prism/1.29.0/plugins/toolbar/prism-toolbar.min.js"></script>
+    <script src="https://cdnjs.cloudflare.com/ajax/libs/prism/1.29.0/plugins/copy-to-clipboard/prism-copy-to-clipboard.min.js"></script>
+    <!-- Emoji plugin -->
+    <script src="https://cdn.jsdelivr.net/npm/docsify/lib/plugins/emoji.min.js"></script>
+    <!-- Zoom image plugin -->
+    <script src="https://cdn.jsdelivr.net/npm/docsify/lib/plugins/zoom-image.min.js"></script>
+  </body>
+</html>

package/docs/theme.css

@@ -0,0 +1,99 @@
+/* ------------------------------
+   LIGHT THEME (default)
+------------------------------ */
+:root {
+  --bg-color: #ffffff;
+  --text-color: #1a1a1a;
+  --link-color: #1e88e5;
+  --sidebar-bg: #f5f5f5;
+  --sidebar-text: #333333;
+  --accent: #3ddc84;
+}
+
+/* ------------------------------
+   DARK THEME
+------------------------------ */
+[data-theme="dark"] {
+  --bg-color: #121212;
+  --text-color: #e0e0e0;
+  --link-color: #64b5f6;
+  --sidebar-bg: #1e1e1e;
+  --sidebar-text: #cccccc;
+  --accent: #3ddc84;
+}
+
+/* ------------------------------
+   Apply Variables
+------------------------------ */
+html,
+body {
+  background: var(--bg-color);
+  color: var(--text-color);
+  transition:
+    background-color 0.35s ease,
+    color 0.35s ease;
+}
+
+.sidebar {
+  background: var(--sidebar-bg);
+  color: var(--sidebar-text);
+}
+
+.sidebar a {
+  color: var(--sidebar-text);
+}
+
+a {
+  color: var(--link-color);
+}
+
+.markdown-section h1,
+.markdown-section h2,
+.markdown-section h3 {
+  color: var(--accent);
+}
+
+/* Toggle Button */
+#theme-toggle {
+  position: fixed;
+  top: 15px;
+  right: 20px;
+  background: var(--accent);
+  color: #000;
+  padding: 6px 12px;
+  border-radius: 6px;
+  cursor: pointer;
+  font-size: 14px;
+  z-index: 999;
+  user-select: none;
+}
+/* Customize Prism copy button */
+.prism-toolbar {
+  background: rgba(0, 0, 0, 0.8);
+  border-radius: 4px;
+}
+
+.prism-toolbar-item button {
+  background: #007bff;
+  color: white;
+  border: none;
+  padding: 8px 12px;
+  border-radius: 3px;
+  cursor: pointer;
+  font-size: 12px;
+}
+
+.prism-toolbar-item button:hover {
+  background: #0056b3;
+}
+
+/* Code block styling */
+pre {
+  border-radius: 6px;
+  border: 1px solid #e0e0e0;
+  background: #f5f5f5;
+}
+
+code {
+  font-family: "Courier New", monospace;
+}

package/example/bin/example.dart

@@ -0,0 +1,15 @@
+import 'package:avd_manager/avd_utils.dart';
+import 'package:avd_manager/commands/list.dart' hide getAvailableAvds;
+
+Future<void> main() async {
+  //list available AVDs with their sizes
+  final avdData = await getAvailableAvds();
+  if (avdData.isEmpty) {
+    print('No AVDs found in the system.');
+    return;
+  }
+  for (final avd in await getAvailableAvds()) {
+    final sizeStr = formatSize(avd.sizeBytes);
+    print('AVD: ${avd.name}, Size: ($sizeStr)');
+  }
+}