22 stable releases

2.0.3 Nov 29, 2023
2.0.0 Aug 11, 2022
1.10.0 Dec 5, 2021
1.9.0 Aug 21, 2021
1.2.1 Feb 16, 2019

#104 in Rust patterns

Download history 30080/week @ 2025-01-28 37567/week @ 2025-02-04 33365/week @ 2025-02-11 33853/week @ 2025-02-18 32453/week @ 2025-02-25 27526/week @ 2025-03-04 32916/week @ 2025-03-11 37544/week @ 2025-03-18 32963/week @ 2025-03-25 31109/week @ 2025-04-01 36623/week @ 2025-04-08 27687/week @ 2025-04-15 30529/week @ 2025-04-22 44632/week @ 2025-04-29 38680/week @ 2025-05-06 21563/week @ 2025-05-13

140,280 downloads per month
Used in 46 crates (22 directly)

MPL-2.0 license

20KB
150 lines

Travis (.com) Crates.io docs.rs license

lazy_format

A [no_std] library for lazily formatting things. Because allocating temporary strings just to write them to a buffered stream is bad for your health.

use std::io;

use lazy_format::lazy_format;
use joinery::JoinableIterator;

fn main() {
	let result = (0..10)
		.map(|value| lazy_format!("\t'{}'", value))
		.join_with("\n")
		.to_string();

	assert_eq!(result,
"	'0'
	'1'
	'2'
	'3'
	'4'
	'5'
	'6'
	'7'
	'8'
	'9'")
}

The above example is the key motivating example: when building up some kind of object you wish to write or format, there's no reason to allocate intermediary strings (which is what format! does). Instead, lazy_format! captures its arguments and returns an opaque struct with a Display implementation, so that the actual formatting can happen directly into its final destination buffer (such as a file or string).

No runtime deps