anvpy 0.1.0__py3-none-any.whl

anvpy/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.1.0"

anvpy/connection.py

@@ -0,0 +1,135 @@
+import requests
+import json
+import socket
+import threading
+import os
+
+from anvpy.logger import *
+
+
+CONFIG_DIR = os.path.join(
+    os.path.expanduser("~"),
+    ".anvpy"
+)
+
+CONFIG_FILE = os.path.join(
+    CONFIG_DIR,
+    "connection.json"
+)
+
+def get_ip():
+
+    try:
+        with open(CONFIG_FILE) as f:
+            data = json.load(f)
+
+        return data.get("ip")
+
+    except:
+        return None
+
+def save_ip(ip):
+
+    os.makedirs(
+        CONFIG_DIR,
+        exist_ok=True
+    )
+
+    with open(CONFIG_FILE, "w") as f:
+        json.dump({
+            "ip": ip
+        }, f)
+
+def is_phone(ip):
+
+    try:
+        r = requests.get(
+            f"http://{ip}:5000/ping",
+            timeout=1
+        )
+
+        data = r.json()
+
+        return (
+            data.get("status") == "ok" and
+            data.get("service") == "anvpy"
+        )
+
+    except:
+        return False
+
+def scan_network():
+
+    local_ip = socket.gethostbyname(
+        socket.gethostname()
+    )
+
+    subnet = ".".join(
+        local_ip.split(".")[:-1]
+    )
+
+    found_ip = None
+
+    def check(ip):
+        nonlocal found_ip
+
+        if found_ip:
+            return
+
+        if is_phone(ip):
+            found_ip = ip
+
+    threads = []
+
+    for i in range(1, 255):
+
+        ip = f"{subnet}.{i}"
+
+        t = threading.Thread(
+            target=check,
+            args=(ip,)
+        )
+
+        t.start()
+        threads.append(t)
+
+    for t in threads:
+        t.join()
+
+    return found_ip
+
+def connect(ip=None, verbose=True):
+
+    if ip is None:
+        ip = get_ip()
+
+    if ip and is_phone(ip):
+
+        save_ip(ip)
+
+        if verbose:
+            log_ok(f"Connected to {ip}")
+
+        return ip
+
+
+    if ip:
+        log_warn(
+            f"Saved IP {ip} unavailable"
+        )
+
+    log_action("Searching for device...")
+
+    found_ip = scan_network()
+
+    if found_ip:
+
+        save_ip(found_ip)
+
+        log_ok(f"Connected to {found_ip}")
+
+        return found_ip
+
+    log_error("No device found")
+
+    return None

anvpy/logger.py

@@ -0,0 +1,27 @@
+class Color:
+    RESET = "\033[0m"
+    BLUE = "\033[94m"
+    GREEN = "\033[38;5;46m"
+    YELLOW = "\033[93m"
+    RED = "\033[91m"
+    CYAN = "\033[96m"
+
+
+def log_info(msg):
+    print(f"{Color.BLUE}[INFO]{Color.RESET} {msg}")
+
+
+def log_ok(msg):
+    print(f"{Color.GREEN}[OK]{Color.RESET} {msg}")
+
+
+def log_warn(msg):
+    print(f"{Color.YELLOW}[WARN]{Color.RESET} {msg}")
+
+
+def log_error(msg):
+    print(f"{Color.RED}[ERROR]{Color.RESET} {msg}")
+
+
+def log_action(msg):
+    print(f"{Color.CYAN}[ACTION]{Color.RESET} {msg}")

anvpy/main.py

@@ -0,0 +1,47 @@
+import argparse
+import os
+from anvpy.sync import sync
+from anvpy.logger import *
+
+
+def main():
+
+    parser = argparse.ArgumentParser()
+    parser.add_argument(
+        "command",
+        choices=["run"]
+    )
+    parser.add_argument("--path")
+
+    args = parser.parse_args()
+
+    if args.path:
+        project_path = args.path
+    else:
+        project_path = os.getcwd()
+
+
+    if args.command == "run":
+
+        if not os.path.isdir(project_path):
+
+            log_error(
+                f'Project folder not found: "{project_path}"'
+            )
+
+            return
+
+        main_file = os.path.join(
+            project_path,
+            "main.py"
+        )
+
+        if not os.path.isfile(main_file):
+
+            log_error(
+                "main.py not found"
+            )
+
+            return
+
+        sync(project_path)

anvpy/run.py

@@ -0,0 +1,42 @@
+import requests
+from anvpy.logger import *
+
+def run_project(ip, project):
+
+    try:
+
+        log_action(
+            f"Running project: {project}"
+        )
+
+        response = requests.post(
+            f"http://{ip}:5000/run",
+            json={
+                "project": project
+            },
+            timeout=10
+        )
+
+        data = response.json()
+
+        if response.status_code != 200:
+
+            log_error(
+                f"Failed to run project: {project}"
+            )
+
+            return None
+
+        log_ok(
+            f"Project started: {project}"
+        )
+
+        return data
+
+    except Exception:
+
+        log_error(
+            f"Failed to contact device"
+        )
+
+        return None

anvpy/sync.py

@@ -0,0 +1,228 @@
+import requests
+import os
+
+from anvpy.logger import *
+from anvpy.utils import *
+from anvpy.connection import *
+from anvpy.run import *
+
+def compute_diff(local_state, phone_state):
+
+    to_upload = []
+    to_delete = []
+
+    for path, hash_value in local_state.items():
+
+        if path not in phone_state:
+            to_upload.append(path)
+
+        elif phone_state[path] != hash_value:
+            to_upload.append(path)
+
+    for path in phone_state:
+
+        if path not in local_state:
+            to_delete.append(path)
+
+    return to_upload, to_delete
+
+def delete_files(ip, project, files):
+
+    try:
+
+        response = requests.post(
+            f"http://{ip}:5000/delete",
+            json={
+                "project": project,
+                "files": files
+            },
+            timeout=10
+        )
+
+        if response.status_code != 200:
+            return False
+
+        return True
+
+    except Exception:
+
+        return False
+
+def get_phone_state(ip, project):
+
+    try:
+        response = requests.get(
+            f"http://{ip}:5000/file_state",
+            params={
+                "project": project
+            },
+            timeout=5
+        )
+
+        if response.status_code != 200:
+
+            log_error("Failed to get phone state")
+
+            return None
+
+        return response.json()
+
+    except Exception as e:
+
+        log_error("Failed to get phone state")
+
+        return None
+
+def upload_file(ip, project, folder, rel_path):
+
+    full_path = os.path.join(
+        folder,
+        rel_path
+    )
+
+    try:
+
+        with open(full_path, "rb") as f:
+
+            files = {
+                "file": f
+            }
+
+            data = {
+                "project": project,
+                "path": rel_path
+            }
+
+            response = requests.post(
+                f"http://{ip}:5000/upload",
+                files=files,
+                data=data,
+                timeout=30
+            )
+
+            data = response.json()
+
+            if response.status_code != 200:
+
+                log_error(
+                    f"Upload failed: {rel_path}"
+                )
+
+                return None
+
+            return data
+
+    except Exception:
+
+        log_error(
+            f"Failed: {rel_path}"
+        )
+
+        return None
+
+def scan_files(folder):
+
+    files = {}
+
+    for root, dirs, filenames in os.walk(folder):
+
+        for filename in filenames:
+
+            full_path = os.path.join(root, filename)
+
+            rel_path = os.path.relpath(
+                full_path,
+                folder
+            ).replace("\\", "/")
+
+            files[rel_path] = get_file_hash(
+                full_path
+            )
+
+    return files
+
+def sync(folder, run_after=True):
+
+    ip = connect(verbose=False)
+
+    if not ip:
+        log_error("Phone not found")
+        return
+
+    project = os.path.basename(
+        os.path.abspath(folder)
+    )
+
+    log_action(
+        f"Syncing project: {project}"
+    )
+
+    local_state = scan_files(folder)
+
+    phone_state = get_phone_state(
+        ip,
+        project
+    )
+
+    if phone_state is None:
+        log_error("Connection lost")
+        return
+
+    to_upload, to_delete = compute_diff(
+    local_state,
+    phone_state
+    )
+
+    if to_upload:
+
+        log_action(
+            f"Uploading {len(to_upload)} files"
+        )
+
+    if to_delete:
+
+        log_action(
+            f"Deleting {len(to_delete)} files"
+        )
+
+    for file in to_upload:
+
+        result = upload_file(
+            ip,
+            project,
+            folder,
+            file
+        )
+
+        if result:
+            log_ok(f"Uploaded: {file}")
+
+    if to_delete:
+
+        result = delete_files(
+            ip,
+            project,
+            to_delete
+        )
+
+        if result:
+
+            for file in to_delete:
+                log_ok(f"Deleted: {file}")
+
+        else:
+
+            log_error("Delete failed")
+
+    log_ok(
+        f"Sync complete "
+        f"(Uploaded: {len(to_upload)}, "
+        f"Deleted: {len(to_delete)})"
+    )
+
+    if run_after:
+
+        run_project(
+            ip,
+            project
+        )

anvpy/utils.py

@@ -0,0 +1,15 @@
+import hashlib
+
+def get_file_hash(path):
+
+    md5 = hashlib.md5()
+
+    with open(path, "rb") as f:
+
+        for chunk in iter(
+            lambda: f.read(4096),
+            b""
+        ):
+            md5.update(chunk)
+
+    return md5.hexdigest()

anvpy-0.1.0.dist-info/METADATA

@@ -0,0 +1,154 @@
+Metadata-Version: 2.4
+Name: anvpy
+Version: 0.1.0
+Summary: Official CLI for AnvPy to sync and run Python projects on Android.
+Author-email: Amar <techanvpy@gmail.com>, Ajay <ajay@vissora.cloud>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/anvlabs/anvpy-cli
+Project-URL: Repository, https://github.com/anvlabs/anvpy-cli
+Project-URL: Issues, https://github.com/anvlabs/anvpy-cli/issues
+Keywords: python,android,cli,development,sync
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Software Development
+Classifier: Topic :: Software Development :: Build Tools
+Classifier: Topic :: Utilities
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests
+Dynamic: license-file
+
+# 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:
+
+```bash
+pip install anvpy
+```
+
+---
+
+# Quick Start
+
+Navigate to your project directory containing `main.py`:
+
+```bash
+cd MyProject
+```
+
+Run the project:
+
+```bash
+anvpy run
+```
+
+Or specify a project path:
+
+```bash
+anvpy run --path="C:\Projects\MyProject"
+```
+
+---
+
+# Project Structure
+
+AnvPy expects your project to contain a `main.py` entry point.
+
+Example:
+
+```text
+MyProject/
+├── main.py
+├── assets/
+├── images/
+├── data/
+└── ...
+```
+
+---
+
+# How It Works
+
+When you execute:
+
+```bash
+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
+
+```text
+[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.

anvpy-0.1.0.dist-info/RECORD

@@ -0,0 +1,13 @@
+anvpy/__init__.py,sha256=Pru0BlFBASFCFo7McHdohtKkUtgMPDwbGfyUZlE2_Vw,21
+anvpy/connection.py,sha256=_-vw-T3REG9okI3iCFmeKDBFUMsSK-kN0RO5JXtPChA,2127
+anvpy/logger.py,sha256=F6U9bqqjPYmTOdtITiujkkBDgKe8GKeoNAv6EgKpqpc,546
+anvpy/main.py,sha256=uGs-YsL_MotQ-v4V3lx3pH01xnj28ILBgrDYveyilj0,874
+anvpy/run.py,sha256=XNo1ANG1WDtrHK1Sz8naITA7ujHJSxQs1-RHkcePF98,763
+anvpy/sync.py,sha256=5GN-_xDMNj5pkmD9GWXYy57Sfx-D5cABzOUN-gJojQs,4334
+anvpy/utils.py,sha256=OD3T2_pHz90xcxToF08sc6Cfkkt0t7LkILaS1Qd7ogw,259
+anvpy-0.1.0.dist-info/licenses/LICENSE,sha256=9C4JyfykmY3LdxHV3QH4XZlcKHKpegmC4TCZ5kbUo84,1082
+anvpy-0.1.0.dist-info/METADATA,sha256=YrOZIPf4y1xCose2bF6s8rovdEoEEWw2SsDV8W9qxtA,4116
+anvpy-0.1.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+anvpy-0.1.0.dist-info/entry_points.txt,sha256=v0dCxD2yPDNPYb_bz8kJN9ZZ_Jp3MA71ODAVNQd_aeg,42
+anvpy-0.1.0.dist-info/top_level.txt,sha256=RY7GZCA1P3HI5-szpXn7TxQroQEqlA7tCoDcRxZPOOQ,6
+anvpy-0.1.0.dist-info/RECORD,,

anvpy-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

anvpy-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+anvpy = anvpy.main:main

anvpy-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,9 @@
+MIT License
+
+Copyright (c) 2026 Ajay, Amar
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

anvpy-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+anvpy