# File lib/apipie/extractor/writer.rb, line 136 def initialize(controller, action) @controller = controller @action = action end
# File lib/apipie/extractor/writer.rb, line 141 def generated? old_header.include?(Apipie.configuration.generated_doc_disclaimer) end
# File lib/apipie/extractor/writer.rb, line 167 def old_header return @old_header if defined? @old_header @old_header = lines_above_method[%r^\s*?#{Regexp.escape(Apipie.configuration.generated_doc_disclaimer)}.*/] @old_header ||= lines_above_method[%r^\s*?\b(api|params|error|example)\b.*/] @old_header ||= "" @old_header.sub!(%r\A\s*\n/,"") @old_header = align_indented(@old_header) end
# File lib/apipie/extractor/writer.rb, line 163 def update(new_header) overwrite_header(new_header) end
# File lib/apipie/extractor/writer.rb, line 145 def update_apis(apis) new_header = "" new_header << Apipie.configuration.generated_doc_disclaimer << "\n" if generated? new_header << generate_apis_code(apis) new_header << ensure_line_breaks(old_header.lines).reject do |line| line.include?(Apipie.configuration.generated_doc_disclaimer) || line =~ %r^api/ end.join overwrite_header(new_header) end
# File lib/apipie/extractor/writer.rb, line 156 def update_generated_description(desc) if generated? || old_header.empty? new_header = generate_code(desc) overwrite_header(new_header) end end
# File lib/apipie/extractor/writer.rb, line 176 def write! File.open(controller_path, "w") { |f| f << @controller_content } @changed=false end
# File lib/apipie/extractor/writer.rb, line 187 def action_line return @action_line if defined? @action_line @action_line = ensure_line_breaks(controller_content.lines).find_index { |line| line =~ %rdef \b#{@action}\b/ } raise ActionNotFound unless @action_line @action_line end
# File lib/apipie/extractor/writer.rb, line 275 def align_indented(text) shift_left = ensure_line_breaks(text.lines).map { |l| l[%r^\s*/].size }.min ensure_line_breaks(text.lines).map { |l| l[shift_left..-1] }.join end
# File lib/apipie/extractor/writer.rb, line 198 def controller_content raise ControllerNotFound.new unless File.exists? controller_path @controller_content ||= File.read(controller_path) end
# File lib/apipie/extractor/writer.rb, line 203 def controller_content=(new_content) return if @controller_name == new_content remove_instance_variable("@action_line") remove_instance_variable("@old_header") @controller_content=new_content @changed = true end
# File lib/apipie/extractor/writer.rb, line 194 def controller_path @controller_path ||= File.join(Rails.root, "app", "controllers", "#{@controller.controller_path}_controller.rb") end
this method would be totally useless unless some clever guy desided that it would be great idea to change a behavior of “”.lines method to not include end of lines.
For more details:
https://github.com/puppetlabs/puppet/blob/0dc44695/lib/puppet/util/monkey_patches.rb
# File lib/apipie/extractor/writer.rb, line 328 def ensure_line_breaks(lines) if lines.to_a.size > 1 && lines.first !~ %r\n\Z/ lines.map { |l| l !~ %r\n\Z/ ? (l << "\n") : l }.to_enum else lines end end
# File lib/apipie/extractor/writer.rb, line 219 def generate_apis_code(apis) code = "" apis.sort_by {|a| a[:path] }.each do |api| desc = api[:desc] name = @controller.controller_name.gsub("_", " ") desc ||= case @action.to_s when "show", "create", "update", "destroy" name = name.singularize "#{@action.capitalize} #{name =~ /^[aeiou]/ ? "an" : "a"} #{name}" when "index" "List #{name}" end code << "api :#{api[:method]}, \"#{api[:path]}\"" code << ", \"#{desc}\"" if desc code << "\n" end return code end
# File lib/apipie/extractor/writer.rb, line 211 def generate_code(desc) code = "#{Apipie.configuration.generated_doc_disclaimer}\n" code << generate_apis_code(desc[:api]) code << generate_params_code(desc[:params]) code << generate_errors_code(desc[:errors]) return code end
# File lib/apipie/extractor/writer.rb, line 267 def generate_errors_code(errors) code = "" errors.sort_by {|e| e[:code] }.each do |error| code << "error :code => #{error[:code]}\n" end code end
# File lib/apipie/extractor/writer.rb, line 239 def generate_params_code(params, indent = "") code = "" params.sort_by {|n,_| n }.each do |(name, desc)| desc[:type] = (desc[:type] && desc[:type].first) || Object code << "#{indent}param" if name =~ %r\W/ code << " :\"#{name}\"" else code << " :#{name}" end code << ", #{desc[:type].inspect}" if desc[:allow_nil] code << ", :allow_nil => true" end if desc[:required] code << ", :required => true" end if desc[:nested] code << " do\n" code << generate_params_code(desc[:nested], indent + " ") code << "#{indent}end" else end code << "\n" end code end
returns all the lines before the method that might contain the restpi descriptions not bulletproof but working for conventional Ruby code
# File lib/apipie/extractor/writer.rb, line 295 def lines_above_method added_lines = [] lines_to_add = [] block_level = 0 ensure_line_breaks(controller_content.lines).first(action_line).reverse_each do |line| if line =~ %r\s*\bend\b\s*/ block_level += 1 end if block_level > 0 lines_to_add << line else added_lines << line end if line =~ %r\s*\b(module|class|def)\b / break end if line =~ %rdo\s*(\|.*?\|)?\s*$/ block_level -= 1 if block_level == 0 added_lines.concat(lines_to_add) lines_to_add = [] end end end return added_lines.reverse.join end
# File lib/apipie/extractor/writer.rb, line 183 def logger Extractor.logger end
# File lib/apipie/extractor/writer.rb, line 280 def overwrite_header(new_header) overwrite_line_from = action_line overwrite_line_to = action_line unless old_header.empty? overwrite_line_from -= ensure_line_breaks(old_header.lines).count end lines = ensure_line_breaks(controller_content.lines).to_a indentation = lines[action_line][%r^\s*/] self.controller_content= (lines[0...overwrite_line_from] + [new_header.gsub(%r^/,indentation)] + lines[overwrite_line_to..-1]).join end