Skip to main content
Yanked

This release has been yanked by its maintainers, and will be ignored by installers, except when explicitly specified.
Consider using release 0.8.0 instead.
Reason given by maintainers: Bug in this release, tool will not start. Fixed in 0.3.1

GitHub Link GitHub Workflow Status (branch) Codecov branch PyPI PyPI - Python Version License - MIT

puncover

https://raw.githubusercontent.com/HBehrens/puncover/master/images/overview.png

Analyzes C/C++ binaries for code size, static variables and stack usages. It creates a report with disassembler and call-stack analysis per directory, file, or function.

Installation and Usage

Install with pip:

pip install puncover

Run it by passing the binary to analyze:

puncover --elf_file project.elf
...
* Running on http://127.0.0.1:5000/ (Press CTRL+C to quit)

Open the link in your browser to view the analysis.

Running Tests Locally

To run the tests locally, you need to install the development dependencies:

  1. install pyenv: https://github.com/pyenv/pyenv

    curl https://pyenv.run | bash
  2. install all the python environments, using this bashism (this can take a few minutes):

    for _py in $(<.python-version ); do pyenv install ${_py}; done
  3. install the development dependencies:

    pip install -r requirements-dev.txt

Then you can run the tests with:

tox

Publishing Release

  1. Update the version in puncover/__version__.py.

  2. Commit the version update: .. code-block:: bash

    git add . && git commit -m “Bump version to x.y.z”

  3. Create an annotated tag: .. code-block:: bash

    git tag -a {-m=,}x.y.z

  4. Push the commit and tag: .. code-block:: bash

    git push && git push –tags

  5. Either wait for the GitHub Action to complete and download the release artifact for uploading: https://github.com/HBehrens/puncover/actions OR Build the package locally: python setup.py sdist bdist_wheel

  6. Upload the package to PyPI: .. code-block:: bash

    twine upload dist/*

  7. Create GitHub releases: - gh release create --generate-notes x.y.z - attach the artifacts to the release too: gh release upload x.y.z dist/*

Release Script

See scripts/release.sh for a script that automates the above steps.

Contributing

Contributions are welcome! Please open an issue or pull request on GitHub.

Release files for puncover 0.3.0

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

Source distribution (sdist)

Source distribution for puncover 0.3.0
File Size Uploaded
puncover-0.3.0.tar.gz 171.4 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for puncover 0.3.0
File Interpreter ABI Platform
puncover-0.3.0-py3-none-any.whl Python 3 none any Details

Total release size: 342.1 kB

Release files / puncover-0.3.0.tar.gz

Download URL puncover-0.3.0.tar.gz
Size 171.4 kB
Tags Source
SHA-256 checksum
How to use checksums
f5878302ec945ed45182827c58c67221b93c379fa1c99846e5f16e88ba7c0db5
BLAKE2b-256 checksum
How to use checksums
2fd3637b2c8b9838bff924469b211064fa5a56c29f155dee5903c079d4a40478
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/4.0.2 CPython/3.10.7

Release files / puncover-0.3.0-py3-none-any.whl

Download URL puncover-0.3.0-py3-none-any.whl
Size 170.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
3f460a966fb40a235c6090db77b06f9f3d26abed91d959f17e13b8ae07f8e567
BLAKE2b-256 checksum
How to use checksums
f107879235e0b45c0424abea594bde944c1dd4815feeb9fc68b467dab40afc52
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/4.0.2 CPython/3.10.7

Release history Release notifications | RSS feed

0.8.0

2 release files

0.7.1

2 release files

0.7.0

2 release files

0.6.1

2 release files

0.6.0

2 release files

0.5.0

2 release files

0.4.2

2 release files

0.4.1

2 release files

0.4.0

2 release files

0.3.6

2 release files

0.3.5

2 release files

0.3.4

2 release files

0.3.3

2 release files

0.3.2

2 release files

0.3.1

2 release files

This release

0.3.0 This release

2 release files

0.2.2

2 release files

0.2.1

2 release files

0.2.0

2 release files

0.1.0

2 release files

0.0.1

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page