| Name | xcffib JSON |
| Version |
1.10.0
JSON |
| download |
| home_page | None |
| Summary | xcffib is the XCB binding for python |
| upload_time | 2025-08-29 01:00:56 |
| maintainer | None |
| docs_url | None |
| author | None |
| requires_python | >=3.10 |
| license | Apache License 2.0 |
| keywords |
xcb
cffi
x11
x
windows
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# xcffib [](https://github.com/tych0/xcffib/actions)
`xcffib` is the XCB binding for Python.
## Installation
For most end users of software that depends on xcffib or developers writing
code against xcffib, you can use the version of xcffib on pypi. To install it,
you'll need libxcb's headers and libxcb-render's headers (these are available
via `sudo apt-get install libxcb-render0-dev` on Ubuntu). Once you have the C
headers installed, you can just `pip install xcffib`.
If you're interested in doing development, read on...
## Development dependencies
You should be able to install all the language deps from hackage or pip.
[.github/workflows/ci.yaml](https://github.com/tych0/xcffib/blob/master/.github/workflows/ci.yaml)
has an example of how to install the dependencies on Ubuntu flavors.
## Hacking
See the [Makefile](https://github.com/tych0/xcffib/blob/master/Makefile) for
examples on how to run the tests. Your contribution should at pass `make check`
before it can be merged. The `newtests` make target can be used to regenerate
expected haskell test data if the tests are failing because you made a change
to the generated python code.
### Hacking on new xcbproto versions
Sometimes (more often recently), xcbproto makes some updates that we need to
do some work for. These often require some updates to `xcb-types` as well.
First, hack your changes into `xcb-types` and `cabal install` them, then git
clone the version of xcbproto you want to somewhere, e.g. `~/packages`:
~/packages $ git clone https://gitlab.freedesktop.org/xorg/proto/xcbproto.git
Finally, you can build/test xcffib against this custom version of
`xcb-{proto|types}` with:
make XCBDIR=~/packages/xcbproto/src check
### Hacking on new xcb-types versions
To go along with new xcbproto elements, sometimes you need to hack on newer
versions of xcb-types. Newer cabals require you to do something like:
echo packages: ../xcb-types/xcb-types.cabal ./xcffib.cabal > cabal.project
In order to find locally modified versions of xcb-types.
Raw data
{
"_id": null,
"home_page": null,
"name": "xcffib",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.10",
"maintainer_email": null,
"keywords": "xcb, cffi, x11, x, windows",
"author": null,
"author_email": "Tycho Andersen <tycho@tycho.pizza>",
"download_url": "https://files.pythonhosted.org/packages/4a/8d/ebf61e169844f7a80d9f7faa602396ead94f8ac5dac1ad989fa129615dcb/xcffib-1.10.0.tar.gz",
"platform": null,
"description": "# xcffib [](https://github.com/tych0/xcffib/actions)\n\n`xcffib` is the XCB binding for Python.\n\n## Installation\n\nFor most end users of software that depends on xcffib or developers writing\ncode against xcffib, you can use the version of xcffib on pypi. To install it,\nyou'll need libxcb's headers and libxcb-render's headers (these are available\nvia `sudo apt-get install libxcb-render0-dev` on Ubuntu). Once you have the C\nheaders installed, you can just `pip install xcffib`.\n\nIf you're interested in doing development, read on...\n\n## Development dependencies\n\nYou should be able to install all the language deps from hackage or pip.\n[.github/workflows/ci.yaml](https://github.com/tych0/xcffib/blob/master/.github/workflows/ci.yaml)\nhas an example of how to install the dependencies on Ubuntu flavors.\n\n## Hacking\n\nSee the [Makefile](https://github.com/tych0/xcffib/blob/master/Makefile) for\nexamples on how to run the tests. Your contribution should at pass `make check`\nbefore it can be merged. The `newtests` make target can be used to regenerate\nexpected haskell test data if the tests are failing because you made a change\nto the generated python code.\n\n### Hacking on new xcbproto versions\n\nSometimes (more often recently), xcbproto makes some updates that we need to\ndo some work for. These often require some updates to `xcb-types` as well.\nFirst, hack your changes into `xcb-types` and `cabal install` them, then git\nclone the version of xcbproto you want to somewhere, e.g. `~/packages`:\n\n ~/packages $ git clone https://gitlab.freedesktop.org/xorg/proto/xcbproto.git\n\nFinally, you can build/test xcffib against this custom version of\n`xcb-{proto|types}` with:\n\n make XCBDIR=~/packages/xcbproto/src check\n\n### Hacking on new xcb-types versions\n\nTo go along with new xcbproto elements, sometimes you need to hack on newer\nversions of xcb-types. Newer cabals require you to do something like:\n\n echo packages: ../xcb-types/xcb-types.cabal ./xcffib.cabal > cabal.project\n\nIn order to find locally modified versions of xcb-types.\n",
"bugtrack_url": null,
"license": "Apache License 2.0",
"summary": "xcffib is the XCB binding for python",
"version": "1.10.0",
"project_urls": {
"Homepage": "http://github.com/tych0/xcffib"
},
"split_keywords": [
"xcb",
" cffi",
" x11",
" x",
" windows"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "4a8debf61e169844f7a80d9f7faa602396ead94f8ac5dac1ad989fa129615dcb",
"md5": "de28655bea52136c5f44eaeddf57db32",
"sha256": "ce07b13c32e25e65a3935dcba762772bdac72e3d1979082321802f6acbbff5c6"
},
"downloads": -1,
"filename": "xcffib-1.10.0.tar.gz",
"has_sig": false,
"md5_digest": "de28655bea52136c5f44eaeddf57db32",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10",
"size": 111521,
"upload_time": "2025-08-29T01:00:56",
"upload_time_iso_8601": "2025-08-29T01:00:56.604818Z",
"url": "https://files.pythonhosted.org/packages/4a/8d/ebf61e169844f7a80d9f7faa602396ead94f8ac5dac1ad989fa129615dcb/xcffib-1.10.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-08-29 01:00:56",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "tych0",
"github_project": "xcffib",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "xcffib"
}
