cmd

Documentation

Overview

Package cmd provides the command line interface for the Defacto2 server application. With the configuration of the application done using the environment variables, the use of commands should be kept to a minimum.

Index

• Constants
• Variables
• func Address(c *config.Config) *cli.Command
• func App(ver string, c *config.Config) *cli.App
• func Arch() string
• func Commit(ver string) string
• func Config(c *config.Config) *cli.Command
• func Copyright() string
• func LastCommit() string
• func OS() string
• func Vers(version string) string
• func Version(s string) string
• type ExitCode
  • func Run(ver string, c *config.Config) (ExitCode, error)

Constants

const (
	Title   = "Defacto2 web application" // Title of this program.
	Domain  = "defacto2.net"             // Domain of the website.
	Program = "df2-server"               // Program is the command line name of this program.
	Author  = "Ben Garrett"              // Author is the primary programmer of this program.
	Email   = "contact@defacto2.net"     // Email contact for public display.
)

Variables

var ErrCmd = errors.New("cannot run command as config is nil")

Functions

func Address

func Address(c *config.Config) *cli.Command

Address is the `address` command help and action.

func App

func App(ver string, c *config.Config) *cli.App

App returns the command line interface for this program. It uses the github.com/urfave.cli package.

func Arch

func Arch() string

Arch returns the program CPU architecture.

func Commit

func Commit(ver string) string

Commit returns a formatted, git commit description for the repository, including tag version and date.

func Config

func Config(c *config.Config) *cli.Command

Config is the `config` command help and action.

func Copyright

func Copyright() string

Copyright returns the © symbol, years and author of this program. The final year is generated from the last commit date.

func LastCommit

func LastCommit() string

LastCommit returns the date of the last repository commit.

func OS

func OS() string

OS returns the program operating system.

func Vers

func Vers(version string) string

Vers returns a formatted version. The version string is generated by GoReleaser.

func Version

func Version(s string) string

Version returns a formatted version string for this program including the Commit, OS and CPU Arch.

Types

type ExitCode

type ExitCode int // ExitCode is the exit code for this program.

const (
	Continue     ExitCode = iota - 1 // Continue is a special case to indicate the program should not exit.
	ExitOK                           // ExitOK is the exit code for a successful run.
	GenericError                     // GenericError is the exit code for a generic error.
	UsageError                       // UsageError is the exit code for an incorrect command line argument or usage.
)

func Run

func Run(ver string, c *config.Config) (ExitCode, error)

Run parses optional command line arguments for this program.