Class: MelissaData::Command::Base

Inherits:
Thor::Group
  • Object
show all
Includes:
Helpers, Thor::Actions
Defined in:
lib/melissadata/command/base.rb

Overview

A Base is the superclass for all commands which are single commands, e.g. ‘melissadata init`, `melissadata up`. Not commands like `melissadata box add`. For commands which have more subcommands, use a GroupBase.

A Base is a subclass of ‘Thor::Group`, so view the documentation there on how to add arguments, descriptions etc. The important note about this is that when invoked, _all public methods_ will be called in the order they are defined. If you don’t want a method called when the command is invoked, it must be made ‘protected` or `private`.

The best way to get examples of how to create your own command is to view the various MelissaData commands, which are relatively simple, and can be found in the MelissaData source tree at ‘lib/melissadata/command/`.

# Defining a New Command

To define a new single command, create a new class which inherits from this class, then call Base.register to register the command. That’s it! When the command is invoked, _all public methods_ will be called. Below is an example ‘SayHello` class:

class SayHello < MelissaData::Command::Base
  register "hello", "Says hello"

  def hello
    env.ui.info "Hello"
  end
end

In this case, the above class is invokable via ‘melissadata hello`. To give this a try, just copy and paste the above into a MelissaDatafile somewhere. The command will be available for that project!

Also note that the above example uses ‘env.ui` to output. It is recommended you use this instead of raw “puts” since it is configurable and provides additional functionality, such as colors and asking for user input. See the UI class for more information.

## Defining Command-line Options

Most command line actions won’t be as simple as ‘melissadata hello`, and will probably require parameters or switches. Luckily, Thor makes adding these easy:

class SayHello < MelissaData::Command::Base
  register "hello", "Says hello"
  argument :name, :type => :string

  def hello
    env.ui.info "Hello, #{name}"
  end
end

Then, the above can be invoked with ‘melissadata hello Mitchell` which would output “Hello, Mitchell.” If instead you’re looking for switches, such as “–name Mitchell”, then take a look at ‘class_option`, an example of which can be found in the PackageCommand.

Direct Known Subclasses

CompileCommand, PackageCommand

Instance Attribute Summary collapse

Class Method Summary collapse

Methods included from Helpers

#initialize_environment

Instance Attribute Details

#envObject (readonly)

Returns the value of attribute env.



65
66
67
# File 'lib/melissadata/command/base.rb', line 65

def env
  @env
end

Class Method Details

.register(usage, description, opts = nil) ⇒ Object

Register the command with the main MelissaData CLI under the given name. The name will be used for accessing it from the CLI, so if you name it “lamp”, then the command to invoke this will be ‘melissadata lamp`.

The description is used when the help is listed, and is meant to be a brief (one sentence) description of what the command does.

Some additional options may be passed in as the last parameter:

  • ‘:alias` - If given as an array or string, these will be aliases

for the same command. For example, `melissadata version` is also
`melissadata --version` and `melissadata -v`

Parameters:

  • usage (String)
  • description (String)
  • opts (Hash) (defaults to: nil)


84
85
86
87
# File 'lib/melissadata/command/base.rb', line 84

def self.register(usage, description, opts=nil)
  desc description
  CLI.register(self, extract_name_from_usage(usage), usage, desc, opts)
end