mirror of
https://github.com/hanzoai/gateway.git
synced 2026-11-02 15:19:24 +00:00
Every import in this module now resolves to github.com/hanzoai/gateway/v2.
The 34 github.com/krakend/* + github.com/luraproject/lura modules that
supplied the engine and its components are vendored under internal/ and
their 91 packages rewritten onto our own path.
Why fold rather than mirror into 34 hanzoai/* repos:
- It removes the exposure outright. 34 rows leave 34 rows of go.sum to
reason about; zero modules leave nothing. `go list -m all` and go.sum
now contain no krakend/lura entry at all.
- Cross-references cannot go wrong. 28 of the 34 import lura (97 files
inside lura self-reference it). Mirroring means rewriting every one of
those to our lura, and a single miss silently links a SECOND copy of
lura into the binary. With one module that is structurally impossible.
- It creates no duplicates. These are lura-coupled gateway glue with no
consumer outside this binary; publishing 34 repos would be 34 new
things to maintain for zero second caller. internal/ makes that
guarantee mechanical — Go forbids importing it from outside this
module, so none of it can become a competing public package. Verified
no repo outside gateway imports any hanzoai/gateway/v2 subpackage.
Layout mirrors provenance so an upstream re-sync stays a diff:
luraproject/lura/v2 -> internal/lura (the engine, 20 pkgs)
krakend/krakend-<x> -> internal/plugin/<x> (28 components)
krakend/<x> -> internal/pkg/<x> (6 standalone libs)
This commit is PURELY MECHANICAL: 196 of the 197 vendored files are
byte-identical to their upstream original once the import rewrite is
applied. The single exception is bloomfilter's subpackage, which upstream
names `krakend` — the one package name that could not survive as-is; it
becomes internal/pkg/bloomfilter/register. Hand edits land separately in
the next commit so they are readable on their own.
Per `go mod vendor` semantics, dependencies' _test.go files are not
vendored. They test upstream code at a pinned version that we do not
modify, several cannot run at all from a module distribution (they need
TLS certs and compiled .so plugins upstream generates but never ships),
and one is a 100k-request stress test that exhausts the ephemeral port
range and fails every package running beside it. Fold integrity is proven
by the byte-diff above instead, which is the stronger check.
Preserved deliberately — each of these is behaviour, not branding:
- the `github.com/devopsfaith/krakend*` extra_config namespace strings
(35 of them). These are config-surface keys, not import paths;
renaming one silently stops that component finding its config. The
jose validator namespace backs `auth/validator` on 212 endpoints.
- core.KrakendVersion / KrakendUserAgent / the X-KRAKEND consts, whose
VALUES rebrand.go overwrites — that seam is unchanged.
- the KRAKEND_ koanf env prefix (a hardcoded upstream const).
- every vendored module's LICENSE (34 files, Apache-2.0/MIT).
The Makefile/CI -X paths move with the engine. An -X naming a symbol that
does not exist is silently ignored by the linker, so a stale path here
would have shipped an "undefined" version in the backend User-Agent and
X-Api-Version with a perfectly green build. Verified live:
`gateway version` reports 2.13.0, not undefined.
Verification (GOWORK=off CGO_ENABLED=0, both tag modes):
go build ./... OK go build -tags legacy ./... OK
go vet ./... clean go vet -tags legacy ./... clean
go test ./... 6/6 ok go test -tags legacy 5/5 ok
tests/ integration harness 47 fixtures pass
gateway check -c configs/{hanzo,lux}/gateway.json -> Syntax OK!
go list -m all | grep -iE 'krakend|lura' -> empty
go mod verify -> all modules verified
Co-authored-by: Hanzo Dev <[email protected]>
149 lines
2.7 KiB
Go
149 lines
2.7 KiB
Go
package binder
|
|
|
|
import (
|
|
"io/ioutil"
|
|
|
|
lua "github.com/yuin/gopher-lua"
|
|
)
|
|
|
|
// Handler is binder function handler
|
|
type Handler func(*Context) error
|
|
|
|
// Binder is a binder... that's all
|
|
type Binder struct {
|
|
*Loader
|
|
state *lua.LState
|
|
loaders []*Loader
|
|
}
|
|
|
|
// Load apply Loader
|
|
func (b *Binder) Load(loader *Loader) {
|
|
b.loaders = append(b.loaders, loader)
|
|
}
|
|
|
|
// Close closes the binder.
|
|
// It should be called after the binder is not needed any more.
|
|
func (b *Binder) Close() {
|
|
b.state.Close()
|
|
}
|
|
|
|
// DoString runs lua script string
|
|
func (b *Binder) DoString(s string) error {
|
|
b.load()
|
|
return b.do(b.state.DoString(s), func(problem int) *source {
|
|
return newSource(s, problem)
|
|
})
|
|
}
|
|
|
|
// DoFile runs lua script file
|
|
func (b *Binder) DoFile(f string) error {
|
|
b.load()
|
|
return b.do(b.state.DoFile(f), func(problem int) *source {
|
|
s, _ := ioutil.ReadFile(f)
|
|
return newSource(string(s), problem)
|
|
})
|
|
}
|
|
|
|
// do applies returns improved errors if it needed
|
|
func (b *Binder) do(err error, h errSourceHandler) error {
|
|
if err != nil {
|
|
return newError(err, h)
|
|
}
|
|
|
|
return nil
|
|
}
|
|
|
|
// source returns lua source script
|
|
func (b *Binder) source() string {
|
|
return b.state.String()
|
|
}
|
|
|
|
func (b *Binder) load() {
|
|
loaders := append([]*Loader{b.Loader}, b.loaders...)
|
|
|
|
for _, l := range loaders {
|
|
l.load(b.state)
|
|
}
|
|
}
|
|
|
|
// New returns new binder instance.
|
|
// The caller should call [Binder.Close] when the binder is no longer needed.
|
|
func New(opts ...Options) *Binder {
|
|
options := []lua.Options{}
|
|
|
|
if len(opts) > 0 {
|
|
o := opts[0]
|
|
|
|
options = append(options, lua.Options{
|
|
CallStackSize: o.CallStackSize,
|
|
RegistrySize: o.RegistrySize,
|
|
SkipOpenLibs: o.SkipOpenLibs,
|
|
IncludeGoStackTrace: o.IncludeGoStackTrace,
|
|
})
|
|
}
|
|
|
|
s := lua.NewState(options...)
|
|
|
|
if len(opts) > 0 && opts[0].SkipOpenLibs {
|
|
type lib struct {
|
|
Name string
|
|
Func lua.LGFunction
|
|
}
|
|
|
|
libs := []lib{
|
|
{lua.LoadLibName, lua.OpenPackage},
|
|
{lua.BaseLibName, lua.OpenBase},
|
|
{lua.TabLibName, lua.OpenTable},
|
|
}
|
|
|
|
for _, l := range libs {
|
|
s.Push(s.NewFunction(l.Func))
|
|
s.Push(lua.LString(l.Name))
|
|
s.Call(1, 0)
|
|
}
|
|
}
|
|
|
|
b := &Binder{
|
|
state: s,
|
|
loaders: []*Loader{},
|
|
}
|
|
b.Loader = NewLoader()
|
|
|
|
return b
|
|
}
|
|
|
|
// NewLoader returns new loader
|
|
func NewLoader() *Loader {
|
|
return &Loader{
|
|
funcs: map[string]Handler{},
|
|
modules: []*Module{},
|
|
tables: []*Table{},
|
|
}
|
|
}
|
|
|
|
func exports(funcs map[string]Handler) map[string]lua.LGFunction {
|
|
e := make(map[string]lua.LGFunction, len(funcs))
|
|
|
|
for name, handler := range funcs {
|
|
e[name] = handle(handler)
|
|
}
|
|
|
|
return e
|
|
}
|
|
|
|
func handle(handler Handler) lua.LGFunction {
|
|
return func(state *lua.LState) int {
|
|
c := &Context{
|
|
state: state,
|
|
}
|
|
|
|
err := handler(c)
|
|
if err != nil {
|
|
c.error(err.Error())
|
|
return 0
|
|
}
|
|
|
|
return c.pushed
|
|
}
|
|
}
|