all: Replace legacy name with MicroPython and MPy as applicable.

projectgus · dpgeorge · commit 3ec8b9a77c59 · 2025-10-04T00:19:40.000+10:00
With the aim of getting consistency, and removing the need to learn an
additional term, replace uses of uPy/uPython with MPy/MicroPython.

Rule of thumb was to use "MPy" abbreviation where "CPy" is used nearby, but
the full word MicroPython otherwise.

This work was funded through GitHub Sponsors.

Signed-off-by: Angus Gratton &lt;angus@redyak.com.au&gt;
diff --git a/docs/pyboard/tutorial/lcd_skin.rst b/docs/pyboard/tutorial/lcd_skin.rst
@@ -29,7 +29,7 @@ Make sure the LCD skin is attached to the pyboard as pictured at the top of this
     >>> import pyb
     >>> lcd = pyb.LCD('X')
     >>> lcd.light(True)
-    >>> lcd.write('Hello uPy!\n')
+    >>> lcd.write('Hello MPy!\n')
 
 You can make a simple animation using the code::
 
@@ -38,7 +38,7 @@ You can make a simple animation using the code::
     lcd.light(True)
     for x in range(-80, 128):
         lcd.fill(0)
-        lcd.text('Hello uPy!', x, 10, 1)
+        lcd.text('Hello MPy!', x, 10, 1)
         lcd.show()
         pyb.delay(25)
 
diff --git a/docs/reference/asm_thumb2_index.rst b/docs/reference/asm_thumb2_index.rst
@@ -63,7 +63,7 @@ References
 -  :ref:`Assembler Tutorial <pyboard_tutorial_assembler>`
 -  `Wiki hints and tips
    <http://wiki.micropython.org/platforms/boards/pyboard/assembler>`__
--  `uPy Inline Assembler source-code,
+-  `MicroPython Inline Assembler source-code,
    emitinlinethumb.c <https://github.com/micropython/micropython/blob/master/py/emitinlinethumb.c>`__
 -  `ARM Thumb2 Instruction Set Quick Reference
    Card <http://infocenter.arm.com/help/topic/com.arm.doc.qrc0001l/QRC0001_UAL.pdf>`__
diff --git a/extmod/asyncio/core.py b/extmod/asyncio/core.py
@@ -50,7 +50,7 @@ def __next__(self):
             raise self.exc
 
 
-# Pause task execution for the given time (integer in milliseconds, uPy extension)
+# Pause task execution for the given time (integer in milliseconds, MicroPython extension)
 # Use a SingletonGenerator to do it without allocating on the heap
 def sleep_ms(t, sgen=SingletonGenerator()):
     assert sgen.state is None
diff --git a/extmod/modtls_mbedtls.c b/extmod/modtls_mbedtls.c
@@ -304,7 +304,7 @@ static mp_obj_t ssl_context_make_new(const mp_obj_type_t *type_in, size_t n_args
     psa_crypto_init();
     #endif
 
-    const byte seed[] = "upy";
+    const byte seed[] = "mpy";
     int ret = mbedtls_ctr_drbg_seed(&self->ctr_drbg, mbedtls_entropy_func, &self->entropy, seed, sizeof(seed));
     if (ret != 0) {
         mbedtls_raise_error(ret);
diff --git a/extmod/vfs.c b/extmod/vfs.c
@@ -96,7 +96,7 @@ mp_vfs_mount_t *mp_vfs_lookup_path(const char *path, const char **path_out) {
     return MP_STATE_VM(vfs_cur);
 }
 
-// Version of mp_vfs_lookup_path that takes and returns uPy string objects.
+// Version of mp_vfs_lookup_path that takes and returns MicroPython string objects.
 static mp_vfs_mount_t *lookup_path(mp_obj_t path_in, mp_obj_t *path_out) {
     const char *path = mp_obj_str_get_str(path_in);
     const char *p_out;
diff --git a/ports/esp32/machine_hw_spi.c b/ports/esp32/machine_hw_spi.c
@@ -38,10 +38,10 @@
 #include "soc/spi_pins.h"
 
 // SPI mappings by device, naming used by IDF old/new
-// upython   | ESP32     | ESP32S2   | ESP32S3 | ESP32C3 | ESP32C6
-// ----------+-----------+-----------+---------+---------+---------
-// SPI(id=1) | HSPI/SPI2 | FSPI/SPI2 | SPI2    | SPI2    | SPI2
-// SPI(id=2) | VSPI/SPI3 | HSPI/SPI3 | SPI3    | err     | err
+// MicroPython | ESP32     | ESP32S2   | ESP32S3 | ESP32C3 | ESP32C6
+// ------------+-----------+-----------+---------+---------+---------
+// SPI(id=1)   | HSPI/SPI2 | FSPI/SPI2 | SPI2    | SPI2    | SPI2
+// SPI(id=2)   | VSPI/SPI3 | HSPI/SPI3 | SPI3    | err     | err
 
 // Number of available hardware SPI peripherals.
 #if SOC_SPI_PERIPH_NUM > 2
diff --git a/ports/webassembly/asyncio/core.py b/ports/webassembly/asyncio/core.py
@@ -47,7 +47,7 @@ def __next__(self):
             raise self.exc
 
 
-# Pause task execution for the given time (integer in milliseconds, uPy extension)
+# Pause task execution for the given time (integer in milliseconds, MicroPython extension)
 # Use a SingletonGenerator to do it without allocating on the heap
 def sleep_ms(t, sgen=SingletonGenerator()):
     assert sgen.state is None
diff --git a/ports/windows/msvc/paths.props b/ports/windows/msvc/paths.props
@@ -31,7 +31,7 @@
     <PyVariantDir Condition="'$(PyVariantDir)' == ''">$(PyWinDir)variants\$(PyVariant)\</PyVariantDir>
     <PyTargetDir Condition="'$(PyTargetDir)' == ''">$(PyBuildDir)</PyTargetDir>
 
-    <!-- All include directories needed for uPy -->
+    <!-- All include directories needed for MicroPython -->
     <PyIncDirs>$(PyIncDirs);$(PyBaseDir);$(PyWinDir);$(PyBuildDir);$(PyWinDir)msvc;$(PyVariantDir)</PyIncDirs>
 
     <!-- Within PyBuildDir different subdirectories are used based on configuration and platform.
diff --git a/py/gc.c b/py/gc.c
@@ -1245,7 +1245,7 @@ void gc_dump_alloc_table(const mp_print_t *print) {
                     break;
                 }
                 */
-                /* this prints the uPy object type of the head block */
+                /* this prints the MicroPython object type of the head block */
                 case AT_HEAD: {
                     void **ptr = (void **)(area->gc_pool_start + bl * BYTES_PER_BLOCK);
                     if (*ptr == &mp_type_tuple) {
diff --git a/py/mpconfig.h b/py/mpconfig.h
@@ -2099,7 +2099,7 @@ typedef time_t mp_timestamp_t;
 /*****************************************************************************/
 /* Miscellaneous settings                                                    */
 
-// All uPy objects in ROM must be aligned on at least a 4 byte boundary
+// All MicroPython objects in ROM must be aligned on at least a 4 byte boundary
 // so that the small-int/qstr/pointer distinction can be made.  For machines
 // that don't do this (eg 16-bit CPU), define the following macro to something
 // like __attribute__((aligned(4))).
diff --git a/py/objexcept.c b/py/objexcept.c
@@ -272,7 +272,7 @@ void mp_obj_exception_attr(mp_obj_t self_in, qstr attr, mp_obj_t *dest) {
             // We allow 'exc.__traceback__ = None' assignment as low-level
             // optimization of pre-allocating exception instance and raising
             // it repeatedly - this avoids memory allocation during raise.
-            // However, uPy will keep adding traceback entries to such
+            // However, MicroPython will keep adding traceback entries to such
             // exception instance, so before throwing it, traceback should
             // be cleared like above.
             self->traceback_len = 0;
diff --git a/py/objstr.c b/py/objstr.c
@@ -1304,7 +1304,7 @@ static vstr_t mp_obj_str_format_helper(const char *str, const char *top, int *ar
                 }
 
                 case '\0':  // No explicit format type implies 'd'
-                case 'n':   // I don't think we support locales in uPy so use 'd'
+                case 'n':   // I don't think we support locales in MicroPython so use 'd'
                 case 'd':
                     mp_print_mp_int(&print, arg, 10, 'a', flags, fill, width, 0);
                     continue;
diff --git a/tests/basics/async_await2.py b/tests/basics/async_await2.py
@@ -2,7 +2,7 @@
 
 import sys
 if sys.implementation.name == 'micropython':
-    # uPy allows normal generators to be awaitables
+    # MicroPython allows normal generators to be awaitables
     coroutine = lambda f: f
 else:
     import types
diff --git a/tests/basics/async_for2.py b/tests/basics/async_for2.py
@@ -2,7 +2,7 @@
 
 import sys
 if sys.implementation.name == 'micropython':
-    # uPy allows normal generators to be awaitables
+    # MicroPython allows normal generators to be awaitables
     coroutine = lambda f: f
 else:
     import types
diff --git a/tests/basics/async_with2.py b/tests/basics/async_with2.py
@@ -2,7 +2,7 @@
 
 import sys
 if sys.implementation.name == 'micropython':
-    # uPy allows normal generators to be awaitables
+    # MicroPython allows normal generators to be awaitables
     coroutine = lambda f: f
 else:
     import types
diff --git a/tests/basics/boundmeth1.py b/tests/basics/boundmeth1.py
@@ -1,6 +1,6 @@
 # tests basics of bound methods
 
-# uPy and CPython differ when printing a bound method, so just print the type
+# MicroPython and CPython differ when printing a bound method, so just print the type
 print(type(repr([].append)))
 
 
diff --git a/tests/basics/builtin_range.py b/tests/basics/builtin_range.py
@@ -54,7 +54,7 @@
 print(range(1, 100, -5)[5:15:-3])
 print(range(1, 100, -5)[15:5:3])
 
-# for this case uPy gives a different stop value but the listed elements are still correct
+# for this case MicroPython gives a different stop value but the listed elements are still correct
 print(list(range(7, -2, -4)[2:-2:]))
 
 # zero step
diff --git a/tests/basics/builtin_setattr.py b/tests/basics/builtin_setattr.py
@@ -21,5 +21,5 @@ def __init__(self):
 try:
     setattr(int, 'to_bytes', 1)
 except (AttributeError, TypeError):
-    # uPy raises AttributeError, CPython raises TypeError
+    # MicroPython raises AttributeError, CPython raises TypeError
     print('AttributeError/TypeError')
diff --git a/tests/basics/class_bind_self.py b/tests/basics/class_bind_self.py
@@ -52,7 +52,7 @@ def f4(self, arg): # generator
 print(C.f8(13))
 print(C.f9(14))
 
-# not working in uPy
+# not working in MicroPython
 #class C(list):
 #    # this acts like a method and binds self
 #    f1 = list.extend
diff --git a/tests/basics/del_attr.py b/tests/basics/del_attr.py
@@ -35,5 +35,5 @@ def f():
 try:
     del int.to_bytes
 except (AttributeError, TypeError):
-    # uPy raises AttributeError, CPython raises TypeError
+    # MicroPython raises AttributeError, CPython raises TypeError
     print('AttributeError/TypeError')
diff --git a/tests/basics/del_global.py b/tests/basics/del_global.py
@@ -14,7 +14,7 @@ def do_del():
 try:
     do_del()
 except: # NameError:
-    # FIXME uPy returns KeyError for this
+    # FIXME MicroPython returns KeyError for this
     print("NameError")
 
 # delete globals using a list
diff --git a/tests/basics/del_name.py b/tests/basics/del_name.py
@@ -10,7 +10,7 @@
 try:
     del x
 except: # NameError:
-    # FIXME uPy returns KeyError for this
+    # FIXME MicroPython returns KeyError for this
     print("NameError")
 
 class C:
diff --git a/tests/basics/frozenset_set.py b/tests/basics/frozenset_set.py
@@ -8,5 +8,5 @@
 # "Instances of set are compared to instances of frozenset based on their
 # members. For example:"
 print(set('abc') == frozenset('abc'))
-# This doesn't work in uPy
+# This doesn't work in MicroPython
 #print(set('abc') in set([frozenset('abc')]))
diff --git a/tests/basics/fun_name.py b/tests/basics/fun_name.py
@@ -16,7 +16,7 @@ def Fun(self):
     print('SKIP')
     raise SystemExit
 
-# __name__ of a bound native method is not implemented in uPy
+# __name__ of a bound native method is not implemented in MicroPython
 # the test here is to make sure it doesn't crash
 try:
     str((1).to_bytes.__name__)
diff --git a/tests/basics/gc1.py b/tests/basics/gc1.py
@@ -15,13 +15,13 @@
 gc.collect()
 
 if hasattr(gc, 'mem_free'):
-    # uPy has these extra functions
+    # MicroPython has these extra functions
     # just test they execute and return an int
     assert type(gc.mem_free()) is int
     assert type(gc.mem_alloc()) is int
 
 if hasattr(gc, 'threshold'):
-    # uPy has this extra function
+    # MicroPython has this extra function
     # check execution and returns
     assert(gc.threshold(1) is None)
     assert(gc.threshold() == 0)
diff --git a/tests/basics/io_iobase.py b/tests/basics/io_iobase.py
@@ -9,7 +9,7 @@
 
 class MyIO(io.IOBase):
     def write(self, buf):
-        # CPython and uPy pass in different types for buf (str vs bytearray)
+        # CPython and MicroPython pass in different types for buf (str vs bytearray)
         print('write', len(buf))
         return len(buf)
 
diff --git a/tests/basics/list_pop.py b/tests/basics/list_pop.py
@@ -10,7 +10,7 @@
 else:
     raise AssertionError("No IndexError raised")
 
-# popping such that list storage shrinks (tests implementation detail of uPy)
+# popping such that list storage shrinks (tests implementation detail of MicroPython)
 l = list(range(20))
 for i in range(len(l)):
     l.pop()
diff --git a/tests/basics/module2.py b/tests/basics/module2.py
@@ -1,4 +1,4 @@
-# uPy behaviour only: builtin modules are read-only
+# MicroPython behaviour only: builtin modules are read-only
 import sys
 try:
     sys.x = 1
diff --git a/tests/basics/parser.py b/tests/basics/parser.py
@@ -7,7 +7,7 @@
     raise SystemExit
 
 # completely empty string
-# uPy and CPy differ for this case
+# MPy and CPy differ for this case
 #try:
 #    compile("", "stdin", "single")
 #except SyntaxError:
diff --git a/tests/basics/python34.py b/tests/basics/python34.py
@@ -28,7 +28,7 @@ def test_syntax(code):
 test_syntax("del ()") # can't delete empty tuple (in 3.6 we can)
 
 # from basics/sys1.py
-# uPy prints version 3.4
+# MicroPython prints version 3.4
 import sys
 print(sys.version[:3])
 print(sys.version_info[0], sys.version_info[1])
diff --git a/tests/basics/syntaxerror.py b/tests/basics/syntaxerror.py
@@ -86,7 +86,7 @@ def test_syntax(code):
 test_syntax("nonlocal a")
 test_syntax("await 1")
 
-# error on uPy, warning on CPy
+# error on MPy, warning on CPy
 #test_syntax("def f():\n a = 1\n global a")
 
 # default except must be last
@@ -98,7 +98,7 @@ def test_syntax(code):
 # non-keyword after keyword
 test_syntax("f(a=1, 2)")
 
-# doesn't error on uPy but should
+# doesn't error on MPy but should
 #test_syntax("f(1, i for i in i)")
 
 # all elements of dict/set must be pairs or singles
diff --git a/tests/basics/sys_tracebacklimit.py b/tests/basics/sys_tracebacklimit.py
@@ -30,7 +30,7 @@ def print_exc(e):
         if l.startswith("  File "):
             l = l.split('"')
             print(l[0], l[2])
-        # uPy and CPy tracebacks differ in that CPy prints a source line for
+        # MPy and CPy tracebacks differ in that CPy prints a source line for
         # each traceback entry.  In this case, we know that offending line
         # has 4-space indent, so filter it out.
         elif not l.startswith("    "):
diff --git a/tests/basics/tuple1.py b/tests/basics/tuple1.py
@@ -17,7 +17,7 @@
 x += (10, 11, 12)
 print(x)
 
-# construction of tuple from large iterator (tests implementation detail of uPy)
+# construction of tuple from large iterator (tests implementation detail of MicroPython)
 print(tuple(range(20)))
 
 # unsupported unary operation
diff --git a/tests/cpydiff/modules_struct_fewargs.py b/tests/cpydiff/modules_struct_fewargs.py
@@ -1,6 +1,6 @@
 """
 categories: Modules,struct
-description: Struct pack with too few args, not checked by uPy
+description: Struct pack with too few args, not checked by MicroPython
 cause: Unknown
 workaround: Unknown
 """
diff --git a/tests/cpydiff/modules_struct_manyargs.py b/tests/cpydiff/modules_struct_manyargs.py
@@ -1,6 +1,6 @@
 """
 categories: Modules,struct
-description: Struct pack with too many args, not checked by uPy
+description: Struct pack with too many args, not checked by MicroPython
 cause: Unknown
 workaround: Unknown
 """
diff --git a/tests/cpydiff/modules_struct_whitespace_in_format.py b/tests/cpydiff/modules_struct_whitespace_in_format.py
@@ -1,6 +1,6 @@
 """
 categories: Modules,struct
-description: Struct pack with whitespace in format, whitespace ignored by CPython, error on uPy
+description: Struct pack with whitespace in format, whitespace ignored by CPython, error on MicroPython
 cause: MicroPython is optimised for code size.
 workaround: Don't use spaces in format strings.
 """
diff --git a/tests/cpydiff/types_float_implicit_conversion.py b/tests/cpydiff/types_float_implicit_conversion.py
@@ -1,6 +1,6 @@
 """
 categories: Types,float
-description: uPy allows implicit conversion of objects in maths operations while CPython does not.
+description: MicroPython allows implicit conversion of objects in maths operations while CPython does not.
 cause: Unknown
 workaround: Objects should be wrapped in ``float(obj)`` for compatibility with CPython.
 """
diff --git a/tests/extmod/asyncio_set_exception_handler.py b/tests/extmod/asyncio_set_exception_handler.py
@@ -12,7 +12,7 @@ def custom_handler(loop, context):
 
 
 async def task(i):
-    # Raise with 2 args so exception prints the same in uPy and CPython
+    # Raise with 2 args so exception prints the same in MicroPython and CPython
     raise ValueError(i, i + 1)
 
 
diff --git a/tests/extmod/hashlib_md5.py b/tests/extmod/hashlib_md5.py
@@ -1,8 +1,7 @@
 try:
     import hashlib
 except ImportError:
-    # This is neither uPy, nor cPy, so must be uPy with
-    # hashlib module disabled.
+    # MicroPython with hashlib module disabled.
     print("SKIP")
     raise SystemExit
 
diff --git a/tests/extmod/hashlib_sha1.py b/tests/extmod/hashlib_sha1.py
@@ -1,8 +1,7 @@
 try:
     import hashlib
 except ImportError:
-    # This is neither uPy, nor cPy, so must be uPy with
-    # hashlib module disabled.
+    # MicroPython with hashlib module disabled.
     print("SKIP")
     raise SystemExit
 
diff --git a/tests/extmod/hashlib_sha256.py b/tests/extmod/hashlib_sha256.py
@@ -1,8 +1,7 @@
 try:
     import hashlib
 except ImportError:
-    # This is neither uPy, nor cPy, so must be uPy with
-    # hashlib module disabled.
+    # MicroPython with hashlib module disabled.
     print("SKIP")
     raise SystemExit
 
diff --git a/tests/extmod/json_dump.py b/tests/extmod/json_dump.py
diff --git a/tests/extmod/json_dump_iobase.py b/tests/extmod/json_dump_iobase.py
diff --git a/tests/extmod/json_dump_separators.py b/tests/extmod/json_dump_separators.py
diff --git a/tests/extmod/json_dumps_extra.py b/tests/extmod/json_dumps_extra.py
diff --git a/tests/extmod/json_dumps_separators.py b/tests/extmod/json_dumps_separators.py
diff --git a/tests/extmod/re_error.py b/tests/extmod/re_error.py
diff --git a/tests/extmod/re_sub.py b/tests/extmod/re_sub.py
diff --git a/tests/float/string_format2.py b/tests/float/string_format2.py
diff --git a/tests/float/string_format_modulo.py b/tests/float/string_format_modulo.py
diff --git a/tests/frozen/frozentest.mpy b/tests/frozen/frozentest.mpy
diff --git a/tests/frozen/frozentest.py b/tests/frozen/frozentest.py
diff --git a/tests/io/builtin_print_file.py b/tests/io/builtin_print_file.py
diff --git a/tests/io/file_seek.py b/tests/io/file_seek.py
diff --git a/tests/micropython/decorator_error.py b/tests/micropython/decorator_error.py
diff --git a/tests/micropython/heapalloc_traceback.py b/tests/micropython/heapalloc_traceback.py
diff --git a/tests/misc/non_compliant.py b/tests/misc/non_compliant.py
diff --git a/tests/misc/non_compliant_lexer.py b/tests/misc/non_compliant_lexer.py
diff --git a/tests/misc/print_exception.py b/tests/misc/print_exception.py
diff --git a/tests/ports/unix/extra_coverage.py b/tests/ports/unix/extra_coverage.py
diff --git a/tests/ports/unix/extra_coverage.py.exp b/tests/ports/unix/extra_coverage.py.exp

Original file line number	Diff line number	Diff line change
`@@ -96,7 +96,7 @@ mp_vfs_mount_t mp_vfs_lookup_path(const char path, const char **path_out) {`
`96`	`96`	`return MP_STATE_VM(vfs_cur);`
`97`	`97`	`}`
`98`	`98`
`99`		`-// Version of mp_vfs_lookup_path that takes and returns uPy string objects.`
	`99`	`+// Version of mp_vfs_lookup_path that takes and returns MicroPython string objects.`
`100`	`100`	`static mp_vfs_mount_t lookup_path(mp_obj_t path_in, mp_obj_t path_out) {`
`101`	`101`	`const char *path = mp_obj_str_get_str(path_in);`
`102`	`102`	`const char *p_out;`
Original file line number	Diff line number	Diff line change
`@@ -1245,7 +1245,7 @@ void gc_dump_alloc_table(const mp_print_t *print) {`
`1245`	`1245`	`break;`
`1246`	`1246`	`}`
`1247`	`1247`	`*/`
`1248`		`- /* this prints the uPy object type of the head block */`
	`1248`	`+ /* this prints the MicroPython object type of the head block */`
`1249`	`1249`	`case AT_HEAD: {`
`1250`	`1250`	`void ptr = (void )(area->gc_pool_start + bl * BYTES_PER_BLOCK);`
`1251`	`1251`	`if (*ptr == &mp_type_tuple) {`