# `textwrap-macros` [](https://github.com/althonos/textwrap-macros/stargazers)
*Simple procedural macros to use [`textwrap`] utilities at compile time.*
[`textwrap`]: https://github.com/mgeisler/textwrap
[](https://travis-ci.com/althonos/textwrap-macros/branches)
[](https://codecov.io/gh/althonos/textwrap-macros)
[](https://choosealicense.com/licenses/mit/)
[](https://github.com/althonos/textwrap-macros)
[](https://crates.io/crates/textwrap-macros)
[](https://docs.rs/textwrap-macros)
[](https://github.com/althonos/textwrap-macros.rs/blob/master/CHANGELOG.md)
## Usage
Add the `textwrap-macros` crate to the `Cargo.toml` manifest:
```toml
[dependencies]
textwrap-macros = "0.1"
```
Then either use the macros using the old-style `#[macro_use]` or import them as
any other crate member:
```rust
use textwrap_macros::dedent;
const poem: &str = dedent!(r#"
When we two parted
In silence and tears,
Half broken-hearted
To sever for years,
Pale grew thy cheek and cold,
Colder thy kiss;
Truly that hour foretold
Sorrow to this.
"#);
```
Check out the [documentation of the original library](https://docs.rs/textwrap/)
for more information about the behaviour of each of the wrapped functions.
## Changelog
This project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.html)
and provides a [changelog](https://github.com/althonos/textwrap-macros/blob/master/CHANGELOG.md)
in the [Keep a Changelog](http://keepachangelog.com/en/1.0.0/) format.