libusb

Python binding for the libusb C library.

These details have not been verified by PyPI

Project links

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

libusb uses the underlying libusb C shared library as specified in libusb.cfg (included libusb-X.X.* is the default), but there is also ability to specify it programmatically by one of the following ways:

import libusb
libusb.config(LIBUSB="libusb C shared library absolute path")
# or
libusb.config(LIBUSB=None)  # included libusb-X.X.* will be use

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:

Python 3.6 or higher
- https://www.python.org/
- 3.7 with C libusb 1.0.22 is a primary test environment.
pip and setuptools
- https://pypi-hypernode.com/project/pip/
- https://pypi-hypernode.com/project/setuptools/

To install run:

python -m pip install --upgrade libusb

Development

Prerequisites:

Development is strictly based on tox. To install it run:
```
python -m pip install --upgrade tox
```

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

License

Copyright (c) 2016-2020 Adam Karpierz

Licensed under the zlib/libpng License

https://opensource.org/licenses/Zlib

Please refer to the accompanying LICENSE file.

Authors

Adam Karpierz <adam@karpierz.net>

Changelog

1.0.23b7 (2020-11-19)

Ability to specify the underlying shared library programmatically.
General update and cleanup.
Setup update.
Removing dependence on atpublic.
Fixed docs setup.
Fix for hotplugtest example.

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

These details have not been verified by PyPI

Project links

Release history Release notifications | RSS feed

1.0.27.post3

Oct 9, 2024

1.0.27.post2

Sep 30, 2024

1.0.27.post1

Aug 15, 2024

1.0.27

Feb 5, 2024

1.0.26

Feb 5, 2024

1.0.26rc4 pre-release

Jan 27, 2024

1.0.26rc2 pre-release

Dec 20, 2023

1.0.26rc1 pre-release

Dec 18, 2023

1.0.26b5 pre-release

Sep 11, 2022

1.0.26b4 pre-release

Aug 25, 2022

1.0.26b3 pre-release

Jul 28, 2022

1.0.26b2 pre-release

Jul 18, 2022

1.0.24b3 pre-release

Jan 10, 2022

1.0.24b1 pre-release

Nov 10, 2021

This version

1.0.23b7 pre-release

Nov 19, 2020

1.0.23b1 pre-release

Sep 16, 2020

1.0.22b9 pre-release

Jan 17, 2020

1.0.22b8 pre-release

Nov 24, 2019

1.0.22b5 pre-release

Nov 14, 2019

1.0.22b4 pre-release

Feb 16, 2019

1.0.22b2 pre-release

Nov 9, 2018

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.23b7.zip (251.8 kB view details)

Uploaded Nov 19, 2020 Source

File details

Details for the file libusb-1.0.23b7.zip.

File metadata

Download URL: libusb-1.0.23b7.zip
Upload date: Nov 19, 2020
Size: 251.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.1 requests-toolbelt/0.9.1 tqdm/4.50.2 CPython/3.7.9

File hashes

Hashes for libusb-1.0.23b7.zip
Algorithm	Hash digest
SHA256	`dbc6622f1e9145b1cbb7a397c68ccfe04cdb65a5d3475c56d689390008ade394`
MD5	`be8d43f0d4d973c5dd46a84dd9cf5940`
BLAKE2b-256	`bf95f8e4eb37bd8ce02aff9dba1cff8823498f18366866ab769ced916ce68315`