Skip to main content

Python bindings for the libwayland library written in pure Python

Project description

Built against Wayland 1.17.0

Build Status Build Coverage Documentation Status

PyWayland provides a wrapper to the libwayland library using the CFFI library to provide access to the Wayland library calls and written in pure Python.

Below is outlined some of the basics of PyWayland and how to get up and running. For more help, see the full documentation.

Current Release

PyWayland is still in a developmental state. An initial version 0.2.1 is available on the cheese shop. Current development versions can be obtained from the git repository, feedback, as well as any bug reports or fixes are highly appreciated.

Dependencies

Installing PyWayland requires the Wayland library and the headers to be installed.

PyWayland requires the cffi package to be installed. PyWayland runs and is tested against Python 3.6+, including sufficient versions of PyPy3 (see Running Tests).

See the installation guide for more information on installing required dependencies

Installing

Installation can be done through pip to pull the most recently tagged release. To see instructions on running from sounce, see the relevant documentation on installing from source.

Building Wayland protocols

In order to run from source, you will need to generate the interfaces to the Wayland protocol objects as defined in the wayland.xml file. By default, this file will be located in /usr/share/wayland/wayland.xml. In this case, the protocol files can be generated by the scanner module:

$ python -m pywayland.scanner

See the help for this module to use non-default locations for the input and output of the scanner.

The scanner is installed as a script pywayland-scanner when PyWayland is installed. See pywayland-scanner -h for more information.

Running Tests

PyWayland implements a (currently limited) test-suite in ./tests. The tests can be run through pytest. Be sure you build the protocol files (see Building Wayland protocols) before running the tests.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pywayland-0.2.1.tar.gz (214.3 kB view details)

Uploaded Source

File details

Details for the file pywayland-0.2.1.tar.gz.

File metadata

  • Download URL: pywayland-0.2.1.tar.gz
  • Upload date:
  • Size: 214.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.15.0 pkginfo/1.4.2 requests/2.21.0 setuptools/41.5.1 requests-toolbelt/0.9.1 tqdm/4.33.0 CPython/3.6.9

File hashes

Hashes for pywayland-0.2.1.tar.gz
Algorithm Hash digest
SHA256 bbad26e2f18629d69fe542026c86450db27da8a760ee7cd6324d9a3d18632263
MD5 b828607b5b3406f6cf4eaa088178806e
BLAKE2b-256 748796f155d370d0826ea9d4e50f64f0e5c73bc135a08ca7a41a6bdc6aa84579

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page