textbuf

package
v2.0.0-dev0.0.28 Latest Latest
Warning

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

 Go to latest Published: Dec 26, 2023 License: BSD-3-Clause Imports: 25 Imported by: 2

Documentation

Index

Constants

View Source 
const (
	// IgnoreCase is passed to search functions to indicate case should be ignored
	IgnoreCase = true

	// UseCase is passed to search functions to indicate case is relevant
	UseCase = false
)

Variables

View Source 
var SearchContext = 30

SearchContext is how much text to include on either side of the search match

View Source 
var UndoGroupDelayMSec = 250

UndoGroupDelayMSec is number of milliseconds above which a new group is started, for grouping undo events

View Source 
var UndoTrace = false

UndoTrace -- set to true to get a report of undo actions

Functions

func ApplyOneDiff 

func ApplyOneDiff(op difflib.OpCode, bedit *[]string, aorig []string, blmap []int)

ApplyOneDiff applies given diff operator to given "B" lines using original "A" lines and given b line map

func BytesToLineStrings 

func BytesToLineStrings(txt []byte, addNewLn bool) []string

BytesToLineStrings returns []string lines from []byte input. If addNewLn is true, each string line has a \n appended at end.

func CountWordsLines 

func CountWordsLines(reader io.Reader) (words, lines int)

CountWordsLines counts the number of words (aka Fields, space-separated strings) and lines given io.Reader input

func CountWordsLinesRegion 

func CountWordsLinesRegion(src [][]rune, reg Region) (words, lines int)

CountWordsLinesRegion counts the number of words (aka Fields, space-separated strings) and lines in given region of source (lines = 1 + End.Ln - Start.Ln)

func DiffLinesUnified 

func DiffLinesUnified(astr, bstr []string, context int, afile, adate, bfile, bdate string) []byte

DiffLinesUnified computes the diff between two string arrays (one string per line), returning a unified diff with given amount of context (default of 3 will be used if -1), with given file names and modification dates.

func DiffOpReverse 

func DiffOpReverse(op difflib.OpCode) difflib.OpCode

func DiffOpString 

func DiffOpString(op difflib.OpCode) string

func FileBytes 

func FileBytes(fpath string) ([]byte, error)

FileBytes returns the bytes of given file.

func FileRegionBytes 

func FileRegionBytes(fpath string, stLn, edLn int, preComments bool, lnBack int) []byte

FileRegionBytes returns the bytes of given file within given start / end lines, either of which might be 0 (in which case full file is returned). If preComments is true, it also automatically includes any comments that might exist just prior to the start line if stLn is > 0, going back a maximum of lnBack lines.

func KnownComments 

func KnownComments(fpath string) (comLn, comSt, comEd string)

KnownComments returns the comment strings for supported file types, and returns the standard C-style comments otherwise.

func PreCommentStart 

func PreCommentStart(lns [][]byte, stLn int, comLn, comSt, comEd string, lnBack int) int

PreCommentStart returns the starting line for comment line(s) that just precede the given stLn line number within the given lines of bytes, using the given line-level and block start / end comment chars. returns stLn if nothing found. Only looks back a total of lnBack lines.

func ReCaseString 

func ReCaseString(str string, c Cases) string

ReCaseString changes the case of the string according to the given case type.

func StringLinesToByteLines 

func StringLinesToByteLines(str []string) [][]byte

StringLinesToByteLines returns [][]byte lines from []string lines

Types

type AdjustPosDel 

type AdjustPosDel int

AdjustPosDel determines what to do with positions within deleted region 

const (
	// AdjustPosDelErr means return a PosErr when in deleted region
	AdjustPosDelErr AdjustPosDel = iota

	// AdjustPosDelStart means return start of deleted region
	AdjustPosDelStart

	// AdjustPosDelEnd means return end of deleted region
	AdjustPosDelEnd
)

these are options for what to do with positions within deleted region for the AdjustPos function

type Cases 

type Cases int32 //enums:enum

Cases are different cases -- Lower, Upper, Camel, etc 

const (
	LowerCase Cases = iota
	UpperCase

	// CamelCase is init-caps
	CamelCase

	// LowerCamelCase has first letter lower-case
	LowerCamelCase

	// SnakeCase is snake_case -- lower with underbars
	SnakeCase

	// UpperSnakeCase is SNAKE_CASE -- upper with underbars
	UpperSnakeCase

	// KebabCase is kebab-case -- lower with -'s
	KebabCase
)
const CasesN Cases = 7

CasesN is the highest valid value for type Cases, plus one.

func CasesValues 

func CasesValues() []Cases

CasesValues returns all possible values for the type Cases.

func (Cases) Desc 

func (i Cases) Desc() string

Desc returns the description of the Cases value.

func (Cases) Int64 

func (i Cases) Int64() int64

Int64 returns the Cases value as an int64.

func (Cases) IsValid 

func (i Cases) IsValid() bool

IsValid returns whether the value is a valid option for type Cases.

func (Cases) MarshalText 

func (i Cases) MarshalText() ([]byte, error)

MarshalText implements the encoding.TextMarshaler interface.

func (*Cases) SetInt64 

func (i *Cases) SetInt64(in int64)

SetInt64 sets the Cases value from an int64.

func (*Cases) SetString 

func (i *Cases) SetString(s string) error

SetString sets the Cases value from its string representation, and returns an error if the string is invalid.

func (Cases) String 

func (i Cases) String() string

String returns the string representation of this Cases value.

func (*Cases) UnmarshalText 

func (i *Cases) UnmarshalText(text []byte) error

UnmarshalText implements the encoding.TextUnmarshaler interface.

func (Cases) Values 

func (i Cases) Values() []enums.Enum

Values returns all possible values for the type Cases.

type DiffSelData 

type DiffSelData struct {
	// original text
	Orig []string

	// edits applied
	Edit []string

	// mapping of original line numbers (index) to edited line numbers,
	// accounting for the edits applied so far
	LineMap []int

	// Undos: stack of diffs applied
	Undos Diffs

	// undo records
	EditUndo [][]string

	// undo records for ALineMap
	LineMapUndo [][]int
}

DiffSelData contains data for one set of text

func (*DiffSelData) SaveUndo 

func (ds *DiffSelData) SaveUndo(op difflib.OpCode)

func (*DiffSelData) SetStringLines 

func (ds *DiffSelData) SetStringLines(s []string)

SetStringLines sets the data from given lines of strings The Orig is set directly and Edit is cloned if the input will be modified during the processing, call slices.Clone first

func (*DiffSelData) Undo 

func (ds *DiffSelData) Undo() bool

type DiffSelected 

type DiffSelected struct {
	A DiffSelData
	B DiffSelData

	// Diffs are the diffs between A and B
	Diffs Diffs
}

DiffSelected supports the incremental application of selected diffs between two files (either A -> B or B <- A), with Undo

func NewDiffSelected 

func NewDiffSelected(astr, bstr []string) *DiffSelected

func (*DiffSelected) AtoB 

func (ds *DiffSelected) AtoB(idx int)

AtoB applies given diff index from A to B

func (*DiffSelected) BtoA 

func (ds *DiffSelected) BtoA(idx int)

BtoA applies given diff index from B to A

func (*DiffSelected) SetStringLines 

func (ds *DiffSelected) SetStringLines(astr, bstr []string)

SetStringLines sets the data from given lines of strings

type Diffs 

type Diffs []difflib.OpCode

Diffs are raw differences between text, in terms of lines, reporting a sequence of operations that would convert one buffer (a) into the other buffer (b). Each operation is either an 'r' (replace), 'd' (delete), 'i' (insert) or 'e' (equal).

func DiffLines 

func DiffLines(astr, bstr []string) Diffs

DiffLines computes the diff between two string arrays (one string per line), reporting a sequence of operations that would convert buffer a into buffer b. Each operation is either an 'r' (replace), 'd' (delete), 'i' (insert) or 'e' (equal). Everything is line-based (0, offset).

func (Diffs) DiffForLine 

func (di Diffs) DiffForLine(line int) (int, difflib.OpCode)

func (Diffs) Reverse 

func (di Diffs) Reverse() Diffs

Reverse returns the reverse-direction diffs, switching a vs. b

func (Diffs) String 

func (di Diffs) String() string

String satisfies the Stringer interface

func (Diffs) ToPatch 

func (dif Diffs) ToPatch(bstr []string) Patch

ToPatch creates a Patch list from given Diffs output from DiffLines and the b strings from which the needed lines of source are copied. ApplyPatch with this on the a strings will result in the b strings. The resulting Patch is independent of bstr slice.

type Edit 

type Edit struct {

	// region for the edit (start is same for previous and current, end is in original pre-delete text for a delete, and in new lines data for an insert.  Also contains the Time stamp for this edit.
	Reg Region

	// text deleted or inserted -- in lines.  For Rect this is just for the spanning character distance per line, times number of lines.
	Text [][]rune

	// optional grouping number, for grouping edits in Undo for example
	Group int

	// action is either a deletion or an insertion
	Delete bool

	// this is a rectangular region with upper left corner = Reg.Start and lower right corner = Reg.End -- otherwise it is for the full continuous region.
	Rect bool
}

Edit describes an edit action to a buffer -- this is the data passed via signals to viewers of the buffer. Actions are only deletions and insertions (a change is a sequence of those, given normal editing processes). The textview.Buf always reflects the current state *after* the edit.

func (*Edit) AdjustPos 

func (te *Edit) AdjustPos(pos lex.Pos, del AdjustPosDel) lex.Pos

AdjustPos adjusts the given text position as a function of the edit. if the position was within a deleted region of text, del determines what is returned

func (*Edit) AdjustPosIfAfterTime 

func (te *Edit) AdjustPosIfAfterTime(pos lex.Pos, t time.Time, del AdjustPosDel) lex.Pos

AdjustPosIfAfterTime checks the time stamp and IfAfterTime, it adjusts the given text position as a function of the edit del determines what to do with positions within a deleted region either move to start or end of the region, or return an error.

func (*Edit) AdjustReg 

func (te *Edit) AdjustReg(reg Region) Region

AdjustReg adjusts the given text region as a function of the edit, including checking that the timestamp on the region is after the edit time, if the region has a valid Time stamp (otherwise always does adjustment). If the starting position is within a deleted region, it is moved to the end of the deleted region, and if the ending position was within a deleted region, it is moved to the start. If the region becomes empty, RegionNil will be returned.

func (*Edit) Clone 

func (te *Edit) Clone() *Edit

Clone returns a clone of the edit record.

func (*Edit) CopyFrom 

func (te *Edit) CopyFrom(cp *Edit)

Copy copies from other Edit

func (*Edit) ToBytes 

func (te *Edit) ToBytes() []byte

ToBytes returns the Text of this edit record to a byte string, with newlines at end of each line -- nil if Text is empty

type Match 

type Match struct {

	// region surrounding the match -- column positions are in runes, not bytes
	Reg Region

	// text surrounding the match, at most FileSearchContext on either side (within a single line)
	Text []byte
}

Match records one match for search within file, positions in runes

func NewMatch 

func NewMatch(rn []rune, st, ed, ln int) Match

NewMatch returns a new Match entry for given rune line with match starting at st and ending before ed, on given line 

func Search(reader io.Reader, find []byte, ignoreCase bool) (int, []Match)

Search looks for a string (no regexp) from an io.Reader input stream, using given case-sensitivity. Returns number of occurrences and specific match position list. Column positions are in runes.

func SearchByteLinesRegexp 

func SearchByteLinesRegexp(src [][]byte, re *regexp.Regexp) (int, []Match)

SearchByteLinesRegexp looks for a regexp within lines of bytes, with given case-sensitivity returning number of occurrences and specific match position list. Column positions are in runes.

func SearchFile 

func SearchFile(filename string, find []byte, ignoreCase bool) (int, []Match)

SearchFile looks for a string (no regexp) within a file, in a case-sensitive way, returning number of occurrences and specific match position list -- column positions are in runes.

func SearchFileRegexp 

func SearchFileRegexp(filename string, re *regexp.Regexp) (int, []Match)

SearchFileRegexp looks for a string (using regexp) within a file, returning number of occurrences and specific match position list -- column positions are in runes.

func SearchLexItems 

func SearchLexItems(src [][]rune, lexs []lex.Line, find []byte, ignoreCase bool) (int, []Match)

SearchLexItems looks for a string (no regexp), as entire lexically tagged items, with given case-sensitivity returning number of occurrences and specific match position list. Column positions are in runes.

func SearchRegexp 

func SearchRegexp(reader io.Reader, re *regexp.Regexp) (int, []Match)

SearchRegexp looks for a string (using regexp) from an io.Reader input stream. Returns number of occurrences and specific match position list. Column positions are in runes.

func SearchRuneLines 

func SearchRuneLines(src [][]rune, find []byte, ignoreCase bool) (int, []Match)

SearchRuneLines looks for a string (no regexp) within lines of runes, with given case-sensitivity returning number of occurrences and specific match position list. Column positions are in runes.

type Opts 

type Opts struct {

	// editor prefs from gogi prefs
	gi.EditorPrefs

	// character(s) that start a single-line comment -- if empty then multi-line comment syntax will be used
	CommentLn string

	// character(s) that start a multi-line comment or one that requires both start and end
	CommentSt string

	// character(s) that end a multi-line comment or one that requires both start and end
	CommentEd string
}

Opts contains options for textview.Bufs Contains everything necessary to conditionalize editing of a given text file.

func (*Opts) CommentStrs 

func (tb *Opts) CommentStrs() (comst, comed string)

CommentStrs returns the comment start and end strings, using line-based CommentLn first if set and falling back on multi-line / general purpose start / end syntax

func (*Opts) ConfigKnown 

func (tb *Opts) ConfigKnown(sup fi.Known) bool

ConfigKnown configures options based on the supported language info in GoPi returns true if supported

func (*Opts) IndentChar 

func (tb *Opts) IndentChar() indent.Char

IndentChar returns the indent character based on SpaceIndent option

type Patch 

type Patch []*PatchRec

Patch is a collection of patch records needed to turn original a buffer into b

func (Patch) Apply 

func (pt Patch) Apply(astr []string) []string

Apply applies given Patch to given file as list of strings this does no checking except range checking so it won't crash so if input string is not appropriate for given Patch, results may be nonsensical.

func (Patch) NumBlines 

func (pt Patch) NumBlines() int

NumBlines returns the total number of Blines source code in the patch

type PatchRec 

type PatchRec struct {

	// diff operation: 'r', 'd', 'i', 'e'
	Op difflib.OpCode

	// lines from B buffer needed for 'r' and 'i' operations
	Blines []string
}

PatchRec is a self-contained record of a DiffLines result that contains the source lines of the b buffer needed to patch a into b

type Region 

type Region struct {

	// starting position
	Start lex.Pos

	// ending position: line number is *inclusive* but character position is *exclusive* (-1)
	End lex.Pos

	// time when region was set -- needed for updating locations in the text based on time stamp (using efficient non-pointer time)
	Time nptime.Time
}

Region represents a text region as a start / end position, and includes a Time stamp for when the region was created as valid positions into the textview.Buf. The character end position is an *exclusive* position (i.e., the region ends at the character just prior to that character) but the lines are always *inclusive* (i.e., it is the actual line, not the next line). 

var RegionNil Region

RegionNil is the empty (zero) text region -- all zeros

func NewRegion 

func NewRegion(stLn, stCh, edLn, edCh int) Region

NewRegion creates a new text region using separate line and char values for start and end, and also sets the time stamp to now

func NewRegionLen 

func NewRegionLen(start lex.Pos, len int) Region

NewRegionLen makes a new Region from a starting point and a length along same line

func NewRegionPos 

func NewRegionPos(st, ed lex.Pos) Region

NewRegionPos creates a new text region using position values and also sets the time stamp to now

func (*Region) AgeMSec 

func (tr *Region) AgeMSec() int

AgeMSec returns the time interval in milliseconds from time.Now()

func (*Region) AgoMSec 

func (tr *Region) AgoMSec(t time.Time) int

AgoMSec returns how long ago this Region's time stamp is relative to given time, in milliseconds.

func (*Region) Contains 

func (tr *Region) Contains(ln int) bool

Contains returns true if line is within region

func (*Region) FromString 

func (tr *Region) FromString(link string) bool

FromString decodes text region from a string representation of form: [#]LxxCxx-LxxCxx -- used in e.g., URL links -- returns true if successful

func (*Region) IsAfterTime 

func (tr *Region) IsAfterTime(t time.Time) bool

IsAfterTime reports if this region's time stamp is after given time value if region Time stamp has not been set, it always returns true

func (*Region) IsNil 

func (tr *Region) IsNil() bool

IsNil checks if the region is empty, because the start is after or equal to the end

func (*Region) IsSameLine 

func (tr *Region) IsSameLine() bool

IsSameLine returns true if region starts and ends on the same line

func (*Region) SinceMSec 

func (tr *Region) SinceMSec(earlier *Region) int

SinceMSec returns the time interval in milliseconds between this Region's time stamp and that of the given earlier region's stamp.

func (*Region) TimeNow 

func (tr *Region) TimeNow()

TimeNow grabs the current time as the edit time

type Undo 

type Undo struct {

	// if true, saving and using undos is turned off (e.g., inactive buffers)
	Off bool

	// undo stack of edits
	Stack []*Edit

	// undo stack of *undo* edits -- added to whenever an Undo is done -- for emacs-style undo
	UndoStack []*Edit

	// undo position in stack
	Pos int

	// group counter
	Group int

	// mutex protecting all updates
	Mu sync.Mutex `json:"-" xml:"-"`
}

Undo is the textview.Buf undo manager

func (*Undo) AdjustPos 

func (un *Undo) AdjustPos(pos lex.Pos, t time.Time, del AdjustPosDel) lex.Pos

AdjustPos adjusts given text position, which was recorded at given time for any edits that have taken place since that time (using the Undo stack). del determines what to do with positions within a deleted region -- either move to start or end of the region, or return an error

func (*Undo) AdjustReg 

func (un *Undo) AdjustReg(reg Region) Region

AdjustReg adjusts given text region for any edits that have taken place since time stamp on region (using the Undo stack). If region was wholly within a deleted region, then RegionNil will be returned -- otherwise it is clipped appropriately as function of deletes.

func (*Undo) NewGroup 

func (un *Undo) NewGroup()

NewGroup increments the Group counter so subsequent undos will be grouped separately

func (*Undo) RedoNext 

func (un *Undo) RedoNext() *Edit

RedoNext returns the current item on Stack for Redo, and increments the position returns nil if at end of stack.

func (*Undo) RedoNextIfGroup 

func (un *Undo) RedoNextIfGroup(gp int) *Edit

RedoNextIfGroup returns the current item on Stack for Redo if it is same group and increments the position. returns nil if at end of stack.

func (*Undo) Reset 

func (un *Undo) Reset()

Reset clears all undo records

func (*Undo) Save 

func (un *Undo) Save(tbe *Edit)

Save saves given edit to undo stack, with current group marker unless timer interval exceeds UndoGroupDelayMSec since last item.

func (*Undo) SaveUndo 

func (un *Undo) SaveUndo(tbe *Edit)

SaveUndo saves given edit to UndoStack (stack of undoes that have have undone..) for emacs mode.

func (*Undo) UndoPop 

func (un *Undo) UndoPop() *Edit

UndoPop pops the top item off of the stack for use in Undo. returns nil if none.

func (*Undo) UndoPopIfGroup 

func (un *Undo) UndoPopIfGroup(gp int) *Edit

UndoPopIfGroup pops the top item off of the stack if it is the same as given group

func (*Undo) UndoStackSave 

func (un *Undo) UndoStackSave()

UndoStackSave if EmacsUndo mode is active, saves the UndoStack to the regular Undo stack, at the end, and moves undo to the very end. Undo is a constant stream..

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.