coreutils

package
v2.55.4 Latest Latest
Warning

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

Go to latest
Published: Aug 26, 2024 License: Apache-2.0 Imports: 26 Imported by: 38

Documentation

Index

Constants

View Source
const (

	// General core constants
	OnErrorPanic OnError = "panic"

	// Common
	TokenRefreshDisabled        = 0
	TokenRefreshDefaultInterval = 60

	// Home Dir
	JfrogBackupDirName                  = "backup"
	JfrogCertsDirName                   = "certs"
	JfrogConfigFile                     = "jfrog-cli.conf"
	JfrogDependenciesDirName            = "dependencies"
	JfrogLocksDirName                   = "locks"
	JfrogLogsDirName                    = "logs"
	JfrogPluginsDirName                 = "plugins"
	JfrogPluginsFileName                = "plugins.yml"
	JfrogSecurityConfFile               = "security.yaml"
	JfrogSecurityDirName                = "security"
	JfrogTransferDelaysDirName          = "delays"
	JfrogTransferDirName                = "transfer"
	JfrogTransferErrorsDirName          = "errors"
	JfrogTransferRepoSnapshotFileName   = "repo-snapshot.json"
	JfrogTransferRepoStateFileName      = "repo-state.json"
	JfrogTransferRepositoriesDirName    = "repositories"
	JfrogTransferTempDirName            = "tmp"
	JfrogTransferRetryableErrorsDirName = "retryable"
	JfrogTransferRunStatusFileName      = "run-status.json"
	JfrogTransferSkippedErrorsDirName   = "skipped"
	JfrogTransferSnapshotDirName        = "snapshot"
	JfrogTransferStateFileName          = "state.json"
	PluginsExecDirName                  = "bin"
	PluginsResourcesDirName             = "resources"
	//#nosec G101
	CurationPassThroughApi = "api/curation/audit/"

	//#nosec G101
	ErrorHandling      = "JFROG_CLI_ERROR_HANDLING"
	TempDir            = "JFROG_CLI_TEMP_DIR"
	LogLevel           = "JFROG_CLI_LOG_LEVEL"
	LogTimestamp       = "JFROG_CLI_LOG_TIMESTAMP"
	ReportUsage        = "JFROG_CLI_REPORT_USAGE"
	DependenciesDir    = "JFROG_CLI_DEPENDENCIES_DIR"
	FailNoOp           = "JFROG_CLI_FAIL_NO_OP"
	OutputDirPathEnv   = "JFROG_CLI_COMMAND_SUMMARY_OUTPUT_DIR"
	CI                 = "CI"
	ServerID           = "JFROG_CLI_SERVER_ID"
	TransitiveDownload = "JFROG_CLI_TRANSITIVE_DOWNLOAD"
	// Deprecated and replaced with TransitiveDownload
	TransitiveDownloadExperimental = "JFROG_CLI_TRANSITIVE_DOWNLOAD_EXPERIMENTAL"
)
View Source
const (
	GettingStartedGuideUrl = "https://github.com/jfrog/jfrog-cli/blob/v2/guides/getting-started-with-jfrog-using-the-cli.md"
	JFrogComUrl            = "https://jfrog.com/"
	JFrogHelpUrl           = JFrogComUrl + "help/r/"
)
View Source
const (
	// ReleasesRemoteEnv should be used for downloading the CLI dependencies (extractor jars, analyzerManager etc.) through an Artifactory remote
	// repository, instead of downloading directly from releases.jfrog.io. The remote repository should be
	// configured to proxy releases.jfrog.io.
	// This env var should store a server ID and a remote repository in form of '<ServerID>/<RemoteRepo>'
	ReleasesRemoteEnv = "JFROG_CLI_RELEASES_REPO"
	// DeprecatedExtractorsRemoteEnv is deprecated, it is replaced with ReleasesRemoteEnv.
	// Its functionality was similar to ReleasesRemoteEnv, but it proxies releases.jfrog.io/artifactory/oss-release-local instead.
	DeprecatedExtractorsRemoteEnv = "JFROG_CLI_EXTRACTORS_REMOTE"
	// JFrog releases URL
	JfrogReleasesUrl = "https://releases.jfrog.io/artifactory/"
)

Variables

View Source
var (
	HomeDir     = "JFROG_CLI_HOME_DIR"
	BuildName   = "JFROG_CLI_BUILD_NAME"
	BuildNumber = "JFROG_CLI_BUILD_NUMBER"
	Project     = "JFROG_CLI_BUILD_PROJECT"
	//#nosec G101
	EncryptionKey = "JFROG_CLI_ENCRYPTION_KEY"
)

Although these vars are constant, they are defined inside a vars section and not a constants section because the tests modify these values.

View Source
var DefaultMaxColWidth = 25

Controls the max col width when printing to a non-terminal. See the PrintTable description for more info.

View Source
var ExitCodeError = ExitCode{1}
View Source
var ExitCodeFailNoOp = ExitCode{2}
View Source
var ExitCodeNoError = ExitCode{0}
View Source
var ExitCodeVulnerableBuild = ExitCode{3}

Functions

func AskYesNo

func AskYesNo(promptPrefix string, defaultValue bool) bool

Ask a yes or no question, with a default answer.

func ChmodPluginsDirectoryContent added in v2.13.0

func ChmodPluginsDirectoryContent() error

func ConvertExitCodeError added in v2.1.0

func ConvertExitCodeError(err error) error

When running a command in an external process, if the command fails to run or doesn't complete successfully ExitError is returned. We would like to return a regular error instead of ExitError, because some frameworks (such as codegangsta used by JFrog CLI) automatically exit when this error is returned.

func CreateDirInJfrogHome

func CreateDirInJfrogHome(dirName string) (string, error)

func ExitOnErr

func ExitOnErr(err error)

func ExtractDetailedSummaryFromArgs

func ExtractDetailedSummaryFromArgs(args []string) (cleanArgs []string, detailedSummary bool, err error)

func ExtractFailFromArgs added in v2.10.0

func ExtractFailFromArgs(args []string) (cleanArgs []string, fail bool, err error)

Used by docker

func ExtractInsecureTlsFromArgs

func ExtractInsecureTlsFromArgs(args []string) (cleanArgs []string, insecureTls bool, err error)

func ExtractLicensesFromArgs added in v2.10.0

func ExtractLicensesFromArgs(args []string) (cleanArgs []string, licenses bool, err error)

Used by docker scan (Xray)

func ExtractRepoPathFromArgs added in v2.10.0

func ExtractRepoPathFromArgs(args []string) (cleanArgs []string, repoPath string, err error)

Used by docker scan (Xray)

func ExtractServerIdFromCommand added in v2.10.0

func ExtractServerIdFromCommand(args []string) (cleanArgs []string, serverId string, err error)

func ExtractSkipLoginFromArgs added in v2.10.0

func ExtractSkipLoginFromArgs(args []string) (cleanArgs []string, skipLogin bool, err error)

Used by docker

func ExtractTagFromArgs added in v2.52.0

func ExtractTagFromArgs(args []string) (cleanArgs []string, tag string, err error)

func ExtractThreadsFromArgs added in v2.10.0

func ExtractThreadsFromArgs(args []string, defaultValue int) (cleanArgs []string, threads int, err error)

func ExtractWatchesFromArgs added in v2.10.0

func ExtractWatchesFromArgs(args []string) (cleanArgs []string, watches string, err error)

Used by docker scan (Xray)

func ExtractXrayOutputFormatFromArgs added in v2.4.1

func ExtractXrayOutputFormatFromArgs(args []string) (cleanArgs []string, format string, err error)

func ExtractXrayScanFromArgs

func ExtractXrayScanFromArgs(args []string) (cleanArgs []string, xrayScan bool, err error)

func FindBooleanFlag

func FindBooleanFlag(flagName string, args []string) (flagIndex int, flagValue bool, err error)

Boolean flag can be provided in one of the following forms: 1. --flag=value, where value can be true/false 2. --flag, here the value is true Return values: flagIndex - index of flagName in args. flagValue - value of flagName. err - error if flag exists, but we failed to extract its value. If flag does not exist flagIndex = -1 with false value and nil error.

func FindFlag

func FindFlag(flagName string, args []string) (flagIndex, flagValueIndex int, flagValue string, err error)

Find value of required CLI flag in Command. If flag does not exist, the returned index is -1 and nil is returned as the error. Return values: err - error if flag exists but failed to extract its value. flagIndex - index of flagName in Command. flagValueIndex - index in Command in which the value of the flag exists. flagValue - value of flagName.

func FindFlagFirstMatch

func FindFlagFirstMatch(flags, args []string) (flagIndex, flagValueIndex int, flagValue string, err error)

Find the first match of the provided flags in args. Return same values as FindFlag.

func GetCliConfigVersion added in v2.13.0

func GetCliConfigVersion() int

GetCliConfigVersion returns the latest version of the config.yml file on the file system at '.jfrog'.

func GetCliExecutableName added in v2.5.0

func GetCliExecutableName() string

func GetCliPersistentTempDirPath

func GetCliPersistentTempDirPath() string

Return the path of CLI temp dir. This path should be persistent, meaning - should not be cleared at the end of a CLI run.

func GetCliUserAgent

func GetCliUserAgent() string

func GetCliUserAgentName

func GetCliUserAgentName() string

func GetCliUserAgentVersion

func GetCliUserAgentVersion() string

func GetClientAgentName

func GetClientAgentName() string

func GetClientAgentVersion

func GetClientAgentVersion() string

func GetFullPathsWorkingDirs added in v2.41.5

func GetFullPathsWorkingDirs(workingDirs []string) ([]string, error)

Receives a list of relative path working dirs, returns a list of full paths working dirs

func GetJfrogBackupDir

func GetJfrogBackupDir() (string, error)

func GetJfrogCertsDir

func GetJfrogCertsDir() (string, error)

func GetJfrogConfigLockDir added in v2.2.0

func GetJfrogConfigLockDir() (string, error)

func GetJfrogHomeDir

func GetJfrogHomeDir() (string, error)

func GetJfrogLocksDir added in v2.2.0

func GetJfrogLocksDir() (string, error)

func GetJfrogPluginsDir

func GetJfrogPluginsDir() (string, error)

func GetJfrogPluginsLockDir added in v2.13.0

func GetJfrogPluginsLockDir() (string, error)

func GetJfrogPluginsResourcesDir added in v2.13.0

func GetJfrogPluginsResourcesDir(pluginsName string) (string, error)

func GetJfrogSecurityConfFilePath

func GetJfrogSecurityConfFilePath() (string, error)

func GetJfrogSecurityDir

func GetJfrogSecurityDir() (string, error)

func GetJfrogTransferDir added in v2.17.0

func GetJfrogTransferDir() (string, error)

func GetJfrogTransferLockDir added in v2.23.0

func GetJfrogTransferLockDir() (string, error)

func GetJfrogTransferRepositoriesDir added in v2.25.0

func GetJfrogTransferRepositoriesDir() (string, error)

func GetJfrogTransferRunStatusFilePath added in v2.23.0

func GetJfrogTransferRunStatusFilePath() (string, error)

func GetJfrogTransferTempDir added in v2.47.10

func GetJfrogTransferTempDir() (string, error)

func GetJsonIndent added in v2.46.0

func GetJsonIndent(o any) (strJson string, err error)

func GetMaskedCommandString added in v2.41.5

func GetMaskedCommandString(cmd *exec.Cmd) string

func GetOSAndArc added in v2.34.1

func GetOSAndArc() (string, error)

func GetPluginsConfigVersion added in v2.13.0

func GetPluginsConfigVersion() int

GetPluginsConfigVersion returns the latest plugins layout version on the file system (at '.jfrog/plugins').

func GetPluginsDirContent added in v2.13.0

func GetPluginsDirContent() ([]os.DirEntry, error)

func GetServerIdAndRepo added in v2.32.0

func GetServerIdAndRepo(remoteEnv string) (serverID string, repoName string, err error)

func GetWorkingDirectory

func GetWorkingDirectory() (string, error)

func IsAnyEmpty

func IsAnyEmpty(strings ...string) bool

func IsLinux

func IsLinux() bool

func IsMac added in v2.34.1

func IsMac() bool

func IsWindows

func IsWindows() bool

func ListToText added in v2.11.3

func ListToText(list []string) string

Turn a list of strings into a sentence. For example, turn ["one", "two", "three"] into "one, two and three". For a single element: "one".

func PanicOnError

func PanicOnError(err error) error

func PrepareTable added in v2.11.3

func PrepareTable(rows interface{}, emptyTableMessage string, printExtended bool) (table.Writer, error)

Creates table following the logic described in PrintTable. Returns: Table Writer (table.Writer) - Can be used to adjust style, output mirror, render type, etc. Error if occurred.

func PrintBold added in v2.7.2

func PrintBold(str string) string

Add bold style to the string if possible.

func PrintBoldTitle added in v2.28.0

func PrintBoldTitle(str string) string

Add bold and green style to the string if possible.

func PrintComment added in v2.7.2

func PrintComment(str string) string

Add gray color style to the string if possible.

func PrintLink(str string) string

Add cyan color style to the string if possible.

func PrintMessage added in v2.1.0

func PrintMessage(message string)

PrintMessage prints message in a frame (which is actually a table with a single table). For example: ┌─────────────────────────────────────────┐ │ An example of a message in a nice frame │ └─────────────────────────────────────────┘

func PrintTable added in v2.1.0

func PrintTable(rows interface{}, title string, emptyTableMessage string, printExtended bool) (err error)

func PrintTitle added in v2.7.2

func PrintTitle(str string) string

Add green color style to the string if possible.

func PrintYellow added in v2.41.1

func PrintYellow(str string) string

Add yellow color style to the string if possible.

func RemoveAllWhiteSpaces added in v2.11.3

func RemoveAllWhiteSpaces(input string) string

func RemoveEmojisIfNonSupportedTerminal added in v2.20.0

func RemoveEmojisIfNonSupportedTerminal(msg string) string

Remove emojis from non-supported terminals

func RemoveFlagFromCommand

func RemoveFlagFromCommand(args *[]string, flagIndex, flagValueIndex int)

Removes the provided flag and value from the command arguments

func ReplaceVars

func ReplaceVars(content []byte, specVars map[string]string) []byte

func SetCliExecutableName added in v2.5.0

func SetCliExecutableName(executableName string)

func SetCliUserAgentName

func SetCliUserAgentName(cliUserAgentNameToSet string)

func SetCliUserAgentVersion

func SetCliUserAgentVersion(versionToSet string)

func SetClientAgentName

func SetClientAgentName(clientAgentToSet string)

func SetClientAgentVersion

func SetClientAgentVersion(versionToSet string)

func SetIfEmpty

func SetIfEmpty(str *string, defaultStr string) bool

func SetPermissionsRecursively added in v2.41.7

func SetPermissionsRecursively(dirPath string, mode os.FileMode) error

func SpecVarsStringToMap

func SpecVarsStringToMap(rawVars string) map[string]string

func SumTrueValues

func SumTrueValues(boolArr []bool) int

Types

type CliError

type CliError struct {
	ExitCode
	ErrorMsg string
}

func (CliError) Error

func (err CliError) Error() string

type Credentials

type Credentials interface {
	SetUser(string)
	SetPassword(string)
	GetUser() string
	GetPassword() string
}

type ExitCode

type ExitCode struct {
	Code int
}

Exit codes:

func GetExitCode

func GetExitCode(err error, success, failed int, failNoOp bool) ExitCode

type GeneralExecCmd

type GeneralExecCmd struct {
	ExecPath string
	Command  []string
}

Command used to execute general commands.

func (*GeneralExecCmd) GetCmd

func (pluginCmd *GeneralExecCmd) GetCmd() *exec.Cmd

func (*GeneralExecCmd) GetEnv

func (pluginCmd *GeneralExecCmd) GetEnv() map[string]string

func (*GeneralExecCmd) GetErrWriter

func (pluginCmd *GeneralExecCmd) GetErrWriter() io.WriteCloser

func (*GeneralExecCmd) GetStdWriter

func (pluginCmd *GeneralExecCmd) GetStdWriter() io.WriteCloser

type OnError

type OnError string

Error modes (how should the application behave when the CheckError function is invoked):

type Profiler added in v2.47.4

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

This struct wraps the "pprof" profiler in Go. It is used for thread dumping.

func NewProfiler added in v2.47.4

func NewProfiler(opts ...ProfilerOption) *Profiler

func (*Profiler) ThreadDump added in v2.47.4

func (p *Profiler) ThreadDump() (output string, err error)

type ProfilerOption added in v2.47.4

type ProfilerOption func(*Profiler)

func WithInterval added in v2.47.4

func WithInterval(interval time.Duration) ProfilerOption

func WithRepetitions added in v2.47.4

func WithRepetitions(repetitions uint) ProfilerOption

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL