Skip to content

Commit 057d0be

Browse files
update README.md
1 parent 84c9da9 commit 057d0be

File tree

1 file changed

+9
-50
lines changed

1 file changed

+9
-50
lines changed

README.md

Lines changed: 9 additions & 50 deletions
Original file line numberDiff line numberDiff line change
@@ -1,23 +1,10 @@
1-
# cmake_example for pybind11
2-
3-
An example [pybind11](https://github.com/pybind/pybind11) module built with a
4-
CMake-based build system. This is useful for C++ codebases that have an
5-
existing CMake project structure. This is being replaced by
6-
[`scikit_build_example`](https://github.com/pybind/scikit_build_example), which uses
7-
[scikit-build-core][], which is designed to allow Python
8-
packages to be driven from CMake without depending on setuptools. The approach here has
9-
some trade-offs not present in a pure setuptools build (see
10-
[`python_example`](https://github.com/pybind/python_example)) or scikit-build-core. Python 3.7+ required;
11-
see the commit history for older versions of Python.
12-
13-
Problems vs. scikit-build-core based example:
14-
15-
- You have to manually copy fixes/additions when they get added to this example (like when Apple Silicon support was added)
16-
- Modern editable installs are not supported (scikit-build-core doesn't support them either yet, but probably will soon)
17-
- You are depending on setuptools, which can and will change
18-
- You are stuck with an all-or-nothing approach to adding cmake/ninja via wheels (scikit-build-core adds these only as needed, so it can be used on BSD, Cygwin, Pyodide, Android, etc)
19-
- You are stuck with whatever CMake ships with (scikit-build-core backports FindPython for you)
1+
# Py-libbpf
2+
This library provides Python bindings for libbpf on Linux to make loading of eBPF object files easier. This is meant to
3+
be used along with `pythonbpf`, the eBPF Python DSL compiler. This library makes it possible to attach these programs to
4+
events in the kernel right from inside Python.
205

6+
# Warning
7+
IN DEVELOPMENT. DO NOT USE.
218

229
## Prerequisites
2310

@@ -32,40 +19,12 @@ Just clone this repository and pip install. Note the `--recursive` option which
3219
needed for the pybind11 submodule:
3320

3421
```bash
35-
git clone --recursive https://github.com/pybind/cmake_example.git
36-
pip install ./cmake_example
22+
git clone --recursive https://github.com/varun-r-mallya/pylibbpf.git
23+
pip install .
3724
```
3825

3926
With the `setup.py` file included in this example, the `pip install` command will
4027
invoke CMake and build the pybind11 module as specified in `CMakeLists.txt`.
4128

42-
43-
4429
## Building the documentation
45-
46-
Documentation for the example project is generated using Sphinx. Sphinx has the
47-
ability to automatically inspect the signatures and documentation strings in
48-
the extension module to generate beautiful documentation in a variety formats.
49-
The following command generates HTML-based reference documentation; for other
50-
formats please refer to the Sphinx manual:
51-
52-
- `cd cmake_example/docs`
53-
- `make html`
54-
55-
56-
## License
57-
58-
Pybind11 is provided under a BSD-style license that can be found in the LICENSE
59-
file. By using, distributing, or contributing to this project, you agree to the
60-
terms and conditions of this license.
61-
62-
63-
## Test call
64-
65-
```python
66-
import cmake_example
67-
cmake_example.add(1, 2)
68-
```
69-
70-
[`cibuildwheel`]: https://cibuildwheel.readthedocs.io
71-
[scikit-build-core]: https://github.com/scikit-build/scikit-build-core
30+
The documentation here is still boilerplate.

0 commit comments

Comments
 (0)