imprecations 0.0.1

data/.gitignore

@@ -0,0 +1,6 @@
+*.gem
+.bundle
+Gemfile.lock
+pkg/*
+*.sw[op]
+.rake_tasks

data/Gemfile

@@ -0,0 +1,4 @@
+source "http://rubygems.org"
+
+# Specify your gem's dependencies in imprecations.gemspec
+gemspec

data/README.md

@@ -0,0 +1,28 @@
+# Imprecations: Because that's what you'll be hurling at the screen
+
+Imprecations recursively deprecates every instance method on a class/module as
+well as all classes defined inside that class/module.
+
+## Installation
+
+    gem install imprecations
+
+## Usage
+
+    MyClass.imprecate
+    MyClass.my_method
+    #=> DEPRECATION WARNING: MyClass#my_method is deprecated!
+    #=> ...my_method does its thing...
+
+## Safety
+Worried about deprecating too many things? Just do this:
+
+    require 'imprecations/safe'
+
+And you're good to go!
+
+
+## Is it tested?
+Of course!
+
+Author/who to blame: Gabe Berke-Williams, 2011

data/Rakefile

@@ -0,0 +1,8 @@
+require 'bundler/gem_tasks'
+
+require 'rspec/core/rake_task'
+
+RSpec::Core::RakeTask.new(:spec)
+
+desc "Run specs"
+task :default => :spec

data/imprecations.gemspec

@@ -0,0 +1,21 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "imprecations/version"
+
+Gem::Specification.new do |s|
+  s.name        = "imprecations"
+  s.version     = Imprecations::VERSION
+  s.authors     = ["Gabe Berke-Williams"]
+  s.email       = ["gabe@thoughtbot.com"]
+  s.homepage    = "https://github.com/gabebw/imprecations/"
+  s.summary     = %q{Deprecate ALL THE THINGS!}
+  s.description = [%q{Imprecations recursively deprecates every instance method},
+                   %q{on a class/module as well as all classes defined inside that class/module.}].join(' ')
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+
+  s.add_development_dependency('rspec', '~> 2.6.0')
+end

data/lib/imprecations.rb

@@ -0,0 +1,55 @@
+require "imprecations/version"
+
+module Imprecations
+  def imprecate
+    if [Object, Module, Kernel].include?(self)
+      raise "Imprecate *#{self}*?! Sorry, even I'm not that evil."
+    end
+
+    __imprecate(self)
+    self.imprecate_child_constants
+  end
+
+  def imprecate_child_constants
+    real_constants  = self.constants.map{|c| self.const_get(c) }
+    class_constants = real_constants.select{|c| Class === c }
+    class_constants.each do |class_const|
+      class_const.imprecate
+    end
+  end
+
+  def __imprecate(constant)
+    unimprecated_instance_methods_for(constant).each do |meth|
+      namespaced_constant =
+        if self.superclass == Object
+          "#{constant}"
+        else
+          "#{self.superclass}::#{constant}"
+        end
+
+      constant.class_eval <<-EVIL
+        # Store a reference
+        alias :"__unimprecated_#{meth}" :"#{meth}"
+
+        # Undefine it so we can redefine it
+        undef_method(:"#{meth}")
+
+        def #{meth}
+          Imprecations.say("DEPRECATION WARNING: #{namespaced_constant}##{meth} is deprecated!")
+          __unimprecated_#{meth}()
+        end
+      EVIL
+    end
+  end
+
+  def unimprecated_instance_methods_for(constant)
+    methods = constant.instance_methods(false)
+    methods.reject{|meth| meth.to_s =~ /^__unimprecated/ }
+  end
+
+  def say(message)
+    puts message
+  end
+end
+
+include Imprecations

data/lib/imprecations/safe.rb

@@ -0,0 +1,4 @@
+# Mwa ha ha ha
+require 'imprecations'
+
+Module.imprecate_child_constants

data/lib/imprecations/version.rb

@@ -0,0 +1,3 @@
+module Imprecations
+  VERSION = "0.0.1"
+end

data/spec/imprecations_spec.rb

@@ -0,0 +1,70 @@
+require 'spec_helper'
+
+describe Imprecations, "#imprecate" do
+  before do
+    Object.send(:remove_const, :MyModule) if defined?(MyModule)
+    Object.send(:remove_const, :MyClass) if defined?(MyClass)
+
+    module MyModule; end
+
+    class MyClass
+      class MySubClass
+        def sub_one
+        end
+
+        class MyTripleSubClass
+          def triple_sub
+          end
+        end
+      end
+
+      def one; end
+      def two; end
+
+      def three
+        called_by_three
+      end
+
+      def called_by_three
+      end
+    end
+  end
+
+  it "is available on any Object" do
+    MyClass.should respond_to :imprecate
+    MyClass::MySubClass.should respond_to :imprecate
+    MyModule.should respond_to :imprecate
+  end
+
+  it "adds deprecation warnings for every instance method" do
+    Imprecations.should_receive(:say).with("DEPRECATION WARNING: MyClass#one is deprecated!")
+    Imprecations.should_receive(:say).with("DEPRECATION WARNING: MyClass#two is deprecated!")
+
+    MyClass.imprecate
+    instance = MyClass.new
+    instance.one
+    instance.two
+  end
+
+  it "recursively adds deprecation warnings for every instance method" do
+    Imprecations.should_receive(:say).with("DEPRECATION WARNING: MyClass::MySubClass::MyTripleSubClass#triple_sub is deprecated!")
+
+    MyClass.imprecate
+    MyClass::MySubClass::MyTripleSubClass.new.triple_sub
+  end
+
+  it "calls the original method" do
+    MyClass.any_instance.should_receive(:called_by_three)
+
+    MyClass.imprecate
+    MyClass.new.three
+  end
+
+  [Object, Module, Kernel].each do |important_class|
+    it "refuses to imprecate #{important_class}" do
+      lambda do
+        important_class.imprecate
+      end.should raise_error
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,4 @@
+require 'imprecations'
+require 'rspec/mocks'
+
+include RSpec::Mocks::Methods

metadata

@@ -0,0 +1,69 @@
+--- !ruby/object:Gem::Specification
+name: imprecations
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- Gabe Berke-Williams
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2011-09-08 00:00:00.000000000Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: &2153095880 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 2.6.0
+  type: :development
+  prerelease: false
+  version_requirements: *2153095880
+description: Imprecations recursively deprecates every instance method on a class/module
+  as well as all classes defined inside that class/module.
+email:
+- gabe@thoughtbot.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- Gemfile
+- README.md
+- Rakefile
+- imprecations.gemspec
+- lib/imprecations.rb
+- lib/imprecations/safe.rb
+- lib/imprecations/version.rb
+- spec/imprecations_spec.rb
+- spec/spec_helper.rb
+homepage: https://github.com/gabebw/imprecations/
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.9
+signing_key: 
+specification_version: 3
+summary: Deprecate ALL THE THINGS!
+test_files:
+- spec/imprecations_spec.rb
+- spec/spec_helper.rb