Merge pull request #1 from micropython/master

sync with upstream

Author: echo-lalia

.git-blame-ignore-revs

@@ -1,3 +1,12 @@
+# all: Prune trailing whitespace.
+dda9b9c6da5d3c31fa8769e581a753e95a270803
+
+# all: Remove the "STATIC" macro and just use "static" instead.
+decf8e6a8bb940d5829ca3296790631fcece7b21
+
+# renesas-ra: Fix spelling mistakes found by codespell.
+b3f2f18f927fa2fad10daf63d8c391331f5edf58
+
 # all: Update Python formatting to ruff-format.
 bbd8760bd9a2302e5abee29db279102bb11d7732
 

.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,107 @@
+name: Bug report
+description: Report a bug or unexpected behaviour
+labels: ["bug"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Please provide as much detail as you can, it really helps us find and fix bugs faster.
+
+        #### Not a bug report?
+
+        * If you have a question \"How Do I ...?\", please post it on [GitHub Discussions](https://github.com/orgs/micropython/discussions/) or [Discord](https://discord.gg/RB8HZSAExQ) instead of here.
+        * For missing or incorrect documentation, or feature requests, then please [choose a different issue type](https://github.com/micropython/micropython/issues/new/choose).
+  - type: checkboxes
+    id: terms
+    attributes:
+      label: Checks
+      description: |
+        Before submitting your bug report, please go over these check points:
+      options:
+      - label: |
+           I agree to follow the MicroPython [Code of Conduct](https://github.com/micropython/micropython/blob/master/CODEOFCONDUCT.md) to ensure a safe and respectful space for everyone.
+        required: true
+      - label: |
+          I've searched for [existing issues](https://github.com/micropython/micropython/issues) matching this bug, and didn't find any.
+        required: true
+  - type: input
+    id: port-board-hw
+    attributes:
+      label: Port, board and/or hardware
+      description: |
+        Which MicroPython port(s) and board(s) are you using?
+      placeholder: |
+        esp32 port, ESP32-Fantastic board.
+    validations:
+       required: true
+  - type: textarea
+    id: version
+    attributes:
+      label: MicroPython version
+      description: |
+        To find the version:
+
+        1. Open a serial REPL.
+        2. Type Ctrl-B to see the startup message.
+        3. Copy-paste that output here.
+
+        If the issue is about building MicroPython, please provide output of `git describe --dirty` and as much information as possible about the build environment.
+
+        If the version or configuration is modified from the official MicroPython releases or the master branch, please tell us the details of this as well.
+      placeholder: |
+        MicroPython v6.28.3 on 2029-01-23; PyBoard 9 with STM32F9
+    validations:
+      required: true
+  - type: textarea
+    id: steps-reproduce
+    attributes:
+      label: Reproduction
+      description: |
+        What steps will reproduce the problem? Please include all details that could be relevant about the environment, configuration, etc.
+
+        If there is Python code to reproduce this issue then please either:
+        a. Type it into a code block below ([code block guide](https://docs.github.com/en/get-started/writing-on-github/working-with-advanced-formatting/creating-and-highlighting-code-blocks)), or
+        b. Post longer code to a [GitHub gist](https://gist.github.com/), or
+        c. Create a sample project on GitHub.
+
+        For build issues, please provide the exact build commands that you ran.
+      placeholder: |
+        1. Copy paste the code provided below into a new file
+        2. Use `mpremote run` to execute it on the board.
+    validations:
+      required: true
+  - type: textarea
+    id: expected
+    attributes:
+      label: Expected behaviour
+      description: |
+         What did you expect MicroPython to do? If comparing output with CPython or a different MicroPython port/version then please provide that output here.
+      placeholder: |
+        Expected to print "Hello World".
+
+        Here is the correct output, seen with previous MicroPython version v3.14.159:
+
+        > [...]
+  - type: textarea
+    id: what-happened
+    attributes:
+      label: Observed behaviour
+      description: |
+        What actually happened? Where possible please paste exact output, or the complete build log, etc. Very long output can be linked in a [GitHub gist](https://gist.github.com/).
+      placeholder: |
+        This unexpected exception appears:
+
+        > [...]
+    validations:
+      required: true
+  - type: textarea
+    id: additional
+    attributes:
+      label: Additional Information
+      description: |
+        Is there anything else that might help to resolve this issue?
+      value: No, I've provided everything above.
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for taking the time to help improve MicroPython.

.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,44 @@
+name: Documentation issue
+description: Report areas of the documentation or examples that need improvement
+title: "docs: "
+labels: ["documentation"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        This form is for reporting issues with the documentation or examples provided with MicroPython.
+
+        If you have a general question \"How Do I ...?\", please post it on [GitHub Discussions](https://github.com/orgs/micropython/discussions/) or [Discord](https://discord.gg/RB8HZSAExQ) instead of here.
+  - type: checkboxes
+    id: terms
+    attributes:
+      label: Checks
+      description: |
+        Before submitting your bug report, please go over these check points:
+      options:
+      - label: |
+           I agree to follow the MicroPython [Code of Conduct](https://github.com/micropython/micropython/blob/master/CODEOFCONDUCT.md) to ensure a safe and respectful space for everyone.
+        required: true
+      - label: |
+          I've searched for [existing issues](https://github.com/micropython/micropython/issues) and didn't find any that matched.
+        required: true
+  - type: input
+    id: page
+    attributes:
+      label: Documentation URL
+      description: |
+        Does this issue relate to a particular page in the [online documentation](https://docs.micropython.org/en/latest/)? If yes, please paste the URL of the page:
+      placeholder: |
+        https://docs.micropython.org/en/latest/
+  - type: textarea
+    id: version
+    attributes:
+      label: Description
+      description: |
+        Please describe what was missing from the documentation and/or what was incorrect/incomplete.
+    validations:
+      required: true
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for taking the time to help improve MicroPython.

.github/ISSUE_TEMPLATE/documentation.md

@@ -0,0 +1,65 @@
+name: Feature request
+description: Request a feature or improvement
+labels: ['enhancement']
+body:
+  - type: markdown
+    attributes:
+      value: |
+        This form is for requesting features or improvements in MicroPython.
+
+        #### Get feedback first
+
+        Before submitting a new feature idea here, suggest starting a discussion on [Discord](https://discord.gg/RB8HZSAExQ) or [GitHub Discussions](https://github.com/orgs/micropython/discussions/) to get early feedback from the community and maintainers.
+
+        #### Not a MicroPython core feature?
+
+        * If you have a question \"How Do I ...?\", please post it on GitHub Discussions or Discord instead of here.
+        * Could this feature be implemented as a pure Python library? If so, please open the request on the [micropython-lib repository](https://github.com/micropython/micropython-lib/issues) instead.
+  - type: checkboxes
+    id: terms
+    attributes:
+      label: Checks
+      description: |
+        Before submitting your feature request, please go over these check points:
+      options:
+      - label: |
+           I agree to follow the MicroPython [Code of Conduct](https://github.com/micropython/micropython/blob/master/CODEOFCONDUCT.md) to ensure a safe and respectful space for everyone.
+        required: true
+      - label: |
+          I've searched for [existing issues](https://github.com/micropython/micropython/issues) regarding this feature, and didn't find any.
+        required: true
+  - type: textarea
+    id: feature
+    attributes:
+      label: Description
+      description: |
+        Describe the feature you'd like to see added to MicroPython. What does this feature enable and why is it useful?
+
+        * For core Python features, where possible please include a link to the relevant PEP or CPython documentation.
+        * For new architectures / ports / boards, please provide links to relevant documentation, specifications, and toolchains. Any information about the popularity and unique features about this hardware would also be useful.
+        * For features for existing ports (e.g. new peripherals or microcontroller features), please describe which port(s) it applies to, and whether this is could be an extension to the machine API or a port-specific module?
+        * For drivers (e.g. for external hardware), please link to datasheets and/or existing drivers from other sources.
+
+        If there is an existing discussion somewhere about this feature, please add a link to it as well.
+    validations:
+      required: true
+  - type: textarea
+    id: size
+    attributes:
+      label: Code Size
+      description: |
+         MicroPython aims to strike a balance between functionality and code size. Can this feature be optionally enabled?
+
+         If you believe the usefulness of this feature would outweigh the additional code size, please explain. (It's OK to say you're unsure here, we're happy to discuss this with you.)
+  - type: checkboxes
+    id: implementation
+    attributes:
+      label: Implementation
+      options:
+      - label: I intend to implement this feature and would submit a Pull Request if desirable.
+      - label: I hope the MicroPython maintainers or community will implement this feature.
+      - label: I would like to [Sponsor](https://github.com/sponsors/micropython#sponsors) development of this feature.
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for taking the time to suggest improvements for MicroPython.

.github/ISSUE_TEMPLATE/documentation.yml

@@ -0,0 +1,59 @@
+name: Security report
+description: Report a security issue or vulnerability in MicroPython
+labels: ["security"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        This form is for reporting security issues in MicroPython that are not readily exploitable.
+
+        1. For issues that are readily exploitable or have high impact, please email [email protected] instead.
+        1. If this is a question about security, please ask it in [Discussions](https://github.com/orgs/micropython/discussions/) or [Discord](https://discord.gg/RB8HZSAExQ) instead.
+  - type: checkboxes
+    id: terms
+    attributes:
+      label: Checks
+      description: |
+        Before submitting your bug report, please go over these check points:
+      options:
+      - label: |
+           I agree to follow the MicroPython [Code of Conduct](https://github.com/micropython/micropython/blob/master/CODEOFCONDUCT.md) to ensure a safe and respectful space for everyone.
+        required: true
+      - label: I wish to report a specific security issue that is **not readily exploitable and does not have high impact** for MicroPython developers or users.
+        required: true
+      - label: |
+          I've searched for [existing issues](https://github.com/micropython/micropython/issues) and didn't find any that matched.
+        required: true
+  - type: input
+    id: port-board-hw
+    attributes:
+      label: Port, board and/or hardware
+      description: |
+        Which MicroPython port(s) and board(s) are you using?
+      placeholder: |
+        esp32 port, ESP32-Duper board.
+  - type: textarea
+    id: version
+    attributes:
+      label: MicroPython version
+      description: |
+        To find the version:
+
+        1. Open a serial REPL.
+        2. Type Ctrl-B to see the startup message.
+        3. Copy-paste that output here.
+
+        If the version or configuration is modified from the official MicroPython releases or the master branch, please tell us the details of this as well.
+      placeholder: |
+        MicroPython v6.28.3 on 2029-01-23; PyBoard 9 with STM32F9
+  - type: textarea
+    id: report
+    attributes:
+      label: Issue Report
+      description: |
+        Please provide a clear and concise description of the security issue.
+
+        * What does this issue allow an attacker to do?
+        * How does the attacker exploit this issue?
+    validations:
+      required: true

.github/ISSUE_TEMPLATE/feature_request.md

@@ -18,13 +18,3 @@ jobs:
       run: source tools/ci.sh && ci_c_code_formatting_run
     - name: Check code formatting
       run: git diff --exit-code
-
-  code-spelling:
-    runs-on: ubuntu-latest
-    steps:
-    - uses: actions/checkout@v4
-    - uses: actions/setup-python@v5
-    - name: Install packages
-      run: source tools/ci.sh && ci_code_spell_setup
-    - name: Run spell checker
-      run: source tools/ci.sh && ci_code_spell_run