filesystem

Documentation

Overview

Package filesystem implements a virtual filesystem which reflects the needs of both the language server and the HCL parser.

- creates in-memory files based on data received from the language client - allows updating in-memory files via diffs received from the language client - maintains file metadata (e.g. version, or whether it's open by the client)

Index

• func NewDocumentMetadata(dh DocumentHandler, content []byte) *documentMetadata
• func NewFilesystem() *fsystem
• func URIFromPath(path string) string
• type Document
• type DocumentChange
• type DocumentChanges
• type DocumentHandler
• type DocumentNotOpenErr
  • func (e *DocumentNotOpenErr) Error() string
• type DocumentStorage
• type Filesystem
• type MetadataAlreadyExistsErr
  • func (e *MetadataAlreadyExistsErr) Error() string
• type UnknownDocumentErr
  • func (e *UnknownDocumentErr) Error() string
• type VersionedDocumentHandler

Functions

func NewDocumentMetadata

func NewDocumentMetadata(dh DocumentHandler, content []byte) *documentMetadata

func NewFilesystem

func NewFilesystem() *fsystem

func URIFromPath

func URIFromPath(path string) string

Types

type Document

type Document interface {
	DocumentHandler
	Text() ([]byte, error)
	Lines() source.Lines
	Version() int
}

type DocumentChange

type DocumentChange interface {
	Text() string
	Range() hcl.Range
}

type DocumentChanges

type DocumentChanges []DocumentChange

type DocumentHandler

type DocumentHandler interface {
	URI() string
	FullPath() string
	Dir() string
	Filename() string
}

type DocumentNotOpenErr

type DocumentNotOpenErr struct {
	DocumentHandler DocumentHandler
}

func (*DocumentNotOpenErr) Error

func (e *DocumentNotOpenErr) Error() string

type DocumentStorage

type DocumentStorage interface {
	// LS-specific methods
	CreateDocument(DocumentHandler, []byte) error
	CreateAndOpenDocument(DocumentHandler, []byte) error
	GetDocument(DocumentHandler) (Document, error)
	CloseAndRemoveDocument(DocumentHandler) error
	ChangeDocument(VersionedDocumentHandler, DocumentChanges) error
}

type Filesystem

type Filesystem interface {
	DocumentStorage

	// direct FS methods
	ReadFile(name string) ([]byte, error)
	ReadDir(name string) ([]os.FileInfo, error)
	Open(name string) (tfconfig.File, error)
}

type MetadataAlreadyExistsErr

type MetadataAlreadyExistsErr struct {
	DocumentHandler DocumentHandler
}

func (*MetadataAlreadyExistsErr) Error

func (e *MetadataAlreadyExistsErr) Error() string

type UnknownDocumentErr

type UnknownDocumentErr struct {
	DocumentHandler DocumentHandler
}

func (*UnknownDocumentErr) Error

func (e *UnknownDocumentErr) Error() string

type VersionedDocumentHandler

type VersionedDocumentHandler interface {
	DocumentHandler
	Version() int
}