Dragon Controller (dractl) Usage Guide

dractl, also known as Dragon Controller, is a command-line interface (CLI) designed to help you manage various tasks related to Dragon Den applications and components.

Installation

To use dractl, you can install it globally using npm:

npm install -g dractl

Alternatively, you can use npx to run dractl without installing it globally:

npx dractl <command> [options]

Running Dragon Controller

Once installed globally, you can run dractl directly from your terminal:

dractl <command> [options]

Basic Command Structure

dractl commands follow a hierarchical structure. The primary command is package, which groups several related subcommands for managing application packages.

dractl package <subcommand> [options]

Available Commands

dractl package list

Lists all supported external packages that Dragon Controller can manage. These are typically tools or components that Dragon Den applications might utilize.

dractl package list

dractl package publish

Uploads a package to a public npm registry. This command is specifically designed to publish large application files by intelligently splitting them into smaller, manageable npm packages.

dractl package publish --package-name <name> --package-version <version> --package-file <path/to/local/file>
# Or publish a file directly from a URL:
dractl package publish --package-name <name> --package-version <version> --package-url <url/to/remote/file>

dractl package search

Searches for available packages using a regex term.

dractl package search <term>

dractl package download

Downloads a package (previously published using dractl package publish) and reassembles it into its original form.

dractl package download <package-name> --package-version <version> --target <output/directory>

dractl package verify

Verifies the integrity and availability of a published package on the npm registry. This ensures that all parts of a split package are correctly published and accessible.

dractl package verify --package-name <name> --package-version <version>

dractl package publishAll

Publishes all predefined supported packages that Dragon Controller is configured to manage. This is useful for automated release processes.

dractl package publishAll

Global Options

• -d, --debug: Enables verbose logging for debugging purposes.

dractl -d package list