elixcee

Run and test a practical subset of Excel VBA without Microsoft Excel. The core is Rust, with a Python API (PyO3), a standalone CLI, and an experimental @elixcee/xlsx JavaScript/WASM package.

Current release: 1.0.1.

elixcee is intended for data-processing macros. It is not a replacement for the Excel desktop application: UI features such as charts, dialogs, and screen updates are skipped, modeled, or reported according to the operation.

Install

pip install elixcee

Pre-built CLI binaries are published on the GitHub Releases page.

For a source build:

python3 -m venv .venv
source .venv/bin/activate
pip install maturin
maturin develop

CLI

elixcee <file.bas>... <MacroName> [--file input.xlsx] [--sheet Sheet1]
                         [--output result.xlsx] [--json]
elixcee check <file.bas>... [--entry MacroName] [--json]
elixcee snapshot <workbook.xlsx|ods> [--json]
elixcee test-workbook fixture.toml [--json] [--seed N] [--case N]
elixcee diagnose <file.bas>... <MacroName> --file input.xlsx [--json]
elixcee diagnose-workbook fixture.toml [--json] [--seed N] [--case N] [--cases N]

The run command accepts one or more standard VBA modules (.bas, .vbs, or .txt). Use Module.Sub for a qualified entry point in a multi-module run. --json emits one stable JSON object on stdout; see docs/agent-contract.md for the contract.

Python quick start

import elixcee

vm = elixcee.Vm()
vm.set_cell(1, 1, 10)          # coordinates are 1-based, like Excel
vm.run("""
Sub DoubleIt()
    Cells(1, 2).Value = Cells(1, 1).Value * 2
End Sub
""", "DoubleIt")
print(vm.get_cell(1, 2))       # 20

vm = elixcee.load_workbook("input.xlsx")
vm.run(vba_code, "ProcessData")
vm.save_workbook("output.xlsx")

# Optional reader resource controls (the cancellation check is cooperative).
cancel = elixcee.ReadCancellation()
vm = elixcee.load_workbook(
    "input.xlsx", max_work_units=100_000_000, timeout_ms=30_000, cancellation=cancel
)

The Python API also provides formula evaluation, ranges, sorting, merges, hidden rows/columns, sheet management, styles, tables, data validation, AutoFilter, defined-name inspection, pandas export, and .xlsx/.xlsm/.ods workbook I/O. See elixcee.pyi for signatures and behavior.

For large XLSX/XLSM files, open_stream(path, sheet=None) yields rows without materializing the whole workbook. Set include_row_numbers=True to receive (row_number, values) tuples, or max_rows=N/max_row_bytes=N/max_columns=N to bound a read. Set timeout_ms=N to bound how long each next() waits for another row. create_stream(path) provides an append-only XLSX row writer. Set max_rows=N, max_columns=N, and/or max_pending_bytes=N to bound pending output.

Vm(on_msgbox="skip") is the default. Use on_msgbox="error" to make a MsgBox call raise an error. Set Vm(timeout_ms=N) or pass timeout_ms=N to run_macro to bound VBA execution time.

The read-only CLI snapshot accepts --max-work-units N, --timeout-ms N, and --cancel-file PATH. Creating the cancel-file while a read is in progress requests a cooperative stop; a blocking filesystem read cannot be forcibly interrupted by this mechanism. Repeated runs of the same source on one Vm reuse its parsed AST. Use vm.fork() to create an isolated copy for batch execution. Use vm.snapshot() to obtain a detached read-only view of all sheets. Pass include_formulas=True to include stored formulas separately from values. Snapshots also include the workbook's worksheet tab order. Snapshots also include runtime defined names. Snapshots include the current calculation_mode (automatic or manual). Snapshots include per-sheet visibility states (visible, hidden, or veryHidden). Snapshots include per-sheet merged ranges in A1 notation. Snapshots include hidden row and column intervals. Use diagnose_macro(vba_code, macro_name, workbook_path) for structured diagnostics matching the CLI diagnose --json contract.

Supported VBA and formulas

The interpreter supports common data-processing constructs including Sub/Function, variables and arrays, If, For, For Each, Do, Select Case, With, On Error, user-defined types, named ranges, multiple sheets, and Excel-style Range/Cells operations. Formula support includes arithmetic, comparisons, criteria functions, lookup functions, date/time, text, statistical, financial, logical, and dynamic-array functions.

The maintained coverage list is FUNCTIONS.md. Unsupported or intentional no-op behavior is documented there and in the diagnostic contract.

Workbook compatibility

The Rust reader/writer preserves supported cell data, formulas, styles, merges, hidden rows/columns, and many unknown OOXML parts. Macro projects in .xlsm files are preserved during supported round trips. Features not modeled by the writer can still be lost or disconnected; tables, drawings, comments, hyperlinks, and other OOXML objects should be treated as compatibility gaps unless covered by tests for the version in use.

The project runs Rust tests, property tests, compatibility fixtures, and differential tests for the JavaScript package in CI. Compatibility with Excel's VBA execution semantics is not claimed for every macro, and post-save macro execution has not been fully validated against desktop Excel.

The v1 support boundaries are documented in docs/v1-support-contract.md. Version 1.0 is a stable contract for the documented data-processing subset and its safe failure behavior; it is not a claim of complete Excel or VBA compatibility.

Development

cargo test --workspace
cargo fmt --check
cargo clippy --all-targets --all-features -- -D warnings
cargo audit --no-fetch
cargo deny check --disable-fetch
python3 scripts/check-reader-measurements.py docs/measurements/*.json
python3 scripts/check-reader-measurements.py --self-test
bash scripts/check-measurement-boundary.sh

依存監査は、ネットワークアクセスを必要としないローカル検証として実行できます。 cargo audit --no-fetchとcargo deny check --disable-fetchは、手元にある advisory DB とリポジトリ内のdeny.tomlを使用します。advisory DBが古い場合は、結果が最新の公開情報を反映していない可能性があります。

The short-term plan is in ROADMAP.md. Public design and policy documents are in docs/.

License: MIT. See THIRD_PARTY_NOTICES.md.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

elixcee-1.0.1.tar.gz (2.7 MB view details)

Uploaded Sep 4, 2026 Source

Built Distributions

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

elixcee-1.0.1-pp311-pypy311_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (1.6 MB view details)

Uploaded Sep 4, 2026 PyPymanylinux: glibc 2.17+ x86-64

elixcee-1.0.1-pp311-pypy311_pp73-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (1.6 MB view details)

Uploaded Sep 4, 2026 PyPymanylinux: glibc 2.17+ ARM64

elixcee-1.0.1-cp315-cp315t-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (1.6 MB view details)

Uploaded Sep 4, 2026 CPython 3.15tmanylinux: glibc 2.17+ x86-64

elixcee-1.0.1-cp315-cp315-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (1.6 MB view details)

Uploaded Sep 4, 2026 CPython 3.15manylinux: glibc 2.17+ x86-64

elixcee-1.0.1-cp314-cp314t-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (1.6 MB view details)

Uploaded Sep 4, 2026 CPython 3.14tmanylinux: glibc 2.17+ x86-64

elixcee-1.0.1-cp314-cp314t-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (1.6 MB view details)

Uploaded Sep 4, 2026 CPython 3.14tmanylinux: glibc 2.17+ ARM64

elixcee-1.0.1-cp314-cp314-win_amd64.whl (1.5 MB view details)

Uploaded Sep 4, 2026 CPython 3.14Windows x86-64

elixcee-1.0.1-cp314-cp314-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (1.6 MB view details)

Uploaded Sep 4, 2026 CPython 3.14manylinux: glibc 2.17+ x86-64

elixcee-1.0.1-cp314-cp314-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (1.6 MB view details)

Uploaded Sep 4, 2026 CPython 3.14manylinux: glibc 2.17+ ARM64

elixcee-1.0.1-cp314-cp314-macosx_10_12_x86_64.macosx_11_0_arm64.macosx_10_12_universal2.whl (3.0 MB view details)

Uploaded Sep 4, 2026 CPython 3.14macOS 10.12+ universal2 (ARM64, x86-64)macOS 10.12+ x86-64macOS 11.0+ ARM64

elixcee-1.0.1-cp313-cp313-win_amd64.whl (1.5 MB view details)

Uploaded Sep 4, 2026 CPython 3.13Windows x86-64

elixcee-1.0.1-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (1.6 MB view details)

Uploaded Sep 4, 2026 CPython 3.13manylinux: glibc 2.17+ x86-64

elixcee-1.0.1-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (1.6 MB view details)

Uploaded Sep 4, 2026 CPython 3.13manylinux: glibc 2.17+ ARM64

elixcee-1.0.1-cp313-cp313-macosx_10_12_x86_64.macosx_11_0_arm64.macosx_10_12_universal2.whl (3.0 MB view details)

Uploaded Sep 4, 2026 CPython 3.13macOS 10.12+ universal2 (ARM64, x86-64)macOS 10.12+ x86-64macOS 11.0+ ARM64

elixcee-1.0.1-cp312-cp312-win_amd64.whl (1.5 MB view details)

Uploaded Sep 4, 2026 CPython 3.12Windows x86-64

elixcee-1.0.1-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (1.6 MB view details)

Uploaded Sep 4, 2026 CPython 3.12manylinux: glibc 2.17+ x86-64

elixcee-1.0.1-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (1.6 MB view details)

Uploaded Sep 4, 2026 CPython 3.12manylinux: glibc 2.17+ ARM64

elixcee-1.0.1-cp312-cp312-macosx_10_12_x86_64.macosx_11_0_arm64.macosx_10_12_universal2.whl (3.0 MB view details)

Uploaded Sep 4, 2026 CPython 3.12macOS 10.12+ universal2 (ARM64, x86-64)macOS 10.12+ x86-64macOS 11.0+ ARM64

elixcee-1.0.1-cp311-cp311-win_amd64.whl (1.5 MB view details)

Uploaded Sep 4, 2026 CPython 3.11Windows x86-64

elixcee-1.0.1-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (1.6 MB view details)

Uploaded Sep 4, 2026 CPython 3.11manylinux: glibc 2.17+ x86-64

elixcee-1.0.1-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (1.6 MB view details)

Uploaded Sep 4, 2026 CPython 3.11manylinux: glibc 2.17+ ARM64

elixcee-1.0.1-cp311-cp311-macosx_10_12_x86_64.macosx_11_0_arm64.macosx_10_12_universal2.whl (3.0 MB view details)

Uploaded Sep 4, 2026 CPython 3.11macOS 10.12+ universal2 (ARM64, x86-64)macOS 10.12+ x86-64macOS 11.0+ ARM64

elixcee-1.0.1-cp310-cp310-win_amd64.whl (1.5 MB view details)

Uploaded Sep 4, 2026 CPython 3.10Windows x86-64

elixcee-1.0.1-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (1.6 MB view details)

Uploaded Sep 4, 2026 CPython 3.10manylinux: glibc 2.17+ x86-64

elixcee-1.0.1-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (1.6 MB view details)

Uploaded Sep 4, 2026 CPython 3.10manylinux: glibc 2.17+ ARM64

elixcee-1.0.1-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (1.6 MB view details)

Uploaded Sep 4, 2026 CPython 3.9manylinux: glibc 2.17+ x86-64

elixcee-1.0.1-cp39-cp39-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (1.6 MB view details)

Uploaded Sep 4, 2026 CPython 3.9manylinux: glibc 2.17+ ARM64

File details

Details for the file elixcee-1.0.1.tar.gz.

File metadata

Download URL: elixcee-1.0.1.tar.gz
Upload date: Sep 4, 2026
Size: 2.7 MB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for elixcee-1.0.1.tar.gz
Algorithm	Hash digest
SHA256	`ebd98266d78ff91ea1ec4175bc9c6560c2062750c59c61261561d4cac5517df3`
MD5	`6165aae057e44870e8d585d1b8e4552d`
BLAKE2b-256	`4877b40f65464ec87af85ab0123eedcea6859fa6ef4881e96fa93b2e5da3d89b`

Algorithm	Hash digest
SHA256	`7e604146d65b5305409a85bcf5965f5ad0bf1c111253e78c88d655fe475438d9`
MD5	`34f1f38e54be05aee516d18724ecc929`
BLAKE2b-256	`1c42c35fad0f30a95ff6536ef9f960d0f5f695e0d322341b81e43ad9840495a9`

Algorithm	Hash digest
SHA256	`b1c39c8d518deac7619aae3b5666a2e155d0204dfe901dce37e2129284c0ee84`
MD5	`4a3c1528cfbf0ff476d622b9e45874ff`
BLAKE2b-256	`c8943e8a41ab88a23e1d03b1ab1dc0313c7b217327b5e71fc773c37c81cf5c9e`

Algorithm	Hash digest
SHA256	`8c19ec714f44046a69e2269a381d8d9a50fb647eccdef3fc22e10ec54f1a5f2f`
MD5	`52a3f42fa06f41eaa31aa515402565fd`
BLAKE2b-256	`891e0119ef58d6e69af93978a2b8989219bca17f2bb5b81b1c719c19e8ea368a`

Algorithm	Hash digest
SHA256	`62e8a3bb5f02c5560845226bd60b1924cf3c36ad38267ea65341b772f037e45b`
MD5	`9a48335b1a35e0352b9e3b362b0ada99`
BLAKE2b-256	`4ccd0b90ee8e269e30bc09e25c8f4210b0eedcc56fb1cff2cf3192d39629c818`

Algorithm	Hash digest
SHA256	`30d5e54726b9dbdc0b12b52b0caebafd7c38a7c5fbb2f936d3f0fe058a4cf3d4`
MD5	`cc65afac680fb83acf1fcc7e6da83cb9`
BLAKE2b-256	`4cbdde444269ffd31224d97ba3838aaf4104a7d959fd79f29cd2c71a8c820866`

Algorithm	Hash digest
SHA256	`266ddedb9efcacba5a5b77f3a12ac08e5ea95fec370ca981d71510a67475cf45`
MD5	`f7eff83362389ed4c3b35b10f53632ca`
BLAKE2b-256	`b61fab2ea58097ef76f89bb5bd1910bb0c8d0c92aa11e94d0cefa0e6c541da68`

Algorithm	Hash digest
SHA256	`3492880821178d41a3fa1a13b36b676933d3b3381f9510aaf1d9c37ec52a49b4`
MD5	`ffd96df4bc71f73d42cd594f0ef4b914`
BLAKE2b-256	`09d1513fd9fa9a5a7548a6bdf9769fb10b903e4bcd228998377d1c81645db390`

Algorithm	Hash digest
SHA256	`4b8198049a704d970cb29e9133cc72f92b9b1450cdd41df12e44600852e541d3`
MD5	`7a74e5d2f29e26cd9f43e15dae1b4fe0`
BLAKE2b-256	`d3899354dde66adf1b4feedf252a9c0e669683a7231b1d93607d4075f0a6c8a9`

Algorithm	Hash digest
SHA256	`552072b4188d828779c56b8dc83778e3e74b286bb5ccb0b679abfa6c59b0110d`
MD5	`2870a15444020ce68d2712c9a7415dc2`
BLAKE2b-256	`11dee80f1219a74be86ad4e2b76c0645c1097df7421ad59b665718b6b757973e`

Algorithm	Hash digest
SHA256	`9048917b3daa1dc78ba8dc5d61bababf23da86762c33f56ed4793d86977b01b4`
MD5	`607ec7de8ad7b89cc69a7a23dca1c88b`
BLAKE2b-256	`9340628cc5a9e6ad10a723b55d22df9abde455aa8d531b518b5ead2bb1f85018`

Algorithm	Hash digest
SHA256	`7793b56757b8e37d922506316a1de0ddf3f4f8560b4ffcf932aa0c72ae8c3d0b`
MD5	`54604df3f113b0de6ab2c6edc1f109a7`
BLAKE2b-256	`3f5aee3eb4ce90a04d74ccbdb64c4d10423eb0a1e03fa78b5af478c68a34230d`

Algorithm	Hash digest
SHA256	`3b88a799b54266022d91ffc6130f9cd4bd430c4dee73dae29275ae46af3875cd`
MD5	`5305216eb0a230fec986565efb70074d`
BLAKE2b-256	`41e3d107d08e4903e0c1488b2860fc63555342fcd149d0de755e1bf4c7f83cad`

Algorithm	Hash digest
SHA256	`4158ecfa8affa2165992b98a30827aa13169f6303a32d2e9cdad4ac099a9112f`
MD5	`c8892d1a679c51533d38f5dff85434ec`
BLAKE2b-256	`72624fd6a2a9d37cb3b4e75c8c8da5d3d990af047885f8ca37428c2a38087f85`

Algorithm	Hash digest
SHA256	`e073673e233f32525d444a1e1d88401350ea34c02b332a2b2f9e7bbf3fae5ff3`
MD5	`c554713b344403d722042e70d338e70c`
BLAKE2b-256	`523b95bcc4607ff18d8f3fcd311e032b27940290091ef02d7816aa5040f9f558`

Algorithm	Hash digest
SHA256	`94f5e2562511c63d1e6550b6ad23340947b25ed7db08b7b29b75c627022bcb13`
MD5	`c883c262030af4c77893a03a55974da4`
BLAKE2b-256	`e29ad9fb1ab2bef4777d5f91d5da47e5b57ade3068a0064ee65c497f458f6537`

Algorithm	Hash digest
SHA256	`1ef006ae543a9a6532895f345ff2d0158366eb8929cdaf901046ba04bd0b0086`
MD5	`2ea0aad62d9d52f45eb1d23b78770db7`
BLAKE2b-256	`995e53f94299a4fd881d91650fb49cc8f155be88828b29ca0458e779cecaa435`

Algorithm	Hash digest
SHA256	`ee5b7fcce7c04b27dc1e54bec0d30bc732263232186145b54cfbf6d128edc3ba`
MD5	`b28398b59b0400bb4ef5ade3d528fe37`
BLAKE2b-256	`742e48a39d5d247b5ccfdc51216b1404d28f421427413268232657b7ca1cd727`

Algorithm	Hash digest
SHA256	`f03a5dbc4bc31cbaa8393b31200464e9fab9cd3e6917e5842bae31d09a47d42a`
MD5	`4ed5817be9416536172ffe30e4d6d87d`
BLAKE2b-256	`f43ccdeb5980b7ef0311da164ad2b2246e6a5c32f8b3471db8d0bee4afd04b10`

Algorithm	Hash digest
SHA256	`f739b1677b6b9323cbb18fe67e1a689699d7f22f83d9c1f50339778bdba349a8`
MD5	`99bb3393af8e222789b387ff64673e66`
BLAKE2b-256	`0f97c7a1518392282c8c290a1bd0499833de2a9a641dc55432291571d8f3e43a`

Algorithm	Hash digest
SHA256	`70e855ff7dbac26a88906628d3d26a8b641fa65e3ff53e39f3a3c118fe93ee57`
MD5	`8ef861bc1876128693de2036b31be1f4`
BLAKE2b-256	`482cd1c9151e8cec2e18c85c5a92b8f99e101bfb8a780c6eacd369ef9bfd1cab`

elixcee 1.0.1

elixcee

Install

CLI

Python quick start

Supported VBA and formulas

Workbook compatibility

Development

Project links

Key dates

1 maintainer

GitHub Statistics

License

Requires

Tags

Classifiers

Download files

Source Distribution

Built Distributions

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

Algorithm	Hash digest
SHA256	`373d9d2dda3bf0d8a05112bed145b68abcf1264118db923a1a7440427da100b0`
MD5	`a5871b0f8dfdffd11b3208fb4ab53083`
BLAKE2b-256	`2a60edfb8a3630586c2f05b531af8cc36ebbe5be51dc1189fec8d929faaf1b01`

Algorithm	Hash digest
SHA256	`e8a8e4f86bce8a277f2efa35905c1dc13d9ace7806417889a606716b5797b439`
MD5	`e404ab6c163f04e5235e93a755e0eee8`
BLAKE2b-256	`5e500bb2b839cdb5a7994745776fc1d72218a71ce4d2444066d4d628cd3866c4`

Algorithm	Hash digest
SHA256	`1ee39783a1d4d698124c69051cdc130d3943885f9163b07e6c392b7144ff7b56`
MD5	`062e72586e408c5f09816cd73c8b5213`
BLAKE2b-256	`e5b5927128c7bb676e6bd6b9f4040942c68f1bcab26a5bdb5f63dd2fe19b4a12`

Algorithm	Hash digest
SHA256	`fb73d3fd2043dffb384531d5374a3b80c1956bd3fdb63a19390b09b0ee2dad2f`
MD5	`c75fca8f4f48862de7704a61a2ae9588`
BLAKE2b-256	`111c7c301a60046466705ec3d1ca32d6964ded4b9351ff9a36e039d07772a0f1`

Algorithm	Hash digest
SHA256	`9753343117d7252dea0c9e25762970b6fccfb2b77163058a6e5df0cd4237c60b`
MD5	`4d1df2dd4ad17e1011b4456f9eeb574a`
BLAKE2b-256	`28ef2b0c11e4a094457ab6f0f0766597d4ae15626a4fd39daba7c51a9317cebc`

Algorithm	Hash digest
SHA256	`9a88cf2313bb8487642e07e11cbfba85f0013cd667ad95b41cb5b155d969cb9f`
MD5	`902ea4c58d183e755ebc617cc202de8e`
BLAKE2b-256	`ea21499e5b55d24ebde8c53ea568a3307bcfd69fe8dff7e0eed68d8b407d438a`

Algorithm	Hash digest
SHA256	`ffa6e387f0fb87119a63068ad048bf1b2f6608ec3f72af1910c87f3c326d642b`
MD5	`1a5ee1ee748318be0b963ef9c6038b19`
BLAKE2b-256	`796b57e6089b8cea64de45890ecc2a06e87c0e9f51a39cb5cdcae89400a676a9`