Documentation ¶
Overview ¶
Package constants contains constant values that are used throughout Steampipe
Index ¶
- Constants
- Variables
- func ArgFromMetaquery(cmd string) string
- func BoldBlack(arg interface{}) aurora.Value
- func BoldBlue(arg interface{}) aurora.Value
- func BoldBrightBlack(arg interface{}) aurora.Value
- func BoldBrightBlue(arg interface{}) aurora.Value
- func BoldBrightCyan(arg interface{}) aurora.Value
- func BoldBrightGreen(arg interface{}) aurora.Value
- func BoldBrightMagenta(arg interface{}) aurora.Value
- func BoldBrightRed(arg interface{}) aurora.Value
- func BoldBrightWhite(arg interface{}) aurora.Value
- func BoldBrightYellow(arg interface{}) aurora.Value
- func BoldCyan(arg interface{}) aurora.Value
- func BoldGreen(arg interface{}) aurora.Value
- func BoldMagenta(arg interface{}) aurora.Value
- func BoldRed(arg interface{}) aurora.Value
- func BoldWhite(arg interface{}) aurora.Value
- func BoldYellow(arg interface{}) aurora.Value
- func BoolToEnableDisable(val bool) string
- func BoolToOnOff(val bool) string
- func Gray1(arg interface{}) aurora.Value
- func Gray2(arg interface{}) aurora.Value
- func Gray3(arg interface{}) aurora.Value
- func Gray4(arg interface{}) aurora.Value
- func Gray5(arg interface{}) aurora.Value
- func IsYamlExtension(ext string) bool
- type Invoker
Constants ¶
const ( AppName = "steampipe" FdwName = "steampipe-postgres-fdw" )
const ( ClientConnectionAppNamePrefix = "steampipe_client" ServiceConnectionAppNamePrefix = "steampipe_service" ClientSystemConnectionAppNamePrefix = "steampipe_client_system" )
const ( ArgHelp = "help" ArgVersion = "version" ArgForce = "force" ArgAll = "all" ArgTiming = "timing" ArgOn = "on" ArgOff = "off" ArgClear = "clear" ArgDatabaseListenAddresses = "database-listen" ArgDatabasePort = "database-port" ArgDatabaseQueryTimeout = "query-timeout" ArgServicePassword = "database-password" ArgServiceShowPassword = "show-password" ArgDashboard = "dashboard" ArgDashboardListen = "dashboard-listen" ArgDashboardPort = "dashboard-port" ArgDashboardStartTimeout = "dashboard-start-timeout" ArgSkipConfig = "skip-config" ArgForeground = "foreground" ArgInvoker = "invoker" ArgUpdateCheck = "update-check" ArgTelemetry = "telemetry" ArgInstallDir = "install-dir" ArgWorkspaceDatabase = "workspace-database" ArgSchemaComments = "schema-comments" ArgCloudHost = "cloud-host" ArgCloudToken = "cloud-token" ArgSearchPath = "search-path" ArgSearchPathPrefix = "search-path-prefix" ArgWatch = "watch" ArgTheme = "theme" ArgProgress = "progress" ArgExport = "export" ArgMaxParallel = "max-parallel" ArgLogLevel = "log-level" ArgDryRun = "dry-run" ArgWhere = "where" ArgTag = "tag" ArgVariable = "var" ArgVarFile = "var-file" ArgConnectionString = "connection-string" ArgDisplayWidth = "display-width" ArgPrune = "prune" ArgModInstall = "mod-install" ArgServiceMode = "service-mode" ArgBrowser = "browser" ArgInput = "input" ArgDashboardInput = "dashboard-input" ArgMaxCacheSizeMb = "max-cache-size-mb" ArgCacheTtl = "cache-ttl" ArgClientCacheEnabled = "client-cache-enabled" ArgServiceCacheEnabled = "service-cache-enabled" ArgCacheMaxTtl = "cache-max-ttl" ArgIntrospection = "introspection" ArgSnapshot = "snapshot" ArgSnapshotTag = "snapshot-tag" ArgWorkspaceProfile = "workspace" ArgModLocation = "mod-location" ArgSnapshotLocation = "snapshot-location" ArgSnapshotTitle = "snapshot-title" ArgDatabaseStartTimeout = "database-start-timeout" ArgMemoryMaxMb = "memory-max-mb" ArgMemoryMaxMbPlugin = "memory-max-mb-plugin" )
Argument name constants
const ( CmdNameQuery = "query" CmdNameCheck = "check" CmdNameDashboard = "dashboard" )
const ( ConfigKeyInteractive = "interactive" ConfigKeyActiveCommand = "cmd" ConfigKeyActiveCommandArgs = "cmd_args" ConfigInteractiveVariables = "interactive_var" ConfigKeyIsTerminalTTY = "is_terminal" ConfigKeyServerSearchPath = "server-search-path" ConfigKeyServerSearchPathPrefix = "server-search-path-prefix" )
viper config keys
const ( // ControlQueryCancellationTimeoutSecs is maximum number of seconds to wait for control queries to finish cancelling ControlQueryCancellationTimeoutSecs = 30 // MaxControlRunAttempts determines how many time should a cotnrol run should be retried // in the case of a GRPC connectivity error MaxControlRunAttempts = 2 )
const ( ControlOk = "ok" ControlAlarm = "alarm" ControlSkip = "skip" ControlInfo = "info" ControlError = "error" )
const ( DashboardServerDefaultPort = 9194 DashboardAssetsImageRefFormat = "us-docker.pkg.dev/steampipe/steampipe/assets:%s" )
const ( // MaxParallelClientInits is the number of clients to initialize in parallel // if we start initializing all clients together, it leads to bad performance on all MaxParallelClientInits = 3 // MaxBackups is the maximum number of backups that will be retained MaxBackups = 100 )
Client constants
const ( DatabaseDefaultListenAddresses = "localhost" DatabaseDefaultPort = 9193 DatabaseDefaultCheckQueryTimeout = 240 DatabaseSuperUser = "root" DatabaseUser = "steampipe" DatabaseName = "steampipe" DatabaseUsersRole = "steampipe_users" DefaultMaxConnections = 10 )
const ( DatabaseVersion = "14.2.0" FdwVersion = "1.8.0-rc.5" // PostgresImageRef is the OCI Image ref for the database binaries PostgresImageRef = "us-docker.pkg.dev/steampipe/steampipe/db:14.2.0" PostgresImageDigest = "sha256:a75637209f1bc2fa9885216f7972dfa0d82010a25d3cbfc07baceba8d16f4a93" FdwImageRef = "us-docker.pkg.dev/steampipe/steampipe/fdw:" + FdwVersion FdwBinaryFileName = "steampipe_postgres_fdw.so" )
constants for installing db and fdw images
const ( // legacy schema names // these are schema names which were used previously // but are not relevant anymore and need to be dropped LegacyInternalSchema = "internal" // InternalSchema is the schema container for all steampipe helper functions, and connection state table // also used to send commands to the FDW InternalSchema = "steampipe_internal" // ServerSettingsTable is the table used to store steampipe service configuration ServerSettingsTable = "steampipe_server_settings" // RateLimiterDefinitionTable is the table used to store rate limiters defined in the config RateLimiterDefinitionTable = "steampipe_rate_limiter" // ConnectionStateTable is the table used to store steampipe connection state ConnectionStateTable = "steampipe_connection_state" ConnectionStatePending = "pending" ConnectionStatePendingIncomplete = "incomplete" ConnectionStateReady = "ready" ConnectionStateUpdating = "updating" ConnectionStateDeleting = "deleting" ConnectionStateDisabled = "disabled" ConnectionStateError = "error" // foreign tables in internal schema ForeignTableScanMetadata = "steampipe_scan_metadata" ForeignTableSettings = "steampipe_settings" ForeignTableSettingsKeyColumn = "name" ForeignTableSettingsValueColumn = "value" ForeignTableSettingsCacheKey = "cache" ForeignTableSettingsCacheTtlKey = "cache_ttl" ForeignTableSettingsCacheClearTimeKey = "cache_clear_time" FunctionCacheSet = "meta_cache" FunctionCacheSetTtl = "meta_cache_ttl" // legacy LegacyCommandSchema = "steampipe_command" LegacyCommandTableCache = "cache" LegacyCommandTableCacheOperationColumn = "operation" LegacyCommandCacheOn = "cache_on" LegacyCommandCacheOff = "cache_off" LegacyCommandCacheClear = "cache_clear" LegacyCommandTableScanMetadata = "scan_metadata" )
schema names
const ( IntrospectionTableQuery = "steampipe_query" IntrospectionTableControl = "steampipe_control" IntrospectionTableBenchmark = "steampipe_benchmark" IntrospectionTableMod = "steampipe_mod" IntrospectionTableDashboard = "steampipe_dashboard" IntrospectionTableDashboardContainer = "steampipe_dashboard_container" IntrospectionTableDashboardCard = "steampipe_dashboard_card" IntrospectionTableDashboardChart = "steampipe_dashboard_chart" IntrospectionTableDashboardFlow = "steampipe_dashboard_flow" IntrospectionTableDashboardGraph = "steampipe_dashboard_graph" IntrospectionTableDashboardHierarchy = "steampipe_dashboard_hierarchy" IntrospectionTableDashboardImage = "steampipe_dashboard_image" IntrospectionTableDashboardInput = "steampipe_dashboard_input" IntrospectionTableDashboardTable = "steampipe_dashboard_table" IntrospectionTableDashboardText = "steampipe_dashboard_text" IntrospectionTableVariable = "steampipe_variable" IntrospectionTableReference = "steampipe_reference" )
introspection table names
const ( // InvokerService is set when invoked by `service start` InvokerService Invoker = "service" // InvokerQuery is set when invoked by query command InvokerQuery = "query" // InvokerCheck is set when invoked by check command InvokerCheck = "check" // InvokerPlugin is set when invoked by a plugin command InvokerPlugin = "plugin" // InvokerDashboard is set when invoked by dashboard command InvokerDashboard = "dashboard" // InvokerConnectionWatcher is set when invoked by the connection watcher process InvokerConnectionWatcher = "connection-watcher" )
const ( // SpinnerShowTimeout is the duration after which spinner should be shown SpinnerShowTimeout = 1 * time.Second MaxColumnWidth = 1024 // NullString is the string which is displayed for null column values NullString = "<null>" )
Display constants
const ( EnvUpdateCheck = "STEAMPIPE_UPDATE_CHECK" EnvInstallDir = "STEAMPIPE_INSTALL_DIR" EnvInstallDatabase = "STEAMPIPE_INITDB_DATABASE_NAME" EnvServicePassword = "STEAMPIPE_DATABASE_PASSWORD" EnvMaxParallel = "STEAMPIPE_MAX_PARALLEL" EnvDatabaseStartTimeout = "STEAMPIPE_DATABASE_START_TIMEOUT" EnvDashboardStartTimeout = "STEAMPIPE_DASHBOARD_START_TIMEOUT" EnvSnapshotLocation = "STEAMPIPE_SNAPSHOT_LOCATION" EnvWorkspaceDatabase = "STEAMPIPE_WORKSPACE_DATABASE" EnvWorkspaceProfile = "STEAMPIPE_WORKSPACE" EnvCloudHost = "STEAMPIPE_CLOUD_HOST" EnvCloudToken = "STEAMPIPE_CLOUD_TOKEN" EnvPipesHost = "PIPES_HOST" EnvPipesToken = "PIPES_TOKEN" EnvDisplayWidth = "STEAMPIPE_DISPLAY_WIDTH" EnvCacheEnabled = "STEAMPIPE_CACHE" EnvCacheTTL = "STEAMPIPE_CACHE_TTL" EnvCacheMaxTTL = "STEAMPIPE_CACHE_MAX_TTL" EnvCacheMaxSize = "STEAMPIPE_CACHE_MAX_SIZE_MB" EnvQueryTimeout = "STEAMPIPE_QUERY_TIMEOUT" EnvConnectionWatcher = "STEAMPIPE_CONNECTION_WATCHER" EnvWorkspaceChDir = "STEAMPIPE_WORKSPACE_CHDIR" EnvModLocation = "STEAMPIPE_MOD_LOCATION" EnvTelemetry = "STEAMPIPE_TELEMETRY" EnvIntrospection = "STEAMPIPE_INTROSPECTION" EnvWorkspaceProfileLocation = "STEAMPIPE_WORKSPACE_PROFILES_LOCATION" // EnvInputVarPrefix is the prefix for environment variables that represent values for input variables. EnvInputVarPrefix = "SP_VAR_" // EnvConfigDump is an undocumented variable is subject to change in the future EnvConfigDump = "STEAMPIPE_CONFIG_DUMP" EnvMemoryMaxMb = "STEAMPIPE_MEMORY_MAX_MB" EnvMemoryMaxMbPlugin = "STEAMPIPE_PLUGIN_MEMORY_MAX_MB" )
Environment Variables
const ( ExitCodeSuccessful = 0 ExitCodeControlsAlarm = 1 // check - no runtime errors, 1 or more control alarms, no control errors ExitCodeControlsError = 2 // check - no runtime errors, 1 or more control errors ExitCodePluginLoadingError = 11 // plugin - loading error ExitCodePluginListFailure = 12 // plugin - listing failed ExitCodePluginNotFound = 13 // plugin - not found ExitCodePluginInstallFailure = 14 // plugin - install failed ExitCodeSnapshotCreationFailed = 21 // snapshot - creation failed ExitCodeSnapshotUploadFailed = 22 // snapshot - upload failed ExitCodeServiceSetupFailure = 31 // service - setup failed ExitCodeServiceStartupFailure = 32 // service - start failed ExitCodeServiceStopFailure = 33 // service - stop failed ExitCodeQueryExecutionFailed = 41 // query - 1 or more queries failed - change in behavior(previously the exitCode used to be the number of queries that failed) ExitCodeLoginCloudConnectionFailed = 51 // login - connecting to cloud failed ExitCodeModInitFailed = 61 // mod - init failed ExitCodeModInstallFailed = 62 // mod - install failed ExitCodeInvalidExecutionEnvironment = 249 // common - when steampipe is run in an unsupported environment ExitCodeInitializationFailed = 250 // common - initialization failed ExitCodeNoModFile = 252 // common - no mod file ExitCodeFileSystemAccessFailure = 253 // common - file system access failed ExitCodeInsufficientOrWrongInputs = 254 // common - runtime error(insufficient or wrong input) ExitCodeUnknownErrorPanic = 255 // common - runtime error(unknown panic) )
const ( PluginExtension = ".plugin" ConfigExtension = ".spc" SqlExtension = ".sql" MarkdownExtension = ".md" ModDataExtension = ".sp" VariablesExtension = ".spvars" AutoVariablesExtension = ".auto.spvars" JsonExtension = ".json" CsvExtension = ".csv" TextExtension = ".txt" SnapshotExtension = ".sps" TokenExtension = ".tptt" LegacyTokenExtension = ".sptt" )
const ( HistoryFile = "history.json" // File to store historical data HistorySize = 500 // Number of historical records to store )
Constants for History
const ( IntrospectionNone = "none" IntrospectionInfo = "info" IntrospectionControl = "control" )
constants for introspection config flag
const ( CmdTableList = ".tables" // List all tables CmdOutput = ".output" // Set output mode CmdTiming = ".timing" // Toggle query timer CmdHeaders = ".header" // Toggle headers output CmdSeparator = ".separator" // Set the column separator CmdExit = ".exit" // Exit the interactive prompt CmdQuit = ".quit" // Alias for .exit CmdInspect = ".inspect" // inspect CmdConnections = ".connections" // list all connections CmdMulti = ".multi" // toggle multi line query CmdClear = ".clear" // clear the console CmdHelp = ".help" // list all meta commands CmdSearchPath = ".search_path" // Set or show search-path CmdSearchPathPrefix = ".search_path_prefix" // set search path prefix CmdCache = ".cache" // cache control CmdCacheTtl = ".cache_ttl" // set cache ttl CmdAutoComplete = ".autocomplete" // enable or disable auto complete )
const ( OutputFormatCSV = "csv" OutputFormatJSON = "json" OutputFormatTable = "table" OutputFormatLine = "line" OutputFormatNone = "none" OutputFormatText = "text" OutputFormatBrief = "brief" OutputFormatSnapshot = "snapshot" OutputFormatSnapshotShort = "sps" )
const ( ArchAMD64 = "amd64" ArchARM64 = "arm64" OSLinux = "linux" OSDarwin = "darwin" )
const ( InstallMessagePluginAlreadyInstalled = "Already installed" InstallMessagePluginLatestAlreadyInstalled = "Latest already installed" InstallMessagePluginNotInstalled = "Not installed" InstallMessagePluginNotFound = "Not found" ConnectionErrorPluginFailedToStart = "plugin failed to start" ConnectionErrorPluginNotInstalled = "plugin not installed" SteampipeHubOCIBase = "hub.steampipe.io/" )
const ( ServerCertKey = "server.key" RootCertKey = "root.key" ServerCert = "server.crt" RootCert = "root.crt" SslConfDir = "/etc/ssl" )
constants for ssl key and certificate
const ( TelemetryNone = "none" TelemetryInfo = "info" )
constants for telemetry config flag
const ( DefaultCloudHost = "pipes.turbot.com" LegacyDefaultCloudHost = "cloud.steampipe.io" DefaultWorkspaceDatabase = "local" )
const DefaultConnectionConfigContent = `` /* 1537-byte string literal not displayed */
DefaultConnectionConfigContent is the content of the sample connection config file(default.spc.sample), that is created if it does not exist
const DefaultMaxCacheSizeMb = 16384
const DefaultWorkspaceContent = `` /* 1453-byte string literal not displayed */
DefaultWorkspaceContent is the content of the sample workspaces config file(workspaces.spc.sample), that is created if it does not exist
const (
PostgresNotificationChannel = "steampipe_notification"
)
const PostgresqlConfContent = `` /* 810-byte string literal not displayed */
const ReservedConnectionNamePrefix = "steampipe_"
const (
RuntimeParamsKeyApplicationName = "application_name"
)
const SteampipeConfContent = `` /* 1556-byte string literal not displayed */
Variables ¶
var ( // OptLeftArrowASCIICode :: OptLeftArrowASCIICode = []byte{0x1b, 0x62} // OptRightArrowASCIICode :: OptRightArrowASCIICode = []byte{0x1b, 0x66} // AltLeftArrowASCIICode :: AltLeftArrowASCIICode = []byte{0x1b, 0x1b, 0x5B, 0x44} // AltRightArrowASCIICode :: AltRightArrowASCIICode = []byte{0x1b, 0x1b, 0x5B, 0x43} )
var ( ColoredErr = color.RedString("Error") ColoredWarn = color.YellowString("Warning") )
var ( DashboardStartTimeout = 30 * time.Second DBStartTimeout = 30 * time.Second DBConnectionRetryBackoff = 200 * time.Millisecond DBRecoveryTimeout = 24 * time.Hour DBRecoveryRetryBackoff = 200 * time.Millisecond ServicePingInterval = 50 * time.Millisecond )
var ArgAutoComplete = ArgFromMetaquery(CmdAutoComplete)
var ArgHeader = ArgFromMetaquery(CmdHeaders)
var ArgMultiLine = ArgFromMetaquery(CmdMulti)
var ArgOutput = ArgFromMetaquery(CmdOutput)
var ArgSeparator = ArgFromMetaquery(CmdSeparator)
var Black = aurora.Black
var Blink = aurora.Blink
var Blue = aurora.Blue
var Bold = aurora.Bold
var BrightBlack = aurora.BrightBlack
var BrightBlue = aurora.BrightBlue
var BrightCyan = aurora.BrightCyan
var BrightGreen = aurora.BrightGreen
var BrightMagenta = aurora.BrightMagenta
var BrightRed = aurora.BrightRed
var BrightWhite = aurora.BrightWhite
var BrightYellow = aurora.BrightYellow
var Colors = map[string]func(arg interface{}) aurora.Value{ "bold": Bold, "italic": Italic, "underline": Underline, "slow-blink": SlowBlink, "black": Black, "red": Red, "green": Green, "yellow": Yellow, "blue": Blue, "magenta": Magenta, "cyan": Cyan, "white": White, "bold-black": BoldBlack, "bold-red": BoldRed, "bold-green": BoldGreen, "bold-yellow": BoldYellow, "bold-blue": BoldBlue, "bold-magenta": BoldMagenta, "bold-cyan": BoldCyan, "bold-white": BoldWhite, "bright-black": BrightBlack, "bright-red": BrightRed, "bright-green": BrightGreen, "bright-yellow": BrightYellow, "bright-blue": BrightBlue, "bright-magenta": BrightMagenta, "bright-cyan": BrightCyan, "bright-white": BrightWhite, "bold-bright-black": BoldBrightBlack, "bold-bright-red": BoldBrightRed, "bold-bright-green": BoldBrightGreen, "bold-bright-yellow": BoldBrightYellow, "bold-bright-blue": BoldBrightBlue, "bold-bright-magenta": BoldBrightMagenta, "bold-bright-cyan": BoldBrightCyan, "bold-bright-white": BoldBrightWhite, "gray1": Gray1, "gray2": Gray2, "gray3": Gray3, "gray4": Gray4, "gray5": Gray5, }
Colors is a map of string to aurora colour value
var ConnectionConfigExtensions = append(YamlExtensions, ConfigExtension, JsonExtension)
var ConnectionStates = []string{ ConnectionStateTable, ConnectionStatePending, ConnectionStateReady, ConnectionStateUpdating, ConnectionStateDeleting, ConnectionStateError, }
ConnectionStates is a handy array of all states
var Cyan = aurora.Cyan
var (
DashboardAssetsImageRef = fmt.Sprintf(DashboardAssetsImageRefFormat, version.VersionString)
)
var DashboardListenAddresses = []string{"localhost", "127.0.0.1"}
DashboardListenAddresses is an arrays is listen addresses which Steampipe accepts
var Green = aurora.Green
var Italic = aurora.Italic
var Magenta = aurora.Magenta
var MinimalPgHbaContent string = `
hostssl all root samehost trust
host all root samehost trust
`
var PgHbaTemplate string = `` /* 1099-byte string literal not displayed */
PgHbaTemplate is to be formatted with two variables:
- databaseName
- username
Example:
fmt.Sprintf(template, datName, username)
var Red = aurora.Red
var ReservedConnectionNames = []string{
"public",
}
var SlowBlink = aurora.SlowBlink
var TelemetryLevels = []string{TelemetryNone, TelemetryInfo}
var Underline = aurora.Underline
var White = aurora.White
var YamlExtensions = []string{".yml", ".yaml"}
var Yellow = aurora.Yellow
Functions ¶
func ArgFromMetaquery ¶
ArgFromMetaquery converts a metaquery of form '.header' into the config argument used to set the mode, i.e. 'header'
func BoldBrightBlack ¶
func BoldBrightBlue ¶
func BoldBrightCyan ¶
func BoldBrightGreen ¶
func BoldBrightMagenta ¶
func BoldBrightRed ¶
func BoldBrightWhite ¶
func BoldBrightYellow ¶
func BoldMagenta ¶
func BoldYellow ¶
func BoolToEnableDisable ¶
BoolToEnableDisable converts a boolean value onto the string "enable" or "disable"
func BoolToOnOff ¶
BoolToOnOff converts a boolean value onto the string "on" or "off"
func IsYamlExtension ¶
Types ¶
Source Files ¶
- app.go
- args.go
- ascii.go
- cache.go
- cmd_name.go
- colors.go
- config_keys.go
- control_execute.go
- control_status.go
- dashboard.go
- db.go
- default_options.go
- default_workspaces.go
- display.go
- doc.go
- duration.go
- env.go
- exit_codes.go
- extensions.go
- history.go
- introspection.go
- metaquery_commands.go
- notifications.go
- output_format.go
- pg_hba.go
- platform.go
- plugin.go
- postgresql_conf.go
- ssl.go
- telemetry.go
- workspace_profile.go