feature: add Module.print_hierarchy

Adding a new Module method that prints the hierarchy. Useful for visualising
the structure of a module.

migen/fhdl/module.py

@@ -183,3 +183,23 @@ def do_finalize(self):
     def do_exit(self, *args, **kwargs):
         for name, submodule in self._submodules:
             submodule.do_exit(*args, **kwargs)
+
+    def print_hierarchy(self, include_anon=False):
+        """Prints a hierarchy tree for the Module.
+        
+        This method iterates over each submodule in the design and prints out an 
+        indented hierarchy. By default it ignores any anonymous modules but this can be 
+        overridden by passing include_anon=True.
+        
+        """
+        print(self.__class__.__name__)
+        self._iter_submodules(self, indent=4, include_anon=include_anon)
+
+    def _iter_submodules(self, module, indent, include_anon):
+        for name, submodule in module._submodules:
+            if name is None:
+                if not include_anon:
+                    continue
+                name = "anon"
+            print("{}{}:{}".format(" " * indent, name, submodule.__class__.__name__))
+            self._iter_submodules(submodule, indent=indent+4)