Add generation preprocess step to make OperationIDs simpler

Author: mbohlool

GEN_README.md

@@ -0,0 +1,38 @@
+# Kubernetes Python Client
+
+Python clients for talking to a [kubernetes](http://kubernetes.io/) cluster.
+
+## Example
+
+```python
+from __future__ import absolute_import
+
+import k8sutil
+import k8sclient
+import os
+
+# Configs can be set in Configuration class directly or using helper utility
+k8sutil.load_kube_config(os.environ["HOME"] + '/.kube/config')
+
+# Prior to python 3.4 hosts with ip-addresses cannot be verified for SSL. this
+# utility function fixes that.
+k8sutil.fix_ssl_hosts_with_ipaddress()
+
+v1=k8sclient.CoreV1Api()
+print "Listing pods with their IPs:"
+ret = v1.list_pod_for_all_namespaces()
+for i in ret.items:
+  print "%s\t%s\t%s" % (i.status.pod_ip, i.metadata.namespace, i.metadata.name)
+```
+
+More examples can be found in [examples](examples/) folder. To run examples, run this command:
+
+```shell
+python -m examples.example1
+```
+
+(replace example1 with the example base filename)
+
+# Generated client README
+
+

README.md

@@ -47,17 +47,22 @@ if [[ ! -n ${SWAGGER_FILE-} ]]; then
   SWAGGER_FILE="${KUBE_ROOT}/api/openapi-spec/swagger.json"
 fi
 
+echo "--- Preprocessing OpenAPI spec to script directory"
+python "${SCRIPT_ROOT}/preprocess_spec.py" "$SWAGGER_FILE" "${SCRIPT_ROOT}/swagger.json"
+
 echo "--- Cleaning up previously generated folders"
 rm -rf "${CLIENT_ROOT}/${PACKAGE_NAME}"
 rm -rf "${CLIENT_ROOT}/docs"
 rm -rf "${CLIENT_ROOT}/test"
 
 echo "--- Generating client ..."
-mvn -f "${SCRIPT_ROOT}/pom.xml" clean generate-sources -Dgenerator.spec.path="${SWAGGER_FILE}" -Dgenerator.output.path="${CLIENT_ROOT}" -Dgenerator.package.name=${PACKAGE_NAME}
+mvn -f "${SCRIPT_ROOT}/pom.xml" clean generate-sources -Dgenerator.spec.path="${SCRIPT_ROOT}/swagger.json" -Dgenerator.output.path="${CLIENT_ROOT}" -Dgenerator.package.name=${PACKAGE_NAME}
 
 echo "--- Patching generated code..."
-cp "${CLIENT_ROOT}/README.md" "${CLIENT_ROOT}/GEN_README.md"
-cp "${SCRIPT_ROOT}/ROOT_README.md" "${CLIENT_ROOT}/README.md"
+cat "${CLIENT_ROOT}/README.prefix" "${CLIENT_ROOT}/README.md" > "${CLIENT_ROOT}/README.new"
+rm "${CLIENT_ROOT}/README.md"
+mv "${CLIENT_ROOT}/README.new" "${CLIENT_ROOT}/README.md"
 cp "${SCRIPT_ROOT}/LICENSE" "${CLIENT_ROOT}"
 rm -rf "${CLIENT_ROOT}/test"
+
 echo "---Done."

README.prefix

@@ -0,0 +1,51 @@
+import json
+import os.path
+import sys
+from collections import OrderedDict
+
+_ops = ['get', 'put', 'post', 'delete', 'options', 'head', 'patch']
+
+
+def _title(s):
+    if len(s) == 0:
+        return s
+    return s[0].upper() + s[1:]
+
+
+def _to_camel_case(s):
+    return ''.join(_title(y) for y in s.split("_"))
+
+
+def iterate_through_operations(spec, func):
+    for k, v in spec['paths'].iteritems():
+        for op in _ops:
+            if op in v:
+                func(v[op])
+
+
+def process_swagger(infile, outfile):
+    with open(infile, 'r') as f:
+        spec = json.load(f, object_pairs_hook=OrderedDict)
+
+        def strip_tags_from_operation_id(operation):
+            operation_id = operation['operationId']
+            for t in operation['tags']:
+                operation_id = operation_id.replace(_to_camel_case(t), '')
+            operation['operationId'] = operation_id
+
+        iterate_through_operations(spec, strip_tags_from_operation_id)
+
+        with open(outfile, 'w') as out:
+            json.dump(spec, out, sort_keys=False, indent=2,
+                      separators=(',', ': '), ensure_ascii=True)
+
+
+def main():
+    if len(sys.argv) < 3:
+        print "Usage:\n\tpython %s infile outfile.\n" % sys.argv[0]
+        sys.exit(0)
+    if not os.path.isfile(sys.argv[1]):
+        print "Input file %s does not exist." % sys.argv[1]
+    process_swagger(sys.argv[1], sys.argv[2])
+
+main()