Skip to content

Add mruby/ to the public header file path for mrbgems - #6671

Closed
dearblue wants to merge 1 commit into
mruby:masterfrom
dearblue:hal
Closed

Add mruby/ to the public header file path for mrbgems#6671
dearblue wants to merge 1 commit into
mruby:masterfrom
dearblue:hal

Conversation

@dearblue

Copy link
Copy Markdown
Contributor

Commit f81cadf identifies this as a local header file, but it is actually externally exposed. This means it is included in the output of mruby-config --cflags and is therefore accessible to projects linking with pre-built libmruby.

To avoid conflicts with other projects, we add mruby/ as a directory prefix.

Commit f81cadf identifies this as a local header file, but it is actually externally exposed.
This means it is included in the output of `mruby-config --cflags` and is therefore accessible to projects linking with pre-built libmruby.

To avoid conflicts with other projects, we add `mruby/` as a directory prefix.
@dearblue
dearblue requested a review from matz as a code owner November 23, 2025 13:08
@gemini-code-assist

Copy link
Copy Markdown
Contributor

Summary of Changes

Hello @dearblue, I'm Gemini Code Assist1! I'm currently reviewing this pull request and will post my feedback shortly. In the meantime, here's a summary to help you and other reviewers quickly get up to speed!

This pull request addresses a potential issue where mrbgems' public header files could cause conflicts with other projects due to their inclusion in mruby-config --cflags. By consistently adding an mruby/ prefix to these header paths, the change standardizes their external exposure and mitigates naming collision risks, improving overall library compatibility.

Highlights

  • Standardized Public Header Paths: Public header files for mrbgems, previously identified as local, are now explicitly prefixed with mruby/ in their include paths. This ensures they are treated as external headers.
  • Conflict Prevention: The change prevents potential naming conflicts with other projects when linking against a pre-built libmruby, as these headers are exposed via mruby-config --cflags.
  • File Renames and Include Updates: Several _hal.h and task.h files within mrbgems have been renamed to include the mruby/ directory prefix, and all corresponding #include directives in .c files have been updated to reflect these new paths.
Using Gemini Code Assist

The full guide for Gemini Code Assist can be found on our documentation page, here are some quick tips.

Invoking Gemini

You can request assistance from Gemini at any point by creating a comment using either /gemini <command> or @gemini-code-assist <command>. Below is a summary of the supported commands on the current page.

Feature Command Description
Code Review /gemini review Performs a code review for the current pull request in its current state.
Pull Request Summary /gemini summary Provides a summary of the current pull request in its current state.
Comment @gemini-code-assist Responds in comments when explicitly tagged, both in pull request comments and review comments.
Help /gemini help Displays a list of available commands.

Customization

To customize Gemini Code Assist for GitHub experience, repository maintainers can create a configuration file and/or provide a custom code review style guide (such as PEP-8 for Python) by creating and adding files to a .gemini/ folder in the base of the repository. Detailed instructions can be found here.

Limitations & Feedback

Gemini Code Assist may make mistakes. Please leave feedback on any instances where its feedback is incorrect or counter productive. You can react with 👍 and 👎 on @gemini-code-assist comments. If you're interested in giving your feedback about your experience with Gemini Code Assist for Github and other Google products, sign up here.

You can also get AI-powered code generation, chat, as well as code reviews directly in the IDE at no cost with the Gemini Code Assist IDE Extension.

Footnotes

  1. Review the Privacy Notices, Generative AI Prohibited Use Policy, Terms of Service, and learn how to configure Gemini Code Assist in GitHub here. Gemini can make mistakes, so double check it and use code with caution.

@gemini-code-assist gemini-code-assist Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request correctly refactors the public header include paths for several mrbgems by adding an mruby/ prefix, which is an excellent practice for avoiding naming conflicts in larger projects. The changes are consistent across the modified files. I have added a couple of minor suggestions to improve header include consistency for better long-term maintainability.

Comment on lines 41 to +42
#include <mruby/ext/io.h>
#include "socket_hal.h"
#include <mruby/socket_hal.h>

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

For consistency with other files in the project, it's good practice to group all project-specific headers together. The blank line at line 40 separates these includes from the main block of mruby headers above. Consider removing the blank line and grouping all mruby headers together to improve readability and maintainability.

Comment on lines +22 to +23
#include <mruby/task.h>
#include <mruby/task_hal.h>

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

For consistency with other files in this project and general best practices, it's recommended to group all project-specific headers together. These mruby/ headers are currently separated from the main block of mruby headers by standard library includes. Consider moving them up to be with the other mruby headers (before line 19) to improve readability and maintainability.

@matz matz closed this in c521d83 Dec 11, 2025
@matz

matz commented Dec 12, 2025

Copy link
Copy Markdown
Member

By c521d83, header files under include/ are only visible to gems that depend on them. If you want to expose your API, put the header files under include/export.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants