flacjacket / pywlroots

Python binding to the wlroots library using cffi
University of Illinois/NCSA Open Source License
53 stars 15 forks source link

pywlroots

|ci|

A Python binding to the wlroots library using cffi. The library uses pywayland to provide the Wayland bindings and python-xkbcommon_ to provide wlroots keyboard functionality.

.. _python-xkbcommon: https://github.com/sde1000/python-xkbcommon .. _pywayland: https://pywayland.readthedocs.io/en/latest/ .. _wlroots: https://gitlab.freedesktop.org/wlroots/wlroots/

Installation

The library can be installed from the packaged PyPI releases, which will pull in all of the necessary Python dependencies. In addition to the Python dependencies, pywlroots requires the wlroots and xkbcommon libraries and headers to be installed. At installation time, the cffi binding is compiled against these libraries.

To build pywlroots from source, the Python requirements will need to be installed manually. These are available in requirements.txt. The cffi bindings are built by running python wlroots/ffi_build.py.

Versioning and Releases

Released versions of pywlroots are published to PyPI_.

The major and minor versions of pywlroots denote the version of wlroots that it is compatibile with. The pywlroots patch version will denote changes and fixes on the given wlroots version.

.. _PyPI: https://pypi.org/project/pywlroots/

.. |ci| image:: https://github.com/flacjacket/pywlroots/actions/workflows/ci.yml/badge.svg :target: https://github.com/flacjacket/pywlroots/actions/workflows/ci.yml :alt: Build Status