Switch to functional options

This commit is contained in:
Tom Payne
2019-12-28 02:55:20 +01:00
committed by Christian Muehlhaeuser
parent 7349948f7f
commit 339b3e9df8
4 changed files with 130 additions and 78 deletions
+3 -2
View File
@@ -36,8 +36,9 @@ import (
"github.com/charmbracelet/glamour/ansi" "github.com/charmbracelet/glamour/ansi"
) )
r, _ := glamour.NewTermRenderer("dark", ansi.Options{ r, _ := glamour.NewTermRenderer(
WordWrap: int(40), glamour.WithStandardStyle("dark"),
glamour.WithWordWrap(40),
}) })
out, _ := r.Render(in) out, _ := r.Render(in)
+4 -4
View File
@@ -4,7 +4,6 @@ import (
"fmt" "fmt"
"github.com/charmbracelet/glamour" "github.com/charmbracelet/glamour"
"github.com/charmbracelet/glamour/ansi"
) )
func main() { func main() {
@@ -17,9 +16,10 @@ line.
Bye! Bye!
` `
r, _ := glamour.NewTermRenderer("dark", ansi.Options{ r, _ := glamour.NewTermRenderer(
WordWrap: int(40), glamour.WithStandardStyle("dark"),
}) glamour.WithWordWrap(40),
)
out, _ := r.Render(in) out, _ := r.Render(in)
fmt.Print(out) fmt.Print(out)
+110 -57
View File
@@ -3,9 +3,8 @@ package glamour
import ( import (
"bytes" "bytes"
"encoding/json" "encoding/json"
"fmt"
"io"
"io/ioutil" "io/ioutil"
"net/http"
"os" "os"
"github.com/rakyll/statik/fs" "github.com/rakyll/statik/fs"
@@ -19,14 +18,28 @@ import (
_ "github.com/charmbracelet/glamour/statik" // pre-generated styles _ "github.com/charmbracelet/glamour/statik" // pre-generated styles
) )
var statikFS http.FileSystem
// A TermRendererOption sets an option on a TermRenderer.
type TermRendererOption func(*TermRenderer) error
// TermRenderer can be used to render markdown content, posing a depth of // TermRenderer can be used to render markdown content, posing a depth of
// customization and styles to fit your needs. // customization and styles to fit your needs.
type TermRenderer struct { type TermRenderer struct {
md goldmark.Markdown md goldmark.Markdown
ansiOptions ansi.Options
buf bytes.Buffer buf bytes.Buffer
renderBuf bytes.Buffer renderBuf bytes.Buffer
} }
func init() {
var err error
statikFS, err = fs.New()
if err != nil {
panic(err)
}
}
// Render initializes a new TermRenderer and renders a markdown with a specific // Render initializes a new TermRenderer and renders a markdown with a specific
// style. // style.
func Render(in string, stylePath string) (string, error) { func Render(in string, stylePath string) (string, error) {
@@ -37,38 +50,19 @@ func Render(in string, stylePath string) (string, error) {
// RenderBytes initializes a new TermRenderer and renders a markdown with a // RenderBytes initializes a new TermRenderer and renders a markdown with a
// specific style. // specific style.
func RenderBytes(in []byte, stylePath string) ([]byte, error) { func RenderBytes(in []byte, stylePath string) ([]byte, error) {
r, err := NewTermRenderer(stylePath, ansi.Options{ r, err := NewTermRenderer(
WordWrap: 80, WithStylePath(stylePath),
}) )
if err != nil { if err != nil {
return nil, err return nil, err
} }
return r.RenderBytes(in) return r.RenderBytes(in)
} }
// NewTermRenderer returns a new TermRenderer with style and options set. // NewTermRenderer returns a new TermRenderer the given options.
func NewTermRenderer(stylePath string, options ansi.Options) (*TermRenderer, error) { func NewTermRenderer(options ...TermRendererOption) (*TermRenderer, error) {
if stylePath == "" { tr := &TermRenderer{
return NewTermRendererFromBytes([]byte("{}"), options) md: goldmark.New(
}
b, err := loadStyle(stylePath)
if err != nil {
return nil, err
}
return NewTermRendererFromBytes(b, options)
}
// NewTermRendererFromBytes returns a new TermRenderer with style and options
// set.
func NewTermRendererFromBytes(b []byte, options ansi.Options) (*TermRenderer, error) {
err := json.Unmarshal(b, &options.Styles)
if err != nil {
// FIXME: wrap error once we depend on Go 1.13
return nil, fmt.Errorf("parsing style: %v", err)
}
md := goldmark.New(
goldmark.WithExtensions( goldmark.WithExtensions(
extension.GFM, extension.GFM,
extension.DefinitionList, extension.DefinitionList,
@@ -76,16 +70,96 @@ func NewTermRendererFromBytes(b []byte, options ansi.Options) (*TermRenderer, er
goldmark.WithParserOptions( goldmark.WithParserOptions(
parser.WithAutoHeadingID(), parser.WithAutoHeadingID(),
), ),
) ),
ansiOptions: ansi.Options{
ar := ansi.NewRenderer(options) WordWrap: 80,
md.SetRenderer( },
}
for _, o := range options {
if err := o(tr); err != nil {
return nil, err
}
}
ar := ansi.NewRenderer(tr.ansiOptions)
tr.md.SetRenderer(
renderer.NewRenderer( renderer.NewRenderer(
renderer.WithNodeRenderers(util.Prioritized(ar, 1000)))) renderer.WithNodeRenderers(
util.Prioritized(ar, 1000),
),
),
)
return tr, nil
}
return &TermRenderer{ // WithBaseURL sets a TermRenderer's base URL.
md: md, func WithBaseURL(baseURL string) TermRendererOption {
}, nil return func(tr *TermRenderer) error {
tr.ansiOptions.BaseURL = baseURL
return nil
}
}
// WithStandardStyle sets a TermRenderer's styles with a standard (builtin)
// style.
func WithStandardStyle(style string) TermRendererOption {
return func(tr *TermRenderer) error {
jsonBytes, err := fs.ReadFile(statikFS, "/"+style+".json")
if err != nil {
return err
}
return json.Unmarshal(jsonBytes, &tr.ansiOptions.Styles)
}
}
// WithStylePath sets a TermRenderer's style from stylePath. stylePath is first
// interpreted as a filename. If no such file exists, it is re-interpreted as a
// standard style.
func WithStylePath(stylePath string) TermRendererOption {
return func(tr *TermRenderer) error {
jsonBytes, err := ioutil.ReadFile(stylePath)
if os.IsNotExist(err) {
jsonBytes, err = fs.ReadFile(statikFS, "/"+stylePath+".json")
}
if err != nil {
return err
}
return json.Unmarshal(jsonBytes, &tr.ansiOptions.Styles)
}
}
// WithStyles sets a TermRenderer's styles.
func WithStyles(styles ansi.StyleConfig) TermRendererOption {
return func(tr *TermRenderer) error {
tr.ansiOptions.Styles = styles
return nil
}
}
// WithStylesFromJSONBytes sets a TermRenderer's styles by parsing styles from
// jsonBytes.
func WithStylesFromJSONBytes(jsonBytes []byte) TermRendererOption {
return func(tr *TermRenderer) error {
return json.Unmarshal(jsonBytes, &tr.ansiOptions.Styles)
}
}
// WithStylesFromJSONFile sets a TermRenderer's styles from a JSON file.
func WithStylesFromJSONFile(filename string) TermRendererOption {
return func(tr *TermRenderer) error {
jsonBytes, err := ioutil.ReadFile(filename)
if err != nil {
return err
}
return json.Unmarshal(jsonBytes, &tr.ansiOptions.Styles)
}
}
// WithWordWrap sets a TermRenderer's word wrap.
func WithWordWrap(wordWrap int) TermRendererOption {
return func(tr *TermRenderer) error {
tr.ansiOptions.WordWrap = wordWrap
return nil
}
} }
func (tr *TermRenderer) Read(b []byte) (int, error) { func (tr *TermRenderer) Read(b []byte) (int, error) {
@@ -120,24 +194,3 @@ func (tr *TermRenderer) RenderBytes(in []byte) ([]byte, error) {
err := tr.md.Convert(in, &buf) err := tr.md.Convert(in, &buf)
return buf.Bytes(), err return buf.Bytes(), err
} }
func loadStyle(f string) ([]byte, error) {
var r io.ReadCloser
r, err := os.Open(f)
if err != nil {
statikFS, err := fs.New()
if err != nil {
return nil, err
}
r, err = statikFS.Open("/" + f + ".json")
if err != nil {
// FIXME: wrap error once we depend on Go 1.13
return nil, fmt.Errorf("loading style %s: %v", f, err)
}
}
defer r.Close()
return ioutil.ReadAll(r)
}
+6 -8
View File
@@ -4,8 +4,6 @@ import (
"bytes" "bytes"
"io/ioutil" "io/ioutil"
"testing" "testing"
"github.com/charmbracelet/glamour/ansi"
) )
const ( const (
@@ -15,9 +13,9 @@ const (
) )
func TestTermRendererWriter(t *testing.T) { func TestTermRendererWriter(t *testing.T) {
r, err := NewTermRenderer("styles/dark.json", ansi.Options{ r, err := NewTermRenderer(
WordWrap: 80, WithStandardStyle("dark"),
}) )
if err != nil { if err != nil {
t.Fatal(err) t.Fatal(err)
} }
@@ -63,9 +61,9 @@ func TestTermRendererWriter(t *testing.T) {
} }
func TestTermRenderer(t *testing.T) { func TestTermRenderer(t *testing.T) {
r, err := NewTermRenderer("styles/dark.json", ansi.Options{ r, err := NewTermRenderer(
WordWrap: 80, WithStandardStyle("dark"),
}) )
if err != nil { if err != nil {
t.Fatal(err) t.Fatal(err)
} }