Skip to content

A command-line tool to interact with CasaOS for testing and diagnosing purpose

License

Notifications You must be signed in to change notification settings

IceWhaleTech/CasaOS-CLI

Repository files navigation

CasaOS-CLI

Go Reference Go Report Card goreleaser codecov

A command-line tool to interact with CasaOS for testing and diagnosing purpose

Usage

A command line interface for CasaOS

Usage:
  casaos-cli [command]

Services
  app-management All compose app management and store related commands
  local-storage  All local storage related commands
  message-bus    All message bus related commands

Additional Commands:
  completion     Generate the autocompletion script for the specified shell
  help           Help about any command
  version        Show version

Flags:
  -h, --help              help for casaos-cli
  -u, --root-url string   root url of CasaOS API (default "localhost:80")

Additional help topics:
  casaos-cli gateway        All gateway related commands
  casaos-cli user           All user related commands

Use "casaos-cli [command] --help" for more information about a command.

Contributing

Use https://github.com/spf13/cobra-cli to add any new command.

Follow example steps below to add commands like casaos-cli message-bus list event-types

  1. create command scaffold with cobra-cli add:

    go run github.com/spf13/cobra-cli@latest add messageBus --config .cobra.yaml
    go run github.com/spf13/cobra-cli@latest add messageBusList -p messageBusCmd --config .cobra.yaml
    go run github.com/spf13/cobra-cli@latest add messageBusListEventTypes -p messageBusListCmd --config .cobra.yaml

    It is important to include --config .cobra.yaml to attribute the scaffold code with correct license header.

  2. update each messageBus*.go file with correct command format:

    // messageBus.go
    Use:   "messageBus",
    // messageBusList.go
    Use:   "messageBusList",
    // messageBusListEventTypes.go
    Use:   "messageBusListEventTypes",

    becomes

    // messageBus.go
    Use:   "message-bus",
    // messageBusList.go
    Use:   "list",
    // messageBusListEventTypes.go
    Use:   "event-types",
  3. update short and long description for each command, and implement the logics

  4. to verify the commands are created correctly, run

    $ go run main.go message-bus list event-types --help
    list event types
    
    Usage:
    CasaOS-CLI message-bus list event-types [flags]
    
    Flags:
    -h, --help   help for event-types

Run go run github.com/spf13/cobra-cli@latest --help to see additional help message.