README
¶
go-tmux
A library to manage tmux sessions/windows/panes.
Usage
See examples directory:
- create_session – Example that shows how to create a tmux session with user-defined configuration
- sessions_manager – Sessions manager implemented using this library.
Documentation
¶
Index ¶
- func ExecCmd(args []string) error
- func GetAttachedSessionName() (string, error)
- func InTravis() bool
- func IsInsideTmux() bool
- func RunCmd(args []string) (string, string, error)
- type Configuration
- type Pane
- type Server
- func (s *Server) AddSession(session Session)
- func (s *Server) HasSession(name string) (bool, error)
- func (s *Server) KillSession(name string) error
- func (s *Server) ListPanes() ([]Pane, error)
- func (s *Server) ListSessions() ([]Session, error)
- func (s *Server) NewSession(name string) (session Session, err error)
- type Session
- func (s *Session) AddWindow(window Window)
- func (s *Session) AttachSession() error
- func (s *Session) DettachSession() error
- func (s *Session) InitSession() error
- func (s *Session) ListPanes() ([]Pane, error)
- func (s *Session) ListWindows() ([]Window, error)
- func (s *Session) NewWindow(name string) (window Window, err error)
- type Window
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
func GetAttachedSessionName ¶
Return name of attached tmux session.
Types ¶
type Configuration ¶
type Configuration struct {
Server *Server // Pointer to used tmux server
Sessions []*Session // List of sessions to be initialized
ActiveSession *Session // Session to be attached after initialization.
}
func (*Configuration) Apply ¶
func (c *Configuration) Apply() error
Apply given configuration to setup a user-defined workflow Before running this method, user must make sure that there is no windows and session with same names exists. Otherwise existing sessions/windows will be replaced with the new ones.
type Pane ¶
type Pane struct {
ID int
SessionId int
SessionName string
WindowId int
WindowName string
WindowIndex int
Active bool
}
func ListPanes ¶
Return list of panes. Optional arguments are define the search scope with tmux command keys (see tmux(1) manpage): list-panes [-as] [-F format] [-t target]
- `-a`: target is ignored and all panes on the server are listed
- `-s`: target is a session. If neither is given, target is a window (or the current window).
func (*Pane) GetCurrentPath ¶
Returns current path for this pane.
func (*Pane) RunCommand ¶
RunCommand runs a command in the pane.
type Server ¶
type Server struct {
SocketPath string // Path to tmux server socket
SocketName string // Name of created tmux socket
Sessions []Session // List of sessions used on server initialization
}
func (*Server) AddSession ¶
Add session to server configuration. This will change only in-library server representation. Used for initial configuration before creating new server.
func (*Server) HasSession ¶
Return true that session with given name is exsits on this server, false otherwise.
func (*Server) KillSession ¶
Kills session with given name. If killed session not found, KillSession will not raise error and just do nothing.
func (*Server) ListSessions ¶
List all sessions managed by this server.
func (*Server) NewSession ¶
Create new session with given name on this server.
Session always will be detached after creation. Call AttachSession to attach it. If session already exists, this function return an error. Check session with HaveSession before running it if you need it.
type Session ¶
type Session struct {
Name string // Session name
Id int // Session id
StartDirectory string // Path to window start directory
Windows []Window // List of windows used on session initialization
}
func (*Session) AddWindow ¶
Add window to session configuration. This will change only in-library session representation. Used for initial configuration before creating new session.
func (*Session) AttachSession ¶
Attach to existing tmux session.
func (*Session) DettachSession ¶
Detach from current session.
func (*Session) InitSession ¶
func (*Session) ListWindows ¶
List all windows in the current session.
type Window ¶
type Window struct {
Name string
Id int
SessionId int
SessionName string
StartDirectory string // Path to window working directory
Panes []Pane // List of panes used in initial window configuration
}
Source Files
Directories