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

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

Built distributions (wheels)

Table of built distributions (wheels) for wickra-screener 0.1.3
File	Interpreter	ABI	Platform	Reset
wickra_screener-0.1.3-cp39-abi3-win_arm64.whl 636.5 kB Sep 4, 2026	CPython 3.9	abi3	Windows ARM64	Details
wickra_screener-0.1.3-cp39-abi3-win_amd64.whl 718.6 kB Sep 4, 2026	CPython 3.9	abi3	Windows x86-64	Details
wickra_screener-0.1.3-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.3-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.3-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.3-cp39-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl 768.8 kB Sep 4, 2026	CPython 3.9	abi3	Linux glibc 2.17+ ARM64	Details
wickra_screener-0.1.3-cp39-abi3-macosx_11_0_arm64.whl 700.3 kB Sep 4, 2026	CPython 3.9	abi3	macOS 11.0+ ARM64	Details
wickra_screener-0.1.3-cp39-abi3-macosx_10_12_x86_64.whl 802.4 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.3.tar.gz

Download URL	wickra_screener-0.1.3.tar.gz
Size	94.6 kB
Tags	Source
SHA-256 checksum How to use checksums	`2b1bdcaa82bad36764849ce8695051daff23b9461cc0edc4fd3887b1e4303b99`
BLAKE2b-256 checksum How to use checksums	`3f459af01cfd956f8394f5c37356333c08f36ff116e21419db47a62a7b2e9802`
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.3-cp39-abi3-win_arm64.whl

Download URL	wickra_screener-0.1.3-cp39-abi3-win_arm64.whl
Size	636.5 kB
Tags	CPython 3.9 Windows ARM64 abi3
SHA-256 checksum How to use checksums	`f511e4bb23555cb4ef4b74bbcb9d878eb842bfac6f4c82ad2a11fc3a41da53c5`
BLAKE2b-256 checksum How to use checksums	`ce3dd738caefb39b9fce7b0e99665145c2ce28d10198b0b332396a93369763d9`
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.3-cp39-abi3-win_amd64.whl

Download URL	wickra_screener-0.1.3-cp39-abi3-win_amd64.whl
Size	718.6 kB
Tags	CPython 3.9 Windows x86-64 abi3
SHA-256 checksum How to use checksums	`4e9852814a0a6df960b337cd42cdb5d03c1fec51448450d261a53257fdc32d77`
BLAKE2b-256 checksum How to use checksums	`d01bfa870dd47891b5a092bf9a6a9bcad76a967b62c901f86b721f3490a8ec52`
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.3-cp39-abi3-musllinux_1_2_x86_64.whl

Download URL	wickra_screener-0.1.3-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	`a756240b259a88b9cb275a933e7f94270149b96b5053a8dd19b9eb9a4d60cc60`
BLAKE2b-256 checksum How to use checksums	`c77e1c961fa9ddfab44db653f882fbde981c6d0f7068e60e1fe356776edbd92c`
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.3-cp39-abi3-musllinux_1_2_aarch64.whl

Download URL	wickra_screener-0.1.3-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	`8879a0334d739d451577968ab487b154e02a8e300ff657256570be0484955e3e`
BLAKE2b-256 checksum How to use checksums	`766d95d9fd038d1b3ae034ef9501183bc3a6dcee9659aa4a39f6520a9c76c947`
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.3-cp39-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl

Download URL	wickra_screener-0.1.3-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	`7b0204c5e0955e4c022fb05530bac250ea6f0aa07b9331b5beba5b9452e51d41`
BLAKE2b-256 checksum How to use checksums	`e2822af7abce9f1a14a45cef8cd6ffb53023ca9ac250bef79e976b642e04aa0d`
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.3-cp39-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl

Download URL	wickra_screener-0.1.3-cp39-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
Size	768.8 kB
Tags	CPython 3.9 Linux glibc 2.17+ ARM64 abi3
SHA-256 checksum How to use checksums	`c7ae24b7208d11fd2788c93b76c5d3e647099bdb1dc2f8c6c91b5f6ec73ce981`
BLAKE2b-256 checksum How to use checksums	`eaca0d3db4abc23e8c4bcc165a70ac16286f7b1b2b56517b230e48efb82b69a4`
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.3-cp39-abi3-macosx_11_0_arm64.whl

Download URL	wickra_screener-0.1.3-cp39-abi3-macosx_11_0_arm64.whl
Size	700.3 kB
Tags	CPython 3.9 abi3 macOS 11.0+ ARM64
SHA-256 checksum How to use checksums	`c02edc02b8c532501414347a3596c86950e58da0937704176888b7ac3ffb40c7`
BLAKE2b-256 checksum How to use checksums	`013fefc8377d9043aa0b9a899d5de47abbf3e326863c6ad7e018ffee0c114fac`
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.3-cp39-abi3-macosx_10_12_x86_64.whl

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