Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion .github/workflows/test.yml
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ jobs:
test:
strategy:
matrix:
go-version: [1.19.x]
go-version: [1.23.x]
platform: [ubuntu-latest, macos-latest, windows-latest]
runs-on: ${{ matrix.platform }}
steps:
Expand Down
4 changes: 2 additions & 2 deletions go.mod
Original file line number Diff line number Diff line change
@@ -1,10 +1,10 @@
module github.com/dolthub/go-icu-regex

go 1.19
go 1.23

require (
github.com/stretchr/testify v1.8.2
github.com/tetratelabs/wazero v1.1.0
github.com/tetratelabs/wazero v1.8.2
gopkg.in/src-d/go-errors.v1 v1.0.0
)

Expand Down
4 changes: 2 additions & 2 deletions go.sum
Original file line number Diff line number Diff line change
Expand Up @@ -12,8 +12,8 @@ github.com/stretchr/testify v1.7.1/go.mod h1:6Fq8oRcR53rry900zMqJjRRixrwX3KX962/
github.com/stretchr/testify v1.8.0/go.mod h1:yNjHg4UonilssWZ8iaSj1OCr/vHnekPRkoO+kdMU+MU=
github.com/stretchr/testify v1.8.2 h1:+h33VjcLVPDHtOdpUCuF+7gSuG3yGIftsP1YvFihtJ8=
github.com/stretchr/testify v1.8.2/go.mod h1:w2LPCIKwWwSfY2zedu0+kehJoqGctiVI29o6fzry7u4=
github.com/tetratelabs/wazero v1.1.0 h1:EByoAhC+QcYpwSZJSs/aV0uokxPwBgKxfiokSUwAknQ=
github.com/tetratelabs/wazero v1.1.0/go.mod h1:wYx2gNRg8/WihJfSDxA1TIL8H+GkfLYm+bIfbblu9VQ=
github.com/tetratelabs/wazero v1.8.2 h1:yIgLR/b2bN31bjxwXHD8a3d+BogigR952csSDdLYEv4=
github.com/tetratelabs/wazero v1.8.2/go.mod h1:yAI0XTsMBhREkM/YDAK/zNou3GoiAce1P6+rp/wQhjs=
gopkg.in/check.v1 v0.0.0-20161208181325-20d25e280405 h1:yhCVgyC4o1eVCa2tZl7eS0r+SDo693bJlVdllGtEeKM=
gopkg.in/check.v1 v0.0.0-20161208181325-20d25e280405/go.mod h1:Co6ibVJAznAaIkqp8huTwlJQCZ016jof/cbN4VW5Yz0=
gopkg.in/src-d/go-errors.v1 v1.0.0 h1:cooGdZnCjYbeS1zb1s6pVAAimTdKceRrpn7aKOnNIfc=
Expand Down
46 changes: 1 addition & 45 deletions initialization.go
Original file line number Diff line number Diff line change
Expand Up @@ -15,57 +15,13 @@
package regex

import (
"context"
_ "embed"
"runtime"
"sync"

"github.com/tetratelabs/wazero"
"github.com/tetratelabs/wazero/api"
"github.com/tetratelabs/wazero/imports/wasi_snapshot_preview1"
)

// Embedded data that will be loaded into our WASM runtime
var (
//go:embed icu/wasm/icu.wasm
icuWasm []byte // This is generated using the "build.sh" script in the "icu" folder
icuConfig = wazero.NewModuleConfig()
)

var r wazero.Runtime
var modulePool = sync.Pool{
New: func() any {
ctx := context.Background()

// Load the ICU library
mod, err := r.Instantiate(ctx, icuWasm)
if err != nil {
panic(err)
}

// We set a finalizer here, as the pool will periodically empty itself, and we need to close the module during
// that time.
runtime.SetFinalizer(mod, func(mod api.Module) {
_ = mod.Close(context.Background())
})
return mod
},
}

func init() {
ctx := context.Background()

// Create the WASM runtime
r = wazero.NewRuntime(ctx)
wasi_snapshot_preview1.MustInstantiate(ctx, r)
envBuilder := r.NewHostModuleBuilder("env")
noop_two := func(int32, int32) int32 { return -1 }
noop_four := func(int32, int32, int32, int32) int32 { return -1 }
envBuilder.NewFunctionBuilder().WithFunc(noop_two).Export("__syscall_stat64")
envBuilder.NewFunctionBuilder().WithFunc(noop_two).Export("__syscall_lstat64")
envBuilder.NewFunctionBuilder().WithFunc(noop_two).Export("__syscall_fstat64")
envBuilder.NewFunctionBuilder().WithFunc(noop_four).Export("__syscall_newfstatat")
_, err := envBuilder.Instantiate(ctx)
if err != nil {
panic(err)
}
}
212 changes: 212 additions & 0 deletions pool.go
Original file line number Diff line number Diff line change
@@ -0,0 +1,212 @@
// Copyright 2024 Dolthub, Inc.
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
// http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.

package regex

import (
"context"
"github.com/tetratelabs/wazero"
"github.com/tetratelabs/wazero/api"
"github.com/tetratelabs/wazero/imports/wasi_snapshot_preview1"
"reflect"
"runtime"
"sync"
)

// modulePool is the pool that is used internally by the project.
var modulePool = NewPool()

// RuntimeTracker tracks all relevant information that the Pool needs regarding a runtime.
type RuntimeTracker struct {
id uint64
r wazero.Runtime
compiled wazero.CompiledModule
modules []api.Module
max uint64
fetches uint64
}

// Pool is a special pool object for handling ICU regex modules. The cause isn't quite clear, but runtimes continue to
// hold onto memory even when their owned modules are closed, so this special pool type will also recycle the runtimes
// once a certain number of modules have been fetched.
type Pool struct {
mutex *sync.Mutex
runtimes []*RuntimeTracker
outstandingMods map[uintptr]uint64
nextId uint64
maxFetch uint64
}

// NewPool creates a new *Pool.
func NewPool() *Pool {
r, compiled := createRuntime(context.Background())
pool := &Pool{
mutex: &sync.Mutex{},
runtimes: []*RuntimeTracker{{
id: 1,
r: r,
compiled: compiled,
modules: make([]api.Module, 0, 16),
max: 0,
fetches: 0,
}},
outstandingMods: make(map[uintptr]uint64),
nextId: 2,
maxFetch: 128,
}
return pool
}

// Get returns a new module from the pool.
func (pool *Pool) Get() api.Module {
pool.mutex.Lock()
defer pool.mutex.Unlock()

ctx := context.Background()
rtracker := pool.runtimes[len(pool.runtimes)-1]
rtracker.fetches++
// If we've used up the number of fetches allowed in this runtime, then we'll create a new one
if rtracker.fetches >= pool.maxFetch {
r, compiled := createRuntime(ctx)
rtracker = &RuntimeTracker{
id: pool.nextId,
r: r,
compiled: compiled,
modules: make([]api.Module, 0, 16),
max: 0,
fetches: 0,
}
pool.runtimes = append(pool.runtimes, rtracker)
pool.nextId++
}
var module api.Module
// If the runtime has no modules remaining, then we need to create a new module
if len(rtracker.modules) == 0 {
rtracker.max++
var err error
module, err = rtracker.r.InstantiateModule(ctx, rtracker.compiled, icuConfig)
if err != nil {
panic(err)
}
} else {
// Pop the last module from the slice
module = rtracker.modules[len(rtracker.modules)-1]
rtracker.modules = rtracker.modules[:len(rtracker.modules)-1]
}
// Now we need to track that this module is being returned
pool.outstandingMods[reflect.ValueOf(module).Pointer()] = rtracker.id
runtime.SetFinalizer(module, func(module api.Module) {
pool.finalized(module)
})
return module
}

// Put returns the module to the pool.
func (pool *Pool) Put(module api.Module) {
pool.mutex.Lock()
defer pool.mutex.Unlock()
pool.receivedModule(module, true)
}

// finalized is called by the finalizer, and only exists to catch orphaned modules.
func (pool *Pool) finalized(module api.Module) {
pool.mutex.Lock()
defer pool.mutex.Unlock()
pool.receivedModule(module, false)
}

// receivedModule is called when either the module is returned through Put, or the finalizer catches an orphaned module
// through finalized.
func (pool *Pool) receivedModule(module api.Module, isPut bool) {
// Remove the finalizer that was set when the object was fetched.
// This is only called from Put, as the finalizer is being called so we don't want to remove it.
if isPut {
runtime.SetFinalizer(module, nil)
}
// Grab the runtime ID and remove the module from the tracking map
ptr := reflect.ValueOf(module).Pointer()
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

If this is slow, it might make sense to get it a single time at creation, and for the pool to vend an object which includes both the api.Module and its uintptr

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This isn't the slow portion. It's wazero.NewRuntime(ctx) that's slow (like half a second on my machine). That's why we can't just create a new one on every request. Second to that is InstantiateModule. Everything else is essentially instant in comparison. The slowdown is due to having to periodically a new runtime, not really anything else.

runtimeId := pool.outstandingMods[ptr]
delete(pool.outstandingMods, ptr)
for rtrackerIdx := 0; rtrackerIdx < len(pool.runtimes); rtrackerIdx++ {
ctx := context.Background()
rtracker := pool.runtimes[rtrackerIdx]
// If this is a different runtime, then we still need to check whether it should be removed
if rtracker.id != runtimeId {
if rtracker.fetches >= pool.maxFetch && uint64(len(rtracker.modules)) >= rtracker.max {
pool.closeRuntime(ctx, rtrackerIdx, rtracker)
rtrackerIdx--
}
continue
}
if isPut {
// Add the module back to the runtime when called from Put
rtracker.modules = append(rtracker.modules, module)
} else {
// We remove the module from the runtime altogether when called from the finalizer
rtracker.max--
_ = module.Close(ctx)
}
// If this runtime has run out of fetches and all of its modules are back, then we need to close and remove it
if rtracker.fetches >= pool.maxFetch && uint64(len(rtracker.modules)) >= rtracker.max {
pool.closeRuntime(ctx, rtrackerIdx, rtracker)
}
return
}
// We could not find the runtime ID (or the module was not in the map), which should never happen
panic("go-icu-regex pool found orphaned module")
}

// closeRuntime closes the given runtime, as well as removing it from the list of runtimes.
func (pool *Pool) closeRuntime(ctx context.Context, rtrackerIdx int, rtracker *RuntimeTracker) {
// First we'll close all the modules, then we'll close the runtime itself
for _, mod := range rtracker.modules {
_ = mod.Close(ctx)
}
_ = rtracker.r.Close(ctx)
// We then remove the runtime from the slice
newSlice := make([]*RuntimeTracker, len(pool.runtimes)-1)
copy(newSlice, pool.runtimes[:rtrackerIdx])
copy(newSlice, pool.runtimes[rtrackerIdx+1:])
pool.runtimes = newSlice
}

// createRuntime creates a new runtime, as well as compiling the ICU module. The compiled module is only valid with the
// runtime that compiled it.
func createRuntime(ctx context.Context) (wazero.Runtime, wazero.CompiledModule) {
r := wazero.NewRuntime(ctx)
wasi_snapshot_preview1.MustInstantiate(ctx, r)
envBuilder := r.NewHostModuleBuilder("env")
noop_two := func(int32, int32) int32 { return -1 }
noop_four := func(int32, int32, int32, int32) int32 { return -1 }
envBuilder.NewFunctionBuilder().WithFunc(noop_two).Export("__syscall_stat64")
envBuilder.NewFunctionBuilder().WithFunc(noop_two).Export("__syscall_lstat64")
envBuilder.NewFunctionBuilder().WithFunc(noop_two).Export("__syscall_fstat64")
envBuilder.NewFunctionBuilder().WithFunc(noop_four).Export("__syscall_newfstatat")
_, err := envBuilder.Instantiate(ctx)
if err != nil {
panic(err)
}
compiledIcuWasm, err := r.CompileModule(ctx, icuWasm)
if err != nil {
panic(err)
}
return r, compiledIcuWasm
}

// SetPoolFetchMax determines how many fetches are allowed from the internal Pool before a runtime is recycled.
func SetPoolFetchMax(maxFetch uint64) {
modulePool.mutex.Lock()
defer modulePool.mutex.Unlock()
modulePool.maxFetch = maxFetch
}
2 changes: 1 addition & 1 deletion regex.go
Original file line number Diff line number Diff line change
Expand Up @@ -108,7 +108,7 @@ const (
// to call Close. This Regex is intended for single-threaded use only, therefore it is advised for each thread to use
// its own Regex when one is needed.
func CreateRegex(stringBufferInBytes uint32) Regex {
mod := modulePool.Get().(api.Module)
mod := modulePool.Get()
pr := &privateRegex{
mod: mod,
regexPtr: 0,
Expand Down
Loading