Started working on the Spect Insert feature for automatic conversion of API calls into Language SDK.

Started with python first

- Added "Example_code in utils.rb"
- Added Switch statement for example_code
- implemented example_code.rb to hande logic for each language
- example_code.mustache for templating
- cat-allocation.md will be the starting test file

Author: Daniel Jackson

_api-reference/cat/cat-allocation.md

@@ -27,6 +27,29 @@ GET /_cat/allocation/{node_id}
 ```
 <!-- spec_insert_end -->
 
+<!-- spec_insert_start
+api: cat.allocation
+component: example_code
+query_params: v
+-->
+{% capture step1_rest %}
+GET /_cat/allocation?v
+{% endcapture %}
+
+{% capture step1_python %}
+response = client.cat.allocation(v: true)
+{% endcapture %}
+
+{% capture step1_javascript %}
+// TODO: add JS client call for cat.allocation
+{% endcapture %}
+
+{% include code-block.html
+  rest=step1_rest
+  python=step1_python
+  javascript=step1_javascript
+%}
+<!-- spec_insert_end -->
 
 <!-- spec_insert_start
 api: cat.allocation

spec-insert/lib/renderers/example_code.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+class ExampleCode < BaseMustacheRenderer
+  self.template_file = "#{__dir__}/templates/example_code.mustache"
+
+  def initialize(action, args)
+    super(action, args)
+  end
+
+  def query_params
+    @args.raw['query_params']&.split(',')&.map(&:strip) || []
+  end
+
+  def rest_code
+    method = @action.http_verbs.first.upcase rescue 'GET'
+    path = @action.urls.first rescue '/'
+    query = query_params
+    query_string = query.any? ? "?#{query.join('&')}" : ""
+    "#{method} #{path}#{query_string}"
+  end
+
+  def python_code
+    query = query_params
+    args = query.map { |k| "#{k}: true" }.join(', ')
+    "response = client.#{@action.full_name}(#{args})"
+  end
+
+  def javascript_code
+    "// TODO: add JS client call for #{@action.full_name}"
+  end
+end

spec-insert/lib/renderers/spec_insert.rb

@@ -7,6 +7,7 @@
 require_relative 'path_parameters'
 require_relative 'query_parameters'
 require_relative 'body_parameters'
+require_relative 'example_code'
 
 # Class to render spec insertions
 class SpecInsert < BaseMustacheRenderer
@@ -40,8 +41,10 @@ def content
       BodyParameters.new(@action, @args, is_request: true).render
     when :response_body_parameters
       BodyParameters.new(@action, @args, is_request: false).render
+    when :example_code
+      ExampleCode.new(@action, @args).render
     else
-      raise SpecInsertError, "Invalid component: #{@args.component}"
+      raise SpecInsertError, "Invalid component: #{@args.component}, from spec_insert.rb "
     end
   end
 end

spec-insert/lib/renderers/templates/example_code.mustache

@@ -0,0 +1,17 @@
+{% capture step1_rest %}
+{{{rest_code}}}
+{% endcapture %}
+
+{% capture step1_python %}
+{{{python_code}}}
+{% endcapture %}
+
+{% capture step1_javascript %}
+{{{javascript_code}}}
+{% endcapture %}
+
+{% include code-block.html
+  rest=step1_rest
+  python=step1_python
+  javascript=step1_javascript
+%}

spec-insert/lib/utils.rb

@@ -13,7 +13,8 @@ module Utils
     'query_parameters' => 'Query Parameters',
     'path_parameters' => 'Path Parameters',
     'request_body_parameters' => 'Request Body Parameters',
-    'response_body_parameters' => 'Response Body Parameters'
+    'response_body_parameters' => 'Response Body Parameters',
+    'example_code' => 'Example Code'
   }.freeze
 
   # @return [Array<String>] list of markdown files to insert the spec components into