Implementing a visual representation of a node size (#30)

Fixes #29.

* Add MacOS .DS_Store file to ignore

* Add minimum width and height proportional to the number of lines in each node. See https://www.graphviz.org/doc/info/shapes.html

* - Add MAX_NODE_WIDTH as a limit
- UpdateSize() is the new method that will update both the width and the height (width / 2). If width exceeds MAX_NODE_WIDTH, the latter will become the new value and thus height will be half of it

* The following changes are made:
- MAX_NODE is set to 5 times NODE_WIDTH_FACTOR.
- Dimensions are rounded up to one decimal digit so as to get more regular ellipses.

* Add flag "--represent-node-size" to enable the relative feature

Remove int cast because we need a rounded number to one decimal digit

* Distribute node size between their min and max values

Add flag "--min-node-size" and "--max-node-size" to select min and max sizes from the command line

* Change math.inf to float(inf) for better legacy support

* Add command line arguements to choose size of nodes

* Add node size check so it is never less than 0

* Change formula so as to make it follow the distribution of node sizes more evenly

* Add scaling factor (FONT_SCALE_FACTOR) to resize font according to node width

* Fix a typo in core.py line 55 that failed unit tests

* Move constants to callgraph.py and adds logic to handle None values

* Remove min_node_loc and node_loc_std as they are not used

* Change to font_scale_factor as constant is defined in callgraph.py

* Make min_node_size, max_node_size, font_scale_factor optional by setting their defaults to None but actually calling them with the provided values

Set default values in function definition to default numbers to make checks work

Author: RiccardoMPesce

.gitignore

@@ -1,3 +1,6 @@
+# MacOS Files
+.DS_Store
+
 # Byte-compiled / optimized / DLL files
 __pycache__/
 *.py[cod]
@@ -109,4 +112,4 @@ venv.bak/
 *.un~
 
 # Visual Studio Code
-.vscode
+.vscode

callgraph/callgraph.py

@@ -10,6 +10,9 @@
 from . import core
 from . import render
 
+DEFAULT_MIN_NODE_SIZE = 3
+DEFAULT_MAX_NODE_SIZE = 7
+DEFAULT_FONT_SCALE_FACTOR = 7
 
 def main():
     parser = argparse.ArgumentParser()
@@ -29,6 +32,13 @@ def main():
                         type=str)
     parser.add_argument("-l", "--log-file", help="Log file. If it's not set, stderr is used.",
                         type=str, dest="logfile")
+    parser.add_argument("--represent-node-size",
+                        help="Nodes' size will be proportional to the number of lines they contain.",
+                        action="store_true", dest="nodesize")
+    parser.add_argument("--min-node-size", help="Set minimum rendered node size.", 
+                        dest="min_node_size", action="store", type=int, default=None)
+    parser.add_argument("--max-node-size", help="Set maximum rendered node size.", 
+                        dest="max_node_size", action="store", type=int, default=None)
 
     args = parser.parse_args()
 
@@ -63,10 +73,22 @@ def main():
             print(u"Error opening {}: {}".format(args.output, e), file=sys.stderr)
             sys.exit(1)
 
+    if args.min_node_size == None:
+        args.min_node_size = DEFAULT_MIN_NODE_SIZE
+
+    if args.max_node_size == None:
+        args.max_node_size = DEFAULT_MAX_NODE_SIZE
+
+    if args.min_node_size > args.max_node_size:
+        print("Minimum node size should be less than maximum node size")
+        sys.exit(1)
+
     try:
         call_graph = core.CallGraph.Build(input_file, log_file=log_file)
-        render.PrintDot(call_graph, output_file, log_file=log_file, show_all_calls=args.allcalls,
-                 show_node_stats=args.nodestats, nodes_to_hide=nodes_to_hide)
+        render.PrintDot(call_graph, out_file=output_file, log_file=log_file, show_all_calls=args.allcalls,          
+                        show_node_stats=args.nodestats, nodes_to_hide=nodes_to_hide, represent_node_size=args.nodesize, 
+                        min_node_size=args.min_node_size, max_node_size=args.max_node_size, 
+                        font_scale_factor=DEFAULT_FONT_SCALE_FACTOR)
     except Exception as e:
         print(u"Error processing the call graph: {}".format(e))