Wickra Screener — Python

Python bindings for wickra-screener, the data-driven multi-symbol scan core. Build a Screener from a spec JSON, drive it with command JSONs, and read back scan reports — the same command protocol every language binding speaks.

Install

pip install wickra-screener

Usage

import json
from wickra_screener import Screener

spec = json.dumps({
    "universe": ["AAA", "BBB"],
    "condition": {
        "type": "cmp",
        "left": {"kind": "price", "field": "close"},
        "op": "gt",
        "right": {"kind": "const", "value": 10.0},
    },
})

screener = Screener(spec)

def candle(close):
    return {"time": 1, "open": close, "high": close,
            "low": close, "close": close, "volume": 1.0}

response = screener.command(json.dumps({
    "cmd": "scan",
    "data": {"AAA": [candle(5.0)], "BBB": [candle(15.0)]},
}))

report = json.loads(response)
print([m["symbol"] for m in report["matches"]])  # ['BBB']

API

Method	Description
`Screener(spec_json)`	Build a screener from a spec JSON (raises `ValueError` if invalid).
`screener.command(cmd_json) -> str`	Apply a command JSON, return the response JSON. Commands: `set_spec`, `feed`, `feed_batch`, `evaluate`, `scan`, `reset`, `version`.
`Screener.version() -> str`	The library version.

Build from source

maturin develop --release
pytest -q

License

MIT OR Apache-2.0.

Release files for wickra-screener 0.1.4

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for wickra-screener 0.1.4
File	Size	Uploaded
wickra_screener-0.1.4.tar.gz	94.5 kB	Sep 13, 2026	Details

Built distributions (wheels)

Table of built distributions (wheels) for wickra-screener 0.1.4
File	Interpreter	ABI	Platform	Reset
wickra_screener-0.1.4-cp39-abi3-win_arm64.whl 636.4 kB Sep 13, 2026	CPython 3.9	abi3	Windows ARM64	Details
wickra_screener-0.1.4-cp39-abi3-win_amd64.whl 718.6 kB Sep 13, 2026	CPython 3.9	abi3	Windows x86-64	Details
wickra_screener-0.1.4-cp39-abi3-musllinux_1_2_x86_64.whl 1.1 MB Sep 13, 2026	CPython 3.9	abi3	Linux musl 1.2+ x86-64	Details
wickra_screener-0.1.4-cp39-abi3-musllinux_1_2_aarch64.whl 947.2 kB Sep 13, 2026	CPython 3.9	abi3	Linux musl 1.2+ ARM64	Details
wickra_screener-0.1.4-cp39-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl 852.8 kB Sep 13, 2026	CPython 3.9	abi3	Linux glibc 2.17+ x86-64	Details
wickra_screener-0.1.4-cp39-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl 768.5 kB Sep 13, 2026	CPython 3.9	abi3	Linux glibc 2.17+ ARM64	Details
wickra_screener-0.1.4-cp39-abi3-macosx_11_0_arm64.whl 699.1 kB Sep 13, 2026	CPython 3.9	abi3	macOS 11.0+ ARM64	Details
wickra_screener-0.1.4-cp39-abi3-macosx_10_12_x86_64.whl 802.5 kB Sep 13, 2026	CPython 3.9	abi3	macOS 10.12+ x86-64	Details

Total release size: 6.6 MB

Release files / wickra_screener-0.1.4.tar.gz

Download URL	wickra_screener-0.1.4.tar.gz
Size	94.5 kB
Tags	Source
SHA-256 checksum How to use checksums	`2451d662a034ed54e0aef5ba709800e2afe13c5a5826791f867ee88785340990`
BLAKE2b-256 checksum How to use checksums	`793382175cc1e4cfbe418aed999c561e2e33385c320b097d2fd8a5ee9e8e1641`
Upload date	Sep 13, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`maturin/1.15.0`

Release files / wickra_screener-0.1.4-cp39-abi3-win_arm64.whl

Download URL	wickra_screener-0.1.4-cp39-abi3-win_arm64.whl
Size	636.4 kB
Tags	CPython 3.9 Windows ARM64 abi3
SHA-256 checksum How to use checksums	`851160015a586f094157fa870143f26d4e324393f6c13990b8268aac2e849d67`
BLAKE2b-256 checksum How to use checksums	`ca8af2f5468eb1a3fb88a4001d474d3b999e520042bf4840b8d9211ac5756c06`
Upload date	Sep 13, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`maturin/1.15.0`

Release files / wickra_screener-0.1.4-cp39-abi3-win_amd64.whl

Download URL	wickra_screener-0.1.4-cp39-abi3-win_amd64.whl
Size	718.6 kB
Tags	CPython 3.9 Windows x86-64 abi3
SHA-256 checksum How to use checksums	`2ccd8740078a57944b7892890869d4e022e3df5b28ed679c23eaba4516199121`
BLAKE2b-256 checksum How to use checksums	`2e4ccc8064dbfadcbf62571c602d0f44cb753d54159b05fba3569191617fa7c7`
Upload date	Sep 13, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`maturin/1.15.0`

Release files / wickra_screener-0.1.4-cp39-abi3-musllinux_1_2_x86_64.whl

Download URL	wickra_screener-0.1.4-cp39-abi3-musllinux_1_2_x86_64.whl
Size	1.1 MB
Tags	CPython 3.9 Linux musl 1.2+ x86-64 abi3
SHA-256 checksum How to use checksums	`9ada586b505f0da19f1c12a9742edaea9928cf8d082f98bf72e8bb7657ad3bc4`
BLAKE2b-256 checksum How to use checksums	`a83893bf57a81ef6b03c0adab2238ab90bd1ef050070ddf3d6b12ac7c3051b60`
Upload date	Sep 13, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`maturin/1.15.0`

Release files / wickra_screener-0.1.4-cp39-abi3-musllinux_1_2_aarch64.whl

Download URL	wickra_screener-0.1.4-cp39-abi3-musllinux_1_2_aarch64.whl
Size	947.2 kB
Tags	CPython 3.9 Linux musl 1.2+ ARM64 abi3
SHA-256 checksum How to use checksums	`990bd477743738671f97427546bd827ddfdab4923b13fb497ea4710acc6e8d8e`
BLAKE2b-256 checksum How to use checksums	`0ec0e616b6fad9f00066e2fd34062644813290b4eee47e767a51f0b8d65ebd29`
Upload date	Sep 13, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`maturin/1.15.0`

Release files / wickra_screener-0.1.4-cp39-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl

Download URL	wickra_screener-0.1.4-cp39-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Size	852.8 kB
Tags	CPython 3.9 Linux glibc 2.17+ x86-64 abi3
SHA-256 checksum How to use checksums	`979f2ae15cb17b03d3c220902e45626187f3b0ba9903f4b6c1711c0b7c6857bc`
BLAKE2b-256 checksum How to use checksums	`f734cad7badf89f6c361f749dc0b1b3f70e1519e4c72084255cc348018aac998`
Upload date	Sep 13, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`maturin/1.15.0`

Release files / wickra_screener-0.1.4-cp39-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl

Download URL	wickra_screener-0.1.4-cp39-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
Size	768.5 kB
Tags	CPython 3.9 Linux glibc 2.17+ ARM64 abi3
SHA-256 checksum How to use checksums	`04c623165620f499ed3fb6029a760f71a496a7f5e1e6730911288cb7763be639`
BLAKE2b-256 checksum How to use checksums	`0a887c3014aef66c9fd6b57632e4ee5bf0c924f7ef1a10c2d4b7b88d64ff8b73`
Upload date	Sep 13, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`maturin/1.15.0`

Release files / wickra_screener-0.1.4-cp39-abi3-macosx_11_0_arm64.whl

Download URL	wickra_screener-0.1.4-cp39-abi3-macosx_11_0_arm64.whl
Size	699.1 kB
Tags	CPython 3.9 abi3 macOS 11.0+ ARM64
SHA-256 checksum How to use checksums	`4870515cba599605fcb87bd512646a683e79ca0fab64394e4764ad83ffd92eca`
BLAKE2b-256 checksum How to use checksums	`2c7ee2825853a8fc6aaf84827331ff0884cc2492e193f3e0ab0eb6f5d642b68a`
Upload date	Sep 13, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`maturin/1.15.0`

Release files / wickra_screener-0.1.4-cp39-abi3-macosx_10_12_x86_64.whl

Download URL	wickra_screener-0.1.4-cp39-abi3-macosx_10_12_x86_64.whl
Size	802.5 kB
Tags	CPython 3.9 abi3 macOS 10.12+ x86-64
SHA-256 checksum How to use checksums	`3956f4fac23412a259498b7139c97facb4eb0a5ecea0b31a666708ba8cea3a46`
BLAKE2b-256 checksum How to use checksums	`1178f0f131257527e412c2f10b08075aceb722bf09d18a2d89d5ee051b1a49f9`
Upload date	Sep 13, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`maturin/1.15.0`