Crates.io | require_lifetimes |
lib.rs | require_lifetimes |
version | 0.3.0 |
source | src |
created_at | 2023-01-07 05:40:48.288239 |
updated_at | 2023-01-08 00:05:13.280309 |
description | A proc-macro to force rust authors to write lifetimes in function signatures. |
homepage | |
repository | https://github.com/tfpk/require_lifetimes |
max_upload_size | |
id | 752785 |
size | 29,658 |
Require Lifetimes is a crate which provides the #[require_lifetimes]
annotation.
This annotation ensures that the annotated function must have lifetimes for
every reference in its signature. In other words, it forces the author to
not rely on lifetime elision for a given function. It also stops the author
from using the anonymous lifetime '_
.
The intent behind this crate is to force the user to actually understand lifetimes. This will be useful when teaching students how lifetimes work, or when trying to write explanatory material. This crate should not be used in production applications, as adding unnecessary lifetimes is an anti-pattern.
See the ui_tests
folder for examples of programs with this annotation.
Files ending in _err.rs_
have a corresponding .stderr
that shows what
their output will be.