rustlings

Шорохи ?❤️

Приветствую и добро пожаловать в Rustlings. Этот проект содержит небольшие упражнения, которые помогут вам научиться читать и писать код Rust. Это включает в себя чтение и ответ на сообщения компилятора!

Рекомендуется выполнять упражнения Rustlings параллельно с чтением официальной книги Rust, наиболее полного ресурса для изучения Rust ️

Rust By example — еще один рекомендуемый ресурс, который может оказаться вам полезным. Он содержит примеры кода и упражнения, аналогичные Rustlings, но онлайн.

Начиная

Установка Руста

Перед установкой Rustlings вам необходимо установить последнюю версию Rust . Посетите www.rust-lang.org/tools/install для получения дальнейших инструкций по установке Rust. При этом также будет установлен Cargo , менеджер пакетов/проектов Rust.

? Если вы используете Linux, убедитесь, что вы установили gcc (для компоновщика).

Деб: sudo apt install gcc . Dnf: sudo dnf install gcc .

? Если вы используете MacOS, убедитесь, что вы установили Xcode и его инструменты разработчика, запустив xcode-select --install .

Установка Растлингс

Следующая команда загрузит и скомпилирует Rustlings:

cargo install rustlings

Если установка не удалась… ( нажмите, чтобы развернуть )

• Убедитесь, что у вас установлена ​​последняя версия Rust, запустив rustup update
• Попробуйте добавить флаг --locked : cargo install rustlings --locked
• В противном случае сообщите о проблеме

Инициализация

После установки Rustlings выполните следующую команду, чтобы инициализировать каталог rustlings/ :

rustlings init

Если командные rustlings не найдены… ( нажмите, чтобы развернуть )

Вероятно, вы используете Linux и установили Rust с помощью менеджера пакетов.

Cargo устанавливает двоичные файлы в каталог ~/.cargo/bin . К сожалению, менеджеры пакетов часто не добавляют ~/.cargo/bin в переменную среды PATH .

Решение состоит в том, чтобы…

• либо добавьте ~/.cargo/bin вручную в PATH
• или удалить Rust из менеджера пакетов и установить его официальным способом с помощью rustup : https://www.rust-lang.org/tools/install

Теперь перейдите в только что инициализированный каталог и запустите Rustlings для получения дальнейших инструкций по началу работы с упражнениями:

 cd rustlings/
rustlings

Рабочая среда

Редактор

Наша общая рекомендация — VS Code с плагином анализатора ржавчины. Но для работы над упражнениями должно хватить любого редактора, поддерживающего ржавчин-анализатор.

Терминал

Для удобства работы с Rustlings используйте современный терминал. Терминала по умолчанию в Linux и Mac должно быть достаточно. В Windows мы рекомендуем терминал Windows.

Выполнение упражнений

Упражнения отсортированы по темам и их можно найти в подкаталоге exercises/<topic> . Для каждой темы существует дополнительный файл README.md с некоторыми ресурсами, которые помогут вам начать работу по этой теме. Мы настоятельно рекомендуем вам взглянуть на них, прежде чем начать ️

Большинство упражнений содержат ошибку, из-за которой они не могут быть скомпилированы, и вы должны ее исправить! Некоторые упражнения содержат тесты, которые необходимо пройти, чтобы упражнение было выполнено ✅

Найдите TODO и todo!() , чтобы узнать, что вам нужно изменить. Попросите подсказку, введя h в режиме просмотра.

Режим просмотра

После инициализации Rustlings можно запустить, просто выполнив команду rustlings .

Запустится режим просмотра , который проведет вас через упражнения в заранее определенном порядке (который, по нашему мнению, лучше всего подходит для новичков). Текущее упражнение будет автоматически повторяться каждый раз, когда вы меняете файл упражнения в каталоге exercises/ .

Если обнаружить изменения файлов в каталоге exercises/ не удалось… ( нажмите, чтобы развернуть )

Вы можете добавить флаг --manual-run ( rustlings --manual-run ), чтобы вручную перезапустить текущее упражнение, введя r в режиме просмотра.

Сообщите о проблеме, указав некоторую информацию о вашей операционной системе и о том, запускаете ли вы Rustlings в контейнере или на виртуальной машине (например, WSL).

Список упражнений

В режиме часов (после запуска rustlings ) вы можете ввести l , чтобы открыть интерактивный список упражнений.

Список позволяет…

• Просматривайте статус всех упражнений (выполнено или ожидается)
• c : Продолжить выполнение другого упражнения (временно пропустить некоторые упражнения или вернуться к предыдущему).
• r : Сбросить статус и файл выбранного упражнения (после этого вам необходимо перезагрузить/переоткрыть его файл в редакторе)

См. нижний колонтитул списка для всех возможных ключей.

Вопросы?

Если вам нужна помощь при выполнении упражнений, а встроенные подсказки не помогают, не стесняйтесь задавать вопросы в категории вопросов и ответов в обсуждениях, если ваш вопрос еще не был задан.

Сторонние упражнения

Сторонние упражнения — это набор упражнений, поддерживаемых сообществом. Для их запуска вы можете использовать ту же программу rustlings , которую вы установили с помощью cargo install rustlings :

• 日本語版 «Шорохи»: японский перевод упражнений «Шорохи».

Хотите создать свой собственный набор упражнений Rustlings, чтобы сосредоточиться на какой-то конкретной теме? Или вы хотите перевести оригинальные упражнения Rustlings? Тогда следуйте инструкциям по сторонним упражнениям!

Продолжается вкл.

Пройдя «Шорохи», примените свои новые знания с пользой! Продолжайте практиковать свои навыки работы с Rust, создавая собственные проекты, участвуя в Rustlings или находя другие проекты с открытым исходным кодом, в которых можно внести свой вклад.

Удаление Растлингс

Если вы хотите удалить Rustlings из вашей системы, выполните следующую команду:

cargo uninstall rustlings

Содействие

См. CONTRIBUTING.md?

Авторы

Спасибо всем замечательным участникам?