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

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.5
File	Size	Uploaded
wickra_screener-0.1.5.tar.gz	99.0 kB	Sep 15, 2026	Details

Built distributions (wheels)

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

Total release size: 6.6 MB

Release files / wickra_screener-0.1.5.tar.gz

Download URL	wickra_screener-0.1.5.tar.gz
Size	99.0 kB
Tags	Source
SHA-256 checksum How to use checksums	`a43b0ce1f8a4899a406f60fb9fef93dfe40ed1de309d4d0d1fd415d3c13741f3`
BLAKE2b-256 checksum How to use checksums	`0a3df19e866842f0a51a941c182f7f84ffbcb4d20dfa08e96daa027994283f0c`
Upload date	Sep 15, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`maturin/1.15.0`

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

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

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

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

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

Download URL	wickra_screener-0.1.5-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	`69ef2bf6641d794c26d3815ba9855967371cc4209c3373c67fb7330a2e8c92f4`
BLAKE2b-256 checksum How to use checksums	`888c6cf09ca3e5ae7e3be6fe90a42a0184397ba01fca3cfb72a033b55c0514a5`
Upload date	Sep 15, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`maturin/1.15.0`

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

Download URL	wickra_screener-0.1.5-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	`51b6e261c82d572e15b98506fab4fea7fb22ba1d06ed9b5a1afe5e8244dc1e3b`
BLAKE2b-256 checksum How to use checksums	`94b847b1353862be4fa619c2a50996ca9e70e4dac39fc98479932cdbf30ff090`
Upload date	Sep 15, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`maturin/1.15.0`

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

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

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

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

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

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

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

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