Add missing api example for incremental backups

* Added Incremental backup test and resulting sample files.
* Fixed the example generator tests to actually fail when api
  changes.
* Added changes since the last example generation was run.
* Added a --fix-examples flag to the example generator to
  automatically correct the sample files.

Change-Id: I7ac355c80b251b0eccd3bd5b8d76d2287c255705
Closes-Bug: #1398119

1 files changed, 31 insertions, 0 deletions

diff --git a/generate_examples.py b/generate_examples.py
index ff9bcd08..afe14e6c 100644..100755
--- a/generate_examples.py
+++ b/generate_examples.py
@@ -1,4 +1,24 @@
+#!/usr/bin/env python
+
+# Copyright 2014 OpenStack Foundation
+#
+#    Licensed under the Apache License, Version 2.0 (the "License"); you may
+#    not use this file except in compliance with the License. You may obtain
+#    a copy of the License at
+#
+#         http://www.apache.org/licenses/LICENSE-2.0
+#
+#    Unless required by applicable law or agreed to in writing, software
+#    distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+#    WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+#    License for the specific language governing permissions and limitations
+#    under the License.
+#
+
 import run_tests
+import argparse
+import os
+import sys
 
 
 def import_tests():
@@ -7,4 +27,15 @@ def import_tests():
 
 
 if __name__ == "__main__":
+    parser = argparse.ArgumentParser(description='Generate Example Snippets')
+    parser.add_argument('--fix-examples', action='store_true',
+                        help='Fix the examples rather than failing tests.')
+
+    args = parser.parse_args()
+    if args.fix_examples:
+        os.environ['TESTS_FIX_EXAMPLES'] = 'True'
+        # Remove the '--fix-examples' argument from sys.argv as it is not a
+        # valid argument in the run_tests module.
+        sys.argv.pop(sys.argv.index('--fix-examples'))
+
     run_tests.main(import_tests)