Pry-Toys

For the times when you need to create a throwaway Array of Floats:

Array.toy(3, Float) # => [1.0, 2.0, 3.0]

or Hash with 300 keys:

Hash.toy(300) # => { a: 1, b: 2, ..., kn: 300 }

or String with 2 words:

String.toy(2) # => "ttttttt oooo"

After gem is installed, these toy / throwaway Ruby objects are loaded in automatically when pry is started. The idea was inspired by this

Installation

You can either install gem individually or you can add it to your Gemfile. To add the gem directly, type in the following in your terminal line:

gem install pry-toys

Alternatively, if your project has a Gemfile, you can add pry-toys there:

gem 'pry-toys'

Or if you would like to add the gem to specific group, you can do the following:

group :development, :test do
  gem 'pry-toys'
end

This will ensure that the gem is only loaded in development or test environments, but not in production. Do not forget to run

bundle install

after adding the pry-toys to Gemfile.

To make sure pry-toys has been successfully added to pry, run the following in your terminal:

pry --installed-plugins

If pry-toys gem installed correctly, you should see toys as one of the plugins in the list.

Usage

Here are some of the things you can do with pry-toys:

Arrays

With only size set

Array.toy(3) # => [1, 2, 3]

With size & block

Array.toy(3) {|i| i + 3} # => [3, 6, 9]

With size & one of the pre-determined objects, such as Integer (default), Float, String, Time, Date set

Array.toy(3, Float) # => [1.0, 2.0, 3.0]
Array.toy(3, String) # => ['tt', 'uuuu', 'cc']
Array.toy(3, Time) # => [2014-02-22 08:49:49 -0800, 2014-02-23 08:49:49 -0800, 2014-02-24 08:49:49 -0800]
Array.toy(3, Date) # => [#<Date: 2014-02-22 ((2456711j,0s,0n),+0s,2299161j)>,
                         #<Date: 2014-02-23 ((2456712j,0s,0n),+0s,2299161j)>,
                         #<Date: 2014-02-24 ((2456713j,0s,0n),+0s,2299161j)>]

With size & an unknown object (that responds to new)

Array.toy(3, Object) # => [#<Object:0x007fa36e9b9128>,
                           #<Object:0x007fa36e9b9100>,
                           #<Object:0x007fa36e9b90d8>]

Enumerators

Enumerators are always infinite (Ruby 2):

Enumerator.toy.size # => Infinity

You can set the type the same way like in Array:

Enumerator.toy(Time) # => #<Enumerator: ...>
Enumerator.toy(Time).take(3)  # => [#<Date: 2014-02-22 ((2456711j,0s,0n),+0s,2299161j)>,
                                    #<Date: 2014-02-23 ((2456712j,0s,0n),+0s,2299161j)>,
                                    #<Date: 2014-02-24 ((2456713j,0s,0n),+0s,2299161j)>]

When passing a block, it will be executed lazily:

> enum = Enumerator.toy {|i| puts "Called with #{i}" }
> enum.next
Called with 0
> enum.next
Called with 1

Hashes

With size set, you can make Hash as small or as big as you want:

Hash.toy(3) # => {a: 1, b: 2, c: 3}

Or as large as 100000 (or larger)

h = Hash.toy(100000)
h.keys.last # => "eqxd"
h.values.last # => 100000
h # => {a: 1, ...., eqxd: 100000}

Strings

Creates a string with certain number of words. In this case, words are random collection of letters (not actual words).

String.toy(3) # => "mmmmmmmm xxxx hhhhhh"

Contributing

Form the project
Make changes
Test changes using the following task:

rake spec
Commit changes. Please do not change pry-toys.gemspec on the version you are planning to submit for the pull request.
Send a pull request

laurentzziu/pry-toys