version 0.29.3

Author: Canop

CHANGELOG.md

@@ -1,5 +1,9 @@
 *If you're reading this because you try make sense of some new API or a breaking change, you might also be interested in coming to the chat for explanations or guidance.*
 
+<a name="v0.29.3"></a>
+### v0.29.3 - 2024-06-13
+- `ask!` macro doesn't need separate imports anymore
+
 <a name="v0.29.2"></a>
 ### v0.29.2 - 2024-04-24
 - update Crokey to 1.0.0

Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "termimad"
-version = "0.29.2"
+version = "0.29.3"
 authors = ["dystroy <denys.seguret@gmail.com>"]
 repository = "https://github.com/Canop/termimad"
 description = "Markdown Renderer for the Terminal"

src/area.rs

@@ -9,10 +9,6 @@ const DEFAULT_TERMINAL_WIDTH: u16 = 50;
 /// A default height which is used when we failed measuring the real terminal width
 const DEFAULT_TERMINAL_HEIGHT: u16 = 20;
 
-pub trait AreaContent {
-    fn height() -> u16;
-}
-
 /// A rectangular part of the screen
 #[derive(Debug, PartialEq, Eq, Clone)]
 pub struct Area {

src/ask.rs

@@ -102,16 +102,27 @@ impl Question {
 /// ask the user to choose among proposed answers.
 ///
 /// This macro makes it possible to propose several choices, with
-/// an optional default ones, to execute blocks, to optionaly return
+/// an optional default one, to execute blocks, to optionaly return
 /// a value.
 ///
-/// Example:
+/// Example of a simple confirmation::
+///
+/// ```no_run
+/// let confirmed = termimad::ask!(
+///     termimad::get_default_skin(),
+///     "Do you want to erase the disk ?", ('n') {
+///         ('y', "**Y**es") => { true }
+///         ('n', "**N**o") => { false }
+///     }
+/// );
+/// ```
+///
+/// Example of chained questions:
 ///
 /// ```no_run
 /// use termimad::*;
 ///
 /// let skin = get_default_skin();
-///
 /// let beverage = ask!(skin, "What do I serve you ?", {
 ///     ('b', "**B**eer") => {
 ///         ask!(skin, "Really ? We have wine and orange juice too", (2) {
@@ -139,9 +150,9 @@ macro_rules! ask {
         $question: expr,
         { $(($key: expr, $answer: expr) => $r: block)+ }
     ) => {{
-        let mut question = Question {
+        let mut question = $crate::Question {
             md: Some($question.to_string()),
-            answers: vec![$(Answer { key: $key.to_string(), md: $answer.to_string() }),*],
+            answers: vec![$($crate::Answer { key: $key.to_string(), md: $answer.to_string() }),*],
             default_answer: None,
         };
         let key = question.ask($skin).unwrap();
@@ -159,9 +170,9 @@ macro_rules! ask {
         ($default_answer: expr)
         { $(($key: expr, $answer: expr) => $r: block)+ }
     ) => {{
-        let mut question = Question {
+        let mut question = $crate::Question {
             md: Some($question.to_string()),
-            answers: vec![$(Answer { key: $key.to_string(), md: $answer.to_string() }),*],
+            answers: vec![$($crate::Answer { key: $key.to_string(), md: $answer.to_string() }),*],
             default_answer: Some($default_answer.to_string()),
         };
         if question.has_exotic_default() {