Module: Brief::Model::ClassMethods

Defined in:
lib/brief/model.rb

Instance Attribute Summary collapse

Instance Method Summary collapse

Dynamic Method Handling

This class handles dynamic methods through the method_missing method

#method_missing(meth, *args, &block) ⇒ Object 



308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
 
# File 'lib/brief/model.rb', line 308

def method_missing(meth, *args, &block)
  # these methods when called at a class level inside of
  # a class definition body will modify the schema settings for that model
  if %w(meta content template example actions helpers).include?(meth.to_s)
    definition.send(meth, *args, &block)
    finalize
  # these methods allow the model class to inspect itself and report
  # whatever methods and actions are defined on the model class
  elsif %w(defined_helper_methods defined_actions).include?(meth.to_s)
    definition.send(meth)
  elsif meth.to_s.match(/^on_(.*)_change$/)
    create_change_handler(Regexp.last_match[1], *args, &block)
  else
    super
  end
end

Instance Attribute Details

#name ⇒ Object 



249
250
251
 
# File 'lib/brief/model.rb', line 249

def name
  @name || to_s.split('::').last.underscore.gsub('_', ' ').titlecase
end

#type_alias ⇒ Object 



255
256
257
 
# File 'lib/brief/model.rb', line 255

def type_alias
  @type_alias || name.parameterize.gsub(/-/, '_')
end

Instance Method Details

#==(other) ⇒ Object 



123
124
125
 
# File 'lib/brief/model.rb', line 123

def ==(other)
  type_alias && type_alias == other.type_alias
end

#accessor_property_names ⇒ Object 



127
128
129
 
# File 'lib/brief/model.rb', line 127

def accessor_property_names
  (definition.content_schema.attributes.keys + definition.metadata_schema.keys).uniq
end

#after_initialize(&block) ⇒ Object 



243
244
245
 
# File 'lib/brief/model.rb', line 243

def after_initialize(&block)
  (self.after_initialization_hooks ||= []).push(block)
end

#attribute_names ⇒ Object 



287
288
289
 
# File 'lib/brief/model.rb', line 287

def attribute_names
  attribute_set.map(&:name)
end

#content_schema_summary ⇒ Object 



156
157
158
159
160
161
162
163
164
165
166
 
# File 'lib/brief/model.rb', line 156

def content_schema_summary
  base = definition.content_schema.attributes

  base.keys.inject({}) do |memo, key|
    val = base[key]
    args = Array(val[:args])
    first = args.first
    memo[key] = first if first
    memo
  end
end

#create_change_handler(_attribute, *_args, &block) ⇒ Object 



325
326
327
 
# File 'lib/brief/model.rb', line 325

def create_change_handler(_attribute, *_args, &block)
  block.call(self)
end

#defined_actions ⇒ Object 



212
213
214
 
# File 'lib/brief/model.rb', line 212

def defined_actions
  definition.defined_actions ||= []
end

#defined_in(*args) ⇒ Object 



304
305
306
 
# File 'lib/brief/model.rb', line 304

def defined_in(*args)
  definition.send(:defined_in, *args)
end

#definition ⇒ Object 



259
260
261
 
# File 'lib/brief/model.rb', line 259

def definition
  @definition ||= Brief::Model::Definition.new(name, type_alias: type_alias, model_class: self)
end

#definition=(_value) ⇒ Object 



263
264
265
 
# File 'lib/brief/model.rb', line 263

def definition=(_value)
  @definition
end

#documentation(*args) ⇒ Object 



300
301
302
 
# File 'lib/brief/model.rb', line 300

def documentation(*args)
  definition.send(:documentation, *args)
end

#each(*args, &block) ⇒ Object 



239
240
241
 
# File 'lib/brief/model.rb', line 239

def each(*args, &block)
  Array(models).send(:each, *args, &block)
end

#example_body(*args) ⇒ Object 



296
297
298
 
# File 'lib/brief/model.rb', line 296

def example_body(*args)
  definition.send(:example_body, *args).to_s.strip
end

#finalize ⇒ Object 



216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
 
# File 'lib/brief/model.rb', line 216

def finalize
  klass = self

  klass.name ||= klass.to_s.split('::').last.humanize
  klass.type_alias ||= klass.name.parameterize.gsub(/-/, '_')

  klass.attribute_set.map(&:name).each do |attr|
    unless klass.method_defined?("find_by_#{ attr }")
      klass.define_singleton_method("find_by_#{ attr }") do |value|
        where(attr => value).first
      end
    end
  end

  klass.definition.apply_config

  Brief::Repository.define_document_finder_methods
end

#generate_template_content_from(object = {}, include_frontmatter = true) ⇒ Object 



275
276
277
278
279
280
281
282
283
284
285
 
# File 'lib/brief/model.rb', line 275

def generate_template_content_from(object={}, include_frontmatter = true)
  @erb ||= ERB.new(template_body)
  content = @erb.result(binding)
  frontmatter = object.slice(*attribute_names)

  base = ''
  base += frontmatter.to_hash.to_yaml + "---\n" if include_frontmatter
  base += content

  base
end

#has_actions? ⇒ Boolean

Returns:

  • (Boolean) 


208
209
210
 
# File 'lib/brief/model.rb', line 208

def has_actions?
  definition.has_actions?
end

#metadata_schema_summary ⇒ Object 



168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
 
# File 'lib/brief/model.rb', line 168

def metadata_schema_summary
  base = definition.metadata_schema

  base.keys.inject({}) do |memo, key|
    val = base[key]
    args = Array(val[:args])
    first = args.first.to_s

    if args.length == 1 && first == key.to_s
      memo[key] = "string"
    elsif args.length >= 2
      memo[key] = args.last
    end

    memo
  end
end

#section_mapping(*args) ⇒ Object 



267
268
269
 
# File 'lib/brief/model.rb', line 267

def section_mapping(*args)
  definition.send(:section_mapping, *args)
end

#section_mappings(*args) ⇒ Object 



271
272
273
 
# File 'lib/brief/model.rb', line 271

def section_mappings(*args)
  definition.send(:section_mappings, *args)
end

#template_body(*args) ⇒ Object 



291
292
293
294
 
# File 'lib/brief/model.rb', line 291

def template_body(*args)
  res = definition.send(:template_body, *args)
  res.to_s.length == 0 ? example_body : res.to_s.strip
end

#to_documentation ⇒ Object

Looks to see if there is a documentation markdown file for the model and if so, will return the documentation info as a Hash



133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
 
# File 'lib/brief/model.rb', line 133

def to_documentation
  docs = definition.documentation

  path = if docs.markdown
           Pathname(docs.markdown)
         elsif defined_in
           basename = defined_in.basename.to_s.gsub(/.rb/,'')
           defined_in.parent.join('..','documentation',"#{basename}.md")
         end

  if path
    model_doc = Brief::Briefcase::Documentation::ModelDoc.new(path)

    {
      content: model_doc.content,
      rendered: model_doc.rendered,
      path: path
    }
  else
    { }
  end
end

#to_schema ⇒ Object 



186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
 
# File 'lib/brief/model.rb', line 186

def to_schema
  {
    schema: {
      content: content_schema_summary,
      metadata: metadata_schema_summary,
    },
    documentation: to_documentation,
    defined_in: defined_in,
    class_name: to_s,
    type_alias: type_alias,
    name: name,
    group: name.to_s.pluralize,
    actions: defined_actions,
    example: definition.example_body.to_s,
    template: definition.template_body.to_s,
    urls: {
      browse_url: "browse/#{ type_alias.to_s.pluralize }",
      schema_url: "schema/#{ type_alias }"
    }
  }
end

#where(*args, &_block) ⇒ Object 



235
236
237
 
# File 'lib/brief/model.rb', line 235

def where(*args, &_block)
  Brief::DocumentMapper::Query.new(self).send(:where, *args)
end