render

package
v0.1.1 Latest Latest
Warning

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

 Go to latest Published: May 31, 2025 License: MIT Imports: 23 Imported by: 0

Documentation

Index

Constants

View Source 
const (
	DefaultBorder     = '\ue0b0'
	DefaultBarBGColor = "#353533"
	DynamicWidth      = -1
)
View Source 
const Version = "v0.1.1"

Variables

View Source 
var (
	TableHeaderStyle = lipgloss.NewStyle().
						Bold(true).
						BorderStyle(lipgloss.ThickBorder()).
						BorderForeground(lipgloss.Color("240")).
						BorderBottom(true)

	TopHeaderStyle = lipgloss.NewStyle().
					Inherit(TableHeaderStyle).
					BorderTop(true).
					BorderStyle(lipgloss.NormalBorder())

	SelectedRowStyle = lipgloss.NewStyle().
						Foreground(lipgloss.Color("#262626")).
						Background(lipgloss.Color("#ebbd34")).
						Bold(false)
)

Functions

func EntryIcon 

func EntryIcon(e *structure.Entry) string

EntryIcon resolves an emoji icon for the provided Entry instance based on the file extension.

func NewProgressBar 

func NewProgressBar(width int, full, empty rune) progress.Model

func NewStatusBar 

func NewStatusBar(items []*BarItem, totalWidth int) string

NewStatusBar builds a new status bar based on the provided list of *BarItem instances. The total bar width is defined by the totalWidth parameter and all bar items will be fit in that width according to their parameters or evenly spread for the available width.

NOTE: This implementation does not guarantee that the manually defined element sizes will not exceed the totalWidth value.

func ReportError added in v0.1.1 

func ReportError(err error, stackTrace []byte) string

ReportError formats an occurred application error and prints the full report to the standard output. The report will contain the error message, the stack trace, and the info on how to report an issue.

func SetTeaProgram 

func SetTeaProgram(tp *tea.Program)

Types

type BarItem 

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

BarItem represents a single status bar item, including its string content, background color, and width. The width parameter is optional, and the default width equals the content width.

The width value -1 denotes that the item will take all available screen width minus the sum of all other elements' widths. If multiple items have a width value of -1, the resulting width will be spread equally between them.

func DefaultBarItem 

func DefaultBarItem(content string) *BarItem

DefaultBarItem returns a new *BarItem instance with default values for background color and width.

func NewBarItem 

func NewBarItem(content, bgColor string, width int) *BarItem

NewBarItem returns a new *BarItem instance based on the provided parameters. If the background color is an empty string, a default color will be assigned.

type Column 

type Column struct {
	Title   string
	SortKey drive.SortKey
	Width   int
}

func (*Column) FmtName 

func (c *Column) FmtName(sortState SortState) string

type DirModel 

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

func NewDirModel 

func NewDirModel(nav *Navigation) *DirModel

func (*DirModel) Init 

func (dm *DirModel) Init() tea.Cmd

func (*DirModel) Update 

func (dm *DirModel) Update(msg tea.Msg) (tea.Model, tea.Cmd)

func (*DirModel) View 

func (dm *DirModel) View() string

type DriveModel 

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

func NewDriveModel 

func NewDriveModel(n *Navigation) *DriveModel

func (*DriveModel) Init 

func (dm *DriveModel) Init() tea.Cmd

func (*DriveModel) Update 

func (dm *DriveModel) Update(msg tea.Msg) (tea.Model, tea.Cmd)

func (*DriveModel) View 

func (dm *DriveModel) View() string

type Mode 

type Mode string
const (
	PENDING Mode = "PENDING"
	READY   Mode = "READY"
	INPUT   Mode = "INPUT"
)
type Navigation struct {
	// contains filtered or unexported fields
}

Navigation defines the behavior for traversing the file system tree structure and handles the changes of state. It contains the current active drive/volume, traversing history, and handles the race condition cases.

func NewNavigation 

func NewNavigation(l *drive.List, t *structure.Tree) *Navigation

func NewRootNavigation added in v0.1.1 

func NewRootNavigation(l *drive.List, t *structure.Tree) (*Navigation, error)

NewRootNavigation creates navigation for a predefined root directory entry. It starts the blocking traversal immediately rather than in interactive mode. Therefore, a root with a wide subdirectory structure might cause a delay. 

func (n *Navigation) Down(path string, cursor int, ocl OnChangeLevel) (chan struct{}, chan error)

Down changes the current tree level down to the provided path. The path value is a directory relative path within the currently active tree node.

It handles two scenarios. The first is changing the level from drives to dirs, and the second is traversing between directories. In the first case, the function will not block execution but instead returns channels for "done" and "errors" that occurred during the drive scan. The client is responsible for listening to the channels and handling the state of scanning. The navigation will be locked until the "done" channel is closed. In the second case, both channels will be returned as nil values, since the scanning is already done. 

func (n *Navigation) DrivesList() *drive.List

DrivesList returns the list of drives available on the system. Depending on the specific operating system, some volumes may be filtered. Refer to the corresponding drive.List implementation for details. 

func (n *Navigation) Entry() *structure.Entry

Entry returns the current active *structure.Entry instance. It never returns an instance of a file, but only a directory. 

func (n *Navigation) Explore(path string) error
func (n *Navigation) OnDrives() bool

OnDrives checks whether the current navigation state is Drives or not. 

func (n *Navigation) ParentSize() int64
func (n *Navigation) Up(ocl OnChangeLevel)

Up changes the current tree level up to the previous one. It doesn't accept the target level but instead takes it from navigation history. The Up function will change the level only if the current state is Dirs and will do nothing in case of the Drives state.

If the navigation is currently locked, the function will do nothing and return immediately without an error.

type OnChangeLevel added in v0.1.1 

type OnChangeLevel func(e *structure.Entry, s State)

OnChangeLevel defines a custom type for a function being called on changing the current tree level. It accepts the current active entry instance and the navigation's state: Drives or Dirs.

type ScanFinished added in v0.1.1 

type ScanFinished struct{}

type SortState 

type SortState struct {
	Key  drive.SortKey
	Desc bool
}

type State 

type State int

State defines a custom type representing the current GUI state. The application's behavior depends on the current state value. 

const (
	// Drives defines an application state while selecting the target drive.
	Drives State = iota

	// Dirs defines an application state while traversing a specific drive for
	// its files and directories.
	Dirs
)

type UpdateDirState added in v0.1.1 

type UpdateDirState struct{}

type ViewModel 

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

func NewViewModel 

func NewViewModel(n *Navigation) *ViewModel

func (*ViewModel) Init 

func (vm *ViewModel) Init() tea.Cmd

func (*ViewModel) Update 

func (vm *ViewModel) Update(msg tea.Msg) (tea.Model, tea.Cmd)

func (*ViewModel) View 

func (vm *ViewModel) View() string

Source Files

View all Source files

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.