diff options
Diffstat (limited to 'app/models/active_storage/filename.rb')
-rw-r--r-- | app/models/active_storage/filename.rb | 10 |
1 files changed, 10 insertions, 0 deletions
diff --git a/app/models/active_storage/filename.rb b/app/models/active_storage/filename.rb index 71614b5113..8605e4960c 100644 --- a/app/models/active_storage/filename.rb +++ b/app/models/active_storage/filename.rb @@ -1,3 +1,5 @@ +# Encapsulates a string representing a filename to provide convenience access to parts of it and a sanitized version. +# This is what's returned by `ActiveStorage::Blob#filename`. A Filename instance is comparable so it can be used for sorting. class ActiveStorage::Filename include Comparable @@ -5,22 +7,30 @@ class ActiveStorage::Filename @filename = filename end + # Filename.new("racecar.jpg").extname # => ".jpg" def extname File.extname(@filename) end + # Filename.new("racecar.jpg").extension # => "jpg" def extension extname.from(1) end + # Filename.new("racecar.jpg").base # => "racecar" def base File.basename(@filename, extname) end + # Filename.new("foo:bar.jpg").sanitized # => "foo-bar.jpg" + # Filename.new("foo/bar.jpg").sanitized # => "foo-bar.jpg" + # + # ...and any other character unsafe for URLs or storage is converted or stripped. def sanitized @filename.encode(Encoding::UTF_8, invalid: :replace, undef: :replace, replace: "�").strip.tr("\u{202E}%$|:;/\t\r\n\\", "-") end + # Returns the sanitized version of the filename. def to_s sanitized.to_s end |