greypot

README

greypot

An experimental library for Report building and generations, based on go-report-builder.

Very much WIP.

What does it do?

Say you want to produce reports or other such type of documents in your applications. greypot allows you to design your reports with HTML as template files that use the standard Go html/template templating engine.

These HTML reports can then be generated as HTML, PNG or PDF via endpoints that greypot adds to your application.

Once you add the middleware to your application, it adds the following routes:

GET /reports/list

GET /reports/preview/:reportTemplateName

GET /reports/render/:reportTemplateName

POST /reports/export/html/:reportTemplateName

POST /reports/export/png/:reportTemplateName

POST /reports/export/pdf/:reportTemplateName

You can then call these from within your applications to generate/export the reports e.g. from a frontend UI.

Playwright Module

Currently, we are focusing on making the playwright based renderer work really good! The base project used Chrome Developer Protocol to connect with a Chromium instance. We are evaluating that decision here

In order to use the Playwright rendering functionality, you will need to have the playwright dependencies installed.

Read here for more info. But in short, you can use the following command to do so:

$ npx playwright install-deps chromium

Basic Fiber example

package main

import (
	"embed"
	"time"

	"github.com/gofiber/fiber/v2"
	"github.com/nndi-oss/greypot"
	greypotFiber "github.com/nndi-oss/greypot/http/fiber"
)

//go:embed "templates"
var templatesFS embed.FS

func main() {
	app := fiber.New()

	module := greypot.NewModule(
		greypot.WithRenderTimeout(10*time.Second),
		greypot.WithViewport(2048, 1920),
		greypot.WithDjangoTemplateEngine(),
		greypot.WithTemplatesFromFilesystem("./templates/"),
		greypot.WithPlaywrightRenderer(),
	)

	greypotFiber.Use(app, module)

	embedModule := greypot.NewModule(
		greypot.WithRenderTimeout(10*time.Second),
		greypot.WithViewport(2048, 1920),
		greypot.WithTemplatesFromFS(templatesFS),
		greypot.WithGolangTemplateEngine(),
		greypot.WithPlaywrightRenderer(),
	)

	greypotFiber.Use(app.Group("/embedded/"), embedModule)

	app.Listen(":3000")
}

Documentation

Index

• func NewDjangoTemplateEngine() engine.TemplateEngine
• func NewFSTemplateRepo(templatesFolder fs.FS) repo.TemplateRepository
• func NewFilesystemRepo(templatesFolder string) repo.TemplateRepository
• func NewGolangTemplateEngine() engine.TemplateEngine
• func NewPongo2TemplateEngine() engine.TemplateEngine
• type GreypotOption
  • func WithChromeDPRenderer(url string) GreypotOption
  • func WithDjangoTemplateEngine() GreypotOption
  • func WithGolangTemplateEngine() GreypotOption
  • func WithPlaywrightRenderer(options ...*playwright.RunOptions) GreypotOption
  • func WithRenderTimeout(timeout time.Duration) GreypotOption
  • func WithTemplateEngine(e engine.TemplateEngine) GreypotOption
  • func WithTemplatesFromFS(dir fs.FS) GreypotOption
  • func WithTemplatesFromFilesystem(dir string) GreypotOption
  • func WithTemplatesRepository(repository repo.TemplateRepository) GreypotOption
  • func WithViewport(width, height int) GreypotOption
• type Module
  • func NewChromeDPModule(renderTimeout time.Duration, repo repo.TemplateRepository) *Module
  • func NewModule(options ...GreypotOption) *Module
  • func NewPlaywrightModule(renderTimeout time.Duration, repo repo.TemplateRepository) *Module

Functions

func NewDjangoTemplateEngine

func NewDjangoTemplateEngine() engine.TemplateEngine

func NewFSTemplateRepo

func NewFSTemplateRepo(templatesFolder fs.FS) repo.TemplateRepository

func NewFilesystemRepo

func NewFilesystemRepo(templatesFolder string) repo.TemplateRepository

func NewGolangTemplateEngine

func NewGolangTemplateEngine() engine.TemplateEngine

func NewPongo2TemplateEngine

func NewPongo2TemplateEngine() engine.TemplateEngine

Types

type GreypotOption

type GreypotOption func(*Module)

func WithChromeDPRenderer

func WithChromeDPRenderer(url string) GreypotOption

func WithDjangoTemplateEngine

func WithDjangoTemplateEngine() GreypotOption

func WithGolangTemplateEngine

func WithGolangTemplateEngine() GreypotOption

func WithPlaywrightRenderer

func WithPlaywrightRenderer(options ...*playwright.RunOptions) GreypotOption

func WithRenderTimeout

func WithRenderTimeout(timeout time.Duration) GreypotOption

func WithTemplateEngine

func WithTemplateEngine(e engine.TemplateEngine) GreypotOption

func WithTemplatesFromFS

func WithTemplatesFromFS(dir fs.FS) GreypotOption

func WithTemplatesFromFilesystem

func WithTemplatesFromFilesystem(dir string) GreypotOption

func WithTemplatesRepository

func WithTemplatesRepository(repository repo.TemplateRepository) GreypotOption

func WithViewport

func WithViewport(width, height int) GreypotOption

type Module

type Module struct {
	RenderTimeout  time.Duration
	ViewportHeight int
	ViewportWidth  int

	TemplateService service.TemplateService
	ReportService   service.ReportService

	TemplateEngine     engine.TemplateEngine
	TemplateRepository repo.TemplateRepository
	PDFExporter        exporter.ReportExporter
	PNGExporter        exporter.ReportExporter
}

func NewChromeDPModule

func NewChromeDPModule(renderTimeout time.Duration, repo repo.TemplateRepository) *Module

func NewModule

func NewModule(options ...GreypotOption) *Module

func NewPlaywrightModule

func NewPlaywrightModule(renderTimeout time.Duration, repo repo.TemplateRepository) *Module