feat(doc): def for DO NOT EDIT comments

A note like that is now added to all files we generated, commented out
depending on the file type.

Quite neat, except that for filtering, I always have to use blocks.

Author: Byron

gen/youtube3/LICENSE.md

@@ -1,3 +1,8 @@
+<!---
+DO NOT EDIT !
+This file was generated automatically from 'src/mako/LICENSE.md.mako'
+DO NOT EDIT !
+-->
 The MIT License (MIT)
 =====================
 

gen/youtube3/README.md

@@ -1,3 +1,8 @@
+<!---
+DO NOT EDIT !
+This file was generated automatically from 'src/mako/README.md.mako'
+DO NOT EDIT !
+-->
 The `youtube3` library allows access to all features of *YouTube*.
 
 TODO: Library level fully fledged documentation, incuding **summary** and **usage**.

gen/youtube3/cargo.toml

@@ -1,5 +1,5 @@
 # DO NOT EDIT !
-# This file was generated automatically by 'src/mako/cargo.toml.mako'
+# This file was generated automatically from 'src/mako/cargo.toml.mako'
 # DO NOT EDIT !
 [package]
 

gen/youtube3/src/cmn.rs

@@ -0,0 +1,21 @@
+// COPY OF 'src/rust/cmn.rs'
+// DO NOT EDIT
+use std::marker::MarkerTrait;
+
+/// Identifies types which can be inserted and deleted.
+/// Types with this trait are most commonly used by clients of this API.
+pub trait Resource: MarkerTrait {}
+
+/// Identifies types which are used in API responses.
+pub trait ResponseResult: MarkerTrait {}
+
+/// Identifies types which are used in API requests.
+pub trait RequestResult: MarkerTrait {}
+
+/// Identifies types which are only used as part of other types, which 
+/// usually are carrying the `Resource` trait.
+pub trait Part: MarkerTrait {}
+
+/// Identifies types which are only used by other types internally.
+/// They have no special meaning, this trait just marks them for completeness.
+pub trait NestedType: MarkerTrait {}

gen/youtube3/src/lib.rs

@@ -1,3 +1,7 @@
+// DO NOT EDIT !
+// This file was generated automatically from 'src/mako/lib.rs.mako'
+// DO NOT EDIT !
+
 //! TODO: Library level fully fledged documentation, incuding **summary** and **usage**.
 //! And another line, for testing
 //! 

src/mako/LICENSE.md.mako

@@ -1,5 +1,9 @@
 ## -*- coding: utf-8 -*-
 <%! import util %>\
+<%namespace name="mutil" file="lib/util.mako"/>\
+<%block filter="util.markdown_comment">\
+<%mutil:gen_info source="${self.uri}" />\
+</%block>
 The MIT License (MIT)
 =====================
 

src/mako/README.md.mako

@@ -1,5 +1,9 @@
+<%! import util as pyutil %>\
 <%namespace name="lib" file="lib/lib.mako"/>\
 <%namespace name="util" file="lib/util.mako"/>\
+<%block filter="pyutil.markdown_comment">\
+<%util:gen_info source="${self.uri}" />\
+</%block>
 The `${util.library_name()}` library allows access to all features of *${canonicalName}*.
 
 <%lib:docs />

src/mako/cargo.toml.mako

@@ -1,8 +1,8 @@
 <%! import util %>\
 <%namespace name="mutil" file="lib/util.mako"/>\
-# DO NOT EDIT !
-# This file was generated automatically by '${self.uri}'
-# DO NOT EDIT !
+<%block filter="util.hash_comment">\
+<%mutil:gen_info source="${self.uri}" />\
+</%block>
 [package]
 
 name = "${mutil.library_name()}"

src/mako/deps.mako

@@ -18,8 +18,10 @@
 	api_json_inputs = api_json + " $(API_SHARED_INFO)"
 	api_info.append((api_name, api_clean, gen_root))
 %>\
-${api_common}: $(RUST_SRC)/cmn.rs
-	@cp $< $@
+${api_common}: $(RUST_SRC)/cmn.rs $(lastword $(MAKEFILE_LIST))
+	@ echo "// COPY OF '$<'"  > $@
+	@ echo "// DO NOT EDIT"  >> $@
+	@cat $< >> $@
 
 ${gen_root_stamp}: ${' '.join(i[0] for i in sds)} ${api_json_inputs} $(MAKO_LIB_FILES) $(MAKO_RENDER)
 	PYTHONPATH=$(MAKO_LIB_DIR) $(TPL) --template-dir '.' --var OUTPUT_DIR=$@ -io ${' '.join("%s=%s" % (s, d) for s, d in sds)} --data-files ${api_json_inputs}

src/mako/lib.rs.mako

@@ -8,6 +8,10 @@
 <%namespace name="lib" file="lib/lib.mako"/>\
 <%namespace name="mutil" file="lib/util.mako"/>\
 <%namespace name="schema" file="lib/schema.mako"/>\
+<%block filter="util.rust_comment">\
+<%mutil:gen_info source="${self.uri}" />\
+</%block>
+
 <%block filter="util.rust_module_doc_comment">\
 <%lib:docs />\
 </%block>