This release is a pre-release and may not be stable for production use.
cdis - a consistent Python disassembler
Important
The cdis bytecode format will not be considered stable until the 1.0.0 release.
The 0.x.y releases may have breaking changes in both the bytecode and the API exposed.
What is it?
cdis, pronounced "see this", is a Python disassembler that produce consistent results across Python versions. CPython bytecode is neither forward or backwards compatible, so it outputs bytecode for the "cdis Virtual Machine", which when executed, has the exact same behaviour as CPython's bytecode.
Why would I use it?
- To write a Python compiler to any language of your choice
- To determine what symbols a function uses
- As a compiler target to generate Python code from another language
Known differences with CPython
- Different behaviour of
locals()inside list comprehensions. In particular, we use a synthetic variable for the iterator variable instead of reusing the name. CPython changed the behaviour oflocals()in list comprehension in 3.12, so this is undefined behaviour. - Different behaviour of when match variables are bound.
Technically, Python allows binding even when subpatterns fail.
That being said, CPython does appear to have consistent behaviour of delaying
binding until all subpatterns succeed.
As such, a future version of
cdiswill probably match CPython behaviour.
Missing features
- User customizable optimization passes (Planned)
- User customizable VM tracer (Planned)
- A guide on how to actually use
cdis(Planned).
Run tests
Install test dependencies
pip install "pytest>8" "coverage" "tox"
pip install -e .
Run tests on current python version
pytest
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file cdis-0.0.1a0.tar.gz.
File metadata
- Download URL: cdis-0.0.1a0.tar.gz
- Upload date:
- Size: 69.9 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
b30933e6f4a0518b0afcc25dc0073828bd226d49650fa675b45caeb6600deafe
|
|
| MD5 |
a8b99d5491f881c21a76207bb05a1243
|
|
| BLAKE2b-256 |
1ab7d646e6b3c98d087e3f95a2f463212fde07ff92d83d242a94c8f9a929a6ac
|
Provenance
The following attestation bundles were made for cdis-0.0.1a0.tar.gz:
Publisher:
release.yml on cdis-vm/cdis
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
cdis-0.0.1a0.tar.gz -
Subject digest:
b30933e6f4a0518b0afcc25dc0073828bd226d49650fa675b45caeb6600deafe - Sigstore transparency entry: 2620348444
- Sigstore integration time:
-
Permalink:
cdis-vm/cdis@1fb3f9accdd9dc9bff6ee98f0c6d1f52b3c96592 -
Branch / Tag:
refs/tags/0.0.1a0 - Owner: https://github.com/cdis-vm
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@1fb3f9accdd9dc9bff6ee98f0c6d1f52b3c96592 -
Trigger Event:
release
-
Statement type:
File details
Details for the file cdis-0.0.1a0-py3-none-any.whl.
File metadata
- Download URL: cdis-0.0.1a0-py3-none-any.whl
- Upload date:
- Size: 67.2 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
b96dae7c00e9a11e1f5fbbefcf73f3cbd93fabebd59f972a7d0878e8225608a1
|
|
| MD5 |
3d24c60a87f954678bb5799b912d1dd9
|
|
| BLAKE2b-256 |
0f3da11a0dd4380bdc4343620659cb954a796fefdd2f58764758be5b47b261ff
|
Provenance
The following attestation bundles were made for cdis-0.0.1a0-py3-none-any.whl:
Publisher:
release.yml on cdis-vm/cdis
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
cdis-0.0.1a0-py3-none-any.whl -
Subject digest:
b96dae7c00e9a11e1f5fbbefcf73f3cbd93fabebd59f972a7d0878e8225608a1 - Sigstore transparency entry: 2620348451
- Sigstore integration time:
-
Permalink:
cdis-vm/cdis@1fb3f9accdd9dc9bff6ee98f0c6d1f52b3c96592 -
Branch / Tag:
refs/tags/0.0.1a0 - Owner: https://github.com/cdis-vm
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@1fb3f9accdd9dc9bff6ee98f0c6d1f52b3c96592 -
Trigger Event:
release
-
Statement type:
