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

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.0
File	Size	Uploaded
wickra_screener-0.1.0.tar.gz	94.6 kB	Sep 4, 2026	Details

Built distributions (wheels)

Table of built distributions (wheels) for wickra-screener 0.1.0
File	Interpreter	ABI	Platform	Reset
wickra_screener-0.1.0-cp39-abi3-win_arm64.whl 637.6 kB Sep 4, 2026	CPython 3.9	abi3	Windows ARM64	Details
wickra_screener-0.1.0-cp39-abi3-win_amd64.whl 718.9 kB Sep 4, 2026	CPython 3.9	abi3	Windows x86-64	Details
wickra_screener-0.1.0-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.0-cp39-abi3-musllinux_1_2_aarch64.whl 947.4 kB Sep 4, 2026	CPython 3.9	abi3	Linux musl 1.2+ ARM64	Details
wickra_screener-0.1.0-cp39-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl 853.3 kB Sep 4, 2026	CPython 3.9	abi3	Linux glibc 2.17+ x86-64	Details
wickra_screener-0.1.0-cp39-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl 768.2 kB Sep 4, 2026	CPython 3.9	abi3	Linux glibc 2.17+ ARM64	Details
wickra_screener-0.1.0-cp39-abi3-macosx_11_0_arm64.whl 700.4 kB Sep 4, 2026	CPython 3.9	abi3	macOS 11.0+ ARM64	Details
wickra_screener-0.1.0-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.0.tar.gz

Download URL	wickra_screener-0.1.0.tar.gz
Size	94.6 kB
Tags	Source
SHA-256 checksum How to use checksums	`d7654e2f50b61226fa05c563d174361ce0877b41f68edd036ceea1a548d28699`
BLAKE2b-256 checksum How to use checksums	`9b8621a507c07411ec189464ffdcd08069caff36f6a9824123c843b3bd17ad33`
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.0-cp39-abi3-win_arm64.whl

Download URL	wickra_screener-0.1.0-cp39-abi3-win_arm64.whl
Size	637.6 kB
Tags	CPython 3.9 Windows ARM64 abi3
SHA-256 checksum How to use checksums	`1f1ab6dbf20559362d207bdcd37c8729f7ddfb73d880d371198d48d2afa5b85f`
BLAKE2b-256 checksum How to use checksums	`533328621bb6ff52907212b0d76af4749d85b609890c6925462a90c98f054d56`
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.0-cp39-abi3-win_amd64.whl

Download URL	wickra_screener-0.1.0-cp39-abi3-win_amd64.whl
Size	718.9 kB
Tags	CPython 3.9 Windows x86-64 abi3
SHA-256 checksum How to use checksums	`d2df2513076651681b35bd5159b398f690153c982474296def3767322cb17fcd`
BLAKE2b-256 checksum How to use checksums	`b8ec7d5c5b37be8eb368ea7ad6f68edc17f268fcffa75c1470ea0f80e70204bb`
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.0-cp39-abi3-musllinux_1_2_x86_64.whl

Download URL	wickra_screener-0.1.0-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	`25b29dac3b09ef722a7b4601d09e22ea8898b747f5e93287a88c04f4ccab7091`
BLAKE2b-256 checksum How to use checksums	`013f7d772c4b765dfa68dc06a5286ddc045a8a0cb20301d42a9371918187f2f2`
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.0-cp39-abi3-musllinux_1_2_aarch64.whl

Download URL	wickra_screener-0.1.0-cp39-abi3-musllinux_1_2_aarch64.whl
Size	947.4 kB
Tags	CPython 3.9 Linux musl 1.2+ ARM64 abi3
SHA-256 checksum How to use checksums	`b9ac69db2f430fd23de2ed7d88496705175e3506e27440c341b8920707681530`
BLAKE2b-256 checksum How to use checksums	`a532cd544c43b005be7dee24b8c6e20f3e271246f7415590cb6020d3c21a59b9`
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.0-cp39-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl

Download URL	wickra_screener-0.1.0-cp39-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Size	853.3 kB
Tags	CPython 3.9 Linux glibc 2.17+ x86-64 abi3
SHA-256 checksum How to use checksums	`359907c1e62372c2104caa32150d266499a298b9ea8cda23dedddeb4613cab71`
BLAKE2b-256 checksum How to use checksums	`b64b8e69efd4f6e8fde3ab884a78563eb4af02f5680b91322c60abbb82d5d2c8`
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.0-cp39-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl

Download URL	wickra_screener-0.1.0-cp39-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
Size	768.2 kB
Tags	CPython 3.9 Linux glibc 2.17+ ARM64 abi3
SHA-256 checksum How to use checksums	`fae4435ae44a985b1005f2adaad17c0ab4e9da29a09b0028f4aec0bfaa7cc5ae`
BLAKE2b-256 checksum How to use checksums	`656d7e74cc31f13389bf36e8fdc3a8f0f3b5a048835f769f7cbf036de39d9421`
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.0-cp39-abi3-macosx_11_0_arm64.whl

Download URL	wickra_screener-0.1.0-cp39-abi3-macosx_11_0_arm64.whl
Size	700.4 kB
Tags	CPython 3.9 abi3 macOS 11.0+ ARM64
SHA-256 checksum How to use checksums	`cc7677d689d2b3f27f482929668f972465cfa02f9b14b2f156e3ac55a91a3049`
BLAKE2b-256 checksum How to use checksums	`2594a7bdbbfa796d5eac3efccdd83b25cb1130d7adacf7aeb368494eb222ed73`
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.0-cp39-abi3-macosx_10_12_x86_64.whl

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