cmd

package
v1.11.0-pre2 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Dec 17, 2020 License: MIT Imports: 38 Imported by: 2

Documentation

Index

Constants

View Source 
const (
	// BuildModeProd indicates we are building for prod mode
	BuildModeProd = "prod"
	// BuildModeDebug indicates we are building for debug mode
	BuildModeDebug = "debug"
	// BuildModeBridge indicates we are building for bridge mode
	BuildModeBridge = "bridge"
)
View Source 
const Version = "v1.11.0-pre2"

Version - Wails version

Variables

This section is empty.

Functions

func BuildApplication 

func BuildApplication(binaryName string, forceRebuild bool, buildMode string, packageApp bool, projectOptions *ProjectOptions) error

BuildApplication will attempt to build the project based on the given inputs

func BuildDocker added in v1.5.0 

func BuildDocker(binaryName string, buildMode string, projectOptions *ProjectOptions) error

BuildDocker builds the project using the cross compiling wailsapp/xgo:<xgoVersion> container

func BuildFrontend 

func BuildFrontend(projectOptions *ProjectOptions) error

BuildFrontend runs the given build command

func BuildNative added in v1.5.0 

func BuildNative(binaryName string, forceRebuild bool, buildMode string, projectOptions *ProjectOptions) error

BuildNative builds on the target platform itself.

func CheckDependencies 

func CheckDependencies(logger *Logger) (bool, error)

CheckDependencies will look for Wails dependencies on the system Errors are reported in error and the bool return value is whether the dependencies are all installed.

func CheckDependenciesSilent 

func CheckDependenciesSilent(logger *Logger) (bool, error)

CheckDependenciesSilent checks for dependencies but only outputs if there's an error

func CheckIfInstalled added in v1.5.0 

func CheckIfInstalled(application string) (err error)

CheckIfInstalled returns if application is installed

func CheckMewn 

func CheckMewn(verbose bool) (err error)

CheckMewn checks if mewn is installed and if not, attempts to fetch it

func CheckWindres 

func CheckWindres() (err error)

CheckWindres checks if Windres is installed and if not, aborts

func DpkgInstalled 

func DpkgInstalled(packageName string) (bool, error)

DpkgInstalled uses dpkg to see if a package is installed

func EOpkgInstalled added in v1.6.0 

func EOpkgInstalled(packageName string) (bool, error)

EOpkgInstalled uses dpkg to see if a package is installed

func EmbedAssets added in v1.5.0 

func EmbedAssets() ([]string, error)

EmbedAssets will embed the built frontend assets via mewn.

func EqueryInstalled added in v0.18.0 

func EqueryInstalled(packageName string) (bool, error)

EqueryInstalled uses equery to see if a package is installed

func GetCurrentVersion added in v1.0.2 

func GetCurrentVersion() (*semver.Version, error)

func GetWailsVersion added in v1.0.2 

func GetWailsVersion() (*semver.Version, error)

func GoModOutOfSync added in v1.0.2 

func GoModOutOfSync() (bool, error)

func InitializeCrossCompilation added in v1.5.0 

func InitializeCrossCompilation(verbose bool) error

func InstallBridge added in v0.11.7 

func InstallBridge(projectDir string, projectOptions *ProjectOptions) error

InstallBridge installs the relevant bridge javascript library

func InstallFrontendDeps 

func InstallFrontendDeps(projectDir string, projectOptions *ProjectOptions, forceRebuild bool, caller string) error

InstallFrontendDeps attempts to install the frontend dependencies based on the given options

func InstallGoDependencies 

func InstallGoDependencies(verbose bool) error

InstallGoDependencies will run go get in the current directory

func InstallProdRuntime added in v0.18.0 

func InstallProdRuntime(projectDir string, projectOptions *ProjectOptions) error

InstallProdRuntime installs the production runtime

func InstallRuntime added in v0.18.0 

func InstallRuntime(caller string, projectDir string, projectOptions *ProjectOptions) error

InstallRuntime installs the correct runtime for the type of build

func PackageApplication 

func PackageApplication(projectOptions *ProjectOptions) error

PackageApplication will attempt to package the application in a platform dependent way

func PacmanInstalled added in v0.12.1 

func PacmanInstalled(packageName string) (bool, error)

PacmanInstalled uses pacman to see if a package is installed.

func Prompt 

func Prompt(question string, defaultValue ...string) string

Prompt asks the user for a value

func PromptRequired 

func PromptRequired(question string, defaultValue ...string) string

PromptRequired calls Prompt repeatedly until a value is given

func PromptSelection 

func PromptSelection(question string, options []string, optionalDefaultValue ...int) int

PromptSelection asks the user to choose an option

func RequestSupportForDistribution added in v0.17.0 

func RequestSupportForDistribution(distroInfo *DistroInfo) error

RequestSupportForDistribution promts the user to submit a request to support their currently unsupported distribution

func RpmInstalled added in v0.13.0 

func RpmInstalled(packageName string) (bool, error)

RpmInstalled uses rpm to see if a package is installed

func ServeProject 

func ServeProject(projectOptions *ProjectOptions, logger *Logger) error

ServeProject attempts to serve up the current project so that it may be connected to via the Wails bridge

func UpdateGoModVersion added in v1.0.2 

func UpdateGoModVersion() error

func ValidateFrontendConfig 

func ValidateFrontendConfig(projectOptions *ProjectOptions) error

ValidateFrontendConfig checks if the frontend config is valid

func XbpsInstalled added in v0.18.0 

func XbpsInstalled(packageName string) (bool, error)

XbpsInstalled uses pacman to see if a package is installed.

Types

type Action 

type Action func() error

Action represents a function that gets calls when the command is called by the user

type CheckPkgInstalled added in v0.18.0 

type CheckPkgInstalled func(string) (bool, error)

CheckPkgInstalled is all functions that use local programs to see if a package is installed

type Cli 

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

Cli - The main application object

func NewCli 

func NewCli(name, description string) *Cli

NewCli - Creates a new Cli application object

func (*Cli) BoolFlag 

func (c *Cli) BoolFlag(name, description string, variable *bool) *Command

BoolFlag - Adds a boolean flag to the root command

func (*Cli) Command 

func (c *Cli) Command(name, description string) *Command

Command - Adds a command to the application

func (*Cli) DefaultCommand 

func (c *Cli) DefaultCommand(defaultCommand *Command) *Cli

DefaultCommand - Sets the given command as the command to run when no other commands given

func (*Cli) PreRun 

func (c *Cli) PreRun(callback func(*Cli) error)

PreRun - Calls the given function before running the specific command

func (*Cli) PrintHelp 

func (c *Cli) PrintHelp()

PrintHelp - Prints the application's help

func (*Cli) Run 

func (c *Cli) Run(args ...string) error

Run - Runs the application with the given arguments

func (*Cli) StringFlag 

func (c *Cli) StringFlag(name, description string, variable *string) *Command

StringFlag - Adds a string flag to the root command

func (*Cli) Version 

func (c *Cli) Version(version string)

Version - Set the Application version string

type Command 

type Command struct {
	Name             string
	CommandPath      string
	Shortdescription string
	Longdescription  string
	AppVersion       string
	SubCommands      []*Command
	SubCommandsMap   map[string]*Command

	ActionCallback Action
	App            *Cli
	Flags          *flag.FlagSet
	// contains filtered or unexported fields
}

Command represents a command that may be run by the user

func NewCommand 

func NewCommand(name string, description string, app *Cli, parentCommandPath string) *Command

NewCommand creates a new Command

func (*Command) Action 

func (c *Command) Action(callback Action) *Command

Action - Define an action from this command

func (*Command) BoolFlag 

func (c *Command) BoolFlag(name, description string, variable *bool) *Command

BoolFlag - Adds a boolean flag to the command

func (*Command) Command 

func (c *Command) Command(name, description string) *Command

Command - Defines a subcommand

func (*Command) Hidden added in v0.15.0 

func (c *Command) Hidden()

Hidden hides the command from the Help system

func (*Command) LongDescription 

func (c *Command) LongDescription(Longdescription string) *Command

LongDescription - Sets the long description for the command

func (*Command) PrintHelp 

func (c *Command) PrintHelp()

PrintHelp - Output the help text for this command

func (*Command) Run 

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

Run - Runs the Command with the given arguments

func (*Command) StringFlag 

func (c *Command) StringFlag(name, description string, variable *string) *Command

StringFlag - Adds a string flag to the command

type Dir added in v0.15.0 

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

Dir holds information about a directory

func (*Dir) GetAllFilenames added in v0.15.0 

func (d *Dir) GetAllFilenames() (*slicer.StringSlicer, error)

GetAllFilenames returns all filename in and below this directory

func (*Dir) GetSubdirs added in v0.15.0 

func (d *Dir) GetSubdirs() (map[string]string, error)

GetSubdirs will return a list of FQPs to subdirectories in the given directory

type Distribution added in v0.18.0 

type Distribution struct {
	ID       string              `yaml:"id"`
	Releases map[string]*Release `yaml:"releases"`
}

Distribution holds the os-release ID and a map of releases.

func (*Distribution) GetRelease added in v0.18.0 

func (d *Distribution) GetRelease(version string) *Release

GetRelease attempts to return the specific Release information for the given release name. If there is no specific match, the default release data is returned.

type DistroInfo 

type DistroInfo struct {
	Distribution LinuxDistribution
	Name         string
	ID           string
	Description  string
	Release      string
}

DistroInfo contains all the information relating to a linux distribution

func GetLinuxDistroInfo 

func GetLinuxDistroInfo() *DistroInfo

GetLinuxDistroInfo returns information about the running linux distribution

type FSHelper 

type FSHelper struct {
}

FSHelper - Wrapper struct for File System utility commands

func NewFSHelper 

func NewFSHelper() *FSHelper

NewFSHelper - Returns a new FSHelper

func (*FSHelper) CopyFile 

func (fs *FSHelper) CopyFile(source, target string) error

CopyFile from source to target

func (*FSHelper) CreateFile added in v0.9.5 

func (fs *FSHelper) CreateFile(filename string, data []byte) error

CreateFile creates a file at the given filename location with the contents set to the given data. It will create intermediary directories if needed.

func (*FSHelper) Cwd 

func (fs *FSHelper) Cwd() string

Cwd returns the current working directory Aborts on Failure

func (*FSHelper) DirExists 

func (fs *FSHelper) DirExists(path string) bool

DirExists - Returns true if the given path resolves to a directory on the filesystem

func (*FSHelper) Directory added in v0.15.0 

func (fs *FSHelper) Directory(dir string) (*Dir, error)

Directory creates a new Dir struct with the given directory path

func (*FSHelper) FileExists 

func (fs *FSHelper) FileExists(path string) bool

FileExists returns a boolean value indicating whether the given file exists

func (*FSHelper) FileMD5 

func (fs *FSHelper) FileMD5(filename string) (string, error)

FileMD5 returns the md5sum of the given file

func (*FSHelper) FindFile added in v1.5.0 

func (fs *FSHelper) FindFile(path, match string) (string, error)

FindFile returns the first occurrence of match inside path.

func (*FSHelper) LoadAsBytes added in v0.15.0 

func (fs *FSHelper) LoadAsBytes(filename string) ([]byte, error)

LoadAsBytes returns the contents of the file as a byte slice

func (*FSHelper) LoadAsString 

func (fs *FSHelper) LoadAsString(filename string) (string, error)

LoadAsString will attempt to load the given file and return its contents as a string

func (*FSHelper) LoadRelativeFile added in v1.0.2 

func (fs *FSHelper) LoadRelativeFile(relativePath string) ([]byte, error)

LoadRelativeFile loads the given file relative to the caller's directory

func (*FSHelper) LocalDir added in v0.15.0 

func (fs *FSHelper) LocalDir(dir string) (*Dir, error)

LocalDir creates a new Dir struct based on a path relative to the caller

func (*FSHelper) MkDir 

func (fs *FSHelper) MkDir(dir string) error

MkDir creates the given directory. Returns error on failure

func (*FSHelper) MkDirs 

func (fs *FSHelper) MkDirs(fullPath string, mode ...os.FileMode) error

MkDirs creates the given nested directories. Returns error on failure

func (*FSHelper) RemoveFile 

func (fs *FSHelper) RemoveFile(filename string) error

RemoveFile removes the given filename

func (*FSHelper) RemoveFiles 

func (fs *FSHelper) RemoveFiles(files []string, continueOnError bool) error

RemoveFiles removes the given filenames

func (*FSHelper) SaveAsJSON added in v0.15.0 

func (fs *FSHelper) SaveAsJSON(data interface{}, filename string) error

SaveAsJSON saves the JSON representation of the given data to the given filename

type GitHubHelper added in v0.13.0 

type GitHubHelper struct {
}

GitHubHelper is a utility class for interacting with GitHub

func NewGitHubHelper added in v0.13.0 

func NewGitHubHelper() *GitHubHelper

NewGitHubHelper returns a new GitHub Helper

func (*GitHubHelper) GetLatestPreRelease added in v0.13.0 

func (g *GitHubHelper) GetLatestPreRelease() (result *SemanticVersion, err error)

GetLatestPreRelease gets the latest prerelease on GitHub

func (*GitHubHelper) GetLatestStableRelease added in v0.13.0 

func (g *GitHubHelper) GetLatestStableRelease() (result *SemanticVersion, err error)

GetLatestStableRelease gets the latest stable release on GitHub

func (*GitHubHelper) GetVersionTags added in v0.13.0 

func (g *GitHubHelper) GetVersionTags() ([]*SemanticVersion, error)

GetVersionTags gets the list of tags on the Wails repo It returns a list of sorted tags in descending order

func (*GitHubHelper) IsValidTag added in v0.13.0 

func (g *GitHubHelper) IsValidTag(tagVersion string) (bool, error)

IsValidTag returns true if the given string is a valid tag

type LinuxDB added in v0.18.0 

type LinuxDB struct {
	Distributions map[string]*Distribution `yaml:"distributions"`
}

LinuxDB is the database for linux distribution data.

func NewLinuxDB added in v0.18.0 

func NewLinuxDB() *LinuxDB

NewLinuxDB creates a new LinuxDB instance from the bundled linuxdb.yaml file.

func (*LinuxDB) GetDistro added in v0.18.0 

func (l *LinuxDB) GetDistro(distro string) *Distribution

GetDistro returns the Distribution information for the given distribution name. If the distribution is not supported, nil is returned.

func (*LinuxDB) ImportData added in v0.18.0 

func (l *LinuxDB) ImportData(data []byte) error

ImportData will unmarshal the given YAML formatted data into the LinuxDB

func (*LinuxDB) Load added in v0.18.0 

func (l *LinuxDB) Load(filename string) error

Load will load the given filename from disk and attempt to import the data into the LinuxDB.

type LinuxDistribution 

type LinuxDistribution int

LinuxDistribution is of type int 

const (
	// Unknown is the catch-all distro
	Unknown LinuxDistribution = iota
	// Debian distribution
	Debian
	// Ubuntu distribution
	Ubuntu
	// Arch linux distribution
	Arch
	// CentOS linux distribution
	CentOS
	// Fedora linux distribution
	Fedora
	// Gentoo distribution
	Gentoo
	// Zorin distribution
	Zorin
	// Parrot distribution
	Parrot
	// Linuxmint distribution
	Linuxmint
	// VoidLinux distribution
	VoidLinux
	// Elementary distribution
	Elementary
	// Kali distribution
	Kali
	// Neon distribution
	Neon
	// ArcoLinux distribution
	ArcoLinux
	// Manjaro distribution
	Manjaro
	// ManjaroARM distribution
	ManjaroARM
	// Deepin distribution
	Deepin
	// Raspbian distribution
	Raspbian
	// Tumbleweed (OpenSUSE) distribution
	Tumbleweed
	// Leap (OpenSUSE) distribution
	Leap
	// ArchLabs distribution
	ArchLabs
	// PopOS distribution
	PopOS
	// Solus distribution
	Solus
	// Ctlos Linux distribution
	Ctlos
	// EndeavourOS linux distribution
	EndeavourOS
)

type Logger 

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

Logger struct

func NewLogger 

func NewLogger() *Logger

NewLogger creates a new logger!

func (*Logger) Error 

func (l *Logger) Error(format string, a ...interface{})

Error - Outputs an Error message

func (*Logger) Green 

func (l *Logger) Green(format string, a ...interface{})

Green - Outputs Green text

func (*Logger) PrintBanner 

func (l *Logger) PrintBanner() error

PrintBanner prints the Wails banner before running commands

func (*Logger) PrintSmallBanner 

func (l *Logger) PrintSmallBanner(message ...string)

PrintSmallBanner prints a condensed banner

func (*Logger) Red 

func (l *Logger) Red(format string, a ...interface{})

Red - Outputs Red text

func (*Logger) SetErrorOnly 

func (l *Logger) SetErrorOnly(errorOnly bool)

SetErrorOnly ensures that only errors are logged out

func (*Logger) White 

func (l *Logger) White(format string, a ...interface{})

White - Outputs White text

func (*Logger) WhiteUnderline 

func (l *Logger) WhiteUnderline(format string, a ...interface{})

WhiteUnderline - Outputs White text with underline

func (*Logger) Yellow 

func (l *Logger) Yellow(format string, a ...interface{})

Yellow - Outputs yellow text

func (*Logger) YellowUnderline 

func (l *Logger) YellowUnderline(format string, a ...interface{})

YellowUnderline - Outputs Yellow text with underline

func (*Logger) Yellowf 

func (l *Logger) Yellowf(format string, a ...interface{})

Yellowf - Outputs yellow text without the newline

type PackageHelper 

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

PackageHelper helps with the 'wails package' command

func NewPackageHelper 

func NewPackageHelper(platform string) *PackageHelper

NewPackageHelper creates a new PackageHelper!

func (*PackageHelper) CleanWindows added in v1.5.0 

func (b *PackageHelper) CleanWindows(po *ProjectOptions)

CleanWindows removes any windows related files found in the directory

func (*PackageHelper) Package 

func (b *PackageHelper) Package(po *ProjectOptions) error

Package the application into a platform specific package

func (*PackageHelper) PackageWindows 

func (b *PackageHelper) PackageWindows(po *ProjectOptions, cleanUp bool) error

PackageWindows packages the application for windows platforms

type PackageManager added in v0.19.0 

type PackageManager int

PackageManager indicates different package managers 

const (
	// UNKNOWN package manager
	UNKNOWN PackageManager = iota
	// NPM package manager
	NPM
	// YARN package manager
	YARN
)

type Prerequisite 

type Prerequisite struct {
	Name string `yaml:"name"`
	Help string `yaml:"help,omitempty"`
}

Prerequisite is a simple struct containing a program/library name plus the distribution specific help text indicating how to install it.

type Prerequisites 

type Prerequisites []*Prerequisite

Prerequisites is a list of things required to use Wails

func GetRequiredLibraries 

func GetRequiredLibraries() (*Prerequisites, error)

GetRequiredLibraries returns a list of libraries (packages) required for the platform

func GetRequiredPrograms 

func GetRequiredPrograms() (*Prerequisites, error)

GetRequiredPrograms returns a list of programs required for the platform

func (*Prerequisites) Add 

func (p *Prerequisites) Add(prereq *Prerequisite)

Add given prereq object to list

type Program 

type Program struct {
	Name string `json:"name"`
	Path string `json:"path"`
	// contains filtered or unexported fields
}

Program - A struct to define an installed application/binary

func (*Program) GetFullPathToBinary 

func (p *Program) GetFullPathToBinary() (string, error)

GetFullPathToBinary returns the full path the the current binary

func (*Program) Run 

func (p *Program) Run(vars ...string) (stdout, stderr string, exitCode int, err error)

Run will execute the program with the given parameters Returns stdout + stderr as strings and an error if one occurred

type ProgramHelper 

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

ProgramHelper - Utility functions around installed applications

func NewProgramHelper 

func NewProgramHelper(verbose ...bool) *ProgramHelper

NewProgramHelper - Creates a new ProgramHelper

func (*ProgramHelper) FindProgram 

func (p *ProgramHelper) FindProgram(programName string) *Program

FindProgram attempts to find the given program on the system.FindProgram Returns a struct with the name and path to the program

func (*ProgramHelper) InstallGoPackage 

func (p *ProgramHelper) InstallGoPackage(packageName string) error

InstallGoPackage installs the given Go package

func (*ProgramHelper) InstallNPMPackage added in v0.19.0 

func (p *ProgramHelper) InstallNPMPackage(packageName string, save bool) error

InstallNPMPackage installs the given npm package

func (*ProgramHelper) IsInstalled 

func (p *ProgramHelper) IsInstalled(programName string) bool

IsInstalled tries to determine if the given binary name is installed

func (*ProgramHelper) RunCommand 

func (p *ProgramHelper) RunCommand(command string) error

RunCommand runs the given command

func (*ProgramHelper) RunCommandArray 

func (p *ProgramHelper) RunCommandArray(args []string, dir ...string) error

RunCommandArray runs the command specified in the array

type ProjectHelper 

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

ProjectHelper is a helper struct for managing projects

func NewProjectHelper 

func NewProjectHelper() *ProjectHelper

NewProjectHelper creates a new Project helper struct

func (*ProjectHelper) GenerateProject 

func (ph *ProjectHelper) GenerateProject(projectOptions *ProjectOptions) error

GenerateProject generates a new project using the options given

func (*ProjectHelper) LoadProjectConfig 

func (ph *ProjectHelper) LoadProjectConfig(dir string) (*ProjectOptions, error)

LoadProjectConfig loads the project config from the given directory

func (*ProjectHelper) NewProjectOptions 

func (ph *ProjectHelper) NewProjectOptions() *ProjectOptions

NewProjectOptions creates a new default set of project options

type ProjectOptions 

type ProjectOptions struct {
	Name            string    `json:"name"`
	Description     string    `json:"description"`
	Author          *author   `json:"author,omitempty"`
	Version         string    `json:"version"`
	OutputDirectory string    `json:"-"`
	UseDefaults     bool      `json:"-"`
	Template        string    `json:"-"`
	BinaryName      string    `json:"binaryname"`
	FrontEnd        *frontend `json:"frontend,omitempty"`
	Tags            string    `json:"tags"`
	NPMProjectName  string    `json:"-"`

	WailsVersion string

	Verbose      bool `json:"-"`
	CrossCompile bool
	Platform     string
	Architecture string
	LdFlags      string
	GoPath       string
	UseFirebug   bool

	// Supported platforms
	Platforms []string `json:"platforms,omitempty"`
	// contains filtered or unexported fields
}

ProjectOptions holds all the options available for a project

func (*ProjectOptions) Defaults 

func (po *ProjectOptions) Defaults()

Defaults sets the default project template

func (*ProjectOptions) GetNPMBinaryName added in v0.19.0 

func (po *ProjectOptions) GetNPMBinaryName() (PackageManager, error)

GetNPMBinaryName returns the type of package manager used by the project

func (*ProjectOptions) LoadConfig 

func (po *ProjectOptions) LoadConfig(projectDir string) error

LoadConfig loads the project configuration file from the given directory

func (*ProjectOptions) PlatformSupported added in v1.9.0 

func (po *ProjectOptions) PlatformSupported() bool

PlatformSupported returns true if the template is supported on the current platform

func (*ProjectOptions) PromptForInputs 

func (po *ProjectOptions) PromptForInputs() error

PromptForInputs asks the user to input project details

func (*ProjectOptions) SetTypescriptDefsFilename added in v1.0.2 

func (po *ProjectOptions) SetTypescriptDefsFilename(filename string)

SetTypescriptDefsFilename indicates that we want to generate typescript bindings to the given file

func (*ProjectOptions) WriteProjectConfig 

func (po *ProjectOptions) WriteProjectConfig() error

WriteProjectConfig writes the project configuration into the project directory

type Release added in v0.18.0 

type Release struct {
	Name              string          `yaml:"name"`
	Version           string          `yaml:"version"`
	GccVersionCommand string          `yaml:"gccversioncommand"`
	Programs          []*Prerequisite `yaml:"programs"`
	Libraries         []*Prerequisite `yaml:"libraries"`
}

Release holds the name and version of the release as given by os-release. Programs is a slice of dependant programs required to be present on the local installation for Wails to function. Libraries is a slice of libraries that must be present for Wails applications to compile.

type SemanticVersion added in v0.13.0 

type SemanticVersion struct {
	Version *semver.Version
}

SemanticVersion is a struct containing a semantic version

func NewSemanticVersion added in v0.13.0 

func NewSemanticVersion(version string) (*SemanticVersion, error)

NewSemanticVersion creates a new SemanticVersion object with the given version string

func (*SemanticVersion) IsGreaterThan added in v0.13.0 

func (s *SemanticVersion) IsGreaterThan(version *SemanticVersion) (bool, error)

IsGreaterThan returns true if this version is greater than the given version

func (*SemanticVersion) IsGreaterThanOrEqual added in v0.13.0 

func (s *SemanticVersion) IsGreaterThanOrEqual(version *SemanticVersion) (bool, error)

IsGreaterThanOrEqual returns true if this version is greater than or equal the given version

func (*SemanticVersion) IsPreRelease added in v0.13.0 

func (s *SemanticVersion) IsPreRelease() bool

IsPreRelease returns true if it's a prerelease version

func (*SemanticVersion) IsRelease added in v0.13.0 

func (s *SemanticVersion) IsRelease() bool

IsRelease returns true if it's a release version

func (*SemanticVersion) MainVersion added in v0.13.0 

func (s *SemanticVersion) MainVersion() *SemanticVersion

MainVersion returns the main version of any version+prerelease+metadata EG: MainVersion("1.2.3-pre") => "1.2.3"

func (*SemanticVersion) String added in v0.13.0 

func (s *SemanticVersion) String() string

type SemverCollection added in v0.13.0 

type SemverCollection []*SemanticVersion

SemverCollection is a collection of SemanticVersion objects

func (SemverCollection) Len added in v0.13.0 

func (c SemverCollection) Len() int

Len returns the length of a collection. The number of Version instances on the slice.

func (SemverCollection) Less added in v0.13.0 

func (c SemverCollection) Less(i, j int) bool

Less is needed for the sort interface to compare two Version objects on the slice. If checks if one is less than the other.

func (SemverCollection) Swap added in v0.13.0 

func (c SemverCollection) Swap(i, j int)

Swap is needed for the sort interface to replace the Version objects at two different positions in the slice.

type ShellHelper 

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

ShellHelper helps with Shell commands

func NewShellHelper 

func NewShellHelper() *ShellHelper

NewShellHelper creates a new ShellHelper!

func (*ShellHelper) Run 

func (sh *ShellHelper) Run(command string, vars ...string) (stdout, stderr string, err error)

Run the given command

func (*ShellHelper) RunInDirectory added in v0.12.3 

func (sh *ShellHelper) RunInDirectory(dir string, command string, vars ...string) (stdout, stderr string, err error)

RunInDirectory runs the given command in the given directory

func (*ShellHelper) SetVerbose added in v1.5.0 

func (sh *ShellHelper) SetVerbose()

SetVerbose sets the verbose flag

type SystemConfig 

type SystemConfig struct {
	Name  string `json:"name"`
	Email string `json:"email"`
}

SystemConfig - Defines system wode configuration data

func NewSystemConfig 

func NewSystemConfig(filename string) (*SystemConfig, error)

NewSystemConfig - Creates a new SystemConfig helper object

func (*SystemConfig) Save 

func (sc *SystemConfig) Save(filename string) error

Save - Saves the system config to the given filename

type SystemHelper 

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

SystemHelper - Defines everything related to the system

func NewSystemHelper 

func NewSystemHelper() *SystemHelper

NewSystemHelper - Creates a new System Helper

func (*SystemHelper) BackupConfig 

func (s *SystemHelper) BackupConfig() (string, error)

BackupConfig attempts to backup the system config file

func (*SystemHelper) CheckInitialised 

func (s *SystemHelper) CheckInitialised() error

CheckInitialised checks if the system has been set up and if not, runs setup

func (*SystemHelper) ConfigFileExists 

func (s *SystemHelper) ConfigFileExists() bool

ConfigFileExists - Returns true if it does!

func (*SystemHelper) ConfigFileIsValid 

func (s *SystemHelper) ConfigFileIsValid() bool

ConfigFileIsValid checks if the config file is valid

func (*SystemHelper) GetAuthor added in v0.15.0 

func (s *SystemHelper) GetAuthor() (string, error)

GetAuthor returns a formatted string of the user's name and email

func (*SystemHelper) Initialise 

func (s *SystemHelper) Initialise() error

Initialise attempts to set up the Wails system. An error is returns if there is a problem

func (*SystemHelper) LoadConfig 

func (s *SystemHelper) LoadConfig() (*SystemConfig, error)

LoadConfig attempts to load the Wails system config

type TemplateDependency added in v0.17.0 

type TemplateDependency struct {
	Bin  string `json:"bin"`
	Help string `json:"help"`
}

TemplateDependency defines a binary dependency for the template EG: ng for angular

type TemplateDetails added in v0.9.5 

type TemplateDetails struct {
	Name     string
	Path     string
	Metadata *TemplateMetadata
	// contains filtered or unexported fields
}

TemplateDetails holds information about a specific template

type TemplateHelper 

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

TemplateHelper is a utility object to help with processing templates

func NewTemplateHelper 

func NewTemplateHelper() *TemplateHelper

NewTemplateHelper creates a new template helper

func (*TemplateHelper) CreateNewTemplate added in v0.15.0 

func (t *TemplateHelper) CreateNewTemplate(dirname string, details *TemplateMetadata) (string, error)

CreateNewTemplate creates a new template based on the given directory name and string

func (*TemplateHelper) GetTemplateDetails 

func (t *TemplateHelper) GetTemplateDetails() (map[string]*TemplateDetails, error)

GetTemplateDetails returns a map of Template structs containing details of the found templates

func (*TemplateHelper) GetTemplateFilenames added in v0.15.0 

func (t *TemplateHelper) GetTemplateFilenames(template *TemplateDetails) (*slicer.StringSlicer, error)

GetTemplateFilenames returns all the filenames of the given template

func (*TemplateHelper) InstallTemplate 

func (t *TemplateHelper) InstallTemplate(projectPath string, projectOptions *ProjectOptions) error

InstallTemplate installs the template given in the project options to the project path given

func (*TemplateHelper) IsValidTemplate added in v0.15.0 

func (t *TemplateHelper) IsValidTemplate(templateName string) bool

IsValidTemplate returns true if the given template name resides on disk

func (*TemplateHelper) LoadMetadata 

func (t *TemplateHelper) LoadMetadata(dir string) (*TemplateMetadata, error)

LoadMetadata loads the template's 'metadata.json' file

func (*TemplateHelper) SanitizeFilename added in v0.15.0 

func (t *TemplateHelper) SanitizeFilename(name string) string

SanitizeFilename sanitizes the given string to make a valid filename

type TemplateMetadata added in v0.9.5 

type TemplateMetadata struct {
	Name                 string                `json:"name"`
	Version              string                `json:"version"`
	ShortDescription     string                `json:"shortdescription"`
	Description          string                `json:"description"`
	Install              string                `json:"install"`
	Build                string                `json:"build"`
	Author               string                `json:"author"`
	Created              string                `json:"created"`
	FrontendDir          string                `json:"frontenddir"`
	Serve                string                `json:"serve"`
	Bridge               string                `json:"bridge"`
	WailsDir             string                `json:"wailsdir"`
	TemplateDependencies []*TemplateDependency `json:"dependencies,omitempty"`

	// List of platforms that this template is supported on.
	// No value means all platforms. A platform name is the same string
	// as `runtime.GOOS` will return, eg: "darwin". NOTE: This is
	// case sensitive.
	Platforms []string `json:"platforms,omitempty"`
}

TemplateMetadata holds all the metadata for a Wails template

func (*TemplateMetadata) PlatformSupported added in v1.9.0 

func (m *TemplateMetadata) PlatformSupported() bool

PlatformSupported returns true if this template supports the currently running platform

Source Files

View all Source files

Directories

Path Synopsis
templates
vanilla

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.