CasaOS-CLI

command module
v0.4.2 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Feb 21, 2023 License: Apache-2.0 Imports: 1 Imported by: 0

README

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]

Available Commands:
  completion    Generate the autocompletion script for the specified shell
  help          Help about any command
  local-storage All local storage related commands
  message-bus   All message bus related commands
  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.

Documentation

Overview

Copyright © 2022 IceWhaleTech

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

Directories

Path Synopsis

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL