Documentation
¶
Index ¶
- Variables
- func AdjustNumberOperatorPos(cpos int, line []rune) int
- func AdjustSurroundQuotes(dBpos, dEpos, sBpos, sEpos int) (mark, cpos int)
- func ConvertMeta(keys []rune) string
- func FormatTabs(s string) string
- func GetQuotedWordStart(line []rune) (unclosed bool, pos int)
- func IsBracket(char rune) bool
- func IsSurround(bchar, echar rune) bool
- func LineSpan(line []rune, idx, indent int) (x, y int)
- func MatchSurround(r rune) (bchar, echar rune)
- func Quote(char rune) (res []rune, length int)
- func RealLength(s string) int
- func Split(input string) (words []string, err error)
- func SurroundType(char rune) (surround, closer bool)
- type KeywordSwitcher
Constants ¶
This section is empty.
Variables ¶
var NewlineMatcher = regexp.MustCompile(`\r\n`)
NewlineMatcher is a regular expression matching all newlines or returned newlines.
Functions ¶
func AdjustNumberOperatorPos ¶
AdjustNumberOperatorPos returns an adjusted cursor position when the word around the cursor is an expression with an operator.
func AdjustSurroundQuotes ¶
AdjustSurroundQuotes returns the correct mark and cursor positions when we want to know where a shell word enclosed with quotes (and potentially having inner ones) starts and ends.
func ConvertMeta ¶
ConvertMeta recursively searches for metafied keys in a sequence, and replaces them with an esc prefix and their unmeta equivalent.
func FormatTabs ¶
FormatTabs replaces all '\t' occurrences in a string with 6 spaces each.
func GetQuotedWordStart ¶
GetQuotedWordStart returns the position of the outmost containing quote of the word (going backward from the end of the provided line), if the current word is a shell word that is not closed yet. Ex: `this 'quote contains "surrounded" words`. the outermost quote is the single one.
func IsBracket ¶
IsBracket returns true if the character is an opening/closing bracket/brace/parenthesis.
func IsSurround ¶
IsSurround returns true if the character is a quote or a bracket/brace, etc.
func LineSpan ¶
LineSpan computes the number of columns and lines that are needed for a given line, accounting for any ANSI escapes/color codes, and tabulations replaced with 4 spaces.
func MatchSurround ¶
MatchSurround returns the matching character of a rune that is either a bracket/brace/parenthesis, or a single/double quote.
func Quote ¶
Quote translates one rune in its printable version, which might be different for Control/Meta characters. Returns the "translated" string and new length. (eg 0x04 => ^C = len:2).
func RealLength ¶
RealLength returns the real length of a string (the number of terminal columns used to render the line, which may contain special graphemes). Before computing the width, it replaces tabs with (4) spaces, and strips colors.
func Split ¶
Split splits a string according to /bin/sh's word-splitting rules. It supports backslash-escapes, single-quotes, and double-quotes. Notably it does not support the $” style of quoting. It also doesn't attempt to perform any other sort of expansion, including brace expansion, shell expansion, or pathname expansion.
If the given input has an unterminated quoted string or ends in a backslash-escape, one of UnterminatedSingleQuoteError, UnterminatedDoubleQuoteError, or UnterminatedEscapeError is returned.
func SurroundType ¶
SurroundType says if the character is a pairing one (first boolean), and if the character is the closing part of the pair (second boolean).
Types ¶
type KeywordSwitcher ¶
type KeywordSwitcher func(word string, increase bool, times int) (done bool, switched string, bpos, epos int)
KeywordSwitcher is a function modifying a given word, returning: @done => If true, the handler performed a change. @switched => The updated word. @bpos => Offset to begin position. @epos => Offset to end position.
func KeywordSwitchers ¶
func KeywordSwitchers() []KeywordSwitcher
KeywordSwitchers returns all keywordSwitchers of the shell.
Source Files