modinstaller

Documentation

Index

• Constants
• func BuildInstallSummary(installData *InstallData) string
• func BuildUninstallSummary(installData *InstallData) string
• func ValidateModLocation(ctx context.Context, workspacePath string) bool
• type ByteSequence
  • func NewByteSequence(b []byte) *ByteSequence
  • func (b *ByteSequence) Apply(apply func([]byte) []byte)
  • func (b *ByteSequence) ApplyChanges(changeSet ChangeSet)
  • func (b *ByteSequence) Bytes() []byte
• type Change
• type ChangeOperation
• type ChangeSet
  • func EmptyChangeSet() ChangeSet
  • func MergeChangeSet(changeSets ...ChangeSet) ChangeSet
  • func NewChangeSet(changes ...*Change) ChangeSet
  • func (c ChangeSet) SortByOffset()
• type DependencyMod
• type GitUrlMode
• type InstallData
  • func InstallWorkspaceDependencies(ctx context.Context, opts *InstallOpts) (_ *InstallData, err error)
  • func NewInstallData(workspaceLock *versionmap.WorkspaceLock, workspaceMod *modconfig.Mod) *InstallData
  • func UninstallWorkspaceDependencies(ctx context.Context, opts *InstallOpts) (*InstallData, error)
  • func (d *InstallData) GetInstalledTree() treeprint.Tree
  • func (d *InstallData) GetUninstalledTree() treeprint.Tree
  • func (d *InstallData) GetUpdatedTree() treeprint.Tree
• type InstallOpts
  • func NewInstallOpts(workspaceMod *modconfig.Mod, updateStrategy string, modsToInstall ...string) *InstallOpts
• type ModInstaller
  • func NewModInstaller(opts *InstallOpts) (*ModInstaller, error)
  • func (i *ModInstaller) GetModList() string
  • func (i *ModInstaller) GetRequiredModVersionsFromArgs(modsArgs []string) (map[string]*modconfig.ModVersionConstraint, error)
  • func (i *ModInstaller) InstallWorkspaceDependencies(ctx context.Context) (err error)
  • func (i *ModInstaller) Prune() (versionmap.DependencyVersionListMap, error)
  • func (i *ModInstaller) UninstallWorkspaceDependencies(ctx context.Context) error
• type OperatorFunc

Constants

const (
	PersonalAccessTokenPrefix              = "ghp_"
	FineGrainedPersonalAccessTokenPrefix   = "github_pat_" //nolint:gosec // this is just the prefix
	OAuthAccessTokenPrefix                 = "gho_"
	GitHubAppUserAccessTokenPrefix         = "ghu_"
	GitHubAppInstallationAccessTokenPrefix = "ghs_"
	GitHubAppRefreshTokenPrefix            = "ghr_"
)

const (
	VerbInstalled   = "Installed"
	VerbUninstalled = "Uninstalled"
	VerbUpgraded    = "Upgraded"
	VerbDowngraded  = "Downgraded"
	VerbPruned      = "Pruned"
)

Functions

func BuildInstallSummary

func BuildInstallSummary(installData *InstallData) string

func BuildUninstallSummary

func BuildUninstallSummary(installData *InstallData) string

func ValidateModLocation

func ValidateModLocation(ctx context.Context, workspacePath string) bool

ValidateModLocation checks whether you are running from the home directory or if you have a lot of non .sql and .sp file in your current directory, and asks for confirmation to continue

Types

type ByteSequence

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

func NewByteSequence

func NewByteSequence(b []byte) *ByteSequence

func (*ByteSequence) Apply

func (b *ByteSequence) Apply(apply func([]byte) []byte)

Apply applies the given function on the byte sequence

func (*ByteSequence) ApplyChanges

func (b *ByteSequence) ApplyChanges(changeSet ChangeSet)

func (*ByteSequence) Bytes

func (b *ByteSequence) Bytes() []byte

Bytes returns the current underlying byte sequence

type Change

type Change struct {
	Content     []byte
	Operation   ChangeOperation
	OffsetStart int
	OffsetEnd   int
}

type ChangeOperation

type ChangeOperation int

const (
	Insert ChangeOperation = iota
	Delete
	Replace
)

type ChangeSet

type ChangeSet []*Change

func EmptyChangeSet

func EmptyChangeSet() ChangeSet

func MergeChangeSet

func MergeChangeSet(changeSets ...ChangeSet) ChangeSet

MergeChangeSet creates a ChangeSet by merging the given ChangeSets in order

func NewChangeSet

func NewChangeSet(changes ...*Change) ChangeSet

NewChangeSet creates a ChangeSet from the given changes

func (ChangeSet) SortByOffset

func (c ChangeSet) SortByOffset()

type DependencyMod

type DependencyMod struct {
	InstalledVersion *versionmap.InstalledModVersion
	Mod              *modconfig.Mod
}

DependencyMod is a mod which has been installed as a dependency

type GitUrlMode

type GitUrlMode int

const (
	GitUrlModeHTTPS GitUrlMode = iota
	GitUrlModeSSH
)

type InstallData

type InstallData struct {
	// record of the full dependency tree
	Lock    *versionmap.WorkspaceLock
	NewLock *versionmap.WorkspaceLock

	// list of dependencies installed by recent install operation
	Installed versionmap.InstalledDependencyVersionsMap
	// list of dependencies which have been upgraded
	Upgraded versionmap.InstalledDependencyVersionsMap
	// list of dependencies which have been downgraded
	Downgraded versionmap.InstalledDependencyVersionsMap
	// list of dependencies which have been uninstalled
	Uninstalled  versionmap.InstalledDependencyVersionsMap
	WorkspaceMod *modconfig.Mod
	// contains filtered or unexported fields
}

func InstallWorkspaceDependencies

func InstallWorkspaceDependencies(ctx context.Context, opts *InstallOpts) (_ *InstallData, err error)

func NewInstallData

func NewInstallData(workspaceLock *versionmap.WorkspaceLock, workspaceMod *modconfig.Mod) *InstallData

func UninstallWorkspaceDependencies

func UninstallWorkspaceDependencies(ctx context.Context, opts *InstallOpts) (*InstallData, error)

func (*InstallData) GetInstalledTree

func (d *InstallData) GetInstalledTree() treeprint.Tree

func (*InstallData) GetUninstalledTree

func (d *InstallData) GetUninstalledTree() treeprint.Tree

func (*InstallData) GetUpdatedTree

func (d *InstallData) GetUpdatedTree() treeprint.Tree

type InstallOpts

type InstallOpts struct {
	WorkspaceMod   *modconfig.Mod
	Command        string
	ModArgs        []string
	DryRun         bool
	Force          bool
	PluginVersions *modconfig.PluginVersionMap
	UpdateStrategy string
}

func NewInstallOpts

func NewInstallOpts(workspaceMod *modconfig.Mod, updateStrategy string, modsToInstall ...string) *InstallOpts

type ModInstaller

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

func NewModInstaller

func NewModInstaller(opts *InstallOpts) (*ModInstaller, error)

func (*ModInstaller) GetModList

func (i *ModInstaller) GetModList() string

func (*ModInstaller) GetRequiredModVersionsFromArgs

func (i *ModInstaller) GetRequiredModVersionsFromArgs(modsArgs []string) (map[string]*modconfig.ModVersionConstraint, error)

func (*ModInstaller) InstallWorkspaceDependencies

func (i *ModInstaller) InstallWorkspaceDependencies(ctx context.Context) (err error)

InstallWorkspaceDependencies installs all dependencies of the workspace mod

func (*ModInstaller) Prune

func (i *ModInstaller) Prune() (versionmap.DependencyVersionListMap, error)

func (*ModInstaller) UninstallWorkspaceDependencies

func (i *ModInstaller) UninstallWorkspaceDependencies(ctx context.Context) error

type OperatorFunc

type OperatorFunc func(*Change, []byte) []byte