Documentation
¶
Overview ¶
Package utils contains common methods used in most packages in Statup. This package contains multiple function like: Logging, encryption, type conversions, setting utils.Directory as the current directory, running local CMD commands, and creating/deleting files/folder.
You can overwrite the utils.Directory global variable by including STATUP_DIR environment variable to be an absolute path.
More info on: https://github.com/hunterlong/statup
Index ¶
- Constants
- Variables
- func Command(cmd string) (string, string, error)
- func DeleteDirectory(directory string) error
- func DeleteFile(file string) error
- func DurationReadable(d time.Duration) string
- func FileExists(name string) bool
- func FormatDuration(d time.Duration) string
- func HashPassword(password string) string
- func Http(r *http.Request) string
- func InitLogs() error
- func Log(level int, err interface{}) error
- func NewSHA1Hash(n ...int) string
- func RandomString(n int) string
- func SaveFile(filename string, data []byte) error
- func StringInt(s string) int64
- func Timezoner(t time.Time, zone float32) time.Time
- func ToString(s interface{}) string
- func UnderScoreString(str string) string
- type LogRow
- type Timestamp
- type Timestamper
Examples ¶
Constants ¶
const ( FlatpickrTime = "2006-01-02 15:04" FlatpickrDay = "2006-01-02" FlatpickrReadable = "Mon, 02 Jan 2006" )
Variables ¶
var ( LastLines []*LogRow LockLines sync.Mutex )
var ( // Directory returns the current path or the STATUP_DIR environment variable Directory string )
Functions ¶
func Command ¶
Command will run a terminal command with 'sh -c COMMAND' and return stdout and errOut as strings
in, out, err := Command("sass assets/scss assets/css/base.css")
func DeleteDirectory ¶
DeleteDirectory will attempt to delete a directory and all contents inside
DeleteDirectory("assets")
func DurationReadable ¶
DurationReadable will return a time.Duration into a human readable string
t := time.Duration(5 * time.Minute) DurationReadable(t) // 5 minutes
Example ¶
dur, _ := time.ParseDuration("25m")
readable := DurationReadable(dur)
fmt.Print(readable)
Output: 25 minutes
func FileExists ¶
FileExists returns true if a file exists
exists := FileExists("assets/css/base.css")
func FormatDuration ¶
FormatDuration converts a time.Duration into a string
func HashPassword ¶
HashPassword returns the bcrypt hash of a password string
func InitLogs ¶
func InitLogs() error
InitLogs will create the '/logs' directory and creates a file '/logs/statup.log' for application logging
func Log ¶
Log creates a new entry in the Logger. Log has 1-5 levels depending on how critical the log/error is
func NewSHA1Hash ¶
NewSHA1Hash returns a random SHA1 hash based on a specific length
func RandomString ¶
RandomString generates a random string of n length
func SaveFile ¶
SaveFile will create a new file with data inside it
SaveFile("newfile.json", []byte('{"data": "success"}')
func StringInt ¶
StringInt converts a string to an int64
Example ¶
amount := "42" fmt.Print(StringInt(amount))
Output: 42
func ToString ¶
func ToString(s interface{}) string
ToString converts a int to a string
Example ¶
amount := 42 fmt.Print(ToString(amount))
Output: 42
func UnderScoreString ¶
UnderScoreString will return a string that replaces spaces and other characters to underscores
UnderScoreString("Example String")
// example_string
Types ¶
type LogRow ¶
func (*LogRow) FormatForHtml ¶
type Timestamper ¶
type Timestamper interface {
Ago() string
}
Source Files