Skip to content

Commit 5f57b0c

Browse files
committed
Update README
1 parent e0bac0d commit 5f57b0c

File tree

2 files changed

+34
-2
lines changed

2 files changed

+34
-2
lines changed

.github/workflows/python-publish.yml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -57,7 +57,7 @@ jobs:
5757
path: dist/
5858

5959
release:
60-
# if: github.ref_type == 'tag' # Only trigger release if the commit is tagged
60+
if: github.ref_type == 'tag' # Only trigger release if the commit is tagged
6161
needs: build
6262
runs-on: ubuntu-latest
6363

README.md

Lines changed: 33 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1 +1,33 @@
1-
# past-python-bindings
1+
# PAST Python Bindings
2+
3+
## Introduction
4+
5+
This is a Python package for PAST, a tool developed by [Louis-Noel Pouchet](https://sourceforge.net/projects/pocc/files/?source=navbar) as part of the PoCC project. The package provides Python bindings using **pybind11**.
6+
7+
Pre-built wheels are automatically released, making installation easy!
8+
9+
## Build Requirements
10+
11+
To build the package from source, ensure that you have the following:
12+
13+
- **GCC** version 8 or higher
14+
- **pybind11** (used for the Python bindings)
15+
16+
## How It Works
17+
18+
Refer to `.github/workflows/python-publish.yml` or `tests/test_local_build.sh` for more details. The general steps are:
19+
20+
1. Download the official PAST release from [PoCC](https://sourceforge.net/projects/pocc/files/?source=navbar).
21+
2. Copy the binding C++ files and setup script.
22+
3. Build the Python wheel.
23+
24+
## Usage Example
25+
26+
Here’s a basic example of how to use the `past` package for verifying two programs:
27+
28+
```python
29+
def test_gemm():
30+
prog_a = "gemm/vanilla.c"
31+
prog_b = "gemm/acc-inter.c"
32+
out_var = "C"
33+
past.verify(prog_a, prog_b, out_var, debug=False, verbose=True)

0 commit comments

Comments
 (0)