Растівки 🦀

Ласкаво просимо до растівок - вправ Rustlings українською 🇺🇦 😃

Це невеликі вправи, що допоможуть звикнути до читання та написання коду на Rust - Рекомендується паралельно з читанням офіційної книги Rust. Доступний також український переклад офіційної книги, але основним авторитетним джерелом про поточну версію мови є завжди оригінал англійською.

Відвідай веб-сайт Rustlings для демо, інформації про налаштування та більше: ➡️ rustlings.rust-lang.org

__

Як почати

Все що потрібно - це встановлений git, налаштований Rust та встановлений Rustlings як розказано нижче в розділі Як встановити Rustlings.

Потім склонуй цей репозиторій, відкрий термінал у теці з репозиторієм та запусти rustlings, щоб почати працювати з вправами 🚀

# Робимо локальну копію
git clone --depth=1 https://github.com/noroutine/rustlings-ua && cd rustlings-ua
# ... i вйо до вправ
rustlings

Як встановити git, rust та Rustlings

Встановлення git

Git не є обов'язковим для виконання вправ, але дуже рекомендований для роботи з кодом та відстеження твого прогресу.

Для Unix-подібних систем:

• Debian/Ubuntu: sudo apt install git
• Fedora: sudo dnf install git
• macOS: brew install git (потребує Homebrew) або xcode-select --install

Для інших систем дивись офіційні інструкції git.

Після встановлення не забудь налаштувати git:

git config --global user.name "Твоє Ім'я"
git config --global user.email "твоя@пош.та"

Робота з Git не входить до вправ. Для вивчення основ рекомендуємо: Pro Git Book, доступний також переклад українською.

Встановлення Rust

Перед встановленням Rustlings ти повинен мати встановлену останню версію Rust.

Це дуже просто, якщо в тебе Unix-подібна система (Linux/macOS),:

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

Для інших систем та особливих оточень дивись офіційні інструкції www.rust-lang.org/tools/install.

Це також встановить Cargo - менеджер пакетів/проектів Rust.

🐧 Якщо ти використовуєш Linux, переконайся, що у тебе встановлено gcc (для лінкера).

Debian/Ubuntu: sudo apt install gcc
Fedora: sudo dnf install gcc

🍎 Якщо ти використовуєш MacOS, переконайся, що у тебе встановлено Xcode та його інструменти розробника: xcode-select --install

Встановлення Rustlings

Наступна команда завантажить та скомпілює 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

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

cd rustlings/
rustlings

Робоче середовище

Редактор

Ми загалом рекомендуємо VS Code з плагіном rust-analyzer. Але будь-який редактор, що підтримує rust-analyzer, повинен підійти для роботи з вправами.

Термінал

Під час роботи з Rustlings, будь ласка, використовуй сучасний термінал для найкращого досвіду. Стандартний термінал на Linux та Mac повинен бути достатнім.

Як допомогти

Дякуємо за інтерес до проекту! Разом ми створимо якісний ресурс для вивчення Rust українською мовою.

Допомога в перекладі

Цей проект перекладу Rustlings українською потребує вашої допомоги! Ми працюємо над створенням якісного перекладу, який зберігає технічну точність та читається природно українською мовою.

Як долучитися

Для досвідчених контриб'юторів:

• Оберіть розділ для перекладу з Issues та почніть переклад
• Дотримуйтесь встановлених принципів термінології
• Створіть Pull Request з вашими змінами

Для початківців:

• Почніть з перевірки та покращення існуючих перекладів
• Допоможіть знайти неточності або незрозумілі формулювання
• Запропонуйте кращі варіанти перекладу термінів

Важливо знати

Наш переклад використовує гібридний підхід до термінології: ключові поняття Rust подаються українською з англійським терміном у дужках при першому згадуванні. Наприклад: "змінні (variables)" або "незмінювані (immutable)". Це допомагає новачкам вивчати як українські пояснення, так і оригінальну англійську термінологію.

Перед початком

Обов'язково прочитайте CONTRIBUTING.md — там містяться:

• Детальні правила стилю та термінології
• Приклади правильного перекладу
• Процес створення Pull Request
• Чекліст перевірки якості

Поточний прогрес

Слідкуйте за прогресом перекладу в Issues.