armory

Documentation

Index

• Variables
• func AddArmoryCmd(cmd *cobra.Command, con *console.SliverClient, args []string)
• func AliasExtensionOrBundleCompleter() carapace.Action
• func ArmoryCmd(cmd *cobra.Command, con *console.SliverClient, args []string)
• func ArmoryInfoCommand(cmd *cobra.Command, con *console.SliverClient, args []string)
• func ArmoryInstallCmd(cmd *cobra.Command, con *console.SliverClient, args []string)
• func ArmorySearchCmd(cmd *cobra.Command, con *console.SliverClient, args []string)
• func ArmoryUpdateCmd(cmd *cobra.Command, con *console.SliverClient, args []string)
• func ChangeArmoryEnabledState(cmd *cobra.Command, con *console.SliverClient, args []string, enabled bool)
• func Commands(con *console.SliverClient) []*cobra.Command
• func DefaultArmoryPkgParser(armoryConfig *assets.ArmoryConfig, armoryPkg *ArmoryPackage, sigOnly bool, ...) (*minisign.Signature, []byte, error)
• func GithubAPIArmoryPackageParser(armoryConfig *assets.ArmoryConfig, armoryPkg *ArmoryPackage, sigOnly bool, ...) (*minisign.Signature, []byte, error)
• func GithubArmoryPackageParser(_ *assets.ArmoryConfig, armoryPkg *ArmoryPackage, sigOnly bool, ...) (*minisign.Signature, []byte, error)
• func ModifyArmoryCmd(cmd *cobra.Command, con *console.SliverClient, args []string)
• func PrintArmoryBundles(bundles []*ArmoryBundle, con *console.SliverClient)
• func PrintArmoryPackages(aliases []*alias.AliasManifest, exts []*extensions.ExtensionManifest, ...)
• func RefreshArmories(cmd *cobra.Command, con *console.SliverClient)
• func RemoveArmoryCmd(cmd *cobra.Command, con *console.SliverClient, args []string)
• func ResetArmoryConfig(cmd *cobra.Command, con *console.SliverClient)
• func SaveArmories(con *console.SliverClient)
• type ArmoryBundle
• type ArmoryHTTPConfig
• type ArmoryIndex
  • func DefaultArmoryIndexParser(armoryConfig *assets.ArmoryConfig, clientConfig ArmoryHTTPConfig) (*ArmoryIndex, error)
  • func GithubAPIArmoryIndexParser(armoryConfig *assets.ArmoryConfig, clientConfig ArmoryHTTPConfig) (*ArmoryIndex, error)
• type ArmoryIndexParser
• type ArmoryPackage
• type ArmoryPackageParser
• type GithubAsset
• type GithubRelease
• type PackageType
• type UpdateIdentifier
• type VersionInformation

Variables

var ErrPackageAlreadyInstalled = errors.New("package is already installed")

var ErrPackageNotFound = errors.New("package not found")

ErrPackageNotFound - The package was not found

Functions

func AddArmoryCmd

func AddArmoryCmd(cmd *cobra.Command, con *console.SliverClient, args []string)

func AliasExtensionOrBundleCompleter

func AliasExtensionOrBundleCompleter() carapace.Action

AliasExtensionOrBundleCompleter - Completer for alias, extension, and bundle names

func ArmoryCmd

func ArmoryCmd(cmd *cobra.Command, con *console.SliverClient, args []string)

ArmoryCmd - The main armory command

func ArmoryInfoCommand

func ArmoryInfoCommand(cmd *cobra.Command, con *console.SliverClient, args []string)

func ArmoryInstallCmd

func ArmoryInstallCmd(cmd *cobra.Command, con *console.SliverClient, args []string)

ArmoryInstallCmd - The armory install command

func ArmorySearchCmd

func ArmorySearchCmd(cmd *cobra.Command, con *console.SliverClient, args []string)

ArmorySearchCmd - Search for packages by name

func ArmoryUpdateCmd

func ArmoryUpdateCmd(cmd *cobra.Command, con *console.SliverClient, args []string)

ArmoryUpdateCmd - Update all installed extensions/aliases

func ChangeArmoryEnabledState

func ChangeArmoryEnabledState(cmd *cobra.Command, con *console.SliverClient, args []string, enabled bool)

func Commands

func Commands(con *console.SliverClient) []*cobra.Command

Commands returns the `armory` command and its subcommands.

func DefaultArmoryPkgParser

func DefaultArmoryPkgParser(armoryConfig *assets.ArmoryConfig, armoryPkg *ArmoryPackage, sigOnly bool, clientConfig ArmoryHTTPConfig) (*minisign.Signature, []byte, error)

DefaultArmoryPkgParser - Parse the armory package manifest directly from the url

func GithubAPIArmoryPackageParser

func GithubAPIArmoryPackageParser(armoryConfig *assets.ArmoryConfig, armoryPkg *ArmoryPackage, sigOnly bool, clientConfig ArmoryHTTPConfig) (*minisign.Signature, []byte, error)

GithubAPIArmoryPackageParser - Retrieve the minisig and tar.gz for an armory package from a GitHub release

func GithubArmoryPackageParser

func GithubArmoryPackageParser(_ *assets.ArmoryConfig, armoryPkg *ArmoryPackage, sigOnly bool, clientConfig ArmoryHTTPConfig) (*minisign.Signature, []byte, error)

GithubArmoryPackageParser - Uses github.com instead of api.github.com to download packages

func ModifyArmoryCmd

func ModifyArmoryCmd(cmd *cobra.Command, con *console.SliverClient, args []string)

func PrintArmoryBundles

func PrintArmoryBundles(bundles []*ArmoryBundle, con *console.SliverClient)

PrintArmoryBundles - Prints the armory bundles

func PrintArmoryPackages

func PrintArmoryPackages(aliases []*alias.AliasManifest, exts []*extensions.ExtensionManifest, con *console.SliverClient)

PrintArmoryPackages - Prints the armory packages

func RefreshArmories

func RefreshArmories(cmd *cobra.Command, con *console.SliverClient)

func RemoveArmoryCmd

func RemoveArmoryCmd(cmd *cobra.Command, con *console.SliverClient, args []string)

func ResetArmoryConfig

func ResetArmoryConfig(cmd *cobra.Command, con *console.SliverClient)

func SaveArmories

func SaveArmories(con *console.SliverClient)

Types

type ArmoryBundle

type ArmoryBundle struct {
	Name       string   `json:"name"`
	Packages   []string `json:"packages"`
	ArmoryName string   `json:"-"`
}

ArmoryBundle - A list of packages

type ArmoryHTTPConfig

type ArmoryHTTPConfig struct {
	ArmoryConfig         *assets.ArmoryConfig
	IgnoreCache          bool
	ProxyURL             *url.URL
	Timeout              time.Duration
	DisableTLSValidation bool
}

ArmoryHTTPConfig - Configuration for armory HTTP client

type ArmoryIndex

type ArmoryIndex struct {
	ArmoryConfig *assets.ArmoryConfig `json:"-"`
	Aliases      []*ArmoryPackage     `json:"aliases"`
	Extensions   []*ArmoryPackage     `json:"extensions"`
	Bundles      []*ArmoryBundle      `json:"bundles"`
}

ArmoryIndex - Index JSON containing alias/extension/bundle information

func DefaultArmoryIndexParser

func DefaultArmoryIndexParser(armoryConfig *assets.ArmoryConfig, clientConfig ArmoryHTTPConfig) (*ArmoryIndex, error)

DefaultArmoryParser - Parse the armory index directly from the url

func GithubAPIArmoryIndexParser

func GithubAPIArmoryIndexParser(armoryConfig *assets.ArmoryConfig, clientConfig ArmoryHTTPConfig) (*ArmoryIndex, error)

GithubAPIArmoryIndexParser - Parse the armory index from a GitHub release

type ArmoryIndexParser

type ArmoryIndexParser func(*assets.ArmoryConfig, ArmoryHTTPConfig) (*ArmoryIndex, error)

ArmoryIndexParser - Generic interface to fetch armory indexes

type ArmoryPackage

type ArmoryPackage struct {
	Name        string `json:"name"`
	CommandName string `json:"command_name"`
	RepoURL     string `json:"repo_url"`
	PublicKey   string `json:"public_key"`

	IsAlias    bool   `json:"-"`
	ArmoryName string `json:"-"`
	/*
		With support for multiple armories, the command name of a package
		is not unique anymore, so we need something that is unique
		to be able to keep track of packages.

		This ID will be a hash calculated from properties of the package.
	*/
	ID       string `json:"-"`
	ArmoryPK string `json:"-"`
}

ArmoryPackage - JSON metadata for alias or extension

type ArmoryPackageParser

type ArmoryPackageParser func(*assets.ArmoryConfig, *ArmoryPackage, bool, ArmoryHTTPConfig) (*minisign.Signature, []byte, error)

ArmoryPackageParser - Generic interface to fetch armory package manifests

type GithubAsset

type GithubAsset struct {
	ID   int    `json:"id"`
	Name string `json:"name"`
	URL  string `json:"url"`
	Size int    `json:"size"`

	BrowserDownloadURL string `json:"browser_download_url"`
}

type GithubRelease

type GithubRelease struct {
	ID          int           `json:"id"`
	Name        string        `json:"name"`
	URL         string        `json:"url"`
	HTMLURL     string        `json:"html_url"`
	TagName     string        `json:"tag_name"`
	Body        string        `json:"body"`
	Prerelease  bool          `json:"prerelease"`
	TarballURL  string        `json:"tarball_url"`
	ZipballURL  string        `json:"zipball_url"`
	CreatedAt   string        `json:"created_at"`
	PublishedAt string        `json:"published_at"`
	Assets      []GithubAsset `json:"assets"`
}

type PackageType

type PackageType uint

const (
	AliasPackage PackageType = iota
	ExtensionPackage
)

type UpdateIdentifier

type UpdateIdentifier struct {
	Type PackageType
	Name string
}

type VersionInformation

type VersionInformation struct {
	OldVersion string
	NewVersion string
	ArmoryName string
}