small changes to the scripts, add module example

scripts/CoTeTo-cli.py

@@ -4,6 +4,9 @@
 # This file is part of CoTeTo - a code generation tool
 # 20170602 Joerg Raedler [email protected]
 #
+# This is the commandline interface to CoTeTo.
+# Run `python CoTeTo-cli.py --help` to get help on the 
+# commandline options and arguements
 
 import os
 import sys

scripts/CoTeTo-gui.py

@@ -4,6 +4,9 @@
 # This file is part of CoTeTo - a code generation tool
 # 20170602 Joerg Raedler [email protected]
 #
+# This is the graphical user interface to CoTeTo.
+# Run `python CoTeTo-gui.py --help` to get help on the 
+# commandline options and arguements
 
 import os
 import sys

scripts/CoTeTo-module.py

@@ -0,0 +1,37 @@
+#!/usr/bin/env python
+#-*- coding:utf-8 -*-
+#
+# This file is part of CoTeTo - a code generation tool
+# 20190411 Joerg Raedler [email protected]
+#
+# This is an example of the usage of CoTeTo as a python module.
+# 
+
+import os
+import sys
+
+# check if we are running in the development folder -
+# just a hack to run this script without installing CoTeTo first -
+# usually not needed for users
+parent = os.path.dirname(os.path.dirname(os.path.realpath(__file__)))
+if os.path.isfile(os.path.join(parent, 'setup.py')):
+    sys.path.insert(0, parent)
+
+#### Example Code 
+
+# 1. import the controller class from CoTeTo
+from CoTeTo.Controller import Controller
+
+# 2. initialize a controller instance
+# for a list of optional arguments see CoTeTo/Controller.py
+con = Controller()
+
+# 3. choose a generator ...
+# a list of available generators can be printed with print(con.generators.keys())
+gen = con.generators['Example01Mako::1.0']
+
+# 4. ... and execute it!
+# arguments are:
+#   a list of input URIs (not used with the dummy loader)
+#   a filename or prefix for the output
+gen.execute(('spam', ), 'ModuleTestOutput.txt')