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

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

Built distributions (wheels)

Table of built distributions (wheels) for wickra-screener 0.1.2
File	Interpreter	ABI	Platform	Reset
wickra_screener-0.1.2-cp39-abi3-win_arm64.whl 636.5 kB Sep 4, 2026	CPython 3.9	abi3	Windows ARM64	Details
wickra_screener-0.1.2-cp39-abi3-win_amd64.whl 718.7 kB Sep 4, 2026	CPython 3.9	abi3	Windows x86-64	Details
wickra_screener-0.1.2-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.2-cp39-abi3-musllinux_1_2_aarch64.whl 947.2 kB Sep 4, 2026	CPython 3.9	abi3	Linux musl 1.2+ ARM64	Details
wickra_screener-0.1.2-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.2-cp39-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl 768.6 kB Sep 4, 2026	CPython 3.9	abi3	Linux glibc 2.17+ ARM64	Details
wickra_screener-0.1.2-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.2-cp39-abi3-macosx_10_12_x86_64.whl 804.2 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.2.tar.gz

Download URL	wickra_screener-0.1.2.tar.gz
Size	94.5 kB
Tags	Source
SHA-256 checksum How to use checksums	`c3359f508ada175541f44965030019d432b8a7a260cbeebd27940de0e68398d7`
BLAKE2b-256 checksum How to use checksums	`f1fccb3fe7abf92fed3d3198afddb18d0bb127e10007d8374d8e8ac56083a01c`
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.2-cp39-abi3-win_arm64.whl

Download URL	wickra_screener-0.1.2-cp39-abi3-win_arm64.whl
Size	636.5 kB
Tags	CPython 3.9 Windows ARM64 abi3
SHA-256 checksum How to use checksums	`1d7e3f2ac2f2b175eedc639e55045fab2b680d811827b51bf65da9eb4d1028ab`
BLAKE2b-256 checksum How to use checksums	`0643be598cda9277da777b312b9bd777caeaa1997f0cb5a388314da4fbd66429`
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.2-cp39-abi3-win_amd64.whl

Download URL	wickra_screener-0.1.2-cp39-abi3-win_amd64.whl
Size	718.7 kB
Tags	CPython 3.9 Windows x86-64 abi3
SHA-256 checksum How to use checksums	`1a2e7b58047a714284d53b2289032b7ae1906f8469cf64fce5c3a059c9149726`
BLAKE2b-256 checksum How to use checksums	`3ce0415af4d80b965fb455c066d47cf286913e1a640e61b646aa1d3027d9c60b`
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.2-cp39-abi3-musllinux_1_2_x86_64.whl

Download URL	wickra_screener-0.1.2-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	`5661f12121adf616a0a5de2e96f6fc9edca3098c6b87e3f326c1605872fc6300`
BLAKE2b-256 checksum How to use checksums	`ca5e5e1cfe7488a6528d0d2fc50ff99789380411a933fbab18255f73ff416409`
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.2-cp39-abi3-musllinux_1_2_aarch64.whl

Download URL	wickra_screener-0.1.2-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	`fe73a565c62a939025e82a77e85e4e35c9d3687385153e748b0bb22c9d488a73`
BLAKE2b-256 checksum How to use checksums	`f0586cc1338e59a3dcc3b6a1936ac6e83b97db422996badaedb0cccc940a8ad0`
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.2-cp39-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl

Download URL	wickra_screener-0.1.2-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	`e583ec1518dfdd84882974a8dffc05fea3c799d26dba0fcbbb41cbb14a1d0a61`
BLAKE2b-256 checksum How to use checksums	`f16d09107062585f9dbfae00eb2cbb06f6982b54787028bb77f931e22af49df6`
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.2-cp39-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl

Download URL	wickra_screener-0.1.2-cp39-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
Size	768.6 kB
Tags	CPython 3.9 Linux glibc 2.17+ ARM64 abi3
SHA-256 checksum How to use checksums	`26d596c5a3039dae191b549e07c790a6015c1afd6319c75e816fc251e389da6b`
BLAKE2b-256 checksum How to use checksums	`dbc00a3d1e686c6dfd917316f265fa852bffff452e07785b3ef72e87e7ff35b1`
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.2-cp39-abi3-macosx_11_0_arm64.whl

Download URL	wickra_screener-0.1.2-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	`d000118a616fd33fac6101f71df11522ce89271fb0430a3b580d616a678e6f1d`
BLAKE2b-256 checksum How to use checksums	`664ea68067ea58f4d72f9c5b07e2e250a464462e77d46d7e9dcbcb357f2c9425`
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.2-cp39-abi3-macosx_10_12_x86_64.whl

Download URL	wickra_screener-0.1.2-cp39-abi3-macosx_10_12_x86_64.whl
Size	804.2 kB
Tags	CPython 3.9 abi3 macOS 10.12+ x86-64
SHA-256 checksum How to use checksums	`6381c51ba1639c14c73087ce5a35a76e2a9e94bfb0549350271f32382418baf3`
BLAKE2b-256 checksum How to use checksums	`9d663c01fc7e5f40106f023a5da3ffcaea012787218a0a99b01bd522ea19620c`
Upload date	Sep 4, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`maturin/1.15.0`