DO NOT READ THIS FILE ON GITHUB, GUIDES ARE PUBLISHED ON http://guides.rubyonrails.org.

Ruby on Rails 5.1 릴리스 노트

Rails 5.1에서 주목할 점

• Yarn 지원
• 선택적인 웹팩(Webpack) 지원
• jQuery 더이상 기본 의존성이 아닙니다
• 시스템 테스트
• 암호화된 보안들
• 매개변수화된 메일러(Mailers)
• Direct & resolved routes
• form_for 및 form_tag 를 form_with에 통합

이 릴리스에서는 주요 변경점에 대해서만 설명합니다. 수정된 버그 및 변경점에 대해서는 Github Rails 저장소에 있는 changelog나 커밋 목록을 참고해주세요.

---

Rails 5.1로 업그레이드하기

기존 애플리케이션을 업그레이드한다면 그 전에 충분한 테스트 커버리지를 확보하는 것이 좋습니다. 애플리케이션이 Rails 5.0으로 업그레이드되지 않았다면 우선 이를 우선하고, 애플리케이션이 정상적으로 동작하는지 충분히 확인한 뒤에 Rails 5.1을 올려주세요. 업그레이드 시의 주의점에 대해서는 Ruby on Rails 업그레이드 가이드 를 참고해주세요.

주요 변경점

Yarn 지원

Pull Request

Rails 5.1은 NPM에서 Yarn을 통해 JavaScript 종속성을 관리 할 수 있습니다. 이렇게하면 React, VueJS 또는 NPM 세계의 다른 라이브러리와 같은 라이브러리를 쉽게 사용할 수 있습니다. Yarn 지원은 에셋 파이프라인과 통합되어 모든 종속성이 Rails 5.1 앱과 원활하게 작동합니다

선택적인 웹팩(Webpack) 지원

Pull Request

Rails 응용 프로그램은 JavaScript asset bundler인 Webpack과 새로운 Webpacker 젬 사용을보다 쉽게 통합 할 수 있습니다. Webpack 통합이 가능한 새로운 응용 프로그램을 생성 할 때 --webpack 플래그 사용합니다.

이는 에셋 파이프라인과 완벽하게 호환되며 이미지, 폰트, 사운드 및 기타 자산에 대해 계속 사용할 수 있습니다. 에셋 파이프라인에 의해 관리되는 일부 JavaScript 코드 및 Webpack을 통해 처리되는 기타 코드를 가질 수도 있습니다. 이 모든 것은 Yarn에 의해 관리됩니다, default로 활성화되어 있습니다.

jQuery는 더이상 기본 의존성이 아닙니다

Pull Request

jQuery는 이전 버전의 Rails에서 data-remote,data-confirm 및 기타 Rails의 겸손한 JavaScript 제공과 같은 기능을 제공하기 위해 기본적으로 필요했습니다. 하지만 더이상 요구되지 않는다, plain, vanilla JavaScript를 사용하기 위해 UJS가 재작성 되었기 때문이다 이 코드는 이제 Action View 내부에서 rails-ujs로 제공된다.

필요한다면 jquery를 사용해도 되지만, 이것은 더이상 default로 요구되지 않는다.

시스템 테스트

Pull Request

Rails 5.1은 Capybara 테스트를 시스템 테스트의 형태로 작성하기 위해 내장된 지원을 제공한다. 해당 테스트를 위한 Capybara와 데이터베이스 정리 전략을 구성하는 거에 대해서 더이상 걱정하지 않아도 된다. Rails 5.1은 크롬에서 실패 테스트 스크린 샷과 같은 추가 기능을 사용하여 테스트를 실행하는 래퍼를 제공한다.

암호화된 보안들

Pull Request

Rails는 이제sekrets gem에서 영감을 얻은 안전한 방법으로 애플리케이션 비밀 정보를 관리 할 수 있다. 새로운 보안 비밀 파일을 설치하기 위해 bin/rails secrets:setup를 실행한다.

이것은 또한 저장소 외부에 저장되어야하는 마스터 키를 생성한다. 비밀 자체는 암호화 된 형식으로 변경 관리 시스템에 안전하게 체크인 할 수 있다.

비밀은 RAILS_MASTER_KEY 환경 변수 또는 키 파일에 저장된 키를 사용하여 프로덕션에서 암호 해독된다.

매개변수화된 mailers

Pull Request

인스턴스 변수, 헤더 및 기타 공통 설정을 공유하기 위해 mailer 클래스의 모든 메서드에 사용되는 공통 매개 변수를 지정할 수 있다.

class InvitationsMailer < ApplicationMailer
  before_action { @inviter, @invitee = params[:inviter], params[:invitee] }
  before_action { @account = params[:inviter].account }

  def account_invitation
    mail subject: "#{@inviter.name} invited you to their Basecamp (#{@account.name})"
  end
end

InvitationsMailer.with(inviter: person_a, invitee: person_b)
                 .account_invitation.deliver_later

Direct & resolved routes

Pull Request

Rails 5.1에서는 DSL를 라우팅하기 위해서 resolve 와 direct 두개의 메서드를 추가했다. resolve메서드를 사용하면 모델의 다형성 매핑을 사용자 정의 할 수 있다.

resource :basket

resolve("Basket") { [:basket] }

<%= form_for @basket do |form| %>
  <!-- basket form -->
<% end %>

이것은 보통의 /baskets/:id 대신하여. 단일 URL /basket을 생성한다.

direct메서드는 커스텀 URL 헬퍼를 생성한다.

direct(:homepage) { "http://www.rubyonrails.org" }

>> homepage_url
=> "http://www.rubyonrails.org"

블록의 반환값은 url_for 메서드의 유효한 인자여야 합니다. 따라서 유효한 문자열 URL, 해시, 배열, Active Model 인스턴스 또는 Active Model 클래스를 전달할 수 있습니다.

direct :commentable do |model|
  [ model, anchor: model.dom_id ]
end

direct :main do
  { controller: 'pages', action: 'index', subdomain: 'www' }
end

form_for 및 form_tag를 form_with로 통합

Pull Request

Rails 5.1 이전 버전에서는, HTML 양식 처리에 모델 인스턴스에 대한 form_for와 커스텀 URL에 대한 form_tag 이렇게 두 개의 인터페이스가 있었습니다.

Rails 5.1 에서는 두 개의 인터페이스를 form_with로 결합하고, 스코프 혹은 모델에 기반하여 폼 태그를 생성할 수 있습니다.

URL만 사용하기:

<%= form_with url: posts_path do |form| %>
  <%= form.text_field :title %>
<% end %>

<%# Will generate %>

<form action="/posts" method="post" data-remote="true">
  <input type="text" name="title">
</form>

scope를 추가하면 입력 필드 이름에 접두어가 붙음:

<%= form_with scope: :post, url: posts_path do |form| %>
  <%= form.text_field :title %>
<% end %>

<%# Will generate %>

<form action="/posts" method="post" data-remote="true">
  <input type="text" name="post[title]">
</form>

모델을 사용하면 URL과 scope를 모두 추론:

<%= form_with model: Post.new do |form| %>
  <%= form.text_field :title %>
<% end %>

<%# Will generate %>

<form action="/posts" method="post" data-remote="true">
  <input type="text" name="post[title]">
</form>

존재하는 모델은 업데이트 양식을 만들고 필드 값을 채움:

<%= form_with model: Post.first do |form| %>
  <%= form.text_field :title %>
<% end %>

<%# Will generate %>

<form action="/posts/1" method="post" data-remote="true">
  <input type="hidden" name="_method" value="patch">
  <input type="text" name="post[title]" value="<the title of the post>">
</form>

비호환성

다음 변경에 대해서는 업그레이드 전에 대응을 해야합니다.

다중 연결을 사용한 Transactional tests

Transactional test들은 데이터베이스 transaction에서 모든 Active Record 연결을 완료했습니다.

테스트가 추가적인 스레드를 생성할 때, 그리고 이런 스레드들이 데이터베이스 연결될 때의 연결들은 이제 특별하게 처리됩니다:

이 스레드들은 Managed Transaction 내에 있는 하나의 연결을 공유할 것입니다. 모든 스레드들이 가장 바깥 쪽의 transaction을 무시하면서, 동일한 상태의 데이터베이스를 볼 수 있도록 보장해줍니다. 이전에, 이러한 추가적인 연결들은 고정 줄로 보는 것이 불가능했습니다, 예를 들면.

스레드가 중첩된 transaction에 들어갈 때, 독립을 유지하기 위해, 일시적으로 연결의 독점적인 사용을 얻을것입니다.

테스트가 생성된 스레드에서 별도의 transaction 외부 연결을 얻는 데 의존하는 경우, 보다 명확한 연결 관리자로 전환할 필요가 있습니다.

당신의 테스트에서 스레드를 생성하고 이 스레드들이 명시적 데이터베이스 transaction을 사용하면서 상호 작용하는 경우, 이 변화로 데드락이 발생할 수 있습니다.

이런 새로운 동작을 거부하는 쉬운 방법은 영향을 미치는 모든 테스트 케이스에서 transaction test를 비활성화하는 것입니다.

Railties

자세한 변경사항은 Changelog 를 참조해 주세요.

제거된 것들

• 제거 예정이었던 config.static_cache_control이 제거. (commit)

• 제거 예정이었던 config.serve_static_files이 제거. (commit)

• 제거 예정이었던 파일 rails/rack/debugger이 제거. (commit)

• 제거 예정이었던 태스크들 : rails:update, rails:template, rails:template:copy, rails:update:configs 그리고 rails:update:bin 이 제거. (commit)

• 제거 예정이었던 routes 태스크에 대한 CONTROLLER 환경 변수가 제거. (commit)

• rails new 명령에서 -j(--javascript) 옵션을 제거. (Pull Request)

주요 변경점

• 모든 환경에 로드되어지는 config/secrets.yml에 공유 섹션을 추가 (commit)

• config/secrets.yml 설정 파일은 이제 심벌로서 모든 키들과 함께 로드됨. (Pull Request)

• 기본 스택에서 jquery-rails를 제거함. Action View와 함께 제공되는 rails-ujs는 기본 UJS 어댑터로 포함. (Pull Request)

• yarn binstub과 package.json. 으로 새로운 앱에서 Yarn 지원을 추가. (Pull Request)

• 새로운 앱에서 rails/webpacker gem 에게 위임하게 되는 옵션인 --webpack을 통해 Webpack 지원을 추가. (Pull Request)

• 새로운 앱 생성 시, 만약 --skip-git 옵션이라면 Git 저장소를 초기화하는 것은 제공되지 않음. (Pull Request)

• config/secrets.yml.enc에 암호화 된 기밀들을 추가. (Pull Request)

• rails initializers에서 railtie 클래스 명을 보여줌. (Pull Request)

Action Cable

자세한 변경사항은 Changelog 을 참조하세요.

주요 변경점

• 여러 애플리케이션에서 동일한 Redis 서버를 실행할 때, 이름 충돌을 피하기 위해 cable.yml의 Redis와 이벤트 발생 Redis어댑터에 channel_prefix지원을 추가. (Pull Request)

• 양방향성 데이터를 위해 ActiveSupport::Notifications훅을 추가. (Pull Request)

Action Pack

자세한 변경사항은 Changelog 을 참조하세요.

제거된 것들

• ActionDispatch::IntegrationTest와 ActionController::TestCase클래스에 속한 #process, #get, #post, #patch, #put, #delete 그리고 #head의 non-keyword인자들의 지원을 제거. (Commit, Commit)

• 제거 예정이었던 ActionDispatch::Callbacks.to_prepare과 ActionDispatch::Callbacks.to_cleanup을 제거. (Commit)

• 제거 예정이었던 컨트롤러 필터와 연관된 메서드들을 제거. (Commit)

제거 예정

• config.action_controller.raise_on_unfiltered_parameters가 제거 예정. Rails 5.1에선 더이상 효과가 없습니다. (Commit)

주요 변경점

• DSL 라우팅을 위한 direct와 resolve 메서드를 추가. (Pull Request)

• 당신의 애플리케이션에 시스템 테스트를 작성하기 위해 새로운 클래스 ActionDispatch::SystemTestCase 를 추가. (Pull Request)

Action View

자세한 변경사항은 Changelog를 참조하세요.

제거된 것들

• 제거 예정이었던 ActionView::Template::Error 의 #original_exception이 제거. (commit)

• strip_tags의 잘못된 명칭 encode_special_chars옵션을 제거. (Pull Request)

제거 예정

• Erubis ERB 핸들러 제거 예정 앞으로는 Erubi를 사용. (Pull Request)

주요 변경점

• 이제 순수한 템플릿 핸들러(기본 Rails 5의 템플릿 핸들러)는 HTML-safe 문자열들을 출력. (commit)

• datatime-local필드를 생성하기 위해 datetime_field와 datetime_field_tag를 변경. (Pull Request)

• HTML 태그들(tag.div, tag.br, etc.)를 위한 새로운 Builder-style 문법. (Pull Request)

• form_tag와 form_for사용법을 통일하기위한 form_with 추가. (Pull Request)

• current_page?를 위한 check_parameters옵션 추가. (Pull Request)

Action Mailer

자세한 변경사항은 Changelog를 참조하세요.

주요 변경점

• 첨부 파일이 포함되고 본문이 인라인으로 설정된 경우 사용자 지정 콘텐츠 형식을 사용. (Pull Request)

• default메서드에 값으로 lambdas를 전달하는 것을 허용. (Commit)

• 다른 메일러 액션 사이의 필터 및 default보다 먼저 공유를 위해 메일러 호출의 매개변수화 지원을 추가. (Commit)

• 메일러 액션에 들어오는 인자들을 args키 아래의 process.action_mailer이벤트로 전달. (Pull Request)

Active Record

자세한 변경사항은Changelog를 참고해주세요.

제거된 것들

• 인자들과 블록을 동시에 ActiveRecord::QueryMethods#select에 전달하는 지원을 제거. (Commit)

• 제거 예정이었던 i18n스코프에서 activerecord.errors.messages.restrict_dependent_destroy.one과 activerecord.errors.messages.restrict_dependent_destroy.many가 제거. (Commit)

• 제거 예정이었던 singular인자 와 collection association readers인자를 강제로 불러오는것을 제거. (Commit)

• 제거 예정이었던 컬럼을 #quote로 전달하는 지원을 제거. (Commit)

• 제거 예정이었던 #tables로부터 name 인자를 제거. (Commit)

• 제거 예정이었던 테이블과 뷰를 반환하는 #tables와 #table_exists? 의 행동을 테이블만 반환하고 뷰는 반환하지 않기위해 제거. (Commit)

• 제거 예정이었던 ActiveRecord::StatementInvalid#initialize와 ActiveRecord::StatementInvalid#original_exception 안의 original_exception인자를 제거. (Commit)

• 제거 예정이었던 질의 내에 변수를 클래스로 전달하는 지원을 제거. (Commit)

• 제거 예정이었던 LIMIT에서 쉼표를 사용하여 질의하는 지원을 제거. (Commit)

• 제거 예정이었던 #destroy_all의 conditions매개변수를 제거. (Commit)

• 제거 예정이었던 #delete_all의 conditions매개변수를 제거. (Commit)

• 제거 예정이었던 #load_schema_for메서드를 제거하고 앞으로는 #load_schema을 사용. (Commit)

• 제거 예정이었던 #raise_in_transactional_callbacks구성을 제거. (Commit)

• 제거 예정이었던 #use_transactional_fixtures구성을 제거. (Commit)

제거 예정

• error_on_ignored_order_or_limit가 제거 예정 앞으로는 error_on_ignored_order를 사용. (Commit)

• sanitize_conditions가 제거 예정 앞으로는 sanitize_sql를 사용. (Pull Request)

• supports_migrations?에 연결된 어탭터는 제거 예정 (Pull Request)

• Migrator.schema_migrations_table_name는 제거 예정, 대신에SchemaMigration.table_name를 사용. (Pull Request)

• 인용 및 타입캐스팅에서 #quoted_id사용을 제거 예정. (Pull Request)

• #index_name_exists?의 default인자는 제거 예정. (Pull Request)

주요 변경점

• Default Primary 키를 BIGINT로 바꿈 (Pull Request)

• MySQL 5.7.5+ 과 MariaDB 5.2.0+는 가상/생성 컬럼을 지원. (Commit)

• 일괄 처리의 한도에 대한 지원이 추가. (Commit)

• Transactional tests는 이제 모든 Active Record connections를 데이터베이스 transactions로 감싼다. (Pull Request)

• mysqldump의 기본적인 명령어의 출력에 대한 주석을 스킵. (Pull Request)

• 전달된 블록을 자동으로 무시하는 대신 인자로 전달될 때 레코더를 카운트하기 위한 루비의 Enumerable#count사용을 위해 ActiveRecord::Relation#count 를 수정. (Pull Request)

• SQL 에러를 억제하지 않도록 psql명령어를 "-v ON_ERROR_STOP=1"플래그와 전달. (Pull Request)

• ActiveRecord::Base.connection_pool.stat 추가. (Pull Request)

• ActiveRecord::Migration으로부터 직접 상속하면 에러가 발생, 마이그레이션이 작성된 레일즈 버전을 지정할것. (Commit)

• through관계가 모호하게 반영된 이름을 가졌을 때 에러가 발생. (Commit)

Active Model

자세한 변경사항은Changelog를 참고해주세요.

제거된 것들

• ActiveModel::Errors에 제거 예정이었던 메서드 제거. (commit)

• 제거 예정이었던 길이 검사 :tokenizer옵션이 제거. (commit)

• 제거 예정이었던 반환 값이 false 일 때 콜백을 중지시키는 동작을 제거. (commit)

주요 변경점

• 모델 속성에 할당 된 컬렉션 문자열이 더 이상 잘못 고정되지 않습니다. (Pull Request)

Active Job

자세한 변경사항은Changelog를 참고해주세요.

제거된 것들

• 제거 예정이었던 어댑터 클래스를 .queue_adapter에 넘기는 지원을 제거. (commit)

• 제거 예정이었던ActiveJob::DeserializationError안에 #original_exception 제거. (commit)

주요 변경점

• ActiveJob::Base.retry_on와 ActiveJob::Base.discard_on을 경유한 선언적 예외 핸들링을 추가. (Pull Request)

• 재시도들이 실패한 후 사용자 로직의 job.arguments같은 것들에 액세스 하기 위해 인스턴스를 얻을것. (commit)

Active Support

자세한 변경사항은Changelog를 참고해주세요.

제거된 것들

• ActiveSupport::Concurrency::Latch클래스는 제거. (Commit)

• halt_callback_chains_on_return_false는 제거. (Commit)

• 제거 예정이었던 반환 값이 false 일 때 콜백을 중지시키는 동작을 제거. (Commit)

제거 예정

• 최상위 클래스 HashWithIndifferentAccess가 부드럽게 제거 예정 앞으로는 ActiveSupport::HashWithIndifferentAccess를 사용. (Pull Request)

• 문자열을 set_callback과 skip_callback상의 :if와 :unless선택적 옵션에 전달을 제거 예정. (Commit)

주요 변경점

• DTS 변경들을 통해 일관성있게 만들기 위해 Duration 파싱과 트래벌링을 수정. (Commit, Pull Request)

• 유니코드 버전을 9.0.0으로 업데이트 됨. (Pull Request)

• Duration#before과 #after를 #ago와 #since의 별칭으로 추가. (Pull Request)

• 현재 객체에 대해 정의되지 않은 메서드호출을 프록시 객체에 위임하기 위해 Module#delegate_missing_to를 추가. (Pull Request)

• Date#all_day는 현재 날짜와 시간의 전체 날짜를 나타내는 범위를 반환하는 메소드를 추가. (Pull Request)

• assert_changes 과 assert_no_changes 메서드는 test에 도입. (Pull Request)

• travel과 travel_to메서드는 중첩 가능. (Pull Request)

• DateTime#change는 usec와 nsec를 지원. (Pull Request)

크레딧 표기

Rails를 견고하고 안정적인 프레임워크로 만들기 위해 많은 시간을 사용해주신 많은 개발자들에 대해서는 Rails 기여자 목록을 참고해주세요. 이 분들에게 경의를 표합니다.