Instalando Binários com Cargo Install

Beginner

This tutorial is from open-source community. Access the source code

Introdução

Bem-vindo a Instalando Binários com Cargo Install. Este laboratório faz parte do Livro Rust. Você pode praticar suas habilidades em Rust no LabEx.

Neste laboratório, você aprenderá como usar o comando cargo install para instalar crates binários localmente e torná-los executáveis, adicionando o diretório de instalação ao seu $PATH.

Instalando Binários com cargo install

O comando cargo install permite que você instale e use crates binários localmente. Isso não se destina a substituir pacotes do sistema; é uma maneira conveniente para os desenvolvedores Rust instalarem ferramentas que outros compartilharam em https://crates.io. Observe que você só pode instalar pacotes que possuem alvos binários. Um alvo binário é o programa executável que é criado se o crate tiver um arquivo src/main.rs ou outro arquivo especificado como binário, em oposição a um alvo de biblioteca que não é executável por si só, mas é adequado para inclusão em outros programas. Normalmente, os crates têm informações no arquivo README sobre se um crate é uma biblioteca, possui um alvo binário ou ambos.

Todos os binários instalados com cargo install são armazenados na pasta bin da raiz da instalação. Se você instalou o Rust usando rustup.rs e não possui nenhuma configuração personalizada, este diretório será _HOME/.cargo/bin_. Certifique-se de que esse diretório esteja no seu `PATHpara poder executar programas que você instalou comcargo install`.

Por exemplo, no Capítulo 12, mencionamos que existe uma implementação Rust da ferramenta grep chamada ripgrep para pesquisar arquivos. Para instalar ripgrep, podemos executar o seguinte:

$ cargo install ripgrep
    Updating crates.io index
  Downloaded ripgrep v13.0.0
  Downloaded 1 crate (243.3 KB) in 0.88s
  Installing ripgrep v13.0.0
   --snip--
   Compiling ripgrep v13.0.0
    Finished release [optimized + debuginfo] target(s) in 3m 10s
  Installing ~/.cargo/bin/rg
   Installed package `ripgrep v13.0.0` (executable `rg`)

A penúltima linha da saída mostra a localização e o nome do binário instalado, que no caso de ripgrep é rg. Contanto que o diretório de instalação esteja no seu $PATH, como mencionado anteriormente, você pode então executar rg --help e começar a usar uma ferramenta mais rápida e "Rustier" para pesquisar arquivos!

Resumo

Parabéns! Você concluiu o laboratório Instalando Binários com Cargo Install. Você pode praticar mais laboratórios no LabEx para aprimorar suas habilidades.