sugar_utils 0.2.0 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: c614940d4ed952e41a7b52798188e3a0ac39a983
-  data.tar.gz: f5ddaf4709df842179c3d85f1b4abdf67c39c636
+  metadata.gz: 4b841240e219afa9f5e780a7c3bd9ae389916c48
+  data.tar.gz: fbb71eb94aaac991e157b215d3eb38c4af935fe2
 SHA512:
-  metadata.gz: e09c44845626a114fbacc8a9a8ba82db43abf86d40951eaf4e880d1779469459407cc020c6861a278dbee23f2cbe1cae8f0bbcb64f137e97965b51dc913f3332
-  data.tar.gz: 64f9577e97eafbd53f4b9f8c2a8d8bdd114677bfbd2b73c45e9564bbc5245f9a665271f4bc32db4829094e74f9a12ffcc9b07033bf8f331c002ee2b566e10523
+  metadata.gz: fe6d9af436894005aed3882bc59387d5bb240a50780d32c1e0de9cc1443d8bbfac9ec146076a9a15d5d49d5abf80e736220f506de2ec30ed2db6a74a930fdf81
+  data.tar.gz: eaf877c2a627817cc6f89837c51a35c89641abb6346633c6c74759a94242001c6dcc9021d5aca0a984111791d0527a610949d985192a1979edbd239ffbca6b31

data/.rubocop.yml

@@ -1,2 +1,17 @@
 Documentation:
   Enabled: false
+
+Metrics/LineLength:
+  Max: 90
+
+Metrics/MethodLength:
+  Max: 20
+
+Metrics/AbcSize:
+  Max: 19
+
+# Because of the way that blocks are used in RSpecs can end up being long when
+# example groups are nested or many examples are checked.
+Metrics/BlockLength:
+  Exclude:
+    - 'spec/**/*'

data/.travis.yml

@@ -3,8 +3,15 @@ rvm:
   - 2.0
   - 2.1
   - 2.2
+  - 2.3.3
+  - 2.4.0
   - ruby-head
 matrix:
   allow_failures:
     - rvm: ruby-head
 sudo: false
+addons:
+  code_climate:
+    repo_token: c250bc1551dd13a07efdd5bc8a594924f6f762f7be9762e79da0c8f065cf93dd
+after_success:
+- bundle exec codeclimate-test-reporter

data/CHANGELOG.md

@@ -2,6 +2,17 @@
 All notable changes to this project will be documented in this file.
 This project adheres to [Semantic Versioning](http://semver.org/).
 
+## [0.3.0] - 2017-03-29
+### Added
+- SugarUtils::File.read, with locking and error handling when reading a plain
+  text file
+- SugarUtils::File.write, with locking and error handling when writing a plain
+  text file
+
+### Changed
+- explicitly specify the Ruby v2.0.0 support limit
+- divide SugarUtils::File.flock into .flock_shared and .flock_exclusive
+
 ## [0.2.0] - 2016-07-21
 ### Added
 - SugarUtils::File.flock, for file locking with a timeout

data/README.md

@@ -3,8 +3,8 @@
 [![Gem Version](https://badge.fury.io/rb/sugar_utils.svg)](http://badge.fury.io/rb/sugar_utils)
 [![Dependency Status](https://gemnasium.com/sugarcrm/sugar_utils.svg)](https://gemnasium.com/sugarcrm/sugar_utils)
 [![Build Status](https://travis-ci.org/sugarcrm/sugar_utils.svg?branch=master)](https://travis-ci.org/sugarcrm/sugar_utils)
-[![Coverage Status](http://img.shields.io/coveralls/sugarcrm/sugar_utils/master.svg)](https://coveralls.io/r/sugarcrm/sugar_utils)
 [![Code Climate](https://codeclimate.com/github/sugarcrm/sugar_utils/badges/gpa.svg)](https://codeclimate.com/github/sugarcrm/sugar_utils)
+[![Test Coverage](https://codeclimate.com/github/sugarcrm/sugar_utils/badges/coverage.svg)](https://codeclimate.com/github/sugarcrm/sugar_utils/coverage)
 [![Inline docs](http://inch-ci.org/github/sugarcrm/sugar_utils.svg)](http://inch-ci.org/github/sugarcrm/sugar_utils)
 [![License](http://img.shields.io/badge/license-Apache2-green.svg?style=flat)](LICENSE)
 
@@ -12,16 +12,20 @@ Utility methods extracted from SugarCRM Ruby projects.
 
 These methods are included:
 
-* ensure_boolean
-* ensure_integer
+* SugarUtils.ensure_boolean
+* SugarUtils.ensure_integer
+* SugarUtils::File.flock_shared
+* SugarUtils::File.flock_exclusive
+* SugarUtils::File.read
+* SugarUtils::File.write
+* SugarUtils::File.read_json
+* SugarUtils::File.write_json
 
 These methods will probably be included in the future:
 
 * sizeof_dir
 * find_files
 * find_file!
-* read_json
-* write_json
 * gzip
 * gunzip
 * tarball
@@ -30,7 +34,6 @@ These methods will probably be included in the future:
 * encrypt
 * http_get_file
 * timeout_retry
-* flock_with_timeout
 
 ## Installation
 
@@ -44,7 +47,7 @@ gem 'sugar_utils'
 And then execute:
 
 ```bash
-$ bundle
+$ bundle install
 ```
 
 Or install it yourself as:

data/Rakefile

@@ -1,4 +1,5 @@
 # -*- encoding: utf-8 -*-
+
 require 'bundler/gem_tasks'
 require 'rspec/core/rake_task'
 require 'rubocop/rake_task'
@@ -22,6 +23,6 @@ Yardstick::Rake::Measurement.new(:yardstick_measure) do |measurement|
   measurement.output = 'tmp/yard_coverage.txt'
 end
 
-task quality: [:rubocop, :yardstick_measure]
+task quality: %i(rubocop yardstick_measure)
 
 task default: [:spec]

data/lib/sugar_utils/file.rb

@@ -3,77 +3,101 @@
 require 'solid_assert'
 require 'fileutils'
 require 'multi_json'
+require 'timeout'
 
 module SugarUtils
   module File
     class Error < StandardError; end
 
-    # flock with a timeout to ensure that it does not flock forever.
+    # @param [File] file
+    # @param [Hash] options
+    # @option options [Integer] :timeout (10)
     #
-    # @see http://www.codegnome.com/blog/2013/05/26/locking-files-with-ruby/
+    # @raise [Timeout::Error]
     #
+    # @return [void]
+    def self.flock_shared(file, options = {})
+      timeout = options[:timeout] || 10
+      Timeout.timeout(timeout) { file.flock(::File::LOCK_SH) }
+    end
+
     # @param [File] file
-    # @param [File::LOCK_EX, File::LOCK_SH] locking_constant
     # @param [Hash] options
     # @option options [Integer] :timeout (10)
     #
+    # @raise [Timeout::Error]
+    #
     # @return [void]
-    def self.flock(file, locking_constant, options = {})
+    def self.flock_exclusive(file, options = {})
       timeout = options[:timeout] || 10
-      Timeout.timeout(timeout) { file.flock(locking_constant) }
+      Timeout.timeout(timeout) { file.flock(::File::LOCK_EX) }
     end
 
     # @param [String] filename
     # @param [Hash] options
     # @option options [Integer] :timeout (10)
     # @option options [Boolean] :raise_on_missing (true)
+    # @option options [String] :value_on_missing ('') which specifies the
+    #   value to return if the file is missing and raise_on_missing is false
     #
-    # @raise [SugarUtils::File::Error)
+    # @raise [SugarUtils::File::Error]
     #
-    # @return [Object]
-    def self.read_json(filename, options = {})
-      assert(options.is_a?(Hash), 'options MUST be a Hash')
-
+    # @return [String]
+    def self.read(filename, options = {})
+      options[:value_on_missing] ||= ''
       options[:raise_on_missing] = true if options[:raise_on_missing].nil?
 
       ::File.open(filename, ::File::RDONLY) do |file|
-        flock(file, ::File::LOCK_SH, options)
-        MultiJson.load(file.read)
+        flock_shared(file, options)
+        file.read
       end
     rescue SystemCallError, IOError
       raise(Error, "Cannot read #{filename}") if options[:raise_on_missing]
-      {}
-    rescue MultiJson::ParseError
-      raise(Error, "Cannot parse #{filename}")
+      options[:value_on_missing]
     rescue Timeout::Error
       raise(Error, "Cannot read #{filename} because it is locked")
     end
 
     # @param [String] filename
-    # @param [#to_json]  data
+    # @param [Hash] options
+    # @option options [Integer] :timeout (10)
+    # @option options [Boolean] :raise_on_missing (true)
+    #
+    # @raise [SugarUtils::File::Error]
+    #
+    # @return [Object]
+    def self.read_json(filename, options = {})
+      options[:value_on_missing] = {}
+      MultiJson.load(read(filename, options))
+    rescue MultiJson::ParseError
+      raise(Error, "Cannot parse #{filename}")
+    end
+
+    # @param [String] filename
+    # @param [#to_s] data
     # @param [Hash] options
     # @option options [Integer] :timeout (10)
     # @option options [Boolean] :flush (false)
     # @option options [Integer] :perm (0666)
     #
-    # @raise [SugarUtils::File::Error)
+    # @raise [SugarUtils::File::Error]
     #
     # @return [void]
-    def self.write_json(filename, data, options = {})
-      perm  = options[:perm] || 0666
+    def self.write(filename, data, options = {})
+      perm  = options[:perm] || 0o666
       flush = options[:flush] || false
 
       FileUtils.mkdir_p(::File.dirname(filename))
       ::File.open(filename, ::File::RDWR | ::File::CREAT, perm) do |file|
-        flock(file, ::File::LOCK_EX, options)
+        flock_exclusive(file, options)
 
         file.truncate(0) # Ensure file is empty before proceeding.
-        file.puts(MultiJson.dump(data, pretty: true))
+        file.puts(data.to_s)
 
         # Flush and fsync to be 100% sure we write this data out now because we
         # are often reading it immediately and if the OS is buffering, it is
-        # possible we might read it before it is been physically written to disk.
-        # We are not worried about speed here, so this should be OKAY.
+        # possible we might read it before it is been physically written to
+        # disk. We are not worried about speed here, so this should be OKAY.
         if flush
           file.flush
           file.fsync
@@ -87,5 +111,19 @@ module SugarUtils
     rescue SystemCallError, IOError => boom
       raise(Error, "Unable to write #{filename} with #{boom}")
     end
+
+    # @param [String] filename
+    # @param [#to_json] data
+    # @param [Hash] options
+    # @option options [Integer] :timeout (10)
+    # @option options [Boolean] :flush (false)
+    # @option options [Integer] :perm (0666)
+    #
+    # @raise [SugarUtils::File::Error]
+    #
+    # @return [void]
+    def self.write_json(filename, data, options = {})
+      write(filename, MultiJson.dump(data, pretty: true), options)
+    end
   end
 end

data/lib/sugar_utils/version.rb

@@ -1,5 +1,5 @@
 # -*- encoding : utf-8 -*-
 
 module SugarUtils
-  VERSION = '0.2.0'.freeze
+  VERSION = '0.3.0'.freeze
 end

data/spec/spec_helper.rb

@@ -2,13 +2,54 @@
 
 $LOAD_PATH.unshift File.expand_path('../../lib', __FILE__)
 require 'sugar_utils'
-require 'simplecov'
 require 'rspec/tabular'
 require 'fakefs/spec_helpers'
-SimpleCov.start 'rails'
+# HACK: including pp seems to resolve an error with FakeFS and File.read
+# This seems to be related to but not the same as the problem mentioned in the
+# README
+# https://github.com/fakefs/fakefs#fakefs-vs-pp-----typeerror-superclass-mismatch-for-class-file
+require 'pp'
+
+# Setup code coverage
+require 'simplecov'
+SimpleCov.start
 
 SolidAssert.enable_assertions
 
 RSpec.configure do |config|
+  # rubocop:disable Style/MixinGrouping
   config.include FakeFS::SpecHelpers, fakefs: true
+  # rubocop:enable all
+end
+
+RSpec::Matchers.define :have_json_content do |expected|
+  match do |actual|
+    next false unless File.exist?(actual)
+
+    @actual = MultiJson.load(File.read(actual))
+    values_match?(expected, @actual)
+  end
+
+  diffable
+end
+
+RSpec::Matchers.define :have_content do |expected|
+  match do |actual|
+    next false unless File.exist?(actual)
+
+    @actual = File.open(actual, 'r') { |f| f.read.chomp }
+    values_match?(expected, @actual)
+  end
+
+  diffable
+end
+
+RSpec::Matchers.define :have_file_permission do |expected|
+  match do |actual|
+    next false unless File.exist?(actual)
+
+    @actual   = format('%o', File.stat(filename).mode)
+    @expected = format('%o', expected)
+    values_match?(@expected, @actual)
+  end
 end

data/spec/sugar_utils/file_spec.rb

@@ -1,15 +1,14 @@
 # -*- encoding : utf-8 -*-
 
 require 'spec_helper'
-require 'fileutils'
 
 describe SugarUtils::File do
-  describe '.flock' do
-    subject { described_class.flock(file, :locking_constant, options) }
+  describe '.flock_shared' do
+    subject { described_class.flock_shared(file, options) }
     let(:file) { instance_double(File) }
     before do
-      expect(Timeout).to receive(:timeout).with(expected_timeout).and_yield
-      expect(file).to receive(:flock).with(:locking_constant)
+      allow(Timeout).to receive(:timeout).with(expected_timeout).and_yield
+      expect(file).to receive(:flock).with(::File::LOCK_SH)
     end
 
     inputs            :options,           :expected_timeout
@@ -18,59 +17,90 @@ describe SugarUtils::File do
     side_effects_with Hash[timeout: 5],   5
   end
 
-  describe '.read_json', :fakefs do
-    subject { described_class.read_json('filename.json', options) }
+  describe '.flock_exclusive' do
+    subject { described_class.flock_exclusive(file, options) }
+    let(:file) { instance_double(File) }
+    before do
+      allow(Timeout).to receive(:timeout).with(expected_timeout).and_yield
+      expect(file).to receive(:flock).with(::File::LOCK_EX)
+    end
 
-    context 'missing file' do
+    inputs            :options,           :expected_timeout
+    side_effects_with Hash[],             10
+    side_effects_with Hash[timeout: nil], 10
+    side_effects_with Hash[timeout: 5],   5
+  end
+
+  describe '.read', :fakefs do
+    subject { described_class.read('filename', options) }
+
+    shared_examples_for 'handles the missing file error' do
+      # rubocop:disable Metrics/LineLength
       inputs           :options
-      raise_error_with Hash[],                        described_class::Error
-      raise_error_with Hash[],                        'Cannot read filename.json'
-      raise_error_with Hash[raise_on_missing: true],  described_class::Error
-      raise_error_with Hash[raise_on_missing: true],  'Cannot read filename.json'
-      it_with          Hash[raise_on_missing: false], {}
+      raise_error_with Hash[],                                                described_class::Error
+      raise_error_with Hash[],                                                'Cannot read filename'
+      raise_error_with Hash[raise_on_missing: true],                          described_class::Error
+      raise_error_with Hash[raise_on_missing: true],                          'Cannot read filename'
+      it_with          Hash[raise_on_missing: false],                         ''
+      it_with          Hash[raise_on_missing: false, value_on_missing: 'hi'], 'hi'
+      # rubocop:enable all
     end
 
-    context 'file present' do
-      let(:options) { {} }
-      before { write('filename.json', content) }
-
-      context 'SysteCallError' do
-        let(:options) { {} }
-        let(:content) { '' }
-        let(:exception) { SystemCallError.new(nil) }
-        before { allow(File).to receive(:open).and_raise(exception) }
-        it { expect_raise_error('Cannot read filename.json') }
-      end
+    context 'missing file' do
+      it_behaves_like 'handles the missing file error'
+    end
 
-      context 'IOError' do
-        let(:options) { {} }
-        let(:content) { '' }
-        let(:exception) { IOError.new(nil) }
-        before { allow(File).to receive(:open).and_raise(exception) }
-        it { expect_raise_error('Cannot read filename.json') }
-      end
+    context 'with IOError' do
+      before { allow(File).to receive(:open).and_raise(IOError) }
+      it_behaves_like 'handles the missing file error'
+    end
+
+    context 'file present' do
+      let(:options) { { key: :value } }
+      before { write('filename', 'content') }
 
       context 'and locked' do
-        let(:content) { '' }
-        before { expect_flock(File::LOCK_SH, options).and_raise(Timeout::Error) }
-        it { expect_raise_error('Cannot read filename.json because it is locked') }
+        before do
+          expect(described_class).to receive(:flock_shared)
+            .with(kind_of(File), options)
+            .and_raise(Timeout::Error)
+        end
+        it { expect_raise_error('Cannot read filename because it is locked') }
       end
 
       context 'and unlocked' do
-        before { expect_flock(File::LOCK_SH, options) }
-
-        inputs           :content
-        raise_error_with 'I am not json',                described_class::Error
-        raise_error_with 'I am not json',                'Cannot parse filename.json'
-        it_with          Hash['key' => 'value'].to_json, Hash['key' => 'value']
+        before do
+          expect(described_class).to receive(:flock_shared)
+            .with(kind_of(File), options)
+        end
+        it { is_expected.to eq('content') }
       end
     end
   end
 
-  describe '.write_json', :fakefs do
-    subject { described_class.write_json(filename, data, options) }
-    let(:data)     { { 'key' => 'value' } }
-    let(:filename) { 'dir1/dir2/filename.json' }
+  describe '.read_json', :fakefs do
+    subject do
+      described_class.read_json(
+        :filename, key: :value, value_on_missing: :foobar
+      )
+    end
+
+    before do
+      allow(described_class).to receive(:read)
+        .with(:filename, key: :value, value_on_missing: {})
+        .and_return(file_content)
+    end
+
+    inputs           :file_content
+    raise_error_with 'I am not json',                described_class::Error
+    raise_error_with 'I am not json',                'Cannot parse filename'
+    it_with          Hash['key' => 'value'].to_json, Hash['key' => 'value']
+  end
+
+  describe '.write', :fakefs do
+    subject { described_class.write(filename, data, options) }
+    let(:data)      { 'content' }
+    let(:filename)  { 'dir1/dir2/filename' }
 
     context 'SystemCallError' do
       let(:options) { {} }
@@ -88,36 +118,37 @@ describe SugarUtils::File do
 
     context 'locked' do
       let(:options) { {} }
-      before { expect_flock(File::LOCK_EX, options).and_raise(Timeout::Error) }
+      before do
+        expect(described_class).to receive(:flock_exclusive)
+          .with(kind_of(File), options)
+          .and_raise(Timeout::Error)
+      end
       it { expect_raise_error("Unable to write #{filename} because it is locked") }
     end
 
     context 'unlocked' do
       shared_examples_for 'file is written' do
-        before { expect_flock(File::LOCK_EX, options) }
+        before do
+          expect(described_class).to receive(:flock_exclusive)
+            .with(kind_of(File), options)
+        end
 
         context 'default options' do
           let(:options) { {} }
           before { subject }
-          specify do
-            expect(File.exist?(filename)).to eq(true)
-            expect(MultiJson.load(File.read(filename))).to eq(data)
-            expect(sprintf('%o', File.stat(filename).mode)).to eq('100666')
-          end
+          specify { expect(filename).to have_content(data) }
+          specify { expect(filename).to have_file_permission(0o100666) }
         end
 
         context 'options' do
-          let(:options) { { flush: true, perm: 0600 } }
+          let(:options) { { flush: true, perm: 0o600 } }
           before do
             expect_any_instance_of(File).to receive(:flush)
             expect_any_instance_of(File).to receive(:fsync)
             subject
           end
-          specify do
-            expect(File.exist?(filename)).to eq(true)
-            expect(MultiJson.load(File.read(filename))).to eq(data)
-            expect(sprintf('%o', File.stat(filename).mode)).to eq('100600')
-          end
+          specify { expect(filename).to have_content(data) }
+          specify { expect(filename).to have_file_permission(0o100600) }
         end
       end
 
@@ -126,7 +157,7 @@ describe SugarUtils::File do
       end
 
       context 'and exists' do
-        before { write(filename, 'foobar', 0777) }
+        before { write(filename, 'foobar', 0o777) }
         context 'not locked' do
           it_behaves_like 'file is written'
         end
@@ -134,15 +165,21 @@ describe SugarUtils::File do
     end
   end
 
-  ##############################################################################
+  describe '.write_json', :fakefs do
+    subject { described_class.write_json(:filename, data, :options) }
 
-  # @param [File::LOCK_SH, File::LOCK_EX] locking_constant
-  # @param [Hash] options
-  def expect_flock(locking_constant, options)
-    expect(described_class).to receive(:flock)
-      .with(kind_of(File), locking_constant, options)
+    let(:data) { { 'key' => 'value' } }
+    before do
+      expect(described_class).to receive(:write).with(
+        :filename, MultiJson.dump(data, pretty: true), :options
+      )
+    end
+
+    specify { subject }
   end
 
+  ##############################################################################
+
   # @param [String] message
   def expect_raise_error(message)
     expect { subject }.to raise_error(described_class::Error, message)
@@ -163,6 +200,4 @@ describe SugarUtils::File do
     File.write(filename, content)
     FileUtils.chmod(perm, filename) if perm
   end
-
-
 end

data/sugar_utils.gemspec

@@ -1,4 +1,5 @@
 # coding: utf-8
+
 lib = File.expand_path('../lib', __FILE__)
 $LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
 require 'sugar_utils/version'
@@ -17,16 +18,19 @@ Gem::Specification.new do |spec|
   spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
   spec.require_paths = ['lib']
 
+  spec.required_ruby_version = '>= 2.0.0'
+
   spec.add_dependency 'multi_json',   '~> 1.12.1'
   spec.add_dependency 'solid_assert', '~> 1.0'
 
   spec.add_development_dependency 'bundler',       '~> 1.7'
-  spec.add_development_dependency 'rake',          '~> 10.0'
-  spec.add_development_dependency 'rspec',         '~> 3.4.0'
+  spec.add_development_dependency 'rake',          '~> 12.0'
+  spec.add_development_dependency 'rspec',         '~> 3.5.0'
   spec.add_development_dependency 'rspec-tabular', '~> 0.1.0'
-  spec.add_development_dependency 'simplecov',     '~> 0.11.0'
-  spec.add_development_dependency 'rubocop',       '~> 0.37'
-  spec.add_development_dependency 'yard',          '~> 0.8.7.6'
+  spec.add_development_dependency 'simplecov',     '~> 0.14.0'
+  spec.add_development_dependency 'yard',          '~> 0.9.0'
   spec.add_development_dependency 'yardstick',     '~> 0.9.9'
   spec.add_development_dependency 'fakefs',        '~> 0.7'
+  spec.add_development_dependency 'codeclimate-test-reporter'
+  spec.add_development_dependency 'rubocop'
 end

metadata

@@ -1,169 +1,183 @@
 --- !ruby/object:Gem::Specification
 name: sugar_utils
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.3.0
 platform: ruby
 authors:
 - Andrew Sullivan Cant
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2016-07-21 00:00:00.000000000 Z
+date: 2017-03-29 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: multi_json
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: 1.12.1
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: 1.12.1
 - !ruby/object:Gem::Dependency
   name: solid_assert
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '1.0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '1.0'
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '1.7'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '1.7'
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '10.0'
+        version: '12.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '10.0'
+        version: '12.0'
 - !ruby/object:Gem::Dependency
   name: rspec
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: 3.4.0
+        version: 3.5.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: 3.4.0
+        version: 3.5.0
 - !ruby/object:Gem::Dependency
   name: rspec-tabular
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: 0.1.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: 0.1.0
 - !ruby/object:Gem::Dependency
   name: simplecov
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.11.0
+        version: 0.14.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.11.0
+        version: 0.14.0
 - !ruby/object:Gem::Dependency
-  name: rubocop
+  name: yard
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.37'
+        version: 0.9.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.37'
+        version: 0.9.0
 - !ruby/object:Gem::Dependency
-  name: yard
+  name: yardstick
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.8.7.6
+        version: 0.9.9
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.8.7.6
+        version: 0.9.9
 - !ruby/object:Gem::Dependency
-  name: yardstick
+  name: fakefs
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.9.9
+        version: '0.7'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.9.9
+        version: '0.7'
 - !ruby/object:Gem::Dependency
-  name: fakefs
+  name: codeclimate-test-reporter
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '0.7'
+        version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '0.7'
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 description: 
 email:
 - acant@sugarcrm.com
@@ -171,10 +185,10 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
-- .gitignore
-- .rspec
-- .rubocop.yml
-- .travis.yml
+- ".gitignore"
+- ".rspec"
+- ".rubocop.yml"
+- ".travis.yml"
 - CHANGELOG.md
 - CONTRIBUTING.md
 - CONTRIBUTOR_TERMS.md
@@ -199,17 +213,17 @@ require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
-  - - '>='
+  - - ">="
     - !ruby/object:Gem::Version
-      version: '0'
+      version: 2.0.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
-  - - '>='
+  - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.0.14.1
+rubygems_version: 2.6.10
 signing_key: 
 specification_version: 4
 summary: Utility methods extracted from SugarCRM Ruby projects.
@@ -217,4 +231,3 @@ test_files:
 - spec/spec_helper.rb
 - spec/sugar_utils/file_spec.rb
 - spec/sugar_utils_spec.rb
-has_rdoc: