cmd

Documentation

Index

• Variables
• func RunClient(ctx context.Context, name string, opts ...fx.Option) error
• func RunServer(ctx context.Context, name string, opts ...fx.Option) error
• func SplitFlag(flag string) (string, string)
• func Start(lc fx.Lifecycle, fn StartFn)
• type Command
  • func New(version string) *Command
  • func (c *Command) AddClient(opts ...fx.Option) *cobra.Command
  • func (c *Command) AddClientCommand(name, description string, opts ...fx.Option) *cobra.Command
  • func (c *Command) AddServer(opts ...fx.Option) *cobra.Command
  • func (c *Command) AddServerCommand(name, description string, opts ...fx.Option) *cobra.Command
  • func (c *Command) RegisterInput(cmd *cobra.Command, value string)
  • func (c *Command) RegisterOutput(cmd *cobra.Command, value string)
  • func (c *Command) Root() *cobra.Command
  • func (c *Command) Run() error
  • func (c *Command) RunWithArgs(args []string) error
• type Config
  • func NewConfig(flag string, enc *encoding.Map) *Config
  • func (c *Config) Decode(data any) error
  • func (c *Config) Kind() string
  • func (c *Config) Write(data []byte, mode fs.FileMode) error
• type ENV
  • func NewENV(location string) *ENV
  • func (e *ENV) Kind() string
  • func (e *ENV) Read() ([]byte, error)
  • func (e *ENV) Write(data []byte, mode fs.FileMode) error
• type File
  • func NewFile(location string) *File
  • func (f *File) Kind() string
  • func (f *File) Read() ([]byte, error)
  • func (f *File) Write(data []byte, mode fs.FileMode) error
• type InputConfig
  • func NewInputConfig(enc *encoding.Map) *InputConfig
• type None
  • func NewNone() *None
  • func (*None) Kind() string
  • func (*None) Read() ([]byte, error)
  • func (*None) Write(_ []byte, _ fs.FileMode) error
• type OutputConfig
  • func NewOutputConfig(enc *encoding.Map) *OutputConfig
• type ReaderWriter
  • func NewReadWriter(kind, location string) ReaderWriter
• type StartFn

Variables

var ErrInvalidLocation = errors.New("invalid location: (format kind:location)")

ErrInvalidLocation for cmd.

var ErrLocationMissing = errors.New("location is missing")

ErrLocationMissing for cmd.

var InputFlag = flags.String()

InputFlag for cmd.

var Module = fx.Options(
	fx.Provide(NewInputConfig),
	fx.Provide(NewOutputConfig),
)

Module for fx.

var OutputFlag = flags.String()

OutputFlag for cmd.

Functions

func RunClient

func RunClient(ctx context.Context, name string, opts ...fx.Option) error

RunClient is a short lived process.

func RunServer

func RunServer(ctx context.Context, name string, opts ...fx.Option) error

RunServer is a long running process.

func SplitFlag

func SplitFlag(flag string) (string, string)

SplitFlag for cmd.

func Start

func Start(lc fx.Lifecycle, fn StartFn)

Start for cmd.

Types

type Command

type Command struct {
	// contains filtered or unexported fields
}

Command for application.

func New

func New(version string) *Command

New command.

func (*Command) AddClient

func (c *Command) AddClient(opts ...fx.Option) *cobra.Command

AddClient to the command.

func (*Command) AddClientCommand

func (c *Command) AddClientCommand(name, description string, opts ...fx.Option) *cobra.Command

AddClientCommand to root.

func (*Command) AddServer

func (c *Command) AddServer(opts ...fx.Option) *cobra.Command

AddServer to the command.

func (*Command) AddServerCommand

func (c *Command) AddServerCommand(name, description string, opts ...fx.Option) *cobra.Command

AddServerCommand to root.

func (*Command) RegisterInput

func (c *Command) RegisterInput(cmd *cobra.Command, value string)

RegisterInput for cmd.

func (*Command) RegisterOutput

func (c *Command) RegisterOutput(cmd *cobra.Command, value string)

RegisterInput for cmd.

func (*Command) Root

func (c *Command) Root() *cobra.Command

Root command.

func (*Command) Run

func (c *Command) Run() error

Run the command.

func (*Command) RunWithArgs

func (c *Command) RunWithArgs(args []string) error

Run the command with a an arg.

type Config

type Config struct {
	// contains filtered or unexported fields
}

Config for cmd.

func NewConfig

func NewConfig(flag string, enc *encoding.Map) *Config

NewConfig for cmd.

func (*Config) Decode

func (c *Config) Decode(data any) error

Decode for config.

func (*Config) Kind

func (c *Config) Kind() string

Kind of config.

func (*Config) Write

func (c *Config) Write(data []byte, mode fs.FileMode) error

Write for config.

type ENV

type ENV struct {
	// contains filtered or unexported fields
}

ENV for cmd.

func NewENV

func NewENV(location string) *ENV

NewENV for cmd.

func (*ENV) Kind

func (e *ENV) Kind() string

Kind for env.

func (*ENV) Read

func (e *ENV) Read() ([]byte, error)

Read for env.

func (*ENV) Write

func (e *ENV) Write(data []byte, mode fs.FileMode) error

Write for env.

type File

type File struct {
	// contains filtered or unexported fields
}

File for cmd.

func NewFile

func NewFile(location string) *File

NewFile for cmd.

func (*File) Kind

func (f *File) Kind() string

Kind for file.

func (*File) Read

func (f *File) Read() ([]byte, error)

Read for file.

func (*File) Write

func (f *File) Write(data []byte, mode fs.FileMode) error

Write for file.

type InputConfig

type InputConfig struct {
	*Config
}

InputConfig for cmd.

func NewInputConfig

func NewInputConfig(enc *encoding.Map) *InputConfig

NewInputConfig for cmd.

type None

type None struct{}

None for cmd.

func NewNone

func NewNone() *None

NewNone for cmd.

func (*None) Kind

func (*None) Kind() string

Kind for none.

func (*None) Read

func (*None) Read() ([]byte, error)

Read for none.

func (*None) Write

func (*None) Write(_ []byte, _ fs.FileMode) error

Write for none.

type OutputConfig

type OutputConfig struct {
	*Config
}

OutputConfig for cmd.

func NewOutputConfig

func NewOutputConfig(enc *encoding.Map) *OutputConfig

NewOutputConfig for cmd.

type ReaderWriter

type ReaderWriter interface {
	// Read bytes.
	Read() ([]byte, error)

	// Write bytes with files's mode.
	Write(data []byte, mode fs.FileMode) error

	// Kind of read writer.
	Kind() string
}

ReaderWriter for cmd.

func NewReadWriter

func NewReadWriter(kind, location string) ReaderWriter

NewReadWriter for cmd.

type StartFn

type StartFn func(ctx context.Context)

StartFn for cmd.