uuids 1.4.1 → 1.4.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 5da4310e0513240c73c5f30d4d04fe9806271af8
-  data.tar.gz: 4a0f7b2b9b9a141ad21e76b1d0f44cfc6fec9b41
+  metadata.gz: 5b59630d1254cf17915e3a7b7beb44845dd1812f
+  data.tar.gz: 9eb598e421669103dcbf1c227e71e0ce5a5b775a
 SHA512:
-  metadata.gz: 7fa00c4678aee17d4d0ceef8da2ec8c2019e4363107ef1ba772f9ca89daa99fae98a1aaf49e887259a716994a68b55364abd05bc9be2a5f3b898bb6b04955756
-  data.tar.gz: a2eb9c7475f5ccce7d5d1cb4ae45054ef3e9c9400585e28b10060135c1d8dfac8d39cd7e2f9ca526043aa64915c786493456b879ed76fe8515f69d6ca9f508be
+  metadata.gz: e8c87ee98ad9b849aa557e1da0b42fb1da5b699dfce7e3039bdc448c0b2fda9884865b233d79b37f79a008ce33b2b71540bbb276c8b352e0999d14c6588c8ed3
+  data.tar.gz: 5c94540825bcbf75fc55890c4ac28c1d5dfac97e41050de8e11a60796b4c4e82bf3b3431d7f1e93b7d7f6af7a713b7dd1ab4e420daf2fcb617c5e0f6b5a43f23

data/.rubocop.yml

@@ -3,10 +3,6 @@ AllCops:
     - 'spec/dummy/**/*'
     - 'Rakefile'
 
-Lint/Eval:
-  Exclude:
-    - 'spec/**/*'
-
 Lint/HandleExceptions:
   Exclude:
     - 'spec/**/*'
@@ -33,7 +29,13 @@ Style/Documentation:
     - 'db/**/*'
     - 'lib/uuids/version.rb'
 
-Style/EmptyLinesAroundBody:
+Style/EmptyLinesAroundClassBody:
+  Enabled: false
+
+Style/EmptyLinesAroundMethodBody:
+  Enabled: false
+
+Style/EmptyLinesAroundModuleBody:
   Enabled: false
 
 Style/EmptyLineBetweenDefs:

data/bin/uuids

@@ -1,13 +1,6 @@
 #!/usr/bin/env ruby
-require_relative "../lib/generators"
+require "active_record_install"
 
-# Runs the generator.
-#
-# @example
-#     $ uuids install
-#
-# To see additional options call
-#
-#     $ uuids install -h
-#
-Generators::Install.start
+ActiveRecordInstall::Generator.start(
+  [File.expand_path("../..", __FILE__), "uuids"] + ARGV[1..-1]
+)

data/lib/uuids/base/has_uuids.rb

@@ -8,7 +8,9 @@ module Uuids
       # Model scopes.
       module ClassMethods
 
-        # Selects distinct records by uuids (relation scope).
+        # Selects records by uuid.
+        #
+        #     by_uuid(*values)
         #
         # @example
         #
@@ -26,8 +28,7 @@ module Uuids
         # Params:
         # <tt>*values</tt>:: a list of uuids to select records by.
         #
-        # Returns the <tt>ActiveRecord::Relation</tt> object.
-        #
+        # Returns an <tt>ActiveRecord::Relation</tt> scope.
         def by_uuid(*values)
           first_value = values.first
           list = first_value.is_a?(Array) ? first_value : values

data/lib/uuids/version.rb

@@ -1,5 +1,5 @@
 module Uuids
 
   # Current release.
-  VERSION = "1.4.1"
+  VERSION = "1.4.2"
 end

data/spec/bin/uuids_spec.rb

@@ -3,49 +3,41 @@ require "spec_helper_dev"
 
 describe "$ uuids", :sandbox do
 
-  let(:files_in_sandbox) { Dir["#{ sandbox }/**/*.*"] }
-
   describe "install" do
 
-    context "without options" do
+    let!(:root)       { File.expand_path("../../..", __FILE__) }
+    let!(:migrations) { Dir["#{ root }/db/migrate/*.rb"] }
 
-      let!(:dir) { "#{ sandbox }/db/migrate" }
-      before     { run_in_sandbox "uuids install" }
+    describe "without options" do
 
-      it "copies migrations to 'db/migrate'" do
-        migrations.each { |file| expect(dir).to have_migration_from file }
-      end
+      before { run_in_sandbox "uuids install" }
 
-      it "doesn't add other files" do
-        expect(files_in_sandbox.count).to eq migrations.count
+      it "copies migrations to `db/migrate`" do
+        migrations.each do |migration|
+          expect(migration).to have_copy_in_sandbox "db/migrate"
+        end
       end
     end
 
-    context "-d" do
-
-      let!(:dir) { "#{ sandbox }/spec/dummy/db/migrate" }
-      before     { run_in_sandbox "uuids install -d" }
+    describe "-d" do
 
-      it "copies migrations to 'spec/dummy/db/migrate'" do
-        migrations.each { |file| expect(dir).to have_migration_from file }
-      end
+      before { run_in_sandbox "uuids install -d" }
 
-      it "doesn't add other files" do
-        expect(files_in_sandbox.count).to eq migrations.count
+      it "copies migrations to `spec/dummy/db/migrate`" do
+        migrations.each do |migration|
+          expect(migration).to have_copy_in_sandbox "spec/dummy/db/migrate"
+        end
       end
     end
 
-    context "-f folder" do
-
-      let!(:dir) { "#{ sandbox }/folder/db/migrate" }
-      before     { run_in_sandbox "uuids install -f folder" }
+    describe "-f folder" do
 
-      it "copies migrations to 'some_path/db/migrate'" do
-        migrations.each { |file| expect(dir).to have_migration_from file }
-      end
+      before { run_in_sandbox "uuids install -f folder" }
 
-      it "doesn't add other files" do
-        expect(files_in_sandbox.count).to eq migrations.count
+      it "copies migrations to `folder/db/migrate`" do
+        migrations.each do |migration|
+          expect(migration).to have_copy_in_sandbox "folder/db/migrate"
+        end
       end
     end
   end

data/spec/spec_helper.rb

@@ -6,7 +6,7 @@ Coveralls.wear! "rails"
 require_relative "dummy/lib/dummy"
 
 # Loads support files for runtime tests.
-%w(runtime all).each do |env|
+%w(all runtime).each do |env|
   support = File.expand_path "../support/#{ env }/**/*.rb", __FILE__
   Dir[support].each { |f| require f }
 end

data/spec/spec_helper_dev.rb

@@ -6,7 +6,7 @@ require "coveralls"
 Coveralls.wear! "rails"
 
 # Loads generators.
-require_relative "../lib/generators"
+require "active_record_install"
 
 # Loads support files for development tests.
 %w(development all).each do |env|

data/spec/support/development/helpers/capture_stdout.rb

@@ -0,0 +1,15 @@
+# Captures stdout I/O.
+#
+# @example
+#     capture_stdout { do_something }
+#
+def capture_stdout
+  begin
+    $stdout = StringIO.new
+    yield
+    result = $stdout.string
+  ensure
+    $stdout = STDOUT
+  end
+  result
+end

data/spec/support/development/helpers/sandbox.rb

@@ -1,4 +1,4 @@
-require_relative "capture"
+require_relative "capture_stdout"
 
 # Path to the `tmp/sandbox`.
 def sandbox
@@ -18,7 +18,7 @@ end
 
 # Runs code from `sandbox`.
 def try_in_sandbox
-  FileUtils.cd(sandbox) { capture(:stdout) { yield } }
+  FileUtils.cd(sandbox) { capture_stdout { yield } }
 end
 
 # Runs cli from `sandbox`.

data/spec/support/development/matchers/migrations.rb

@@ -1,14 +1,15 @@
-# Checks if a directory has a migration from given source file.
-RSpec::Matchers.define :have_migration_from do |source|
-  match do |dir|
+require_relative "../helpers/sandbox"
+
+# Checks if a migration is properly copied to sandbox subfolder
+RSpec::Matchers.define :have_copy_in_sandbox do |folder|
+  match do |source|
 
-    # Search file that matches source with any timestamp.
     basename = File.basename(source, ".rb")[14..-1]
     sample   = "*#{ basename }.uuids.rb"
-    search   = File.join(dir, sample)
+    search   = File.join(sandbox, folder, sample)
     file     = Dir[search].first
 
-    # Check the file exists and has required content.
+    # Check whether file exists and has required content.
     expect(file).not_to be_nil
     expect(File.read file).to eq File.read source
   end

data/spec/support/runtime/factories/records.rb

@@ -1,3 +1,5 @@
+require_relative "../config/factory_girl"
+
 FactoryGirl.define do
   factory :record do
   end

data/spec/support/runtime/factories/uuids.rb

@@ -1,3 +1,5 @@
+require_relative "../config/factory_girl"
+
 FactoryGirl.define do
   factory :uuid, class: Uuids::Uuid do
     value  { SecureRandom.uuid }

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: uuids
 version: !ruby/object:Gem::Version
-  version: 1.4.1
+  version: 1.4.2
 platform: ruby
 authors:
 - Andrew Kozin
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-11-14 00:00:00.000000000 Z
+date: 2014-11-22 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activerecord
@@ -25,33 +25,33 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '4.1'
 - !ruby/object:Gem::Dependency
-  name: i18n
+  name: active_record_install
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.6'
-  type: :runtime
+        version: '0.4'
+  type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.6'
+        version: '0.4'
 - !ruby/object:Gem::Dependency
-  name: thor
+  name: coveralls
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.19'
+        version: '0.7'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.19'
+        version: '0.7'
 - !ruby/object:Gem::Dependency
   name: database_cleaner
   requirement: !ruby/object:Gem::Requirement
@@ -80,6 +80,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '4.4'
+- !ruby/object:Gem::Dependency
+  name: guard-rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.3'
 - !ruby/object:Gem::Dependency
   name: inch
   requirement: !ruby/object:Gem::Requirement
@@ -109,61 +123,61 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '4.11'
 - !ruby/object:Gem::Dependency
-  name: rspec
+  name: rake
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.1'
+        version: '10.3'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.1'
+        version: '10.3'
 - !ruby/object:Gem::Dependency
-  name: rubocop
+  name: rspec
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.26'
+        version: '3.1'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.26'
+        version: '3.1'
 - !ruby/object:Gem::Dependency
-  name: sqlite3
+  name: rubocop
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.3'
+        version: '0.26'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.3'
+        version: '0.26'
 - !ruby/object:Gem::Dependency
-  name: rake
+  name: sqlite3
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '10.3'
+        version: '1.3'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '10.3'
+        version: '1.3'
 - !ruby/object:Gem::Dependency
   name: timecop
   requirement: !ruby/object:Gem::Requirement
@@ -197,9 +211,6 @@ files:
 - config/locales/en.yml
 - config/locales/ru.yml
 - db/migrate/20141016112506_create_uuids_uuids.rb
-- lib/generators.rb
-- lib/generators/install.rb
-- lib/generators/install/copy_migration.rb
 - lib/uuids.rb
 - lib/uuids/base.rb
 - lib/uuids/base/has_uuids.rb
@@ -219,8 +230,6 @@ files:
 - spec/dummy/db/schema.rb
 - spec/dummy/db/test.sqlite3
 - spec/dummy/lib/dummy.rb
-- spec/lib/generators/install/copy_migration_spec.rb
-- spec/lib/generators/install_spec.rb
 - spec/lib/uuids/base_spec.rb
 - spec/spec_helper.rb
 - spec/spec_helper_dev.rb
@@ -230,7 +239,7 @@ files:
 - spec/support/all/config/rspec.rb
 - spec/support/development/config/sandbox.rb
 - spec/support/development/config/timecop.rb
-- spec/support/development/helpers/capture.rb
+- spec/support/development/helpers/capture_stdout.rb
 - spec/support/development/helpers/migrations.rb
 - spec/support/development/helpers/sandbox.rb
 - spec/support/development/matchers/migrations.rb
@@ -281,15 +290,13 @@ test_files:
 - spec/dummy/lib/dummy.rb
 - spec/dummy/Rakefile
 - spec/app/models/uuids/uuid_spec.rb
-- spec/lib/generators/install/copy_migration_spec.rb
-- spec/lib/generators/install_spec.rb
 - spec/lib/uuids/base_spec.rb
 - spec/bin/uuids_spec.rb
 - spec/support/development/config/timecop.rb
 - spec/support/development/config/sandbox.rb
 - spec/support/development/matchers/sandbox.rb
 - spec/support/development/matchers/migrations.rb
-- spec/support/development/helpers/capture.rb
+- spec/support/development/helpers/capture_stdout.rb
 - spec/support/development/helpers/sandbox.rb
 - spec/support/development/helpers/migrations.rb
 - spec/support/all/config/garbage_collection.rb

data/lib/generators.rb

@@ -1,10 +0,0 @@
-# Generators dependencies.
-require "thor"
-require "pathname"
-
-# `uuids` generators code.
-Dir[File.expand_path("../generators/**/*.rb", __FILE__)].each { |f| require f }
-
-# Namespace for generators.
-module Generators
-end

data/lib/generators/install.rb

@@ -1,92 +0,0 @@
-# encoding: utf-8
-
-module Generators
-
-  # An installer for the `uuids` gem.
-  # Copies module migration into an external project.
-  #
-  # @example
-  #     installer = Generators::Install.start [], { dummy: true }
-  #     # => creates `spec/dummy/db/migrage/{timestamp}_uuids_uuids.uuids.rb
-  #
-  # Options:
-  # <tt>dummy:</tt> (optional, boolean, default: false)
-  #     ... flag to copy migrations to a dummy app. If not set, the migration
-  #     will be added to the root `db/migrate` folder.
-  #
-  # Adds the "uuids" gem's migration to a module that uses the gem.
-  #
-  class Install < Thor::Group
-    include Thor::Actions
-
-    # Root for db migrations to be copied.
-    source_root File.expand_path "../../../db/migrate", __FILE__
-    namespace :install
-
-    class_option(
-      :dummy,
-      aliases: "-d",
-      default: false,
-      desc: "Copy migrations to dummy (`spec/dummy/db/migrate`) folder.",
-      required: false,
-      type: :boolean
-    )
-
-    class_option(
-      :folder,
-      aliases: "-f",
-      desc: "A folder to copy migrations to (`given_folder/db/migrate`).",
-      required: false,
-      type: :string
-    )
-
-    # Creates a folder for migrations.
-    def prepare_folder
-      empty_directory dir, skip: true
-    end
-
-    # Copies migrations to proper folder
-    def copy_migrations
-      copies.each do |copy|
-        copy_file copy.source, copy.target, copy.content unless copy.created?
-      end
-    end
-
-    private
-
-    def source_root
-      File.expand_path "../../../db/migrate", __FILE__
-    end
-
-    def dir
-      @dir ||= "#{ folder || dummy || "" }db/migrate/"
-    end
-
-    def folder
-      @folder ||= begin
-        folder = options["folder"]
-        folder ? "#{ folder }/" : nil
-      end
-    end
-
-    def dummy
-      @dummy ||= "spec/dummy/" if options["dummy"]
-    end
-
-    def sources
-      @sources ||= Dir[File.expand_path("*.rb", source_root)]
-    end
-
-    def copies
-      @copies ||= sources.map do |file|
-        CopyMigration.new(
-          gemname:     "uuids",
-          source_root: source_root,
-          source_file: file,
-          target_root: destination_root,
-          target_dir:  dir
-        )
-      end
-    end
-  end
-end

data/lib/generators/install/copy_migration.rb

@@ -1,104 +0,0 @@
-# encoding: utf-8
-require_relative "../install"
-
-module Generators
-  class Install
-
-    # Description for migration to copy.
-    #
-    # @example
-    #
-    #     copy = CopyMigration.new(
-    #       gemname:     "uuids",
-    #       source_root: "/",
-    #       source_file: "/db/migrate/20141016112506_create_uuids_uuids.rb",
-    #       target_root: "/items",
-    #       target_dir:  "db/migrate"
-    #     )
-    #
-    #     copy.source
-    #     # => "/db/migrate/20141016112506_create_uuids_uuids.rb"
-    #     copy.target
-    #     # => "/db/migrate/20150101000001_create_uuids_uuids.uuids.rb"
-    #     copy.content
-    #     # => returns uuids content.
-    #     copy.created?
-    #     # => returns true after the first copy created with any timestamp.
-    #
-    class CopyMigration
-
-      # Initialized parameters.
-      attr_reader(
-        :gemname, :source_root, :source_file, :target_root, :target_dir
-      )
-
-      # Instance initializer.
-      #
-      # @example
-      #     CopyMigration.new(params)
-      #
-      # Params:
-      # <tt>:gemname</tt>::     the name of the gem.
-      # <tt>:source_root</tt>:: the uuids db/migrate folder path.
-      # <tt>:source_file</tt>:: full path to migration file.
-      # <tt>:target_root</tt>:: path to root of application to create copy.
-      # <tt>:target_dir</tt>::  a folder in application root for migrations.
-      #
-      # All params are required.
-      #
-      def initialize(params)
-        @gemname     = params[:gemname]
-        @source_root = params[:source_root]
-        @source_file = params[:source_file]
-        @target_root = params[:target_root]
-        @target_dir  = params[:target_dir]
-      end
-
-      # Returns a source path to the migration.
-      def source
-        filepath.relative_path_from(rootpath).to_s
-      end
-
-      # Returns a target file name to copy the migration to.
-      def target
-        File.join(target_dir, "#{ timestamp }#{ suffix }")
-      end
-
-      # Returns the migration content.
-      def content
-        File.read filepath
-      end
-
-      # Checks if a copy already created.
-      def created?
-        search != []
-      end
-
-      private
-
-      def filepath
-        @filepath ||= Pathname.new(source_file)
-      end
-
-      def suffix
-        @suffix ||= "#{ basename }.#{ gemname }.rb"
-      end
-
-      def search
-        Dir[File.join(target_root, target_dir, "*#{ suffix }")]
-      end
-
-      def rootpath
-        Pathname.new(source_root)
-      end
-
-      def timestamp
-        @timestamp ||= Time.now.utc.strftime "%Y%m%d%H%M%S"
-      end
-
-      def basename
-        File.basename(source_file, ".rb")[14..-1]
-      end
-    end
-  end
-end

data/spec/lib/generators/install/copy_migration_spec.rb

@@ -1,66 +0,0 @@
-# encoding: utf-8
-require "spec_helper_dev"
-
-module Generators
-  class Install
-    describe CopyMigration, :sandbox do
-
-      let(:filename) { "20140101010101_create_items_items" }
-      let(:filepath) { "#{ sandbox }/#{ filename }.rb" }
-      let(:content)  { "some content" }
-      let(:params) do
-        {
-          gemname:     "uuids",
-          source_root: sandbox,
-          source_file: filepath,
-          target_root: sandbox,
-          target_dir:  "db/migrate"
-        }
-      end
-
-      before  { File.write filepath, content }
-      subject { CopyMigration.new params }
-
-      describe "#source" do
-
-        it "returns migrations source" do
-          expect(subject.source).to eq("#{ filename }.rb")
-        end
-      end
-
-      describe "#target" do
-
-        let(:regexp) do
-          Regexp.new "db/migrate/\\d{14}_create_items_items[.]uuids[.]rb"
-        end
-
-        it "returns the name of migration target" do
-          expect(subject.target).to match(regexp)
-        end
-      end
-
-      describe "#content" do
-
-        it "returns the migration content" do
-          expect(subject.content).to eq(content)
-        end
-      end
-
-      describe "#created?" do
-
-        let(:folder) { File.join sandbox, "db", "migrate" }
-        let(:copy)   { File.join(folder, "#{ filename }.uuids.rb") }
-
-        it "returns false before migration copy created" do
-          expect(subject).not_to be_created
-        end
-
-        it "returns true after migration copy created" do
-          FileUtils.mkdir_p folder
-          File.write copy, content
-          expect(subject).to be_created
-        end
-      end
-    end
-  end
-end

data/spec/lib/generators/install_spec.rb

@@ -1,73 +0,0 @@
-# encoding: utf-8
-require "spec_helper_dev"
-
-module Generators
-  describe Install, :sandbox do
-
-    describe "#invoke_all" do
-
-      def run_with_options(options = {})
-        try_in_sandbox do
-          subject = Install.new [], options
-          subject.invoke_all
-        end
-      end
-
-      let(:files_in_sandbox) { Dir["#{ sandbox }/**/*.*"] }
-
-      context "without options" do
-
-        let!(:dir) { "#{ sandbox }/db/migrate" }
-        before     { run_with_options }
-
-        it "copies migrations to 'db/migrate'" do
-          migrations.each { |file| expect(dir).to have_migration_from file }
-        end
-
-        it "doesn't add other files" do
-          expect(files_in_sandbox.count).to eq migrations.count
-        end
-      end
-
-      context "dummy: true" do
-
-        let!(:dir) { "#{ sandbox }/spec/dummy/db/migrate" }
-        before     { run_with_options dummy: true }
-
-        it "copies migrations to 'spec/dummy/db/migrate'" do
-          migrations.each { |file| expect(dir).to have_migration_from file }
-        end
-
-        it "doesn't add other files" do
-          expect(files_in_sandbox.count).to eq migrations.count
-        end
-      end
-
-      context "folder: 'folder'" do
-
-        let!(:dir) { "#{ sandbox }/folder/db/migrate" }
-        before     { run_with_options folder: "folder" }
-
-        it "copies migrations to 'some_path/db/migrate'" do
-          migrations.each { |file| expect(dir).to have_migration_from file }
-        end
-
-        it "doesn't add other files" do
-          expect(files_in_sandbox.count).to eq migrations.count
-        end
-      end
-
-      context "if a migration is already added" do
-
-        before do
-          run_with_options
-          Timecop.travel(Time.now + 10) { run_with_options }
-        end
-
-        it "doesn't copy it again" do
-          expect(files_in_sandbox.count).to eq migrations.count
-        end
-      end
-    end
-  end
-end

data/spec/support/development/helpers/capture.rb

@@ -1,16 +0,0 @@
-# Captures given stream.
-#
-# @example
-#     capture(:stdout) { do_something }
-#
-def capture(stream)
-  begin
-    stream = stream.to_s
-    eval "$#{stream} = StringIO.new"
-    yield
-    result = eval("$#{stream}").string
-  ensure
-    eval("$#{stream} = #{stream.upcase}")
-  end
-  result
-end