Crate stryke 

Crate root — see README.md for overview.

Re-exports

pub use vm_helper::perl_bracket_version;

pub use vm_helper::FEAT_SAY;

pub use vm_helper::FEAT_STATE;

pub use vm_helper::FEAT_SWITCH;

pub use vm_helper::FEAT_UNICODE_STRINGS;

Modules

agent

stryke agent — Persistent load testing agent for distributed stress testing.

ai

AI primitives — Phase 0 (“walking skeleton”) of the design in docs/AI_PRIMITIVES.md.

ai_sugar

Source-level desugar for tool fn and mcp_server syntax.

aop

Aspect-oriented programming primitives for stryke.

aot

Ahead-of-time build: bake a Perl script into a copy of the running stryke binary as a compressed trailer, producing a self-contained executable.

ast

AST node types for the Perl 5 interpreter. Every node carries a line field for error reporting.

banner

Stryke ASCII logo + live-stats box banner. Single source of truth shared by:

builtins

Builtins dispatched from FuncCall (names not modeled as dedicated ExprKinds). I/O uses Interpreter::io_file_slots for raw read/write/seek alongside buffered handles.

builtins_bio_geom_markov

Bioinformatics, 3D geometry, sequence alignment, file format header parsers, resampling, Markov chains.

builtins_bits_music_stats

Bit manipulation, music theory, hash functions, text utilities, statistical tests. Pure deterministic functions.

builtins_combin_audio_physics

Combinatorics, audio synthesis, search algorithms, physics 2D, noise generators, RNG variants, polygonal numbers.

builtins_const

Constants & distribution helpers. HTTP status codes return their numeric value. HTTP method names return their canonical uppercase form. Distribution PDF/quantile/ sampler functions use the statrs crate.

builtins_data

HTML / JSON / XML / CSS primitives. Uses serde_json and scraper (both already deps). XML/CSS ops that don’t have a clean crate-backed implementation use lightweight regex/string parsing — pragmatic, not RFC-perfect.

builtins_games_ml_chem

Game theory, ML inference primitives, operations research, chemistry, language modeling, information-theoretic divergences.

builtins_geom

Geometric primitives, complex numbers, color-space extras, and trig extras. Pure functions, no external crates.

builtins_iter

Iterator combinator + string-distance extras. Pure functions, no external crates.

builtins_linalg_graph_date

Linear algebra (matrices), graph algorithms, calendar/date helpers, special math. Pure functions only.

builtins_mathx

Math / number theory / random extras.

builtins_misc

Miscellaneous primitives: BigInt ops + game/physics vectors + probabilistic data structures + audio synthesis basics + geo extras. Pure functions where possible; BigInt uses num-bigint.

builtins_misc2

Currency / ML / file-path / locale / channels. Pure functions where possible. Channels honor capacity, oneshot auto-close, and subscriber cursors; timeout args are accepted but no-op in the single-thread VM.

builtins_net

Network / IP / CIDR / MAC primitives — Phase 1 of the 10k-builtin push.

builtins_phonetic_geo_codec

Phonetic algorithms, geo projections, base58/base91, astronomy, CRC variants, color blending, compression primitives.

builtins_quant

Quantitative builtins: technical indicators, time-series ops, finance, optimization, numerical methods. Pure functions; deliberately compact implementations.

builtins_ratings_geom_units

Ratings/tournaments, image morphology, computational geometry 2D, crypto primitives, physics constants, case conversions, photography, unit conversions.

builtins_validate

Validation / input-check primitives.

builtins_vision_ir_algorithms

Computer vision / image kernels, information retrieval, distance metrics, Bayesian updates, RL primitives, color spaces, window functions, trie / Fenwick / union-find, network extras.

bytecode

capture

Structured shell output: capture("cmd").

cli_runners

Shared runners for stryke check and stryke test.

cluster

Persistent SSH worker pool dispatcher for pmap_on.

compiler

controller

stryke controller — Interactive REPL for coordinating stress test agents.

convert

Convert standard Perl source to idiomatic stryke syntax.

dap

Debug Adapter Protocol (DAP) server for stryke.

data_section

Split __DATA__ from program source (line must equal __DATA__ after trim).

debugger

Interactive debugger for stryke programs.

deconvert

Deconvert stryke .stk syntax back to standard Perl .pl syntax.

deparse

AST-to-source deparser for serializing code refs.

doc_render

Render raw hover-doc markdown (from lsp::doc_text_for) into a terminal display string. Same visual surface as the stryke docs interactive browser — bold topic heading, dim rule, cyan inline backticks, green code fences — but without the pager chrome (header/footer banner, page navigation hints), so a single doc page can be returned by the docs(TOPIC) builtin and printed inline at the REPL.

english

English.pm-style scalar aliases (use English).

error

fmt

Pretty-print parsed Perl back to source (stryke --fmt). Regenerate with python3 tools/gen_fmt.py after ast.rs changes.

format

Perl format / write — picture lines and field padding (subset of Perl 5 perlform).

getopts

getopts — Getopt::Long-style CLI flag parser.

kvstore

rkyv-backed KV store — first-class CRUD store in any scripting language.

lexer

list_builtins

Stryke list builtins — native Rust implementations of sum, min, max, uniq, reduce, zip, the pairs family, and friends. Every fn here is a bare-name builtin reachable via [dispatch_by_name]; there is no Perl module emulation layer.

lsp

Language server protocol (stdio) for editors — stryke --lsp.

lsp_docs_domains

Hand-written LSP hover descriptions for stryke builtins grouped by domain. Returned via doc_for_label_text fallback — every entry here is concise, signature-typed, and ships a runnable example.

lsp_extras

Additional LSP capabilities for stryke --lsp:

mcp

MCP client (Model Context Protocol) — Phase 2 of AI_PRIMITIVES.md.

minify

Source-code minifier for stryke (stryke minify FILE).

mro

C3 method resolution order (Perl mro / Algorithm::C3 style).

native_data

Native CSV (csv crate), SQLite (rusqlite), and HTTP JSON (ureq + serde_json) helpers.

pack

Subset of Perl pack / unpack for binary I/O. Supported: A a N n V v C Q q Z H x w i I l L s S f d (optional repeat count after each; * for some).

par_lines

Memory-mapped parallel line iteration for par_lines PATH, fn { ... }. Splits the file into byte ranges aligned to line starts, then processes each chunk in parallel with rayon (each chunk scans its lines sequentially).

par_pipeline

par_pipeline — two overloads:

par_walk

Parallel recursive directory walk for par_walk PATH, fn { ... }.

parallel_trace

Optional stderr tracing for mysync mutations under trace { ... } and fan.

parser

pcache

Thread-safe memoization for crate::ast::ExprKind::PcacheExpr.

pchannel

Typed message channels for parallel blocks (pchannel, send, recv, pselect).

perf_recorder

Wall-clock recorder for stryke --record. Writes one row per stryke invocation to ~/.stryke/perf.sqlite, queryable via the perfview builtin.

perl_decode

UTF-8 vs Latin-1 octet decoding for Perl-compatible text (no dependency on crate::value). Used by I/O, par_lines, and byte stringification.

perl_fs

Perl-style filesystem helpers (stat, glob, etc.).

perl_inc

Resolve @INC paths from the system perl binary (same directories Perl searches for .pm files).

perl_pty

PTY-driven interactive automation — Phases 1–4 of the Tcl/Expect-style feature. Builtins are bare-name and take the handle hashref as first argument; method-form $h->expect(...) works through the thin PtyHandle class shipped via PTY_HANDLE_CLASS_STK.

perl_signal

Minimal %SIG delivery for common signals (Unix). Handlers run between statements.

pkg

stryke package manager — RFC: docs/PACKAGE_REGISTRY.md.

ppool

Persistent thread pool (ppool) — workers pull jobs from a shared queue and run each task on a fresh VMHelper on an existing OS thread (no rayon task spawn per item; threads stay alive between jobs).

profiler

Wall-clock profiler for stryke --profile.

pwatch

Parallel file notifications for pwatch GLOB, fn { ... } (notify + rayon).

remote_wire

Framed bincode over stdin/stdout for stryke --remote-worker (distributed pmap_on).

rust_ffi

Inline Rust FFI — rust { ... } blocks compiled to a cdylib on first run, dlopened, and registered as Perl-callable subs.

rust_sugar

Source-level desugaring for rust { ... } FFI blocks.

scope

script_cache

rkyv-backed bytecode cache for scripts.

secrets

Encrypted secrets — AES-256-GCM authenticated encryption.

serialize_normalize

Free-function recursive flatten of stryke ClassInstance / StructInstance values into plain hashref / arrayref trees, for use by serializers (to_json, to_xml, to_yaml, to_toml, to_html, ddump) that take &[StrykeValue] and don’t have a &VMHelper to consult.

shell_exec

Shell executor state for zshrs.

shell_fds

File descriptor utilities for zshrs.

shell_history

SQLite-backed command history for zshrs.

shell_jobs

Job control for zshrs

shell_parse

Zsh parser — direct port from zsh/Src/parse.c.

shell_signal

Signal handling for zshrs

shell_zle

ZLE - Zsh Line Editor

shell_zwc

ZWC (Zsh Word Code) file parser. Direct port of the dump-file family in zsh/Src/parse.c:3077-end.

sketches

Probabilistic data structures as native stryke builtins.

special_vars

Perl 5 ${^NAME} scalars: see perlvar.

static_analysis

Static analysis pass for detecting undefined variables and subroutines.

stress

Expanded stress-testing surface. The original stress_cpu / stress_mem / stress_io / stress_test / heat builtins live in builtins.rs; this module adds the rest of the load-axis matrix — float / int / cache / branch / sort compute; sustained-disk + IOPS; TCP / HTTP / DNS network; fork / thread churn; alloc / mmap memory; crypto / compress / regex / json kernels; ramp / burst / oscillate patterns; and per-system telemetry (temp / freq / throttle / load / meminfo).

token

value

vm

vm_helper

web

Web framework runtime — Rails-shaped builtins for stryke.

web_orm

Web framework ORM + migrator runtime — PASS 3 + PASS 4.

zsh_lex

Zsh lexical analyzer - Direct port from zsh/Src/lex.c

zsh_parse

Zsh parser — direct port from zsh/Src/parse.c.

zsh_tokens

Zsh lexical analyzer - Direct port from zsh/Src/lex.c

Constants

ERRFLAG_ERROR

Statics

zsh_errflag

Port of int errflag from Src/init.c. Tracks whether an error has been raised (ERRFLAG_ERROR = 1) or break/return is in flight (ERRFLAG_INT = 2).

Functions

bigint_pragma

Returns true when use bigint; is active in this script.

compat_mode

Returns true when --compat is active.

compile_and_run_prelude

Compile program and run only the prelude (BEGIN/CHECK/INIT phase blocks) via the VM. Stores the compiled chunk on interp.line_mode_chunk for per-line re-execution.

convert_to_stryke

Convert a parsed program to stryke syntax with |> pipes and no semicolons.

convert_to_stryke_with_options

Convert a parsed program to stryke syntax with custom options.

deconvert_to_perl

Deconvert a parsed stryke program back to standard Perl .pl syntax.

deconvert_to_perl_with_options

Deconvert a parsed stryke program back to standard Perl .pl syntax with options.

format_program

Parse a string of Perl code and return the AST. Pretty-print a parsed program as Perl-like source (stryke --fmt).

lint_program

Parse + register top-level subs / use (same as the VM path), then compile to bytecode without running. Also runs static analysis to detect undefined variables and subroutines.

no_interop_mode

Effective no-interop flag for this thread: TLS override if set, else the process-wide default. Hot path — called from parser/lexer.

no_interop_mode_tls

Read the current thread’s no-interop override (without falling back). Used by RAII guards to save/restore.

parse

parse_and_run_module_in_file

Like parse_and_run_string_in_file, but marks parsing as a module load. Allows shadowing stryke builtins (e.g. sub blessed { ... }) unless --no-interop is active.

parse_and_run_string

Parse and execute a string of Perl code within an existing interpreter. Compile and execute via the bytecode VM. Uses VMHelper::file for both parse diagnostics and __FILE__ during this execution.

parse_and_run_string_in_file

Like parse_and_run_string, but parse errors and __FILE__ for this run use file (e.g. a required module path). Restores VMHelper::file after execution.

parse_module_with_file

Like parse_with_file, but marks the parser as loading a module. Modules are allowed to shadow stryke builtins (e.g. sub blessed { ... } in Scalar::Util.pm) unless --no-interop.

parse_with_file

Parse with a source path for lexer/parser diagnostics (… at FILE line N), e.g. a script path or a required .pm absolute path. Use parse for snippets where -e is appropriate.

run

Parse and execute a string of Perl code with a fresh interpreter.

run_line_body

Execute the body portion of a pre-compiled chunk for one input line. Sets $_ to line_str, runs from body_start_ip to Halt, returns $_ for -p output.

run_lsp_stdio

Language server over stdio (stryke --lsp). Returns a process exit code.

set_bigint_pragma

Enable bigint pragma (use bigint;) — integer overflow promotes to BigInt instead of demoting to f64.

set_compat_mode

Enable Perl 5 strict-compatibility mode (disables all stryke extensions).

set_no_interop_mode

Set the process-wide default for no-interop mode. Used by the CLI (--no-interop); threads without a thread-local override inherit it.

set_no_interop_mode_tls

Set the current thread’s no-interop override. None clears it; Some(b) pins this thread to b. Sibling threads are unaffected — the primitive that lets check_no_interop work safely from pmaps.

try_vm_execute

Try to compile and run via bytecode VM. Returns None if compilation fails.

vendor_perl_inc_path

Crate-root vendor/perl (e.g. List/Util.pm). The stryke / stryke driver prepends this to @INC when the directory exists so in-tree pure-Perl modules shadow XS-only core stubs.