-
01 / GET READY
Install Facets
Facets 4.1.0 requires Ruby 3.1 or newer. Install it directly with RubyGems or add it to a Bundler project.
TERMINAL
gem install facets
GEMFILE
gem 'facets', require: false
require: false keeps Bundler from loading the entire core collection automatically, so you can choose the files your project needs.
To have Bundler load only certain extensions, for example in a Rails app, list their files instead:
GEMFILE
gem 'facets', require: ['facets/array/to_ranges', 'facets/string/snakecase']
+
01 / GET READY
Install Facets
Facets 4.2.0 requires Ruby 3.1 or newer. Install it directly with RubyGems or add it to a Bundler project.
TERMINAL
gem install facets
GEMFILE
gem 'facets', require: false
require: false keeps Bundler from loading the entire core collection automatically, so you can choose the files your project needs.
To have Bundler load only certain extensions, for example in a Rails app, list their files instead:
GEMFILE
gem 'facets', require: ['facets/array/to_ranges', 'facets/string/snakecase']
02 / CHOOSE YOUR SCOPE
Load what fits
Most core extension methods are stored in individual files. You can require one method, a class's core methods, or the core collection.
RUBY
require 'facets/array/to_ranges'
diff --git a/docs/news.html b/docs/news.html
index 95e3a66a..0214d298 100644
--- a/docs/news.html
+++ b/docs/news.html
@@ -5,7 +5,8 @@
---
RELEASES & HISTORY
A living Ruby
collection.
Facets has been growing since 2004. Here are the recent releases and a path back through its story.
LATEST RELEASES
Facets 4
Facets 4 continues the modernization begun in 3.2 for Ruby 3.1 and newer. The 3.2.0 release changed enough that it should have been 4.0.0; 4.0.0 makes the next round of changes under the right number.
-
4.1.008 NOV 2026
LATEST
Out of Ruby's way
Makes the methods Facets shares with ActiveSupport behave as ActiveSupport's do, so it no longer matters which library loads last. Stops Facets from changing what Ruby's own methods do, including Hash#count and Array#shelljoin, and deprecates the block form of Kernel#extend.
Read changes ↗
+
4.2.017 NOV 2026
LATEST
Old friends return
Adds Integer#to_base and String#from_base for any base from 2 to 62, and a :flush option for String#margin. Brings back three libraries that began in Facets, each loaded on request: Mirror for looking inside any object, Paramix for parametric mixins, and String::Mask. Fixes String#dashcase, Dir.multiglob, Array#delete_first and the salt Crypt3 generates.
Read changes ↗
+
4.1.008 NOV 2026
Out of Ruby's way
Makes the methods Facets shares with ActiveSupport behave as ActiveSupport's do, so it no longer matters which library loads last. Stops Facets from changing what Ruby's own methods do, including Hash#count and Array#shelljoin, and deprecates the block form of Kernel#extend.
Read changes ↗
4.0.102 NOV 2026
Safer shell escaping
Stops facets/shellwords from replacing Ruby's Shellwords.escape with a version that left shell metacharacters unescaped, lets Rails apps that load Facets boot again, and fixes several methods that broke on Ruby 3.
Read changes ↗
4.0.027 SEP 2026
Clearer by design
Makes #try strict and #try! lenient, moves Rails-compatible methods to a new lib/rails area, and schedules every deprecation for removal after 2027-09-30.
Read changes ↗
3.2.215 JUN 2026
Compatibility, polished
Fixes range intersection on Ruby 3.1 and 3.2, restores Range#overlap? where Ruby does not provide it, and corrects Binding#caller_locations argument handling.
Read changes ↗
diff --git a/lib/core/facets/version.rb b/lib/core/facets/version.rb
index db5689d1..c94ac56f 100644
--- a/lib/core/facets/version.rb
+++ b/lib/core/facets/version.rb
@@ -1,3 +1,3 @@
module Facets
- VERSION = '4.1.0'
+ VERSION = '4.2.0'
end