develry 0.0.2

data/lib/develry/site/initializer.rb

@@ -0,0 +1,73 @@
+# encoding: utf-8
+
+module Develry
+  class Site
+
+    # Supports initializing new projects with a Gemfile and Rakefile
+    class Initializer
+
+      def self.call(root)
+        new(root).call
+      end
+
+      attr_reader :site
+
+      attr_reader :root
+
+      attr_reader :config_dir
+
+      def initialize(site)
+        @site       = site
+        @root       = site.root
+        config_dir  = @root.join(DEFAULT_CONFIG_DIR_NAME).tap(&:mkpath)
+        @config_dir = config_dir.parent
+      end
+
+      # Init develry using default config
+      #
+      # @return [undefined]
+      #
+      # @api public
+      def call
+        FileUtils.cp_r(DEFAULT_CONFIG_PATH, config_dir)
+
+        site.sync
+        init_gemfile
+        init_rakefile
+
+        self
+      end
+
+      private
+
+      # Initialize the Gemfile
+      #
+      # @return [undefined]
+      #
+      # @api private
+      def init_gemfile
+        gemfile = root.join(DEFAULT_GEMFILE_NAME)
+        unless gemfile.file? && gemfile.read.include?(EVAL_GEMFILE)
+          gemfile.open('a') do |file|
+            file << ANNOTATION_WRAPPER % EVAL_GEMFILE
+          end
+        end
+      end
+
+      # Initialize the Rakefile
+      #
+      # @return [undefined]
+      #
+      # @api private
+      def init_rakefile
+        rakefile = root.join(RAKE_FILE_NAME)
+        unless rakefile.file? && rakefile.read.include?(INIT_RAKE_TASKS)
+          rakefile.open('a') do |file|
+            file << ANNOTATION_WRAPPER % [REQUIRE, INIT_RAKE_TASKS].join("\n")
+          end
+        end
+      end
+
+    end # class Initializer
+  end # class Site
+end # module Develry

data/lib/develry/spec_helper.rb

@@ -0,0 +1,5 @@
+# encoding: utf-8
+
+require 'develry'
+
+Develry.init_spec_helper

data/shared/Gemfile

@@ -0,0 +1,55 @@
+# encoding: utf-8
+
+group :development do
+  gem 'rake',  '~> 10.1.0'
+  gem 'rspec', '~> 2.14.1'
+  gem 'yard',  '~> 0.8.7'
+end
+
+group :yard do
+  gem 'kramdown', '~> 1.2.0'
+end
+
+group :guard do
+  gem 'guard',         '~> 1.8.1'
+  gem 'guard-bundler', '~> 1.0.0'
+  gem 'guard-rspec',   '~> 3.0.2'
+  gem 'guard-rubocop', '~> 0.2.0'
+  gem 'guard-mutant',  '~> 0.0.1'
+
+  # file system change event handling
+  gem 'listen',     '~> 1.3.0'
+  gem 'rb-fchange', '~> 0.0.6', require: false
+  gem 'rb-fsevent', '~> 0.9.3', require: false
+  gem 'rb-inotify', '~> 0.9.0', require: false
+
+  # notification handling
+  gem 'libnotify',               '~> 0.8.0', require: false
+  gem 'rb-notifu',               '~> 0.0.4', require: false
+  gem 'terminal-notifier-guard', '~> 1.5.3', require: false
+end
+
+group :metrics do
+  gem 'coveralls', '~> 0.6.7'
+  gem 'flay',      '~> 2.4.0'
+  gem 'flog',      '~> 4.1.1'
+  gem 'reek',      '~> 1.3.2'
+  gem 'rubocop',   '~> 0.13.0'
+  gem 'simplecov', '~> 0.7.1'
+  gem 'yardstick', '~> 0.9.7', git: 'https://github.com/dkubb/yardstick.git'
+
+  platforms :ruby_19, :ruby_20 do
+    gem 'mutant', git: 'https://github.com/mbj/mutant.git'
+    gem 'yard-spellcheck', '~> 0.1.5'
+  end
+end
+
+group :benchmarks do
+  gem 'rbench', '~> 0.2.3'
+end
+
+platform :jruby do
+  group :jruby do
+    gem 'jruby-openssl', '~> 0.8.5'
+  end
+end

data/shared/spec/shared/abstract_type_behavior.rb

@@ -0,0 +1,18 @@
+# encoding: utf-8
+
+shared_examples_for 'an abstract type' do
+  context 'called on a subclass' do
+    let(:object) { Class.new(described_class) }
+
+    it { should be_instance_of(object) }
+  end
+
+  context 'called on the class' do
+    let(:object) { described_class }
+
+    specify do
+      expect { subject }
+        .to raise_error(NotImplementedError, "#{object} is an abstract type")
+    end
+  end
+end

data/shared/spec/shared/command_method_behavior.rb

@@ -0,0 +1,7 @@
+# encoding: utf-8
+
+shared_examples_for 'a command method' do
+  it 'returns self' do
+    should equal(object)
+  end
+end

data/shared/spec/shared/each_method_behaviour.rb

@@ -0,0 +1,15 @@
+# encoding: utf-8
+
+shared_examples_for 'an #each method' do
+  it_should_behave_like 'a command method'
+
+  context 'with no block' do
+    subject { object.each }
+
+    it { should be_instance_of(to_enum.class) }
+
+    it 'yields the expected values' do
+      expect(subject.to_a).to eql(object.to_a)
+    end
+  end
+end

data/shared/spec/shared/hash_method_behavior.rb

@@ -0,0 +1,17 @@
+# encoding: utf-8
+
+shared_examples_for 'a hash method' do
+  it_should_behave_like 'an idempotent method'
+
+  specification = proc do
+    should be_instance_of(Fixnum)
+  end
+
+  it 'is a fixnum' do
+    instance_eval(&specification)
+  end
+
+  it 'memoizes the hash code' do
+    expect(subject).to eql(object.memoized(:hash))
+  end
+end

data/shared/spec/shared/idempotent_method_behavior.rb

@@ -0,0 +1,9 @@
+# encoding: utf-8
+
+shared_examples_for 'an idempotent method' do
+  it 'is idempotent' do
+    first = subject
+    __memoized.delete(:subject)
+    should equal(first)
+  end
+end

data/shared/spec/support/ice_nine_config.rb

@@ -0,0 +1,14 @@
+# encoding: utf-8
+
+if defined?(IceNine)
+  module IceNine
+
+    # Freezer namespace
+    class Freezer
+
+      # Rspec freezer
+      class RSpec < NoFreeze; end
+
+    end # Freezer
+  end # IceNine
+end

data/spec/spec_helper.rb

@@ -0,0 +1,33 @@
+# encoding: utf-8
+
+require 'develry/spec_helper'
+
+if ENV['COVERAGE'] == 'true'
+  require 'simplecov'
+  require 'coveralls'
+
+  SimpleCov.formatter = SimpleCov::Formatter::MultiFormatter[
+    SimpleCov::Formatter::HTMLFormatter,
+    Coveralls::SimpleCov::Formatter
+  ]
+
+  SimpleCov.start do
+    command_name     'spec:unit'
+    add_filter       'config'
+    add_filter       'spec'
+    minimum_coverage 100
+  end
+end
+
+require 'develry'
+
+# Require spec support files and shared behavior
+Dir[File.expand_path('../{support,shared}/**/*.rb', __FILE__)].each do |file|
+  require file.chomp('.rb')
+end
+
+RSpec.configure do |config|
+  config.expect_with :rspec do |expect_with|
+    expect_with.syntax = :expect
+  end
+end

data/tasks/metrics/ci.rake

@@ -0,0 +1,18 @@
+# encoding: utf-8
+
+desc 'Run all metrics and integration specs'
+task ci: %w[ ci:metrics metrics:mutant spec:integration ]
+
+namespace :ci do
+  tasks = %w[
+    metrics:coverage
+    metrics:yardstick:verify
+    metrics:rubocop
+    metrics:flog
+    metrics:flay
+    metrics:reek
+  ]
+
+  desc 'Run metrics (except mutant)'
+  task metrics: tasks
+end

data/tasks/metrics/coverage.rake

@@ -0,0 +1,13 @@
+# encoding: utf-8
+
+namespace :metrics do
+  desc 'Measure code coverage'
+  task :coverage do
+    begin
+      original, ENV['COVERAGE'] = ENV['COVERAGE'], 'true'
+      Rake::Task['spec:unit'].invoke
+    ensure
+      ENV['COVERAGE'] = original
+    end
+  end
+end

data/tasks/metrics/flay.rake

@@ -0,0 +1,66 @@
+# encoding: utf-8
+
+namespace :metrics do
+  begin
+    require 'flay'
+
+    project = Develry.project
+    config  = project.flay
+
+    compatible_scores = %w(mri-1.9.3 mri-2.0.0)
+
+    if ! compatible_scores.include?(Develry.rvm)
+      task :flay do
+        $stderr.puts "Flay is disabled under #{Develry.rvm}"
+      end
+    elsif config.enabled?
+      # Original code by Marty Andrews:
+      # http://blog.martyandrews.net/2009/05/enforcing-ruby-code-quality.html
+      desc 'Measure code duplication'
+      task :flay do
+        threshold   = config.threshold
+        total_score = config.total_score
+        files       = Flay.expand_dirs_to_files(project.lib_dir).sort
+
+        # Run flay first to ensure the max mass matches the threshold
+        flay = Flay.new(fuzzy: false, verbose: false, mass: 0)
+        flay.process(*files)
+        flay.analyze
+
+        masses = flay.masses.map do |hash, mass|
+          Rational(mass, flay.hashes[hash].size)
+        end
+
+        max = (masses.max || 0).to_i
+        unless max >= threshold
+          Develry.notify "Adjust flay threshold down to #{max}"
+        end
+
+        total = masses.sum.to_i
+        unless total == total_score
+          Develry.notify "Flay total is now #{total}, but expected #{total_score}"
+        end
+
+        # Run flay a second time with the threshold set
+        flay = Flay.new(fuzzy: false, verbose: false, mass: threshold.succ)
+        flay.process(*files)
+        flay.analyze
+
+        mass_size = flay.masses.size
+
+        if mass_size.nonzero?
+          flay.report
+          Develry.notify "#{mass_size} chunks have a duplicate mass > #{threshold}"
+        end
+      end
+    else
+      task :flay do
+        $stderr.puts 'Flay is disabled'
+      end
+    end
+  rescue LoadError
+    task :flay do
+      $stderr.puts 'In order to run flay, you must: gem install flay'
+    end
+  end
+end

data/tasks/metrics/flog.rake

@@ -0,0 +1,59 @@
+# encoding: utf-8
+
+namespace :metrics do
+  begin
+    require 'backports'
+    require 'flog'
+    require 'flog_cli'
+
+    project = Develry.project
+    config  = project.flog
+
+    compatible_scores = %w(mri-1.9.3)
+
+    if ! compatible_scores.include?(Develry.rvm)
+      task :flog do
+        $stderr.puts "Flog is disabled under #{Develry.rvm}"
+      end
+    elsif config.enabled?
+      # Original code by Marty Andrews:
+      # http://blog.martyandrews.net/2009/05/enforcing-ruby-code-quality.html
+      desc 'Measure code complexity'
+      task :flog do
+        threshold = config.threshold.to_f.round(1)
+        flog      = Flog.new
+        flog.flog(*FlogCLI.expand_dirs_to_files(project.lib_dir))
+
+        totals = flog.totals.select  { |name, score| name[-5, 5] != '#none' }
+                            .map     { |name, score| [name, score.round(1)] }
+                            .sort_by { |name, score| score }
+
+        if totals.any?
+          max = totals.last[1]
+          unless max >= threshold
+            Develry.notify "Adjust flog score down to #{max}"
+          end
+        end
+
+        bad_methods = totals.select { |name, score| score > threshold }
+        if bad_methods.any?
+          bad_methods.reverse_each do |name, score|
+            printf "%8.1f: %s\n", score, name
+          end
+
+          Develry.notify(
+            "#{bad_methods.size} methods have a flog complexity > #{threshold}"
+          )
+        end
+      end
+    else
+      task :flog do
+        $stderr.puts 'Flog is disabled'
+      end
+    end
+  rescue LoadError
+    task :flog do
+      $stderr.puts 'In order to run flog, you must: gem install flog'
+    end
+  end
+end

data/tasks/metrics/mutant.rake

@@ -0,0 +1,44 @@
+# encoding: utf-8
+
+namespace :metrics do
+  allowed_versions = %w(mri-1.9.3 mri-2.0.0 rbx-1.9.3)
+
+  enabled = begin
+    require 'mutant'
+  rescue LoadError
+    false
+  end
+
+  config    = Develry.project.mutant
+  enabled &&= config.enabled? && allowed_versions.include?(Develry.rvm)
+
+  zombify = %w(
+    adamantium equalizer ice_nine infecto anima concord abstract_type
+    descendants_tracker parser rspec unparser mutant
+  ).include?(config.name)
+
+  if enabled && !ENV['DEVTOOLS_SELF']
+    desc 'Measure mutation coverage'
+    task mutant: :coverage do
+      namespace =
+        if zombify
+          Mutant::Zombifier.zombify
+          Zombie::Mutant
+        else
+          Mutant
+        end
+
+      namespaces = Array(config.namespace).map { |n| "::#{n}*" }
+      status     = namespace::CLI.run(['--include', 'lib', '--require', config.name, *namespaces, config.strategy])
+
+      if status.nonzero?
+        Develry.notify 'Mutant task is not successful'
+      end
+    end
+  else
+    desc 'Measure mutation coverage'
+    task mutant: :coverage do
+      $stderr.puts 'Mutant is disabled'
+    end
+  end
+end