Common Issues¶
Mac (OSX)¶
Keychain¶
If you encounter the following error messages:
Error
2024-07-22T13:47:05 CRITICAL Authentication Manager : Retrieving password from your Keychain failed: OS X Keychain error (OSStatus -25293). 2024-07-22T13:47:11 CRITICAL Authentication Manager : Storing password in your Keychain failed: OS X Keychain 2024-07-22T13:47:11 WARNING Authentication Manager : Master password could not be written to your Keychain
This is a general QGIS issue, please follow the guidance in issue 46175.
bottleneck¶
A pre-requisite package of this Plugin ibmpairs
has a transitive dependency chain: ibmpairs
-> jsonschema
-> bottleneck
. As of bottleneck 1.4.0 the wheel builds for [arm64](https://github.com/pydata/bottleneck/pull/427) systems (e.g. M1, M2, M3 chipsets) are broken. For this reason the version of bottleneck is pinned to 1.3.8 to prevent the error when attempting to make install
:
Error
Could not build wheels for bottleneck which use PEP 517 and cannot be installed directly
numpy¶
A pre-requisite package of this Plugin ibmpairs
has a non-version pinned transitive dependency on numpy
, by default this will install 2.x (as of 2024-06-16). “A module that was compiled using NumPy 1.x cannot be run in NumPy 2.0.0 as it may crash. To support both 1.x and 2.x versions of NumPy, modules must be compiled with NumPy 2.0.”; as there are prerequisites of QGIS compiled with numpy 1.x the version is pinned to 1.26.4 to avoid the following error when opening QGIS:
Error
AttributeError: _ARRAY_API not found
Windows¶
aiohttp¶
A pre-requisite package of this Plugin ibmpairs
has a non-version pinned transitive dependency on aiohttp
, by default this will install 3.10.x (as of 2024-06-16). The recommended version for Windows under later versions of Python is 3.9.5 for this reason the version is pinned in the requirements.txt. 3.10.x versions cause the following error at present:
Error
aiodns needs a SelectorEventLoop on Windows. See more: https://github.com/saghul/aiodns/issues/86