Macros, API guide, and best practices

I've never authored a public library (yet). As I was thinking about the process while reading https://rust-lang.github.io/api-guidelines/checklist.html I noticed it was relatively short on hints for macros.

I'm curious if folks have other best practices around exporting macros...

As an example, I am wondering if there's any merit to trying to limit macros use in public APIs? Are tools like rust semver paying attention to then the same as functions?

Having some c++ experience I'm somewhat apprehensive about macros, even knowing they're substantially different in rust :grinning:

I mean, if you have a legitimate use case for macros in your public api go ahead.

1 Like