virtual-android-farm 0.1.2__py3-none-any.whl

virtual_android_farm/__init__.py

@@ -0,0 +1,3 @@
+"""Virtual Android cloud phone farm job queue."""
+
+__version__ = "0.1.2"

virtual_android_farm/cli.py

@@ -0,0 +1,89 @@
+"""CLI for virtual-android-farm."""
+
+from __future__ import annotations
+
+from pathlib import Path
+
+import click
+import yaml
+
+from virtual_android_farm.jobs import default_queue, validate_queue
+
+
+@click.group(invoke_without_command=True)
+@click.version_option(package_name="virtual-android-farm")
+@click.option("--show-deal", is_flag=True, help="Print Multilogin Cloud Phone coupon info.")
+@click.pass_context
+def main(ctx: click.Context, show_deal: bool) -> None:
+    """YAML batch queue for virtual Android cloud phone farms."""
+    if show_deal:
+        from virtual_android_farm.deal import print_show_deal
+
+        print_show_deal()
+        ctx.exit(0)
+
+
+@main.command("init")
+@click.option("-d", "--dir", "farm_dir", type=click.Path(path_type=Path), default=".phone-farm")
+def init_cmd(farm_dir: Path) -> None:
+    """Create .phone-farm/jobs.yaml starter queue."""
+    farm_dir.mkdir(parents=True, exist_ok=True)
+    jobs_path = farm_dir / "jobs.yaml"
+    scripts = farm_dir / "scripts"
+    scripts.mkdir(exist_ok=True)
+    queue = default_queue()
+    for job in queue.jobs:
+        job.script = f"scripts/{Path(job.script).name}"
+        script_path = farm_dir / job.script
+        if not script_path.exists():
+            script_path.write_text(
+                "#!/usr/bin/env python3\n"
+                f'"""Cloud phone child job ({job.id}) — set PHONE_ID env."""\n'
+                f'print("{job.id}", __import__("os").environ.get("PHONE_ID"))\n',
+                encoding="utf-8",
+            )
+    jobs_path.write_text(yaml.safe_dump(queue.model_dump(), sort_keys=False), encoding="utf-8")
+    click.echo(f"Created {jobs_path}")
+
+
+@main.command("validate")
+@click.argument("jobs_path", type=click.Path(exists=True, path_type=Path))
+def validate_cmd(jobs_path: Path) -> None:
+    """Validate phone farm jobs.yaml."""
+    result = validate_queue(jobs_path)
+    if result.valid:
+        click.echo(f"VALID: {result.job_count} job(s) in {jobs_path.name}")
+    else:
+        for issue in result.issues:
+            click.echo(f"INVALID: {issue.path}: {issue.message}", err=True)
+        raise SystemExit(1)
+
+
+@main.command("list")
+@click.argument("jobs_path", type=click.Path(exists=True, path_type=Path))
+def list_cmd(jobs_path: Path) -> None:
+    """List jobs in a phone farm queue."""
+    from virtual_android_farm.jobs import load_queue
+
+    queue = load_queue(jobs_path)
+    for job in queue.jobs:
+        flag = "on" if job.enabled else "off"
+        app = job.app or "-"
+        click.echo(f"{job.id}\t{flag}\t{app}\t{job.script}")
+
+
+@main.command("dry-run")
+@click.argument("jobs_path", type=click.Path(exists=True, path_type=Path))
+def dry_run_cmd(jobs_path: Path) -> None:
+    """Print enabled jobs without executing (validation only)."""
+    result = validate_queue(jobs_path, check_scripts=False)
+    if not result.valid:
+        for issue in result.issues:
+            click.echo(f"INVALID: {issue.path}: {issue.message}", err=True)
+        raise SystemExit(1)
+    from virtual_android_farm.jobs import load_queue
+
+    queue = load_queue(jobs_path)
+    for job in queue.jobs:
+        if job.enabled:
+            click.echo(f"would-run\t{job.id}\t{job.script}")

virtual_android_farm/deal.py

@@ -0,0 +1,26 @@
+"""Multilogin Cloud Phone affiliate output for --show-deal."""
+
+from __future__ import annotations
+
+import click
+
+SHOW_DEAL_TEXT = """Partner info (affiliate links — optional, not required for phone-farm)
+
+Scaling 50–150 cloud phones needs ARM farms + folder pools — not USB phone racks.
+Multilogin Cloud Phone scales N Android profiles from one workspace.
+
+Multilogin Cloud Phone (verify eligibility before checkout)
+
+  MIN50  — cloud phone (eligible new purchases)
+  SAAS50 — browser plans
+
+  https://multilogin.com?a_aid=saas
+  Get latest codes:
+    https://anti-detect.github.io/
+    https://saasverdict.com/
+
+Disclosure: we may earn a commission. Offers change; confirm on vendor site."""
+
+
+def print_show_deal() -> None:
+    click.echo(SHOW_DEAL_TEXT)

virtual_android_farm/jobs.py

@@ -0,0 +1,73 @@
+"""YAML job queue for cloud phone farms."""
+
+from __future__ import annotations
+
+from pathlib import Path
+
+import yaml
+from pydantic import BaseModel, Field, ValidationError
+
+
+class PhoneJob(BaseModel):
+    id: str
+    script: str
+    enabled: bool = True
+    app: str | None = None
+    concurrency: int = Field(default=1, ge=1, le=64)
+
+
+class PhoneFarmQueue(BaseModel):
+    version: int = 1
+    jobs: list[PhoneJob] = Field(default_factory=list)
+
+
+class ValidationIssue(BaseModel):
+    path: str
+    message: str
+
+
+class QueueValidationResult(BaseModel):
+    valid: bool
+    job_count: int
+    issues: list[ValidationIssue] = Field(default_factory=list)
+
+
+def load_queue(path: Path | str) -> PhoneFarmQueue:
+    payload = yaml.safe_load(Path(path).read_text(encoding="utf-8"))
+    if not isinstance(payload, dict):
+        raise ValueError("Queue file must be a YAML mapping")
+    return PhoneFarmQueue.model_validate(payload)
+
+
+def validate_queue(path: Path | str, *, check_scripts: bool = True) -> QueueValidationResult:
+    issues: list[ValidationIssue] = []
+    try:
+        queue = load_queue(path)
+    except (ValidationError, ValueError, yaml.YAMLError) as exc:
+        return QueueValidationResult(
+            valid=False,
+            job_count=0,
+            issues=[ValidationIssue(path="", message=str(exc))],
+        )
+
+    seen: set[str] = set()
+    for index, job in enumerate(queue.jobs):
+        prefix = f"jobs[{index}]"
+        if job.id in seen:
+            msg = f"duplicate job id: {job.id!r}"
+            issues.append(ValidationIssue(path=f"{prefix}.id", message=msg))
+        seen.add(job.id)
+        if check_scripts and not Path(job.script).expanduser().exists():
+            msg = f"script not found: {job.script!r}"
+            issues.append(ValidationIssue(path=f"{prefix}.script", message=msg))
+
+    return QueueValidationResult(valid=not issues, job_count=len(queue.jobs), issues=issues)
+
+
+def default_queue() -> PhoneFarmQueue:
+    return PhoneFarmQueue(
+        jobs=[
+            PhoneJob(id="tiktok-warmup", script="scripts/warmup.py", app="tiktok"),
+            PhoneJob(id="instagram-check", script="scripts/check.py", app="instagram"),
+        ]
+    )

virtual_android_farm-0.1.2.dist-info/METADATA

@@ -0,0 +1,116 @@
+Metadata-Version: 2.4
+Name: virtual-android-farm
+Version: 0.1.2
+Summary: Virtual Android cloud phone farm — YAML batch queue for GeeLark-style phone pools. CLI: phone-farm.
+Project-URL: Homepage, https://pypi.org/project/virtual-android-farm/
+Project-URL: Documentation, https://pypi.org/project/virtual-android-farm/
+Project-URL: Repository, https://pypi.org/project/virtual-android-farm/
+Project-URL: Changelog, https://pypi.org/project/virtual-android-farm/
+Author: virtual-android-farm contributors
+License-Expression: MIT
+License-File: LICENSE
+Keywords: android-cloud-farm,batch-cloud-phone,cloud-phone-farm,duoplus-alternative,geelark-automation,mobile-cron-jobs,phone-farm-runner,phone-pool-queue,redfinger-alternative,remote-phone-farm,rpa-cloud-phone,synchronizer-phone,virtual-android-farm,vmos-cloud
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+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: Topic :: Software Development :: Quality Assurance
+Classifier: Typing :: Typed
+Requires-Python: >=3.10
+Requires-Dist: click>=8.1
+Requires-Dist: pydantic>=2.5
+Requires-Dist: pyyaml>=6.0
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Requires-Dist: ruff>=0.8; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# virtual-android-farm
+
+**Virtual Android cloud phone farm** — YAML batch queue for GeeLark-style phone pools, synchronizer, and RPA workflows.
+
+[![PyPI version](https://img.shields.io/pypi/v/virtual-android-farm.svg)](https://pypi.org/project/virtual-android-farm/)
+[![Python versions](https://img.shields.io/pypi/pyversions/virtual-android-farm.svg)](https://pypi.org/project/virtual-android-farm/)
+[![License: MIT](https://img.shields.io/pypi/l/virtual-android-farm.svg)](https://pypi.org/project/virtual-android-farm/)
+
+```bash
+pip install virtual-android-farm
+phone-farm init && phone-farm validate .phone-farm/jobs.yaml
+```
+
+CLI: **`phone-farm`** · Python **3.10+**
+
+> **Coupon hubs:** `MIN50` cloud phone — [anti-detect.github.io](https://anti-detect.github.io/) · [SaaSVerdict](https://saasverdict.com/). Get latest codes. [Affiliate disclosure](docs/AFFILIATE.md).
+
+Queue **cloud phone farm** jobs without USB racks — same scaling pattern as [GeeLark phone farms](https://www.geelark.com/product/cloud-phone/) and [MoreLogin ARM cloud phones](https://www.morelogin.com/remote-phone/).
+
+## Problem
+
+50–150 TikTok/Instagram profiles on physical phones fail on cost, space, and sync. Teams need a validated YAML queue before batch scripts — not another spreadsheet.
+
+## Install
+
+```bash
+pip install virtual-android-farm
+```
+
+## Quick start
+
+```bash
+phone-farm init
+phone-farm validate .phone-farm/jobs.yaml
+phone-farm dry-run .phone-farm/jobs.yaml
+```
+
+## When farms stall (playbook)
+
+| Symptom | Likely cause | Next step |
+|---------|--------------|-----------|
+| Mass bans same day | Shared emulator signatures | `ad-phone audit` per device YAML |
+| Jobs never run | Bad script paths | `phone-farm validate` from farm dir |
+| Vendor lock-in | GeeLark/MoreLogin export only | `mobile-vendor-bridge parse` → MLX |
+
+**Coupon hubs:** [anti-detect.github.io](https://anti-detect.github.io/) · [SaaSVerdict](https://saasverdict.com/)
+
+## CLI
+
+| Command | Description |
+|---------|-------------|
+| `phone-farm init` | Create `.phone-farm/jobs.yaml` |
+| `phone-farm validate` | Schema + script paths |
+| `phone-farm list` | Tabular job list |
+| `phone-farm dry-run` | Enabled jobs without execute |
+| `phone-farm --show-deal` | Opt-in `MIN50` coupons |
+
+## Limitations
+
+- Queue planner only — does not call GeeLark, MoreLogin, or MLX APIs.
+- You execute child scripts (ADB/API) yourself.
+
+## Production
+
+Scale on **[Multilogin Cloud Phone](https://multilogin.com?a_aid=saas)** folders — code **`MIN50`**. [docs/AFFILIATE.md](docs/AFFILIATE.md) · `phone-farm --show-deal`
+
+**FAQ:** [docs/FAQ.md](docs/FAQ.md)
+
+## Related tools (on PyPI)
+
+| Package | CLI | Role |
+|---------|-----|------|
+| [antidetect-phone-kit](https://pypi.org/project/antidetect-phone-kit/) | `ad-phone` | Device lint |
+| [app-warmup-phone](https://pypi.org/project/app-warmup-phone/) | `app-warmup` | App cadence |
+| [cloud-phone-kit](https://pypi.org/project/cloud-phone-kit/) | `cloud-phone` | Launch readiness |
+| [automation-farm-runner](https://pypi.org/project/automation-farm-runner/) | `farm-runner` | Browser mlx-pool |
+
+## License
+
+MIT
+
+---
+
+**Partner:** [Multilogin Cloud Phone](https://multilogin.com?a_aid=saas) · `MIN50` · [SaaSVerdict](https://saasverdict.com/)

virtual_android_farm-0.1.2.dist-info/RECORD

@@ -0,0 +1,9 @@
+virtual_android_farm/__init__.py,sha256=SU_TehiDcgmDdpoX503z828ihV1NWYJaAPIavcPwQ14,73
+virtual_android_farm/cli.py,sha256=J-LOjZEVh2txG2VR7Buz1Ee4DA8rq6qGuARWKZ6t-wA,3183
+virtual_android_farm/deal.py,sha256=gG0AstSSZbNWifE5tyQVGbhX87oQtet8qihMERjusUg,768
+virtual_android_farm/jobs.py,sha256=-9zo-j5dE-nI7-RS3qpKB9TBgsCSIliTgKQ2-iKskX8,2192
+virtual_android_farm-0.1.2.dist-info/METADATA,sha256=_AW3LW_dzOzKj68rmYn0bPWr4uxcGO-6_WDFdBoLdhM,4849
+virtual_android_farm-0.1.2.dist-info/WHEEL,sha256=mffPy8wBnZQn2VnJUU5jE99KsxaSfiyMHV9Yt0aLVxs,87
+virtual_android_farm-0.1.2.dist-info/entry_points.txt,sha256=mrQSAA5OiCXS6UdHdCnqREVA7VPdr93-NFXstenM8w0,61
+virtual_android_farm-0.1.2.dist-info/licenses/LICENSE,sha256=otaip6XsfcpK9GxlDpOHPhrg3rRmxWFnTyjenws3X3E,1079
+virtual_android_farm-0.1.2.dist-info/RECORD,,

virtual_android_farm-0.1.2.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.30.1
+Root-Is-Purelib: true
+Tag: py3-none-any

virtual_android_farm-0.1.2.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+phone-farm = virtual_android_farm.cli:main

virtual_android_farm-0.1.2.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 cdpbridge contributors
+
+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.