Pretty print your Ruby objects with style -- in full color and with proper indentation
Awesome Print is a Ruby library that pretty prints Ruby objects in full color exposing their internal structure with proper indentation. Rails ActiveRecord objects and usage within Rails templates are supported via included mixins.
NOTE: awesomeprint v1.9.0 may not work on Ruby versions 2.4 or older or Rails versions 4.2 or older. The upcoming awesomeprint v2.0 will require Ruby v1.9.3 or later and Rails v3.0 or later.
# Installing as Ruby gem $ gem install awesome_printCloning the repository
$ git clone git://github.com/awesome-print/awesome_print.git
require "awesome_print" ap object, options = {}
Default options:
indent: 4, # Number of spaces for indenting. index: true, # Display array indices. html: false, # Use ANSI color codes rather than HTML. multiline: true, # Display in multiple lines. plain: false, # Use colors. raw: false, # Do not recursively format instance variables. sort_keys: false, # Do not sort hash keys. sort_vars: true, # Sort instance variables. limit: false, # Limit arrays & hashes. Accepts bool or int. ruby19_syntax: false, # Use Ruby 1.9 hash syntax in output. class_name: :class, # Method called to report the instance class name. (e.g. :to_s) object_id: true, # Show object id. color: { args: :pale, array: :white, bigdecimal: :blue, class: :yellow, date: :greenish, falseclass: :red, integer: :blue, float: :blue, hash: :pale, keyword: :cyan, method: :purpleish, nilclass: :red, rational: :blue, string: :yellowish, struct: :pale, symbol: :cyanish, time: :greenish, trueclass: :green, variable: :cyanish }
Supported color names:
:gray, :red, :green, :yellow, :blue, :purple, :cyan, :white :black, :redish, :greenish, :yellowish, :blueish, :purpleish, :cyanish, :pale
Use
Object#aito return an ASCII encoded string:
irb> "awesome print".ai => "\e[0;33m\"awesome print\"\e[0m"
$ cat > 1.rb require "awesome_print" data = [ false, 42, %w(forty two), { :now => Time.now, :class => Time.now.class, :distance => 42e42 } ] ap data ^D $ ruby 1.rb [ [0] false, [1] 42, [2] [ [0] "forty", [1] "two" ], [3] { :class => Time < Object, :now => Fri Apr 02 19:55:53 -0700 2010, :distance => 4.2e+43 } ]
$ cat > 2.rb require "awesome_print" data = { :now => Time.now, :class => Time.now.class, :distance => 42e42 } ap data, :indent => -2 # Time < Object, :now => Fri Apr 02 19:55:53 -0700 2010, :distance => 4.2e+43 }
$ cat > 3.rb require "awesome_print" data = [ false, 42, %w(forty two) ] data << data # false ^D $ ruby 3.rb [ false, 42, [ "forty", "two" ], [...] ]
$ cat > 4.rb require "awesome_print" class Hello def self.world(x, y, z = nil, &blk) end end ap Hello.methods - Class.methods ^D $ ruby 4.rb [ [0] world(x, y, *z, &blk) Hello ]
$ cat > 5.rb require "awesome_print" ap (''.methods - Object.methods).grep(/!/) ^D $ ruby 5.rb [ [ 0] capitalize!() String [ 1] chomp!(*arg1) String [ 2] chop!() String [ 3] delete!(*arg1) String [ 4] downcase!() String [ 5] encode!(*arg1) String [ 6] gsub!(*arg1) String [ 7] lstrip!() String [ 8] next!() String [ 9] reverse!() String [10] rstrip!() String [11] slice!(*arg1) String [12] squeeze!(*arg1) String [13] strip!() String [14] sub!(*arg1) String [15] succ!() String [16] swapcase!() String [17] tr!(arg1, arg2) String [18] tr_s!(arg1, arg2) String [19] upcase!() String ]
$ cat > 6.rb require "awesome_print" ap 42 == ap(42) ^D $ ruby 6.rb 42 true
$ cat > 7.rb require "awesome_print" some_array = (1..1000).to_a ap some_array, :limit => true ^D $ ruby 7.rb [ [ 0] 1, [ 1] 2, [ 2] 3, [ 3] .. [996], [997] 998, [998] 999, [999] 1000 ]
$ cat > 8.rb require "awesome_print" some_array = (1..1000).to_a ap some_array, :limit => 5 ^D $ ruby 8.rb [ [ 0] 1, [ 1] 2, [ 2] .. [997], [998] 999, [999] 1000 ]
$ rails console rails> require "awesome_print" rails> ap Account.limit(2).all [ [0] #<0x1033220b8> { :id => 1, :user_id => 5, :assigned_to => 7, :name => "Hayes-DuBuque", :access => "Public", :website => "http://www.hayesdubuque.com", :toll_free_phone => "1-800-932-6571", :phone => "(111)549-5002", :fax => "(349)415-2266", :deleted_at => nil, :created_at => Sat, 06 Mar 2010 09:46:10 UTC +00:00, :updated_at => Sat, 06 Mar 2010 16:33:10 UTC +00:00, :email => "[email protected]", :background_info => nil }, [1] #<0x103321ff0> { :id => 2, :user_id => 4, :assigned_to => 4, :name => "Ziemann-Streich", :access => "Public", :website => "http://www.ziemannstreich.com", :toll_free_phone => "1-800-871-0619", :phone => "(042)056-1534", :fax => "(106)017-8792", :deleted_at => nil, :created_at => Tue, 09 Feb 2010 13:32:10 UTC +00:00, :updated_at => Tue, 09 Feb 2010 20:05:01 UTC +00:00, :email => "[email protected]", :background_info => nil } ] rails> ap Account class Account < ActiveRecord::Base { :id => :integer, :user_id => :integer, :assigned_to => :integer, :name => :string, :access => :string, :website => :string, :toll_free_phone => :string, :phone => :string, :fax => :string, :deleted_at => :datetime, :created_at => :datetime, :updated_at => :datetime, :email => :string, :background_info => :string } rails>
To use awesome_print as default formatter in irb and Rails console add the following code to your ~/.irbrc file:
require "awesome_print" AwesomePrint.irb!
If you miss awesome_print's way of formatting output, here's how you can use it in place of the formatting which comes with pry. Add the following code to your ~/.pryrc:
require "awesome_print" AwesomePrint.pry!
awesome_print adds the 'ap' method to the Logger and ActiveSupport::BufferedLogger classes letting you call:
logger.ap object
By default, this logs at the :debug level. You can override that globally with:
:log_level => :info
in the custom defaults (see below). You can also override on a per call basis with:
logger.ap object, :warn
awesome_print adds the 'ap' method to the ActionView::Base class making it available within Rails templates. For example:
# ERB != ap @accounts.first # HAML
With other web frameworks (ex: in Sinatra templates) you can explicitly request HTML formatting:
true %>
Use methods such as
.redto set string color:
irb> puts "red text".red red text # (it's red)
You can set your own default options by creating
.aprcfile in your home directory. Within that file assign your defaults to
AwesomePrint.defaults. For example:
# ~/.aprc file. AwesomePrint.defaults = { :indent => -2, :color => { :hash => :pale, :class => :white } }
AwesomePrint follows the Semantic Versioning standard.
See CONTRIBUTING.md for information.
Copyright (c) 2010-2016 Michael Dvorkin and contributors
http://www.dvorkin.net
%w(mike dvorkin.net) * "@" || "twitter.com/mid"
Released under the MIT license. See LICENSE file for details.