Update repository to latest upstream branch (pyftdi 0.57.1)

.flake8

@@ -0,0 +1,2 @@
+[flake8]
+max-line-length = 80

.github/workflows/pypi.yml

@@ -0,0 +1,47 @@
+name: Publish to PyPI
+
+on:
+  release:
+    types:
+      - published
+  workflow_dispatch:
+    inputs:
+      twine_verbose:
+        description: 'Enable Twine verbose mode'
+        required: true
+        type: boolean
+
+jobs:
+  pypi-publish:
+    name: upload release to PyPI
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/p/pyftdi
+    permissions:
+      id-token: write
+    strategy:
+      matrix:
+        python-version: ['3.13']
+    steps:
+
+    - uses: actions/checkout@v4
+
+    - name: Set up Python ${{ matrix.python-version }}
+      uses: actions/setup-python@v5
+      with:
+        python-version: ${{ matrix.python-version }}
+
+    - name: Install dependencies
+      run: |
+        python -m pip install --upgrade pip
+        pip install setuptools wheel
+
+    - name: Build package
+      run: |
+        python setup.py bdist_wheel
+
+    - name: Publish package distributions to PyPI
+      uses: pypa/gh-action-pypi-publish@release/v1
+      with:
+          verbose: ${{ inputs.twine_verbose }}

.github/workflows/pythonchecksyntax.yml

@@ -1,33 +1,46 @@
 name: Python syntax tests
 # check that there is no import issues with tool suite
 
-on: [push]
+on:
+  push:
+  pull_request:
+    types: [assigned, opened, synchronize, reopened]
 
 jobs:
   build:
 
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        python-version: ['3.7', '3.8', '3.9', '3.10']
+        python-version: ['3.9', '3.10', '3.11', '3.12', '3.13']
 
     steps:
-    - uses: actions/checkout@v2
+    - uses: actions/checkout@v4
+
     - name: Set up Python ${{ matrix.python-version }}
-      uses: actions/setup-python@v1
+      uses: actions/setup-python@v5
       with:
         python-version: ${{ matrix.python-version }}
+
     - name: Install dependencies
       run: |
         python -m pip install --upgrade pip
         pip install -r requirements.txt
-        pip install setuptools wheel ruamel.yaml
+        pip install -r test-requirements.txt
+
     - name: Check style
       run: |
         python setup.py check_style
+
+    - name: Linter
+      run: |
+        pylint --disable=fixme --disable=duplicate-code \
+          $(git ls-files '*.py')
+
     - name: Install package
       run: |
         python setup.py install
+
     - name: Run tests
       run: |
         python pyftdi/tests/toolsimport.py

.github/workflows/pythonmocktests.yml

@@ -11,13 +11,13 @@ jobs:
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        python-version: ['3.7', '3.8', '3.9', '3.10']
+        python-version: ['3.9', '3.10', '3.11', '3.12', '3.13']
 
     steps:
-    - uses: actions/checkout@v2
+    - uses: actions/checkout@v4
 
     - name: Set up Python ${{ matrix.python-version }}
-      uses: actions/setup-python@v1
+      uses: actions/setup-python@v5
       with:
         python-version: ${{ matrix.python-version }}
 

.github/workflows/pythonpackage.yml

@@ -1,32 +1,37 @@
 name: Python package
 
-on: [push]
+on:
+  push:
+  pull_request:
+    types: [assigned, opened, synchronize, reopened]
 
 jobs:
   build:
 
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        python-version: ['3.7', '3.8', '3.9', '3.10']
+        python-version: ['3.9', '3.10', '3.11', '3.12', '3.13']
 
     steps:
-    - uses: actions/checkout@v2
+    - uses: actions/checkout@v4
+
     - name: Set up Python ${{ matrix.python-version }}
-      uses: actions/setup-python@v1
+      uses: actions/setup-python@v5
       with:
         python-version: ${{ matrix.python-version }}
+
     - name: Install dependencies
       run: |
         python -m pip install --upgrade pip
         pip install -r requirements.txt
-        pip install setuptools wheel sphinx sphinx_autodoc_typehints
-        # Shpinx Read the Doc theme seems to never get a release w/ fixed issues
-        pip install -U -e git+https://github.com/readthedocs/sphinx_rtd_theme.git@2b8717a3647cc650625c566259e00305f7fb60aa#egg=sphinx_rtd_theme
+        pip install setuptools wheel sphinx sphinx_rtd_theme sphinx_autodoc_typehints
+
     - name: Build package
       run: |
         python setup.py bdist
         python setup.py sdist bdist_wheel
+
     - name: Build documentation
       run: |
         mkdir doc

.gitignore

@@ -9,3 +9,4 @@ build/
 sphinx/
 .vs/
 .vscode/
+.venv/

.pylintrc

@@ -0,0 +1,19 @@
+[MASTER]
+
+init-hook='import sys; sys.path.append(".")'
+
+[MESSAGES CONTROL]
+
+disable=
+    too-few-public-methods,
+    too-many-arguments,
+    too-many-branches,
+    too-many-instance-attributes,
+    too-many-lines,
+    too-many-locals,
+    too-many-nested-blocks,
+    too-many-positional-arguments,
+    too-many-public-methods,
+    too-many-return-statements,
+    too-many-statements,
+    unspecified-encoding

LICENSE

@@ -1,4 +1,4 @@
-Copyright (c) 2008-2021 Emmanuel Blot <emmanuel.blot@free.fr>
+Copyright (c) 2008-2025 Emmanuel Blot <emmanuel.blot@free.fr>
 All Rights Reserved.
 
 SPDX-License-Identifier: BSD-3-Clause

README.md

@@ -1,8 +1,10 @@
 # PyFtdiWin
 
+
 ![Python package](https://github.com/mariusgreuel/pyftdiwin/workflows/Python%20package/badge.svg)
 ![Mock tests](https://github.com/mariusgreuel/pyftdiwin/workflows/Python%20mock%20tests/badge.svg)
 ![Syntax tests](https://github.com/mariusgreuel/pyftdiwin/workflows/Python%20syntax%20tests/badge.svg)
+
 [![StandWithUkraine](https://raw.githubusercontent.com/vshymanskyy/StandWithUkraine/main/badges/StandWithUkraine.svg)](https://vshymanskyy.github.io/StandWithUkraine)
 
 [![PyPI](https://img.shields.io/pypi/v/pyftdiwin.svg?maxAge=2592000)](https://pypi.org/project/pyftdiwin/)
@@ -44,6 +46,7 @@ Suported FTDI devices include:
   * FT232H (single port, clock up to 30 MHz)
   * FT2232H (dual port, clock up to 30 MHz)
   * FT4232H (quad port, clock up to 30 MHz)
+  * FT4232HA (quad port, clock up to 30 MHz)
 
 ## Features
 
@@ -90,6 +93,6 @@ pip install pyftdiwin
 
 ### Python support
 
-PyFtdi requires Python 3.7+.
+PyFtdi requires Python 3.9+.
 
 See `pyftdi/doc/requirements.rst` for more details.

pyftdi/__init__.py

@@ -1,21 +1,21 @@
-# Copyright (c) 2010-2022 Emmanuel Blot <emmanuel.blot@free.fr>
+# Copyright (c) 2010-2025 Emmanuel Blot <emmanuel.blot@free.fr>
 # Copyright (c) 2010-2016, Neotion
 # All rights reserved.
 #
 # SPDX-License-Identifier: BSD-3-Clause
 
-#pylint: disable-msg=missing-docstring
+# pylint: disable=missing-docstring
 
-__version__ = '0.54.0'
+__version__ = '0.57.1'
 __title__ = 'PyFtdi'
 __description__ = 'FTDI device driver (pure Python)'
 __uri__ = 'http://github.com/eblot/pyftdi'
 __doc__ = __description__ + ' <' + __uri__ + '>'
 __author__ = 'Emmanuel Blot'
 # For all support requests, please open a new issue on GitHub
 __email__ = 'emmanuel.blot@free.fr'
-__license__ = 'Modified BSD'
-__copyright__ = 'Copyright (c) 2011-2021 Emmanuel Blot'
+__license__ = 'BSD-3-Clause'
+__copyright__ = 'Copyright (c) 2011-2025 Emmanuel Blot'
 
 
 from logging import WARNING, NullHandler, getLogger

pyftdi/bin/ftconf.py

@@ -3,25 +3,25 @@
 """Simple FTDI EEPROM configurator.
 """
 
-# Copyright (c) 2019-2022, Emmanuel Blot <emmanuel.blot@free.fr>
+# Copyright (c) 2019-2024, Emmanuel Blot <emmanuel.blot@free.fr>
 # All rights reserved.
 #
 # SPDX-License-Identifier: BSD-3-Clause
 
 from argparse import ArgumentParser, FileType
 from io import StringIO
 from logging import Formatter, StreamHandler, DEBUG, ERROR
-from sys import modules, stderr, stdout
+from sys import exit as sys_exit, modules, stderr, stdout
 from textwrap import fill
 from traceback import format_exc
 from pyftdi import FtdiLogger
 from pyftdi.eeprom import FtdiEeprom
 from pyftdi.ftdi import Ftdi
 from pyftdi.misc import add_custom_devices, hexdump
 
-#pylint: disable-msg=too-many-locals
-#pylint: disable-msg=too-many-branches
-#pylint: disable-msg=too-many-statements
+# pylint: disable=too-many-locals
+# pylint: disable=too-many-branches
+# pylint: disable=too-many-statements
 
 
 def main():
@@ -86,9 +86,9 @@ def main():
 
         extra = argparser.add_argument_group(title='Extras')
         extra.add_argument('-v', '--verbose', action='count', default=0,
-                               help='increase verbosity')
+                           help='increase verbosity')
         extra.add_argument('-d', '--debug', action='store_true',
-                               help='enable debug mode')
+                           help='enable debug mode')
         args = argparser.parse_args()
         debug = args.debug
 
@@ -107,7 +107,7 @@ def main():
         FtdiLogger.log.addHandler(StreamHandler(stderr))
 
         if args.virtual:
-            #pylint: disable-msg=import-outside-toplevel
+            # pylint: disable=import-outside-toplevel
             from pyftdi.usbtools import UsbTools
             # Force PyUSB to use PyFtdi test framework for USB backends
             UsbTools.BACKENDS = ('pyftdi.tests.backend.usbvirt', )
@@ -138,13 +138,12 @@ def main():
                 helpstr = ', '.join(sorted(eeprom.properties))
                 print(fill(helpstr, initial_indent='  ',
                            subsequent_indent='  '))
-                exit(1)
+                sys_exit(1)
             for sep in ':=':
                 if sep in conf:
                     name, value = conf.split(sep, 1)
                     if not value:
-                        argparser.error('Configuration %s without value' %
-                                        conf)
+                        argparser.error(f'Configuration {conf} without value')
                     if value == 'help':
                         value = '?'
                     helpio = StringIO()
@@ -153,10 +152,10 @@ def main():
                     if helpstr:
                         print(fill(helpstr, initial_indent='  ',
                                    subsequent_indent='  '))
-                        exit(1)
+                        sys_exit(1)
                     break
             else:
-                argparser.error('Missing name:value separator in %s' % conf)
+                argparser.error(f'Missing name:value separator in {conf}')
         if args.vid:
             eeprom.set_property('vendor_id', args.vid)
         if args.pid:
@@ -166,7 +165,7 @@ def main():
         if args.hexblock is not None:
             indent = ' ' * args.hexblock
             for pos in range(0, len(eeprom.data), 16):
-                hexa = ' '.join(['%02x' % x for x in eeprom.data[pos:pos+16]])
+                hexa = ' '.join([f'{x:02x}' for x in eeprom.data[pos:pos+16]])
                 print(indent, hexa, sep='')
         if args.update:
             if eeprom.commit(False, no_crc=args.full_erase):
@@ -181,12 +180,14 @@ def main():
                     eeprom.save_config(ofp)
 
     except (ImportError, IOError, NotImplementedError, ValueError) as exc:
-        print('\nError: %s' % exc, file=stderr)
+        print(f'\nError: {exc}', file=stderr)
         if debug:
             print(format_exc(chain=False), file=stderr)
-        exit(1)
+        sys_exit(1)
     except KeyboardInterrupt:
-        exit(2)
+        sys_exit(2)
+    finally:
+        eeprom.close()
 
 
 if __name__ == '__main__':

pyftdi/bin/ftdi_urls.py

@@ -1,6 +1,6 @@
 #!/usr/bin/env python3
 
-# Copyright (c) 2019-2022, Emmanuel Blot <emmanuel.blot@free.fr>
+# Copyright (c) 2019-2024, Emmanuel Blot <emmanuel.blot@free.fr>
 # All rights reserved.
 #
 # SPDX-License-Identifier: BSD-3-Clause
@@ -9,7 +9,7 @@
 
 from argparse import ArgumentParser, FileType
 from logging import Formatter, StreamHandler, DEBUG, ERROR
-from sys import modules, stderr
+from sys import exit as sys_exit, modules, stderr
 from traceback import format_exc
 from pyftdi import FtdiLogger
 from pyftdi.ftdi import Ftdi
@@ -45,7 +45,7 @@ def main():
         FtdiLogger.log.addHandler(StreamHandler(stderr))
 
         if args.virtual:
-            #pylint: disable-msg=import-outside-toplevel
+            # pylint: disable=import-outside-toplevel
             from pyftdi.usbtools import UsbTools
             # Force PyUSB to use PyFtdi test framework for USB backends
             UsbTools.BACKENDS = ('pyftdi.tests.backend.usbvirt', )
@@ -62,12 +62,12 @@ def main():
         Ftdi.show_devices()
 
     except (ImportError, IOError, NotImplementedError, ValueError) as exc:
-        print('\nError: %s' % exc, file=stderr)
+        print(f'\nError: {exc}', file=stderr)
         if debug:
             print(format_exc(chain=False), file=stderr)
-        exit(1)
+        sys_exit(1)
     except KeyboardInterrupt:
-        exit(2)
+        sys_exit(2)
 
 
 if __name__ == '__main__':