Class: Footnotes::Filter

Inherits:
Object
  • Object
show all
Defined in:
lib/rails-footnotes/footnotes.rb

Constant Summary collapse

@@no_style = 
false
@@multiple_notes = 
false
@@klasses = 
[]
@@prefix =

Default link prefix is textmate

'txmt://open?url=file://%s&line=%d&column=%d'
@@notes =

Edit notes

[ :controller, :view, :layout, :partials, :stylesheets, :javascripts ]

Class Method Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(controller) ⇒ Filter

Returns a new instance of Filter.



94
95
96
97
98
99
 
# File 'lib/rails-footnotes/footnotes.rb', line 94

def initialize(controller)
  @controller = controller
  @template = controller.instance_variable_get(:@template)
  @body = controller.response.body
  @notes = []
end

Class Method Details

.each_with_rescue(collection) ⇒ Object

Process notes, discarding only the note if any problem occurs



57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
 
# File 'lib/rails-footnotes/footnotes.rb', line 57

def each_with_rescue(collection)
  delete_me = []

  collection.each do |item|
    begin
      yield item
    rescue Exception => e
      # Discard item if it has a problem
      log_error("Footnotes #{item.to_s.camelize} Exception", e)
      delete_me << item
      next
    end
  end

  delete_me.each { |item| collection.delete(item) }
  return collection
end

.log_error(title, exception) ⇒ Object

Logs the error using specified title and format



77
78
79
 
# File 'lib/rails-footnotes/footnotes.rb', line 77

def log_error(title, exception)
  Rails.logger.error "#{title}: #{exception}\n#{exception.backtrace.join("\n")}"
end

.prefix(*args) ⇒ Object

If none argument is sent, simply return the prefix. Otherwise, replace the args in the prefix.



84
85
86
87
88
89
90
 
# File 'lib/rails-footnotes/footnotes.rb', line 84

def prefix(*args)
  if args.empty?
    @@prefix
  else
    format(@@prefix, *args)
  end
end

.start!(controller) ⇒ Object

Calls the class method start! in each note Sometimes notes need to set variables or clean the environment to work properly This method allows this kind of setup



44
45
46
47
48
49
50
51
52
53
 
# File 'lib/rails-footnotes/footnotes.rb', line 44

def start!(controller)
  self.each_with_rescue(Footnotes.before_hooks) {|hook| hook.call(controller, self)}

  @@klasses = []
  self.each_with_rescue(@@notes.flatten) do |note|
    klass = "Footnotes::Notes::#{note.to_s.camelize}Note".constantize
    klass.start!(controller) if klass.respond_to?(:start!)
    @@klasses << klass
  end
end

Instance Method Details

#add_footnotes! ⇒ Object 



101
102
103
104
105
106
 
# File 'lib/rails-footnotes/footnotes.rb', line 101

def add_footnotes!
  add_footnotes_without_validation! if valid?
rescue Exception => e
  # Discard footnotes if there are any problems
  self.class.log_error("Footnotes Exception", e)
end

#close!(controller) ⇒ Object

Calls the class method close! in each note Sometimes notes need to finish their work even after being read This method allows this kind of work



112
113
114
115
 
# File 'lib/rails-footnotes/footnotes.rb', line 112

def close!(controller)
  self.each_with_rescue(@@klasses) {|klass| klass.close!(controller)}
  self.each_with_rescue(Footnotes.after_hooks) {|hook| hook.call(controller, self)}
end