feat(mako): cargo.toml template

It's quite final, and super easy to change and to read.

It seems we want to use namespaces/shared implementations soon to allow
using defs. In our case, we transform the version in a particular way,
which is easy enough, yet I'd like to use it to make the system more
powerful.

etc/api/shared.yaml

@@ -1,13 +1,13 @@
 # Contains values shared among all API implementations
 directories:
   # directory under which all generated sources should reside
-  output: ./generated
+  output: generated
   # how to get from `output` back to common library
   common: ../
   # where are all the API meta files
-  api_base: ./etc/api
+  api_base: etc/api
   # all mako source files
-  mako_src: ./src/mako
+  mako_src: src/mako
 api:
   list:
     - name: youtube
@@ -19,8 +19,10 @@ api:
       # output_dir:  optional - not there if unset
 cargo:
   build_version: "0.0.1"
+  repo_base_url: https://github.com/Byron/youtube-rs
+  doc_base_url: http://byron.github.io/youtube-rs
   authors:
     - Sebastian Thiel <byronimo@gmail>
-  keywords: [google, protocol]
+  keywords: [google, protocol, web, api]
   # All APIs should live in the same repository
   repository_url: https://github.com/Byron/youtube-rs

src/mako/cargo.toml.mako

@@ -1,12 +1,14 @@
 [package]
 
-name = "youtube3-dev"
-version = "0.0.1"
-authors = ["Sebastian Thiel <byronimo@gmail.com>"]
-description = "A library to facilitate interacting with your youtube account"
-repository = "https://github.com/Byron/youtube-rs"
+name = "${name}${version[1:]}"
+version = "${cargo.build_version}"
+authors = [${",\n           ".join('"%s"' % a for a in cargo.authors)}]
+description = "A library to interact with ${canonicalName} (protocol ${version})"
+repository = "${cargo.repo_base_url}/${OUTPUT_DIR}"
+homepage = "${documentationLink}"
+documentation = "${cargo.doc_base_url}"
 license = "MIT"
-keywords = ["youtube", "google", "protocol"]
+keywords = ["${name}", ${", ".join('"%s"' % k for k in cargo.keywords)}]
 
 [dependencies]
 # Just to get hyper to work !

src/mako/deps.mako

@@ -5,7 +5,7 @@
 <%api_info=[]%>\
 % for a in api.list:
 <%
-	gen_root = directories.output + '/' + a.name + '_' + a.version
+	gen_root = directories.output + '/' + a.name + a.version[1:]
 	api_name = a.name + a.version
 	api_clean = api_name + '-clean'
 	# source, destination
@@ -17,7 +17,7 @@
 %>\
 ${gen_root}: ${' '.join(i[0] for i in sds)} ${api_json_inputs}
 	@mkdir -p $@
-	$(TPL) -io ${' '.join("%s=%s" % (s, d) for s, d in sds)} --data-files ${api_json_inputs}
+	$(TPL) --var OUTPUT_DIR=$@ -io ${' '.join("%s=%s" % (s, d) for s, d in sds)} --data-files ${api_json_inputs}
 
 ${api_name}: ${gen_root}