feat: Add text! macro

README.md

@@ -145,6 +145,19 @@ let line = line!["hello", format!("{name}")];
 let line = line!["bye"; 2];
 ```
 
+## Line
+
+The `text!` macro creates a `Text` that contains a sequence of lines. It is similar to the `vec!` macro.
+
+```rust
+use ratatui::prelude::*;
+use ratatui_macros::{span, line, text};
+
+let name = "world!";
+let text = text![span!(Modifier::BOLD; "hello"), line![format!("{name}")]];
+let text = text!["bye"; 2];
+```
+
 ## Contributing
 
 Contributions to `ratatui-macros` are welcome! Whether it's submitting a bug report, a feature

src/lib.rs

@@ -3,3 +3,4 @@
 mod layout;
 mod line;
 mod span;
+mod text;

src/text.rs

@@ -0,0 +1,73 @@
+/// A macro for creating a [`Text`] using vec! syntax.
+///
+/// `text!` is similar to the [`vec!`] macro, but it returns a [`Text`] instead of a `Vec`.
+///
+/// # Examples
+///
+/// * Create a [`Text`] containing a vector of [`Line`]s:
+///
+/// ```rust
+/// # use ratatui::prelude::*;
+/// use ratatui_macros::text;
+///
+/// let text = text!["hello", "world"];
+/// let text = text!["hello".red(), "world".red().bold()];
+/// ```
+///
+/// * Create a [`text`] from a given [`Line`] repeated some amount of times:
+///
+/// ```rust
+/// # use ratatui::prelude::*;
+/// use ratatui_macros::text;
+///
+/// let text = text!["hello"; 2];
+/// ```
+///
+/// * Use [`line!`] or [`span!`] macro inside [`text!`] macro.
+///
+/// ```rust
+/// # use ratatui::prelude::*;
+/// use ratatui_macros::{line, text, span};
+///
+/// let text = text![line!["hello", "world"], span!(Modifier::BOLD; "goodbye {}", "world")];
+/// ```
+///
+/// [`Text`]: crate::text::Text
+/// [`Line`]: crate::text::Line
+/// [`Span`]: crate::text::Span
+#[macro_export]
+macro_rules! text {
+    () => {
+        ratatui::text::Text::default()
+    };
+    ($line:expr; $n:expr) => {
+      ratatui::text::Text::from(vec![$line.into(); $n])
+    };
+    ($($line:expr),+ $(,)?) => {{
+        ratatui::text::Text::from(vec![
+        $(
+            $line.into(),
+        )+
+        ])
+    }};
+}
+
+#[cfg(test)]
+mod tests {
+    use ratatui::prelude::*;
+
+    #[test]
+    fn text() {
+        // literal
+        let text = text!["hello", "world"];
+        assert_eq!(text, Text::from(vec!["hello".into(), "world".into()]));
+
+        // explicit use of span and line
+        let text = text![crate::span!("hello"), crate::line!["world"]];
+        assert_eq!(text, Text::from(vec!["hello".into(), "world".into()]));
+
+        // vec count syntax
+        let text = text!["hello"; 2];
+        assert_eq!(text, Text::from(vec!["hello".into(), "hello".into()]));
+    }
+}