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.1

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.1
File	Size	Uploaded
wickra_screener-0.1.1.tar.gz	94.5 kB	Sep 4, 2026	Details

Built distributions (wheels)

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

Total release size: 6.6 MB

Release files / wickra_screener-0.1.1.tar.gz

Download URL	wickra_screener-0.1.1.tar.gz
Size	94.5 kB
Tags	Source
SHA-256 checksum How to use checksums	`e89bae12c78d3057545b31d676f706d151a0e43a16f9c85c865353ccf6675ce5`
BLAKE2b-256 checksum How to use checksums	`86957c89554b403bbff678519a9bec2e5ac2fd27b9b99d9690d335e7ef3c7bc9`
Upload date	Sep 4, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`maturin/1.15.0`

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

Download URL	wickra_screener-0.1.1-cp39-abi3-win_arm64.whl
Size	636.5 kB
Tags	CPython 3.9 Windows ARM64 abi3
SHA-256 checksum How to use checksums	`3e3d5689f85c727009b82dfb4b1975587d9acaef192f8ca061ae4bd5d986b7f2`
BLAKE2b-256 checksum How to use checksums	`58df5ed3fe1308a86a26ff3490dca1ae636f349b6699854dc29c4a0990142cd5`
Upload date	Sep 4, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`maturin/1.15.0`

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

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

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

Download URL	wickra_screener-0.1.1-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	`fca909c43befb4ee38df0d71512b60c2c2ac50e03ad21483ab39c722724757ba`
BLAKE2b-256 checksum How to use checksums	`6ff4128195bc1c665b1ff5cf08a836b226d1d60ac0745e248a5743f560f98e27`
Upload date	Sep 4, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`maturin/1.15.0`

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

Download URL	wickra_screener-0.1.1-cp39-abi3-musllinux_1_2_aarch64.whl
Size	947.1 kB
Tags	CPython 3.9 Linux musl 1.2+ ARM64 abi3
SHA-256 checksum How to use checksums	`def8c3eb34f6ba9a8479bd12b5472603c36053975828a8dab47f7eb604798425`
BLAKE2b-256 checksum How to use checksums	`4522c042db65418b3a3115847c503ee9fe194d507c92a1f58a71ccfc9829d7e9`
Upload date	Sep 4, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`maturin/1.15.0`

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

Download URL	wickra_screener-0.1.1-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	`41c6c5bb5b713d4690e5773d15af27e326ec9ee4954b450daeb7762bbd51dba5`
BLAKE2b-256 checksum How to use checksums	`02c5996af5f15386d40d94cf81d5db02d2e7814c7b411a69b06e090035d83f9f`
Upload date	Sep 4, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`maturin/1.15.0`

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

Download URL	wickra_screener-0.1.1-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	`0aceca28f39b2611fa7854a3ec93c3492d79817483ef7eb4a552b206b3f96683`
BLAKE2b-256 checksum How to use checksums	`80cf16a94fe63dd84fbe88017e2eaa5921d0265c2273592f094864ffac477887`
Upload date	Sep 4, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`maturin/1.15.0`

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

Download URL	wickra_screener-0.1.1-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	`6254613ce4b30dbd0f42851867c67fa96ea9a698188ba726e690bf022d7796fa`
BLAKE2b-256 checksum How to use checksums	`7795c6b44a08107fef67d9b08a72a3221f892858736466b9ff8b35c1e3e871f9`
Upload date	Sep 4, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`maturin/1.15.0`

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

Download URL	wickra_screener-0.1.1-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	`a653e850f48e1193899df1b183f3708fa097c99c05b292b60dd21cf735dd29a4`
BLAKE2b-256 checksum How to use checksums	`a911ec4a42efb383725d680cd2422e66a1815248ba168da561d5dd55bd589d06`
Upload date	Sep 4, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`maturin/1.15.0`