faux-lambda 0.5

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 27f64243cbe049392b836b5e6dbb7c9af0308bed
+  data.tar.gz: aff20d710af04c063beb96a287d80c3f5f2bc6f0
+SHA512:
+  metadata.gz: 3a7cbf03b35a0d9e7a4cfe76705d254bbdfbbed48a52801eb5c95903650a7c0bcf0bcb27eb2ebe1ef179a6e609852dc476510253aba0c300710b56fa6f32b82c
+  data.tar.gz: 58ecad0b190c54a694a431e6659ac94dbf75603811fda1c1f8fd37a5d328e3517e99acdc6a9f8669c200a72dcb51ffedd611ebf5ec6456a0a538e8cd75efed05

data/.gitignore

@@ -0,0 +1,2 @@
+.bundle/
+.ruby-version

data/Gemfile

@@ -0,0 +1,4 @@
+# frozen_string_literal: true
+source "https://rubygems.org"
+
+gemspec

data/Gemfile.lock

@@ -0,0 +1,19 @@
+PATH
+  remote: .
+  specs:
+    faux-lambda (0.5)
+      rack (~> 2.0)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    rack (2.0.3)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  faux-lambda!
+
+BUNDLED WITH
+   1.15.4

data/README.md

@@ -0,0 +1,78 @@
+# Faux Lambda server for testing
+
+Lambda service mock implementation for testing and exploration. It starts a simple web server (default is http://localhost:9123) and processes Lambda invocation requests. It can be used both programmatically and as a command line tool.
+
+## As a command line tool
+
+In its simplest form:
+```
+gem install faux-lambda
+faux-lambda --reply='{}' &
+aws --endpoint http://localhost:9123 lambda invoke --function-name whatever
+```
+
+The CLI can also simulate specific scenarios:
+```
+$ faux-lambda --function=foo --reply='{}' --function=bar --reply='{}' --reply='{}' --fail &
+$ aws --endpoint http://localhost:12345 lambda invoke --function-name foo
+Called foo with ...
+{}
+```
+Here, each call to function `foo` gets reply `{}`, first call to function `bar` gets `{}`, second gets `{}` and third will fail.
+
+You can also pipe in replies from `stdin`, one reply per object (may contain newlines):
+```
+faux-lambda --function=foo <<<EOF
+{}
+{}
+EOF
+```
+In this mode, the CLI will accept only one function, but may prove useful where there are numerous or large replies.
+
+```
+Usage: faux-lambda [options]
+Query specifiers:
+  --function-name=regex
+  --async       Require invocation to be async
+  --sync        Require invocation to be sync
+Reply specifiers:
+  --reply=json  Send this reply
+  --fail        ...
+Various:
+  --quiet       Don't log sent and received messages
+  --version
+```
+
+## faux-lambda as a library
+
+You can use `faux-lambda` programmatically too, like so:
+```
+require `faux-lambda`
+lambda = FauxLambda.new(port: 12345).handle do |call|
+  return if call.async
+  if call.function_name == 'foo'
+    '{}'
+  end
+end
+
+Aws::Lambda.new(endpoint: lambda.endpoint).invoke(...)
+```
+
+## faux-lambda in your specs
+
+Or in your specs as if FauxLambda were an `rspec-mocks` double:
+```
+let(:lambda) { FauxLambda.new }
+before do
+  allow(lambda).to receive(:incrementer).and_return(43)
+end
+
+subject do
+  ThingUnderTest.new(lambda.endpoint).do_math(42)
+end
+
+it 'invokes lambda and returns its value' do
+  expect(subject).to equal(43)
+  expect(lambda).to have_received(:incrementer).with(value: 42)
+end
+```

data/bin/faux-lambda

@@ -0,0 +1,82 @@
+#!/usr/bin/env ruby
+
+require 'rack'
+require 'webrick'
+require 'optparse'
+require_relative '../lib/faux_lambda/version'
+
+options = {
+  port: 9123,
+  bind: '127.0.0.1',
+}
+
+functions = {
+  default: {
+    invocation_type: nil,
+    replies: []
+  }
+}
+
+current_function = :default
+parser = OptionParser.new do |opts|
+  opts.banner = "AWS Lambda debugging endpoint, version #{FauxLambda::VERSION}."
+  opts.separator('')
+  opts.separator('Usage: faux-lambda --reply "Hello world!"')
+  opts.on('--function name', '-f name', 'Name of function to expect, optionally with :<qualifier>') do |function_name|
+    current_function = function_name
+    functions[current_function] = {replies: []}
+  end
+  opts.on('--reply payload', '-r payload', 'Data to respond with') do |payload|
+    functions[current_function][:replies] << payload
+  end
+  opts.on('--fail', 'AWS Lambda framework gives 400') do
+    functions[current_function][:replies] << :fail
+  end
+end
+parser.parse!
+
+def reply_from(replies)
+  if replies.size > 1
+    replies.shift
+  elsif replies.size == 1
+    replies.last
+  else
+    nil
+  end
+end
+
+def function_data(functions, function_name, qualifier)
+  qualified_function_name = if qualifier
+    "#{function_name}:#{qualifier}"
+  end
+  functions[qualified_function_name] || functions[function_name] || functions[:default]
+end
+
+app = Proc.new do |env|
+  _, version, _, function_name, _ = env['REQUEST_PATH'].split('/')
+  raise "Unknown version #{version}" unless version == '2015-03-31'
+  qs = Rack::Utils.parse_nested_query(env["QUERY_STRING"])
+
+  data = function_data(functions, function_name, qs["Qualifier"])
+  reply = reply_from(data[:replies])
+  if reply.nil?
+    status_code = '404'
+    reply = 'Not found'
+  elsif reply == :fail
+    status_code = '400'
+    reply = 'Failed'
+  else
+    status_code = '200'
+  end
+
+  headers = {'Content-Type' => 'application/octet-stream'}
+  [status_code, headers, [reply]]
+end
+
+Rack::Handler::WEBrick.run(
+  app,
+  Port: options[:port],
+  BindAddress: options[:bind],
+  Logger: WEBrick::Log.new($stderr, WEBrick::Log::ERROR),
+  AccessLog: [['/dev/null', WEBrick::AccessLog::COMMON_LOG_FORMAT]]
+)

data/faux-lambda.gemspec

@@ -0,0 +1,19 @@
+require File.expand_path('../lib/faux_lambda/version', __FILE__)
+
+Gem::Specification.new do |spec|
+  spec.name        = 'faux-lambda'
+  spec.version     = FauxLambda::VERSION
+  spec.summary     = 'faux-lambda provides a simple tool to mock AWS Lambda endpoint'
+  spec.description = 'faux-lambda is a toolbox to make it easier to develop client that call AWS Lambda functions. A simple CLI lets you mock AWS Lambda and specify replies for specific function as well as simulate AWS Lambda framework failures.'
+  spec.authors     = ['Anders Qvist']
+  spec.email       = 'quest@lysator.liu.se'
+  spec.homepage    = 'https://github.com/bittrance/faux-lambda'
+  spec.license     = 'MIT'
+
+  spec.executables = ['faux-lambda']
+  spec.files       = `git ls-files -z`.split("\x0").reject { |f| f.match(/^spec/) }
+
+  spec.required_ruby_version = '>= 2.0.0'
+
+  spec.add_runtime_dependency 'rack', '~> 2.0'
+end

data/lib/faux_lambda/version.rb

@@ -0,0 +1,3 @@
+module FauxLambda
+  VERSION = '0.5'
+end

metadata

@@ -0,0 +1,67 @@
+--- !ruby/object:Gem::Specification
+name: faux-lambda
+version: !ruby/object:Gem::Version
+  version: '0.5'
+platform: ruby
+authors:
+- Anders Qvist
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2017-11-01 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rack
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+description: faux-lambda is a toolbox to make it easier to develop client that call
+  AWS Lambda functions. A simple CLI lets you mock AWS Lambda and specify replies
+  for specific function as well as simulate AWS Lambda framework failures.
+email: quest@lysator.liu.se
+executables:
+- faux-lambda
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- Gemfile
+- Gemfile.lock
+- README.md
+- bin/faux-lambda
+- faux-lambda.gemspec
+- lib/faux_lambda/version.rb
+homepage: https://github.com/bittrance/faux-lambda
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.0.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.6.13
+signing_key: 
+specification_version: 4
+summary: faux-lambda provides a simple tool to mock AWS Lambda endpoint
+test_files: []