wickra

498 Commits 1 Branch 71 Tags

3 Commits

Include renames

Author	SHA1	Message	Date
kingchencandGitHub	3a709d9a66	feat(data): native live Binance kline feed in 9 languages (+ 3d/1M intervals) (#313 ) * feat(data): C-ABI Binance feed + Go binding (F4 wip) C ABI exposes the existing async BinanceKlineStream (tokio + TLS, auto-reconnect, mock-server-tested in wickra-data) through a blocking poll: wickra_binance_connect / _next(out, timeout_ms) -> {1 event, 0 timeout, -1 closed} / _close / _free over an opaque BinanceStream that owns a current-thread runtime. WickraKlineEvent carries OHLCV + open_time + is_closed + a 16-byte symbol buffer. `live-binance` is now a default feature of wickra-c (the published DLL ships the feed; the wasm build drops it via --no-default-features). Go: NewBinanceFeed(symbols, interval, baseURL) + Next(timeout) + Close, with a deterministic error-path smoke (the connect->event pipeline is covered by the Rust mock-WS-server tests). * feat(data): Binance feed C# + Java bindings (F4 wip) C#: BinanceFeed(symbols, interval, baseUrl?) + Next(timeout) -> KlineEvent? + Dispose; bespoke WickraKlineEvent native struct (fixed symbol buffer + byte is_closed) since the scalar struct parser can't model it. `char` maps to `byte` for the const char* params. Java: BinanceFeed + KlineEvent record + BinanceInterval enum over Panama FFM; the event is read at hand-computed offsets (symbol@0, doubles@16..48, open_time@56, is_closed@64; 72-byte struct). Both with deterministic error-path smokes (pipeline covered by the Rust mock-WS-server tests). * feat(data): Binance feed R binding (F4 wip) R: BinanceFeed(symbols, interval, base_url) + binance_next(feed, timeout_ms) -> named list \| NULL + binance_close, via bespoke .Call glue (wk_binance_). The glue + its registration entries are gated out of the Emscripten/wasm build (#ifndef __EMSCRIPTEN__) since r-universe/webR has no raw sockets. NAMESPACE exports added by hand (roxygen2 not installed locally). Deterministic error-path smoke; pipeline covered by the Rust mock-WS-server tests. feat(data): native Binance feed for Node + Python; CHANGELOG (F4 complete) Node (napi) BinanceFeed: new(symbols, interval, baseUrl?) + next(timeoutMs) -> KlineEvent \| null + close. Python (pyo3) BinanceFeed: same, with next releasing the GIL (py.detach) while it waits. Both drive the mock-server-tested async BinanceKlineStream on a single-thread tokio runtime (blocking poll); wickra-data gains the live-binance feature + tokio in each binding. Completes F4: the live Binance kline feed is now native in all 9 languages (WASM excluded), with no third-party WebSocket client in any of them.	2026-06-16 02:01:37 +02:00
kingchencandGitHub	b06ce2678a	Restructure the Go binding for self-contained distribution (#236 ) ## Problem Plain `go get` + `go build` of the Go binding never worked as a dependency: - cgo `CFLAGS` pointed at `${SRCDIR}/../c/include` — the parent dir is outside the Go module, so a proxy-fetched module has no header. - the library under `./lib` was git-ignored and never shipped; the README told users to `cargo build` it from the workspace, which only works inside a clone, not from the read-only module cache. cgo has no build hook and Go has no registry, so the only way a consumer's `go get`+build can find the lib is for it to be committed inside the module the consumer pulls. Per the design decision, that module is a separate `wickra-go` repo (keeps this repo free of committed binaries), populated by the release pipeline — this PR is the in-repo restructure that makes that possible. ## Changes - Vendor the header at `bindings/go/include/wickra.h` (committed copy of `bindings/c/include/wickra.h`); `CFLAGS` → `-I${SRCDIR}/include`. A CI drift check fails if the copy goes stale. - Per-platform libraries: cgo `LDFLAGS` become per `GOOS`/`GOARCH`, linking `${SRCDIR}/lib/<goos>_<goarch>/`. - CI stages the host library into `lib/<goos>_<goarch>/` (`RUNNER_OS`/`RUNNER_ARCH` — note `macos-latest` is arm64) and exports `WICKRA_GO_LIBDIR` for the Windows PATH; libraries stay git-ignored here. - README: install via the `wickra-go` module + a contributor build section. ## Validation - Local windows/amd64: `gofmt` clean, `go vet`, `go build`, `go test` all green against the staged library + vendored header. - Linux/macOS arches → the 3-OS `Go on …` CI job. Follow-up (Stage 2, separate): create `wickra-lib/wickra-go` + a `release.yml` mirror job (source + 6 platform libs → `lib/<goos>_<goarch>/`, commit + tag), and point the docs at the new import path. Part of the self-contained gap (`todo-11`).	2026-06-09 23:06:16 +02:00
kingchencandGitHub	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

Author

SHA1

Message

Date

kingchencandGitHub

3a709d9a66

feat(data): native live Binance kline feed in 9 languages (+ 3d/1M intervals) (#313 )

* feat(data): C-ABI Binance feed + Go binding (F4 wip)

C ABI exposes the existing async BinanceKlineStream (tokio + TLS, auto-reconnect,
mock-server-tested in wickra-data) through a blocking poll: wickra_binance_connect
/ _next(out, timeout_ms) -> {1 event, 0 timeout, -1 closed} / _close / _free over
an opaque BinanceStream that owns a current-thread runtime. WickraKlineEvent
carries OHLCV + open_time + is_closed + a 16-byte symbol buffer. `live-binance`
is now a default feature of wickra-c (the published DLL ships the feed; the wasm
build drops it via --no-default-features).

Go: NewBinanceFeed(symbols, interval, baseURL) + Next(timeout) + Close, with a
deterministic error-path smoke (the connect->event pipeline is covered by the
Rust mock-WS-server tests).

* feat(data): Binance feed C# + Java bindings (F4 wip)

C#: BinanceFeed(symbols, interval, baseUrl?) + Next(timeout) -> KlineEvent? +
Dispose; bespoke WickraKlineEvent native struct (fixed symbol buffer + byte
is_closed) since the scalar struct parser can't model it. `char` maps to `byte`
for the const char* params.

Java: BinanceFeed + KlineEvent record + BinanceInterval enum over Panama FFM;
the event is read at hand-computed offsets (symbol@0, doubles@16..48,
open_time@56, is_closed@64; 72-byte struct). Both with deterministic error-path
smokes (pipeline covered by the Rust mock-WS-server tests).

* feat(data): Binance feed R binding (F4 wip)

R: BinanceFeed(symbols, interval, base_url) + binance_next(feed, timeout_ms) ->
named list | NULL + binance_close, via bespoke .Call glue (wk_binance_*). The
glue + its registration entries are gated out of the Emscripten/wasm build
(#ifndef __EMSCRIPTEN__) since r-universe/webR has no raw sockets. NAMESPACE
exports added by hand (roxygen2 not installed locally). Deterministic error-path
smoke; pipeline covered by the Rust mock-WS-server tests.

* feat(data): native Binance feed for Node + Python; CHANGELOG (F4 complete)

Node (napi) BinanceFeed: new(symbols, interval, baseUrl?) + next(timeoutMs) ->
KlineEvent | null + close. Python (pyo3) BinanceFeed: same, with next releasing
the GIL (py.detach) while it waits. Both drive the mock-server-tested async
BinanceKlineStream on a single-thread tokio runtime (blocking poll); wickra-data
gains the live-binance feature + tokio in each binding.

Completes F4: the live Binance kline feed is now native in all 9 languages
(WASM excluded), with no third-party WebSocket client in any of them.

2026-06-16 02:01:37 +02:00

kingchencandGitHub

b06ce2678a

Restructure the Go binding for self-contained distribution (#236 )

## Problem
Plain `go get` + `go build` of the Go binding never worked **as a dependency**:
- cgo `CFLAGS` pointed at `${SRCDIR}/../c/include` — the parent dir is **outside** the Go module, so a proxy-fetched module has no header.
- the library under `./lib` was git-ignored and never shipped; the README told users to `cargo build` it from the workspace, which only works inside a clone, not from the read-only module cache.

cgo has no build hook and Go has no registry, so the only way a consumer's `go get`+build can find the lib is for it to be committed **inside the module the consumer pulls**. Per the design decision, that module is a separate **`wickra-go`** repo (keeps this repo free of committed binaries), populated by the release pipeline — this PR is the in-repo restructure that makes that possible.

## Changes
- **Vendor the header** at `bindings/go/include/wickra.h` (committed copy of `bindings/c/include/wickra.h`); `CFLAGS` → `-I${SRCDIR}/include`. A **CI drift check** fails if the copy goes stale.
- **Per-platform libraries**: cgo `LDFLAGS` become per `GOOS`/`GOARCH`, linking `${SRCDIR}/lib/<goos>_<goarch>/`.
- **CI** stages the host library into `lib/<goos>_<goarch>/` (`RUNNER_OS`/`RUNNER_ARCH` — note `macos-latest` is arm64) and exports `WICKRA_GO_LIBDIR` for the Windows PATH; libraries stay git-ignored here.
- **README**: install via the `wickra-go` module + a contributor build section.

## Validation
- Local **windows/amd64**: `gofmt` clean, `go vet`, `go build`, `go test` all green against the staged library + vendored header.
- Linux/macOS arches → the 3-OS `Go on …` CI job.

Follow-up (Stage 2, separate): create `wickra-lib/wickra-go` + a `release.yml` mirror job (source + 6 platform libs → `lib/<goos>_<goarch>/`, commit + tag), and point the docs at the new import path. Part of the self-contained gap (`todo-11`).

2026-06-09 23:06:16 +02:00

kingchencandGitHub

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