libusb 1.0.27__zip → 1.0.27.post1__zip

{libusb-1.0.27 → libusb-1.0.27.post1}/.readthedocs.yml

@@ -2,7 +2,7 @@ version: 2
 build:
   os: "ubuntu-22.04"
   tools:
-    python: "3.11"
+    python: "3.12"
 python:
   install:
     - method: pip

{libusb-1.0.27 → libusb-1.0.27.post1}/CHANGES.rst

@@ -1,6 +1,13 @@
 Changelog
 =========
 
+1.0.27.post1 (2024-08-13)
+-------------------------
+- Add support for Python 3.13
+- Setup (dependencies) update.
+- Improvements and cleanup for win32.
+- Source code refactoring and cleanup.
+
 1.0.27 (2024-02-05)
 -------------------
 - | The API has been fully updated to version 1.0.27 (libusb v.1.0.27

{libusb-1.0.27 → libusb-1.0.27.post1}/MANIFEST.in

@@ -1,6 +1,5 @@
 # Copyright (c) 2016 Adam Karpierz
-# Licensed under the zlib/libpng License
-# https://opensource.org/license/zlib
+# SPDX-License-Identifier: Zlib
 
 include README.rst
 include CHANGES.rst

{libusb-1.0.27 → libusb-1.0.27.post1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: libusb
-Version: 1.0.27
+Version: 1.0.27.post1
 Summary: Python binding for the libusb C library.
 Author: Adam Karpierz
 Author-email: adam@karpierz.net
@@ -26,27 +26,28 @@ Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
 Classifier: Programming Language :: Python :: 3 :: Only
 Classifier: Programming Language :: Python :: Implementation :: CPython
 Classifier: Programming Language :: Python :: Implementation :: PyPy
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
-Requires-Python: <4.0.0,>=3.8.1
+Requires-Python: <4.0.0,>=3.8.10
 Description-Content-Type: text/x-rst; charset=UTF-8
 License-File: LICENSE
-Requires-Dist: setuptools>=68.2.2
-Requires-Dist: pkg-about>=1.1.5
+Requires-Dist: setuptools>=72.2.0
+Requires-Dist: pkg-about>=1.1.8
 Provides-Extra: doc
 Requires-Dist: Sphinx>=7.1.2; extra == "doc"
-Requires-Dist: sphinx-toolbox>=3.5.0; extra == "doc"
-Requires-Dist: sphinx-tabs>=3.4.1; extra == "doc"
-Requires-Dist: sphinx-copybutton>=0.5.1; extra == "doc"
-Requires-Dist: sphinxcontrib-spelling>=7.7.0; extra == "doc"
-Requires-Dist: sphinx-lint>=0.6.7; extra == "doc"
+Requires-Dist: sphinx-toolbox>=3.7.0; extra == "doc"
+Requires-Dist: sphinx-tabs>=3.4.5; extra == "doc"
+Requires-Dist: sphinx-copybutton>=0.5.2; extra == "doc"
+Requires-Dist: sphinxcontrib-spelling>=8.0.0; extra == "doc"
+Requires-Dist: sphinx-lint>=0.9.1; extra == "doc"
 Requires-Dist: restructuredtext-lint>=1.4.0; extra == "doc"
-Requires-Dist: nbsphinx>=0.8.10; extra == "doc"
+Requires-Dist: nbsphinx>=0.9.4; extra == "doc"
 Provides-Extra: test
-Requires-Dist: deepdiff>=6.7.1; extra == "test"
-Requires-Dist: rich>=13.7.0; extra == "test"
+Requires-Dist: deepdiff>=7.0.1; extra == "test"
+Requires-Dist: rich>=13.7.1; extra == "test"
 
 libusb
 ======
@@ -128,7 +129,7 @@ Prerequisites:
 + Python 3.8 or higher
 
   * https://www.python.org/
-  * with C libusb 1.0.26 is a primary test environment.
+  * with C libusb 1.0.27 is a primary test environment.
 
 + pip and setuptools
 
@@ -196,6 +197,13 @@ Authors
 Changelog
 =========
 
+1.0.27.post1 (2024-08-13)
+-------------------------
+- Add support for Python 3.13
+- Setup (dependencies) update.
+- Improvements and cleanup for win32.
+- Source code refactoring and cleanup.
+
 1.0.27 (2024-02-05)
 -------------------
 - | The API has been fully updated to version 1.0.27 (libusb v.1.0.27

{libusb-1.0.27 → libusb-1.0.27.post1}/README.rst

@@ -78,7 +78,7 @@ Prerequisites:
 + Python 3.8 or higher
 
   * https://www.python.org/
-  * with C libusb 1.0.26 is a primary test environment.
+  * with C libusb 1.0.27 is a primary test environment.
 
 + pip and setuptools
 

libusb-1.0.27.post1/examples/_win32.py

@@ -0,0 +1,149 @@
+# Copyright (c) 2013 Adam Karpierz
+# SPDX-License-Identifier: Zlib
+
+import ctypes
+from ctypes import windll
+from ctypes import wintypes
+from ctypes import WINFUNCTYPE
+from ctypes.wintypes import (
+    CHAR, WCHAR, BOOLEAN, BOOL, BYTE, WORD, DWORD, SHORT, USHORT, INT,
+    UINT, LONG, ULONG, LARGE_INTEGER, ULARGE_INTEGER, FLOAT, DOUBLE,
+    LPBYTE, PBYTE, LPWORD, PWORD, LPDWORD, PDWORD, LPLONG, PLONG, LPSTR,
+    LPCSTR, LPVOID, LPCVOID, LPVOID as PVOID, HANDLE, LPHANDLE, PHANDLE,
+    WPARAM, LPARAM, FILETIME, LPFILETIME,
+)
+
+from ctypes.wintypes import WPARAM as ULONG_PTR # workaround
+PULONG_PTR = ctypes.POINTER(ULONG_PTR)
+
+ULONG32   = ctypes.c_uint32
+ULONGLONG = ctypes.c_uint64
+DWORDLONG = ctypes.c_uint64
+SIZE_T    = ctypes.c_size_t
+
+WAIT_ABANDONED = 0x00000080
+WAIT_OBJECT_0  = 0x00000000
+WAIT_TIMEOUT   = 0x00000102
+WAIT_FAILED    = 0xFFFFFFFF
+
+IGNORE   = 0
+INFINITE = 0xFFFFFFFF
+
+FORMAT_MESSAGE_ALLOCATE_BUFFER = 0x00000100
+FORMAT_MESSAGE_ARGUMENT_ARRAY  = 0x00002000
+FORMAT_MESSAGE_FROM_HMODULE    = 0x00000800
+FORMAT_MESSAGE_FROM_STRING     = 0x00000400
+FORMAT_MESSAGE_FROM_SYSTEM     = 0x00001000
+FORMAT_MESSAGE_IGNORE_INSERTS  = 0x00000200
+FORMAT_MESSAGE_MAX_WIDTH_MASK  = 0x000000FF
+
+GetCurrentProcess = windll.kernel32.GetCurrentProcess
+GetCurrentProcess.restype  = HANDLE
+GetCurrentProcess.argtypes = []
+
+GetProcessTimes = windll.kernel32.GetProcessTimes
+GetProcessTimes.restype  = BOOL
+GetProcessTimes.argtypes = [HANDLE,
+                            LPFILETIME,
+                            LPFILETIME,
+                            LPFILETIME,
+                            LPFILETIME]
+
+class SECURITY_ATTRIBUTES(ctypes.Structure):
+    _fields_ = [
+    ("nLength",              DWORD),
+    ("lpSecurityDescriptor", LPVOID),
+    ("bInheritHandle",       BOOL),
+]
+LPSECURITY_ATTRIBUTES = ctypes.POINTER(SECURITY_ATTRIBUTES)
+
+LPTHREAD_START_ROUTINE = WINFUNCTYPE(DWORD, LPVOID)
+CreateThread = windll.kernel32.CreateThread
+CreateThread.restype  = HANDLE
+CreateThread.argtypes = [LPSECURITY_ATTRIBUTES,
+                         SIZE_T,
+                         LPTHREAD_START_ROUTINE,
+                         LPVOID,
+                         DWORD,
+                         LPDWORD]
+
+WaitForSingleObject = windll.kernel32.WaitForSingleObject
+WaitForSingleObject.restype  = DWORD
+WaitForSingleObject.argtypes = [HANDLE,
+                                DWORD]
+
+SetEvent = windll.kernel32.SetEvent
+SetEvent.restype  = BOOL
+SetEvent.argtypes = [HANDLE]
+
+CreateSemaphore = windll.kernel32.CreateSemaphoreA
+CreateSemaphore.restype  = HANDLE
+CreateSemaphore.argtypes = [LPSECURITY_ATTRIBUTES,
+                            LONG,
+                            LONG,
+                            LPCSTR]
+
+ReleaseSemaphore = windll.kernel32.ReleaseSemaphore
+ReleaseSemaphore.restype  = BOOL
+ReleaseSemaphore.argtypes = [HANDLE,
+                             LONG,
+                             LPLONG]
+
+Sleep = windll.kernel32.Sleep
+Sleep.restype  = None
+Sleep.argtypes = [DWORD]
+
+PHANDLER_ROUTINE = WINFUNCTYPE(BOOL, DWORD)
+SetConsoleCtrlHandler = windll.kernel32.SetConsoleCtrlHandler
+SetConsoleCtrlHandler.restype  = BOOL
+SetConsoleCtrlHandler.argtypes = [PHANDLER_ROUTINE,
+                                  BOOL]
+
+CloseHandle = windll.kernel32.CloseHandle
+CloseHandle.restype  = BOOL
+CloseHandle.argtypes = [HANDLE]
+
+GetLastError = windll.kernel32.GetLastError
+GetLastError.restype  = DWORD
+GetLastError.argtypes = []
+
+FormatMessageA = windll.kernel32.FormatMessageA
+FormatMessageA.restype  = DWORD
+FormatMessageA.argtypes = [DWORD,
+                           LPCVOID,
+                           DWORD,
+                           DWORD,
+                           LPSTR,
+                           DWORD,
+                           LPVOID]
+
+class SYSTEMTIME(ctypes.Structure):
+    _fields_ = [
+    ("wYear",         WORD),
+    ("wMonth",        WORD),
+    ("wDayOfWeek",    WORD),
+    ("wDay",          WORD),
+    ("wHour",         WORD),
+    ("wMinute",       WORD),
+    ("wSecond",       WORD),
+    ("wMilliseconds", WORD),
+]
+LPSYSTEMTIME = ctypes.POINTER(SYSTEMTIME)
+
+GetLocalTime = windll.kernel32.GetLocalTime
+GetLocalTime.restype  = None
+GetLocalTime.argtypes = [LPSYSTEMTIME]
+
+SetLocalTime = windll.kernel32.SetLocalTime
+SetLocalTime.restype  = BOOL
+SetLocalTime.argtypes = [LPSYSTEMTIME]
+
+GetSystemTime = windll.kernel32.GetSystemTime
+GetSystemTime.restype  = None
+GetSystemTime.argtypes = [LPSYSTEMTIME]
+
+SetSystemTime = windll.kernel32.SetSystemTime
+SetSystemTime.restype  = BOOL
+SetSystemTime.argtypes = [LPSYSTEMTIME]
+
+del ctypes

{libusb-1.0.27 → libusb-1.0.27.post1}/examples/dpfp.py

@@ -1,6 +1,5 @@
 # Copyright (c) 2016 Adam Karpierz
-# Licensed under the zlib/libpng License
-# https://opensource.org/license/zlib
+# SPDX-License-Identifier: Zlib
 
 # libusb example program to manipulate U.are.U 4000B fingerprint scanner.
 # Copyright © 2007 Daniel Drake <dsd@gentoo.org>
@@ -32,7 +31,7 @@ import ctypes as ct
 
 import libusb as usb
 from libusb._platform import defined, is_posix, is_windows
-if is_windows: import win32
+if is_windows: import _win32 as win32
 
 usb_strerror = lambda r: usb.strerror(r).decode("utf-8")
 

{libusb-1.0.27 → libusb-1.0.27.post1}/examples/dpfp_threaded.py

@@ -1,6 +1,5 @@
 # Copyright (c) 2016 Adam Karpierz
-# Licensed under the zlib/libpng License
-# https://opensource.org/license/zlib
+# SPDX-License-Identifier: Zlib
 
 # libusb example program to manipulate U.are.U 4000B fingerprint scanner.
 # Copyright © 2007 Daniel Drake <dsd@gentoo.org>

{libusb-1.0.27 → libusb-1.0.27.post1}/examples/ezusb.py

@@ -1,6 +1,5 @@
 # Copyright (c) 2016 Adam Karpierz
-# Licensed under the zlib/libpng License
-# https://opensource.org/license/zlib
+# SPDX-License-Identifier: Zlib
 
 # Copyright © 2001 Stephen Williams (steve@icarus.com)
 # Copyright © 2001-2002 David Brownell (dbrownell@users.sourceforge.net)

{libusb-1.0.27 → libusb-1.0.27.post1}/examples/fxload.py

@@ -1,6 +1,5 @@
 # Copyright (c) 2016 Adam Karpierz
-# Licensed under the zlib/libpng License
-# https://opensource.org/license/zlib
+# SPDX-License-Identifier: Zlib
 
 # Copyright © 2001 Stephen Williams (steve@icarus.com)
 # Copyright © 2001-2002 David Brownell (dbrownell@users.sourceforge.net)

{libusb-1.0.27 → libusb-1.0.27.post1}/examples/hotplugtest.py

@@ -1,6 +1,5 @@
 # Copyright (c) 2016 Adam Karpierz
-# Licensed under the zlib/libpng License
-# https://opensource.org/license/zlib
+# SPDX-License-Identifier: Zlib
 
 # libusb example program for hotplug API
 # Copyright © 2012-2013 Nathan Hjelm <hjelmn@mac.com>

{libusb-1.0.27 → libusb-1.0.27.post1}/examples/listdevs.py

@@ -1,6 +1,5 @@
 # Copyright (c) 2016 Adam Karpierz
-# Licensed under the zlib/libpng License
-# https://opensource.org/license/zlib
+# SPDX-License-Identifier: Zlib
 
 # libusb example program to list devices on the bus
 # Copyright © 2007 Daniel Drake <dsd@gentoo.org>

{libusb-1.0.27 → libusb-1.0.27.post1}/examples/sam3u_benchmark.py

@@ -1,6 +1,5 @@
 # Copyright (c) 2016 Adam Karpierz
-# Licensed under the zlib/libpng License
-# https://opensource.org/license/zlib
+# SPDX-License-Identifier: Zlib
 
 # libusb example program to measure Atmel SAM3U isochronous performance
 # Copyright (C) 2012 Harald Welte <laforge@gnumonks.org>

{libusb-1.0.27 → libusb-1.0.27.post1}/examples/testlibusb.py

@@ -1,6 +1,5 @@
 # Copyright (c) 2016 Adam Karpierz
-# Licensed under the zlib/libpng License
-# https://opensource.org/license/zlib
+# SPDX-License-Identifier: Zlib
 
 # Test suite program based of libusb-0.1-compat testlibusb
 # Copyright (c) 2013 Nathan Hjelm <hjelmn@mac.ccom>

{libusb-1.0.27 → libusb-1.0.27.post1}/examples/xusb.py

@@ -1,6 +1,5 @@
 # Copyright (c) 2016 Adam Karpierz
-# Licensed under the zlib/libpng License
-# https://opensource.org/license/zlib
+# SPDX-License-Identifier: Zlib
 
 # xusb: Generic USB test program
 # Copyright © 2009-2012 Pete Batard <pete@akeo.ie>
@@ -27,7 +26,7 @@ import ctypes as ct
 
 import libusb as usb
 from libusb._platform import is_windows
-if is_windows: import win32
+if is_windows: import _win32 as win32
 
 usb_strerror   = lambda r: usb.strerror(r).decode("utf-8")
 usb_error_name = lambda status: usb.error_name(status).decode("utf-8")

{libusb-1.0.27 → libusb-1.0.27.post1}/pyproject.toml

@@ -1,14 +1,13 @@
 # Copyright (c) 2016 Adam Karpierz
-# Licensed under the zlib/libpng License
-# https://opensource.org/license/zlib
+# SPDX-License-Identifier: Zlib
 
 [build-system]
 build-backend = 'setuptools.build_meta'
-requires = ['setuptools>=68.2.2', 'wheel>=0.42.0', 'packaging>=23.2.0', 'tox>=4.11.3']
+requires = ['setuptools>=72.2.0', 'wheel>=0.44.0', 'packaging>=24.1.0', 'tox>=4.18.0']
 
 [project]
 name        = 'libusb'
-version     = '1.0.27'
+version     = '1.0.27.post1'
 description = 'Python binding for the libusb C library.'
 urls.Homepage      = 'https://pypi.org/project/libusb/'
 urls.Documentation = 'https://libusb.readthedocs.io/'
@@ -38,33 +37,34 @@ classifiers = [
     'Programming Language :: Python :: 3.10',
     'Programming Language :: Python :: 3.11',
     'Programming Language :: Python :: 3.12',
+    'Programming Language :: Python :: 3.13',
     'Programming Language :: Python :: 3 :: Only',
     'Programming Language :: Python :: Implementation :: CPython',
     'Programming Language :: Python :: Implementation :: PyPy',
     'Topic :: Software Development :: Libraries :: Python Modules',
 ]
-requires-python = '>=3.8.1,<4.0.0'
+requires-python = '>=3.8.10,<4.0.0'
 dependencies = [
     # mandatory
-    'setuptools>=68.2.2',
-    'pkg-about>=1.1.5',
+    'setuptools>=72.2.0',
+    'pkg-about>=1.1.8',
     # others
 ]
 dynamic = ['readme']
 [project.optional-dependencies]
 doc = [
     'Sphinx>=7.1.2',
-    'sphinx-toolbox>=3.5.0',
-    'sphinx-tabs>=3.4.1',
-    'sphinx-copybutton>=0.5.1',
-    'sphinxcontrib-spelling>=7.7.0',
-    'sphinx-lint>=0.6.7',
+    'sphinx-toolbox>=3.7.0',
+    'sphinx-tabs>=3.4.5',
+    'sphinx-copybutton>=0.5.2',
+    'sphinxcontrib-spelling>=8.0.0',
+    'sphinx-lint>=0.9.1',
     'restructuredtext-lint>=1.4.0',
-    'nbsphinx>=0.8.10',
+    'nbsphinx>=0.9.4',
 ]
 test = [
-    'deepdiff>=6.7.1',
-    'rich>=13.7.0',
+    'deepdiff>=7.0.1',
+    'rich>=13.7.1',
 ]
 
 [project.scripts]
@@ -174,29 +174,29 @@ count = true
 [tool.tox]
 legacy_tox_ini = """
 [tox]
-envlist = py{38,39,310,311,312}, pypy{39,310}, docs
+envlist = py{38,39,310,311,312,313}, pypy{39,310}, docs
 labels =
-    py = py{38,39,310,311,312}, pypy{39,310}
+    py = py{38,39,310,311,312,313}, pypy{39,310}
     prepare = prepare
     coverage = coverage
     lint = lint
     docs = docs
-    build  = py{38,39,310,311,312}, pypy{39,310}, docs, build
-    deploy = py{38,39,310,311,312}, pypy{39,310}, docs, build, publish
-minversion = 4.11.3
+    build  = py{38,39,310,311,312,313}, pypy{39,310}, docs, build
+    deploy = py{38,39,310,311,312,313}, pypy{39,310}, docs, build, publish
+minversion = 4.18.0
 skip_missing_interpreters = true
 requires =
     {[base]deps}
-    virtualenv>=20.25.0
-    tox-backtick>=0.4.4
+    virtualenv>=20.26.3
+    tox-backtick>=0.4.6
     tox-tags>=0.2.0
 
 [base]
-basepython = python3.11
+basepython = python3.12
 deps =
-    pip>=23.3.2
-    setuptools>=68.2.2
-    wheel>=0.42.0
+    pip>=24.2.0
+    setuptools>=72.2.0
+    wheel>=0.44.0
 packagesubdir = libusb
 
 [testenv]
@@ -228,9 +228,9 @@ commands =
     {envpython} -m coverage html
 deps =
     {[testenv]deps}
-    coverage>=7.4.0
+    coverage>=7.6.1
     covdefaults>=2.3.0
-    diff-cover>=7.7.0
+    diff-cover>=9.1.1
 
 [testenv:docs]
 basepython = {[base]basepython}
@@ -244,7 +244,7 @@ extras = doc
 deps =
 
 [testenv:build]
-depends = py{38,39,310,311,312}, pypy{39,310}, docs
+depends = py{38,39,310,311,312,313}, pypy{39,310}, docs
 basepython = {[base]basepython}
 setenv =
     {[testenv]setenv}
@@ -258,7 +258,7 @@ commands =
     {envpython} -m twine check dist/*
 deps =
     {[testenv]deps}
-    twine>=4.0.2
+    twine>=5.1.1
 
 [testenv:publish]
 depends = build
@@ -269,7 +269,7 @@ commands =
     {envpython} -m twine upload dist/*
 extras =
 deps =
-    twine>=4.0.2
+    twine>=5.1.1
 
 [testenv:lint]
 basepython = {[base]basepython}
@@ -278,10 +278,10 @@ commands =
 extras =
 deps =
     {[testenv]deps}
-    flake8>=7.0.0
+    flake8>=7.1.1
     flake8-pyproject>=1.2.3
     flake8-docstrings>=1.7.0
-    pep8-naming>=0.13.3
-    flake8-builtins>=2.2.0
+    pep8-naming>=0.14.1
+    flake8-builtins>=2.5.0
     flake8-deprecated>=2.2.1
 """

{libusb-1.0.27 → libusb-1.0.27.post1}/src/libusb/__about__.py

@@ -1,6 +1,5 @@
 # Copyright (c) 2016 Adam Karpierz
-# Licensed under the zlib/libpng License
-# https://opensource.org/license/zlib
+# SPDX-License-Identifier: Zlib
 
 __import__("pkg_about").about()
 __copyright__ = f"Copyright (c) 2016-2024 {__author__}"  # noqa

{libusb-1.0.27 → libusb-1.0.27.post1}/src/libusb/__init__.py

@@ -1,6 +1,5 @@
 # Copyright (c) 2016 Adam Karpierz
-# Licensed under the zlib/libpng License
-# https://opensource.org/license/zlib
+# SPDX-License-Identifier: Zlib
 
 from .__about__ import * ; del __about__  # noqa
 from . import __config__ ; del __config__

{libusb-1.0.27 → libusb-1.0.27.post1}/src/libusb/_config.py

@@ -1,6 +1,5 @@
 # Copyright (c) 2016 Adam Karpierz
-# Licensed under the zlib/libpng License
-# https://opensource.org/license/zlib
+# SPDX-License-Identifier: Zlib
 
 __all__ = ('make_config',)
 

{libusb-1.0.27 → libusb-1.0.27.post1}/src/libusb/_dll.py

@@ -1,6 +1,5 @@
 # Copyright (c) 2016 Adam Karpierz
-# Licensed under the zlib/libpng License
-# https://opensource.org/license/zlib
+# SPDX-License-Identifier: Zlib
 
 from ._platform import DLL_PATH, DLL, dlclose