util

Documentation

Index

• func AfterLog()
• func BeforeLog()
• func BuildDataURL(mimeType string, data []byte) string
• func Contains(list []string, item string, ignoreCase bool) bool
• func DecodeBase64String(data string) ([]byte, error)
• func DownloadAndExtractZip(urlStr, destDir string) error
• func EndWithNewline(s string) bool
• func Errorf(cmd *cobra.Command, format string, args ...interface{})
• func Errorln(cmd *cobra.Command, args ...interface{})
• func ExtractThinkTags(content string) (thinking, cleaned string)
• func FormatMinutesSeconds(d time.Duration) string
• func GenerateTempFileName() string
• func GetBase64String(data []byte) string
• func GetFileContent(filePath string) (string, error)
• func GetGitHubZipURL(urlStr string) string
• func GetSanitizeTitle(title string) string
• func GetStringValue(data map[string]any, key string) string
• func GetUserConfigDir() string
• func HasContent(s *string) bool
• func HasGit() bool
• func InitLogger()
• func InjectThinkTags(content, thinking string) string
• func IsEmpty(s string) bool
• func IsGitHubURL(urlStr string) bool
• func JoinFilePath(dir string, filename string) string
• func LogDebugf(format string, args ...interface{})
• func LogDebugln(args ...interface{})
• func LogErrorf(format string, args ...interface{})
• func LogErrorln(args ...interface{})
• func LogInfof(format string, args ...interface{})
• func LogInfoln(args ...interface{})
• func LogSuccessf(format string, args ...interface{})
• func LogSuccessln(args ...interface{})
• func LogWarnf(format string, args ...interface{})
• func LogWarnln(args ...interface{})
• func MakeUserSubDir(subparts ...string) string
• func ParseDataURL(dataURL string) (string, []byte, error)
• func Print(cmd *cobra.Command, args ...interface{})
• func Printf(cmd *cobra.Command, format string, args ...interface{})
• func Println(cmd *cobra.Command, args ...interface{})
• func RegisterLoggerHook(h LoggerHook)
• func SetLoggerLevel(level log.Level)
• func Successf(cmd *cobra.Command, format string, args ...interface{})
• func Successln(cmd *cobra.Command, args ...interface{})
• func TruncateString(s string, maxLen int) string
• func ValidateResourceName(resourceType, name string) error
• func Warnf(cmd *cobra.Command, format string, args ...interface{})
• func Warnln(cmd *cobra.Command, args ...interface{})
• func WriteFileContent(path, content string) error
• type LoggerHook
• type ProgressWriter
  • func (pw *ProgressWriter) Write(p []byte) (int, error)

Functions

func AfterLog

func AfterLog()

func BeforeLog

func BeforeLog()

func BuildDataURL

func BuildDataURL(mimeType string, data []byte) string

BuildDataURL constructs a data URL string from MIME type and raw bytes. Example: "image/png", []byte -> "data:image/png;base64,iVBORw0KGgo..."

func Contains

func Contains(list []string, item string, ignoreCase bool) bool

func DecodeBase64String

func DecodeBase64String(data string) ([]byte, error)

DecodeBase64String decodes a base64 encoded string to raw bytes.

func DownloadAndExtractZip

func DownloadAndExtractZip(urlStr, destDir string) error

DownloadAndExtractZip downloads a zip file from the given URL and extracts it to the target directory. It creates the target directory if it doesn't exist. This function expects the zip file to contain a single root directory (like GitHub zips do) and extracts the *contents* of that root directory directly into destDir.

func EndWithNewline

func EndWithNewline(s string) bool

func Errorf

func Errorf(cmd *cobra.Command, format string, args ...interface{})

Errorf prints an error message to the command's designated error output stream.

func Errorln

func Errorln(cmd *cobra.Command, args ...interface{})

Errorln prints an error message with a newline to the command's error output stream.

func ExtractThinkTags

func ExtractThinkTags(content string) (thinking, cleaned string)

ExtractThinkTags extracts thinking content from <think>...</think> tags. Some providers (like MiniMax, some Qwen endpoints) embed reasoning content in <think> tags within the regular content field instead of using a separate reasoning_content field.

Returns:

• thinking: the extracted thinking content (empty if no tags found)
• cleaned: the content with <think> tags removed

func FormatMinutesSeconds

func FormatMinutesSeconds(d time.Duration) string

func GenerateTempFileName

func GenerateTempFileName() string

func GetBase64String

func GetBase64String(data []byte) string

GetBase64String returns the base64 encoded string of the given data.

func GetFileContent

func GetFileContent(filePath string) (string, error)

func GetGitHubZipURL

func GetGitHubZipURL(urlStr string) string

GetGitHubZipURL converts a GitHub repository clone URL to its zip archive download URL.

func GetSanitizeTitle

func GetSanitizeTitle(title string) string

func GetStringValue

func GetStringValue(data map[string]any, key string) string

Helper function to safely extract string values

func GetUserConfigDir

func GetUserConfigDir() string

func HasContent

func HasContent(s *string) bool

func HasGit

func HasGit() bool

HasGit checks if the git executable is available in the system PATH.

func InitLogger

func InitLogger()

func InjectThinkTags

func InjectThinkTags(content, thinking string) string

InjectThinkTags cleanly prepends reasoning logic wrapped in <think> tags to the primary content area. This is essential for officially preserving continuous "internal monologue" back to OpenRouter/DeepSeek instances within generic API clients that only accept a single `content` string.

func IsEmpty

func IsEmpty(s string) bool

func IsGitHubURL

func IsGitHubURL(urlStr string) bool

IsGitHubURL checks if the given URL is a standard GitHub repository URL.

func JoinFilePath

func JoinFilePath(dir string, filename string) string

func LogDebugf

func LogDebugf(format string, args ...interface{})

func LogDebugln

func LogDebugln(args ...interface{})

func LogErrorf

func LogErrorf(format string, args ...interface{})

func LogErrorln

func LogErrorln(args ...interface{})

func LogInfof

func LogInfof(format string, args ...interface{})

func LogInfoln

func LogInfoln(args ...interface{})

func LogSuccessf

func LogSuccessf(format string, args ...interface{})

func LogSuccessln

func LogSuccessln(args ...interface{})

func LogWarnf

func LogWarnf(format string, args ...interface{})

func LogWarnln

func LogWarnln(args ...interface{})

func MakeUserSubDir

func MakeUserSubDir(subparts ...string) string

func ParseDataURL

func ParseDataURL(dataURL string) (string, []byte, error)

ParseDataURL extracts the MIME type and base64-decoded raw bytes from a data URL string. Example: "data:image/png;base64,iVBORw0KGgo..." -> "image/png", []byte, nil

func Print

func Print(cmd *cobra.Command, args ...interface{})

Print formats and prints text to the command's designated standard output stream.

func Printf

func Printf(cmd *cobra.Command, format string, args ...interface{})

Printf formats and prints text to the command's designated standard output stream.

func Println

func Println(cmd *cobra.Command, args ...interface{})

Println prints text with a trailing newline to the command's designated standard output stream.

func RegisterLoggerHook

func RegisterLoggerHook(h LoggerHook)

RegisterLoggerHook registers a hook to be called before and after logging.

func SetLoggerLevel

func SetLoggerLevel(level log.Level)

func Successf

func Successf(cmd *cobra.Command, format string, args ...interface{})

Successf prints a success message to the command's output stream.

func Successln

func Successln(cmd *cobra.Command, args ...interface{})

Successln prints a success message with a newline to the command's output stream.

func TruncateString

func TruncateString(s string, maxLen int) string

Helper function to truncate strings with ellipsis

func ValidateResourceName

func ValidateResourceName(resourceType, name string) error

ValidateResourceName checks if the name is filesystem-safe.

func Warnf

func Warnf(cmd *cobra.Command, format string, args ...interface{})

Warnf prints a warning message to the command's designated error output stream.

func Warnln

func Warnln(cmd *cobra.Command, args ...interface{})

Warnln prints a warning message with a newline to the command's error output stream.

func WriteFileContent

func WriteFileContent(path, content string) error

Types

type LoggerHook

type LoggerHook interface {
	BeforeLog() bool // Returns true if indicator was active
	AfterLog(wasActive bool)
}

LoggerHook defines an interface for external components to intercept logging and handle UI-specific tasks like stopping/restarting indicators.

type ProgressWriter

type ProgressWriter struct {
	Total      int64
	Downloaded int64
}

ProgressWriter tracks the number of bytes written to it.

func (*ProgressWriter) Write

func (pw *ProgressWriter) Write(p []byte) (int, error)