env

Documentation

Index

• func All() map[string]string
• func Chdir(u *user.User, path string) error
• func EditFile(u *user.User, path, line, s string) ([]rune, error)
• func Exec(s string) (string, error)
• func Getenv(keys ...string) string
• func Getvar(s string) (bool, string, error)
• func HistoryFile(u *user.User) string
• func OpenFile(u *user.User, path string, relative bool) (string, *os.File, error)
• func Pall() map[string]string
• func PassFile(u *user.User) string
• func PassFileEntry(u *user.User, v *dburl.URL) (*url.Userinfo, error)
• func Pget(name string) (string, error)
• func Pset(name, value string) (string, error)
• func Ptoggle(name, extra string) (string, error)
• func RCFile(u *user.User) string
• func Set(name, value string) error
• func Timefmt() string
• func Unquote(u *user.User, s string, exec bool) (string, error)
• func Unset(name string) error
• func ValidIdentifier(n string) error
• type Vars
  • func (v Vars) All() map[string]string
  • func (v Vars) Set(name, value string)
  • func (v Vars) Unset(name string)

Functions

func All

func All() map[string]string

All returns all variables.

func Chdir

func Chdir(u *user.User, path string) error

Chdir changes the current working directory to the specified path, or to the user's home directory if path is not specified.

func EditFile

func EditFile(u *user.User, path, line, s string) ([]rune, error)

EditFile edits a file. If path is empty, then a temporary file will be created.

func Exec

func Exec(s string) (string, error)

Exec runs s using the user's SHELL / COMSPEC (Windows, aka 'ComSpec'), with -c (or /c).

When SHELL or COMSPEC is not defined, then "sh" / "cmd.exe" will be used instead, assuming it is found on the system's PATH.

func Getenv

func Getenv(keys ...string) string

Getenv tries retrieving successive keys from os environment variables.

func Getvar

func Getvar(s string) (bool, string, error)

Getvar retrieves a variable.

func HistoryFile

func HistoryFile(u *user.User) string

HistoryFile returns the path to the history file.

Defaults to ~/.<command name>_history, overridden by environment variable <COMMAND NAME>_HISTORY (ie, ~/.usql_history and USQL_HISTORY).

func OpenFile

func OpenFile(u *user.User, path string, relative bool) (string, *os.File, error)

OpenFile opens a file for reading, returning the full, expanded path of the file. All callers are responsible for closing the returned file.

func Pall

func Pall() map[string]string

Pall returns all p variables.

func PassFile

func PassFile(u *user.User) string

PassFile returns the path to the password file.

Defaults to ~/.<command name>pass, overridden by environment variable <COMMAND NAME>PASS (ie, ~/.usqlpass and USQLPASS).

func PassFileEntry

func PassFileEntry(u *user.User, v *dburl.URL) (*url.Userinfo, error)

PassFileEntry determines if there is a password file entry for a specific database URL.

func Pget

func Pget(name string) (string, error)

func Pset

func Pset(name, value string) (string, error)

Pset sets a p variable.

func Ptoggle

func Ptoggle(name, extra string) (string, error)

Ptoggle toggles a p variable.

func RCFile

func RCFile(u *user.User) string

RCFile returns the path to the RC file.

Defaults to ~/.<command name>rc, overridden by environment variable <COMMAND NAME>RC (ie, ~/.usqlrc and USQLRC).

func Set

func Set(name, value string) error

Set sets a variable.

func Timefmt

func Timefmt() string

Timefmt returns the environment TIME_FORMAT.

func Unquote

func Unquote(u *user.User, s string, exec bool) (string, error)

Unquote unquotes the string.

func Unset

func Unset(name string) error

Unset unsets a variable.

func ValidIdentifier

func ValidIdentifier(n string) error

ValidIdentifier returns an error when n is not a valid identifier.

Types

type Vars

type Vars map[string]string

Vars is a map of variables.

func (Vars) All

func (v Vars) All() map[string]string

All returns all variables as a map.

func (Vars) Set

func (v Vars) Set(name, value string)

Set sets a variable name.

func (Vars) Unset

func (v Vars) Unset(name string)

Unset unsets a variable name.