python_papi

Python binding for the PAPI library


Keywords
papi, perf, performance
License
WTFPL
Install
pip install python_papi==5.5.1.5

Documentation

PyPAPI

GitHub PyPI License Discord Github Actions Black

PyPAPI is a Python binding for the PAPI (Performance Application Programming Interface) library. PyPAPI implements the whole PAPI High Level API and partially the Low Level API.

Note

Starting with v5.5.1.4, PyPAPI is only compatible with GCC 7.0 or higher. Please use previous releases for older GCC version.

Documentation:

Installing PyPAPI

See this page of the documentation:

Hacking

Building PyPAPI For Local Development

To work on PyPAPI, you first have to clone this repositiory and initialize and update submodules:

git clone https://github.com/flozz/pypapi.git
cd pypapi

git submodule init
git submodule update

Then you have to build both PAPI and the C library inside the pypapi module. This can be done with the following commands:

python setup.py build
python pypapi/papi_build.py

Linting and Code formatting

To build lint the code, you first need to install Nox:

pip install nox

Then, run the following command:

nox -s lint

To automatically coding style issues, run:

nox -s black_fix

Generating Documentation

To build the Sphinx documentation, you first need to install Nox:

pip install nox

Then, run the following command:

nox -s gendoc

Support this project

Want to support this project?

Changelog

  • [NEXT] (changes on master, but not released yet):
    • Nothing yet :)
  • v6.0.0.1:
    • feat!: Updated the PAPI library to v6.0.0.1
  • v5.5.1.6:
    • chore: Added code linting with Flake8 (@flozz)
    • chore: Added code formatter and reformatted all files with Black (@flozz)
    • chore: Added Nox to run code linting, code formatting, doc building tasks (@flozz)
    • chore: Updated dev dependnecies (@flozz)
    • chore: Automatically build and publish sdist package and wheels for Linux (@flozz, #39)
    • docs: Updated documentation (@flozz)
  • v5.5.1.5:
    • fix: Fixed issue with module named types.py (@mcopik, #19)
  • v5.5.1.4:
    • chore: Fixed compilation with GCC 8 and newer (@maresmar, #18)
    • chore!: PyPAPI is no more compatible with GCC < 7.0
  • v5.5.1.3:
    • chore: Removed .o, .lo and other generated objects from the package
  • v5.5.1.2:
    • feat: Partial bindings for the low level API
  • v5.5.1.1:
    • chore: Added missing files to build PAPI
  • v5.5.1.0:
    • feat: Initial release (binding for papy 5.5.1)