commit
334c98e388
692
realize.go
692
realize.go
File diff suppressed because it is too large
Load Diff
@ -2,21 +2,22 @@ package server
|
|||||||
|
|
||||||
import (
|
import (
|
||||||
"encoding/json"
|
"encoding/json"
|
||||||
"github.com/labstack/echo"
|
|
||||||
"github.com/labstack/echo/middleware"
|
|
||||||
c "github.com/tockins/realize/settings"
|
|
||||||
w "github.com/tockins/realize/watcher"
|
|
||||||
"golang.org/x/net/websocket"
|
|
||||||
"gopkg.in/urfave/cli.v2"
|
|
||||||
"net/http"
|
"net/http"
|
||||||
"strconv"
|
"strconv"
|
||||||
|
|
||||||
|
"github.com/labstack/echo"
|
||||||
|
"github.com/labstack/echo/middleware"
|
||||||
|
"github.com/tockins/realize/settings"
|
||||||
|
"github.com/tockins/realize/watcher"
|
||||||
|
"golang.org/x/net/websocket"
|
||||||
|
"gopkg.in/urfave/cli.v2"
|
||||||
)
|
)
|
||||||
|
|
||||||
// Server settings
|
// Server settings
|
||||||
type Server struct {
|
type Server struct {
|
||||||
*c.Settings `yaml:"-"`
|
*settings.Settings `yaml:"-"`
|
||||||
*w.Blueprint `yaml:"-"`
|
*watcher.Blueprint `yaml:"-"`
|
||||||
Sync chan string `yaml:"-"`
|
Sync chan string `yaml:"-"`
|
||||||
}
|
}
|
||||||
|
|
||||||
// Render return a web pages defined in bindata
|
// Render return a web pages defined in bindata
|
||||||
|
@ -2,7 +2,7 @@ package server
|
|||||||
|
|
||||||
import (
|
import (
|
||||||
"bytes"
|
"bytes"
|
||||||
"errors"
|
"fmt"
|
||||||
"io"
|
"io"
|
||||||
"os/exec"
|
"os/exec"
|
||||||
"runtime"
|
"runtime"
|
||||||
@ -22,9 +22,10 @@ func init() {
|
|||||||
|
|
||||||
// Open a url in the default browser
|
// Open a url in the default browser
|
||||||
func Open(url string) (io.Writer, error) {
|
func Open(url string) (io.Writer, error) {
|
||||||
open, err := cmd[runtime.GOOS]
|
goos := runtime.GOOS
|
||||||
|
open, err := cmd[goos]
|
||||||
if !err {
|
if !err {
|
||||||
return nil, errors.New("This operating system is not supported.")
|
return nil, fmt.Errorf("operating system %q is not supported", goos)
|
||||||
}
|
}
|
||||||
cmd := exec.Command(open, url)
|
cmd := exec.Command(open, url)
|
||||||
cmd.Stderr = &stderr
|
cmd.Stderr = &stderr
|
||||||
|
@ -1,89 +0,0 @@
|
|||||||
package settings
|
|
||||||
|
|
||||||
import (
|
|
||||||
"github.com/fatih/color"
|
|
||||||
)
|
|
||||||
|
|
||||||
// Colors allowed
|
|
||||||
type Colors struct {
|
|
||||||
Red
|
|
||||||
Blue
|
|
||||||
Yellow
|
|
||||||
Magenta
|
|
||||||
Green
|
|
||||||
}
|
|
||||||
|
|
||||||
// Red color
|
|
||||||
type Red struct{}
|
|
||||||
|
|
||||||
// Blue color
|
|
||||||
type Blue struct{}
|
|
||||||
|
|
||||||
// Yellow color
|
|
||||||
type Yellow struct{}
|
|
||||||
|
|
||||||
// Magenta color
|
|
||||||
type Magenta struct{}
|
|
||||||
|
|
||||||
// Green color
|
|
||||||
type Green struct{}
|
|
||||||
|
|
||||||
// Regular font in red
|
|
||||||
func (c Red) Regular(t ...interface{}) string {
|
|
||||||
r := color.New(color.FgRed).SprintFunc()
|
|
||||||
return r(t...)
|
|
||||||
}
|
|
||||||
|
|
||||||
// Bold font in red
|
|
||||||
func (c Red) Bold(t ...interface{}) string {
|
|
||||||
r := color.New(color.FgRed, color.Bold).SprintFunc()
|
|
||||||
return r(t...)
|
|
||||||
}
|
|
||||||
|
|
||||||
// Regular font in blue
|
|
||||||
func (c Blue) Regular(t ...interface{}) string {
|
|
||||||
r := color.New(color.FgBlue).SprintFunc()
|
|
||||||
return r(t...)
|
|
||||||
}
|
|
||||||
|
|
||||||
// Bold font in blue
|
|
||||||
func (c Blue) Bold(t ...interface{}) string {
|
|
||||||
r := color.New(color.FgBlue, color.Bold).SprintFunc()
|
|
||||||
return r(t...)
|
|
||||||
}
|
|
||||||
|
|
||||||
// Regular font in yellow
|
|
||||||
func (c Yellow) Regular(t ...interface{}) string {
|
|
||||||
r := color.New(color.FgYellow).SprintFunc()
|
|
||||||
return r(t...)
|
|
||||||
}
|
|
||||||
|
|
||||||
// Bold font in red
|
|
||||||
func (c Yellow) Bold(t ...interface{}) string {
|
|
||||||
r := color.New(color.FgYellow, color.Bold).SprintFunc()
|
|
||||||
return r(t...)
|
|
||||||
}
|
|
||||||
|
|
||||||
// Regular font in magenta
|
|
||||||
func (c Magenta) Regular(t ...interface{}) string {
|
|
||||||
r := color.New(color.FgMagenta).SprintFunc()
|
|
||||||
return r(t...)
|
|
||||||
}
|
|
||||||
|
|
||||||
// Bold font in magenta
|
|
||||||
func (c Magenta) Bold(t ...interface{}) string {
|
|
||||||
r := color.New(color.FgMagenta, color.Bold).SprintFunc()
|
|
||||||
return r(t...)
|
|
||||||
}
|
|
||||||
|
|
||||||
// Regular font in green
|
|
||||||
func (c Green) Regular(t ...interface{}) string {
|
|
||||||
r := color.New(color.FgGreen).SprintFunc()
|
|
||||||
return r(t...)
|
|
||||||
}
|
|
||||||
|
|
||||||
// Bold font in red
|
|
||||||
func (c Green) Bold(t ...interface{}) string {
|
|
||||||
r := color.New(color.FgGreen, color.Bold).SprintFunc()
|
|
||||||
return r(t...)
|
|
||||||
}
|
|
@ -5,12 +5,13 @@ package settings
|
|||||||
import "syscall"
|
import "syscall"
|
||||||
|
|
||||||
// Flimit defines the max number of watched files
|
// Flimit defines the max number of watched files
|
||||||
func (s *Settings) Flimit() {
|
func (s *Settings) Flimit() error {
|
||||||
var rLimit syscall.Rlimit
|
var rLimit syscall.Rlimit
|
||||||
rLimit.Max = uint64(s.Config.Flimit)
|
rLimit.Max = uint64(s.Config.Flimit)
|
||||||
rLimit.Cur = uint64(s.Config.Flimit)
|
rLimit.Cur = uint64(s.Config.Flimit)
|
||||||
err := syscall.Setrlimit(syscall.RLIMIT_NOFILE, &rLimit)
|
|
||||||
if err != nil {
|
if err := syscall.Setrlimit(syscall.RLIMIT_NOFILE, &rLimit); err != nil {
|
||||||
s.Fatal(err, "Error setting rlimit")
|
return err
|
||||||
}
|
}
|
||||||
|
return nil
|
||||||
}
|
}
|
||||||
|
@ -1,6 +1,7 @@
|
|||||||
|
// build windows
|
||||||
package settings
|
package settings
|
||||||
|
|
||||||
// Flimit defines the max number of watched files
|
// Flimit defines the max number of watched files
|
||||||
func (s *Settings) Flimit() {
|
func (s *Settings) Flimit() error {
|
||||||
return
|
return nil
|
||||||
}
|
}
|
||||||
|
@ -9,12 +9,12 @@ import (
|
|||||||
// Stream return a byte stream of a given file
|
// Stream return a byte stream of a given file
|
||||||
func (s Settings) Stream(file string) ([]byte, error) {
|
func (s Settings) Stream(file string) ([]byte, error) {
|
||||||
_, err := os.Stat(file)
|
_, err := os.Stat(file)
|
||||||
if err == nil {
|
if err != nil {
|
||||||
content, err := ioutil.ReadFile(file)
|
return nil, err
|
||||||
s.Validate(err)
|
|
||||||
return content, err
|
|
||||||
}
|
}
|
||||||
return nil, err
|
content, err := ioutil.ReadFile(file)
|
||||||
|
s.Validate(err)
|
||||||
|
return content, err
|
||||||
}
|
}
|
||||||
|
|
||||||
// Write a file given a name and a byte stream
|
// Write a file given a name and a byte stream
|
||||||
|
@ -1,14 +1,14 @@
|
|||||||
package settings
|
package settings
|
||||||
|
|
||||||
import (
|
import (
|
||||||
"gopkg.in/yaml.v2"
|
|
||||||
"os"
|
"os"
|
||||||
"time"
|
"time"
|
||||||
|
|
||||||
|
yaml "gopkg.in/yaml.v2"
|
||||||
)
|
)
|
||||||
|
|
||||||
// Settings defines a group of general settings
|
// Settings defines a group of general settings
|
||||||
type Settings struct {
|
type Settings struct {
|
||||||
Colors `yaml:"-"`
|
|
||||||
Config `yaml:",inline" json:"config"`
|
Config `yaml:",inline" json:"config"`
|
||||||
Resources `yaml:"resources" json:"resources"`
|
Resources `yaml:"resources" json:"resources"`
|
||||||
Server `yaml:"server,omitempty" json:"server,omitempty"`
|
Server `yaml:"server,omitempty" json:"server,omitempty"`
|
||||||
|
@ -5,6 +5,8 @@ import (
|
|||||||
"os"
|
"os"
|
||||||
"path/filepath"
|
"path/filepath"
|
||||||
"strings"
|
"strings"
|
||||||
|
|
||||||
|
"github.com/tockins/realize/style"
|
||||||
)
|
)
|
||||||
|
|
||||||
// Wdir return the current working directory
|
// Wdir return the current working directory
|
||||||
@ -25,7 +27,7 @@ func (s Settings) Validate(err error) error {
|
|||||||
// Fatal prints a fatal error with its additional messages
|
// Fatal prints a fatal error with its additional messages
|
||||||
func (s Settings) Fatal(err error, msg ...interface{}) {
|
func (s Settings) Fatal(err error, msg ...interface{}) {
|
||||||
if len(msg) > 0 && err != nil {
|
if len(msg) > 0 && err != nil {
|
||||||
log.Fatalln(s.Red.Regular(msg...), err.Error())
|
log.Fatalln(style.Red.Regular(msg...), err.Error())
|
||||||
} else if err != nil {
|
} else if err != nil {
|
||||||
log.Fatalln(err.Error())
|
log.Fatalln(err.Error())
|
||||||
}
|
}
|
||||||
|
24
style/style.go
Normal file
24
style/style.go
Normal file
@ -0,0 +1,24 @@
|
|||||||
|
package style
|
||||||
|
|
||||||
|
import (
|
||||||
|
"github.com/fatih/color"
|
||||||
|
)
|
||||||
|
|
||||||
|
type colorBase color.Attribute
|
||||||
|
|
||||||
|
func (s colorBase) Regular(a ...interface{}) string {
|
||||||
|
return color.New(color.Attribute(s)).Sprint(a...)
|
||||||
|
}
|
||||||
|
|
||||||
|
func (s colorBase) Bold(a ...interface{}) string {
|
||||||
|
return color.New(color.Attribute(s), color.Bold).Sprint(a...)
|
||||||
|
}
|
||||||
|
|
||||||
|
// allowed colors
|
||||||
|
var (
|
||||||
|
Red = colorBase(color.FgRed)
|
||||||
|
Blue = colorBase(color.FgBlue)
|
||||||
|
Yellow = colorBase(color.FgYellow)
|
||||||
|
Magenta = colorBase(color.FgMagenta)
|
||||||
|
Green = colorBase(color.FgGreen)
|
||||||
|
)
|
@ -1,10 +1,12 @@
|
|||||||
package cli
|
package watcher
|
||||||
|
|
||||||
import (
|
import (
|
||||||
"errors"
|
"errors"
|
||||||
"fmt"
|
"fmt"
|
||||||
"gopkg.in/urfave/cli.v2"
|
|
||||||
"strings"
|
"strings"
|
||||||
|
|
||||||
|
"github.com/tockins/realize/style"
|
||||||
|
cli "gopkg.in/urfave/cli.v2"
|
||||||
)
|
)
|
||||||
|
|
||||||
// Run launches the toolchain for each project
|
// Run launches the toolchain for each project
|
||||||
@ -80,7 +82,7 @@ func (h *Blueprint) Remove(p *cli.Context) error {
|
|||||||
return nil
|
return nil
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
return errors.New("No project found.")
|
return errors.New("no project found")
|
||||||
}
|
}
|
||||||
|
|
||||||
// List of all the projects
|
// List of all the projects
|
||||||
@ -88,49 +90,49 @@ func (h *Blueprint) List() error {
|
|||||||
err := h.check()
|
err := h.check()
|
||||||
if err == nil {
|
if err == nil {
|
||||||
for _, val := range h.Projects {
|
for _, val := range h.Projects {
|
||||||
fmt.Println(h.Blue.Bold("[") + strings.ToUpper(val.Name) + h.Blue.Bold("]"))
|
fmt.Println(style.Blue.Bold("[") + strings.ToUpper(val.Name) + style.Blue.Bold("]"))
|
||||||
name := h.Magenta.Bold("[") + strings.ToUpper(val.Name) + h.Magenta.Bold("]")
|
name := style.Magenta.Bold("[") + strings.ToUpper(val.Name) + style.Magenta.Bold("]")
|
||||||
|
|
||||||
fmt.Println(name, h.Yellow.Regular("Base Path"), ":", h.Magenta.Regular(val.Path))
|
fmt.Println(name, style.Yellow.Regular("Base Path"), ":", style.Magenta.Regular(val.Path))
|
||||||
fmt.Println(name, h.Yellow.Regular("Fmt"), ":", h.Magenta.Regular(val.Fmt))
|
fmt.Println(name, style.Yellow.Regular("Fmt"), ":", style.Magenta.Regular(val.Fmt))
|
||||||
fmt.Println(name, h.Yellow.Regular("Generate"), ":", h.Magenta.Regular(val.Generate))
|
fmt.Println(name, style.Yellow.Regular("Generate"), ":", style.Magenta.Regular(val.Generate))
|
||||||
fmt.Println(name, h.Yellow.Regular("Test"), ":", h.Magenta.Regular(val.Test))
|
fmt.Println(name, style.Yellow.Regular("Test"), ":", style.Magenta.Regular(val.Test))
|
||||||
fmt.Println(name, h.Yellow.Regular("Install"), ":", h.Magenta.Regular(val.Bin))
|
fmt.Println(name, style.Yellow.Regular("Install"), ":", style.Magenta.Regular(val.Bin))
|
||||||
fmt.Println(name, h.Yellow.Regular("Build"), ":", h.Magenta.Regular(val.Build))
|
fmt.Println(name, style.Yellow.Regular("Build"), ":", style.Magenta.Regular(val.Build))
|
||||||
fmt.Println(name, h.Yellow.Regular("Run"), ":", h.Magenta.Regular(val.Run))
|
fmt.Println(name, style.Yellow.Regular("Run"), ":", style.Magenta.Regular(val.Run))
|
||||||
if len(val.Params) > 0 {
|
if len(val.Params) > 0 {
|
||||||
fmt.Println(name, h.Yellow.Regular("Params"), ":", h.Magenta.Regular(val.Params))
|
fmt.Println(name, style.Yellow.Regular("Params"), ":", style.Magenta.Regular(val.Params))
|
||||||
}
|
}
|
||||||
fmt.Println(name, h.Yellow.Regular("Watcher"), ":")
|
fmt.Println(name, style.Yellow.Regular("Watcher"), ":")
|
||||||
fmt.Println(name, "\t", h.Yellow.Regular("Preview"), ":", h.Magenta.Regular(val.Watcher.Preview))
|
fmt.Println(name, "\t", style.Yellow.Regular("Preview"), ":", style.Magenta.Regular(val.Watcher.Preview))
|
||||||
if len(val.Watcher.Exts) > 0 {
|
if len(val.Watcher.Exts) > 0 {
|
||||||
fmt.Println(name, "\t", h.Yellow.Regular("Extensions"), ":", h.Magenta.Regular(val.Watcher.Exts))
|
fmt.Println(name, "\t", style.Yellow.Regular("Extensions"), ":", style.Magenta.Regular(val.Watcher.Exts))
|
||||||
}
|
}
|
||||||
if len(val.Watcher.Paths) > 0 {
|
if len(val.Watcher.Paths) > 0 {
|
||||||
fmt.Println(name, "\t", h.Yellow.Regular("Paths"), ":", h.Magenta.Regular(val.Watcher.Paths))
|
fmt.Println(name, "\t", style.Yellow.Regular("Paths"), ":", style.Magenta.Regular(val.Watcher.Paths))
|
||||||
}
|
}
|
||||||
if len(val.Watcher.Ignore) > 0 {
|
if len(val.Watcher.Ignore) > 0 {
|
||||||
fmt.Println(name, "\t", h.Yellow.Regular("Ignored paths"), ":", h.Magenta.Regular(val.Watcher.Ignore))
|
fmt.Println(name, "\t", style.Yellow.Regular("Ignored paths"), ":", style.Magenta.Regular(val.Watcher.Ignore))
|
||||||
}
|
}
|
||||||
if len(val.Watcher.Scripts) > 0 {
|
if len(val.Watcher.Scripts) > 0 {
|
||||||
fmt.Println(name, "\t", h.Yellow.Regular("Scripts"), ":")
|
fmt.Println(name, "\t", style.Yellow.Regular("Scripts"), ":")
|
||||||
for _, v := range val.Watcher.Scripts {
|
for _, v := range val.Watcher.Scripts {
|
||||||
if v.Command != "" {
|
if v.Command != "" {
|
||||||
fmt.Println(name, "\t\t", h.Magenta.Regular("-"), h.Yellow.Regular("Command"), ":", h.Magenta.Regular(v.Command))
|
fmt.Println(name, "\t\t", style.Magenta.Regular("-"), style.Yellow.Regular("Command"), ":", style.Magenta.Regular(v.Command))
|
||||||
if v.Path != "" {
|
if v.Path != "" {
|
||||||
fmt.Println(name, "\t\t", h.Yellow.Regular("Path"), ":", h.Magenta.Regular(v.Path))
|
fmt.Println(name, "\t\t", style.Yellow.Regular("Path"), ":", style.Magenta.Regular(v.Path))
|
||||||
}
|
}
|
||||||
if v.Type != "" {
|
if v.Type != "" {
|
||||||
fmt.Println(name, "\t\t", h.Yellow.Regular("Type"), ":", h.Magenta.Regular(v.Type))
|
fmt.Println(name, "\t\t", style.Yellow.Regular("Type"), ":", style.Magenta.Regular(v.Type))
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
fmt.Println(name, h.Yellow.Regular("Streams"), ":")
|
fmt.Println(name, style.Yellow.Regular("Streams"), ":")
|
||||||
fmt.Println(name, "\t", h.Yellow.Regular("Cli Out"), ":", h.Magenta.Regular(val.Streams.CliOut))
|
fmt.Println(name, "\t", style.Yellow.Regular("Cli Out"), ":", style.Magenta.Regular(val.Streams.CliOut))
|
||||||
fmt.Println(name, "\t", h.Yellow.Regular("File Out"), ":", h.Magenta.Regular(val.Streams.FileOut))
|
fmt.Println(name, "\t", style.Yellow.Regular("File Out"), ":", style.Magenta.Regular(val.Streams.FileOut))
|
||||||
fmt.Println(name, "\t", h.Yellow.Regular("File Log"), ":", h.Magenta.Regular(val.Streams.FileLog))
|
fmt.Println(name, "\t", style.Yellow.Regular("File Log"), ":", style.Magenta.Regular(val.Streams.FileLog))
|
||||||
fmt.Println(name, "\t", h.Yellow.Regular("File Err"), ":", h.Magenta.Regular(val.Streams.FileErr))
|
fmt.Println(name, "\t", style.Yellow.Regular("File Err"), ":", style.Magenta.Regular(val.Streams.FileErr))
|
||||||
}
|
}
|
||||||
return nil
|
return nil
|
||||||
}
|
}
|
||||||
@ -143,5 +145,5 @@ func (h *Blueprint) check() error {
|
|||||||
h.Clean()
|
h.Clean()
|
||||||
return nil
|
return nil
|
||||||
}
|
}
|
||||||
return errors.New("There are no projects. The config file is empty.")
|
return errors.New("there are no projects")
|
||||||
}
|
}
|
||||||
|
@ -1,4 +1,4 @@
|
|||||||
package cli
|
package watcher
|
||||||
|
|
||||||
import (
|
import (
|
||||||
"bufio"
|
"bufio"
|
||||||
@ -11,6 +11,8 @@ import (
|
|||||||
"strings"
|
"strings"
|
||||||
"sync"
|
"sync"
|
||||||
"time"
|
"time"
|
||||||
|
|
||||||
|
"github.com/tockins/realize/style"
|
||||||
)
|
)
|
||||||
|
|
||||||
// GoRun is an implementation of the bin execution
|
// GoRun is an implementation of the bin execution
|
||||||
@ -46,7 +48,7 @@ func (p *Project) goRun(channel chan bool, runner chan bool, wr *sync.WaitGroup)
|
|||||||
p.Buffer.StdLog = append(p.Buffer.StdLog, BufferOut{Time: time.Now(), Text: "Failed to stop: " + err.Error()})
|
p.Buffer.StdLog = append(p.Buffer.StdLog, BufferOut{Time: time.Now(), Text: "Failed to stop: " + err.Error()})
|
||||||
p.Fatal(err, "Failed to stop", ":")
|
p.Fatal(err, "Failed to stop", ":")
|
||||||
}
|
}
|
||||||
msg := fmt.Sprintln(p.pname(p.Name, 2), ":", p.Red.Regular("Ended"))
|
msg := fmt.Sprintln(p.pname(p.Name, 2), ":", style.Red.Regular("Ended"))
|
||||||
out := BufferOut{Time: time.Now(), Text: "Ended", Type: "Go Run"}
|
out := BufferOut{Time: time.Now(), Text: "Ended", Type: "Go Run"}
|
||||||
p.print("log", out, msg, "")
|
p.print("log", out, msg, "")
|
||||||
wr.Done()
|
wr.Done()
|
||||||
@ -55,11 +57,11 @@ func (p *Project) goRun(channel chan bool, runner chan bool, wr *sync.WaitGroup)
|
|||||||
stdout, err := build.StdoutPipe()
|
stdout, err := build.StdoutPipe()
|
||||||
stderr, err := build.StderrPipe()
|
stderr, err := build.StderrPipe()
|
||||||
if err != nil {
|
if err != nil {
|
||||||
log.Println(p.Red.Bold(err.Error()))
|
log.Println(style.Red.Bold(err.Error()))
|
||||||
return err
|
return err
|
||||||
}
|
}
|
||||||
if err := build.Start(); err != nil {
|
if err := build.Start(); err != nil {
|
||||||
log.Println(p.Red.Bold(err.Error()))
|
log.Println(style.Red.Bold(err.Error()))
|
||||||
return err
|
return err
|
||||||
}
|
}
|
||||||
close(runner)
|
close(runner)
|
||||||
@ -70,7 +72,7 @@ func (p *Project) goRun(channel chan bool, runner chan bool, wr *sync.WaitGroup)
|
|||||||
for output.Scan() {
|
for output.Scan() {
|
||||||
select {
|
select {
|
||||||
default:
|
default:
|
||||||
msg := fmt.Sprintln(p.pname(p.Name, 3), ":", p.Blue.Regular(output.Text()))
|
msg := fmt.Sprintln(p.pname(p.Name, 3), ":", style.Blue.Regular(output.Text()))
|
||||||
if isError {
|
if isError {
|
||||||
out := BufferOut{Time: time.Now(), Text: output.Text(), Type: "Go Run"}
|
out := BufferOut{Time: time.Now(), Text: output.Text(), Type: "Go Run"}
|
||||||
p.print("error", out, msg, "")
|
p.print("error", out, msg, "")
|
||||||
|
@ -1,10 +1,11 @@
|
|||||||
package cli
|
package watcher
|
||||||
|
|
||||||
import (
|
import (
|
||||||
c "github.com/tockins/realize/settings"
|
|
||||||
"log"
|
"log"
|
||||||
"sync"
|
"sync"
|
||||||
"time"
|
"time"
|
||||||
|
|
||||||
|
"github.com/tockins/realize/settings"
|
||||||
)
|
)
|
||||||
|
|
||||||
var wg sync.WaitGroup
|
var wg sync.WaitGroup
|
||||||
@ -21,35 +22,34 @@ type pollWatcher struct {
|
|||||||
|
|
||||||
// Log struct
|
// Log struct
|
||||||
type logWriter struct {
|
type logWriter struct {
|
||||||
c.Colors
|
|
||||||
}
|
}
|
||||||
|
|
||||||
// Blueprint struct contains a projects list
|
// Blueprint struct contains a projects list
|
||||||
type Blueprint struct {
|
type Blueprint struct {
|
||||||
*c.Settings `yaml:"-"`
|
*settings.Settings `yaml:"-"`
|
||||||
Projects []Project `yaml:"projects,omitempty" json:"projects,omitempty"`
|
Projects []Project `yaml:"projects,omitempty" json:"projects,omitempty"`
|
||||||
Sync chan string `yaml:"-"`
|
Sync chan string `yaml:"-"`
|
||||||
}
|
}
|
||||||
|
|
||||||
// Project defines the informations of a single project
|
// Project defines the informations of a single project
|
||||||
type Project struct {
|
type Project struct {
|
||||||
c.Settings `yaml:"-"`
|
settings.Settings `yaml:"-"`
|
||||||
LastChangedOn time.Time `yaml:"-" json:"-"`
|
LastChangedOn time.Time `yaml:"-" json:"-"`
|
||||||
base string
|
base string
|
||||||
Name string `yaml:"name" json:"name"`
|
Name string `yaml:"name" json:"name"`
|
||||||
Path string `yaml:"path" json:"path"`
|
Path string `yaml:"path" json:"path"`
|
||||||
Fmt bool `yaml:"fmt" json:"fmt"`
|
Fmt bool `yaml:"fmt" json:"fmt"`
|
||||||
Generate bool `yaml:"generate" json:"generate"`
|
Generate bool `yaml:"generate" json:"generate"`
|
||||||
Test bool `yaml:"test" json:"test"`
|
Test bool `yaml:"test" json:"test"`
|
||||||
Bin bool `yaml:"bin" json:"bin"`
|
Bin bool `yaml:"bin" json:"bin"`
|
||||||
Build bool `yaml:"build" json:"build"`
|
Build bool `yaml:"build" json:"build"`
|
||||||
Run bool `yaml:"run" json:"run"`
|
Run bool `yaml:"run" json:"run"`
|
||||||
Params []string `yaml:"params,omitempty" json:"params,omitempty"`
|
Params []string `yaml:"params,omitempty" json:"params,omitempty"`
|
||||||
Watcher Watcher `yaml:"watcher" json:"watcher"`
|
Watcher Watcher `yaml:"watcher" json:"watcher"`
|
||||||
Streams Streams `yaml:"streams" json:"streams"`
|
Streams Streams `yaml:"streams" json:"streams"`
|
||||||
Buffer Buffer `yaml:"-" json:"buffer"`
|
Buffer Buffer `yaml:"-" json:"buffer"`
|
||||||
parent *Blueprint
|
parent *Blueprint
|
||||||
path string
|
path string
|
||||||
}
|
}
|
||||||
|
|
||||||
// Watcher struct defines the livereload's logic
|
// Watcher struct defines the livereload's logic
|
||||||
|
@ -1,10 +1,12 @@
|
|||||||
package cli
|
package watcher
|
||||||
|
|
||||||
import (
|
import (
|
||||||
"errors"
|
"errors"
|
||||||
"fmt"
|
"fmt"
|
||||||
"gopkg.in/urfave/cli.v2"
|
|
||||||
"time"
|
"time"
|
||||||
|
|
||||||
|
"github.com/tockins/realize/style"
|
||||||
|
cli "gopkg.in/urfave/cli.v2"
|
||||||
)
|
)
|
||||||
|
|
||||||
// Argsparam parse one by one the given argumentes
|
// Argsparam parse one by one the given argumentes
|
||||||
@ -23,7 +25,7 @@ func argsParam(params *cli.Context) []string {
|
|||||||
// Duplicates check projects with same name or same combinations of main/path
|
// Duplicates check projects with same name or same combinations of main/path
|
||||||
func duplicates(value Project, arr []Project) (Project, error) {
|
func duplicates(value Project, arr []Project) (Project, error) {
|
||||||
for _, val := range arr {
|
for _, val := range arr {
|
||||||
if value.Path == val.Path {
|
if value.Path == val.Path && val.Name == value.Name {
|
||||||
return val, errors.New("There is already a project for '" + val.Path + "'. Check your config file!")
|
return val, errors.New("There is already a project for '" + val.Path + "'. Check your config file!")
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
@ -42,5 +44,5 @@ func inArray(str string, list []string) bool {
|
|||||||
|
|
||||||
// Rewrite the layout of the log timestamp
|
// Rewrite the layout of the log timestamp
|
||||||
func (w logWriter) Write(bytes []byte) (int, error) {
|
func (w logWriter) Write(bytes []byte) (int, error) {
|
||||||
return fmt.Print(w.Yellow.Regular("[") + time.Now().Format("15:04:05") + w.Yellow.Regular("]") + string(bytes))
|
return fmt.Print(style.Yellow.Regular("[") + time.Now().Format("15:04:05") + style.Yellow.Regular("]") + string(bytes))
|
||||||
}
|
}
|
||||||
|
@ -1,9 +1,8 @@
|
|||||||
package cli
|
package watcher
|
||||||
|
|
||||||
import (
|
import (
|
||||||
"errors"
|
"errors"
|
||||||
"fmt"
|
"fmt"
|
||||||
"github.com/fsnotify/fsnotify"
|
|
||||||
"log"
|
"log"
|
||||||
"math/big"
|
"math/big"
|
||||||
"os"
|
"os"
|
||||||
@ -14,6 +13,9 @@ import (
|
|||||||
"sync"
|
"sync"
|
||||||
"syscall"
|
"syscall"
|
||||||
"time"
|
"time"
|
||||||
|
|
||||||
|
"github.com/fsnotify/fsnotify"
|
||||||
|
"github.com/tockins/realize/style"
|
||||||
)
|
)
|
||||||
|
|
||||||
var msg string
|
var msg string
|
||||||
@ -71,7 +73,7 @@ func (p *Project) watchByPolling() {
|
|||||||
}
|
}
|
||||||
p.LastChangedOn = time.Now().Truncate(time.Second)
|
p.LastChangedOn = time.Now().Truncate(time.Second)
|
||||||
// repeat the initial cycle
|
// repeat the initial cycle
|
||||||
msg = fmt.Sprintln(p.pname(p.Name, 4), ":", p.Magenta.Bold(strings.ToUpper(ext[1:])+" changed"), p.Magenta.Bold(file))
|
msg = fmt.Sprintln(p.pname(p.Name, 4), ":", style.Magenta.Bold(strings.ToUpper(ext[1:])+" changed"), style.Magenta.Bold(file))
|
||||||
out = BufferOut{Time: time.Now(), Text: strings.ToUpper(ext[1:]) + " changed " + file}
|
out = BufferOut{Time: time.Now(), Text: strings.ToUpper(ext[1:]) + " changed " + file}
|
||||||
p.print("log", out, msg, "")
|
p.print("log", out, msg, "")
|
||||||
|
|
||||||
@ -88,7 +90,7 @@ func (p *Project) watchByPolling() {
|
|||||||
base := filepath.Join(p.base, dir)
|
base := filepath.Join(p.base, dir)
|
||||||
if _, err := os.Stat(base); err == nil {
|
if _, err := os.Stat(base); err == nil {
|
||||||
if err := filepath.Walk(base, walk); err != nil {
|
if err := filepath.Walk(base, walk); err != nil {
|
||||||
msg = fmt.Sprintln(p.pname(p.Name, 2), ":", p.Red.Regular(err.Error()))
|
msg = fmt.Sprintln(p.pname(p.Name, 2), ":", style.Red.Regular(err.Error()))
|
||||||
out = BufferOut{Time: time.Now(), Text: err.Error()}
|
out = BufferOut{Time: time.Now(), Text: err.Error()}
|
||||||
p.print("error", out, msg, "")
|
p.print("error", out, msg, "")
|
||||||
}
|
}
|
||||||
@ -147,7 +149,7 @@ func (p *Project) watchByNotify() {
|
|||||||
}
|
}
|
||||||
p.LastChangedOn = time.Now().Truncate(time.Second)
|
p.LastChangedOn = time.Now().Truncate(time.Second)
|
||||||
// repeat the initial cycle
|
// repeat the initial cycle
|
||||||
msg = fmt.Sprintln(p.pname(p.Name, 4), ":", p.Magenta.Bold(strings.ToUpper(ext[1:])+" changed"), p.Magenta.Bold(file))
|
msg = fmt.Sprintln(p.pname(p.Name, 4), ":", style.Magenta.Bold(strings.ToUpper(ext[1:])+" changed"), style.Magenta.Bold(file))
|
||||||
out = BufferOut{Time: time.Now(), Text: strings.ToUpper(ext[1:]) + " changed " + file}
|
out = BufferOut{Time: time.Now(), Text: strings.ToUpper(ext[1:]) + " changed " + file}
|
||||||
p.print("log", out, msg, "")
|
p.print("log", out, msg, "")
|
||||||
|
|
||||||
@ -160,7 +162,7 @@ func (p *Project) watchByNotify() {
|
|||||||
}
|
}
|
||||||
}
|
}
|
||||||
case err := <-watcher.Errors:
|
case err := <-watcher.Errors:
|
||||||
msg = fmt.Sprintln(p.pname(p.Name, 2), ":", p.Red.Regular(err.Error()))
|
msg = fmt.Sprintln(p.pname(p.Name, 2), ":", style.Red.Regular(err.Error()))
|
||||||
out = BufferOut{Time: time.Now(), Text: err.Error()}
|
out = BufferOut{Time: time.Now(), Text: err.Error()}
|
||||||
p.print("error", out, msg, "")
|
p.print("error", out, msg, "")
|
||||||
case <-exit:
|
case <-exit:
|
||||||
@ -206,13 +208,13 @@ func (p *Project) watch(watcher watcher) error {
|
|||||||
base := filepath.Join(p.base, dir)
|
base := filepath.Join(p.base, dir)
|
||||||
if _, err := os.Stat(base); err == nil {
|
if _, err := os.Stat(base); err == nil {
|
||||||
if err := filepath.Walk(base, walk); err != nil {
|
if err := filepath.Walk(base, walk); err != nil {
|
||||||
log.Println(p.Red.Bold(err.Error()))
|
log.Println(style.Red.Bold(err.Error()))
|
||||||
}
|
}
|
||||||
} else {
|
} else {
|
||||||
return errors.New(base + " path doesn't exist")
|
return errors.New(base + " path doesn't exist")
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
msg = fmt.Sprintln(p.pname(p.Name, 1), ":", p.Blue.Bold("Watching"), p.Magenta.Bold(files), "file/s", p.Magenta.Bold(folders), "folder/s")
|
msg = fmt.Sprintln(p.pname(p.Name, 1), ":", style.Blue.Bold("Watching"), style.Magenta.Bold(files), "file/s", style.Magenta.Bold(folders), "folder/s")
|
||||||
out = BufferOut{Time: time.Now(), Text: "Watching " + strconv.FormatInt(files, 10) + " files/s " + strconv.FormatInt(folders, 10) + " folder/s"}
|
out = BufferOut{Time: time.Now(), Text: "Watching " + strconv.FormatInt(files, 10) + " files/s " + strconv.FormatInt(folders, 10) + " folder/s"}
|
||||||
p.print("log", out, msg, "")
|
p.print("log", out, msg, "")
|
||||||
return nil
|
return nil
|
||||||
@ -225,11 +227,11 @@ func (p *Project) install() error {
|
|||||||
log.Println(p.pname(p.Name, 1), ":", "Installing..")
|
log.Println(p.pname(p.Name, 1), ":", "Installing..")
|
||||||
stream, err := p.goInstall()
|
stream, err := p.goInstall()
|
||||||
if err != nil {
|
if err != nil {
|
||||||
msg = fmt.Sprintln(p.pname(p.Name, 2), ":", p.Red.Bold("Go Install"), p.Red.Regular(err.Error()))
|
msg = fmt.Sprintln(p.pname(p.Name, 2), ":", style.Red.Bold("Go Install"), style.Red.Regular(err.Error()))
|
||||||
out = BufferOut{Time: time.Now(), Text: err.Error(), Type: "Go Install", Stream: stream}
|
out = BufferOut{Time: time.Now(), Text: err.Error(), Type: "Go Install", Stream: stream}
|
||||||
p.print("error", out, msg, stream)
|
p.print("error", out, msg, stream)
|
||||||
} else {
|
} else {
|
||||||
msg = fmt.Sprintln(p.pname(p.Name, 5), ":", p.Green.Regular("Installed")+" after", p.Magenta.Regular(big.NewFloat(float64(time.Since(start).Seconds())).Text('f', 3), " s"))
|
msg = fmt.Sprintln(p.pname(p.Name, 5), ":", style.Green.Regular("Installed")+" after", style.Magenta.Regular(big.NewFloat(float64(time.Since(start).Seconds())).Text('f', 3), " s"))
|
||||||
out = BufferOut{Time: time.Now(), Text: "Installed after " + big.NewFloat(float64(time.Since(start).Seconds())).Text('f', 3) + " s"}
|
out = BufferOut{Time: time.Now(), Text: "Installed after " + big.NewFloat(float64(time.Since(start).Seconds())).Text('f', 3) + " s"}
|
||||||
p.print("log", out, msg, stream)
|
p.print("log", out, msg, stream)
|
||||||
}
|
}
|
||||||
@ -248,7 +250,7 @@ func (p *Project) run(channel chan bool, wr *sync.WaitGroup) {
|
|||||||
for {
|
for {
|
||||||
select {
|
select {
|
||||||
case <-runner:
|
case <-runner:
|
||||||
msg = fmt.Sprintln(p.pname(p.Name, 5), ":", p.Green.Regular("Has been run")+" after", p.Magenta.Regular(big.NewFloat(float64(time.Since(start).Seconds())).Text('f', 3), " s"))
|
msg = fmt.Sprintln(p.pname(p.Name, 5), ":", style.Green.Regular("Has been run")+" after", style.Magenta.Regular(big.NewFloat(float64(time.Since(start).Seconds())).Text('f', 3), " s"))
|
||||||
out = BufferOut{Time: time.Now(), Text: "Has been run after " + big.NewFloat(float64(time.Since(start).Seconds())).Text('f', 3) + " s"}
|
out = BufferOut{Time: time.Now(), Text: "Has been run after " + big.NewFloat(float64(time.Since(start).Seconds())).Text('f', 3) + " s"}
|
||||||
p.print("log", out, msg, "")
|
p.print("log", out, msg, "")
|
||||||
return
|
return
|
||||||
@ -264,11 +266,11 @@ func (p *Project) build() error {
|
|||||||
log.Println(p.pname(p.Name, 1), ":", "Building..")
|
log.Println(p.pname(p.Name, 1), ":", "Building..")
|
||||||
stream, err := p.goBuild()
|
stream, err := p.goBuild()
|
||||||
if err != nil {
|
if err != nil {
|
||||||
msg = fmt.Sprintln(p.pname(p.Name, 2), ":", p.Red.Bold("Go Build"), p.Red.Regular(err.Error()))
|
msg = fmt.Sprintln(p.pname(p.Name, 2), ":", style.Red.Bold("Go Build"), style.Red.Regular(err.Error()))
|
||||||
out = BufferOut{Time: time.Now(), Text: err.Error(), Type: "Go Build", Stream: stream}
|
out = BufferOut{Time: time.Now(), Text: err.Error(), Type: "Go Build", Stream: stream}
|
||||||
p.print("error", out, msg, stream)
|
p.print("error", out, msg, stream)
|
||||||
} else {
|
} else {
|
||||||
msg = fmt.Sprintln(p.pname(p.Name, 5), ":", p.Green.Regular("Builded")+" after", p.Magenta.Regular(big.NewFloat(float64(time.Since(start).Seconds())).Text('f', 3), " s"))
|
msg = fmt.Sprintln(p.pname(p.Name, 5), ":", style.Green.Regular("Builded")+" after", style.Magenta.Regular(big.NewFloat(float64(time.Since(start).Seconds())).Text('f', 3), " s"))
|
||||||
out = BufferOut{Time: time.Now(), Text: "Builded after " + big.NewFloat(float64(time.Since(start).Seconds())).Text('f', 3) + " s"}
|
out = BufferOut{Time: time.Now(), Text: "Builded after " + big.NewFloat(float64(time.Since(start).Seconds())).Text('f', 3) + " s"}
|
||||||
p.print("log", out, msg, stream)
|
p.print("log", out, msg, stream)
|
||||||
}
|
}
|
||||||
@ -281,7 +283,7 @@ func (p *Project) build() error {
|
|||||||
func (p *Project) fmt(path string) error {
|
func (p *Project) fmt(path string) error {
|
||||||
if p.Fmt && strings.HasSuffix(path, ".go") {
|
if p.Fmt && strings.HasSuffix(path, ".go") {
|
||||||
if stream, err := p.goTools(p.base, "gofmt", "-s", "-w", "-e", path); err != nil {
|
if stream, err := p.goTools(p.base, "gofmt", "-s", "-w", "-e", path); err != nil {
|
||||||
msg = fmt.Sprintln(p.pname(p.Name, 2), ":", p.Red.Bold("Go Fmt"), p.Red.Regular("there are some errors in"), ":", p.Magenta.Bold(path))
|
msg = fmt.Sprintln(p.pname(p.Name, 2), ":", style.Red.Bold("Go Fmt"), style.Red.Regular("there are some errors in"), ":", style.Magenta.Bold(path))
|
||||||
out = BufferOut{Time: time.Now(), Text: "there are some errors in", Path: path, Type: "Go Fmt", Stream: stream}
|
out = BufferOut{Time: time.Now(), Text: "there are some errors in", Path: path, Type: "Go Fmt", Stream: stream}
|
||||||
p.print("error", out, msg, stream)
|
p.print("error", out, msg, stream)
|
||||||
return err
|
return err
|
||||||
@ -294,7 +296,7 @@ func (p *Project) fmt(path string) error {
|
|||||||
func (p *Project) generate(path string) error {
|
func (p *Project) generate(path string) error {
|
||||||
if p.Generate {
|
if p.Generate {
|
||||||
if stream, err := p.goTools(path, "go", "generate"); err != nil {
|
if stream, err := p.goTools(path, "go", "generate"); err != nil {
|
||||||
msg = fmt.Sprintln(p.pname(p.Name, 2), ":", p.Red.Bold("Go Generate"), p.Red.Regular("there are some errors in"), ":", p.Magenta.Bold(path))
|
msg = fmt.Sprintln(p.pname(p.Name, 2), ":", style.Red.Bold("Go Generate"), style.Red.Regular("there are some errors in"), ":", style.Magenta.Bold(path))
|
||||||
out = BufferOut{Time: time.Now(), Text: "there are some errors in", Path: path, Type: "Go Generate", Stream: stream}
|
out = BufferOut{Time: time.Now(), Text: "there are some errors in", Path: path, Type: "Go Generate", Stream: stream}
|
||||||
p.print("error", out, msg, stream)
|
p.print("error", out, msg, stream)
|
||||||
return err
|
return err
|
||||||
@ -307,7 +309,7 @@ func (p *Project) generate(path string) error {
|
|||||||
func (p *Project) test(path string) error {
|
func (p *Project) test(path string) error {
|
||||||
if p.Test {
|
if p.Test {
|
||||||
if stream, err := p.goTools(path, "go", "test"); err != nil {
|
if stream, err := p.goTools(path, "go", "test"); err != nil {
|
||||||
msg = fmt.Sprintln(p.pname(p.Name, 2), ":", p.Red.Bold("Go Test"), p.Red.Regular("there are some errors in "), ":", p.Magenta.Bold(path))
|
msg = fmt.Sprintln(p.pname(p.Name, 2), ":", style.Red.Bold("Go Test"), style.Red.Regular("there are some errors in "), ":", style.Magenta.Bold(path))
|
||||||
out = BufferOut{Time: time.Now(), Text: "there are some errors in", Path: path, Type: "Go Test", Stream: stream}
|
out = BufferOut{Time: time.Now(), Text: "there are some errors in", Path: path, Type: "Go Test", Stream: stream}
|
||||||
p.print("error", out, msg, stream)
|
p.print("error", out, msg, stream)
|
||||||
return err
|
return err
|
||||||
@ -321,7 +323,7 @@ func (p *Project) cmd(flag string) {
|
|||||||
for _, cmd := range p.Watcher.Scripts {
|
for _, cmd := range p.Watcher.Scripts {
|
||||||
if strings.ToLower(cmd.Type) == flag {
|
if strings.ToLower(cmd.Type) == flag {
|
||||||
errors, logs := p.command(cmd)
|
errors, logs := p.command(cmd)
|
||||||
msg = fmt.Sprintln(p.pname(p.Name, 5), ":", p.Green.Bold("Command"), p.Green.Bold("\"")+cmd.Command+p.Green.Bold("\""))
|
msg = fmt.Sprintln(p.pname(p.Name, 5), ":", style.Green.Bold("Command"), style.Green.Bold("\"")+cmd.Command+style.Green.Bold("\""))
|
||||||
out = BufferOut{Time: time.Now(), Text: cmd.Command, Type: flag}
|
out = BufferOut{Time: time.Now(), Text: cmd.Command, Type: flag}
|
||||||
if logs != "" {
|
if logs != "" {
|
||||||
p.print("log", out, msg, "")
|
p.print("log", out, msg, "")
|
||||||
@ -335,7 +337,7 @@ func (p *Project) cmd(flag string) {
|
|||||||
p.print("log", out, "", msg)
|
p.print("log", out, "", msg)
|
||||||
}
|
}
|
||||||
if errors != "" {
|
if errors != "" {
|
||||||
msg = fmt.Sprintln(p.Red.Regular(errors))
|
msg = fmt.Sprintln(style.Red.Regular(errors))
|
||||||
out = BufferOut{Time: time.Now(), Text: errors, Type: flag}
|
out = BufferOut{Time: time.Now(), Text: errors, Type: flag}
|
||||||
p.print("error", out, "", msg)
|
p.print("error", out, "", msg)
|
||||||
}
|
}
|
||||||
@ -368,19 +370,19 @@ func (p *Project) routines(channel chan bool, wr *sync.WaitGroup) {
|
|||||||
func (p *Project) pname(name string, color int) string {
|
func (p *Project) pname(name string, color int) string {
|
||||||
switch color {
|
switch color {
|
||||||
case 1:
|
case 1:
|
||||||
name = p.Yellow.Regular("[") + strings.ToUpper(name) + p.Yellow.Regular("]")
|
name = style.Yellow.Regular("[") + strings.ToUpper(name) + style.Yellow.Regular("]")
|
||||||
break
|
break
|
||||||
case 2:
|
case 2:
|
||||||
name = p.Yellow.Regular("[") + p.Red.Bold(strings.ToUpper(name)) + p.Yellow.Regular("]")
|
name = style.Yellow.Regular("[") + style.Red.Bold(strings.ToUpper(name)) + style.Yellow.Regular("]")
|
||||||
break
|
break
|
||||||
case 3:
|
case 3:
|
||||||
name = p.Yellow.Regular("[") + p.Blue.Bold(strings.ToUpper(name)) + p.Yellow.Regular("]")
|
name = style.Yellow.Regular("[") + style.Blue.Bold(strings.ToUpper(name)) + style.Yellow.Regular("]")
|
||||||
break
|
break
|
||||||
case 4:
|
case 4:
|
||||||
name = p.Yellow.Regular("[") + p.Magenta.Bold(strings.ToUpper(name)) + p.Yellow.Regular("]")
|
name = style.Yellow.Regular("[") + style.Magenta.Bold(strings.ToUpper(name)) + style.Yellow.Regular("]")
|
||||||
break
|
break
|
||||||
case 5:
|
case 5:
|
||||||
name = p.Yellow.Regular("[") + p.Green.Bold(strings.ToUpper(name)) + p.Yellow.Regular("]")
|
name = style.Yellow.Regular("[") + style.Green.Bold(strings.ToUpper(name)) + style.Yellow.Regular("]")
|
||||||
break
|
break
|
||||||
}
|
}
|
||||||
return name
|
return name
|
||||||
|
Loading…
Reference in New Issue
Block a user