Class: Glyph::Analyzer

Inherits:
Object
  • Object
show all
Includes:
Utils
Defined in:
lib/glyph/analyzer.rb

Overview

This class is used to collect statistics about a Glyph document.

Since:

  • 0.4.0

Instance Attribute Summary collapse

Instance Method Summary collapse

Methods included from Utils

#clean_xml_document, #complex_output?, #current_output_setting, #debug, #error, #file_copy, #file_load, #file_write, #info, #load_files_from_dir, #macro_alias?, #macro_aliases_for, #macro_definition_for, #macro_eq?, #msg, #multiple_output_files?, #project?, #run_external_command, #titled_sections, #warning, #with_files_from, #yaml_dump, #yaml_load

Constructor Details

#initialize(doc = Glyph.document) ⇒ Analyzer

Initializes a new Analyzer

Parameters:

  • doc (Glyph::Document) (defaults to: Glyph.document) —

    the document to analyze

Since:

  • 0.4.0



15
16
17
18
19
20
 
# File 'lib/glyph/analyzer.rb', line 15

def initialize(doc=Glyph.document)
  @doc = doc
  @stats = {}
  @macros = []
  @macros_by_def = {}
end

Instance Attribute Details

#stats ⇒ Object (readonly)

Since:

  • 0.4.0



11
12
13
 
# File 'lib/glyph/analyzer.rb', line 11

def stats
  @stats
end

Instance Method Details

#macro_array_for(name) ⇒ Object

Helper method used to return an array of specific macro instances

Parameters:

  • name (String, Symbol) —

    the name of the macro definition

Since:

  • 0.4.0



24
25
26
27
28
29
 
# File 'lib/glyph/analyzer.rb', line 24

def macro_array_for(name)
  return @macros_by_def[name.to_sym] if @macros_by_def[name.to_sym]
  key = @macros_by_def.keys.select{|k| macro_eq?(k, name.to_sym) }[0] || name.to_sym
  @macros_by_def[key] = [] unless @macros_by_def[key]
  @macros_by_def[key]
end

#stats_for(stats_type, *args) ⇒ Object

Retrieves statistics of a given type (:macros, :bookmarks, :links, :snippets, :files, :global, :macro, :bookmark, :snippet, :link)

Parameters:

  • stats_type (String, Symbol) —

    the type of stats to retrieve

  • *args (String, Symbol) —

    Stats parameter(s) (e.g. a macro name, bookmark ID, etc.)

Since:

  • 0.4.0



70
71
72
73
74
75
76
 
# File 'lib/glyph/analyzer.rb', line 70

def stats_for(stats_type, *args)
  begin
    send :"stats_#{stats_type}", *args 
  rescue NoMethodError => e
    raise RuntimeError, "Unable to calculate #{stats_type} stats"
  end
end

#with_macros(name = nil) {|n| ... } ⇒ Object

Iterator over specific macro instances

Parameters:

  • name (String, Symbol) (defaults to: nil) —

    the name of the macro definition (if left blank, iterates over all macro instances)

Yield Parameters:

Raises:

  • (ArgumentError)

Since:

  • 0.4.0



34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
 
# File 'lib/glyph/analyzer.rb', line 34

def with_macros(name=nil, &block)
  raise ArgumentError, "No block given" unless block_given?
  name = name.to_sym if name
  if !name then
    unless @macros.blank? then
      @macros.each(&block)
    else
      @doc.structure.descend do |n, level|
        if n.is_a?(Glyph::MacroNode) && n.source
          @macros << n
          macro_array_for(n[:name]) << n
          block.call n
        end
      end
    end
  else
    existing = @macros_by_def[name]
    if existing then
      existing.each(&block)
    else
      macros = []
      @doc.structure.descend do |n, level|
        if n.is_a?(Glyph::MacroNode) && macro_eq?(name, n[:name]) && n.source
          macros << n
          block.call n
        end
      end
      @macros_by_def[name] = macros
    end
  end
end