allow loading of other k8s API implementations

Refactor to move all code generated from swagger spec into a separate module, named `ApiImpl`.
`KuberContext` now optionally takes a module reference to load APIs from. It defaults to the one bundled in Kuber.jl - `ApiImpl`, but can be replaced with a different module when `KuberContext` is constructed. This will let Kuber.jl be used with code generated for a different Kubernetes API version, or for a spec with custom APIs (e.g. for CRDs).

Author: tanmaykm

codecov.yml

@@ -0,0 +1,2 @@
+ignore:
+- "src/ApiImpl"

gen/genapialiases.jl

@@ -127,7 +127,7 @@ end
 
 function main()
     DIR = dirname(@__FILE__)
-    gen_aliases(joinpath(DIR, "../src/api"), joinpath(DIR, "../src/apialiases.jl"))
+    gen_aliases(joinpath(DIR, "../src/ApiImpl/api"), joinpath(DIR, "../src/ApiImpl/apialiases.jl"))
 end
 
 main()

gen/generate.sh

@@ -7,8 +7,8 @@ if [ $# -ne 1 ]; then
     echo "  - package directory is writable."
     echo "  - CSTParser v2.1.0 is installed."
     echo "Note:"
-    echo "  - your current 'src/api' folder in the package will be renamed to 'src/api_bak'"
-    echo "  - existing 'src/api_bak' folder if any will be deleted"
+    echo "  - your current 'src/ApiImpl/api' folder in the package will be renamed to 'src/ApiImpl/api_bak'"
+    echo "  - existing 'src/ApiImpl/api_bak' folder if any will be deleted"
     echo "Ref:"
     echo "  - API conventions: https://github.com/kubernetes/community/blob/master/contributors/devel/api-conventions.md"
     echo "  - API: https://kubernetes.io/docs/concepts/overview/kubernetes-api/"
@@ -40,17 +40,17 @@ echo "Swagger is at $SWAGGERDIR"
 echo "Generating into $TEMPGENDIR, moving into $GENDIR"
 mkdir -p ${TEMPGENDIR}
 ${SWAGGERDIR}/plugin/generate.sh -i ${SPECDIR}/${SPECFILE} -o ${TEMPGENDIR} -c ${DIR}/config.json
-rm -rf ${GENDIR}/src/api_bak
-mv ${GENDIR}/src/api ${GENDIR}/src/api_bak
-mkdir ${GENDIR}/src/api
-mv ${TEMPGENDIR}/src/* ${GENDIR}/src/api/
+rm -rf ${GENDIR}/src/ApiImpl/api_bak
+mv ${GENDIR}/src/ApiImpl/api ${GENDIR}/src/ApiImpl/api_bak
+mkdir ${GENDIR}/src/ApiImpl/api
+mv ${TEMPGENDIR}/src/* ${GENDIR}/src/ApiImpl/api/
 rm ${TEMPGENDIR}/LICENSE
 rm -r ${TEMPGENDIR}
 
 ${JULIA} ${DIR}/genapialiases.jl
 ${JULIA} ${DIR}/gentypealiases.jl
 
 # the following models are not generated correctly by Swagger, hand code them for now
-cp ${DIR}/model_IoK8sApimachineryPkgApisMetaV1Time.jl ${GENDIR}/src/api/
-cp ${DIR}/model_IoK8sApimachineryPkgUtilIntstrIntOrString.jl ${GENDIR}/src/api/
-cp ${DIR}/model_IoK8sApimachineryPkgApisMetaV1WatchEvent.jl ${GENDIR}/src/api/
+cp ${DIR}/model_IoK8sApimachineryPkgApisMetaV1Time.jl ${GENDIR}/src/ApiImpl/api/
+cp ${DIR}/model_IoK8sApimachineryPkgUtilIntstrIntOrString.jl ${GENDIR}/src/ApiImpl/api/
+cp ${DIR}/model_IoK8sApimachineryPkgApisMetaV1WatchEvent.jl ${GENDIR}/src/ApiImpl/api/

gen/gentypealiases.jl

@@ -202,7 +202,7 @@ end
 
 function main()
     DIR = dirname(@__FILE__)
-    gen_aliases(joinpath(DIR, "../src/api"), joinpath(DIR, "../src/typealiases.jl"))
+    gen_aliases(joinpath(DIR, "../src/ApiImpl/api"), joinpath(DIR, "../src/ApiImpl/typealiases.jl"))
 end
 
 main()

src/ApiImpl/.gitignore

@@ -0,0 +1 @@
+api_bak

src/ApiImpl/ApiImpl.jl

@@ -0,0 +1,15 @@
+module ApiImpl
+
+using Swagger
+
+include("api/Kubernetes.jl")
+using .Kubernetes
+import .Kubernetes: getAPIVersions
+
+import Base: convert, get, put!, delete!, show
+import Swagger: SwaggerModel
+
+include("typealiases.jl")
+include("apialiases.jl")
+
+end # module