devela_macros

Procedural macros for devela.

See the documentation for more information.

Status

This is currently in an experimental stage of development.

License

This project is dual licensed under either MIT or Apache-2.0 at your option.

Contributing

Contributions are welcomed to help refine and improve this library over time. If you notice a bug, have an idea for a new feature, or simply want to suggest improvements to the existing codebase, please get in touch.

lib.rs:

Conditional compilation

Each form of conditional compilation takes a compilation predicate that evaluates to true or false.

These are the [#[compile]][compile()] and [#[compile_attr]][compile_attr()] attributes and the [cif!][cif()] macro.

They are similar to the #[cfg] and #[cfg_attr] attributes and the cfg! macro, except they use compilation predicates.

Compilation predicates

The following compilation predicates are supported:

• unary:

  • A bare predicate returns true only if it is the true literal
  • not(): returns true only if the predicate does not evaluate to true.

• binary:

  • eq(): returns true if both predicates are evaluated as equal.
  • ne(): returns true if both predicates are not evaluated as equal.
  • xor(): returns true if only one predicate is true, but not both.
  • ge(): returns true if both predicates are numbers and the first >= the second.
  • gt(): returns true if both predicates are numbers and the first > the second.
  • le(): returns true if both predicates are numbers and the first <= the second.
  • lt(): returns true if both predicates are numbers and the first < the second.

• non-binary:

  • any(): returns true if any predicate is true.
  • all(): returns true if all predicates are true.
  • none(): returns true if there is no given predicate.
  • some(): returns true if there is some given predicate.
  • diff(): returns true if any predicate has a different text.
  • same(): returns true if all the predicates have the same text.
  • xany(): returns true if there are any true predicates, but not all.
  • xodd(): returns true if there is an odd number of true predicates.
  • xone(): returns true if there is just one true predicate, but no more.

When more than 1 predicate is supported, they are separated by commas.