A production-grade Python tool for migrating Ansible Automation Platform (AAP) installations from one version to another, designed to handle large-scale migrations (e.g., 80,000+ hosts)

Features

Bulk Operations : Leverages AAP bulk APIs for high-performance migrations

State Management : PostgreSQL-backed state tracking with checkpoint/resume capability

Idempotency : Safely resume interrupted migrations without creating duplicates

Professional Progress Display : Rich-based live progress display with real-time metrics (rate, success/fail counts, timing)

Flexible Output Modes : Normal, quiet, CI/CD, and detailed modes for different environments

Comprehensive Logging : Structured logging with separate console (WARNING) and file (DEBUG) levels

Split-File Export/Import : Automatic file splitting for large datasets with metadata tracking

CLI Interface : Intuitive Click-based CLI with extensive options and environment variable support

Architecture

The tool is organized into several key components:

Client…