Class: Rake::Notes::SourceAnnotationExtractor
- Inherits:
-
Object
- Object
- Rake::Notes::SourceAnnotationExtractor
- Defined in:
- lib/rake/notes/source_annotation_extractor.rb
Overview
From: github.com/rails/rails/blob/master/railties/lib/rails/source_annotation_extractor.rb
Implements the logic behind the rake tasks for annotations like
rake notes
rake notes:optimize
and friends. See rake -T notes
.
Annotation objects are triplets :line
, :tag
, :text
that represent the line where the annotation lives, its tag, and its text. Note the filename is not stored.
Annotations are looked for in comments and modulus whitespace they have to start with the tag optionally followed by a colon. Everything up to the end of the line (or closing ERB comment tag) is considered to be their text.
Defined Under Namespace
Classes: Annotation
Constant Summary collapse
- RUBYFILES =
%w( Vagrantfile Rakefile Puppetfile Gemfile )
- DEFAULT_IGNORE_DIRS =
‘gem install –standalone` puts gems into $project/bundle and it really slows down the rake task
{ 'ignore' => [ './bundle', './vendor' ] }
Instance Attribute Summary collapse
-
#tag ⇒ Object
readonly
Returns the value of attribute tag.
Class Method Summary collapse
-
.enumerate(tag, options = {}) ⇒ Object
Prints all annotations with tag
tag
under the current directory. - .ignore_dirs ⇒ Object
Instance Method Summary collapse
-
#display(results, options = {}) ⇒ Object
Prints the mapping from filenames to annotations in
results
ordered by filename. -
#extract_annotations_from(file, pattern) ⇒ Object
If
file
is the filename of a file that contains annotations this method returns a hash with a single entry that mapsfile
to an array of its annotations. -
#find ⇒ Object
Returns a hash that maps filenames to arrays with their annotations.
-
#find_in(dir) ⇒ Object
Returns a hash that maps filenames under
dir
(recursively) to arrays with their annotations. -
#initialize(tag) ⇒ SourceAnnotationExtractor
constructor
A new instance of SourceAnnotationExtractor.
Constructor Details
#initialize(tag) ⇒ SourceAnnotationExtractor
Returns a new instance of SourceAnnotationExtractor.
70 71 72 |
# File 'lib/rake/notes/source_annotation_extractor.rb', line 70 def initialize(tag) @tag = tag end |
Instance Attribute Details
#tag ⇒ Object (readonly)
Returns the value of attribute tag.
68 69 70 |
# File 'lib/rake/notes/source_annotation_extractor.rb', line 68 def tag @tag end |
Class Method Details
.enumerate(tag, options = {}) ⇒ Object
Prints all annotations with tag tag
under the current directory. Only known file types are taken into account. The options
hash is passed to each annotation’s to_s
.
This class method is the single entry point for the rake tasks.
63 64 65 66 |
# File 'lib/rake/notes/source_annotation_extractor.rb', line 63 def self.enumerate(tag, ={}) extractor = new(tag) extractor.display(extractor.find, ) end |
.ignore_dirs ⇒ Object
29 30 31 32 33 34 35 |
# File 'lib/rake/notes/source_annotation_extractor.rb', line 29 def self.ignore_dirs @ignore_dirs ||= begin config = DEFAULT_IGNORE_DIRS config = config.merge(YAML.safe_load(File.read('./.rake-notes.yml'))) if File.exist?('./.rake-notes.yml') config['ignore'] || [] end end |
Instance Method Details
#display(results, options = {}) ⇒ Object
Prints the mapping from filenames to annotations in results
ordered by filename. The options
hash is passed to each annotation’s to_s
.
121 122 123 124 125 126 127 128 129 130 131 |
# File 'lib/rake/notes/source_annotation_extractor.rb', line 121 def display(results, ={}) [:indent] = results.map { |f, a| a.map(&:line) }.flatten.max.to_s.size out = .delete(:out) || $stdout results.keys.sort.each do |file| out.puts "#{file[2..-1]}:" results[file].each do |note| out.puts " * #{note.to_s()}" end out.puts end end |
#extract_annotations_from(file, pattern) ⇒ Object
If file
is the filename of a file that contains annotations this method returns a hash with a single entry that maps file
to an array of its annotations. Otherwise it returns an empty hash.
109 110 111 112 113 114 115 116 117 |
# File 'lib/rake/notes/source_annotation_extractor.rb', line 109 def extract_annotations_from(file, pattern) lineno = 0 result = File.readlines(file).inject([]) do |list, line| lineno += 1 next list unless line =~ pattern list << Annotation.new(lineno, $1, $2) end result.empty? ? {} : { file => result } end |
#find ⇒ Object
Returns a hash that maps filenames to arrays with their annotations.
75 76 77 |
# File 'lib/rake/notes/source_annotation_extractor.rb', line 75 def find find_in('.') end |
#find_in(dir) ⇒ Object
Returns a hash that maps filenames under dir
(recursively) to arrays with their annotations. Only files with annotations are included, and only known file types are taken into account.
82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 |
# File 'lib/rake/notes/source_annotation_extractor.rb', line 82 def find_in(dir) results = {} Dir.glob("#{dir}/*") do |item| next if File.basename(item)[0] == ?. if File.directory?(item) next if SourceAnnotationExtractor.ignore_dirs.include?(item) results.update(find_in(item)) elsif item =~ /\.(builder|rb|coffee|rake|pp|ya?ml|gemspec|feature)$/ || RUBYFILES.include?(File.basename(item)) results.update(extract_annotations_from(item, /#\s*(#{tag}):?\s*(.*)$/)) elsif item =~ /\.(css|scss|js|ts|tsx)$/ results.update(extract_annotations_from(item, /\/\/\s*(#{tag}):?\s*(.*)$/)) elsif item =~ /\.erb$/ results.update(extract_annotations_from(item, /<%\s*#\s*(#{tag}):?\s*(.*?)\s*%>/)) elsif item =~ /\.haml$/ results.update(extract_annotations_from(item, /-\s*#\s*(#{tag}):?\s*(.*)$/)) elsif item =~ /\.slim$/ results.update(extract_annotations_from(item, /\/\s*\s*(#{tag}):?\s*(.*)$/)) end end results end |