A catch-all compile-tool wrapper
Project description
blight
blight is a catch-all compile tool wrapper.
Usage
$ pip3 install blight
$ eval $(blight-env --guess-wrapped)
$ export BLIGHT_ACTIONS="Record"
$ export BLIGHT_ACTION_RECORD="output=/tmp/demo.jsonl"
$ cd /your/project && make
$ cat /tmp/demo.jsonl
Goals
- Wrapping
CC,CXX,CPP,LD, andAS. - Providing a visitor-style API for each of the above, pre- and post-execution.
- Providing a nice set of default actions.
- Being as non-invasive as possible.
Anti-goals
- Using
LD_PRELOADto capture everyexecin a build system, a la Bear. - Supporting
cl.exe. - Detailed support for non C/C++ languages.
Contributing a new action
New blight actions are easy to write. For example, the following prints a message before every ld
invocation:
# src/blight/actions/printld.py
from blight.action import LDAction
class PrintLD(LDAction):
def before_run(self, tool):
print(f"ld was run with: {tool.args}")
# src/blight/actions/__init__.py
# bring PrintLD into blight.actions so that `BLIGHT_ACTIONS` can find it
from printld import PrintLD # noqa: F401
$ eval $(blight-env --guess-wrapped)
$ export BLIGHT_ACTIONS="PrintLD"
$ make
Check out blight's API documentation for more details, including the kinds of available actions.
The name?
Build systems and tools that instrument build systems are a blight on my productivity.
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
blight-0.0.16.tar.gz
(18.5 kB
view details)
File details
Details for the file blight-0.0.16.tar.gz.
File metadata
- Download URL: blight-0.0.16.tar.gz
- Upload date:
- Size: 18.5 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/3.2.0 pkginfo/1.6.1 requests/2.24.0 setuptools/50.3.2 requests-toolbelt/0.9.1 tqdm/4.51.0 CPython/3.8.6
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 01c570f2953c8581973a051d4fa5413d608949dcc7ee3a772f492b1476b41956 |
|
| MD5 | 6614b1c3e23d5d74c06e9067716bfa4e |
|
| BLAKE2b-256 | 0be1d643ff72270ca7e02d14ed30d34d0c27353ae65abe7b133a6326147b648d |
