Features/Ruby 1.9.3

= Ruby 1.9.3 =

Summary
Ruby 1.9.3 is the latest stable version of Ruby, with major increases in speed and reliability. With this major update from Ruby 1.8.7 in Fedora 16 to Ruby 1.9.3 in Fedora 17, alongside JRuby, Fedora becomes the superior Ruby development platform.

Owner

 * Name: Vít Ondruch


 * Email: vondruch@redhat.com

Current status

 * Targeted release: Fedora 17
 * Last updated: --
 * Percentage of completion: 100%

Detailed Description
Ruby 1.9.3 is upstream's new major release of Ruby. The MRI reference interpreter is replaced by the YARV bytecode interpreter, designed to greatly improve the execution time of ruby programs. 

In doing so, upstream has set the anticipations for downstream consumers with faster and more reliable Ruby. Bringing Ruby 1.9.3 to Fedora is essential for Fedora to be at the top of it's game as a Ruby development platform.

Benefit to Fedora
Supporting the growth of a young language with a performance-enhancing milestone release. Add to that the multiplatform targetted development we enable downstream parties to do using our distribution.

Scope
The following list includes a summary of changes included in this feature:


 * New Packaging Guidelines for Ruby packages (gems and extension libraries)
 * Rebuilding of all Ruby packages, and all packages depending on Ruby
 * Changes to the search path to comply with the multi-versioning
 * Changes to the location of files to comply with FHS, multilib and packaging standards

New Packaging Guidelines
Drafts of new packaging guidelines will have to be proposed to FPC. You can see the current draft.

Ruby Search path
The ruby search path is going to change. Not set in stone yet, but this is what it is right now:

$ ruby -e "puts $:" /usr/local/lib64/ruby/site_ruby /usr/local/share/ruby/site_ruby /usr/lib64/ruby/vendor_ruby /usr/share/ruby/vendor_ruby /usr/lib64/ruby /usr/lib64/ruby/x86_64-linux

Changes like these mean that the Packaging Guidelines for Ruby will also need to be updated.

Packages that require "ruby(abi) = 1.8"
Requires rebuilding numerous packages that depend on ruby(abi) = 1.8, or have Requires or BuildRequires for package dependent on ruby(abi) = 1.8. All these packages have to be updated to support ruby(abi) = 1.9


 * 115 in total

repoquery --repoid=rawhide-source --arch=src --whatrequires 'ruby(abi) = 1.8' | sort | uniq

Packages that require "*ruby*"

 * 334 in total (115 matches from previous query, of course)

repoquery --repoid=rawhide-source --arch=src --whatrequires '*ruby*' | sort | uniq

How To Test

 * No special hardware is needed.
 * To test, install Ruby 1.9.3 and the rebuilt packages from the testing repository http://vondruch.fedorapeople.org/ruby_1.9.3.repo . Or better, ẗhere is already available f17-ruby tag in Koji, so you can use Koji repository http://kojipkgs.fedoraproject.org/repos/f17-ruby/latest/$basearch for testing. For more updates, please follow the Ruby-SIG mailing list thread http://lists.fedoraproject.org/pipermail/ruby-sig/2011-December/000705.html.
 * Use the packages, ideally with your applications previously written in Ruby (be sure to upgrade your applications to Ruby 1.9.3 first).
 * If something doesn't work as it should, let us know (specifically, concentrate on correct load paths, encodings, changes in binary extensions and also other new features added between 1.8.7 and 1.9.3).

Please note that we already tested all packages available in Fedora for compatibility with Ruby 1.9.3. You can go through the findings in following mailing list threads:


 * http://lists.fedoraproject.org/pipermail/ruby-sig/2011-December/000729.html
 * http://lists.fedoraproject.org/pipermail/ruby-sig/2011-December/000735.html

User Experience
The Ruby programmes/scripts will get significantly faster compared to the current state.

Dependencies
Ruby has more than three hundred dependencies in Fedora, most of them are Rubygems. All of these 300 will have to be rebuilt and tested.

Contingency Plan
We would like to get a special buildroot tag to be able to rebuild all the packages with Ruby 1.9.3. If anything goes wrong, the tag could be easily dropped and previous version of Ruby 1.8.7 and its dependencies stays intact.

Documentation
http://www.ruby-doc.org/

Upstream EOL

 * 1.8.6 : Engine Yard’s Plans for Ruby 1.8.6


 * 1.8.7 : About 1.8.7 EOL and Plans for 1.8.7

Release Notes

 * The Ruby 1.9.3 breaks ABI/API compatibility with previous version of Ruby, therefore soname was bumped. All RubyGems which use binary extensions should be rebuilt. All applications which use Ruby binding should be rebuilt.
 * Ruby 1.9.3 as well as integrated version of RubyGems now use different directory structure, compatible with FHS. All libraries need to be adjusted to this change. This change is reflected in new packaging guidelines draft.
 * Unprivileged user now installs gems automatically into her/his home directory, root installs gems into /usr/local directory structure and system gems, managed by RPM, are installed into /usr.
 * Ruby libraries managed by RPM are now installed into vendor directories while other libraries managed by system administrator should go into site directories.


 * http://svn.ruby-lang.org/repos/ruby/tags/v1_8_7_358/NEWS
 * http://svn.ruby-lang.org/repos/ruby/tags/v1_9_1_431/NEWS
 * http://svn.ruby-lang.org/repos/ruby/tags/v1_9_2_381/NEWS
 * http://svn.ruby-lang.org/repos/ruby/tags/v1_9_3_125/NEWS

Comments and Discussion

 * See Talk:Features/Ruby 1.9.3 or Ruby-SIG mailing list.