rustlings

Farfalhamentos ?❤️

Saudações e bem-vindos ao Rustlings. Este projeto contém pequenos exercícios para você se acostumar a ler e escrever código Rust. Isso inclui ler e responder às mensagens do compilador!

Recomenda-se fazer os exercícios Rustlings paralelamente à leitura do livro oficial Rust, o recurso mais completo para aprender Rust ️

Rust By Example é outro recurso recomendado que pode ser útil. Ele contém exemplos de código e exercícios semelhantes aos Rustlings, mas online.

Começando

Instalando ferrugem

Antes de instalar o Rustlings, você precisa ter a versão mais recente do Rust instalada. Visite www.rust-lang.org/tools/install para obter mais instruções sobre como instalar o Rust. Isso também instalará Cargo , o gerenciador de pacotes/projetos do Rust.

? Se você estiver no Linux, certifique-se de ter instalado gcc (para um vinculador).

Deb: sudo apt install gcc . Dnf: sudo dnf install gcc .

? Se você estiver no MacOS, certifique-se de ter instalado o Xcode e suas ferramentas de desenvolvedor executando xcode-select --install .

Instalando Rustlings

O seguinte comando irá baixar e compilar Rustlings:

cargo install rustlings

Se a instalação falhar… ( clique para expandir )

• Certifique-se de ter a versão mais recente do Rust executando rustup update
• Tente adicionar o sinalizador --locked : cargo install rustlings --locked
• Caso contrário, informe o problema

Inicialização

Depois de instalar o Rustlings, execute o seguinte comando para inicializar o diretório rustlings/ :

rustlings init

Se o comando rustlings não for encontrado… ( clique para expandir )

Você provavelmente está usando Linux e instalou o Rust usando seu gerenciador de pacotes.

Cargo instala binários no diretório ~/.cargo/bin . Infelizmente, os gerenciadores de pacotes geralmente não adicionam ~/.cargo/bin à sua variável de ambiente PATH .

A solução é…

• adicione ~/.cargo/bin manualmente ao PATH
• ou desinstalar o Rust do gerenciador de pacotes e instalá-lo usando o método oficial com rustup : https://www.rust-lang.org/tools/install

Agora, vá para o diretório recém-inicializado e inicie o Rustlings para obter mais instruções sobre como começar os exercícios:

 cd rustlings/
rustlings

Ambiente de trabalho

Editor

Nossa recomendação geral é VS Code com o plugin analisador de ferrugem. Mas qualquer editor que suporte o analisador de ferrugem deve ser suficiente para trabalhar nos exercícios.

terminal

Ao trabalhar com Rustlings, use um terminal moderno para obter a melhor experiência do usuário. O terminal padrão no Linux e Mac deve ser suficiente. No Windows, recomendamos o Terminal Windows.

Fazendo exercícios

Os exercícios são classificados por tópico e podem ser encontrados no subdiretório exercises/<topic> . Para cada tópico, há um arquivo README.md adicional com alguns recursos para você começar no tópico. É altamente recomendável que você dê uma olhada neles antes de começar ️

A maioria dos exercícios contém um erro que os impede de serem compilados e cabe a você corrigi-lo! Alguns exercícios contêm testes que precisam ser aprovados para que o exercício seja realizado ✅

Pesquise TODO e todo!() para descobrir o que você precisa alterar. Peça dicas digitando h no modo de relógio

Modo Assistir

Após a inicialização, Rustlings pode ser iniciado simplesmente executando o comando rustlings .

Isso iniciará o modo de observação que orienta você nos exercícios em uma ordem predefinida (o que achamos melhor para os novatos). Ele executará novamente o exercício atual automaticamente sempre que você alterar o arquivo do exercício no diretório exercises/ .

Se a detecção de alterações no arquivo no diretório exercises/ falhar… ( clique para expandir )

Você pode adicionar o sinalizador --manual-run ( rustlings --manual-run ) para executar novamente manualmente o exercício atual inserindo r no modo de observação.

Por favor, relate o problema com algumas informações sobre o seu sistema operacional e se você executa Rustlings em um contêiner ou em uma máquina virtual (por exemplo, WSL).

Lista de exercícios

No modo de observação (após iniciar rustlings ), você pode inserir l para abrir a lista de exercícios interativos.

A lista permite que você…

• Veja o status de todos os exercícios (concluídos ou pendentes)
• c : Continue em outro exercício (pule temporariamente alguns exercícios ou volte para um anterior)
• r : Redefinir o status e o arquivo do exercício selecionado (você precisará recarregar/reabrir o arquivo em seu editor posteriormente)

Veja o rodapé da lista para todas as chaves possíveis.

Questões?

Se você precisar de ajuda ao fazer os exercícios e as dicas integradas não forem úteis, sinta-se à vontade para perguntar na categoria de perguntas e respostas das discussões se sua pergunta ainda não foi feita

Exercícios de terceiros

Exercícios de terceiros são um conjunto de exercícios mantidos pela comunidade. Você pode usar o mesmo programa rustlings que instalou com cargo install rustlings para executá-los:

• 日本語版 Rustlings：Uma tradução japonesa dos exercícios Rustlings.

Você deseja criar seu próprio conjunto de exercícios Rustlings para focar em algum tópico específico? Ou você deseja traduzir os exercícios originais do Rustlings? Então siga o guia sobre exercícios de terceiros!

Continuando

Depois de concluir Rustlings, faça bom uso de seu novo conhecimento! Continue praticando suas habilidades em Rust construindo seus próprios projetos, contribuindo para Rustlings ou encontrando outros projetos de código aberto para contribuir.

Desinstalando Rustlings

Se você deseja remover Rustlings do seu sistema, execute o seguinte comando:

cargo uninstall rustlings

Contribuindo

Consulte CONTRIBUTING.md?

Colaboradores

Obrigado a todos os contribuidores maravilhosos?