A command-line interface for Perseus APK version management system. Heleus provides a simple way to manage APK versions, similar to how Git manages source code versions.

• Push APKs to the repository with progress tracking
• Pull specific APKs or entire version bundles
• Freeze versions for release
• List versions, apps, and their details
• Configure server settings
• Progress bars for all file operations
• Persistent server configuration

# Clone the repository
git clone https://github.com/yourusername/heleus.git
cd heleus

# Install using Poetry
poetry install

# Run commands through Poetry
poetry run heleus --help

# Or activate the Poetry shell and run directly
poetry shell
heleus --help

pip install heleus

Heleus stores its configuration in ~/.heleus/config.json. You can configure the server settings using the CLI:

# Set server configuration
heleus config server <host> <port>

# View current configuration
heleus config show

Upload an APK to the repository:

heleus push path/to/your.apk

The command shows a progress bar during upload and returns the upload status.

Pull the latest frozen version of all APKs:

heleus pull

Pull a specific version of all APKs:

heleus pull --version v1.0.0

Pull a specific app (latest version):

heleus pull app_name

Pull a specific app and version:

heleus pull app_name v1.0.0

All pull operations show progress bars for download and extraction.

List all frozen versions:

heleus list versions

List all apps with their latest versions:

heleus list apps

List all apps with their complete version history:

heleus list all

Create a frozen version for release:

heleus freeze v1.0.0

heleus
  config
    server <host> <port>  Configure server connection
    show                  Display current configuration
  list
    versions             List all frozen versions
    apps                 List apps with latest versions
    all                  List all apps with full history
  push <apk_path>        Upload an APK
  pull [app] [version]   Download APK(s)
  freeze <version>       Create a frozen version

To contribute to Heleus:

1. Fork the repository
2. Create a feature branch
3. Install development dependencies:

   poetry install

4. Make your changes
5. Run tests:

   poetry run pytest

6. Submit a pull request

MIT License