develry 0.0.2

data/default/config/flay.yml

@@ -0,0 +1,3 @@
+---
+threshold: 0
+total_score: 0

data/default/config/flog.yml

@@ -0,0 +1,2 @@
+---
+threshold: 0

data/default/config/mutant.yml

@@ -0,0 +1,3 @@
+---
+name: your_lib
+namespace: YourLib

data/default/config/reek.yml

@@ -0,0 +1,103 @@
+---
+Attribute:
+  enabled: true
+  exclude: []
+BooleanParameter:
+  enabled: true
+  exclude: []
+ClassVariable:
+  enabled: true
+  exclude: []
+ControlParameter:
+  enabled: true
+  exclude: []
+DataClump:
+  enabled: true
+  exclude: []
+  max_copies: 2
+  min_clump_size: 2
+DuplicateMethodCall:
+  enabled: true
+  exclude: []
+  max_calls: 1
+  allow_calls: []
+FeatureEnvy:
+  enabled: true
+  exclude: []
+IrresponsibleModule:
+  enabled: true
+  exclude: []
+LongParameterList:
+  enabled: true
+  exclude: []
+  max_params: 2
+  overrides:
+    initialize:
+      max_params: 3
+LongYieldList:
+  enabled: true
+  exclude: []
+  max_params: 2
+NestedIterators:
+  enabled: true
+  exclude: []
+  max_allowed_nesting: 1
+  ignore_iterators: []
+NilCheck:
+  enabled: true
+  exclude: []
+RepeatedConditional:
+  enabled: true
+  exclude: []
+  max_ifs: 1
+TooManyInstanceVariables:
+  enabled: true
+  exclude: []
+  max_instance_variables: 3
+TooManyMethods:
+  enabled: true
+  exclude: []
+  max_methods: 10
+TooManyStatements:
+  enabled: true
+  exclude:
+  - each
+  max_statements: 2
+UncommunicativeMethodName:
+  enabled: true
+  exclude: []
+  reject:
+  - !ruby/regexp /^[a-z]$/
+  - !ruby/regexp /[0-9]$/
+  - !ruby/regexp /[A-Z]/
+  accept: []
+UncommunicativeModuleName:
+  enabled: true
+  exclude: []
+  reject:
+  - !ruby/regexp /^.$/
+  - !ruby/regexp /[0-9]$/
+  accept: []
+UncommunicativeParameterName:
+  enabled: true
+  exclude: []
+  reject:
+  - !ruby/regexp /^.$/
+  - !ruby/regexp /[0-9]$/
+  - !ruby/regexp /[A-Z]/
+  accept: []
+UncommunicativeVariableName:
+  enabled: true
+  exclude: []
+  reject:
+  - !ruby/regexp /^.$/
+  - !ruby/regexp /[0-9]$/
+  - !ruby/regexp /[A-Z]/
+  accept: []
+UnusedParameters:
+  enabled: true
+  exclude: []
+UtilityFunction:
+  enabled: true
+  exclude: []
+  max_helper_calls: 0

data/default/config/rubocop.yml

@@ -0,0 +1,58 @@
+AllCops:
+  Includes:
+    - '**/*.rake'
+    - 'Gemfile'
+    - 'Gemfile.develry'
+  Excludes:
+    - '**/vendor/**'
+    - '**/benchmarks/**'
+
+# Avoid parameter lists longer than five parameters.
+ParameterLists:
+  Max: 3
+  CountKeywordArgs: true
+
+# Avoid more than `Max` levels of nesting.
+BlockNesting:
+  Max: 3
+
+# Align with the style guide.
+CollectionMethods:
+  PreferredMethods:
+    collect:  'map'
+    inject:   'reduce'
+    find:     'detect'
+    find_all: 'select'
+
+# Do not force public/protected/private keyword to be indented at the same
+# level as the def keyword. My personal preference is to outdent these keywords
+# because I think when scanning code it makes it easier to identify the
+# sections of code and visually separate them. When the keyword is at the same
+# level I think it sort of blends in with the def keywords and makes it harder
+# to scan the code and see where the sections are.
+AccessControl:
+  Enabled: false
+
+# Limit line length
+LineLength:
+  Max: 79
+
+# Disable documentation checking until a class needs to be documented once
+Documentation:
+  Enabled: false
+
+# Do not favor modifier if/unless usage when you have a single-line body
+IfUnlessModifier:
+  Enabled: false
+
+# Allow case equality operator (in limited use within the specs)
+CaseEquality:
+  Enabled: false
+
+# Constants do not always have to use SCREAMING_SNAKE_CASE
+ConstantName:
+  Enabled: false
+
+# Not all trivial readers/writers can be defined with attr_* methods
+TrivialAccessors:
+  Enabled: false

data/default/config/yardstick.yml

@@ -0,0 +1,2 @@
+---
+threshold: 100

data/develry.gemspec

@@ -0,0 +1,53 @@
+# encoding: utf-8
+
+Gem::Specification.new do |gem|
+  gem.name        = 'develry'
+  gem.version     = '0.0.2'
+  gem.authors     = [ 'Markus Schirp' ]
+  gem.email       = [ 'mbj@schirp-dso.com' ]
+  gem.description = 'A metagem for ROM-style development'
+  gem.summary     = gem.description
+  gem.homepage    = 'https://github.com/rom-rb/develry'
+  gem.license     = 'MIT'
+
+  gem.require_paths    = %w[lib]
+  gem.files            = `git ls-files`.split($/)
+  gem.executables      = %w[develry]
+  gem.test_files       = `git ls-files -- spec`.split($/)
+  gem.extra_rdoc_files = %w[README.md TODO]
+
+  gem.add_dependency 'rake',  '~> 10.1.0'
+  gem.add_dependency 'rspec', '~> 2.14.1'
+  gem.add_dependency 'yard',  '~> 0.8.7'
+  gem.add_dependency 'kramdown', '~> 1.2.0'
+
+  # guard
+  gem.add_dependency 'guard',         '~> 1.8.1'
+  gem.add_dependency 'guard-bundler', '~> 1.0.0'
+  gem.add_dependency 'guard-rspec',   '~> 3.0.2'
+  gem.add_dependency 'guard-rubocop', '~> 0.2.0'
+  gem.add_dependency 'guard-mutant',  '~> 0.0.1'
+
+  # file system change event handling
+  gem.add_dependency 'listen',     '~> 1.3.0'
+  gem.add_dependency 'rb-fchange', '~> 0.0.6'
+  gem.add_dependency 'rb-fsevent', '~> 0.9.3'
+  gem.add_dependency 'rb-inotify', '~> 0.9.0'
+
+  # notification handling
+  gem.add_dependency 'libnotify',               '~> 0.8.0'
+  gem.add_dependency 'rb-notifu',               '~> 0.0.4'
+  gem.add_dependency 'terminal-notifier-guard', '~> 1.5.3'
+
+  # metrics
+  gem.add_dependency 'coveralls', '~> 0.6.7'
+  gem.add_dependency 'flay',      '~> 2.4.0'
+  gem.add_dependency 'flog',      '~> 4.1.1'
+  gem.add_dependency 'reek',      '~> 1.3.2'
+  gem.add_dependency 'rubocop',   '~> 0.13.0'
+  gem.add_dependency 'simplecov', '~> 0.7.1'
+  gem.add_dependency 'yardstick', '~> 0.9.7'
+
+  gem.add_dependency 'mutant',          '~> 0.3.0.rc3'
+  gem.add_dependency 'yard-spellcheck', '~> 0.1.5'
+end

data/lib/develry.rb

@@ -0,0 +1,164 @@
+# encoding: utf-8
+
+require 'pathname'
+require 'rake'
+require 'timeout'
+require 'yaml'
+require 'fileutils'
+
+require 'develry/platform'
+require 'develry/site'
+require 'develry/site/initializer'
+require 'develry/project'
+require 'develry/config'
+require 'develry/project/initializer'
+require 'develry/project/initializer/rake'
+require 'develry/project/initializer/rspec'
+
+# Provides access to metric tools
+module Develry
+
+  extend Platform
+
+  ROOT                    = Pathname.new(__FILE__).parent.parent.freeze
+  PROJECT_ROOT            = Pathname.pwd.freeze
+  SHARED_PATH             = ROOT.join('shared').freeze
+  SHARED_SPEC_PATH        = SHARED_PATH.join('spec').freeze
+  SHARED_GEMFILE_PATH     = SHARED_PATH.join('Gemfile').freeze
+  DEFAULT_CONFIG_PATH     = ROOT.join('default/config').freeze
+  RAKE_FILES_GLOB         = ROOT.join('tasks/**/*.rake').to_s.freeze
+  LIB_DIRECTORY_NAME      = 'lib'.freeze
+  SPEC_DIRECTORY_NAME     = 'spec'.freeze
+  RB_FILE_PATTERN         = '**/*.rb'.freeze
+  RAKE_FILE_NAME          = 'Rakefile'.freeze
+  DEFAULT_GEMFILE_NAME    = 'Gemfile'.freeze
+  GEMFILE_NAME            = 'Gemfile.develry'.freeze
+  EVAL_GEMFILE            = "eval_gemfile '#{GEMFILE_NAME}'".freeze
+  BUNDLE_UPDATE           = 'bundle update'.freeze
+  REQUIRE                 = "require 'develry'".freeze
+  INIT_RAKE_TASKS         = 'Develry.init_rake_tasks'.freeze
+  SHARED_SPEC_PATTERN     = '{shared,support}/**/*.rb'.freeze
+  UNIT_TEST_PATH_REGEXP   = %r{\bspec/unit/}.freeze
+  DEFAULT_CONFIG_DIR_NAME = 'config'.freeze
+  ANNOTATION_WRAPPER      = "\n# Added by develry\n%s".freeze
+
+  # Provides develry for a project
+  SITE = Site.new(Project.new(PROJECT_ROOT))
+
+  # Initialize project and load tasks
+  #
+  # Should *only* be called from your $application_root/Rakefile
+  #
+  # @return [self]
+  #
+  # @api public
+  def self.init_rake_tasks
+    Project::Initializer::Rake.call
+    self
+  end
+
+  # Initialize project and load shared specs
+  #
+  # Expects to be called from $application_root/spec/spec_helper.rb
+  #
+  # @return [self]
+  #
+  # @api public
+  def self.init_spec_helper
+    SITE.init_spec_helper
+    self
+  end
+
+  # Initialize develry using default config
+  #
+  # @return [undefined]
+  #
+  # @api public
+  def self.init
+    SITE.init
+    self
+  end
+
+  # Sync Gemfile.develry
+  #
+  # @return [undefined]
+  #
+  # @api public
+  def self.sync
+    SITE.sync
+  end
+
+  # Sync Gemfile.develry and run bundle update
+  #
+  # @return [undefined]
+  #
+  # @api public
+  def self.update
+    SITE.update
+  end
+
+  # Return project
+  #
+  # @return [Project]
+  #
+  # @api private
+  def self.project
+    SITE.project
+  end
+
+  # Require shared examples
+  #
+  # @param [Pathname] dir
+  #   the directory containing the files to require
+  #
+  # @param [String] pattern
+  #   the file pattern to match inside directory
+  #
+  # @return [self]
+  #
+  # @api private
+  def self.require_files(dir, pattern)
+    Dir[dir.join(pattern)].each { |file| require file }
+    self
+  end
+
+  # Notify or abort depending on the branch
+  #
+  # @param [String] msg
+  #
+  # @return [undefined]
+  #
+  # @api private
+  def self.notify(msg)
+    fail_on_current_branch? ? abort(msg) : puts(msg)
+  end
+
+  # Test if the build should fail because of metrics on this branch
+  #
+  # @return [Boolean]
+  #
+  # @api private
+  def self.fail_on_current_branch?
+    fail_on_branch.include?(current_branch)
+  end
+
+  # Return the branches the build should fail on because of metrics
+  #
+  # @return [Array[String]]
+  #
+  # @api private
+  def self.fail_on_branch
+    project.devtools.fail_on_branch
+  end
+
+  # Return current git branch
+  #
+  # @return [String]
+  #
+  # @api private
+  def self.current_branch
+    `git rev-parse --abbrev-ref HEAD`.rstrip
+  end
+  private_class_method :current_branch
+
+end # module Develry

data/lib/develry/config.rb

@@ -0,0 +1,167 @@
+# encoding: utf-8
+
+module Develry
+
+  MASTER_BRANCH = 'master'.freeze
+
+  # Abstract base class of tool configuration
+  class Config
+    # Represent no configuration
+    DEFAULT_CONFIG = {}.freeze
+
+    # Declare an attribute
+    #
+    # @param [Symbol] name
+    #
+    # @yieldreturn [Object]
+    #   the default value to use
+    #
+    # @api private
+    #
+    # @return [self]
+    #
+    def self.attribute(name, *default)
+      define_method(name) do
+        raw.fetch(name.to_s, *default)
+      end
+    end
+    private_class_method :attribute
+
+    # Return project
+    #
+    # @return [Project]
+    #
+    # @api private
+    #
+    attr_reader :project
+
+    # Initialize object
+    #
+    # @return [Project]
+    #
+    # @api private
+    #
+    def initialize(project)
+      @project = project
+    end
+
+    # Return config path
+    #
+    # @return [String]
+    #
+    # @api private
+    #
+    def config_file
+      @config_file ||= project.config_dir.join(self.class::FILE).freeze
+    end
+
+    # Test if the task is enabled
+    #
+    # If there is no config file, and no sensible defaults, then the rake task
+    # should become disabled.
+    #
+    # @return [Boolean]
+    #
+    # @api private
+    #
+    def enabled?
+      ! raw.equal?(DEFAULT_CONFIG)
+    end
+
+    private
+
+    # Return raw data
+    #
+    # @return [Hash]
+    #
+    # @api private
+    #
+    def raw
+      @raw ||= yaml_config || DEFAULT_CONFIG
+    end
+
+    # Return the raw config data from a yaml file
+    #
+    # @return [Hash]
+    #   returned if the yaml file is found
+    # @return [nil]
+    #   returned if the yaml file is not found
+    #
+    # @api private
+    #
+    def yaml_config
+      config_file = self.config_file
+      YAML.load_file(config_file).freeze if config_file.file?
+    end
+
+    # Rubocop configuration
+    class Rubocop < self
+      FILE = 'rubocop.yml'.freeze
+    end
+
+    # Reek configuration
+    class Reek < self
+      FILE = 'reek.yml'.freeze
+    end
+
+    # Flay configuration
+    class Flay < self
+      FILE = 'flay.yml'.freeze
+
+      attribute :total_score
+      attribute :threshold
+    end
+
+    # Yardstick configuration
+    class Yardstick < self
+      FILE    = 'yardstick.yml'.freeze
+      OPTIONS = %w[
+        threshold
+        rules
+        verbose
+        path
+        require_exact_threshold
+      ].freeze
+
+      # Options hash that Yardstick understands
+      #
+      # @return [Hash]
+      #
+      # @api private
+      def options
+        OPTIONS.each_with_object({}) { |name, hash|
+          hash[name] = raw.fetch(name, nil)
+        }
+      end
+    end
+
+    # Flog configuration
+    class Flog < self
+      FILE = 'flog.yml'.freeze
+
+      attribute :total_score
+      attribute :threshold
+    end
+
+    # Mutant configuration
+    class Mutant < self
+      FILE             = 'mutant.yml'.freeze
+      DEFAULT_NAME     = ''.freeze
+      DEFAULT_STRATEGY = '--rspec'.freeze
+
+      attribute :name, DEFAULT_NAME
+      attribute :namespace
+      attribute :strategy, DEFAULT_STRATEGY
+    end
+
+    # Develry configuration
+    class Develry < self
+      FILE = 'develry.yml'.freeze
+      DEFAULT_UNIT_TEST_TIMEOUT = 0.1  # 100ms
+      DEFAULT_BRANCHES_TO_FAIL_ON = [MASTER_BRANCH]
+
+      attribute :unit_test_timeout, DEFAULT_UNIT_TEST_TIMEOUT
+      attribute :fail_on_branch, DEFAULT_BRANCHES_TO_FAIL_ON
+    end
+  end
+end