class Apipie::Extractor::Writer
Public Class Methods
new(collector)
click to toggle source
# File lib/apipie/extractor/writer.rb, line 7 def initialize(collector) @collector = collector @examples_file = File.join(Rails.root, "doc", "apipie_examples.yml") end
update_action_description(controller, action) { |updater| ... }
click to toggle source
# File lib/apipie/extractor/writer.rb, line 33 def self.update_action_description(controller, action) updater = ActionDescriptionUpdater.new(controller, action) yield updater updater.write! rescue ActionDescriptionUpdater::ControllerNotFound logger.warn("REST_API: Couldn't find controller file for #{controller}") rescue ActionDescriptionUpdater::ActionNotFound logger.warn("REST_API: Couldn't find action #{action} in #{controller}") end
Protected Class Methods
logger()
click to toggle source
# File lib/apipie/extractor/writer.rb, line 115 def self.logger Extractor.logger end
Public Instance Methods
write_docs()
click to toggle source
# File lib/apipie/extractor/writer.rb, line 20 def write_docs descriptions = @collector.finalize_descriptions descriptions.each do |_, desc| if desc[:api].empty? logger.warn("REST_API: Couldn't find any path for #{desc_to_s(desc)}") next end self.class.update_action_description(desc[:controller], desc[:action]) do |u| u.update_generated_description desc end end end
write_examples()
click to toggle source
# File lib/apipie/extractor/writer.rb, line 12 def write_examples merged_examples = merge_old_new_examples FileUtils.mkdir_p(File.dirname(@examples_file)) File.open(@examples_file, "w") do |f| f << YAML.dump(OrderedHash[*merged_examples.sort_by(&:first).flatten(1)]) end end
Protected Instance Methods
desc_to_s(description)
click to toggle source
# File lib/apipie/extractor/writer.rb, line 45 def desc_to_s(description) "#{description[:controller].name}##{description[:action]}" end
hash_nodes_count(node)
click to toggle source
# File lib/apipie/extractor/writer.rb, line 128 def hash_nodes_count(node) case node when Hash 1 + (node.values.map { |v| hash_nodes_count(v) }.reduce(:+) || 0) when Array node.map { |v| hash_nodes_count(v) }.reduce(:+) || 1 else 1 end end
load_new_examples()
click to toggle source
# File lib/apipie/extractor/writer.rb, line 79 def load_new_examples @collector.records.reduce({}) do |h, (method, calls)| showed_in_versions = Set.new # we have already shown some example recorded_examples = calls.map do |call| method_descriptions = Apipie.get_method_descriptions(call[:controller], call[:action]) call[:versions] = method_descriptions.map(&:version) if call[:versions].any? { |v| ! showed_in_versions.include?(v) } call[:versions].each { |v| showed_in_versions << v } show_in_doc = 1 else show_in_doc = 0 end example = call.merge(:show_in_doc => show_in_doc.to_i, :recorded => true) example end h.update(method => recorded_examples) end end
load_old_examples()
click to toggle source
# File lib/apipie/extractor/writer.rb, line 100 def load_old_examples if File.exists?(@examples_file) if defined? SafeYAML return YAML.load_file(@examples_file, :safe=>false) else return YAML.load_file(@examples_file) end end return {} end
logger()
click to toggle source
# File lib/apipie/extractor/writer.rb, line 111 def logger self.class.logger end
merge_old_new_examples()
click to toggle source
# File lib/apipie/extractor/writer.rb, line 64 def merge_old_new_examples new_examples = self.load_new_examples old_examples = self.load_old_examples merged_examples = [] (new_examples.keys + old_examples.keys).uniq.each do |key| if new_examples.has_key?(key) records = new_examples[key] else records = old_examples[key] end merged_examples << [key, records.map { |r| ordered_call(r) } ] end return merged_examples end
ordered_call(call)
click to toggle source
# File lib/apipie/extractor/writer.rb, line 49 def ordered_call(call) call = call.stringify_keys ordered_call = OrderedHash.new %w[verb path versions query request_data response_data code show_in_doc recorded].each do |k| next unless call.has_key?(k) ordered_call[k] = case call[k] when ActiveSupport::HashWithIndifferentAccess JSON.parse(call[k].to_json) # to_hash doesn't work recursively and I'm too lazy to write the recursion:) else call[k] end end return ordered_call end
showable_in_doc?(call)
click to toggle source
# File lib/apipie/extractor/writer.rb, line 119 def showable_in_doc?(call) # we don't want to mess documentation with too large examples if hash_nodes_count(call["request_data"]) + hash_nodes_count(call["response_data"]) > 100 return false else return 1 end end