rubygems

Rubygems

Rubygems - это структура управления пакетами для Ruby.

Пакет (также известный как библиотека) содержит набор функциональности, который может быть вызван программой Ruby, такой как чтение и анализ файла XML. Мы называем эти пакеты «драгоценными камнями», а Rubygems - это инструмент для установки, создания, управления и загрузки этих пакетов в вашей среде Ruby.

Rubygems также является клиентом для Rubygems.org, общественного репозитория драгоценных камней, который позволяет вам публиковать драгоценный камень, который можно разделить и использовать другими разработчиками. См. Наше руководство по публикации драгоценного камня на Guides.rubygems.org

Начиная

Установка и управление драгоценным камнем выполняется через команду gem . Чтобы установить драгоценный камень, такой как Nokogiri, который позволяет читать и разбирать XML в Ruby:

 $ gem install nokogiri

Rubygems загрузит Gem Nokogiri с rubygems.org и установит его в вашу среду Ruby.

Наконец, внутри вашей программы Ruby загрузите драгоценный камень Nokogiri и начните анализ вашего XML:

 require 'nokogiri'

Nokogiri.XML('<h1>Hello World</h1>')

Для получения дополнительной информации о том, как использовать Rubygems, см. Наше руководство по основам Rubygems на Guides.rubygems.org

Требования

• Rubygems поддерживает Ruby 3.0 или позже.

Установка

Rubygems уже установлен в вашей среде Ruby, вы можете проверить версию, которую вы установили, запустив gem --version в вашем эмуляторе терминала.

В некоторых случаях Ruby & Rubygems могут быть предоставлены в качестве пакетов ОС. Это не рекомендуемый способ использовать Ruby & Rubygems. Лучше использовать менеджер версий Ruby, например, RBENV или Chruby. Если вы по -прежнему хотите использовать версию, предоставленную вашим менеджером пакетов ОС, также используйте диспетчер пакетов ОС для обновления Rubygems и игнорируйте любые другие инструкции по установке, приведенные ниже.

Если вы хотите вручную установить Rubygems:

• Скачать с https://rubygems.org/pages/download, unpack и cd в src rubygems
• Или клонировать этот репозиторий и cd в репозиторий

Установите Rubygems, работая:

 $ ruby setup.rb

Для получения более подробной информации и других вариантов см.

 $ ruby setup.rb --help

Модернизация Rubygems

Чтобы перейти к последним Rubygems, запустите:

 $ gem update --system

Смотрите обновление для более подробной информации и альтернативных инструкций.

Выпустить политику

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

Политика выпуска несколько похожа на политику выпуска самой Руби:

• Частые выпуски патча (каждые 2-4 недели), включая исправления ошибок, незначительные улучшения, небольшие функции или даже функции среднего размера, объявленные экспериментальными для боевых тестирования.
• Ежегодные незначительные выпуски, включая более широкие функции, и незначительные нарушения (затрагивают только кромки и очень небольшой набор пользователей).
• Случайные основные выпуски (замена ежегодных несовершеннолетних), включая серьезные нарушения.

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

Rubygems использует RDOC для документации. Скомпилированный набор документов можно просмотреть онлайн на Rubydoc.

Rubygems также предоставляет комплексный набор руководств, которые охватывают многочисленные темы, такие как создание нового драгоценного камня, практики безопасности и другие ресурсы по адресу https://guides.rubygems.org.

Получить помощь

Подача билетов

Есть ошибка, и вы не уверены? Вы уверены, что у вас есть ошибка, но не знаете, что делать дальше? В любом случае, дайте нам знать об этом! Лучшее место, чтобы сообщить команде Rubygems о ошибках или проблемах, которые у вас возникают, находится на странице проблем Rubygems в Github.

Совместимость бундлера

См. Https://bundler.io/compatibility для известных вопросов.

Поддержка

Rubygems управляется Ruby Central, некоммерческой организацией, которая поддерживает сообщество Ruby через такие проекты, как этот, а также Rubyconf, Railsconf и Rubygems.org. Вы можете поддержать Ruby Central, посетив или спонсируя конференцию, или присоединившись к вспомогательному участнику.

Внося

Если вы хотите внести свой вклад в Rubygems, это круто, и мы <3 вы. Ознакомьтесь с нашим руководством по содействию дополнительной информации.

Нормы поведения

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