add Pathname#existence

Author: timoschilling

activesupport/CHANGELOG.md

@@ -1,3 +1,11 @@
+*   Add `Pathname#existence`.
+
+    ```ruby
+    Pathname.new("file").existence&.read
+    ```
+
+    *Timo Schilling*
+
 *   Remove deprecate `ActiveSupport::Multibyte::Unicode.default_normalization_form`.
 
     *Rafael Mendonça França*

activesupport/lib/active_support/core_ext/pathname.rb

@@ -0,0 +1,3 @@
+# frozen_string_literal: true
+
+require "active_support/core_ext/pathname/existence"

activesupport/lib/active_support/core_ext/pathname/existence.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+class Pathname
+  # Returns the receiver if the named file exists otherwise returns +nil+.
+  # <tt>pathname.existence</tt> is equivalent to
+  #
+  #    pathname.existence? ? object : nil
+  #
+  # For example, something like
+  #
+  #   content = pathname.read if pathname.exist?
+  #
+  # becomes
+  #
+  #   content = pathname.existence&.read
+  #
+  # @return [Pathname]
+  def existence
+    self if exist?
+  end
+end

activesupport/test/core_ext/pathname/existence_test.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+require_relative "../../abstract_unit"
+require "active_support/core_ext/pathname/existence"
+
+class PathnameExistenceTest < ActiveSupport::TestCase
+  def test_presence
+    existing = Pathname.new(__FILE__)
+    not_existing = Pathname.new("not existing")
+    assert_equal existing, existing.existence
+    assert_nil not_existing.existence
+  end
+end