🖼️ Micro fragmentation middleware for fiber 🚀 that enables to build microservice frontends.
Перейти к файлу
Sebastian Döll 54fa75926d (wip) increase read buffer size 2021-08-30 10:17:18 +00:00
.devcontainer Update devcontainer.json 2021-06-28 16:39:35 +02:00
.github/workflows fix: move golangci to own job 2021-07-14 12:15:18 +00:00
example (doc) adding multiple forward ref templates 2021-08-23 19:15:19 +00:00
.editorconfig (chore) init 2021-06-28 10:19:15 +00:00
.envrc (chore) init 2021-06-28 10:19:15 +00:00
.envsh (chore) init 2021-06-28 10:19:15 +00:00
.gitignore (chore) init 2021-06-28 10:19:15 +00:00
CODE_OF_CONDUCT.md wip: update docs 2021-07-12 14:47:34 +00:00
CONTRIBUTING.md wip: update docs 2021-07-12 14:47:34 +00:00
LICENSE wip: update docs 2021-07-12 14:47:34 +00:00
README.md Update README.md 2021-08-23 15:24:53 +02:00
SECURITY.md doc: adding SECURITY.md 2021-07-14 12:29:20 +00:00
document.go (fix) root node injection 2021-08-25 11:11:54 +00:00
fragment.go (fix) root node injection 2021-08-25 11:11:54 +00:00
fragments.go (wip) increase read buffer size 2021-08-30 10:17:18 +00:00
fragments_test.go wip: update docs 2021-07-12 14:47:34 +00:00
go.mod (chore) define fragment references 2021-08-19 14:10:03 +00:00
go.sum (chore) define fragment references 2021-08-19 14:10:03 +00:00
links.go wip: primary fragment and options 2021-07-12 20:19:12 +00:00
resolver.go (chore) closes #1 by adding forward ref 2021-08-22 19:32:52 +00:00

README.md

Fragments

main Go Report Card License: MIT Taylor Swift

Fragments middleware for Fiber enables building microservices for the frontend.

A <fragment> symbolizes a part of a template that can be served by a singular microservice. Thus, making a fragment the contract between different services and teams within a large engineering organization. The middleware concurrently fetches those parts from the service and replaces it in the template. It supports GET and POST HTTP methods to fetcht the content. Related resources like CSS or JavaScript are injected via the HTTP LINK entity header field. A <fragment> can occure in the body element or the header element. See Example to learn more about using fragments.

Tailor by Zalando is prior art for this middleware.

Fragement(s)

A fragment will be hybrid-polymorphic (if this is a thing). On the server it is parsed and evaluate by the middleware. 🦄 In the browser it will be a web component that received data from the middleware (this is still work in progress ⚠️).

Server

  • src The source to fetch for replacement in the DOM
  • method can be of GET (default) or POST.
  • primary denotes a fragment that sets the response code of the page
  • id is an optional unique identifier (optional)
  • refis an optional forward reference to an id (optional)
  • timeout timeout of a fragement to receive in milliseconds (default is 300)
  • deferred is deferring the fetch to the browser
  • fallback is the fallback source in case of timeout/error on the current fragment

Example

Import the middleware package this is part of the Fiber web framework.

package main

import (
	"github.com/gofiber/fiber/v2"
	"github.com/gofiber/template/html"

	"github.com/github/fiber-fragments"
)

After you initiate your Fiber app, you can plugin in the fragments middleware. The middleware draws the templates for the fragments to load from the template engine. Thus it supports using all template engines supported by the Fiber team.

// Create a new engine
engine := html.New("./views", ".html")

// Pass the engine to the Views
app := fiber.New(fiber.Config{
	Views: engine,
})

// Associates the route with a specific template with fragments to render
app.Get("/index", fragments.Template(fragments.Config{}, "index", fiber.Map{}, "layouts/main"))

// this would listen to port 8080
app.Listen(":8080")
<html>
<head>
    <script type="fragment" src="assets"></script>
</head>
<body>
    <h1>Example</h1>
    <fragment src="fragment1.html"></fragment>
</body>
</html>

The example folder contains many examples. You can learn how to use a forward reference of content for fetching outer and inner content and replace either one.

Benchmark(s)

This is run on a MacBook Pro 16 inch locally. It is the example run.

  • Parsing a local template with extrapolation with the fragments
  • Parsing the fragments
  • Doing fragments
  • Inlining results and adding Link header resources to the output
echo "GET http://127.0.0.1:8080/index" | vegeta attack -duration=5s -rate 2000 | tee results.bin | vegeta report
  vegeta report -type=json results.bin > metrics.json
  cat results.bin | vegeta plot > plot.html
  cat results.bin | vegeta report -type="hist[0,100ms,200ms,300ms]"

Requests      [total, rate, throughput]         10000, 2000.26, 2000.15
Duration      [total, attack, wait]             5s, 4.999s, 285.172µs
Latencies     [min, mean, 50, 90, 95, 99, max]  183.725µs, 251.517µs, 226.993µs, 310.698µs, 394.601µs, 563.022µs, 1.347ms
Bytes In      [total, mean]                     6240000, 624.00
Bytes Out     [total, mean]                     0, 0.00
Success       [ratio]                           100.00%
Status Codes  [code:count]                      200:10000
Error Set:
Bucket           #      %        Histogram
[0s,     100ms]  10000  100.00%  ###########################################################################
[100ms,  200ms]  0      0.00%
[200ms,  300ms]  0      0.00%
[300ms,  +Inf]   0      0.00%

License

MIT