Python Tree Shaking

English README is under construction.

Install

pip install tree-shaking

Be noted tree-shaking requires Python >= 3.12.

Usage

Project tree (before):

# my example project
/workspace/hello-world
|= .venv
|= hello_world
   |- __init__.py
   |- __main__.py
   |- ...
|= dist
|- pyprojet.toml
|- tree_shaking.yaml
|- ...

"tree_shaking.yaml" content:

root: .
search_paths:
  - <root>/.venv/Lib/site-packages
  - <root>
entries:
  - <root>/hello_world/__main__.py

Create a temporary script (e.g. "build.py"), code like this:

import tree_shaking
tree_shaking.build_graph_modules("./tree_shaking.yaml")
tree_shaking.dump_tree("./tree_shaking.yaml", "./dist/minified_libs")

After running, the project tree changes:

# my example project
/workspace/hello-world
|= .venv
|= hello_world
   |- __init__.py
   |- __main__.py
   |- ...
|= dist
   |= minified_libs  # updated
      |= ...
|- pyprojet.toml
|- tree_shaking.yaml
|- ...

You can temporarily exclude ".venv/Lib/site-packages", and add "dist/minified_libs" to Python's sys.path (put it at the first place) to test if worked.

After testing, compress "dist/minified_libs" to zip, and compare its size with ".venv/Lib/site-packages" -- the more heavy dependencies you have, the more notable changes on size reduction.

Incremental Updates

Just rerun "build.py", outputs results to the same path as last time, tree-shaking will find the changed parts and do only necessary adding/deleting operations to the target directory.

Metadata

Release files for tree-shaking 0.4.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Built distribution (wheel)

Table of built distributions (wheels) for tree-shaking 0.4.1
File	Interpreter	ABI	Platform	Reset
tree_shaking-0.4.1-py3-none-any.whl 30.0 kB Sep 7, 2026	Python 3	none	any	Details

Release files / tree_shaking-0.4.1-py3-none-any.whl

Download URL	tree_shaking-0.4.1-py3-none-any.whl
Size	30.0 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`6094efa45af1d0d22ef949213d2ba5ba54c80b9b117be89e50e5001f207b09dc`
BLAKE2b-256 checksum How to use checksums	`92a1367f1683a9b393dcca0b64a9f8fcfea5146f3eb561b913e16f664d1252fc`
Upload date	Sep 7, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`uv/0.11.12 {"installer":{"name":"uv","version":"0.11.12","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":null,"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}`