![\"Estrutura](\"midia/super-minigrep/%7B1%7D.png\")
Não, eu não quero ajudar você a organizar seu quarto!
\nBom, como eu avia dito no artigo anterior tava querendo fazer esse projetinho do grep do Rust e aplicar algumas melhorias nele, e acho que a primeira coisa que devemos fazer quando pensamos em fazer uma refatoração do nível que comentei no artigo anterior (que esta aqui ó: Super minigrep) é uma organização clara e objetiva, para que assim novos desenvolvedores possam entrar no projeto, e não terem que lidar com arquivos enormes (na medida do possível)
\nDeixei uma Branch criada dentro do repositório mas aqui esta uma fotografia digital do estado atual que quero dizer\n
Consegue ver?? como as pessoas vão conseguir trabalhar aqui?? me fala!!! não tem como, então vamos primeiro aplicar melhorias na organização do projeto para ai sim, aplicar melhorias verdadeiras.
\nÉ ISSO QUE NOS QUEREMOS! ARQUIVOS QUE GRITEM SEUS NOMES, SEU CANTO DE GUERRA, PRONTOS PARA A BATALHA!
\nSe você já leu o capitulo 2 de Clean Code (☝️🤓) sabe oque eu quero dizer aqui, os nomes devem revelar o seu proposito, e creio fielmente nisso, então vamos começar com isso antes de qualquer coisa, sem alterar profundamente o código, isso tem que ficar para depois, para facilitar as mentes mais lentas (eu) e criar até mesmo um histórico de alterações mais tangível e real.
\nEntão vamos começar com a configuração, ela é a nossa porta de entrada, crie um arquivo 'config.rs' e remova toda a parte de configuração e parâmetros da nossa mini CLI de dentro do lib.rs, teremos algo assim (caso você não tenha ansiedade e já começou a implementar algo):
\nuse std:: env; \n\npub struct Config { \n pub query : String , \n pub filename : String , \n pub case_sensitive : bool , \n} \n\nimpl Config { \n pub fn new ( args : & [ String ]) -> Result < Config , & str > { \n let mut case_sensitive = false ; \n if ( args. len () == 4 ) && ( args[ 3 ] == "--case-sensitive" ) { \n case_sensitive = true ; \n } \n if args. len () < 3 { \n return Err ( "not enough arguments" ); \n } \n\n let query = args[ 1 ]. clone (); \n let filename = args[ 2 ]. clone (); \n\n if !case_sensitive { \n case_sensitive = !env:: var ( "CASE_SENSITIVE" ). is_err (); \n } \n\n Ok ( Config { \n query, \n filename, \n case_sensitive, \n }) \n } \n} Com isso temos um arquivo com toda a regra de validação dos argumentos fornecidos pelo nosso usuário, etapa importante para nosso projetos, nossas ideias são enormes para esse projeto, uma CLI precisa de um bom parser de argumentos. (sim sim sim, eu sei que poderíamos estar utilizando Clap para reduzir tudo isso em meras configurações triviais, mas para manter a magia da coisa, vamos manter dessa forma)
\nSim, eu sei que sou péssimo com nomes (ficou claro com o nome desse projeto), mas acho que esse vai passar bem a vibes que desejamos aqui, um buscador, um achador (é isso ai, kkkk)
\nEntão já sabemos oque temos que fazer, crie um arquivo 'finder.rs' e vamos encapsular as duas funções de busca que nos foram ensinadas dentro de um struct de mesmo nome, dessa forma nas nossas melhorias futuras tudo vai fazer sentido, tudo! se você tiver um pouco de conhecimento em Rust, deve ter chegado em algo parecido com isso:
\npub struct Finder ; \n\nimpl Finder { \n pub fn search < ' a >( query : & str , contents : &' a str ) -> Vec < &' a str > { \n let mut result = Vec :: new (); \n for line in contents. lines () { \n if line. contains ( query) { \n result. push ( line); \n } \n } \n result\n } \n\n pub fn search_case_insensitive < ' a >( query : & str , contents : &' a str ) -> Vec < &' a str > { \n let mut result = Vec :: new (); \n for line in contents. lines () { \n if line. to_lowercase (). contains ( & query. to_lowercase ()) { \n result. push ( line); \n } \n } \n result\n } \n} \n\n# [ cfg ( test )] \nmod tests { \n use super :: * ; \n\n # [ test ] \n fn case_sensitive () { \n let query = "duct" ; \n let contents = "\\\nRust:\nsafe, fast, productive.\nPick three.\nDuct Tape." ; \n assert_eq! ( \n vec! [ "safe, fast, productive." ], \n Finder :: search ( query, contents) \n ); \n } \n\n # [ test ] \n fn case_insensitive () { \n let query = "rUsT" ; \n let contents = "\\\nRust:\nsafe, fast, productive.\nPick three.\nTrust me." ; \n assert_eq! ( \n vec! [ "Rust:" , "Trust me." ], \n Finder :: search_case_insensitive ( query, contents) \n ); \n } \n} Nossos amigos do livro já deixaram testes feitos, lembra deles? pois então, em Rust deixamos os testes unitários dentro dos próprios arquivos, la em baixo, pode copiar e adaptar pra funcionar com suas próprias structs.
\nBom se tudo deu certo ai, vamos precisar arrumar aqui também, o coração da CLI vive aqui, onde vamos expor nossas regras de negocio para que seja usavel pelo programa compilado, eu criei um struct chamada SuperMiniGrep dentro de 'lib.rs' e joguei a função run dentro dela e arrumei os imports e tudo mais, ficou assim:
\npub mod config; \nmod finder; \n\nuse crate :: config:: Config ; \nuse crate :: finder:: Finder ; \nuse std:: error:: Error ; \nuse std:: fs; \n\npub struct SuperMiniGrep ; \n\nimpl SuperMiniGrep { \n pub fn run ( config : Config ) -> Result <(), Box < dyn Error >> { \n let contents = fs:: read_to_string ( config. filename ) ?; \n\n let result = if config. case_sensitive { \n Finder :: search ( & config. query , & contents) \n } else { \n Finder :: search_case_insensitive ( & config. query , & contents) \n }; \n for line in result { \n println! ( "{}" , line); \n } \n\n Ok (()) \n } \n} Com tudo isso feito, nossa cli já deve compilar, mas primeiros vamos rodar os testes e ver se ta tudo passando né:
\n![\"Testes](\"midia/super-minigrep/%7B2%7D.png\")
Tudo certo, nossas alterações não quebraram a CLI no meio, um grande avanço para nós não acha?
\ne com tudo isso nossa main.rs fica muito parecida, quase que intocada, porem os benefícios vão ser visíveis a longo prazo!
\nuse std:: env; \nuse std:: process; \n\nuse super_minigrep::{ SuperMiniGrep , config:: Config }; \n\nfn main () { \n let args: Vec < String > = env:: args (). collect (); \n\n let config = Config :: new ( & args). unwrap_or_else ( |err| { \n eprintln! ( "Problem parsing arguments: {}" , err); \n process:: exit ( 1 ); \n }); \n\n if let Err ( e) = SuperMiniGrep :: run ( config) { \n eprintln! ( "Application error: {}" , e); \n process:: exit ( 1 ); \n } \n} Bom isso aqui ficou maior do que eu esperava, sei que prometi no artigo anterior já fazer melhorias no código em si, mas acho que foi um passo importante para o soberania do super-minigrep.
\ne foi assim que ficou a estrutura do projeto, podemos fazer muitas outras melhorias, mas com o tempo se tudo ir se encaminhando bem, vamos aplicando elas (como o Cargo Workspaces)
\n![\"Estrutura](\"midia/super-minigrep/%7B3%7D.png\")
Então aqui dou um tchau, beijos!
\n", "summary": "", "date_published": "2026-05-30T00:00:00-00:00", "image": "midia/super-minigrep/%7B1%7D.png", "authors": [ { "name": "Marcelo Magalhães", "url": "https://github.com/Marcelo-maga", "avatar": "https://github.com/Marcelo-maga.png" } ], "tags": [ "rust" ], "language": "pt-BR" }, { "id": "https://blog.marcelomaga.space/super-minigrep.html", "url": "https://blog.marcelomaga.space/super-minigrep.html", "title": "Super minigrep", "content_html": "Eitchaa 2 posts em uma semana, sou uma maquina...
\nEstava aqui agora 22:10 da noite pensando em como eu poderia aplicar tudo que eu andei falando/escrevendo aqui (Cognitive Offloading) e tentando achar algo interessante que me desse a vontade necessária de construir fora do meu horário de trabalho. E ontem (20/05) e hoje (21/05) foram dias super produtivos lá, onde tive a oportunidade (rsrs) de construir basicamente um fazedor (isso ai que você leu!) de relatórios, onde basicamente, recebo as mensagens em uma fila RabbitMQ e crio o arquivo PDF, através de mágica e chromium, e envio o buffer para ser armazenado no sistema de arquivos da organização do usuário. O detalhe interessante disso tudo é que o worker que faz os PDF é escrito em uma beldade chamada Rust.
\nO que me acendeu uma vontade imensa de fazer alguma coisa minha aqui na minha casinha, mas tenho uma certa preguiça de desenvolver sistemas web quando o assunto é projetos pessoais, nunca gostei, sempre preferi criar aplicativos desktops
\n(que inclusive penso em escrever um pouco sobre Tauri que bizzaramente tenho muita experiencia e historia pra contar do que eu já passei com esse framework maravilhoso)
\nE outro mundo da programação que sempre adorei foram as CLI, e revisitando O Livro lembrei de um mini projeto que temos para aprender certos conceitos que aprendemos até aquele momento na leitura, o minigrep. O grep é um comando para pesquisar por padrões de texto em arquivos ou em qualquer coisa que tenha stdout no terminal, muito utilizado quando o desespero bate e voce esta dentro de um SSH com o seu chefe aos prantos por conta da API que caiu e você tem ideia de qual foi o console.log que foi adicionado no ultimo PR que travou o event loop do NodeJS.
\nenfim, porque não melhorar ele??? então por aqui nas próximas semanas vão ser bem movimentado, a priore eu pensei em torno de 4 artigos seguindo uma completa refatoração do projeto minigrep para transforma ele em... (adivinha o nome super criativo) um super-minigrep.
\npensei em aceitar regex (o inferno nos aguarda), múltiplos arquivos sendo processados simultaneamente (Tokio vai ser necessário), um e error handling digno de cinema com anyhow e thiserror e maneiras pintar o terminal para ficar bem legal.
\nSpolier: O primeiro artigo quero fazer uma analise (pouco aprofundada) do código que temos ao seguir o livro e já começar com pequenas melhorias!
\nJá deixei um repositório no Github pronto para começar
\nconforme for criando os artigos vou usando esse aqui como um indexador para que seja facilmente localizado nesse mar de texto que vai virar isso aqui!!
\n1 - Arrumando a Casa
\n", "summary": "", "date_published": "2026-05-21T00:00:00-00:00", "image": "", "authors": [ { "name": "Marcelo Magalhães", "url": "https://github.com/Marcelo-maga", "avatar": "https://github.com/Marcelo-maga.png" } ], "tags": [ "rust" ], "language": "pt-BR" } ] }