Class: RDoc::Diagram
- Inherits:
-
Object
- Object
- RDoc::Diagram
- Defined in:
- lib/rdoc/diagram.rb
Overview
Draw a set of diagrams representing the modules and classes in the system. We draw one diagram for each file, and one for each toplevel class or module. This means there will be overlap. However, it also means that you'll get better context for objects.
To use, simply
d = Diagram.new(info) # pass in collection of top level infos
d.draw
The results will be written to the dot
subdirectory. The process also sets the diagram
attribute in each object it graphs to the name of the file containing the image. This can be used by output generators to insert images.
Constant Summary collapse
- FONT =
"Arial"
- DOT_PATH =
"dot"
Instance Method Summary collapse
-
#draw ⇒ Object
Draw the diagrams.
-
#initialize(info, options) ⇒ Diagram
constructor
Pass in the set of top level objects.
Constructor Details
#initialize(info, options) ⇒ Diagram
Pass in the set of top level objects. The method also creates the subdirectory to hold the images
36 37 38 39 40 41 42 |
# File 'lib/rdoc/diagram.rb', line 36 def initialize(info, ) @info = info @options = @counter = 0 File.makedirs(DOT_PATH) @diagram_cache = {} end |
Instance Method Details
#draw ⇒ Object
Draw the diagrams. We traverse the files, drawing a diagram for each. We also traverse each top-level class and module in that file drawing a diagram for these too.
48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 |
# File 'lib/rdoc/diagram.rb', line 48 def draw unless @options.quiet $stderr.print "Diagrams: " $stderr.flush end @info.each_with_index do |i, file_count| @done_modules = {} @local_names = find_names(i) @global_names = [] @global_graph = graph = DOT::DOTDigraph.new('name' => 'TopLevel', 'fontname' => FONT, 'fontsize' => '8', 'bgcolor' => 'lightcyan1', 'compound' => 'true') # it's a little hack %) i'm too lazy to create a separate class # for default node graph << DOT::DOTNode.new('name' => 'node', 'fontname' => FONT, 'color' => 'black', 'fontsize' => 8) i.modules.each do |mod| draw_module(mod, graph, true, i.file_relative_name) end add_classes(i, graph, i.file_relative_name) i.diagram = convert_to_png("f_#{file_count}", graph) # now go through and document each top level class and # module independently i.modules.each_with_index do |mod, count| @done_modules = {} @local_names = find_names(mod) @global_names = [] @global_graph = graph = DOT::DOTDigraph.new('name' => 'TopLevel', 'fontname' => FONT, 'fontsize' => '8', 'bgcolor' => 'lightcyan1', 'compound' => 'true') graph << DOT::DOTNode.new('name' => 'node', 'fontname' => FONT, 'color' => 'black', 'fontsize' => 8) draw_module(mod, graph, true) mod.diagram = convert_to_png("m_#{file_count}_#{count}", graph) end end $stderr.puts unless @options.quiet end |