Documentation
¶
Index ¶
- Constants
- Variables
- func ClientError(msg string) error
- type ChannelMarshaler
- type Command
- func (c *Command) Call(req Request) Response
- func (c *Command) CheckArguments(req Request) error
- func (c *Command) Get(path []string) (*Command, error)
- func (c *Command) GetOptions(path []string) (map[string]cmdkit.Option, error)
- func (c *Command) ProcessHelp()
- func (c *Command) Resolve(pth []string) ([]*Command, error)
- func (c *Command) Subcommand(id string) *Command
- func (c *Command) Walk(visitor CommandVisitor)
- type CommandVisitor
- type Context
- type EncodingType
- type ErrorType
- type Function
- type Marshaler
- type MarshalerMap
- type ReqLog
- type ReqLogEntry
- type Request
- type Response
Constants ¶
const ( JSON = "json" XML = "xml" Protobuf = "protobuf" Text = "text" )
Supported EncodingType constants.
Variables ¶
var ErrIncorrectType = errors.New("The command returned a value with a different type than expected")
var ErrNoFormatter = ClientError("This command cannot be formatted to plain text")
var ErrNotCallable = ClientError("This command can't be called directly. Try one of its subcommands.")
ErrNotCallable signals a command that cannot be called.
Functions ¶
func ClientError ¶
Types ¶
type ChannelMarshaler ¶
type Command ¶
type Command struct {
Options []cmdkit.Option
Arguments []cmdkit.Argument
PreRun func(req Request) error
// Run is the function that processes the request to generate a response.
// Note that when executing the command over the HTTP API you can only read
// after writing when using multipart requests. The request body will not be
// available for reading after the HTTP connection has been written to.
Run Function
PostRun Function
Marshalers map[EncodingType]Marshaler
Helptext cmdkit.HelpText
// External denotes that a command is actually an external binary.
// fewer checks and validations will be performed on such commands.
External bool
// Type describes the type of the output of the Command's Run Function.
// In precise terms, the value of Type is an instance of the return type of
// the Run Function.
//
// ie. If command Run returns &Block{}, then Command.Type == &Block{}
Type interface{}
Subcommands map[string]*Command
}
Command is a runnable command, with input arguments and options (flags). It can also have Subcommands, to group units of work into sets.
func (*Command) CheckArguments ¶
func (*Command) GetOptions ¶
GetOptions returns the options in the given path of commands
func (*Command) ProcessHelp ¶ added in v0.4.2
func (c *Command) ProcessHelp()
func (*Command) Subcommand ¶
Subcommand returns the subcommand with the given id
func (*Command) Walk ¶ added in v0.4.2
func (c *Command) Walk(visitor CommandVisitor)
Walks tree of all subcommands (including this one)
type CommandVisitor ¶ added in v0.4.2
type CommandVisitor func(*Command)
type Context ¶
type Context struct {
Online bool
ConfigRoot string
ReqLog *ReqLog
LoadConfig func(path string) (*config.Config, error)
ConstructNode func() (*core.IpfsNode, error)
// contains filtered or unexported fields
}
func (*Context) Close ¶ added in v0.4.14
func (c *Context) Close()
Close cleans up the application state.
func (*Context) GetConfig ¶
GetConfig returns the config of the current Command exection context. It may load it with the providied function.
func (*Context) GetNode ¶
GetNode returns the node of the current Command exection context. It may construct it with the provided function.
func (*Context) LogRequest ¶ added in v0.4.14
func (c *Context) LogRequest(req *cmds.Request) func()
LogRequest adds the passed request to the request log and returns a function that should be called when the request lifetime is over.
func (*Context) NodeWithoutConstructing ¶
NodeWithoutConstructing returns the underlying node variable so that clients may close it.
type Function ¶
Function is the type of function that Commands use. It reads from the Request, and writes results to the Response.
type Marshaler ¶
Marshaler is a function that takes in a Response, and returns an io.Reader (or an error on failure)
type MarshalerMap ¶
type MarshalerMap map[EncodingType]Marshaler
MarshalerMap is a map of Marshaler functions, keyed by EncodingType (or an error on failure)
type ReqLog ¶ added in v0.4.0
type ReqLog struct {
Requests []*ReqLogEntry
// contains filtered or unexported fields
}
ReqLog is a log of requests
func (*ReqLog) Add ¶ added in v0.4.0
func (rl *ReqLog) Add(req Request) *ReqLogEntry
Add creates a ReqLogEntry from a request and adds it to the log
func (*ReqLog) AddEntry ¶ added in v0.4.14
func (rl *ReqLog) AddEntry(rle *ReqLogEntry)
AddEntry adds an entry to the log
func (*ReqLog) ClearInactive ¶ added in v0.4.0
func (rl *ReqLog) ClearInactive()
ClearInactive removes stale entries
func (*ReqLog) Finish ¶ added in v0.4.14
func (rl *ReqLog) Finish(rle *ReqLogEntry)
Finish marks an entry in the log as finished
func (*ReqLog) Report ¶ added in v0.4.0
func (rl *ReqLog) Report() []*ReqLogEntry
Report generates a copy of all the entries in the requestlog
func (*ReqLog) SetKeepTime ¶ added in v0.4.0
SetKeepTime sets a duration after which an entry will be considered inactive
type ReqLogEntry ¶ added in v0.4.0
type ReqLogEntry struct {
StartTime time.Time
EndTime time.Time
Active bool
Command string
Options map[string]interface{}
Args []string
ID int
// contains filtered or unexported fields
}
ReqLogEntry is an entry in the request log
func (*ReqLogEntry) Copy ¶ added in v0.4.0
func (r *ReqLogEntry) Copy() *ReqLogEntry
Copy returns a copy of the ReqLogEntry
type Request ¶
type Request interface {
Path() []string
Option(name string) *cmdkit.OptionValue
Options() cmdkit.OptMap
SetOption(name string, val interface{})
SetOptions(opts cmdkit.OptMap) error
Arguments() []string
StringArguments() []string
SetArguments([]string)
Files() files.File
SetFiles(files.File)
Context() context.Context
InvocContext() *Context
SetInvocContext(Context)
Command() *Command
Values() map[string]interface{}
Stdin() io.Reader
VarArgs(func(string) error) error
ConvertOptions() error
}
Request represents a call to a command from a consumer
func NewEmptyRequest ¶
NewEmptyRequest initializes an empty request
func NewRequest ¶
func NewRequest(path []string, opts cmdkit.OptMap, args []string, file files.File, cmd *Command, optDefs map[string]cmdkit.Option) (Request, error)
NewRequest returns a request initialized with given arguments An non-nil error will be returned if the provided option values are invalid
type Response ¶
type Response interface {
Request() Request
// Set/Return the response Error
SetError(err error, code cmdkit.ErrorType)
Error() *cmdkit.Error
// Sets/Returns the response value
SetOutput(interface{})
Output() interface{}
// Sets/Returns the length of the output
SetLength(uint64)
Length() uint64
// underlying http connections need to be cleaned up, this is for that
Close() error
SetCloser(io.Closer)
// Marshal marshals out the response into a buffer. It uses the EncodingType
// on the Request to chose a Marshaler (Codec).
Marshal() (io.Reader, error)
// Gets a io.Reader that reads the marshalled output
Reader() (io.Reader, error)
// Gets Stdout and Stderr, for writing to console without using SetOutput
Stdout() io.Writer
Stderr() io.Writer
}
Response is the result of a command request. Handlers write to the response, setting Error or Value. Response is returned to the client.
func NewResponse ¶
NewResponse returns a response to match given Request