# -*- encoding: utf-8 -*- # stub: lll 1.1.0 ruby lib Gem::Specification.new do |s| s.name = "lll".freeze s.version = "1.1.0".freeze s.required_rubygems_version = Gem::Requirement.new(">= 0".freeze) if s.respond_to? :required_rubygems_version= s.require_paths = ["lib".freeze] s.authors = ["Mark Wilden".freeze] s.date = "2010-05-13" s.description = "= lll\n\nlll() is used in debugging to display an expression and its value.\n\n=== Motivation\n\nOne of the most basic tools in debugging is printing out the values of\nvariables (or other expressions) during program execution:\n\n puts user_name\n\nSometimes you need to label these values so you know what they're\nreferring to, especially if you're outputting a lot of them:\n\n puts \"user_name = \#{message}\"\n\nlll() does the labelling automatically: \n\n lll{'user_name'}\n\nThe expression is passed as a string inside a block. It's useful to\ncreate a text editor macro that outputs lll{''} and leaves the\ncursor inside the apostrophes.\n\n=== Other benefits\n\nOutput goes to standard output and the Rails log (if available).\n\nOutput is displayed in reverse video, so it's easy to pick out from the\nlog or console.\n\nlll() uses #inspect to output the expression. It outputs Enumerable\nmembers (except strings) on separate lines.\n\nOutput is tagged with the file and line number where it appears, so\nyou can easily find lll's that you forgot to take out. The time of\nday (but not the date) is also printed, so you don't waste time\nlooking at old output.\n\n=== Outputting additional text\n\nSometimes you want to include some other string, along with the label\nand value like this:\n\n puts \"After polling the queue, user_name = \#{user_name}\"\n\nYou can pass a string to lll() to print a string:\n\n lll(\"After polling the queue\"){'user_name'}\n\nAnd because lll() outputs in reverse video, and to the Rails log, it can\nbe useful to simply print a string without an expression:\n\n lll \"After read_user\"\n\n=== Copyright\n\nCopyright (c) 2009 Mark Wilden. See LICENSE for details.\n".freeze s.email = "mark@mwilden.com".freeze s.extra_rdoc_files = ["LICENSE".freeze, "README.rdoc".freeze] s.files = [".document".freeze, ".gitignore".freeze, "LICENSE".freeze, "README.rdoc".freeze, "Rakefile".freeze, "VERSION".freeze, "doc/README_rdoc.html".freeze, "lib/lll.rb".freeze, "test/test.rb".freeze] s.homepage = "http://github.com/mwilden/lll".freeze s.rdoc_options = ["--charset=UTF-8".freeze] s.rubygems_version = "3.5.10".freeze s.summary = "Output labeled data when debugging".freeze s.test_files = ["test/test.rb".freeze] end