mpremote: Add smart encoding selection for fs_writefile.

.github/actions/setup_esp32/action.yml

@@ -0,0 +1,47 @@
+name: Setup ESP-IDF for CI
+description: Install ESP-IDF
+inputs:
+  idf_ver:
+    required: true
+    type: string
+  ccache_key:
+    required: true
+    type: string
+
+runs:
+  using: "composite"
+
+  steps:
+  - id: python_ver
+    name: Read the Python version
+    run: echo PYTHON_VER=py$(python --version | cut -d' ' -f2) | tee "${GITHUB_OUTPUT}"
+    shell: bash
+
+  - name: Cached ESP-IDF install
+    id: cache_esp_idf
+    uses: actions/cache@v5
+    with:
+      path: |
+        ./esp-idf/
+        ~/.espressif/
+        !~/.espressif/dist/
+        ~/.cache/pip/
+      # Cache is keyed on both IDF version (from the job) and Python version (from the runner)
+      key: esp-idf-${{ inputs.idf_ver }}-${{ steps.python_ver.outputs.PYTHON_VER }}
+
+  - name: Install ESP-IDF packages
+    if: steps.cache_esp_idf.outputs.cache-hit != 'true'
+    env:
+       IDF_VER: ${{ inputs.idf_ver }}
+    run: tools/ci.sh esp32_idf_setup
+    shell: bash
+
+  - name: ccache
+    uses: hendrikmuhs/ccache-action@v1.2
+    with:
+      key: esp32-${{ inputs.idf_ver }}-${{ inputs.ccache_key }}
+
+  - name: Enable CCache for ESP-IDF
+    run: echo "IDF_CCACHE_ENABLE=1" >> ${GITHUB_ENV}
+    shell: bash
+

.github/workflows/code_size.yml

@@ -32,28 +32,17 @@ jobs:
     - name: Install packages
       run: tools/ci.sh code_size_setup
 
-    # Needs to be kept in synch with ports_esp32.yml
-    - id: idf_ver
-      name: Read the ESP-IDF version (including Python version) and set outputs.IDF_VER
-      run: tools/ci.sh esp32_idf_ver | tee "${GITHUB_OUTPUT}"
-    - name: Cached ESP-IDF install
-      id: cache_esp_idf
-      uses: actions/cache@v5
-      with:
-        path: |
-          ./esp-idf/
-          ~/.espressif/
-          !~/.espressif/dist/
-          ~/.cache/pip/
-        key: esp-idf-${{ steps.idf_ver.outputs.IDF_VER }}
-    - name: Install ESP-IDF packages
-      if: steps.cache_esp_idf.outputs.cache-hit != 'true'
-      run: tools/ci.sh esp32_idf_setup
+    - name: Find IDF_NEWEST_VER
+      id: idf_ver
+      run: |
+          echo "IDF_VER="$(yq .env.IDF_NEWEST_VER < .github/workflows/ports_esp32.yml) \
+          | tee "${GITHUB_OUTPUT}"
 
-    - name: ccache
-      uses: hendrikmuhs/ccache-action@v1.2
+    - name: Setup ESP-IDF
+      uses: ./.github/actions/setup_esp32
       with:
-        key: code_size
+        idf_ver: ${{ steps.idf_ver.outputs.IDF_VER }}
+        ccache_key: code_size
 
     - name: Build
       run: tools/ci.sh code_size_build

.github/workflows/ports_esp32.yml

@@ -12,54 +12,52 @@ on:
       - 'lib/**'
       - 'drivers/**'
       - 'ports/esp32/**'
-  schedule:
-     # Scheduled run exists to keep master branch ESP-IDF cache entry hot
-     # and prevent creating many redundant per-branch cache entries instead.
-     - cron: "20 0 * * *"
 
 concurrency:
   group: ${{ github.workflow }}-${{ github.ref }}
   cancel-in-progress: true
 
+env:
+   # Oldest and newest supported ESP-IDF versions, should match ports/esp32/README.md
+   IDF_OLDEST_VER: &oldest "v5.3"
+   IDF_NEWEST_VER: &newest "v5.5.1"
+
 jobs:
   build_idf:
     strategy:
       fail-fast: false
       matrix:
+        idf_ver:
+          - *oldest
+          - *newest
         ci_func:  # names are functions in ci.sh
           - esp32_build_cmod_spiram_s2
           - esp32_build_s3_c3
           - esp32_build_c2_c5_c6
           - esp32_build_p4
+        exclude:
+          # Exclude some jobs on the oldest IDF version, to save resources
+          - idf_ver: *oldest
+            ci_func: esp32_build_c2_c5_c6
+          - idf_ver: *oldest
+            ci_func: esp32_build_p4
     runs-on: ubuntu-latest
     steps:
     - uses: actions/checkout@v6
 
-    # Needs to be kept in synch with code_size.yml
-    - id: idf_ver
-      name: Read the ESP-IDF version (including Python version) and set outputs.IDF_VER
-      run: tools/ci.sh esp32_idf_ver | tee "${GITHUB_OUTPUT}"
+    # Only the newest IDF version will build the ESP-IDF lockfiles correctly,
+    # so we need to disable MICROPY_MAINTAINER_BUILD on older versions.
+    - name: Disable extra checks for older ESP-IDF
+      id: check_newest_ver
+      if: ${{ matrix.idf_ver != env.IDF_NEWEST_VER }}
+      run: echo "MICROPY_MAINTAINER_BUILD=0" >> ${GITHUB_ENV}
 
-    - name: Cached ESP-IDF install
-      id: cache_esp_idf
-      uses: actions/cache@v5
+    - name: Setup ESP-IDF
+      uses: ./.github/actions/setup_esp32
       with:
-        path: |
-          ./esp-idf/
-          ~/.espressif/
-          !~/.espressif/dist/
-          ~/.cache/pip/
-        key: esp-idf-${{ steps.idf_ver.outputs.IDF_VER }}
-
-    - name: Install ESP-IDF packages
-      if: steps.cache_esp_idf.outputs.cache-hit != 'true'
-      run: tools/ci.sh esp32_idf_setup
+        idf_ver: ${{ matrix.idf_ver }}
+        ccache_key: ${{ matrix.ci_func }}
 
-    # Needs to be kept in synch with code_size.yml
-    - name: ccache
-      uses: hendrikmuhs/ccache-action@v1.2
-      with:
-        key: esp32-${{ matrix.ci_func }}
 
-    - name: Build ci_${{matrix.ci_func }}
+    - name: Build ci_${{matrix.ci_func }} on ESP-IDF ${{ matrix.idf_ver }}
       run: tools/ci.sh ${{ matrix.ci_func }}

.github/workflows/ports_zephyr.yml

@@ -12,10 +12,6 @@ on:
       - 'lib/**'
       - 'ports/zephyr/**'
       - 'tests/**'
-  schedule:
-     # Scheduled run exists to keep master branch Zephyr cache entry hot
-     # and prevent creating many redundant per-branch cache entries instead.
-     - cron: "40 4 * * *"
 
 concurrency:
   group: ${{ github.workflow }}-${{ github.ref }}

LICENSE

@@ -1,6 +1,6 @@
 The MIT License (MIT)
 
-Copyright (c) 2013-2025 Damien P. George
+Copyright (c) 2013-2026 Damien P. George
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

docs/conf.py

@@ -72,7 +72,7 @@
 
 # General information about the project.
 project = "MicroPython"
-copyright = "- The MicroPython Documentation is Copyright © 2014-2025, " + micropy_authors
+copyright = "- The MicroPython Documentation is Copyright © 2014-2026, " + micropy_authors
 
 # The version info for the project you're documenting, acts as replacement for
 # |version| and |release|, also used in various other places throughout the

docs/library/index.rst

@@ -82,6 +82,7 @@ library.
    struct.rst
    sys.rst
    time.rst
+   weakref.rst
    zlib.rst
    _thread.rst