Changes/Ruby on Rails 5.0

Ruby on Rails 5.0

Summary

Ruby on Rails 5.0 is the latest version of well known web framework written in Ruby.

Owner

• Name: Jun Aruga, Pavel Valena, Vít Ondruch
• Email: jaruga@redhat.com, pvalena@redhat.com, vondruch@redhat.com, ruby-sig@lists.fedoraproject.org
• Release notes owner:

Current status

• Targeted release: Fedora 25
• Last updated: 2016-09-26
• Tracker bug: #1357414

Detailed Description

The Ruby on Rails stack is evolving quickly and Fedora needs to keep pace with it. Therefore the whole Ruby on Rails stack should be updated from 4.2 in Fedora 24 to 5.0 (latest version) in Fedora 25. This will ensure that all the Ruby developers using Fedora have the latest and greatest RPM-packaged Ruby on Rails.

Benefit to Fedora

This update will keep Fedora up-to-date and will ensure that the current Ruby on Rails developers stay with us as they will get support for system-packaged Ruby on Rails of the latest version. Apart from that, update to Rails 5.0 will bring ActionCable (A new framework that seamlessly integrates WebSockets with the rest of your Rails application), API mode (You can create a new Rails application using rails new backend --api), ActionRecord attributes with a type on a model, and exclusive use of rails CLI over Rake.

Scope

• Proposal owners:

• The whole Rails stack has to be updated
• Some dependencies of the Rails stack will need update

List of packages needed by Rails 5.0 to generate basic application

Package name	Task	Status
rubygem-actioncable	Create (5.0.x)	pass vondruch #1354545
rubygem-actionmailer	Update to 5.0.x	pass vondruch #1351811
rubygem-actionpack	Update to 5.0.x	pass jaruga #1351812
rubygem-actionview	Update to 5.0.x	pass jaruga #1351813
rubygem-activejob	Update to 5.0.x	pass jaruga #1351814
rubygem-activemodel	Update to 5.0.x	pass vondruch #1351815
rubygem-activerecord	Update to 5.0.x	pass vondruch #1351816
rubygem-activesupport	Update to 5.0.x	pass vondruch #1351817
rubygem-arel	Update to 7.x	pass vondruch #1292628
rubygem-builder	No need to update	pass jaruga
rubygem-bundler	No need to update	pass jaruga
rubygem-concurrent-ruby	No need to update	pass vondruch
rubygem-erubis	No need to update	pass jaruga
rubygem-globalid	Update to >= 0.3.6	pass jaruga #1296970
rubygem-i18n	No need to update	pass jaruga
rubygem-loofah	No need to update	pass jaruga
rubygem-mail	Latest version	pass vondruch #1320765
rubygem-method_source	No need to update	pass jaruga
rubygem-mime-types	Update to 3.1 (latest version) because of rubygem-mime-types-data	pass jaruga #907393
rubygem-mime-types-data		pass vondruch #1351575
rubygem-minitest	No need to update	pass jaruga
rubygem-nio4r	Create (~> 1.2)	pass jaruga #1315801
rubygem-nokogiri	No need to update	pass jaruga
rubygem-pkg-config	No need to update	pass jaruga
rubygem-rack	Update to 2.x	pass vondruch #1352603
rubygem-rack-test	No need to update	pass jaruga
rubygem-rails	Update to 5.0.x	pass vondruch #1352604
rubygem-rails-dom-testing	Update to ~> 2.0 (It does not need to update at 5.0.0.rc2, but it needs to update at 5.0.0)	pass jaruga #1297006
rubygem-rails-html-sanitizer	No need to update	pass jaruga
rubygem-railties	Update to 5.0.x	inprogress vondruch #1352605
rubygem-rake	No need to update	pass jaruga
rubygem-sprockets	No need to update. Fix the build failure.	pass jaruga #1352650
rubygem-sprockets-rails	No need to update	pass jaruga
rubygem-thor	No need to update	pass jaruga
rubygem-thread_safe	No need to update	pass jaruga
rubygem-tzinfo	No need to update	pass jaruga
rubygem-websocket-driver	Update to ~> 0.6.1	pass jaruga #1171085
rubygem-websocket-extensions	No need to update	pass jaruga

List of optional packages, required by the basic Ruby on Rails application

Package name	Task	Status
rubygem-byebug	No need to update	pass jaruga
rubygem-coffee-rails	No need to update. Fix the build failure.	pass jaruga #1357056
rubygem-coffee-script	No need to update. Fix the build failure.	pass jaruga #1357047
rubygem-coffee-script-source	No need to update	pass jaruga
rubygem-debug_inspector	No need to update	pass jaruga
rubygem-execjs	No need to update. Fix the build failure.	pass jaruga #1357592
rubygem-ffi	No need to update	pass jaruga
rubygem-jbuilder	Update to ~> 2.5	pass vondruch #1294347
rubygem-jquery-rails	Relax rails-dom-testing dependency. Update is blocked by jQuery.	pass vondruch
rubygem-listen	No need to update	pass jaruga
rubygem-multi_json	No need to update	pass jaruga
rubygem-puma	Create? (~> 3.0) TODO	inprogress jaruga #1372718
rubygem-rails-deprecated_sanitizer	No need to update	pass jaruga
rubygem-rb-fsevent	No use	pass jaruga
rubygem-rb-inotify	Latest version	pass vondruch #1305192
rubygem-sass	No need to update.	pass jaruga
rubygem-sass-rails	~> 5.0.5	pass vondruch #1352576
rubygem-spring	No need to update	pass jaruga #1279891
rubygem-spring-watcher-listen	Create? (~> 2.0.0) TODO	pass jaruga #1361584
rubygem-sqlite3	No need to update	pass jaruga
rubygem-tilt	No need to update	pass jaruga
rubygem-turbolinks	Update to 5.x	pass vondruch #1352597
rubygem-turbolinks-source	Create? TODO	pass vondruch #1359224
rubygem-uglifier	No need to update. Fix the build failure.	pass jaruga #1357879
rubygem-web-console	Update to >= 3.1	pass vondruch #1291685

The lists are compiled from the result of "bundle list" and "Gemfile.lock" after both installing rails, and creating new Rails app.

• Other developers: Update Rails dependent packages to be working with Ruby on Rails 5.0

• Release engineering: Not needed.

• Policies and guidelines: Not needed

• Trademark approval: N/A (not needed for this Change)

Upgrade/compatibility impact

Web applications build above Ruby on Rails framework might need to be updated. Official upstream upgrade guide might come handy: http://guides.rubyonrails.org/upgrading_ruby_on_rails.html

How To Test

The test packages are available in Copr (WIP):

https://copr.fedorainfracloud.org/coprs/vondruch/ror5/

• No special hardware is needed.
• To test Rails 5.0 from upstream:

gem install rails -v 5.0.x
rails new app
cd app && rails s

• Go to http://127.0.0.1:3000/ and make sure you are running Rails 5.0.x
• To test only Rails itself

dnf install rubygem-{rails,sqlite3}
rails new app
cd app && rails s

• To test the complete feature including generating a new Rails app using RPM

su -c "dnf install rubygem-{rails,sqlite3,coffee-rails,sass-rails,uglifier,jquery-rails,turbolinks,jbuilder,sdoc,spring,byebug,web-console} nodejs"
rails new app --skip-bundle && cd app
rails s

• Go to http://127.0.0.1:3000/ and make sure you are running Rails 5.0.x

User Experience

• New version of Ruby on Rails (5.0) available
• The most significant Rails 5.0 features:
  • ActionCable: user can use WebSockets with the rest of your Rails application.
  • API mode: uesr can create a Rails application for API server easily with API mode.
  • Exclusive use of rails CLI over Rake. Add bin/rails test, bin/rails db:migrate. Now bin/rails is the one master command to rule them all.
  • ActionRecord attributes: user can override ActiveRecord attributes if needed.

Dependencies

• There are several packages, which depends on Ruby on Rails framework. All need to be tested an updated:
• These needs to be surely updated:
  • none now
• Following gems don't support Rails 5.0 right now and would be broken by the update:
  • none now
• As Rails requires Ruby >= 2.2.2, the platform less than the version can not use Rails 5.0.

Contingency Plan

• Contingency mechanism: None needed. Rails stack won't be updated until all its dependencies are in Rawhide. After that, it will be a simple matter of updating the core packages (and their dependencies).
• Contingency deadline: N/A
• Blocks release? No

Documentation

• http://api.rubyonrails.org/

Release Notes

• http://weblog.rubyonrails.org/2016/6/30/Rails-5-0-final/
• http://edgeguides.rubyonrails.org/5_0_release_notes.html