red-api 0.1.6 → 0.1.9

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 53151d9692ecd31e415aa6c4387158e6da25fed70a4cc7f99a352efb93d7ab04
-  data.tar.gz: 28215493dd8a9875435176dd4a7848db788d375c2f716d714bf09f8fb1d7c6b7
+  metadata.gz: 46c471a9c123c2bcd52de3e2459f7d282b83172a2c75f54fd4240e9931a80a54
+  data.tar.gz: 3202e5fdff5882c142d9173e593254c09767c67e9aac33765905f4b5eba44274
 SHA512:
-  metadata.gz: 1dc400ed3600883b143b7be98621626b3d2cb9c501e0b4e6d0ff4275b91d6d3f9abc8cf478391539a75299d1d8b11702ed9387b830b2d7daa338cefbe1badcd7
-  data.tar.gz: be49041456dea4b2e2d5460333cc6755877a7b2ed006e285db24e289d4a4903e5e3d984b7990feeeaad8533b375e9b2902417971592ff73aad5e1a46bb394d48
+  metadata.gz: 12c9cb3aff98022cc14e545b56dc2388df0ae536bb818b0779dbaa6b6f8de7a8f4260f7ebb61e9dbb6cbab657949988618b3755ff60515f844a543049b3374c9
+  data.tar.gz: 8ca0ef18944bbf57e5ec00c9a05d81a3ca8c5a3ea1ecb5fffdc4602066e4959371953b95a3d31ab30030760965d97164b63f05fbae2f24ade06936707533616e

data/lib/generators/endpoint/USAGE

@@ -1,8 +1,15 @@
 Description:
-    Adds an endpoint api call to your generated API service with optional method params (not to be confused with the api endpoint params)
+    Adds an endpoint api call to your generated API service with optional endpoint method and endpoint helper method parameters
 
 Example:
-    rails generate endpoint ServiceName EndpointName /endpoint/#{param1}/#{param2} --method_params param1 param2
+    rails generate endpoint ServiceName version EndpointName /endpoint/#{param1}/#{param2} --method-params param1 param2 --helper-params param1 param2
+    
+    Simple Form:
+      rails generate endpoint ServiceName V1 EndpointName /endpoint
 
     This will create:
-        app/services/ServiceName/api_call/endpoint_name.rb
+        app/services/ServiceName/version/api_call/endpoint_name.rb
+
+    This will modify:
+        app/services/ServiceName/version/api_endpoints.rb
+        app/services/ServiceName/version/endpoint_helpers.rb

data/lib/generators/endpoint/endpoint_generator.rb

@@ -2,45 +2,87 @@ class EndpointGenerator < Rails::Generators::NamedBase
   source_root File.expand_path('templates', __dir__)
 
   argument :endpoint_name, type: :string
+  argument :api_version, type: :string
   argument :endpoint, type: :string
-  class_option :method, type: :string, default: :get
-  class_option :method_params, type: :array
 
+  class_option :method, type: :string, default: :get
+  class_option :endpoint_params, type: :array
+  class_option :helper_params, type: :array
+  
   def create_api_call
-    @api_name = endpoint_name
+    @api_service = file_name.underscore
+    @api_version = api_version
+    @endpoint_name = endpoint_name
     @endpoint = endpoint
-    @endpoint = @endpoint[1..] if @endpoint.first == '/'
-    @method = options[:method].to_sym
 
-    if options[:method_params].present?
-      @method_params = options[:method_params][0..-2].each_with_object('') do |p, str|
-        str << p << ', '
+    raise ArgumentError 'Endpoint name required' unless @endpoint_name
+    raise ArgumentError 'Endpoint is required' unless @endpoint
+
+    @endpoint_reference = @api_service.camelize + '::' + @api_version.camelize + '::ApiEndpoints'
+    @full_endpoint_reference = @endpoint_reference + '.' + @endpoint_name.underscore
+
+    @endpoint = @endpoint[1..] unless @endpoint.first == '/'
+    @method = options[:method].to_sym unless options[:method]
+
+    create_endpoint_params unless options[:endpoint_params]
+    create_helper_params unless options[:helper_params]
+
+    spec_file_name = @endpoint_name.underscore + '_spec.rb';
+    spec_dir = 'spec/services/'
+    spec_api_dir = spec_dir + @api_service.underscore + '/'
+    service_version_dir = spec_api_dir + @api_version + '/'
+
+    Dir.mkdir spec_dir unless File.exist?(spec_dir)
+    Dir.mkdir spec_api_dir unless File.exist?(spec_api_dir)
+    Dir.mkdir service_version_dir unless File.exist?(service_version_dir)
+
+    spec_file_path = service_version_dir + spec_file_name
+
+    unless File.exist? spec_file_path
+      template 'endpoint_spec.erb', spec_file_path
+    else
+      end_point_test = ERB.new load_template('endpoint_test.erb')
+      inject_into_file spec_file_path, after: "  # API Endpoint tests\n" do
+        end_point_test.result(binding)
       end
-      @method_params << options[:method_params].last
     end
 
-    @api_service = file_name.underscore
     service_dir_path = "app/services/#{@api_service}/"
+    service_api_version_path = service_dir_path + @api_version + '/'
 
-    template 'api_call.erb', service_dir_path + "api_calls/#{@api_name.underscore}.rb"
+    template 'api_call.erb', service_api_version_path + "api_calls/#{@endpoint_name.underscore}.rb"
 
-    temp = ERB.new <<-'EOF'
-
-  def <%= @api_name.underscore%>_endpoint<%="(#{@method_params})" if @method_params.present?%>
-    <%= "\"#{@endpoint}\".freeze" if @endpoint.present? %>
-  end
-    EOF
+    api_call_file = ERB.new load_template('endpoint_helper.erb')
     
-    inject_into_file service_dir_path + 'endpoint_helpers.rb', after: "  # API Endpoint Helpers\n" do
-      temp.result(binding)
+    inject_into_file service_api_version_path + 'endpoint_helpers.rb', after: "  # API Endpoint Helpers\n" do
+      api_call_file.result(binding)
+    end
+
+    mixin = ERB.new load_template('mixin.erb')
+
+    inject_into_file service_api_version_path + 'api_endpoints.rb', after: "  # API call modules\n" do
+      mixin.result(binding)
     end
+  end
 
-    temp = ERB.new <<-'EOF'
-  extend <%= @api_name.camelize%>
-    EOF
+  private
+
+  def load_template(template_file)
+    template_path = File.join(File.dirname(__FILE__), 'templates/' + template_file)
+    File.read(template_path)
+  end
+
+  def create_helper_params
+    @endpoint_params = options[:helper_params][0..-2].each_with_object('') do |p, str|
+      str << p << ', '
+    end
+    @endpoint_params << options[:helper_params].last
+  end
 
-    inject_into_file service_dir_path + 'api_endpoints.rb', after: "  # API call modules\n" do
-      temp.result(binding)
+  def create_endpoint_params
+    @endpoint_params = options[:endpoint_params][0..-2].each_with_object('') do |p, str|
+      str << p << ', '
     end
+    @endpoint_params << options[:endpoint_params].last
   end
 end

data/lib/generators/endpoint/templates/api_call.erb

@@ -1,5 +1,5 @@
-module <%= @api_name.camelize%>
-  def <%= @api_name.underscore%><%="(#{@method_params})" if @method_params.present?%>
-    request :<%= @method%>, <%= @api_name.underscore%>_endpoint<%="(#{@method_params})" if @method_params.present?%>, params: {}
+module <%= @endpoint_name.camelize%>
+  def <%= @endpoint_name.underscore%><%="(#{@endpoint_params})" if @endpoint_params%>
+    request :<%= @method%>, <%= @endpoint_name.underscore%>_endpoint<%="(#{@helper_params})" if @helper_params%>, params: {}
   end
 end

data/lib/generators/endpoint/templates/endpoint_helper.erb

@@ -0,0 +1,4 @@
+
+  def <%= @endpoint_name.underscore%>_endpoint<%="(#{@helper_params})" if @endpoint_params.present?%>
+    <%= "\"#{@endpoint}\".freeze" if @endpoint.present? %>
+  end

data/lib/generators/endpoint/templates/endpoint_spec.erb

@@ -0,0 +1,5 @@
+require 'rails_helper'
+
+RSpec.describe <%=@endpoint_reference%> do
+  # API Endpoint tests
+end

data/lib/generators/endpoint/templates/endpoint_test.erb

@@ -0,0 +1,9 @@
+
+  describe '#<%=@endpoint_name.underscore%>' do
+    it 'returns expected data' do
+      skip 'Write tests for <%=@endpoint_name.underscore%>'
+      
+      <%='# Define endpoint parameters here' unless @endpoint_params%>
+      response = <%=@full_endpoint_reference%><%="(#{@endpoint_params})" unless @endpoint_params%>
+    end
+  end

data/lib/generators/endpoint/templates/mixin.erb

@@ -0,0 +1 @@
+  extend <%= @endpoint_name.camelize%>

data/lib/generators/service/USAGE

@@ -2,7 +2,14 @@ Description:
     Generates the framework for a basic API service your app consumes
 
 Example:
-    rails generate service ServiceName https://service/api/endpoint/ --key api_key env_key_name
+    rails generate service ServiceName version https://service/api/endpoint/ --key api_key env_key_name
+
+Simple Form:
+    rails generate service ServiceName V1 https://service/api/endpoint/
 
     This will create:
-        app/services/ServiceName
+        app/services/ServiceName/version
+        app/services/ServiceName/version/api_calls/
+        app/services/ServiceName/version/api_endpoints.rb
+        app/services/ServiceName/version/client.rb
+        app/services/ServiceName/version/endpoint_helpers.rb

data/lib/generators/service/service_generator.rb

@@ -1,21 +1,30 @@
 class ServiceGenerator < Rails::Generators::NamedBase
   source_root File.expand_path('templates', __dir__)
 
+  argument :version, type: :string
   argument :api_endpoint, type: :string
   class_option :key, type: :array
 
   def create_api_service
     @api_name = file_name
+    @api_version = version
     @api_endpoint = api_endpoint
     @env_var_opts = options[:key]
-    raise 'Need to define the name of your API service with --api' unless @api_name.present?
 
-    @api_dir_name = @api_name.underscore
+    raise ArgumentError, 'Need to give the API version' unless @api_version.present?
+    raise ArgumentError, 'Need to give the API endpoint URI e.g. https://api/' unless @api_endpoint.present?
+
+    @full_api_reference = @api_name.camelize + '::' + @api_version.upcase
+    @api_endpoint = @api_endpoint + '/' unless @api_endpoint.last == '/'
 
     root_dir = "app/services/"
     Dir.mkdir root_dir unless File.exist?(root_dir)
 
-    service_dir_path = "#{root_dir}#{@api_dir_name}/"
+    api_version_path = root_dir + @api_version.downcase + '/'
+
+    Dir.mkdir api_version_path unless File.exist?(api_version_path)
+
+    service_dir_path = api_version_path + api_name.underscore + '/'
 
     Dir.mkdir service_dir_path unless File.exist?(service_dir_path)
     Dir.mkdir "#{service_dir_path}/api_calls" unless File.exist?("#{service_dir_path}/api_calls")

data/lib/generators/service/templates/api_endpoints.erb

@@ -1,5 +1,5 @@
-Dir[Rails.root.join('app/services/<%= @api_dir_name%>/api_calls/*.rb')].each { |api_call| require api_call }
+Dir[Rails.root.join('app/services/<%= @api_dir_name.underscore%>/<%=@api_version.downcase%>/api_calls/*.rb')].sort.each { |api_call| require api_call }
 
-class <%= @api_name.camelize%>::ApiEndpoints < <%= @api_name.camelize%>::Client
+class <%=@full_api_reference%>::ApiEndpoints < <%= @full_api_reference%>::Client
   # API call modules
-end
+end

data/lib/generators/service/templates/client.erb

@@ -1,6 +1,6 @@
 require_relative 'endpoint_helpers'
 
-class <%= @api_name.camelize%>::Client
+class <%=@full_api_reference%>::Client
   extend EndpointHelpers
 
   def self.client(params)

data/lib/generators/service/templates/endpoint_helpers.erb

@@ -1,7 +1,7 @@
 module EndpointHelpers
   def api_endpoint
     # The http API endpoint for this service
-    <%= "'#{@api_endpoint}'.freeze" if @api_endpoint.present? %>
+    <%= "'#{@api_endpoint}'.freeze" %>
   end
 
   # API Endpoint Helpers

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: red-api
 version: !ruby/object:Gem::Version
-  version: 0.1.6
+  version: 0.1.9
 platform: ruby
 authors:
 - Richard DeSilvey
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-07-18 00:00:00.000000000 Z
+date: 2021-07-19 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails
@@ -52,6 +52,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: 1.5.1
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 description: Generate API service and endpoints for API consumption
 email:
 - rdesilvey@gmail.com
@@ -63,6 +77,10 @@ files:
 - lib/generators/endpoint/USAGE
 - lib/generators/endpoint/endpoint_generator.rb
 - lib/generators/endpoint/templates/api_call.erb
+- lib/generators/endpoint/templates/endpoint_helper.erb
+- lib/generators/endpoint/templates/endpoint_spec.erb
+- lib/generators/endpoint/templates/endpoint_test.erb
+- lib/generators/endpoint/templates/mixin.erb
 - lib/generators/service/USAGE
 - lib/generators/service/service_generator.rb
 - lib/generators/service/templates/api_endpoints.erb