anvpy 0.1.0

Official CLI for AnvPy to sync and run Python projects on Android.

AnvPy CLI

AnvPy CLI is the official command-line interface for AnvPy (Android Versatile Python), a platform that enables developers to build and run Python applications on Android.

The CLI provides a seamless desktop development workflow by synchronizing your project from your computer to your Android device and launching it directly in the AnvPy application with a single command.

---

Features

• One command project synchronization and execution
• Automatic device discovery on the local network
• Incremental synchronization using file hashing
• Simple setup with automatic connection management

---

Requirements

• Python 3.8 or later
• AnvPy installed on an Android device
• Computer and Android device connected to the same local network (same Wi-Fi network or mobile hotspot)

---

Installation

Install directly from PyPI:

pip install anvpy

---

Quick Start

Navigate to your project directory containing main.py:

cd MyProject

Run the project:

anvpy run

Or specify a project path:

anvpy run --path="C:\Projects\MyProject"

---

Project Structure

AnvPy expects your project to contain a main.py entry point.

Example:

MyProject/
├── main.py
├── assets/
├── images/
├── data/
└── ...

---

How It Works

When you execute:

anvpy run

the CLI automatically:

1. Detects the project directory.
2. Verifies that main.py exists.
3. Connects to the AnvPy application running on your Android device.
4. Synchronizes only the files that have changed.
5. Removes files deleted from the Android project.
6. Launches the synchronized project automatically on the device.

---

Example Output

[ACTION] Connecting to device...
[OK] Connected to 192.168.1.5

[ACTION] Syncing project: MyProject
[OK] Uploaded: main.py
[OK] Uploaded: assets/logo.png
[OK] Deleted: assets/old_logo.png

[OK] Sync complete (Uploaded: 2, Deleted: 1)

[ACTION] Running project: MyProject
[OK] Project started

---

Why AnvPy CLI?

Developing for Android often involves repetitive deployment steps such as manually copying project files, connecting a USB cable, configuring ADB, or setting up custom synchronization workflows before every test.

AnvPy CLI eliminates these repetitive tasks by automatically discovering your Android device, synchronizing only modified files, and launching your project with a single command over your local network. This significantly reduces iteration time, allowing you to focus on building your application instead of managing deployment.

---

License

This project is licensed under the MIT License.