utils

Documentation

Index

• Constants
• func CreateFile(absPath string, payload io.Reader, opts ...FileOptionFunc) error
• func CreateIfNotExist(path string, defaultValue string) error
• func FileExists(fpath string) bool
• func GetFileName(fpath string) string
• func Int32Pointer(i int32) *int32
• func Int64Pointer(i int64) *int64
• func IntPointer(i int) *int
• func IsNil(p any) bool
• func LoadCSV[T any](inputPath string) ([]T, error)
• func NewCSVFilelistCallback(pattern string, rowProcessor sdkcsv.RecordProcessor) error
• func NewFileOpenCallback(fpath string, fn func(f *os.File) error) error
• func NewFilelistCallback(pattern string, f FileCallback) error
• func OpenFile(absPath string, opts ...FileOptionFunc) (*os.File, error)
• func ParseCSVFile(fpath string) (*csv.Reader, *os.File, error)
• func ParseTimeDuration(s string) (time.Duration, error)
• func ResolvePath(path string) (string, error)
• func SaveFile(absPath string, payload io.Reader) error
• func String(length int) string
• func StringPointer(s string) *string
• func StringWithCharset(length int, charset string) string
• func Uint32Pointer(i uint32) *uint32
• func Uint64Pointer(i uint64) *uint64
• func UintPointer(i uint) *uint
• func WriteCSV(absPath string, data any) error
• func WriteFile(absPath string, payload io.Reader, opts ...FileOptionFunc) error
• type FileCallback
• type FileOptionFunc
  • func WithBackup() FileOptionFunc
  • func WithCreate() FileOptionFunc
  • func WithReturnWriter(w *io.Writer) FileOptionFunc
• type FileOptions
• type SampleInt
• type SampleInt2

Constants

const (
	COUNTER2_A = 1<<iota + 2
	COUNTER2_B
	COUNTER2_C
	COUNTER2_D
)

const CHARSET = "abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789"

Functions

func CreateFile

func CreateFile(absPath string, payload io.Reader, opts ...FileOptionFunc) error

CreateFile is an alias for WriteFile.

func CreateIfNotExist

func CreateIfNotExist(path string, defaultValue string) error

CreateIfNotExist checks if a file exists at the given path. If the file does not exist, it creates one with the provided defaultValue. It supports "~" as the home directory.

func FileExists

func FileExists(fpath string) bool

func GetFileName

func GetFileName(fpath string) string

func Int32Pointer

func Int32Pointer(i int32) *int32

func Int64Pointer

func Int64Pointer(i int64) *int64

func IntPointer

func IntPointer(i int) *int

func IsNil

func IsNil(p any) bool

func LoadCSV

func LoadCSV[T any](inputPath string) ([]T, error)

LoadCSV 是一個泛型函數，能將 CSV 檔案直接解析為任意指定結構體 (Structure) 的切片 (Slice)

func NewCSVFilelistCallback

func NewCSVFilelistCallback(pattern string, rowProcessor sdkcsv.RecordProcessor) error

func NewFileOpenCallback

func NewFileOpenCallback(fpath string, fn func(f *os.File) error) error

func NewFilelistCallback

func NewFilelistCallback(pattern string, f FileCallback) error

func OpenFile

func OpenFile(absPath string, opts ...FileOptionFunc) (*os.File, error)

OpenFile opens or creates a file at absPath according to provided options.

func ParseCSVFile

func ParseCSVFile(fpath string) (*csv.Reader, *os.File, error)

func ParseTimeDuration

func ParseTimeDuration(s string) (time.Duration, error)

ParseHHMMSS converts a string of "HH:MM:SS" format to a time.Duration.

func ResolvePath

func ResolvePath(path string) (string, error)

Deprecated: use github.com/mitchellh/go-homedir or similar specialized package instead.

func SaveFile

func SaveFile(absPath string, payload io.Reader) error

Deprecated: use WriteFile instead.

func String

func String(length int) string

func StringPointer

func StringPointer(s string) *string

func StringWithCharset

func StringWithCharset(length int, charset string) string

func Uint32Pointer

func Uint32Pointer(i uint32) *uint32

func Uint64Pointer

func Uint64Pointer(i uint64) *uint64

func UintPointer

func UintPointer(i uint) *uint

func WriteCSV

func WriteCSV(absPath string, data any) error

WriteCSV writes data (either [][]string or a slice of structs) to a CSV file. If data is [][]string, it writes the raw rows using standard encoding/csv. Otherwise, it marshals the struct slice using gocsv.

func WriteFile

func WriteFile(absPath string, payload io.Reader, opts ...FileOptionFunc) error

WriteFile writes payload to absPath according to provided options. Default behavior is to fail if file doesn't exist, and override if it does.

Types

type FileCallback

type FileCallback func(string) error

type FileOptionFunc

type FileOptionFunc func(*FileOptions)

FileOptionFunc defines configuration builder for CreateFile.

func WithBackup

func WithBackup() FileOptionFunc

WithBackup enables recursive backup of existing files.

func WithCreate

func WithCreate() FileOptionFunc

WithCreate enables file creation if it doesn't exist.

func WithReturnWriter

func WithReturnWriter(w *io.Writer) FileOptionFunc

WithWriter allows retrieving the opened writer.

type FileOptions

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

type SampleInt

type SampleInt int

const (
	COUNTER_A SampleInt = iota + 100 // 111111
	COUNTER_B                        // 222222
	COUNTER_C                        // 333333
	COUNTER_D                        // 444444
)

123123sjdasio

type SampleInt2

type SampleInt2 int

const (
	COUNTER1_A SampleInt2 = iota
	COUNTER1_B
	COUNTER1_C
	COUNTER1_D
	COUNTER1_E
	COUNTER1_F
	COUNTER1_G
	COUNTER1_H
	COUNTER1_I
	COUNTER1_J
	COUNTER1_K
	COUNTER1_L
	COUNTER1_M
)