braceexpansion

README

braceexpansion

Shell brace expansion implemented in Go (golang).

Supports some specialties required by multigoogle.

Numeric ranges are currently not supported, as I didn't need them. Feel free to send a PR.

Build

$ cd cmd && go build -o be

Usage (command line):

$ be '{a,b}{1,2}'
a1
a2
b1
b2

Usage (library):

import (
	be "github.com/thomasheller/braceexpansion"
	"fmt"
)

func main() {
	tree, err := be.New().Parse("{a,b}{1,2}")
	if err != nil {
		panic(err)
	}
	for _, s := range tree.Expand() {
		fmt.Println(s)
	}
	
	// Output:
	// a1
	// a2
	// b1
	// b2
}

Documentation

Index

• func Cartesian(sets [][]string) []string
• func Cartesian2(first, second []string) []string
• type ListNode
  • func (l ListNode) Expand(root bool) []string
• type Node
• type NodeType
• type ParseOpts
• type PhraseNode
  • func (p PhraseNode) Expand() []string
• type TextNode
  • func (t TextNode) Expand() []string
• type Tree
  • func New() *Tree
  • func (t *Tree) Expand() []string
  • func (t *Tree) Parse(input string) (tree *Tree, err error)
  • func (t *Tree) ParseCustom(input string, opts ParseOpts) (tree *Tree, err error)

Functions

func Cartesian

func Cartesian(sets [][]string) []string

func Cartesian2

func Cartesian2(first, second []string) []string

Types

type ListNode

type ListNode struct {
	NodeType
	Phrases []PhraseNode
	Tree    *Tree
}

func (ListNode) Expand

func (l ListNode) Expand(root bool) []string

type Node

type Node interface{}

type NodeType

type NodeType int

const (
	NodeList NodeType = iota
	NodePhrase
	NodeText
)

type ParseOpts

type ParseOpts struct {
	OpenBrace             string
	CloseBrace            string
	Separator             string
	TreatRootAsList       bool
	TreatSingleAsOptional bool
}

type PhraseNode

type PhraseNode struct {
	NodeType
	Parts []Node // TextNode or ListNode
}

func (PhraseNode) Expand

func (p PhraseNode) Expand() []string

type TextNode

type TextNode struct {
	NodeType
	// contains filtered or unexported fields
}

func (TextNode) Expand

func (t TextNode) Expand() []string

type Tree

type Tree struct {
	Root *ListNode
	// contains filtered or unexported fields
}

func New

func New() *Tree

func (*Tree) Expand

func (t *Tree) Expand() []string

func (*Tree) Parse

func (t *Tree) Parse(input string) (tree *Tree, err error)

func (*Tree) ParseCustom

func (t *Tree) ParseCustom(input string, opts ParseOpts) (tree *Tree, err error)