patch_life 0.0.1

data/LICENSE

@@ -0,0 +1,16 @@
+This software is free to use, modify, and distribute.
+
+You aren't allowed to sell it, under any condition, to anyone, at any time, for any reason.
+
+If you use this to write some evil shit, then fuck you.
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,33 @@
+#Patch Life
+
+Sometimes in Ruby, it's necessary to backport things like security fixes and stability patches to earlier versions, because upgrading a large-scale ecosystem in ruby can require many months of testing, bug fixes, partial rollouts, etc. Occasionally, you need a way to apply newer fixes to older Ruby runtimes.
+
+But, as often happens, large scale ecosystems tend to collect dust, and hide secrets. Todays quick thinking patch could be tomorrows unexpected production issue, because lets face it - you're going to forget you ever did this in 6 months.
+
+The first, uses a Warning, printed every time your application starts, when the patch is loaded. If your defined Ruby Version and Patch level are equal to or older than the version of Ruby you're running the application with, you'll receive a Warning.
+
+```ruby
+define_patch_life :version => '1.9.3', :patch=> 448, :message => "It's time to remove me, as you've upgraded to a version of ruby where this code is no longer needed"
+
+#Dirty hack that is considered a bold move
+```
+
+The second, allows you to pass the patch into define_patch_life as a block, only to be executed if the defined version / patch level of Ruby is not equal to or higher than the Ruby Version the application is running with.
+
+```ruby
+define_patch_life :version => '1.9.3', :patch=> 448 do
+  #World saving code
+end
+```
+
+You can also combine the two, and have the patch execute only if ruby is beneath it's defined version, and have the message emitted as a Warning as well
+
+```ruby
+define_patch_life :version => '1.9.3', :patch=> 448, :message => "It's time to remove me, as you've upgraded to a version of ruby where this code is no longer needed" do
+  #There will be much scorn and derision when this bites someone in the ass
+end
+```
+
+##Upcoming Features
+
+Ability to define arbitrary checks to apply patches with (not just based on ruby version)

data/lib/patch_life.rb

@@ -0,0 +1,28 @@
+module PatchLife
+  def define_patch_life(options={})
+    raise(ArgumentError, "print_patch_warning requires a :version argument to be set") unless options[:version]
+    raise(ArgumentError, "print_patch_warning requires a :patch argument to be set") unless options[:patch]
+    raise(ArgumentError, "print_patch_warning requires either a :message argument, a block to yield, or both") unless options[:message] || block_given?
+  
+    past_due = Gem::Version.new(ruby_version) >= Gem::Version.new(options[:version]) && ruby_patch_level >= options[:patch].to_i
+    Kernel.warn(options[:message]) if past_due && options[:message]
+    yield if !past_due && block_given?
+    #Don't want to return anything at all...
+    nil
+  end
+  module_function :define_patch_life
+
+  def ruby_version
+    RUBY_VERSION.dup
+  end
+  module_function :ruby_version
+
+  def ruby_patch_level
+    RUBY_PATCHLEVEL
+  end
+  module_function :ruby_patch_level
+end
+
+def patch_life(options={})
+  PatchLife.define_patch_life(options)
+end

data/lib/version.rb

@@ -0,0 +1,9 @@
+module PatchLife
+  module Version
+    MAJOR = 0
+    MINOR = 0
+    PATCH = 1
+
+    STRING = [ MAJOR, MINOR, PATCH ].join('.')
+  end
+end

data/patch_life.gemspec

@@ -0,0 +1,32 @@
+# -*- encoding: utf-8 -*-
+$: << File.expand_path('lib', File.dirname(__FILE__))
+
+require 'version'
+
+Gem::Specification.new do |s|
+  s.name = "patch_life"
+  s.version = PatchLife::Version::STRING
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Stabby Cutyou"]
+  s.date = Time.new.strftime("%Y-%m-%d")
+  s.description = "Allows you to define a patch to ruby in a block that only gets executed if you're below the version which obsoletes the patch."
+
+  s.files = Dir[*%w(
+    patch_life.gemspec
+    lib/**/*
+    spec/**/*
+    README.md
+    LICENSE
+  )]
+
+  s.homepage = "http://github.com/StabbyCutyou/patch_life"
+  s.licenses = ["Custom with a touch of MIT"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = "1.8.25"
+  s.summary = "Yells at you when you should have removed a particular patch by now"
+
+  s.add_development_dependency("rspec")
+  s.add_development_dependency("bundler")
+end
+

data/spec/print_patch_warning_spec.rb

@@ -0,0 +1,86 @@
+require 'spec_helper'
+
+describe PrintPatchWarning do
+  before(:each) do
+    #Don't wanna actually fire it...
+    Kernel.stub(:warn)
+  end
+
+  context "when being defined" do
+    let (:version) {"1.0.0"}
+    let (:patch) {1}
+    let (:message) {"You're outdated"}
+    it "requires a version to be delcared" do
+      expect {subject.print_patch_warning}.to raise_error(ArgumentError)
+    end
+
+    it "requires a patch level to be declared" do
+      expect {subject.print_patch_warning(:version=>version)}.to raise_error(ArgumentError)
+    end
+
+    it "requires a message when no block has been yielded" do
+      expect {subject.print_patch_warning(:version=>version, :patch=>patch, :message=>message)}.not_to raise_error
+    end
+
+    it "requires a block when no message was declared" do
+      expect {subject.print_patch_warning(:version=>version, :patch=>patch) {nil} }.not_to raise_error
+    end
+
+    it "allows both a message and a block at the same time" do
+      expect {subject.print_patch_warning(:version=>version, :patch=>patch, :message=>message) {nil} }.not_to raise_error
+    end
+  end
+
+  context "when comparing ruby versions" do
+    context "and the current ruby version is less than the declared version" do
+      let (:version) {"9.9.9"}
+      let (:patch) {999}
+      let (:message) {"You're outdated"}
+
+      it "will not print a message if defined" do
+        Kernel.should_not_receive(:warn).with(message)
+        subject.print_patch_warning(:version=>version, :patch=>patch, :message=>message) {nil}
+      end
+
+      it "will yield a block if given" do
+        block_called = false
+        subject.print_patch_warning(:version=>version, :patch=>patch, :message=>message) {block_called=true}
+        block_called.should == true
+      end
+    end
+
+    context "and the current ruby version is equal to the declared version" do
+      let (:version) {RUBY_VERSION.dup}
+      let (:patch) {RUBY_PATCHLEVEL}
+      let (:message) {"You're outdated"}
+      
+      it "will print a message if defined" do
+        Kernel.should_receive(:warn).with(message)
+        subject.print_patch_warning(:version=>version, :patch=>patch, :message=>message) {nil}
+      end
+
+      it "will not yield a block if given" do
+        block_called = false
+        subject.print_patch_warning(:version=>version, :patch=>patch, :message=>message) {block_called=true}
+        block_called.should == false
+      end
+    end
+
+    context "and the current ruby version is greater than the declared version" do
+      let (:version) {"1.0.0"}
+      let (:patch) {1}
+      let (:message) {"You're outdated"}
+
+      it "will print a message if defined" do
+        Kernel.should_receive(:warn).with(message)
+        subject.print_patch_warning(:version=>version, :patch=>patch, :message=>message) {nil}
+      end
+
+      it "will not yield a block if given" do
+        block_called = false
+        subject.print_patch_warning(:version=>version, :patch=>patch, :message=>message) {block_called=true}
+        block_called.should == false
+      end
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,2 @@
+require 'rspec'
+require 'print_patch_warning'

metadata

@@ -0,0 +1,86 @@
+--- !ruby/object:Gem::Specification
+name: patch_life
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- Stabby Cutyou
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-10-12 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Allows you to define a patch to ruby in a block that only gets executed
+  if you're below the version which obsoletes the patch.
+email: 
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- patch_life.gemspec
+- lib/patch_life.rb
+- lib/version.rb
+- spec/print_patch_warning_spec.rb
+- spec/spec_helper.rb
+- README.md
+- LICENSE
+homepage: http://github.com/StabbyCutyou/patch_life
+licenses:
+- Custom with a touch of MIT
+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.24
+signing_key: 
+specification_version: 3
+summary: Yells at you when you should have removed a particular patch by now
+test_files: []
+has_rdoc: