new: add italic, strike, and blink to fyi_ansi

remove: ">" and "~" `ansi` modifiers
misc: support trailing commas for `ansi` and shortcut macros

Author: joshstoik1

fyi_ansi/README.md

@@ -8,7 +8,8 @@
 [![license](https://img.shields.io/badge/license-wtfpl-ff1493?style=flat-square)](https://en.wikipedia.org/wiki/WTFPL)
 
 This crate exports two simple compile-time ANSI formatting macros — `csi` and
-`ansi` — as well as shortcut helpers for `bold`, `dim`, and `underline`.
+`ansi` — as well as shortcut helpers for `blink`, `bold`, `dim`,
+`italic`, `strike`, and `underline`.
 
 ## Examples
 
@@ -25,20 +26,22 @@ assert_eq!(
 );
 ```
 
-The `dim`, `bold`, and `underline` macros are only shortcuts, but can
-help declutter your code when there's only the one style being toggled.
+The `bold`, `dim`, etc., macros are only shortcuts, but can help declutter
+your code when there's only the one style being toggled.
 
 ```rust
-use fyi_ansi::{bold, dim, underline};
+use fyi_ansi::{blink, bold, dim, italic, strike, underline};
 
 // Same as with `ansi`, they terminate with a blanket reset by default.
-assert_eq!(bold!("I'm bold!"),              "\x1b[1mI'm bold!\x1b[0m");
-assert_eq!(dim!("I'm dim!"),                "\x1b[2mI'm dim!\x1b[0m");
-assert_eq!(underline!("I'm underlined!"),   "\x1b[4mI'm underlined!\x1b[0m");
-
-// And same as `ansi`, the ">" modifier will make them terminate more
-// selectively instead.
-assert_eq!(bold!(> "I'm bold!"),            "\x1b[1mI'm bold!\x1b[21m");
-assert_eq!(dim!(> "I'm dim!"),              "\x1b[2mI'm dim!\x1b[22m");
-assert_eq!(underline!(> "I'm underlined!"), "\x1b[4mI'm underlined!\x1b[24m");
+assert_eq!(bold!("I'm bold!"),            "\x1b[1mI'm bold!\x1b[0m");
+assert_eq!(dim!("I'm dim!"),              "\x1b[2mI'm dim!\x1b[0m");
+assert_eq!(italic!("I'm italic!"),        "\x1b[3mI'm italic!\x1b[0m");
+assert_eq!(underline!("I'm underlined!"), "\x1b[4mI'm underlined!\x1b[0m");
+assert_eq!(blink!("I'm annoying!"),       "\x1b[5mI'm annoying!\x1b[0m");
+assert_eq!(strike!("I'm struck!"),        "\x1b[9mI'm struck!\x1b[0m");
 ```
+
+## Stability
+
+This library is currently under development and subject to breaking changes
+between dot releases, though the basic API is pretty well set.

fyi_ansi/build.rs

@@ -73,12 +73,18 @@ fn macro_codes() -> BTreeMap<Cow<'static, str>, Cow<'static, str>> {
 	// Reset bold, dim, underline.
 	out.insert(Cow::Borrowed("!bold"), Cow::Borrowed("21"));
 	out.insert(Cow::Borrowed("!dim"), Cow::Borrowed("22"));
+	out.insert(Cow::Borrowed("!italic"), Cow::Borrowed("23"));
 	out.insert(Cow::Borrowed("!underline"), Cow::Borrowed("24"));
+	out.insert(Cow::Borrowed("!blink"), Cow::Borrowed("25"));
+	out.insert(Cow::Borrowed("!strike"), Cow::Borrowed("29"));
 
 	// Enable bold, dim, underline.
 	out.insert(Cow::Borrowed("bold"), Cow::Borrowed("1"));
 	out.insert(Cow::Borrowed("dim"), Cow::Borrowed("2"));
+	out.insert(Cow::Borrowed("italic"), Cow::Borrowed("3"));
 	out.insert(Cow::Borrowed("underline"), Cow::Borrowed("4"));
+	out.insert(Cow::Borrowed("blink"), Cow::Borrowed("5"));
+	out.insert(Cow::Borrowed("strike"), Cow::Borrowed("9"));
 
 	// Now the colors!
 	for (k, v) in (u8::MIN..=u8::MAX).zip(COLORS.iter().map(|(v, _)| v)) {