Could you add method documentation to say what the parameters are and what the return values are? Something like https://github.com/adrienthebo/puppet-portage/blob/master/lib/puppet/util/portage.rb#L24 would be good.