Ruby private method : a hack
Private methods exist for a reason. However they can lead to tricky situations. Here is a quick hack about private methods in Ruby.
How to declare a private method
class Wolf def scare "scaring..." end private def sleep "sleeping.." end def eat "eating.." end end
All methods above the keyword "private" is considered as public, all methods below are considered as private.
Note that "private" here is not a keyword, but a method of the Kernel module.
What is a private method in Ruby
A private method cannot be called from the outside. Let's use a wolf in the IRB console. To use our Wolf above, simply copy/paste the class in the console (console will kindly accept carriage return)
$irb(main)> w = Wolf.new => #<Wolf:0x00007fee2c760440> $irb(main)> w.scare => "scaring..." $irb(main)> w.sleep Traceback (most recent call last): 1: from (irb):38:in `<main>' NoMethodError (private method `sleep' called for #<Wolf:0x00007fee2c760440>)
Now you got the idea. An object can decide to hide its internal behaviour, to ensure consistency. If you don't know what it this about, you can read about encapsulation, or read this in-depth article about method visibility in Ruby.
Private methods in Ruby : the annoying parts
Why to hack a well-known OOP principle ? Because I find this privacy annoying. There are some corner cases :
- You want just one other class to access the private method (but no other classes).
- You want to test a private method because the regular way (test a private method through available public methods) do not work.
- You have to think about hierarchy, and how "protected" methods are handled, and if this hierarchy suits your needs.
Ruby is nice enough to avoid this mental headache : you can use the .send method to bypass the privacy rule.
$irb(main)> w.send('sleep') => "sleeping.."
But why to lose so much energy... One time to define what is private or not, and another one to be sure we can go around the limitation.
Do we need this privacy anyway ?
Maybe yes. I'm thinking about Open-Source projects. Maintainers don't want the final user to manipulate private things, and break the internal behaviour (and raise some issue on Github...) about the Ruby gem. OOP is there for a reason.
But for your business, daily app, I think it's a burden. Often these applications are already private anyway. Think about a Rails app : no one can see your code. The /public folder is meant for frontend assets, not your codebase.
Thus I go around the "private" keyword by using an underscore as a suffix. Our wolf would now look like this :
class Wolf def scare "scaring..." end def _sleep "sleeping.." end def _eat "eating.." end end
Each time I encounter an underscore, I know it means "hey be aware this is something fragile, in theory only the class, or fellow class, or test, may use it".
It was not invented here of course. As far as I can remember, Frameworks like VueJS use a double-underscore as a suffix, and I've seen this convention in other projects.
Private methods in Ruby recursive function
There is one last use case for this kind of privacy : private arguments.
Let's say I have a recursive function, and I have to track the number of time the function is called to avoid an infinite loop :
def countdown(n, _number_of_calls = 0) if n < 1 return elsif _number_of_calls > 5 puts 'too much calls, exiting' return else puts n end countdown(n-1, _number_of_calls + 1) end
Notice the _number_of_calls is not part of the public parameters :
$irb(main)> countdown(2) 2 1 => nil
And if I exceed the number of call, I exit the recursion :
$irb(main)> countdown(10) 10 9 8 7 6 5 too much calls, exiting => nil
private methods are necessary, it's a basic thing in OOP languages. However for your business app there is a nice shortener : the underscore - or any other convention you prefer.
Help needed 😊
If you enjoyed the article, you can :
- Share the article on Twitter , or LinkedIn , or Reddit , it will stimulate the writing effort, thanks !
Subscribe to the newsletter, you'll be warned each time a new Rails tutorial is released : we start from the
rails newcommand to fully understand a new concept.
- Subscribe to the Bootrails Beta, it's a tool to launch new Rails apps.
Thanks to all,