Implement hashtable

Author: asvetlov

.github/workflows/auto-merge.yml

@@ -15,7 +15,7 @@ jobs:
     steps:
     - name: Dependabot metadata
       id: metadata
-      uses: dependabot/fetch-metadata@v2.3.0
+      uses: dependabot/fetch-metadata@v2.4.0
       with:
         github-token: "${{ secrets.GITHUB_TOKEN }}"
     - name: Enable auto-merge for Dependabot PRs

.github/workflows/ci-cd.yml

@@ -123,13 +123,16 @@ jobs:
         os:
         - ubuntu
         - windows
+        - windows-11-arm
         - macos
         tag:
         - ''
         - 'musllinux'
         exclude:
         - os: windows
           tag: 'musllinux'
+        - os: windows-11-arm
+          tag: 'musllinux'
         - os: macos
           tag: 'musllinux'
         - os: ubuntu
@@ -199,7 +202,7 @@ jobs:
           debug: ''
       fail-fast: false
     runs-on: ${{ matrix.os }}-latest
-    timeout-minutes: 15
+    timeout-minutes: 20
 
     continue-on-error: >-
       ${{

.github/workflows/reusable-build-wheel.yml

@@ -44,7 +44,10 @@ jobs:
   build-wheel:
     name: >-
       Build ${{ inputs.tag }} wheels on ${{ inputs.os }} ${{ inputs.qemu }}
-    runs-on: ${{ inputs.os }}-latest
+    runs-on: ${{
+        inputs.os == 'windows-11-arm' && inputs.os ||
+        format('{0}-latest', inputs.os)
+      }}
     timeout-minutes: ${{ inputs.qemu && 120 || 15 }}
     steps:
     - name: Compute GHA artifact name ending
@@ -89,7 +92,7 @@ jobs:
       shell: bash
 
     - name: Build wheels
-      uses: pypa/cibuildwheel@v2.23.2
+      uses: pypa/cibuildwheel@v2.23.3
       env:
         CIBW_ARCHS_MACOS: x86_64 arm64 universal2
 

.github/workflows/reusable-linters.yml

@@ -74,7 +74,6 @@ jobs:
         fail_ci_if_error: true
     - name: Install spell checker
       run: |
-        sudo apt install libenchant-2-dev
         pip install -r requirements/doc.txt
     - name: Run docs spelling
       run: |

.pre-commit-config.yaml

@@ -118,7 +118,7 @@ repos:
     additional_dependencies:
     - types-docutils
     - lxml  # dep of `--txt-report`, `--cobertura-xml-report` & `--html-report`
-    - pytest
+    - pytest >= 8.4.0
     - pytest_codspeed
     - Sphinx >= 5.3.0
     - sphinxcontrib-spelling
@@ -134,7 +134,7 @@ repos:
     additional_dependencies:
     - types-docutils
     - lxml  # dep of `--txt-report`, `--cobertura-xml-report` & `--html-report`
-    - pytest
+    - pytest >= 8.4.0
     - pytest_codspeed
     - Sphinx >= 5.3.0
     - sphinxcontrib-spelling

CHANGES.rst

@@ -14,6 +14,60 @@ Changelog
 
 .. towncrier release notes start
 
+6.4.4
+=====
+
+*(2025-05-19)*
+
+
+Bug fixes
+---------
+
+- Fixed a segmentation fault when calling :py:meth:`multidict.MultiDict.setdefault` with a single argument -- by :user:`bdraco`.
+
+  *Related issues and pull requests on GitHub:*
+  :issue:`1160`.
+
+- Fixed a segmentation fault when attempting to directly instantiate view objects
+  (``multidict._ItemsView``, ``multidict._KeysView``, ``multidict._ValuesView``) -- by :user:`bdraco`.
+
+  View objects now raise a proper :exc:`TypeError` with the message "cannot create '...' instances directly"
+  when direct instantiation is attempted.
+
+  View objects should only be created through the proper methods: :py:meth:`multidict.MultiDict.items`,
+  :py:meth:`multidict.MultiDict.keys`, and :py:meth:`multidict.MultiDict.values`.
+
+  *Related issues and pull requests on GitHub:*
+  :issue:`1164`.
+
+
+Miscellaneous internal changes
+------------------------------
+
+- :class:`multidict.MultiDictProxy` was refactored to rely only on
+  :class:`multidict.MultiDict` public interface and don't touch any implementation
+  details.
+
+  *Related issues and pull requests on GitHub:*
+  :issue:`1150`.
+
+- Multidict views were refactored to rely only on
+  :class:`multidict.MultiDict` API and don't touch any implementation
+  details.
+
+  *Related issues and pull requests on GitHub:*
+  :issue:`1152`.
+
+- Dropped internal ``_Impl`` class from pure Python implementation, both pure Python and C
+  Extension follows the same design internally now.
+
+  *Related issues and pull requests on GitHub:*
+  :issue:`1153`.
+
+
+----
+
+
 6.4.3
 =====
 

CHANGES/1128.feature

@@ -0,0 +1,10 @@
+Replace internal implementation from an array of items to hash table.
+algorithmic complexity for lookups is switched from O(N) to O(1).
+
+The hash table is very similar to :class:`dict` from CPython but it allows keys duplication.
+
+The benchmark shows 25-50% boost for single lookups, x2-x3 for bulk updates, and x20 for
+some multidict view operations.  The gain is not for free:
+:class:`~multidict.MultiDict.add` and :class:`~multidict.MultiDict.extend` are 25-50%
+slower now. We consider it as acceptable because the lookup is much more common
+operation that addition for the library domain.

CHANGES/1167.contrib.rst

@@ -0,0 +1,5 @@
+Builds have been added for arm64 Windows
+wheels and the ``reusable-build-wheel.yml``
+template has been modified to allow for
+an os value (``windows-11-arm``) which
+does not end with the ``-latest`` postfix.

multidict/__init__.py

@@ -22,7 +22,7 @@
     "getversion",
 )
 
-__version__ = "6.4.3"
+__version__ = "6.4.5.dev0"
 
 
 if TYPE_CHECKING or not USE_EXTENSIONS: