Metadata-Version: 2.1
Name: pywlroots
Version: 0.15.18
Summary: Python binding to the wlroots library using cffi
Home-page: https://github.com/flacjacket/pywlroots
Author: Sean Vig
Author-email: sean.v.775@gmail.com
License: MIT
Project-URL: Code, https://github.com/flacjacket/pywlroots/
Project-URL: Issue tracker, https://github.com/flacjacket/pywlroots/issues
Platform: UNKNOWN
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Operating System :: POSIX
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Programming Language :: Python :: Implementation :: PyPy
Classifier: Topic :: Desktop Environment :: Window Managers
Classifier: Topic :: Software Development :: Libraries
Description-Content-Type: text/x-rst
License-File: LICENSE
Requires-Dist: cffi (>=1.12.0)
Requires-Dist: pywayland (>=0.1.1)
Requires-Dist: xkbcommon (>=0.2)
Provides-Extra: test
Requires-Dist: pytest ; extra == 'test'

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://github.com/swaywm/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


