Replace flake8/pyflakes with pylint in CI and toolchain

pylint at 10.00/10 covers everything pyflakes checked (unused imports,
undefined names) and more. pycodestyle is kept — it owns PEP 8
whitespace/indentation checks that pylint doesn't replicate.

- requirements.txt: drop flake8, add pylint
- Makefile: replace ci-flake8 target with ci-pylint
- python.yml: drop flake8 step; add pylint step gated to ubuntu/3.12
  (linting is not platform-sensitive, no need to run 15x)
- contributing.rst: update Code Style, Components, and make ci sections

Author: timlnx

.github/workflows/python.yml

@@ -36,7 +36,11 @@ jobs:
       - name: Pre-Tests code smell validation
         run: |
           pycodestyle -v --ignore=E501 bitmath/__init__.py tests/
-          flake8 --select=F bitmath/__init__.py tests/
+
+      - name: Lint with pylint
+        if: matrix.os == 'ubuntu-latest' && matrix.python-version == '3.12'
+        run: |
+          pylint bitmath/__init__.py
 
       - name: Run Unit Tests
         run: |

Makefile

@@ -209,12 +209,12 @@ ci-pycodestyle:
 	@echo "#############################################"
 	. $(NAME)env3/bin/activate && pycodestyle -v --ignore=E501 bitmath/__init__.py tests/*.py
 
-ci-flake8:
+ci-pylint:
 	@echo ""
 	@echo "#################################################"
-	@echo "# Running Flake8 Compliance Tests in virtualenv"
+	@echo "# Running pylint in virtualenv"
 	@echo "#################################################"
-	. $(NAME)env3/bin/activate && flake8 --select=F bitmath/__init__.py tests/*.py
+	. $(NAME)env3/bin/activate && pylint bitmath/__init__.py
 
-ci: clean uniquetestnames virtualenv ci-list-deps ci-pycodestyle ci-flake8 ci-unittests
+ci: clean uniquetestnames virtualenv ci-list-deps ci-pycodestyle ci-pylint ci-unittests
 	:

bitmath.1

@@ -2,12 +2,12 @@
 .\"     Title: bitmath
 .\"    Author: [see the "AUTHOR" section]
 .\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
-.\"      Date: 04/17/2026
+.\"      Date: 05/04/2026
 .\"    Manual: python-bitmath
-.\"    Source: bitmath 2.0.0
+.\"    Source: bitmath 2.0.1
 .\"  Language: English
 .\"
-.TH "BITMATH" "1" "04/17/2026" "bitmath 2\&.0\&.0" "python\-bitmath"
+.TH "BITMATH" "1" "05/04/2026" "bitmath 2\&.0\&.1" "python\-bitmath"
 .\" -----------------------------------------------------------------
 .\" * Define some portability stuff
 .\" -----------------------------------------------------------------

docsite/source/contributing.rst

@@ -39,13 +39,15 @@ provided template.
 Code Style and Formatting
 *************************
 
-Two static analysis checks run on every pull request as part of the
+Two static analysis tools run on every pull request as part of the
 GitHub Actions CI workflow, and locally via ``make ci``:
 
-* ``pycodestyle`` — checks code style, with **E501** (line too long)
-  ignored.
-* ``flake8 --select=F`` — runs pyflakes error checks only (undefined
-  names, unused imports, etc.). Style checks are disabled.
+* ``pycodestyle`` — checks PEP 8 code style, with **E501** (line too
+  long) ignored. Runs across all matrix cells.
+* ``pylint`` — full static analysis: naming conventions, refactoring
+  hints, design metrics, and correctness checks. The project targets
+  10.00/10. Runs on Ubuntu / Python 3.12 only (linting is not
+  platform-sensitive).
 
 A PR cannot be merged until both pass. If you want to save time you
 can run ``make ci`` locally to check before submitting and waiting on
@@ -150,10 +152,11 @@ The bitmath test suite depends on the following tools:
   can always be discussed in the pull request.
 
 * `pycodestyle <https://pypi.org/project/pycodestyle/>`_ — Checks
-  Python code style.
+  Python code style (PEP 8).
 
-* `pyflakes <https://pypi.org/project/pyflakes/>`_ — Checks Python
-  source files for errors.
+* `pylint <https://pylint.readthedocs.io/>`_ — Full static analysis:
+  naming, refactoring hints, design metrics, and correctness. The
+  project targets a score of 10.00/10.
 
 * `virtualenv <https://virtualenv.pypa.io/en/latest/>`_ — Creates an
   isolated Python environment. The ``make ci`` target manages this
@@ -181,7 +184,7 @@ relevant to contributors are:
    The primary target. Creates a Python virtualenv, installs all
    dependencies from ``requirements.txt``, runs the unique test name
    check, executes the full pytest suite with coverage, and runs
-   ``pycodestyle`` and ``pyflakes``. Run this before opening a pull
+   ``pycodestyle`` and ``pylint``. Run this before opening a pull
    request. **This is the same check GitHub Actions runs.**
 
 ``make clean``

requirements.txt

@@ -1,4 +1,4 @@
-flake8
 pycodestyle
+pylint
 pytest
 pytest-cov