Ruby справочник: Документация

Документация

Здесь вы найдете отсылки к руководствам, урокам и ссылкам, которые могут быть полезны, если вы почувствуете, что хотите программировать на Ruby.

Установка Ruby

Если вы хотите попробовать Ruby не только в браузере (смотрите ссылки ниже), но и локально – вам нужно установить Ruby на ваш компьютер. Вы можете проверить, установлен ли Ruby на ваш компьютер, набрав в терминале

ruby -v

Это должно вывести некоторую информацию об установленной версии Ruby. Если нет, смотрите страницу установки с различными способами получить Ruby.

С чего начать

Try Ruby!

Интерактивное введение, которое даст вам возможность попробовать Ruby прямо в вашем браузере. 15-ти минутная вводная часть нацелена на начинающих, кто хочет почувствовать возможности языка.

Ruby Koans

Данный ресурс поведет вас по пути просвещения к знаниям о Ruby. Цель ресурса – изучить язык Ruby, его синтаксис, структуру и несколько стандартных функций и библиотек. Так же он обучит вас культуре.

Why’s (Poignant) Guide to Ruby

Необычная, но интересная книга, которая научит вас Ruby посредством историй, шуток и комиксов. Созданное программистом why the lucky stiff, данное руководство является классикой для изучения Ruby.

Ruby за двадцать минут

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

В Ruby из других языков

Пришли в мир Ruby из другого языка? Будь это C, C++, Java, Perl, PHP или Python – этот раздел вам поможет!

Ruby Essentials

Бесплатная онлайн-книга, предоставляющая краткое и легкое руководство для изучения Ruby.

Learn to Program

Замечательное маленькое руководство от Chris Pine для новичков в программировании. Если вы не знаете как программировать — начните отсюда.

Learn Ruby the Hard Way

Отличный набор упражнений с объяснениями, который поможет вам пройти путь от абсолютно базовых понятий Ruby до ООП и веб-разработки.

Руководства

Programming Ruby

Основополагающая работа по Ruby на английском в первом издании, книга от Pragmatic Programmers, доступна бесплатно онлайн.

The Ruby Programming Wikibook

Бесплатное онлайн-руководство для начинающих и продвинутых, плюс полная документация языка.

Документация языка

Ruby Core Reference

Полученная прямиком из исходного кода при помощи RDoc, эта документация охватывает все классы и модули ядра (такие как String, Array, Symbol и так далее).

Ruby Standard Library Reference

Так же полученная прямо из исходного кода при помощи RDoc, эта документация охватывает стандартные библиотеки.

RubyDoc.info

Веб-сайт содержащий в себе документацию о гемах Ruby и Ruby проектах, расположенных на GitHub.

Ruby & Rails Searchable API Docs

Rails и Ruby документация с умным поиском.

APIdock

Ruby, Rails и RSpec документация с комментариями и заметками пользователей.

RubyAPI.org

Легко находите и просматривайте классы, модули и методы Ruby.

Редакторы и среды разработки

Для программирования на Ruby вы можете использовать стандартный редактор вашей операционной системы. Кстати, для более эффективного написания кода, стоит использовать редактор с поддержкой Ruby (например, подсветка синтаксиса, просмотр файлов) или среду разработки с продвинутыми функциями (например, code completion, рефакторинг, поддержка тестирования).

Далее следует список популярных инструментов, используемых рубистами:

• Инструменты для Linux и кросс-платформенные инструменты:
  • Aptana Studio
  • Emacs с Ruby режимом и Rsense
  • Geany
  • gedit
  • Vim с vim-ruby плагином и Rsense
  • RubyMine
  • SciTe
  • NetBeans
  • Sublime Text
• На Windows:
  • Notepad++
  • E-TextEditor
  • Ruby In Steel
• На macOS:
  • TextMate
  • BBEdit

Дальнейшее чтение

Ruby-Doc. org поддерживает актуальный список англоязычных источников. Если у вас есть вопросы по Ruby, почтовая рассылка – отличное место их задать.

---

---

Ruby за двадцать минут

1 | 2 | 3 | 4

Вступление

Здесь представлено небольшое введение в Ruby, которое должно занять не более двадцати минут. Предполагается, что вы уже установили Ruby. (Если на вашем компьютере нет Ruby, скачайте и установите его перед тем как начать.)

Интерактивный Ruby

Ruby устанавливается вместе с программой, которая покажет результат любого Ruby кода, который вы напишете в ней. Играть с кодом Ruby интерактивно – отличный способ узнать язык.

Откройте IRB (сокращение для Interactive Ruby).

• Если вы используете macOS, откройте Terminal, наберите irb и нажмите Enter.
• Если вы используете Linux, откройте shell, наберите irb и нажмите Enter.
• Если вы используете Windows, откройте Interactive Ruby из секции Ruby вашего меню Пуск.

irb(main):001:0>

Окей, итак он запущен. Что дальше?

Наберите это: "Hello World"

irb(main):001:0> "Hello World"
=> "Hello World"

Ruby повиновался вам!

Что только что произошло? Неужели мы только что написали кратчайшую в мире программу “Hello World”? Не совсем. Вторая строка, это всего-лишь способ IRB показать нам результат последнего выполненного выражения. Если мы хотим напечатать “Hello World”, мы должны написать немного больше:

irb(main):002:0> puts "Hello World"
Hello World
=> nil

puts – основная команда в Ruby, позволяющая напечатать что-нибудь. Но что же такое тогда => nil? Это результат выполнения выражения. puts всегда возвращает nil, который в Ruby обозначает значение абсолютно-положительного ничего.

Ваш бесплатный калькулятор

Теперь мы знаем достаточно, чтобы использовать IRB как простейший калькулятор:

irb(main):003:0> 3+2
=> 5

Три плюс два. Достаточно просто. Что насчет три умножить на два? Вы можете набрать сами, это достаточно короткий код, но также вы можете вернуться выше и изменить то, что вы ввели ранее. Попробуйте нажать стрелку наверх на клавиатуре и вы увидите строку с 3+2. Если это так — вы можете использовать стрелку влево, чтобы переместить курсор прямо за +, нажать backspace и поменять его на *.

irb(main):004:0> 3*2
=> 6

Теперь давайте попробуем возвести три в квадрат:

irb(main):005:0> 3**2
=> 9

В руби ** – способ возвести число в степень. Но что если вы хотите пойти в обратном направлении и узнать квадратный корень от чего-либо?

irb(main):006:0> Math.
  sqrt(9)
=> 3.0

Окей, погодите, что это было? Если вы думаете “это был способ выяснить квадратный корень из девяти”, вы правы. Но давайте приглядимся к деталям. Во-первых, что такое Math?

Модули группируют код по темам

Math – это встроенный модуль для математических операций. Модули выполняют две роли в Ruby. Наш пример показывает первую роль: сгруппировать похожие методы вместе под знакомым именем. Math также содержит методы типа sin() и tan().

Следующее – это точка. Что делает точка? Точка – это то, как вы указываете получателя сообщения. Что такое сообщение? В данном случае это sqrt(9), которое означает вызов метода sqrt, сокращение от “square root” (квадратный корень), с параметром 9.

Результат от вызова этого метода – 3.0. Вы можете заметить, что это не просто 3. Это потому, что большинство значений квадратного корня от числа не являются целыми, так что метод всегда возвращает число с плавающей точкой.

Что если мы хотим запомнить результат какой-либо математической операции? Присвойте это значение переменной.

irb(main):007:0> a = 3 ** 2
=> 9
irb(main):008:0> b = 4 ** 2
=> 16
irb(main):009:0> Math.sqrt(a+b)
=> 5.0

Калькулятор это замечательно, но мы отошли от традиционного сообщения Hello World, которым начали наше введение и на котором мы должны были сфокусироваться… так что давайте вернемся к нему.

---

---

Документация

Руководства, учебные пособия и справочные материалы, которые помогут вам узнать больше о Ruby

Установка Ruby

Хотя вы можете легко попробовать Ruby в своем браузере, вы также можете прочитать руководство по установке для справки по установке Ruby.

Начало работы

Официальный FAQ

Официальный часто задаваемые вопросы.

Руби Коанс

Коаны ведут вас по пути к просветлению, чтобы учиться Рубин. Цель состоит в том, чтобы изучить язык Ruby, синтаксис, структуру и некоторые общие функции и библиотеки. Мы также обучаем вас культуре.

Почему (острый) путеводитель по Ruby

Необычная, но интересная книга, которая научит вас Ruby через рассказы, остроумие и комиксы. Первоначально создано почему повезло hard , это руководство остается классикой для изучающих Ruby.

Основы Руби

Бесплатная онлайн-книга, предназначенная для краткого и простое руководство по изучению Ruby.

Научитесь программировать

Замечательный небольшой учебник Криса Пайна для новичков в программировании. Если не умеешь программировать, начни отсюда.

Изучите Ruby трудным путем

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

Руководства

Программирование Ruby

Основополагающая работа по Ruby на английском языке, это первое издание Книга Pragmatic Programmers доступна бесплатно в Интернете.

Викиучебник по программированию на Ruby

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

Справочная документация

Официальная документация API

Официальная документация Ruby API для разных версий, включая текущая невыпущенная (магистральная) версия.

Базовая версия Ruby

Получено прямо из исходного кода с помощью RDoc, эта ссылка work документирует все основные классы и модули (такие как String, Массив, символ и т. д.).

Справочник по стандартной библиотеке Ruby

Также взято из исходного кода с помощью RDoc, этот справочник документирует стандартную библиотеку.

Справочник API Ruby C

Официальное введение в Ruby C API. Отлично, если вы хотите писать расширения C или внести свой вклад в развитие Ruby.

RubyDoc.info

Универсальный веб-сайт для справочной документации по Ruby gems и Проекты Ruby, размещенные на GitHub.

Ruby & Rails API Docs с возможностью поиска

Документация по Rails и Ruby с интеллектуальным поиском.

APIдок

Документация по Ruby, Rails и RSpec с примечаниями пользователей.

RubyAPI.org

Легко находите и просматривайте классы, модули и методы Ruby.

Редакторы и IDE

Для написания кода на Ruby вы можете использовать редактор по умолчанию вашей операционной системы. система. Кстати, для более эффективного написания кода стоит выбрать редактор исходного кода с базовой поддержкой Ruby (например, подсветка синтаксиса, просмотр файлов) или интегрированная разработка среда с расширенными функциями (например, завершение кода, рефакторинг, поддержка тестирования).

Вот список популярных инструментов, используемых рубистами:

• Linux и кросс-платформенные инструменты:
  • Студия Аптана
  • Атом
  • Emacs с режимом Ruby и Rsense
  • Эрик
  • Джини
  • гэд
  • Кейт
  • KDevelop
  • NetBeans
  • РубиМайн
  • Наука
  • Возвышенный текст
  • Vim с подключаемым модулем vim-ruby и Rsense
  • Код Visual Studio
• В Windows:
  • Блокнот++
  • Электронный текстовый редактор
  • Рубин в стали
• В macOS:
  • TextMate
  • BBПравить
  • Dash (браузер документации)

Дополнительная литература

Ruby-doc. org ведет полный список исходники документации. Если у вас есть вопросы о Ruby, Список рассылки — отличное место для начала.

---

---

Установка Ruby

С менеджерами пакетов или сторонними инструментами у вас есть множество вариантов для установки и управления Ruby.

Возможно, на вашем компьютере уже установлен Ruby. Ты можешь проверить внутри эмулятора терминала, набрав:

 ruby ​​-v 

Это должно вывести некоторую информацию об установленной версии Ruby.

Выберите способ установки

Существует несколько способов установки Ruby:

• В UNIX-подобной операционной системе с использованием менеджер пакетов проще всего. Однако упакованная версия Ruby может быть не самой новой.
• Установщики могут использоваться для установки определенного или нескольких Рубиновые версии. Также есть установщик для Windows.
• Менеджеры помогают переключаться между несколькими версиями Ruby в вашей системе.
• Наконец, вы также можете собрать Ruby из исходного кода .

В Windows 10 вы также можете использовать подсистему Windows для Linux установить один из поддерживаемых дистрибутивов Linux и использовать любой из методы установки, доступные в этой системе.

Доступные методы установки:

• Системы управления пакетами
  • Дебиан, Убунту
  • CentOS, Fedora, RHEL
  • Защелка
  • Генту
  • Arch Linux
  • macOS
  • FreeBSD
  • OpenBSD
  • ОпенИндиана
  • Диспетчер пакетов Windows
  • Менеджер пакетов Chocolatey для Windows
  • Другие дистрибутивы
• Установщики
  • рубиновая сборка
  • рубиновая установка
  • RubyInstaller (Windows)
  • Рубиновый стек
• Менеджеры
  • asdf-vm
  • чрубый
  • рбенв
  • РВМ
  • уру
• Здание из источника

Системы управления пакетами

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

Некоторые члены сообщества Ruby считают, что вам следует избегать менеджеров для установки Ruby и что вместо этого вам следует использовать специальные инструменты.

Возможно, что основные менеджеры пакетов будут устанавливать старые версии Ruby версии вместо последней версии. Чтобы использовать последнюю версию Ruby, убедитесь, что имя пакета соответствует номеру его версии. Или используйте специальный установщик.

apt (Debian или Ubuntu)

Debian GNU/Linux и Ubuntu используют диспетчер пакетов apt. Вы можете использовать его вот так:

 $ sudo apt-get install ruby-full 

yum (CentOS, Fedora или RHEL)

CentOS, Fedora и RHEL используют диспетчер пакетов yum. Вы можете использовать его следующим образом:

 $ sudo yum install ruby ​​

Установленная версия обычно является последней доступной версией Ruby. во время выпуска конкретной версии дистрибутива.

snap (Ubuntu или другие дистрибутивы Linux)

Snap — это менеджер пакетов, разработанный Canonical. Он доступен «из коробки» в Ubuntu, но snap тоже работает. во многих других дистрибутивах Linux. Вы можете использовать его так:

 $ sudo snap install ruby ​​--classic 

У нас есть несколько каналов для младших серий Ruby. Например, следующие команды переключаются на Ruby 2.3:

 $ sudo snap switch ruby ​​--channel=2.3/stable
$ sudo snap refresh 

portage (Gentoo)

Gentoo использует диспетчер пакетов portage.

 $ sudo emerge dev-lang/ruby 

Чтобы установить определенную версию, установите RUBY_TARGETS в make.conf . См. подробности на веб-сайте проекта Gentoo Ruby.

pacman (Arch Linux)

Arch Linux использует менеджер пакетов с именем pacman. Чтобы получить Ruby, просто сделайте следующее:

 $ sudo pacman -S ruby ​​

Это должно установить последнюю стабильную версию Ruby.

Homebrew (macOS)

Ruby версии 2. 0 и выше по умолчанию включены в выпуски macOS по крайней мере, с Эль-Капитана (10.11).

Homebrew — широко используемый менеджер пакетов в macOS. Установить Ruby с помощью Homebrew очень просто:

 $ brew install ruby ​​

Это должно установить последнюю версию Ruby.

FreeBSD

FreeBSD предлагает как предварительно упакованные, так и исходные методы установки Ruby. Готовые пакеты можно установить с помощью инструмента pkg:

 $ pkg install ruby ​​

Для установки Ruby можно использовать метод на основе исходного кода с помощью Коллекция портов. Это полезно, если вы хотите для настройки параметров конфигурации сборки.

Дополнительная информация о Ruby и окружающей его экосистеме на FreeBSD можно найти на веб-сайте FreeBSD Ruby Project.

OpenBSD

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

 $ doas pkg_add ruby ​​

Вы можете установить несколько основных версий рядом, потому что их двоичные файлы имеют разные имена (например, ruby27 , ruby26 ).

Ветвь HEAD коллекции портов OpenBSD может иметь самая последняя версия Ruby для этой платформы через несколько дней после выпущен, см. каталог lang/ruby в самой последней коллекции портов.

Ruby на OpenIndiana

Чтобы установить Ruby на OpenIndiana, используйте Клиент системы упаковки изображений (IPS). Это установит бинарные файлы Ruby и RubyGems напрямую. из репозиториев OpenIndiana. Это просто:

 $ pkg install runtime/ruby 

Однако сторонние инструменты могут быть хорошим способом получить последняя версия Руби.

Диспетчер пакетов Windows

В Windows можно использовать интерфейс командной строки диспетчера пакетов Windows для установки Руби:

 > winget install RubyInstallerTeam.Ruby 

Менеджер пакетов Chocolatey для Windows

Также в Windows вы можете использовать диспетчер пакетов Chocolatey для установки Ruby:

 > choco install ruby ​​

Он будет повторно использовать существующий msys2 или установить собственный для полной среды разработки Ruby

Другие дистрибутивы

В других системах вы можете выполнить поиск в репозитории пакетов вашего Linux менеджер по распространению Ruby. В качестве альтернативы вы можете использовать сторонний установщик.

Установщики

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

Некоторые установщики позволяют устанавливать несколько версий на один и тот же система; связанные менеджеры могут помочь переключаться между различными Рубины.

Если вы планируете использовать RVM в качестве менеджера версий, вам не нужен отдельный установщик, он идет со своим.

ruby-build

ruby-build — это плагин для rbenv, который позволяет вам компилировать и устанавливать разные версии Ruby. ruby-build также может использоваться как отдельная программа без rbenv. Он доступен для macOS, Linux и другие UNIX-подобные операционные системы.

ruby-install

ruby-install позволяет компилировать и устанавливать различные версии Ruby в произвольные каталоги. чрубий — это бесплатный инструмент, используемый для переключения между версиями Ruby. Это доступно для macOS, Linux и других UNIX-подобных операционных систем.

RubyInstaller

В Windows RubyInstaller дает вам все необходимое для настройки полной среды разработки Ruby.

Просто загрузите его, запустите, и готово!

Рубиновый стек

Если вы устанавливаете Ruby для использования Ruby on Rails, вы можете использовать следующий установщик:

• Bitnami Ruby Stack обеспечивает полную разработку среда для Rails. Он поддерживает macOS, Linux, Windows, виртуальные машины и облачные образы.

Менеджеры

Многие пользователи Ruby используют менеджеры Ruby для управления несколькими Ruby. Они разрешают простое или даже автоматическое переключение между версиями Ruby в зависимости от проект и другие преимущества, но официально не поддерживаются. Ты можешь однако находят поддержку в своих сообществах.

asdf-vm

asdf-vm — расширяемый менеджер версий, который может управлять несколькими языковые версии среды выполнения для каждого проекта. Вам понадобится Плагин asdf-ruby (который, в свою очередь, использует ruby-build) для установки Руби.

chruby

chruby позволяет переключаться между несколькими рубинами. Оно может управлять Rubies, установленными с помощью ruby-install или даже встроенными из источника.

rbenv

rbenv позволяет управлять несколькими установками Ruby. Хотя он не может установить Ruby по умолчанию, его ruby-build плагин может. Оба инструмента доступны для macOS, Linux или других UNIX-подобные операционные системы.

rbenv для Windows

rbenv для Windows позволяет устанавливать и управлять несколькими установками Ruby в Windows. Это написано в Таким образом, PowerShell обеспечивает собственный способ использования Ruby для пользователей Windows. Кроме того, интерфейс командной строки совместим с rbenv. в UNIX-подобных системах.

RVM («Менеджер версий Ruby»)

RVM позволяет устанавливать и управлять несколькими установками Ruby в вашей системе.