1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
use std::env;
use std::error::Error;
use std::fs;

/// Estructura de configuración que se utiliza
/// como parámetro para la función search
pub struct Config {
    /// Guardara el patron que se necesita buscar
    pub query: String,

    /// Guardara el nombre del archivo a escanear
    pub filename: String,

    /// Servirá para hacer una búsqueda que distinga
    /// entre mayúsculas en caso de ser false, por el caso
    /// contrario solo devolverá cadenas que coincidan en
    /// capitalización
    pub case_sensitive: bool,
}

/// Implementación de la configuración que contiene
/// Métodos esenciales para el funcionamiento del programa.
impl Config {
    /// Función constructora encargada de inicializar una instancia
    /// de Config, recibe los en los argumentos el tipo env::Args
    /// que consiste en las opciones que se ingresa junto con el
    /// comando.
    ///
    /// # Errors
    ///
    /// En caso de que no se ingrese ningún argumento al llamar a la
    /// función se retornara el error, "Didn't get a query string"
    /// Si se ingresan todo funciona correctamente se retornara
    /// un OK, con la estructura Config iniciada.
    pub fn new(mut args: env::Args) -> Result<Config, &'static str> {
        args.next();

        let query = match args.next() {
            Some(arg) => arg,
            None => return Err("Didn't get a query string"),
        };

        let filename = match args.next() {
            Some(arg) => arg,
            None => return Err("Didn't get a query string"),
        };

        let case_sensitive = env::var("CASE_INSENSITIVE").is_err();

        Ok(Config {
            query,
            filename,
            case_sensitive,
        })
    }
}

/// Recibe una instancia de Config con los parametros para
/// ejecutar la funcion search y imprimir por pantalla cada
/// coincidencia.
///
/// # Example
///
/// ``` rust
/// use minigrep_fracoxza::Config;
/// use minigrep_fracoxza::run;
///
/// let config = Config {
///     query: String::from("test"),
///     filename: String::from("./test.txt"),
///     case_sensitive: true,
/// };
///
/// let result = match run(config) {
///     Ok(v) => assert_eq!((), v),
///     Err(_) => panic!("An error"),
/// };
///
/// ```
///
pub fn run(config: Config) -> Result<(), Box<dyn Error>> {
    let contents = fs::read_to_string(config.filename)?;

    let results = if config.case_sensitive {
        search(&config.query, &contents)
    } else {
        search_case_insensitive(&config.query, &contents)
    };

    for line in results {
        println!("{}", line);
    }

    Ok(())
}

/// Esta función buscara un elemento en una lista siendo estricto en
/// cuanto a mayúsculas y minúsculas
///
/// # Examples
///
/// ```
/// let contents = String::from("Probando la función\nEsta linea no se debería ver");
/// let query = String::from("and");
///
/// let results = minigrep_fracoxza::search(&query, &contents);
///
/// assert_eq!(results, vec!["Probando la función"]);
///
/// ```
pub fn search<'a>(query: &str, contents: &'a str) -> Vec<&'a str> {
    contents
        .lines()
        .filter(|line| line.contains(query))
        .collect()
}

/// Esta función buscara un elemento en una lista sin distinguir entre
/// mayúsculas y minúsculas
///
/// # Examples
///
/// ```
/// let contents = String::from("ProbAnDo la función\nEsta linea no se debería ver");
/// let query = String::from("aNdO");
///
/// let results = minigrep_fracoxza::search_case_insensitive(&query, &contents);
///
/// assert_eq!(results, vec!["ProbAnDo la función"]);
///
/// ```
pub fn search_case_insensitive<'a>(query: &str, contents: &'a str) -> Vec<&'a str> {
    let query = query.to_lowercase();
    let str_query = query.as_str();

    contents
        .lines()
        .filter(|line| line.to_lowercase().contains(str_query))
        .collect()
}

#[cfg(test)]
mod tests {
    use super::*;
    
    #[test]
    fn case_sensitive() {
        let query = "duct";
        let contents = "\
Rust:
safe, fast, productive.
Pick three.
Duck tape.";
        assert_eq!(vec!["safe, fast, productive."], search(query, contents));
    }

    #[test]
    fn case_insensitive() {
        let query = "rUsT";
        let contents = "\
Rust:
safe, fast, productive.
Pick three.
Trust me.";

        assert_eq!(
            vec!["Rust:", "Trust me."],
            search_case_insensitive(query, contents)
        )
    }
}