ast

Documentation

Overview

Package ast declares the types used to represent syntax trees for the .env file.

Index

• type Assignment
  • func (a *Assignment) BelongsToGroup(name string) bool
  • func (a *Assignment) Documentation(withoutPrefix bool) string
  • func (a *Assignment) HasComments() bool
  • func (a *Assignment) Is(other Statement) bool
  • func (a *Assignment) SetQuote(in string)
  • func (a *Assignment) Type() string
  • func (a *Assignment) ValidationRules() string
• type Comment
  • func NewComment(value string) *Comment
  • func (c *Comment) BelongsToGroup(name string) bool
  • func (c *Comment) Is(other Statement) bool
  • func (c *Comment) String() string
  • func (c *Comment) Type() string
• type Document
  • func (d *Document) Assignments() []*Assignment
  • func (d *Document) BelongsToGroup(name string) bool
  • func (doc *Document) EnsureGroup(name string) *Group
  • func (d *Document) Get(name string) *Assignment
  • func (d *Document) GetConfig(name string) (string, error)
  • func (d *Document) GetGroup(name string) *Group
  • func (d *Document) GetInterpolation(in string) (string, bool)
  • func (d *Document) GetPosition(name string) (int, *Assignment)
  • func (d *Document) Is(other Statement) bool
  • func (doc *Document) Set(input *Assignment, options SetOptions) (bool, error)
  • func (d *Document) Type() string
• type Group
  • func (g *Group) BelongsToGroup(name string) bool
  • func (g *Group) Is(other Statement) bool
  • func (g *Group) String() string
  • func (g *Group) Type() string
• type Newline
  • func (n *Newline) Is(other Statement) bool
  • func (n *Newline) Type() string
• type Position
  • func (p Position) String() string
• type SetOptions
• type Statement

Types

type Assignment

type Assignment struct {
	Name         string      `json:"key"`       // Name of the key (left hand side of the "=" sign)
	Literal      string      `json:"literal"`   // Value of the key (right hand side of the "=" sign)
	Interpolated string      `json:"value"`     // Value of the key (after interpolation)
	Complete     bool        `json:"complete"`  // The key/value had no value/content after the "=" sign
	Active       bool        `json:"commented"` // The assignment was commented out (#KEY=VALUE)
	Quote        token.Quote `json:"quote"`     // The style of quotes used for the assignment
	Group        *Group      `json:"-"`         // The (optional) group this assignment belongs to
	Comments     []*Comment  `json:"comments"`  // Comments attached to the assignment (e.g. doc block before it)
	Position     Position    `json:"position"`  // Information about position of the assignment in the file
}

func (*Assignment) BelongsToGroup

func (a *Assignment) BelongsToGroup(name string) bool

func (*Assignment) Documentation

func (a *Assignment) Documentation(withoutPrefix bool) string

func (*Assignment) HasComments

func (a *Assignment) HasComments() bool

func (*Assignment) Is

func (a *Assignment) Is(other Statement) bool

func (*Assignment) SetQuote

func (a *Assignment) SetQuote(in string)

func (*Assignment) Type

func (a *Assignment) Type() string

func (*Assignment) ValidationRules

func (a *Assignment) ValidationRules() string

type Comment

type Comment struct {
	Value      string            `json:"value"`      // The actual comment value
	Annotation *token.Annotation `json:"annotation"` // If the comment was detected to be an annotation
	Group      *Group            `json:"-"`          // The (optional) group the comment belongs to
	Position   Position          `json:"position"`   // Information about position of the assignment in the file
}

Comment node represents a comment statement.

func NewComment

func NewComment(value string) *Comment

func (*Comment) BelongsToGroup

func (c *Comment) BelongsToGroup(name string) bool

func (*Comment) Is

func (c *Comment) Is(other Statement) bool

func (*Comment) String

func (c *Comment) String() string

func (*Comment) Type

func (c *Comment) Type() string

type Document

type Document struct {
	Statements  []Statement `json:"statements"` // Statements belonging to the root of the document
	Groups      []*Group    `json:"groups"`     // Groups within the document
	Annotations []*Comment  `json:"-"`          // Global annotations for configuration of dottie
}

Document node represents .env file statement, that contains assignments and comments.

func (*Document) Assignments

func (d *Document) Assignments() []*Assignment

func (*Document) BelongsToGroup

func (d *Document) BelongsToGroup(name string) bool

func (*Document) EnsureGroup

func (doc *Document) EnsureGroup(name string) *Group

func (*Document) Get

func (d *Document) Get(name string) *Assignment

func (*Document) GetConfig

func (d *Document) GetConfig(name string) (string, error)

func (*Document) GetGroup

func (d *Document) GetGroup(name string) *Group

func (*Document) GetInterpolation

func (d *Document) GetInterpolation(in string) (string, bool)

func (*Document) GetPosition

func (d *Document) GetPosition(name string) (int, *Assignment)

func (*Document) Is

func (d *Document) Is(other Statement) bool

func (*Document) Set

func (doc *Document) Set(input *Assignment, options SetOptions) (bool, error)

func (*Document) Type

func (d *Document) Type() string

type Group

type Group struct {
	Name       string      `json:"name"`       // Name of the group (within the header)
	Statements []Statement `json:"statements"` // Statements within the group
	Position   Position    `json:"position"`   // Positional information about the group
}

func (*Group) BelongsToGroup

func (g *Group) BelongsToGroup(name string) bool

func (*Group) Is

func (g *Group) Is(other Statement) bool

func (*Group) String

func (g *Group) String() string

func (*Group) Type

func (g *Group) Type() string

type Newline

type Newline struct {
	Blank    bool     `json:"blank"`
	Group    *Group   `json:"-"`
	Repeated int      `json:"repeated"`
	Position Position `json:"position"`
}

func (*Newline) Is

func (n *Newline) Is(other Statement) bool

func (*Newline) Type

func (n *Newline) Type() string

type Position

type Position struct {
	File      string `json:"file"`
	Line      uint   `json:"line"`
	FirstLine uint   `json:"first_line"`
	LastLine  uint   `json:"last_line"`
}

func (Position) String

func (p Position) String() string

type SetOptions

type SetOptions struct {
	ErrorIfMissing bool
	SkipIfSet      bool
	SkipIfSame     bool
	Group          string
	Before         string
	Comments       []string
}

type Statement

type Statement interface {
	Is(Statement) bool
	Type() string
	// contains filtered or unexported methods
}

Statement represents syntax tree node of .env file statement (like: assignment or comment).