feat(mako): LICENSE + README.md

Readme is very initial, but the architecture is set to evolve it to
something no less than beatiful.

src/mako/LICENSE.md.mako

@@ -0,0 +1,26 @@
+## -*- coding: utf-8 -*-
+The MIT License (MIT)
+=====================
+
+Copyright © `${copyright.years}` ${', '.join("`%s`" % a for a in copyright.authors)}
+
+Permission is hereby granted, free of charge, to any person
+obtaining a copy of this software and associated documentation
+files (the “Software”), to deal in the Software without
+restriction, including without limitation the rights to use,
+copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the
+Software is furnished to do so, subject to the following
+conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
+OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
+HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+OTHER DEALINGS IN THE SOFTWARE.

src/mako/README.md.mako

@@ -0,0 +1,5 @@
+<%! import util %>\
+<%namespace name="lib" file="lib/lib.mako"/>\
+The `${util.library_name(name, version)}` library allows access to all features of *${canonicalName}*.
+
+<%lib:docs />

src/mako/deps.mako

@@ -1,15 +1,13 @@
 # DO NOT EDIT !
 # This file was generated automatically by '${self.uri}'
 # DO NOT EDIT !
-## ${util.to_api_version('v3')}
-## here <%util:to_api_version v="v3"/>
+
 <%api_info=[]%>\
 % for a in api.list:
 <%
 	import util
-	version = util.to_api_version(a.version)
-	gen_root = directories.output + '/' + a.name + version
-	api_name = a.name + version
+	gen_root = directories.output + '/' + a.name + util.to_api_version(a.version)
+	api_name = util.library_name(a.name, a.version)
 	api_clean = api_name + '-clean'
 	# source, destination of individual output files
 	sds = [(directories.mako_src + '/' + i.source + '.mako', gen_root + i.get('output_dir', '') + '/' + i.source) 

src/mako/lib/lib.mako

@@ -0,0 +1,3 @@
+<%def name="docs()">\
+TODO: Library level fully fledged documentation, incuding **summary** and **usage**.
+</%def>

src/mako/lib/util.py

@@ -11,3 +11,7 @@ def rdc(s):
 def to_api_version(v):
 	assert len(v) >= 2 and v[0] == 'v'
 	return v[1:]
+
+# build a full library name (non-canonical)
+def library_name(name, version):
+    return name + to_api_version(version)