Skip to main content

Python binding for the libusb C library (ctypes/cffi-based libusb).

Project description

libusb

Python binding for the libusb C library.

Overview

Python libusb module is a low-level binding for libusb C library.
It is an effort to allow python programs full access to the API implemented and provided by the well known *libusb* library.

libusb is a lightweight Python package, based on the ctypes library.
It is fully compliant implementation of the original C libusb 1.0 API by implementing whole its functionality in a clean Python instead of C.

libusb API 1.0 documentation can be found at:

libusb-1.0 API Reference

About original libusb:

Borrowed from the original website:

libusb - A cross-platform user library to access USB devices

Overview

libusb is a C library that provides generic access to USB devices. It is intended to be used by developers to facilitate the production of applications that communicate with USB hardware.

It is portable: Using a single cross-platform API, it provides access to USB devices on Linux, OS X, Windows, Android, OpenBSD, etc.

It is user-mode: No special privilege or elevation is required for the application to communicate with a device.

It is version-agnostic: All versions of the USB protocol, from 1.0 to 3.1 (latest), are supported.

What platforms are supported?

Linux, OS X, Windows, Windows CE, Android, OpenBSD/NetBSD, Haiku.

For additional information, please consult the FAQ or the Wiki.

Requirements

  • It is a fully independent package.
    All necessary things are installed during the normal installation process.
  • ATTENTION: currently works and tested only for Windows.

Installation

Prerequisites:

To install run:

python -m pip install --upgrade libusb

Development

Visit development page.

Installation from sources:

clone the sources:

git clone https://github.com/karpierz/libusb.git libusb

and run:

python -m pip install ./libusb

or on development mode:

python -m pip install --editable ./libusb

Prerequisites:

  • Development is strictly based on tox. To install it run:

    python -m pip install --upgrade tox

License

Copyright (c) 2016-2020 Adam Karpierz

Licensed under the zlib/libpng License
Please refer to the accompanying LICENSE file.

Authors

Changelog

1.0.23b1 (2020-09-15)

  • Upgrade for Windows: libusb v.1.0.22 -> v.1.0.23
    (partially; without libusb_wrap_sys_device, because
    original Windows dlls do not export this function).
  • Add support for Python 3.9.

  • Drop support for Python 3.5.

  • Setup update.

  • Cleanup.

1.0.22b9 (2020-01-17)

  • Added ReadTheDocs config file.

  • Setup update.

1.0.22b8 (2019-11-24)

  • Upgrade for Linux: libusb x64 v.1.0.21 -> v.1.0.22

  • Fix for error when the shared library is configured.

  • Cleanup.

1.0.22b6 (2019-11-23)

  • Initial support for Linux (libusb v.1.0.21 x64).

1.0.22b5 (2019-11-14)

  • Drop support for Python 2.

  • Drop support for Python 3.4.

  • Add support for Python 3.8.

  • Setup update and cleanup.

1.0.22b4 (2019-02-15)

  • Setup improvement.

  • Update required setuptools version.

  • Some updates of examples.

1.0.22b2 (2018-11-08)

  • Setup improvement.

  • Update required setuptools version.

1.0.22b1 (2018-03-30)

  • Upgrade to the libusb v.1.0.22

  • Setup improvement.

1.0.21b4 (2018-02-26)

  • Improve and simplify setup and packaging.

1.0.21b3 (2018-02-25)

  • Setup improvement.

1.0.21b2 (2017-12-18)

  • Fix the error of platform detecting.

1.0.21b1 (2017-10-11)

  • First beta release.

1.0.21a3 (2017-08-20)

  • Next alpha release.

1.0.21a0 (2016-09-24)

  • First alpha release.

0.0.1 (2016-09-23)

  • Initial release.

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

libusb-1.0.23b1.zip (250.8 kB view details)

Uploaded Source

File details

Details for the file libusb-1.0.23b1.zip.

File metadata

  • Download URL: libusb-1.0.23b1.zip
  • Upload date:
  • Size: 250.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.2.0 pkginfo/1.5.0.1 requests/2.24.0 setuptools/50.3.0 requests-toolbelt/0.9.1 tqdm/4.48.2 CPython/3.7.9

File hashes

Hashes for libusb-1.0.23b1.zip
Algorithm Hash digest
SHA256 39f227ac5ddf5e780402e6c1ee81bfdf396dc5c1365b3f127437ab1fde49590a
MD5 3d11771472e48a4dcdc9e68b3208a41f
BLAKE2b-256 8147781365251d0cebff6790b6dd3bb85b995442c8e23cf86d276d010d15037e

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