Metadata-Version: 2.4
Name: wickra
Version: 0.1.1
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Financial and Insurance Industry
Classifier: License :: Free for non-commercial use
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Rust
Classifier: Topic :: Office/Business :: Financial :: Investment
Classifier: Topic :: Scientific/Engineering :: Mathematics
Requires-Dist: numpy>=1.22
Requires-Dist: pytest-benchmark>=4 ; extra == 'bench'
Requires-Dist: ta-lib ; platform_system != 'Windows' and extra == 'bench'
Requires-Dist: pandas-ta>=0.3.14b0 ; extra == 'bench'
Requires-Dist: talipp>=2 ; extra == 'bench'
Requires-Dist: finta>=1.3 ; extra == 'bench'
Requires-Dist: pandas>=2 ; extra == 'bench'
Requires-Dist: numpy>=1.22 ; extra == 'bench'
Requires-Dist: pytest>=7 ; extra == 'test'
Requires-Dist: numpy>=1.22 ; extra == 'test'
Requires-Dist: hypothesis>=6 ; extra == 'test'
Provides-Extra: bench
Provides-Extra: test
Summary: Streaming-first technical indicators: incremental, fast, install-free.
Keywords: finance,trading,indicators,technical-analysis,ta-lib
Home-Page: https://github.com/kingchenc/wickra
License: PolyForm-Noncommercial-1.0.0
Requires-Python: >=3.9
Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
Project-URL: Homepage, https://github.com/kingchenc/wickra
Project-URL: Issues, https://github.com/kingchenc/wickra/issues
Project-URL: Repository, https://github.com/kingchenc/wickra

# Wickra — Python bindings

Streaming-first technical indicators powered by a Rust core.

```bash
pip install wickra
```

## Quick start

```python
import numpy as np
import wickra as ta

# Batch — TA-Lib-style usage
prices = np.linspace(100, 200, 1000)
rsi = ta.RSI(14).batch(prices)            # NumPy array; NaN during warmup

# Streaming — feed ticks one at a time
rsi = ta.RSI(14)
for price in live_prices:
    v = rsi.update(price)                 # O(1) per tick
    if v is not None and v > 70:
        ...
```

## What's included

25 streaming-first indicators across four families. Every one passes a
`batch == streaming` equivalence test and reference-value tests:

- **Trend** — SMA, EMA, WMA, DEMA, TEMA, HMA, KAMA
- **Momentum** — RSI (Wilder), MACD, Stochastic, CCI, ROC, WilliamsR, ADX,
  MFI, TRIX, AwesomeOscillator, Aroon
- **Volatility** — BollingerBands, ATR, Keltner, Donchian, PSAR
- **Volume** — OBV, VWAP

## Why streaming-first matters

Classic TA libraries are batch-only: every live tick triggers a full
recomputation over the entire history. Wickra updates indicator state in
O(1) per tick. On a 5K-bar history the streaming RSI gap is ~17× over the
nearest peer with a streaming API and 100×+ over batch-only libraries.

## Full project

See <https://github.com/kingchenc/wickra> for benchmarks, the Rust core,
Node.js and WebAssembly bindings, examples, and CI.

## License

Licensed under the **PolyForm Noncommercial License 1.0.0**. Personal,
research, educational, and non-profit use are all permitted. Commercial
sale requires a separate license — contact via the GitHub repo.

