tools: Index | Files

package fake

import ""

Package fake provides fake implementations of a text editor, LSP client plugin, and Sandbox environment for use in tests.

The Editor type provides a high level API for text editor operations (open/modify/save/close a buffer, jump to definition, etc.), and the Client type exposes an LSP client for the editor that can be connected to a language server. By default, the Editor and Client should be compliant with the LSP spec: their intended use is to verify server compliance with the spec in a variety of environment. Possible future enhancements of these types may allow them to misbehave in configurable ways, but that is not their primary use.

The Sandbox type provides a facility for executing tests with a temporary directory, module proxy, and GOPATH.


Package Files

client.go doc.go edit.go editor.go proxy.go sandbox.go workdir.go


var (
    ErrNoMatch       = errors.New("no match")
    ErrUnknownBuffer = errors.New("unknown buffer")

ErrNoMatch is returned if a regexp search fails.

func Tempdir Uses

func Tempdir(txt string) (string, error)

Tempdir creates a new temp directory with the given txtar-encoded files. It is the responsibility of the caller to call os.RemoveAll on the returned file path when it is no longer needed.

func WriteFileData Uses

func WriteFileData(path string, content []byte, rel RelativeTo) error

WriteFileData writes content to the relative path, replacing the special token $SANDBOX_WORKDIR with the relative root given by rel.

func WriteProxy Uses

func WriteProxy(tmpdir, txt string) (string, error)

WriteProxy creates a new proxy file tree using the txtar-encoded content, and returns its URL.

type CallCounts Uses

type CallCounts struct {
    DidOpen, DidChange, DidChangeWatchedFiles int

type Client Uses

type Client struct {
    // contains filtered or unexported fields

Client is an adapter that converts an *Editor into an LSP Client. It mosly delegates functionality to hooks that can be configured by tests.

func (*Client) ApplyEdit Uses

func (c *Client) ApplyEdit(ctx context.Context, params *protocol.ApplyWorkspaceEditParams) (*protocol.ApplyWorkspaceEditResponse, error)

ApplyEdit applies edits sent from the server. Note that as of writing gopls doesn't use this feature, so it is untested.

func (*Client) Configuration Uses

func (c *Client) Configuration(_ context.Context, p *protocol.ParamConfiguration) ([]interface{}, error)

func (*Client) Event Uses

func (c *Client) Event(ctx context.Context, event *interface{}) error

func (*Client) LogMessage Uses

func (c *Client) LogMessage(ctx context.Context, params *protocol.LogMessageParams) error

func (*Client) Progress Uses

func (c *Client) Progress(ctx context.Context, params *protocol.ProgressParams) error

func (*Client) PublishDiagnostics Uses

func (c *Client) PublishDiagnostics(ctx context.Context, params *protocol.PublishDiagnosticsParams) error

func (*Client) RegisterCapability Uses

func (c *Client) RegisterCapability(ctx context.Context, params *protocol.RegistrationParams) error

func (*Client) ShowMessage Uses

func (c *Client) ShowMessage(ctx context.Context, params *protocol.ShowMessageParams) error

func (*Client) ShowMessageRequest Uses

func (c *Client) ShowMessageRequest(ctx context.Context, params *protocol.ShowMessageRequestParams) (*protocol.MessageActionItem, error)

func (*Client) UnregisterCapability Uses

func (c *Client) UnregisterCapability(ctx context.Context, params *protocol.UnregistrationParams) error

func (*Client) WorkDoneProgressCreate Uses

func (c *Client) WorkDoneProgressCreate(ctx context.Context, params *protocol.WorkDoneProgressCreateParams) error

func (*Client) WorkspaceFolders Uses

func (c *Client) WorkspaceFolders(context.Context) ([]protocol.WorkspaceFolder, error)

type ClientHooks Uses

type ClientHooks struct {
    OnLogMessage             func(context.Context, *protocol.LogMessageParams) error
    OnDiagnostics            func(context.Context, *protocol.PublishDiagnosticsParams) error
    OnWorkDoneProgressCreate func(context.Context, *protocol.WorkDoneProgressCreateParams) error
    OnProgress               func(context.Context, *protocol.ProgressParams) error
    OnShowMessage            func(context.Context, *protocol.ShowMessageParams) error
    OnShowMessageRequest     func(context.Context, *protocol.ShowMessageRequestParams) error
    OnRegistration           func(context.Context, *protocol.RegistrationParams) error
    OnUnregistration         func(context.Context, *protocol.UnregistrationParams) error

ClientHooks are called to handle the corresponding client LSP method.

type Edit Uses

type Edit struct {
    Start, End Pos
    Text       string

Edit represents a single (contiguous) buffer edit.

func NewEdit Uses

func NewEdit(startLine, startColumn, endLine, endColumn int, text string) Edit

NewEdit creates an edit replacing all content between (startLine, startColumn) and (endLine, endColumn) with text.

type Editor Uses

type Editor struct {
    Config EditorConfig

    // Server, client, and sandbox are concurrency safe and written only
    // at construction time, so do not require synchronization.
    Server protocol.Server
    // contains filtered or unexported fields

Editor is a fake editor client. It keeps track of client state and can be used for writing LSP tests.

func NewEditor Uses

func NewEditor(sandbox *Sandbox, config EditorConfig) *Editor

NewEditor Creates a new Editor.

func (*Editor) AcceptCompletion Uses

func (e *Editor) AcceptCompletion(ctx context.Context, path string, pos Pos, item protocol.CompletionItem) error

AcceptCompletion accepts a completion for the given item at the given position.

func (*Editor) ApplyQuickFixes Uses

func (e *Editor) ApplyQuickFixes(ctx context.Context, path string, rng *protocol.Range, diagnostics []protocol.Diagnostic) error

ApplyQuickFixes requests and performs the quickfix codeAction.

func (*Editor) BufferText Uses

func (e *Editor) BufferText(name string) string

BufferText returns the content of the buffer with the given name.

func (*Editor) BufferVersion Uses

func (e *Editor) BufferVersion(name string) int

BufferVersion returns the current version of the buffer corresponding to name (or 0 if it is not being edited).

func (*Editor) Client Uses

func (e *Editor) Client() *Client

Client returns the LSP client for this editor.

func (*Editor) Close Uses

func (e *Editor) Close(ctx context.Context) error

Close issues the shutdown and exit sequence an editor should.

func (*Editor) CloseBuffer Uses

func (e *Editor) CloseBuffer(ctx context.Context, path string) error

CloseBuffer removes the current buffer (regardless of whether it is saved).

func (*Editor) CodeAction Uses

func (e *Editor) CodeAction(ctx context.Context, path string, rng *protocol.Range) ([]protocol.CodeAction, error)

CodeAction executes a codeAction request on the server.

func (*Editor) CodeLens Uses

func (e *Editor) CodeLens(ctx context.Context, path string) ([]protocol.CodeLens, error)

CodeLens executes a codelens request on the server.

func (*Editor) Completion Uses

func (e *Editor) Completion(ctx context.Context, path string, pos Pos) (*protocol.CompletionList, error)

Completion executes a completion request on the server.

func (*Editor) Connect Uses

func (e *Editor) Connect(ctx context.Context, conn jsonrpc2.Conn, hooks ClientHooks) (*Editor, error)

Connect configures the editor to communicate with an LSP server on conn. It is not concurrency safe, and should be called at most once, before using the editor.

It returns the editor, so that it may be called as follows:

editor, err := NewEditor(s).Connect(ctx, conn)

func (*Editor) CreateBuffer Uses

func (e *Editor) CreateBuffer(ctx context.Context, path, content string) error

CreateBuffer creates a new unsaved buffer corresponding to the workdir path, containing the given textual content.

func (e *Editor) DocumentLink(ctx context.Context, path string) ([]protocol.DocumentLink, error)

func (*Editor) EditBuffer Uses

func (e *Editor) EditBuffer(ctx context.Context, path string, edits []Edit) error

EditBuffer applies the given test edits to the buffer identified by path.

func (*Editor) ExecuteCommand Uses

func (e *Editor) ExecuteCommand(ctx context.Context, params *protocol.ExecuteCommandParams) (interface{}, error)

func (*Editor) Exit Uses

func (e *Editor) Exit(ctx context.Context) error

Exit issues the 'exit' LSP notification.

func (*Editor) FormatBuffer Uses

func (e *Editor) FormatBuffer(ctx context.Context, path string) error

FormatBuffer gofmts a Go file.

func (*Editor) GoToDefinition Uses

func (e *Editor) GoToDefinition(ctx context.Context, path string, pos Pos) (string, Pos, error)

GoToDefinition jumps to the definition of the symbol at the given position in an open buffer.

func (*Editor) HasBuffer Uses

func (e *Editor) HasBuffer(name string) bool

HasBuffer reports whether the file name is open in the editor.

func (*Editor) Hover Uses

func (e *Editor) Hover(ctx context.Context, path string, pos Pos) (*protocol.MarkupContent, Pos, error)

Hover triggers a hover at the given position in an open buffer.

func (*Editor) OpenFile Uses

func (e *Editor) OpenFile(ctx context.Context, path string) error

OpenFile creates a buffer for the given workdir-relative file.

func (*Editor) OrganizeImports Uses

func (e *Editor) OrganizeImports(ctx context.Context, path string) error

OrganizeImports requests and performs the source.organizeImports codeAction.

func (*Editor) RefactorRewrite Uses

func (e *Editor) RefactorRewrite(ctx context.Context, path string, rng *protocol.Range) error

RefactorRewrite requests and performs the source.refactorRewrite codeAction.

func (*Editor) References Uses

func (e *Editor) References(ctx context.Context, path string, pos Pos) ([]protocol.Location, error)

References executes a reference request on the server.

func (*Editor) RegexpRange Uses

func (e *Editor) RegexpRange(bufName, re string) (Pos, Pos, error)

RegexpRange returns the first range in the buffer bufName matching re. See RegexpSearch for more information on matching.

func (*Editor) RegexpReplace Uses

func (e *Editor) RegexpReplace(ctx context.Context, path, re, replace string) error

RegexpReplace edits the buffer corresponding to path by replacing the first instance of re, or its first subgroup, with the replace text. See RegexpSearch for more explanation of these two modes. It returns an error if re is invalid, has more than one subgroup, or doesn't match the buffer.

func (*Editor) RegexpSearch Uses

func (e *Editor) RegexpSearch(bufName, re string) (Pos, error)

RegexpSearch returns the position of the first match for re in the buffer bufName. For convenience, RegexpSearch supports the following two modes:

1. If re has no subgroups, return the position of the match for re itself.
2. If re has one subgroup, return the position of the first subgroup.

It returns an error re is invalid, has more than one subgroup, or doesn't match the buffer.

func (*Editor) RunGenerate Uses

func (e *Editor) RunGenerate(ctx context.Context, dir string) error

RunGenerate runs `go generate` non-recursively in the workdir-relative dir path. It does not report any resulting file changes as a watched file change, so must be followed by a call to Workdir.CheckForFileChanges once the generate command has completed.

func (*Editor) SaveBuffer Uses

func (e *Editor) SaveBuffer(ctx context.Context, path string) error

SaveBuffer writes the content of the buffer specified by the given path to the filesystem.

func (*Editor) SaveBufferWithoutActions Uses

func (e *Editor) SaveBufferWithoutActions(ctx context.Context, path string) error

func (*Editor) SetBufferContent Uses

func (e *Editor) SetBufferContent(ctx context.Context, path, content string) error

func (*Editor) Shutdown Uses

func (e *Editor) Shutdown(ctx context.Context) error

Shutdown issues the 'shutdown' LSP notification.

func (*Editor) Stats Uses

func (e *Editor) Stats() CallCounts

func (*Editor) Symbol Uses

func (e *Editor) Symbol(ctx context.Context, query string) ([]SymbolInformation, error)

Symbol performs a workspace symbol search using query

type EditorConfig Uses

type EditorConfig struct {
    Env        map[string]string
    BuildFlags []string

    // CodeLenses is a map defining whether codelens are enabled, keyed by the
    // codeLens command. CodeLenses which are not present in this map are left in
    // their default state.
    CodeLenses map[string]bool

    // SymbolMatcher is the config associated with the "symbolMatcher" gopls
    // config option.
    SymbolMatcher, SymbolStyle *string

    // LimitWorkspaceScope is true if the user does not want to expand their
    // workspace scope to the entire module.
    LimitWorkspaceScope bool

    // WorkspaceFolders is the workspace folders to configure on the LSP server,
    // relative to the sandbox workdir.
    // As a special case, if WorkspaceFolders is nil the editor defaults to
    // configuring a single workspace folder corresponding to the workdir root.
    // To explicitly send no workspace folders, use an empty (non-nil) slice.
    WorkspaceFolders []string

    // EnableStaticcheck enables staticcheck analyzers.
    EnableStaticcheck bool

    // AllExperiments sets the "allExperiments" configuration, which enables
    // all of gopls's opt-in settings.
    AllExperiments bool

    // Whether to send the current process ID, for testing data that is joined to
    // the PID. This can only be set by one test.
    SendPID bool

    DirectoryFilters []string

    VerboseOutput bool

EditorConfig configures the editor's LSP session. This is similar to source.UserOptions, but we use a separate type here so that we expose only that configuration which we support.

The zero value for EditorConfig should correspond to its defaults.

type FileEvent Uses

type FileEvent struct {
    Path, Content string
    ProtocolEvent protocol.FileEvent

FileEvent wraps the protocol.FileEvent so that it can be associated with a workdir-relative path.

type Location Uses

type Location struct {
    Path  string
    Range Range

Location is the editor friendly equivalent of protocol.Location

type Pos Uses

type Pos struct {
    Line, Column int

Pos represents a position in a text buffer. Both Line and Column are 0-indexed.

func (Pos) ToProtocolPosition Uses

func (p Pos) ToProtocolPosition() protocol.Position

type Range Uses

type Range struct {
    Start Pos
    End   Pos

Range corresponds to protocol.Range, but uses the editor friend Pos instead of UTF-16 oriented protocol.Position

type RelativeTo Uses

type RelativeTo string

RelativeTo is a helper for operations relative to a given directory.

func (RelativeTo) AbsPath Uses

func (r RelativeTo) AbsPath(path string) string

AbsPath returns an absolute filesystem path for the workdir-relative path.

func (RelativeTo) RelPath Uses

func (r RelativeTo) RelPath(fp string) string

RelPath returns a '/'-encoded path relative to the working directory (or an absolute path if the file is outside of workdir)

type Sandbox Uses

type Sandbox struct {
    Workdir *Workdir
    // contains filtered or unexported fields

Sandbox holds a collection of temporary resources to use for working with Go code in tests.

func NewSandbox Uses

func NewSandbox(config *SandboxConfig) (_ *Sandbox, err error)

NewSandbox creates a collection of named temporary resources, with a working directory populated by the txtar-encoded content in srctxt, and a file-based module proxy populated with the txtar-encoded content in proxytxt.

If rootDir is non-empty, it will be used as the root of temporary directories created for the sandbox. Otherwise, a new temporary directory will be used as root.

func (*Sandbox) Close Uses

func (sb *Sandbox) Close() error

Close removes all state associated with the sandbox.

func (*Sandbox) GOPATH Uses

func (sb *Sandbox) GOPATH() string

GOPATH returns the value of the Sandbox GOPATH.

func (*Sandbox) GoEnv Uses

func (sb *Sandbox) GoEnv() map[string]string

GoEnv returns the default environment variables that can be used for invoking Go commands in the sandbox.

func (*Sandbox) RootDir Uses

func (sb *Sandbox) RootDir() string

func (*Sandbox) RunGoCommand Uses

func (sb *Sandbox) RunGoCommand(ctx context.Context, dir, verb string, args []string) error

RunGoCommand executes a go command in the sandbox.

type SandboxConfig Uses

type SandboxConfig struct {
    // RootDir sets the base directory to use when creating temporary
    // directories. If not specified, defaults to a new temporary directory.
    RootDir string
    // Files holds a txtar-encoded archive of files to populate the initial state
    // of the working directory.
    // For convenience, the special substring "$SANDBOX_WORKDIR" is replaced with
    // the sandbox's resolved working directory before writing files.
    Files string
    // InGoPath specifies that the working directory should be within the
    // temporary GOPATH.
    InGoPath bool
    // Workdir configures the working directory of the Sandbox. It behaves as
    // follows:
    //  - if set to an absolute path, use that path as the working directory.
    //  - if set to a relative path, create and use that path relative to the
    //    sandbox.
    //  - if unset, default to a the 'work' subdirectory of the sandbox.
    // This option is incompatible with InGoPath or Files.
    Workdir string

    // ProxyFiles holds a txtar-encoded archive of files to populate a file-based
    // Go proxy.
    ProxyFiles string
    // GOPROXY is the explicit GOPROXY value that should be used for the sandbox.
    // This option is incompatible with ProxyFiles.
    GOPROXY string

SandboxConfig controls the behavior of a test sandbox. The zero value defines a reasonable default.

type SymbolInformation Uses

type SymbolInformation struct {
    Name     string
    Kind     protocol.SymbolKind
    Location Location

SymbolInformation is an editor friendly version of protocol.SymbolInformation, with location information transformed to byte offsets. Field names correspond to the protocol type.

type Workdir Uses

type Workdir struct {
    // contains filtered or unexported fields

Workdir is a temporary working directory for tests. It exposes file operations in terms of relative paths, and fakes file watching by triggering events on file operations.

func NewWorkdir Uses

func NewWorkdir(dir string) *Workdir

NewWorkdir writes the txtar-encoded file data in txt to dir, and returns a Workir for operating on these files using

func (*Workdir) AddWatcher Uses

func (w *Workdir) AddWatcher(watcher func(context.Context, []FileEvent))

AddWatcher registers the given func to be called on any file change.

func (*Workdir) ChangeFilesOnDisk Uses

func (w *Workdir) ChangeFilesOnDisk(ctx context.Context, events []FileEvent) error

ChangeFilesOnDisk executes the given on-disk file changes in a batch, simulating the action of changing branches outside of an editor.

func (*Workdir) CheckForFileChanges Uses

func (w *Workdir) CheckForFileChanges(ctx context.Context) error

CheckForFileChanges walks the working directory and checks for any files that have changed since the last poll.

func (*Workdir) ReadFile Uses

func (w *Workdir) ReadFile(path string) (string, error)

ReadFile reads a text file specified by a workdir-relative path.

func (*Workdir) RegexpRange Uses

func (w *Workdir) RegexpRange(path, re string) (Pos, Pos, error)

func (*Workdir) RegexpSearch Uses

func (w *Workdir) RegexpSearch(path string, re string) (Pos, error)

RegexpSearch searches the file corresponding to path for the first position matching re.

func (*Workdir) RemoveFile Uses

func (w *Workdir) RemoveFile(ctx context.Context, path string) error

RemoveFile removes a workdir-relative file path.

func (*Workdir) RootURI Uses

func (w *Workdir) RootURI() protocol.DocumentURI

RootURI returns the root URI for this working directory of this scratch environment.

func (*Workdir) URI Uses

func (w *Workdir) URI(path string) protocol.DocumentURI

URI returns the URI to a the workdir-relative path.

func (*Workdir) URIToPath Uses

func (w *Workdir) URIToPath(uri protocol.DocumentURI) string

URIToPath converts a uri to a workdir-relative path (or an absolute path, if the uri is outside of the workdir).

func (*Workdir) WriteFile Uses

func (w *Workdir) WriteFile(ctx context.Context, path, content string) error

WriteFile writes text file content to a workdir-relative path.

func (*Workdir) WriteFiles Uses

func (w *Workdir) WriteFiles(ctx context.Context, files map[string]string) error

WriteFiles writes the text file content to workdir-relative paths. It batches notifications rather than sending them consecutively.

Package fake imports 21 packages (graph) and is imported by 2 packages. Updated 2021-01-23. Refresh now. Tools for package owners.