anvpy 0.1.2

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

AnvPy CLI

Official command line toolkit for AnvPy development.

pip install anvpy

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 X 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

License

This project is licensed under the MIT License.