Files
kingchenc 23d636fd97 Add the Go binding over the C ABI hub (#228)
Adds a Go binding (`bindings/go`) over the C ABI hub — the second language stecker after C#.

## What's here
- **`bindings/go`** — a cgo binding exposing all 514 indicators as idiomatic Go types with `New<Indicator>` constructors and `Update`/`Batch`/`Reset`/`Close` methods. The wrappers in `indicators_gen.go` are generated from `bindings/c/include/wickra.h` (same archetype taxonomy as the C# generator: scalar/batch, multi-output, bars, profile, profile-values, array-input). Opaque handles are freed by `Close()` with a `runtime.SetFinalizer` backstop; pointer arguments are caller-owned, panics never cross the boundary.
- **`examples/go`** — the full example suite mirroring C/C#: streaming, backtest, multi_timeframe, parallel_assets (goroutine fan-out), three strategies, and `fetch_btcusdt`/`live_binance`.
- **CI** — a `go` job builds the C ABI library, stages it, and runs `gofmt`/`go vet`/`go test` plus the offline examples on Linux, macOS and Windows.
- **Docs** — Go added to the README languages table, project layout, building/testing, CONTRIBUTING binding table + regenerate note, ARCHITECTURE, examples index, issue/PR templates, the About-description template, and the other binding READMEs.

## Linking / distribution
The binding links the prebuilt C ABI library via cgo (`libwickra.so`/`.dylib`/`wickra.dll` staged under `bindings/go/lib`, gitignored). The native libraries are already shipped per target triple by the existing `c-abi-build` release job; distribution is via the subdirectory module tag `bindings/go/vX.Y.Z` (gated), so `release.yml` needs no new publish job.

No Rust crate or `Cargo.toml` change — the Go module is standalone and additive.

Not for merge yet (gated, per request).
2026-06-09 17:33:37 +02:00

41 lines
1.1 KiB
Go

// Feed a synthetic price series through several indicators tick by tick (O(1) each).
package main
import (
"fmt"
wickra "github.com/wickra-lib/wickra/bindings/go"
"github.com/wickra-lib/wickra/examples/go/internal/market"
)
func main() {
prices := market.SyntheticPrices(500)
sma, _ := wickra.NewSma(20)
defer sma.Close()
ema, _ := wickra.NewEma(20)
defer ema.Close()
rsi, _ := wickra.NewRsi(14)
defer rsi.Close()
macd, _ := wickra.NewMacdIndicator(12, 26, 9)
defer macd.Close()
var lastSma, lastEma, lastRsi float64
var lastMacd wickra.MacdOutput
var haveMacd bool
for _, price := range prices {
lastSma = sma.Update(price)
lastEma = ema.Update(price)
lastRsi = rsi.Update(price)
lastMacd, haveMacd = macd.Update(price)
}
fmt.Printf("Streamed %d prices through SMA(20), EMA(20), RSI(14), MACD(12,26,9):\n", len(prices))
fmt.Printf(" SMA = %.4f\n", lastSma)
fmt.Printf(" EMA = %.4f\n", lastEma)
fmt.Printf(" RSI = %.4f\n", lastRsi)
if haveMacd {
fmt.Printf(" MACD = %.4f signal=%.4f hist=%.4f\n", lastMacd.Macd, lastMacd.Signal, lastMacd.Histogram)
}
}