lambda_open_api 0.1.1 → 0.1.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: '0292d9248bdef0279482cba6e3231611d85f1bcf97366c9c652d6b7dd139ea22'
-  data.tar.gz: '09d09c1996366fcba3bde6e75ed360f1eb8b00e922f9632b2b1c4c516886acba'
+  metadata.gz: 215da615c51f2cc4828de0551f0f3c8ff55e1139913125654f336f5b596a9641
+  data.tar.gz: 55aa015422479a62519535d4ac452b03fe1e994fcb6aac8cf919054007a9ab9b
 SHA512:
-  metadata.gz: 1f46e71f03e98eb461122773ac840c6c900cb5022488cc5bfff9e79c0b28118a62a65c056a5f0a8e8cea877afcc30f706999663e16e9a1259297552d21f2fde8
-  data.tar.gz: d0861c21a6905db371f74025cdf0ad0a1050b53abb40fdca4b6a75d22bff8a233a84af9a49bd329cb6655b4d502ff7126786ea7de5ac4d1982509f98e51424b6
+  metadata.gz: f288e0522addb39986627173c569a6ecead21a7ab7dd45e7bc9b72ec2e0dad79dacad4f1f5d038e7ac9aeebd6ba46f78ee76272ebc492f0c52a3dabfbeea6ac0
+  data.tar.gz: 1228582d556426675f94e02a0fb83be97494e0e6ed084e1f4d442101023847b03d2122418fc467cd30adacb7a29bc9ff3ebbf01d10b144f8eaa77a05393aa8ab

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    lambda_open_api (0.1.0)
+    lambda_open_api (0.1.3)
 
 GEM
   remote: https://rubygems.org/

data/README.md

@@ -1,22 +1,191 @@
 # LambdaOpenApi
 
-Welcome to your new gem! In this directory, you'll find the files you need to be able to package up your Ruby library into a gem. Put your Ruby code in the file `lib/lambda_open_api`. To experiment with that code, run `bin/console` for an interactive prompt.
-
-TODO: Delete this and the text above, and describe your gem
+This gem is a light weight DSL that works with rspec to allow developers to generate an OpenAPI (swagger) file based an AWS Lambda invoked by API Gateway. It works by writing a simple unit test for your lambda's code. When the test is executed, the input event and returned response are captured and used to build an OpenAPI file. 
 
 ## Installation
 
-Install the gem and add to the application's Gemfile by executing:
-
-    $ bundle add lambda_open_api
-
-If bundler is not being used to manage dependencies, install the gem by executing:
-
-    $ gem install lambda_open_api
+Add to your gem file:
+```ruby
+group :test do
+  gem 'rspec'
+  gem 'lambda_open_api'
+end
+```
+    
+Create an initializer file to configure the gem. 
+```ruby
+LambdaOpenApi.configure do |config|
+  config.file_name = "open_api.json"
+  config.title = "My Example Api"
+  config.description = "About this api"
+  config.version = "1"
+  config.host = "https://my_example_api.com"
+  config.schemes = ["https"]
+  config.consumes = ["application/json"] 
+  config.produces = ["application/json"]
+end
+```
+
+Include the gem in your spec hepler file `spec/spec_helper.rb` or any file that gets loaded before rspec is ran. 
+```ruby
+require "lambda_open_api"
+
+RSpec.configure do |config|
+  # ...
+  # the rest of your normal config
+  #...
+end
+```
+
+That's it!
 
 ## Usage
 
-TODO: Write usage instructions here
+Let's say we have a lmabda that looks something like this.
+```ruby
+require_relative '../spec_helper'
+
+class MyLambda
+  def self.process(event:, context: {})
+    body = JSON.parse(event["body"])
+
+    # do something useful
+
+    {
+      statusCode: 200,
+      body: { message: "processed", name: body["name"], email: body["email"] }
+    }
+  end
+end
+```
+
+We can write a spec file like this:
+
+```ruby
+RSpec.describe MyLambda do
+
+  resource "Users" do
+
+    get "users/{id}" do
+      path_summery "Some very high level details"
+      path_description "Some more details about this path"
+
+      example_case "200" do
+        parameter({id: 1})
+
+        event_body({
+          name: "Timbo Baggins",
+          email: "tbaggings@hotmail.com"
+        }.to_json)
+
+        event_headers({
+          "Api-Key" => "the_api_key"
+        })
+
+        run_example do
+          expect(lambda_response[:body]).to eq({:message => "processed", :email=>"tbaggings@hotmail.com", :name=>"Timbo Baggins"})
+          expect(lambda_response[:statusCode]).to eq(200)
+        end
+      end
+    end
+
+  end
+end
+```
+
+Run rspec 
+```bash
+rspec
+```
+
+An Open Api file will be generated and saved that looks like this:
+```json
+{
+  "swagger": "2.0",
+  "info": {
+    "title": "My Example Api",
+    "description": "About this api",
+    "version": "1"
+  },
+  "host": "https://my_example.com",
+  "schemes": [
+    "https"
+  ],
+  "consumes": [
+    "application/json"
+  ],
+  "produces": [
+    "application/json"
+  ],
+  "paths": {
+    "users/{id}": {
+      "get": {
+        "tags": [
+          "Users"
+        ],
+        "summary": "Some very high level details",
+        "description": "Some more details about this path",
+        "consumes": [
+          "application/json"
+        ],
+        "produces": [
+          "application/json"
+        ],
+        "parameters": [
+          {
+            "name": "id",
+            "in": "path",
+            "description": "",
+            "required": true,
+            "type": "integer"
+          },
+          {
+            "name": "body",
+            "in": "body",
+            "description": "",
+            "required": false,
+            "schema": {
+              "description": "",
+              "type": "object",
+              "properties": {
+                "name": {
+                  "type": "string"
+                },
+                "email": {
+                  "type": "string"
+                }
+              },
+              "required": [
+
+              ]
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "examples": {
+              "application/json": {
+                "statusCode": 200,
+                "body": {
+                  "message": "processed",
+                  "name": "Timbo Baggins",
+                  "email": "tbaggings@hotmail.com"
+                }
+              }
+            }
+          }
+        }
+      }
+    }
+  }
+}
+
+```
+
+From https://editor-next.swagger.io/
+<img width="853" alt="Screen Shot 2023-01-30 at 9 42 18 AM" src="https://user-images.githubusercontent.com/9610694/215508235-c0edfadb-6df1-4cc5-83ef-43fdecc9dc34.png">
+
+<img width="851" alt="Screen Shot 2023-01-30 at 9 42 04 AM" src="https://user-images.githubusercontent.com/9610694/215508248-b852cff0-2bf3-40ae-a601-43c0e6173831.png">
 
 ## Development
 
@@ -26,7 +195,7 @@ To install this gem onto your local machine, run `bundle exec rake install`. To
 
 ## Contributing
 
-Bug reports and pull requests are welcome on GitHub at https://github.com/[USERNAME]/lambda_open_api.
+Bug reports and pull requests are welcome on GitHub at https://github.com/Timothyjb/lambda_open_api.
 
 ## License
 

data/lib/lambda_open_api/builder.rb

@@ -65,14 +65,12 @@ module LambdaOpenApi
     end
 
     def run_example(test_name=nil, &block)
-      lambda_response_value = invoke_lambda
-      @action.set_response(lambda_response_value)
+      klass = create_class
 
       it "#{test_name || @action.path_name}" do
-        @lambda_response_value = lambda_response_value
-
+        @klass = klass
         def lambda_response
-          @lambda_response_value
+          @lambda_response ||= @klass.invoke
         end
 
         instance_eval &block
@@ -99,6 +97,37 @@ module LambdaOpenApi
       OpenStruct.new(aws_request_id: "123")
     end
 
+    def create_class
+      dynamic_name = "ClassName#{rand(10000)}"
+      klass = Object.const_set(dynamic_name, Class.new do
+        def self.set_event(event)
+          @event = event
+        end
+
+        def self.event
+          @event
+        end
+
+        def self.set_described_class(klass)
+          @klass = klass
+        end
+
+        def self.invoke
+          invokcation = LambdaOpenApi::Invoker.new(klass: @klass, method: "process", event: @event.json, context: OpenStruct.new(aws_request_id: "123"))
+          @action.set_response(invokcation.response_body)
+          invokcation.response_body
+        end
+        def self.set_action(action)
+          @action = action
+        end
+      end)
+
+      klass.set_event(@event)
+      klass.set_action(@action)
+      klass.set_described_class(described_class)
+      klass
+    end
+
   end
 end
 

data/lib/lambda_open_api/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module LambdaOpenApi
-  VERSION = "0.1.1"
+  VERSION = "0.1.3"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: lambda_open_api
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.1.3
 platform: ruby
 authors:
 - Timothyjb
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2023-01-30 00:00:00.000000000 Z
+date: 2023-01-31 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: minitest