quality 4.0.2 → 5.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- checksums.yaml +4 -4
- data/README.md +3 -1
- data/lib/quality/quality_checker.rb +11 -9
- data/lib/quality/rake/config.rb +73 -0
- data/lib/quality/rake/task.rb +14 -73
- data/lib/quality/runner.rb +10 -6
- data/lib/quality/tools/punchlist.rb +15 -0
- data/lib/quality/version.rb +1 -1
- data/quality.gemspec +1 -0
- metadata +18 -2
checksums.yaml
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
---
|
2
2
|
SHA1:
|
3
|
-
metadata.gz:
|
4
|
-
data.tar.gz:
|
3
|
+
metadata.gz: 3cfeb910fecf24038686535a2e904d6703149134
|
4
|
+
data.tar.gz: 9c2dc4563465bddb667151c887c9037c3659d522
|
5
5
|
SHA512:
|
6
|
-
metadata.gz:
|
7
|
-
data.tar.gz:
|
6
|
+
metadata.gz: 6ffc41976904af90fd21b40aa104814e83e2672f7514d85dfc225a0e5a5ef11ca224b2f7e9422f97435095cb07f61a040652cb64dc0ef71e9722b2e42758b785
|
7
|
+
data.tar.gz: c66f3f646781f5aa60996e4f3f6c776331a7340ce2fd894eef7c7af0fe9c0712eff076ae97b89e0c11ea460e0c200f1bcd7154c95d17f7ca12100429803f2b27
|
data/README.md
CHANGED
@@ -94,7 +94,7 @@ See [this post for more information](http://blog.apiology.cc/2014/06/scalable-qu
|
|
94
94
|
|
95
95
|
## Maturity
|
96
96
|
|
97
|
-
Quality
|
97
|
+
Quality uses [semantic versioning](http://semver.org/)--any incompatible changes will come out as major number updates.
|
98
98
|
|
99
99
|
## Supported Ruby Versions
|
100
100
|
|
@@ -117,6 +117,8 @@ Quality makes use of the following other gems, which do the actual checking:
|
|
117
117
|
* [flog](https://github.com/seattlerb/flog)
|
118
118
|
* [flay](https://github.com/seattlerb/flay)
|
119
119
|
* [rubocop](https://github.com/bbatsov/rubocop)
|
120
|
+
* [bigfiles](https://github.com/apiology/bigfiles)
|
121
|
+
* [punchlist](https://github.com/apiology/punchlist)
|
120
122
|
|
121
123
|
### Learn More
|
122
124
|
|
@@ -1,23 +1,25 @@
|
|
1
1
|
require_relative 'command_output_processor'
|
2
2
|
require_relative 'process_runner'
|
3
3
|
|
4
|
+
# XXX: Should add *.gemspec to glob
|
4
5
|
module Quality
|
5
6
|
# Runs a quality-checking, command, checks it agaist the existing
|
6
7
|
# number of violations for that command, and decreases that number
|
7
8
|
# if possible, or outputs data if the number of violations increased.
|
8
9
|
class QualityChecker
|
9
|
-
def initialize(cmd, command_options, output_dir, verbose,
|
10
|
-
|
11
|
-
|
12
|
-
|
13
|
-
|
14
|
-
|
10
|
+
def initialize(cmd, command_options, output_dir, verbose,
|
11
|
+
count_file: File,
|
12
|
+
count_io: IO,
|
13
|
+
command_output_processor_class:
|
14
|
+
Quality::CommandOutputProcessor,
|
15
|
+
count_dir: Dir,
|
16
|
+
process_runner_class: ProcessRunner)
|
17
|
+
@count_file, @count_io, @command_output_processor_class, @count_dir =
|
18
|
+
count_file, count_io, command_output_processor_class, count_dir
|
15
19
|
@cmd, @command_options, @verbose = cmd, command_options, verbose
|
16
|
-
@count_dir = dependencies[:count_dir] || Dir
|
17
20
|
@count_dir.mkdir(output_dir) unless @count_file.exists?(output_dir)
|
18
21
|
@filename = File.join(output_dir, "#{cmd}_high_water_mark")
|
19
|
-
@process_runner_class =
|
20
|
-
dependencies[:process_runner_class] || ProcessRunner
|
22
|
+
@process_runner_class = process_runner_class
|
21
23
|
end
|
22
24
|
|
23
25
|
def execute(&count_violations_on_line)
|
@@ -0,0 +1,73 @@
|
|
1
|
+
# XXX: This should be moved out of rake directory
|
2
|
+
module Quality
|
3
|
+
# Configuration for running quality tool
|
4
|
+
class Config
|
5
|
+
# Name of quality task.
|
6
|
+
# Defaults to :quality.
|
7
|
+
attr_accessor :quality_name
|
8
|
+
|
9
|
+
# Name of ratchet task.
|
10
|
+
# Defaults to :ratchet.
|
11
|
+
attr_accessor :ratchet_name
|
12
|
+
|
13
|
+
# Array of strings describing tools to be skipped--e.g., ["cane"]
|
14
|
+
#
|
15
|
+
# Defaults to []
|
16
|
+
attr_accessor :skip_tools
|
17
|
+
|
18
|
+
# Log command executation
|
19
|
+
#
|
20
|
+
# Defaults to false
|
21
|
+
attr_accessor :verbose
|
22
|
+
|
23
|
+
# Array of directory names which contain ruby files to analyze.
|
24
|
+
#
|
25
|
+
# Defaults to %w(app lib test spec feature), which translates to *.rb in
|
26
|
+
# the base directory, as well as those directories.
|
27
|
+
attr_writer :ruby_dirs
|
28
|
+
|
29
|
+
# Array of directory names which contain any type of source
|
30
|
+
# files to analyze.
|
31
|
+
#
|
32
|
+
# Defaults to the same as ruby_dirs
|
33
|
+
attr_writer :source_dirs
|
34
|
+
|
35
|
+
# Relative path to output directory where *_high_water_mark
|
36
|
+
# files will be read/written
|
37
|
+
#
|
38
|
+
# Defaults to .
|
39
|
+
attr_accessor :output_dir
|
40
|
+
|
41
|
+
def ruby_dirs
|
42
|
+
@ruby_dirs ||= %w(app lib test spec feature)
|
43
|
+
end
|
44
|
+
|
45
|
+
def source_dirs
|
46
|
+
@source_dirs ||= ruby_dirs.clone
|
47
|
+
end
|
48
|
+
|
49
|
+
def source_files_glob(dirs = source_dirs,
|
50
|
+
extensions = 'rb,swift,cpp,c,java,py')
|
51
|
+
File.join("{#{dirs.join(',')}}", '**', "*.{#{extensions}}")
|
52
|
+
end
|
53
|
+
|
54
|
+
def ruby_files_glob
|
55
|
+
source_files_glob(ruby_dirs, 'rb')
|
56
|
+
end
|
57
|
+
|
58
|
+
def ruby_files
|
59
|
+
@globber.glob('{*.rb,Rakefile}')
|
60
|
+
.concat(@globber.glob(ruby_files_glob)).join(' ')
|
61
|
+
end
|
62
|
+
|
63
|
+
def initialize(quality_name: 'quality',
|
64
|
+
ratchet_name: 'ratchet',
|
65
|
+
globber: fail)
|
66
|
+
@quality_name, @ratchet_name = quality_name, ratchet_name
|
67
|
+
@skip_tools = []
|
68
|
+
@output_dir = 'metrics'
|
69
|
+
@verbose = false
|
70
|
+
@globber = globber
|
71
|
+
end
|
72
|
+
end
|
73
|
+
end
|
data/lib/quality/rake/task.rb
CHANGED
@@ -5,6 +5,7 @@ require 'rake/tasklib'
|
|
5
5
|
require 'rbconfig'
|
6
6
|
require_relative '../runner'
|
7
7
|
require_relative '../quality_checker'
|
8
|
+
require_relative 'config'
|
8
9
|
|
9
10
|
module Quality
|
10
11
|
#
|
@@ -25,42 +26,6 @@ module Quality
|
|
25
26
|
#
|
26
27
|
# rake quality
|
27
28
|
class Task < ::Rake::TaskLib
|
28
|
-
# Name of quality task.
|
29
|
-
# Defaults to :quality.
|
30
|
-
attr_accessor :quality_name
|
31
|
-
|
32
|
-
# Name of ratchet task.
|
33
|
-
# Defaults to :ratchet.
|
34
|
-
attr_accessor :ratchet_name
|
35
|
-
|
36
|
-
# Array of strings describing tools to be skipped--e.g., ["cane"]
|
37
|
-
#
|
38
|
-
# Defaults to []
|
39
|
-
attr_accessor :skip_tools
|
40
|
-
|
41
|
-
# Log command executation
|
42
|
-
#
|
43
|
-
# Defaults to false
|
44
|
-
attr_accessor :verbose
|
45
|
-
|
46
|
-
# Array of directory names which contain ruby files to analyze.
|
47
|
-
#
|
48
|
-
# Defaults to %w(app lib test spec feature), which translates to *.rb in
|
49
|
-
# the base directory, as well as those directories.
|
50
|
-
attr_writer :ruby_dirs
|
51
|
-
|
52
|
-
# Array of directory names which contain any type of source
|
53
|
-
# files to analyze.
|
54
|
-
#
|
55
|
-
# Defaults to the same as ruby_dirs
|
56
|
-
attr_writer :source_dirs
|
57
|
-
|
58
|
-
# Relative path to output directory where *_high_water_mark
|
59
|
-
# files will be read/written
|
60
|
-
#
|
61
|
-
# Defaults to .
|
62
|
-
attr_accessor :output_dir
|
63
|
-
|
64
29
|
# Defines a new task, using the name +name+.
|
65
30
|
def initialize(dsl: ::Rake::Task,
|
66
31
|
cmd_runner: Kernel,
|
@@ -68,59 +33,35 @@ module Quality
|
|
68
33
|
count_io: IO,
|
69
34
|
globber: Dir,
|
70
35
|
gem_spec: Gem::Specification,
|
71
|
-
configuration_writer: File,
|
72
36
|
quality_checker_class:
|
73
|
-
Quality::QualityChecker
|
74
|
-
quality_name: 'quality',
|
75
|
-
ratchet_name: 'ratchet')
|
37
|
+
Quality::QualityChecker)
|
76
38
|
@dsl, @cmd_runner = dsl, cmd_runner
|
77
39
|
@globber = globber
|
78
|
-
@
|
79
|
-
|
80
|
-
@
|
81
|
-
|
82
|
-
@verbose = false
|
83
|
-
|
84
|
-
@output_dir = 'metrics'
|
85
|
-
|
86
|
-
yield self if block_given?
|
87
|
-
|
88
|
-
@runner = Quality::Runner.new(self,
|
40
|
+
@config = Quality::Config.new(globber: globber)
|
41
|
+
yield @config if block_given?
|
42
|
+
@runner = Quality::Runner.new(@config,
|
89
43
|
gem_spec: gem_spec,
|
90
44
|
quality_checker_class:
|
91
45
|
quality_checker_class,
|
92
46
|
count_io: count_io,
|
93
|
-
count_file: count_file
|
47
|
+
count_file: count_file,
|
48
|
+
globber: globber)
|
94
49
|
define
|
95
50
|
end
|
96
51
|
|
97
|
-
attr_reader :globber
|
98
|
-
|
99
|
-
def ruby_dirs
|
100
|
-
@ruby_dirs ||= %w(app lib test spec feature)
|
101
|
-
end
|
102
|
-
|
103
|
-
def source_dirs
|
104
|
-
@source_dirs ||= ruby_dirs.clone
|
105
|
-
end
|
52
|
+
attr_reader :globber, :config
|
106
53
|
|
107
|
-
|
108
|
-
extensions = 'rb,swift,cpp,c,java,py')
|
109
|
-
File.join("{#{dirs.join(',')}}", '**', "*.{#{extensions}}")
|
110
|
-
end
|
54
|
+
private
|
111
55
|
|
112
|
-
def
|
113
|
-
|
56
|
+
def quality_name
|
57
|
+
config.quality_name
|
114
58
|
end
|
115
59
|
|
116
|
-
def
|
117
|
-
|
118
|
-
.concat(@globber.glob(ruby_files_glob)).join(' ')
|
60
|
+
def ratchet_name
|
61
|
+
config.ratchet_name
|
119
62
|
end
|
120
63
|
|
121
|
-
|
122
|
-
|
123
|
-
def define # :nodoc:
|
64
|
+
def define
|
124
65
|
desc 'Verify quality has increased or stayed ' \
|
125
66
|
'the same' unless ::Rake.application.last_comment
|
126
67
|
@dsl.define_task(quality_name) { @runner.run_quality }
|
data/lib/quality/runner.rb
CHANGED
@@ -4,6 +4,9 @@ require_relative 'tools/flog'
|
|
4
4
|
require_relative 'tools/reek'
|
5
5
|
require_relative 'tools/rubocop'
|
6
6
|
require_relative 'tools/bigfiles'
|
7
|
+
require_relative 'tools/punchlist'
|
8
|
+
|
9
|
+
# XXX: This name is too similar to process_runner
|
7
10
|
|
8
11
|
module Quality
|
9
12
|
# Knows how to run different quality tools based on a configuration
|
@@ -15,17 +18,20 @@ module Quality
|
|
15
18
|
include Tools::Reek
|
16
19
|
include Tools::Rubocop
|
17
20
|
include Tools::BigFiles
|
21
|
+
include Tools::Punchlist
|
18
22
|
|
19
23
|
def initialize(config,
|
20
24
|
gem_spec: Gem::Specification,
|
21
25
|
quality_checker_class: Quality::QualityChecker,
|
22
26
|
count_io: IO,
|
23
|
-
count_file: File
|
27
|
+
count_file: File,
|
28
|
+
globber: Dir)
|
24
29
|
@config = config
|
25
30
|
@gem_spec = gem_spec
|
26
31
|
@quality_checker_class = quality_checker_class
|
27
32
|
@count_io = count_io
|
28
33
|
@count_file = count_file
|
34
|
+
@globber = globber
|
29
35
|
end
|
30
36
|
|
31
37
|
def run_quality
|
@@ -43,12 +49,10 @@ module Quality
|
|
43
49
|
end
|
44
50
|
end
|
45
51
|
|
46
|
-
def globber
|
47
|
-
@config.globber
|
48
|
-
end
|
49
|
-
|
50
52
|
def run_ratchet
|
51
|
-
|
53
|
+
# XXX: a lot of things know about globbing--isn't this config's job?
|
54
|
+
@globber.glob("#{@config.output_dir}/*_high_water_mark")
|
55
|
+
.each do |filename|
|
52
56
|
run_ratchet_on_file(filename)
|
53
57
|
end
|
54
58
|
end
|
@@ -0,0 +1,15 @@
|
|
1
|
+
module Quality
|
2
|
+
module Tools
|
3
|
+
# Adds 'punchlist' tool support to quality gem
|
4
|
+
module Punchlist
|
5
|
+
private
|
6
|
+
|
7
|
+
def quality_punchlist
|
8
|
+
ratchet_quality_cmd('punchlist',
|
9
|
+
args: "--glob '#{source_files_glob}'") do |_line|
|
10
|
+
1
|
11
|
+
end
|
12
|
+
end
|
13
|
+
end
|
14
|
+
end
|
15
|
+
end
|
data/lib/quality/version.rb
CHANGED
data/quality.gemspec
CHANGED
@@ -37,6 +37,7 @@ your numbers don't get any worse over time.
|
|
37
37
|
s.add_runtime_dependency(%q(flay), ['>= 2.4', '!= 2.6.0'])
|
38
38
|
s.add_runtime_dependency(%q(rubocop))
|
39
39
|
s.add_runtime_dependency(%q(bigfiles))
|
40
|
+
s.add_runtime_dependency(%q(punchlist))
|
40
41
|
|
41
42
|
# need above this version to support Ruby 2.0 syntax
|
42
43
|
s.add_runtime_dependency(%q(ruby_parser), ['>= 3.2.2'])
|
metadata
CHANGED
@@ -1,14 +1,14 @@
|
|
1
1
|
--- !ruby/object:Gem::Specification
|
2
2
|
name: quality
|
3
3
|
version: !ruby/object:Gem::Version
|
4
|
-
version:
|
4
|
+
version: 5.0.0
|
5
5
|
platform: ruby
|
6
6
|
authors:
|
7
7
|
- Vince Broz
|
8
8
|
autorequire:
|
9
9
|
bindir: bin
|
10
10
|
cert_chain: []
|
11
|
-
date: 2015-04-
|
11
|
+
date: 2015-04-08 00:00:00.000000000 Z
|
12
12
|
dependencies:
|
13
13
|
- !ruby/object:Gem::Dependency
|
14
14
|
name: cane
|
@@ -100,6 +100,20 @@ dependencies:
|
|
100
100
|
- - '>='
|
101
101
|
- !ruby/object:Gem::Version
|
102
102
|
version: '0'
|
103
|
+
- !ruby/object:Gem::Dependency
|
104
|
+
name: punchlist
|
105
|
+
requirement: !ruby/object:Gem::Requirement
|
106
|
+
requirements:
|
107
|
+
- - '>='
|
108
|
+
- !ruby/object:Gem::Version
|
109
|
+
version: '0'
|
110
|
+
type: :runtime
|
111
|
+
prerelease: false
|
112
|
+
version_requirements: !ruby/object:Gem::Requirement
|
113
|
+
requirements:
|
114
|
+
- - '>='
|
115
|
+
- !ruby/object:Gem::Version
|
116
|
+
version: '0'
|
103
117
|
- !ruby/object:Gem::Dependency
|
104
118
|
name: ruby_parser
|
105
119
|
requirement: !ruby/object:Gem::Requirement
|
@@ -201,12 +215,14 @@ files:
|
|
201
215
|
- lib/quality/command_output_processor.rb
|
202
216
|
- lib/quality/process_runner.rb
|
203
217
|
- lib/quality/quality_checker.rb
|
218
|
+
- lib/quality/rake/config.rb
|
204
219
|
- lib/quality/rake/task.rb
|
205
220
|
- lib/quality/runner.rb
|
206
221
|
- lib/quality/tools/bigfiles.rb
|
207
222
|
- lib/quality/tools/cane.rb
|
208
223
|
- lib/quality/tools/flay.rb
|
209
224
|
- lib/quality/tools/flog.rb
|
225
|
+
- lib/quality/tools/punchlist.rb
|
210
226
|
- lib/quality/tools/reek.rb
|
211
227
|
- lib/quality/tools/rubocop.rb
|
212
228
|
- lib/quality/version.rb
|