Skip to content

Fix the Arduino Lint check - #9

Merged
Forairaaaaa merged 2 commits into
m5stack:mainfrom
ainyan03:arduino_lint_fixes
Aug 28, 2026
Merged

Fix the Arduino Lint check#9
Forairaaaaa merged 2 commits into
m5stack:mainfrom
ainyan03:arduino_lint_fixes

Conversation

@ainyan03

@ainyan03 ainyan03 commented Aug 28, 2026

Copy link
Copy Markdown
Contributor

The Arduino Lint Check workflow has failed on every run of main since April (it is not caused by any particular PR). Running arduino-lint --compliance strict --library-manager update locally reproduces the CI result: 3 errors, 1 warning.

What fails and why

Rule Message Cause
LP052 (error) library.properties includes field item(s) src, src/utils not found in library includes= must list header files, not directories
LS008 (warning) No header file found matching library name (StackChan-BSP.h) best practice: primary header named after the library
LP018 (error) Library name StackChan-BSP not found in the Library Manager index the library is not registered in the Arduino Library Manager, and library-manager: update in the workflow asks arduino-lint to enforce the registration rules
LP042 (error) Unable to load the library.properties url field: ... unexpected EOF transient network error on the runner; the URL is valid and this does not reproduce locally

Changes

  1. library.properties: includes=M5StackChan.h, and add src/StackChan-BSP.h as the primary header (it only includes M5StackChan.h, so existing sketches are unaffected). This clears LP052 and LS008.
  2. Workflow: library-manager: submit. LP018 cannot be fixed from the repository content; it only goes away once the library has been accepted into the Library Manager index. submit is arduino-lint's mode for a library that is not in the index yet: it keeps the pre-registration checks active without requiring the name to be present. Switch to update once the library has been accepted — feel free to drop this commit if you prefer to keep the red check as a reminder.

With both commits arduino-lint --compliance strict --library-manager submit reports no errors or warnings for the library and all examples.

The includes field must list header files, not directories; arduino-lint
rejected "src,src/utils" (LP052). List the primary header instead.

Add StackChan-BSP.h as the primary header named after the library
(LS008, best practice); it only includes M5StackChan.h so existing
sketches are unaffected.
With library-manager: update, arduino-lint fails on LP018 because
StackChan-BSP is not in the Library Manager index, so the check has been
red on every run. Use the "submit" mode, which applies the rules for a
library that is about to be submitted (so the pre-registration checks stay
active) without requiring the name to be in the index yet. Switch to
"update" once the library has been accepted into the index.
@ainyan03
ainyan03 force-pushed the arduino_lint_fixes branch from 3f7e3e4 to c9c30a2 Compare August 28, 2026 05:02
@Forairaaaaa

Copy link
Copy Markdown
Contributor

Thanks!

@Forairaaaaa
Forairaaaaa merged commit f4ae3c0 into m5stack:main Aug 28, 2026
3 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants