WrappedPrint

How usually you debug your code? Binding.pry, byebug, puts, ...

How ofter do you write a code something like:

puts "="*50
puts current_user.full_name
puts "="*50

I do this at least few times per week, sometimes per day.

This is annoying. It's need to be automated. And this gem is a simple solution.

Just add this gem and use a global method .wp to see in the console value of your object or wrap code in block with wp { ... }.

def index
  # to get list of emails and print them in console
  # .wp method prints in console and returns same object
  @emails = User.pluck(:emails).wp
end

See screenshot below with examples of usage (gem can be used not only in specs, this is just an example).

Installation

Add this line to your application's Gemfile:

gem 'wrapped_print'

And then execute:

$ bundle install

Or install it yourself as:

$ gem install wrapped_print

And then require "wrapped_print"

Usage

You can do a simple configuration to the gem (config/initializers/wrapped_print.rb):

WrappedPrint.setup do |config|
  # config.log_to = :console # simply puts
  config.log_to = :logs # e.g. Rails.logger.info....
  # config.log_to = ActiveSupport::Logger.new($stdout) # custom logger

  # # applicable only for Logger (not console)
  config.level = :debug
  # config.level = :info
end if defined?(WrappedPrint)

You can print using puts or to Rails.logger.

Output could be customized with several options:

wp(label = nil, pattern: "-", count: 80, prefix: nil, suffix: nil, color: nil)

For example:

"Demo with color 3".wp("COLORIZED: ", color: :pur, pattern: '*')

#
# see how .wp is called. This method `.wp` returning the original value, so you can use it as normal variable.
#
class A
  def calc
    z = balance.wp # same as z = balance
    100 + 200 + z
  end

  def balance
    500
  end
end

Development

After checking out the repo, run bin/setup to install dependencies. Then, run rake spec to run the tests. You can also run bin/console for an interactive prompt that will allow you to experiment.

To install this gem onto your local machine, run bundle exec rake install. To release a new version, update the version number in version.rb, and then run bundle exec rake release, which will create a git tag for the version, push git commits and tags, and push the .gem file to rubygems.org.

Contributing

Bug reports and pull requests are welcome on GitHub at https://github.com/igorkasyanchuk/wrapped_print.

License

The gem is available as open source under the terms of the MIT License.

igorkasyanchuk / wrapped_print