Macros
Instead of providing procedural macros, like git_ref_format this
crate just provides much simpler declarative macros, guarded by the feature
flag macro.
Comparison to git_ref_format
Benefits
- Does not depend on
radicle-git-ext. - Does not pull in procedural macro dependencies.
- Has much smaller compile-time overhead than
git_ref_format.
Drawback
The main drawback is that the macros in this crate cannot provide compile time validation of the argument. Thus, these macros must be used in conjunction with testing: If all generated objects are used in tests, and these tests are run, then the guarantees are equally strong. Consumers that do not or cannot test their code should not use the macros then.