Fetch upstream PR

.flake8

@@ -1,3 +1,3 @@
 [flake8]
+ignore = E203, W503
 max-line-length = 120
-exclude = .git,__pycache__,vendor

.github/workflows/codeql.yml

@@ -0,0 +1,74 @@
+# For most projects, this workflow file will not need changing; you simply need
+# to commit it to your repository.
+#
+# You may wish to alter this file to override the set of languages analyzed,
+# or to provide custom queries or build logic.
+#
+# ******** NOTE ********
+# We have attempted to detect the languages in your repository. Please check
+# the `language` matrix defined below to confirm you have the correct set of
+# supported CodeQL languages.
+#
+name: "CodeQL"
+
+on:
+  push:
+    branches: [ "master" ]
+  pull_request:
+    # The branches below must be a subset of the branches above
+    branches: [ "master" ]
+  schedule:
+    - cron: '35 7 * * 1'
+
+jobs:
+  analyze:
+    name: Analyze
+    runs-on: ubuntu-latest
+    permissions:
+      actions: read
+      contents: read
+      security-events: write
+
+    strategy:
+      fail-fast: false
+      matrix:
+        language: [ 'python' ]
+        # CodeQL supports [ 'cpp', 'csharp', 'go', 'java', 'javascript', 'python', 'ruby' ]
+        # Learn more about CodeQL language support at https://aka.ms/codeql-docs/language-support
+
+    steps:
+    - name: Checkout repository
+      uses: actions/checkout@v4
+
+    # Initializes the CodeQL tools for scanning.
+    - name: Initialize CodeQL
+      uses: github/codeql-action/init@v3
+      with:
+        languages: ${{ matrix.language }}
+        # If you wish to specify custom queries, you can do so here or in a config file.
+        # By default, queries listed here will override any specified in a config file.
+        # Prefix the list here with "+" to use these queries and those in the config file.
+
+        # Details on CodeQL's query packs refer to : https://docs.github.com/en/code-security/code-scanning/automatically-scanning-your-code-for-vulnerabilities-and-errors/configuring-code-scanning#using-queries-in-ql-packs
+        # queries: security-extended,security-and-quality
+
+
+    # Autobuild attempts to build any compiled languages  (C/C++, C#, Go, or Java).
+    # If this step fails, then you should remove it and run the build manually (see below)
+    - name: Autobuild
+      uses: github/codeql-action/autobuild@v3
+
+    # ℹ️ Command-line programs to run using the OS shell.
+    # 📚 See https://docs.github.com/en/actions/using-workflows/workflow-syntax-for-github-actions#jobsjob_idstepsrun
+
+    #   If the Autobuild fails above, remove it and uncomment the following three lines.
+    #   modify them (or add more) to build your code if your project, please refer to the EXAMPLE below for guidance.
+
+    # - run: |
+    #   echo "Run, Build Application using script"
+    #   ./location_of_script_within_repo/buildscript.sh
+
+    - name: Perform CodeQL Analysis
+      uses: github/codeql-action/analyze@v3
+      with:
+        category: "/language:${{matrix.language}}"

.github/workflows/dependency-review.yml

@@ -0,0 +1,20 @@
+# Dependency Review Action
+#
+# This Action will scan dependency manifest files that change as part of a Pull Request, surfacing known-vulnerable versions of the packages declared or updated in the PR. Once installed, if the workflow run is marked as required, PRs introducing known-vulnerable packages will be blocked from merging.
+#
+# Source repository: https://github.com/actions/dependency-review-action
+# Public documentation: https://docs.github.com/en/code-security/supply-chain-security/understanding-your-software-supply-chain/about-dependency-review#dependency-review-enforcement
+name: 'Dependency Review'
+on: [pull_request]
+
+permissions:
+  contents: read
+
+jobs:
+  dependency-review:
+    runs-on: ubuntu-latest
+    steps:
+      - name: 'Checkout Repository'
+        uses: actions/checkout@v4
+      - name: 'Dependency Review'
+        uses: actions/dependency-review-action@v4

.github/workflows/python-package.yml

@@ -29,18 +29,18 @@ jobs:
     needs: pre_job
     strategy:
       matrix:
-        python-version: [3.6, 3.7, 3.8, 3.9, 3.10-dev]
+        python-version: ['3.9', '3.13']
         include:
-          # Allow failure on Python dev - e.g. Cython install regularly fails
-          - python-version: 3.10-dev
+        # Allow failure on Python dev - e.g. Cython install regularly fails
+          - python-version: "3.14-dev"
             allowed_failure: true
       max-parallel: 1
 
     steps:
-    - uses: actions/checkout@v2
+    - uses: actions/checkout@v4
 
     - name: Set up Python ${{ matrix.python-version }}
-      uses: actions/setup-python@v2
+      uses: actions/setup-python@v5
       with:
         python-version: ${{ matrix.python-version }}
 
@@ -50,21 +50,21 @@ jobs:
       # Only repo owners have access to the secret. PRs will run only the unit tests
       if: env.AES_256_CBC_PASS != ''
       run: |
-        openssl aes-256-cbc -d -in settings.yml.ghenc -out settings.yml -pass env:AES_256_CBC_PASS
+        openssl aes-256-cbc -d -md sha256 -in settings.yml.ghenc -out settings.yml -pass env:AES_256_CBC_PASS
 
     - name: Upgrade pip
       run: |
-        python -m pip install --upgrade pip
+        python -m pip install --upgrade pip wheel
 
     - name: Install cutting-edge Cython-based packages on Python dev versions
       continue-on-error: ${{ matrix.allowed_failure || false }}
-      if: matrix.python-version == '3.10-dev'
+      if: matrix.python-version == '3.14-dev'
       run: |
         sudo apt-get install libxml2-dev libxslt1-dev
-        python -m pip install hg+https://foss.heptapod.net/pypy/cffi
         python -m pip install git+https://github.com/cython/cython.git
         python -m pip install git+https://github.com/lxml/lxml.git
         python -m pip install git+https://github.com/yaml/pyyaml.git
+        python -m pip install git+https://github.com/python-cffi/cffi.git
 
     - name: Install dependencies
       continue-on-error: ${{ matrix.allowed_failure || false }}
@@ -77,7 +77,11 @@ jobs:
       env:
        GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
       run: |
-        unittest-parallel -j 4 --class-fixtures --coverage --coverage-source exchangelib
+        black --check --diff exchangelib tests scripts
+        isort --check --diff exchangelib tests scripts
+        flake8 exchangelib tests scripts
+        blacken-docs *.md docs/*.md
+        unittest-parallel -j 4 --level=class --coverage --coverage-source exchangelib
         coveralls --service=github
 
   cleanup:
@@ -87,24 +91,26 @@ jobs:
     if: ${{ always() }}
 
     steps:
-    - uses: actions/checkout@v2
+    - uses: actions/checkout@v4
 
     - name: Set up Python
-      uses: actions/setup-python@v2
+      uses: actions/setup-python@v5
       with:
-        python-version: '3.9'
+        python-version: '3.13'
 
     - name: Unencrypt secret file
       env:
           AES_256_CBC_PASS: ${{ secrets.AES_256_CBC_PASS }}
-      # Only repo owners have access to the secret. PRs will run only the unit tests
+      # Only repo owners have access to the secret. PRs will run only the unit tests.
+      # The encrypted file was created as:
+      #  openssl aes-256-cbc -e -md sha256 -in settings.yml -out settings.yml.ghenc
       if: env.AES_256_CBC_PASS != ''
       run: |
-        openssl aes-256-cbc -d -in settings.yml.ghenc -out settings.yml -pass env:AES_256_CBC_PASS
+        openssl aes-256-cbc -d -md sha256 -in settings.yml.ghenc -out settings.yml -pass env:AES_256_CBC_PASS
 
     - name: Upgrade pip
       run: |
-        python -m pip install --upgrade pip
+        python -m pip install --upgrade pip wheel
 
     - name: Install dependencies
       run: |

.gitignore

@@ -9,6 +9,7 @@
 build
 dist
 __pycache__
+venv
 
 settings.yml
 scratch*.py

.pre-commit-config.yaml

@@ -0,0 +1,42 @@
+# See https://pre-commit.com for more information
+# See https://pre-commit.com/hooks.html for more hooks
+repos:
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v5.0.0
+    hooks:
+      - id: trailing-whitespace
+      - id: end-of-file-fixer
+      - id: check-yaml
+      - id: check-added-large-files
+  - repo: https://github.com/compilerla/conventional-pre-commit
+    rev: v3.6.0
+    hooks:
+      - id: conventional-pre-commit
+        stages: [ commit-msg ]
+        args: [ ] # optional: list of Conventional Commits types to allow
+  - repo: local
+    hooks:
+      - id: black
+        name: black
+        stages: [ pre-commit ]
+        entry: black --check --diff
+        language: system
+        types: [ python ]
+      - id: isort
+        name: isort
+        stages: [ pre-commit ]
+        entry: isort --check --diff
+        types: [ python ]
+        language: system
+      - id: flake8
+        name: flake8
+        stages: [ pre-commit ]
+        entry: flake8
+        types: [ python ]
+        language: system
+      - id: blacken-docs
+        name: blacken-docs
+        stages: [ pre-commit ]
+        entry: blacken-docs
+        types: [ markdown ]
+        language: system