kingchencandGitHub
23d636fd97
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).
26 lines
1.0 KiB
Go
26 lines
1.0 KiB
Go
// Package wickra provides idiomatic Go bindings for the Wickra
|
|
// technical-analysis library over its C ABI hub.
|
|
//
|
|
// Each indicator is an opaque-handle type with a New<Indicator> constructor and
|
|
// Update/Batch/Reset/Close methods. Handles are freed by Close and, as a
|
|
// backstop, by a finalizer; call Close explicitly to release native memory
|
|
// promptly. The binding links against the prebuilt Wickra C ABI library
|
|
// (libwickra.so/.dylib or wickra.dll) staged under ./lib — see the package
|
|
// README for how to provision it.
|
|
package wickra
|
|
|
|
/*
|
|
#cgo CFLAGS: -I${SRCDIR}/../c/include
|
|
#cgo linux LDFLAGS: -L${SRCDIR}/lib -lwickra -Wl,-rpath,${SRCDIR}/lib
|
|
#cgo darwin LDFLAGS: -L${SRCDIR}/lib -lwickra -Wl,-rpath,${SRCDIR}/lib
|
|
#cgo windows LDFLAGS: -L${SRCDIR}/lib -l:wickra.dll
|
|
#include "wickra.h"
|
|
*/
|
|
import "C"
|
|
|
|
import "errors"
|
|
|
|
// ErrInvalidParams is returned by a New<Indicator> constructor when the native
|
|
// constructor rejects the supplied parameters (for example a zero period).
|
|
var ErrInvalidParams = errors.New("wickra: invalid indicator parameters")
|