######
pyudev
######
.. image:: https://secure.travis-ci.org/pyudev/pyudev.png?branch=develop
:target: http://travis-ci.org/pyudev/pyudev
http://pyudev.readthedocs.org
pyudev is a LGPL_ licensed, pure Python_ binding for libudev_, the device and
hardware management and information library for Linux. It supports almost all
libudev_ functionality. You can enumerate devices, query device properties and
attributes or monitor devices, including asynchronous monitoring with threads,
or within the event loops of Qt, Glib or wxPython.
The binding supports CPython_ 3 and compatible versions of PyPy_.
It is tested against udev 151 or newer, earlier versions of udev
as found on dated Linux systems may work, but are not officially supported.
Usage
-----
Usage of pyudev is quite simply thanks to the power of the underlying udev
library. Getting the labels of all partitions just takes a few lines:
>>> import pyudev
>>> context = pyudev.Context()
>>> for device in context.list_devices(subsystem='block', DEVTYPE='partition'):
... print(device.get('ID_FS_LABEL', 'unlabeled partition'))
...
boot
swap
system
The website_ provides a detailed `user guide`_ and a complete `API reference`_.
Support
-------
Please report issues and questions to the issue tracker, but respect the
following guidelines:
- Check that the issue has not already been reported.
- Check that the issue is not already fixed in the ``master`` branch.
- Open issues with clear title and a detailed description in grammatically
correct, complete sentences.
- Include the Python version and the udev version (see ``udevadm --version``) in
the description of your issue.
Development
-----------
The source code is hosted on GitHub_::
git clone git://github.com/pyudev/pyudev.git
Please fork the repository and send pull requests with your fixes or new
features, but respect the following guidelines:
- Read `how to properly contribute to open source projects on GitHub
<http://gun.io/blog/how-to-github-fork-branch-and-pull-request/>`_.
- Understand the `branching model
<http://nvie.com/posts/a-successful-git-branching-model/>`_.
- Write `good commit messages
<http://tbaggery.com/2008/04/19/a-note-about-git-commit-messages.html>`_.
- Add unit tests if possible (refer to the `testsuite documentation
<http://pyudev.readthedocs.org/en/latest/tests/index.html>`_).
- Add API documentation in docstrings.
- Open a `pull request <https://help.github.com/articles/using-pull-requests>`_
that relates to but one subject with a clear title and description in
grammatically correct, complete sentences.
.. _LGPL: http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html
.. _Python: http://www.python.org/
.. _CPython: http://www.python.org/
.. _PyPy: http://www.pypy.org/
.. _libudev: https://www.freedesktop.org/software/systemd/man/libudev.html
.. _website: http://pyudev.readthedocs.org
.. _user guide: http://pyudev.readthedocs.org/en/latest/guide.html
.. _api reference: http://pyudev.readthedocs.org/en/latest/api/index.html
.. _issue tracker: http://github.com/pyudev/pyudev/issues
.. _GitHub: http://github.com/pyudev/pyudev
.. _git: http://www.git-scm.com/
Request a New Release
---------------------
I will be doing regular releases of this project every August and October,
shortly after Fedora releases are branched from rawhide.
If you believe an extra release would help you in some way, please file an
issue, explaining why you need the new release, and I expect I'll put one up.
Why should you explain why you need the new release? Well, it is helpful to me,
because pyudev is not at all part of my regular work, and I tend not to know
very much about how it is used these days.
Raw data
{
"_id": null,
"home_page": "http://github.com/pyudev/pyudev",
"name": "pyudev",
"maintainer": null,
"docs_url": "https://pythonhosted.org/pyudev/",
"requires_python": ">=3.7",
"maintainer_email": null,
"keywords": null,
"author": "Sebastian Wiesner",
"author_email": "lunaryorn@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/c4/5c/6cc034da13830e3da123ccf9a30910bc868fa16670362f004e4b788d0df1/pyudev-0.24.3.tar.gz",
"platform": "Linux",
"description": "######\npyudev\n######\n\n.. image:: https://secure.travis-ci.org/pyudev/pyudev.png?branch=develop\n :target: http://travis-ci.org/pyudev/pyudev\n\nhttp://pyudev.readthedocs.org\n\npyudev is a LGPL_ licensed, pure Python_ binding for libudev_, the device and\nhardware management and information library for Linux. It supports almost all\nlibudev_ functionality. You can enumerate devices, query device properties and\nattributes or monitor devices, including asynchronous monitoring with threads,\nor within the event loops of Qt, Glib or wxPython.\n\nThe binding supports CPython_ 3 and compatible versions of PyPy_.\nIt is tested against udev 151 or newer, earlier versions of udev\nas found on dated Linux systems may work, but are not officially supported.\n\n\nUsage\n-----\n\nUsage of pyudev is quite simply thanks to the power of the underlying udev\nlibrary. Getting the labels of all partitions just takes a few lines:\n\n>>> import pyudev\n>>> context = pyudev.Context()\n>>> for device in context.list_devices(subsystem='block', DEVTYPE='partition'):\n... print(device.get('ID_FS_LABEL', 'unlabeled partition'))\n...\nboot\nswap\nsystem\n\nThe website_ provides a detailed `user guide`_ and a complete `API reference`_.\n\n\nSupport\n-------\n\nPlease report issues and questions to the issue tracker, but respect the\nfollowing guidelines:\n\n- Check that the issue has not already been reported.\n- Check that the issue is not already fixed in the ``master`` branch.\n- Open issues with clear title and a detailed description in grammatically\n correct, complete sentences.\n- Include the Python version and the udev version (see ``udevadm --version``) in\n the description of your issue.\n\n\nDevelopment\n-----------\n\nThe source code is hosted on GitHub_::\n\n git clone git://github.com/pyudev/pyudev.git\n\nPlease fork the repository and send pull requests with your fixes or new\nfeatures, but respect the following guidelines:\n\n- Read `how to properly contribute to open source projects on GitHub\n <http://gun.io/blog/how-to-github-fork-branch-and-pull-request/>`_.\n- Understand the `branching model\n <http://nvie.com/posts/a-successful-git-branching-model/>`_.\n- Write `good commit messages\n <http://tbaggery.com/2008/04/19/a-note-about-git-commit-messages.html>`_.\n- Add unit tests if possible (refer to the `testsuite documentation\n <http://pyudev.readthedocs.org/en/latest/tests/index.html>`_).\n- Add API documentation in docstrings.\n- Open a `pull request <https://help.github.com/articles/using-pull-requests>`_\n that relates to but one subject with a clear title and description in\n grammatically correct, complete sentences.\n\n\n.. _LGPL: http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html\n.. _Python: http://www.python.org/\n.. _CPython: http://www.python.org/\n.. _PyPy: http://www.pypy.org/\n.. _libudev: https://www.freedesktop.org/software/systemd/man/libudev.html\n.. _website: http://pyudev.readthedocs.org\n.. _user guide: http://pyudev.readthedocs.org/en/latest/guide.html\n.. _api reference: http://pyudev.readthedocs.org/en/latest/api/index.html\n.. _issue tracker: http://github.com/pyudev/pyudev/issues\n.. _GitHub: http://github.com/pyudev/pyudev\n.. _git: http://www.git-scm.com/\n\n\nRequest a New Release\n---------------------\nI will be doing regular releases of this project every August and October,\nshortly after Fedora releases are branched from rawhide.\n\nIf you believe an extra release would help you in some way, please file an\nissue, explaining why you need the new release, and I expect I'll put one up.\n\nWhy should you explain why you need the new release? Well, it is helpful to me,\nbecause pyudev is not at all part of my regular work, and I tend not to know\nvery much about how it is used these days.\n",
"bugtrack_url": null,
"license": "LGPL 2.1+",
"summary": "A libudev binding",
"version": "0.24.3",
"project_urls": {
"Homepage": "http://github.com/pyudev/pyudev"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "9d3bc37870f68ceb067707ca7b04db364a1478fcd40c6194007fb6e492ff9a92",
"md5": "648a134d9740cc590fcdeafc9d43157c",
"sha256": "e8246f0a014fe370119ba2bc781bfbe62c0298d0d6b39c94e83102a8a3f56960"
},
"downloads": -1,
"filename": "pyudev-0.24.3-py3-none-any.whl",
"has_sig": false,
"md5_digest": "648a134d9740cc590fcdeafc9d43157c",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.7",
"size": 62677,
"upload_time": "2024-05-10T18:24:02",
"upload_time_iso_8601": "2024-05-10T18:24:02.743464Z",
"url": "https://files.pythonhosted.org/packages/9d/3b/c37870f68ceb067707ca7b04db364a1478fcd40c6194007fb6e492ff9a92/pyudev-0.24.3-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "c45c6cc034da13830e3da123ccf9a30910bc868fa16670362f004e4b788d0df1",
"md5": "07bbe9111308d2509645705b8321c416",
"sha256": "2e945427a21674893bb97632401db62139d91cea1ee96137cc7b07ad22198fc7"
},
"downloads": -1,
"filename": "pyudev-0.24.3.tar.gz",
"has_sig": false,
"md5_digest": "07bbe9111308d2509645705b8321c416",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.7",
"size": 55970,
"upload_time": "2024-05-10T18:24:04",
"upload_time_iso_8601": "2024-05-10T18:24:04.599815Z",
"url": "https://files.pythonhosted.org/packages/c4/5c/6cc034da13830e3da123ccf9a30910bc868fa16670362f004e4b788d0df1/pyudev-0.24.3.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-05-10 18:24:04",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "pyudev",
"github_project": "pyudev",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "pyudev"
}
JSON
