Class: Dragonfly::App

Inherits:
Object show all
Extended by:
Configurable, Forwardable
Defined in:
lib/dragonfly/app.rb

Defined Under Namespace

Classes: UnregisteredDataStore

Constant Summary collapse

DEFAULT_NAME = 
:default

Instance Attribute Summary collapse

Attributes included from Configurable

#configurer

Class Method Summary collapse

Instance Method Summary collapse

Methods included from Configurable

set_up_config

Constructor Details

#initialize(name) ⇒ App

Returns a new instance of App.



54
55
56
57
58
59
60
61
 
# File 'lib/dragonfly/app.rb', line 54

def initialize(name)
  @name = name
  @analysers, @processors, @generators = Register.new, Register.new, Register.new
  @server = Server.new(self)
  @job_methods = Module.new
  @shell = Shell.new
  @env = {}
end

Instance Attribute Details

#allow_legacy_urls ⇒ Object

Returns the value of attribute allow_legacy_urls.



266
267
268
 
# File 'lib/dragonfly/app.rb', line 266

def allow_legacy_urls
  @allow_legacy_urls
end

#analysers ⇒ Object (readonly)

Returns the value of attribute analysers.



120
121
122
 
# File 'lib/dragonfly/app.rb', line 120

def analysers
  @analysers
end

#datastore ⇒ Object 



125
126
127
 
# File 'lib/dragonfly/app.rb', line 125

def datastore
  @datastore ||= FileDataStore.new
end

#env ⇒ Object (readonly)

Returns the value of attribute env.



63
64
65
 
# File 'lib/dragonfly/app.rb', line 63

def env
  @env
end

#generators ⇒ Object (readonly)

Returns the value of attribute generators.



122
123
124
 
# File 'lib/dragonfly/app.rb', line 122

def generators
  @generators
end

#job_methods ⇒ Object (readonly)

Returns the value of attribute job_methods.



181
182
183
 
# File 'lib/dragonfly/app.rb', line 181

def job_methods
  @job_methods
end

#name ⇒ Object (readonly)

Returns the value of attribute name.



63
64
65
 
# File 'lib/dragonfly/app.rb', line 63

def name
  @name
end

#processors ⇒ Object (readonly)

Returns the value of attribute processors.



121
122
123
 
# File 'lib/dragonfly/app.rb', line 121

def processors
  @processors
end

#secret ⇒ Object

Returns the value of attribute secret.



266
267
268
 
# File 'lib/dragonfly/app.rb', line 266

def secret
  @secret
end

#server ⇒ Object (readonly)

Returns the value of attribute server.



123
124
125
 
# File 'lib/dragonfly/app.rb', line 123

def server
  @server
end

#shell ⇒ Object (readonly)

Returns the value of attribute shell.



175
176
177
 
# File 'lib/dragonfly/app.rb', line 175

def shell
  @shell
end

Class Method Details

.[](name) ⇒ Object 



32
33
34
 
# File 'lib/dragonfly/app.rb', line 32

def [](name)
  raise "Dragonfly::App[#{name.inspect}] is deprecated - use Dragonfly.app (for the default app) or Dragonfly.app(#{name.inspect}) (for extra named apps) instead. See docs at http://markevans.github.io/dragonfly for details"
end

.apps ⇒ Object 



36
37
38
 
# File 'lib/dragonfly/app.rb', line 36

def apps
  @apps ||= {}
end

.available_datastores ⇒ Object 



48
49
50
 
# File 'lib/dragonfly/app.rb', line 48

def available_datastores
  @available_datastores ||= {}
end

.destroy_apps ⇒ Object 



40
41
42
 
# File 'lib/dragonfly/app.rb', line 40

def destroy_apps
  apps.clear
end

.instance(name = nil) ⇒ Object 



26
27
28
29
30
 
# File 'lib/dragonfly/app.rb', line 26

def instance(name=nil)
  name ||= DEFAULT_NAME
  name = name.to_sym
  apps[name] ||= new(name)
end

.register_datastore(symbol, &block) ⇒ Object 



44
45
46
 
# File 'lib/dragonfly/app.rb', line 44

def register_datastore(symbol, &block)
  available_datastores[symbol] = block
end

Instance Method Details

#add_analyser(name, callable = nil, &block) ⇒ Object 



161
162
163
164
 
# File 'lib/dragonfly/app.rb', line 161

def add_analyser(name, callable=nil, &block)
  analysers.add(name, callable, &block)
  define(name){ analyse(name) }
end

#add_generator(*args, &block) ⇒ Object 



143
144
145
 
# File 'lib/dragonfly/app.rb', line 143

def add_generator(*args, &block)
  generators.add(*args, &block)
end

#add_mime_type(format, mime_type) ⇒ Object 



201
202
203
 
# File 'lib/dragonfly/app.rb', line 201

def add_mime_type(format, mime_type)
  mime_types[file_ext_string(format)] = mime_type
end

#add_processor(name, callable = nil, &block) ⇒ Object 



151
152
153
154
155
 
# File 'lib/dragonfly/app.rb', line 151

def add_processor(name, callable=nil, &block)
  processors.add(name, callable, &block)
  define(name){|*args| process(name, *args) }
  define("#{name}!"){|*args| process!(name, *args) }
end

#analyser_methods ⇒ Object 



254
255
256
 
# File 'lib/dragonfly/app.rb', line 254

def analyser_methods
  analysers.names
end

#define(method, &block) ⇒ Object 



193
194
195
 
# File 'lib/dragonfly/app.rb', line 193

def define(method, &block)
  job_methods.send(:define_method, method, &block)
end

#define_macro(klass, name) ⇒ Object

Raises:

  • (NoMethodError) 


268
269
270
 
# File 'lib/dragonfly/app.rb', line 268

def define_macro(klass, name)
  raise NoMethodError, "define_macro is deprecated - instead of defining #{name}, just extend #{klass.name} with Dragonfly::Model and use dragonfly_accessor"
end

#define_macro_on_include(mod, name) ⇒ Object

Raises:

  • (NoMethodError) 


272
273
274
 
# File 'lib/dragonfly/app.rb', line 272

def define_macro_on_include(mod, name)
  raise NoMethodError, "define_macro_on_include is deprecated - instead of defining #{name}, just extend the relevant class with Dragonfly::Model and use dragonfly_accessor"
end

#define_url(&block) ⇒ Object 



227
228
229
 
# File 'lib/dragonfly/app.rb', line 227

def define_url(&block)
  @url_proc = block
end

#endpoint(job = nil, &block) ⇒ Object 



177
178
179
 
# File 'lib/dragonfly/app.rb', line 177

def endpoint(job=nil, &block)
  block ? RoutedEndpoint.new(self, &block) : JobEndpoint.new(job)
end

#ext_for(mime_type) ⇒ Object 



213
214
215
216
217
 
# File 'lib/dragonfly/app.rb', line 213

def ext_for(mime_type)
  return 'txt' if mime_type == 'text/plain'
  ext = key_for(mime_types, mime_type)
  ext.tr('.', '') if ext
end

#fallback_mime_type ⇒ Object 



262
263
264
 
# File 'lib/dragonfly/app.rb', line 262

def fallback_mime_type
  'application/octet-stream'
end

#generator_methods ⇒ Object 



250
251
252
 
# File 'lib/dragonfly/app.rb', line 250

def generator_methods
  generators.names
end

#get_analyser(name) ⇒ Object 



166
167
168
 
# File 'lib/dragonfly/app.rb', line 166

def get_analyser(name)
  analysers.get(name)
end

#get_generator(name) ⇒ Object 



147
148
149
 
# File 'lib/dragonfly/app.rb', line 147

def get_generator(name)
  generators.get(name)
end

#get_processor(name) ⇒ Object 



157
158
159
 
# File 'lib/dragonfly/app.rb', line 157

def get_processor(name)
  processors.get(name)
end

#inspect ⇒ Object 



258
259
260
 
# File 'lib/dragonfly/app.rb', line 258

def inspect
  "<#{self.class.name} name=#{name.inspect} >"
end

#job_class ⇒ Object 



183
184
185
186
187
188
189
190
191
 
# File 'lib/dragonfly/app.rb', line 183

def job_class
  @job_class ||= begin
    app = self
    Class.new(Job).class_eval do
      include app.job_methods
      self
    end
  end
end

#mime_type_for(format) ⇒ Object 



209
210
211
 
# File 'lib/dragonfly/app.rb', line 209

def mime_type_for(format)
  mime_types[file_ext_string(format)] || fallback_mime_type
end

#mime_types ⇒ Object 



205
206
207
 
# File 'lib/dragonfly/app.rb', line 205

def mime_types
  @mime_types ||= Rack::Mime::MIME_TYPES.dup
end

#new_job(content = "", meta = {}) ⇒ Object Also known as: create 



170
171
172
 
# File 'lib/dragonfly/app.rb', line 170

def new_job(content="", meta={})
  job_class.new(self, content, meta)
end

#processor_methods ⇒ Object

Reflection



246
247
248
 
# File 'lib/dragonfly/app.rb', line 246

def processor_methods
  processors.names
end

#remote_url_for(uid, opts = {}) ⇒ Object 



239
240
241
242
243
 
# File 'lib/dragonfly/app.rb', line 239

def remote_url_for(uid, opts={})
  datastore.url_for(uid, opts)
rescue NoMethodError
  raise NotImplementedError, "The datastore doesn't support serving content directly - #{datastore.inspect}"
end

#response_header(key, value = nil, &block) ⇒ Object 



219
220
221
 
# File 'lib/dragonfly/app.rb', line 219

def response_header(key, value=nil, &block)
  response_headers[key] = value || block
end

#response_headers ⇒ Object 



223
224
225
 
# File 'lib/dragonfly/app.rb', line 223

def response_headers
  @response_headers ||= {}
end

#store(object, meta = {}, opts = {}) ⇒ Object 



197
198
199
 
# File 'lib/dragonfly/app.rb', line 197

def store(object, meta={}, opts={})
  create(object, meta).store(opts)
end

#url_for(job, opts = {}) ⇒ Object 



231
232
233
234
235
236
237
 
# File 'lib/dragonfly/app.rb', line 231

def url_for(job, opts={})
  if @url_proc
    @url_proc.call(self, job, opts)
  else
    server.url_for(job, opts)
  end
end

#use_datastore(store, *args) ⇒ Object 



130
131
132
133
134
135
136
137
138
139
140
141
 
# File 'lib/dragonfly/app.rb', line 130

def use_datastore(store, *args)
  self.datastore = if store.is_a?(Symbol)
    get_klass = self.class.available_datastores[store]
    raise UnregisteredDataStore, "the datastore '#{store}' is not registered" unless get_klass
    klass = get_klass.call
    klass.new(*args)
  else
    raise ArgumentError, "datastore only takes 1 argument unless you use a symbol" if args.any?
    store
  end
  raise "datastores have a new interface (read/write/destroy) - see docs at http://markevans.github.io/dragonfly for details" if datastore.respond_to?(:store) && !datastore.respond_to?(:write)
end