yake 0.1.1 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 117ea613cf7d5a703aba3702eb6ab076fa77490c7e7a901b1e00c22db5c55675
-  data.tar.gz: 8a9a8efba6b480218c2adf79990f567ed2d5a01756e98f4aa4e1d2ee7a6734fa
+  metadata.gz: 2be2a80d8b7737cf954f33faef88eb7054ce7b0bbb516f8a216f3b6ec0b5578c
+  data.tar.gz: 69e7b3323594c0f2d794674dc938104ecf1f2d37ccbd4818272aefb6ab4345f7
 SHA512:
-  metadata.gz: 9c543d7f07274ba4b6fb707fcd2326dfc33a10e027723d39a78eaf0bf5937209968759b1caa497d1a024911d70d76221da449346da67defd8d0c2ee1a9a8dfad
-  data.tar.gz: 64f6319d4ad3578aa7920caba1315995b05df6790862bf0256a4b5019cf3e64c64b7861b4eec25acf4a4e729bfb44bc0e68b06863bcf7918a0980c2921a52fc5
+  metadata.gz: 206fdff33a178be14611721811bf5d3177b7e5b3bc7bf09237844aeac2a93e74b7b88281675a169fe41333dfaa9d40eb8bfb4aab3cac20ee762c3fa4d419c5d0
+  data.tar.gz: cc3a7a75a4f467028acc9bc892681067fbe86f4be6ed7cfe120deadfd34100f2da648f013d6ac81021fade9bcf0342ba576b6fa61a520cbc0724022aadae0aba

data/README.md

@@ -26,7 +26,7 @@ require "yake/api"
 
 header "content-type" => "application/json"
 
-get "/fizz" do |handler|
+get "/fizz" do
   respond 200, { ok: true }.to_json
 end
 
@@ -59,19 +59,17 @@ Or install it yourself as:
 gem install yake
 ```
 
-## Why Use It?
+## Why Is It Called "yake"?
 
-So why use `yake` for your Lambda functions?
+"λ" + Rake, but "λ" is hard to type and I think "y" looks like a funny little upside-down-and-backwards Lambda symbol.
 
-#### Zero Dependencies
+## Why Use It?
 
-`yake` does not depend on any other gems, using the Ruby stdlib only. This helps keep your Lambda packages slim & speedy.
+So why use `yake` for your Lambda functions?
 
 #### Event Logging
 
-By default, the `handler` function wraps its block in log lines formatted to match the style of Amazon's native Lambda logs sent to CloudWatch. Each invocation of the handler logs the input event and the returned value prefixed with the ID of the request.
-
-Example log lines:
+By default, the `handler` function wraps its block in log lines formatted to match the style of Amazon's native Lambda logs sent to CloudWatch. Each invocation of the handler will log both the _input event_ and the _returned value_, prefixed with the ID of the request:
 
 ```
 START RequestId: 149c500f-028a-4b57-8977-0ef568cf8caf Version: $LATEST
@@ -82,14 +80,25 @@ END RequestId: 149c500f-028a-4b57-8977-0ef568cf8caf
 REPORT RequestId: 149c500f-028a-4b57-8977-0ef568cf8caf	Duration: 43.97 ms	Billed Duration: 44 ms	Memory Size: 128 MB	Max Memory Used: 77 MB
 ```
 
-This makes gathering logs lines for a particular execution in CloudWatch much easier.
+Logging the request ID in this way makes gathering logs lines for a particular execution in CloudWatch much easier.
 
-This feature can be disabled by adding a declaration in your handler:
+This feature can be disabled by adding a declaration in your handler file:
 
 ```ruby
 logging :off
 ```
 
+Include `Yake::Logger` on a class to access this logger:
+
+```ruby
+class Fizz
+  include Yake::Logger
+end
+
+Fizz.new.logger == Yake.logger
+# => true
+```
+
 #### API Routes
 
 A common use of Lambda functions is as a proxy for API Gateway. Oftentimes users will deploy a single Lambda function to handle all requests coming from API Gateway.
@@ -144,7 +153,7 @@ respond 200, { ok: true }.to_json, "x-extra-header" => "buzz"
 # {
 #   "statusCode" => 200,
 #   "body" => '{"ok":true}',
-#   "headers" => { "x-extra-header" => "fizz" }
+#   "headers" => { "x-extra-header" => "buzz" }
 # }
 ```
 
@@ -156,10 +165,14 @@ handler :lambda_handler do |event|
 rescue Yake::UndeclaredRoute => err
   respond 404, { message: err.message }.to_json
 rescue => err
-  respond 500 { message: err.message }.to_json
+  respond 500, { message: err.message }.to_json
 end
 ```
 
+#### Zero Dependencies
+
+Finally, `yake` does not depend on any other gems, using the Ruby stdlib only. This helps keep your Lambda packages slim & speedy.
+
 ## Development
 
 After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.

data/lib/yake/api.rb

@@ -55,6 +55,12 @@ module Yake
         (@headers ||= {}).update(headers)
       end
 
+      ##
+      # Define ANY route
+      def any(path, &block)
+        define_singleton_method("ANY #{ path }") { |*args| instance_exec(*args, &block) }
+      end
+
       ##
       # Define DELETE route
       def delete(path, &block)

data/lib/yake/dsl.rb

@@ -10,17 +10,17 @@ module Yake
     # Lambda handler task wrapper
     def handler(name, &block)
       define_method(name) do |event:nil, context:nil|
-        Yake.logger.nil? ? yield(event, context) : Yake.logger.wrap(event, context, &block)
+        Yake.wrap(event, context, &block)
       end
     end
 
     ##
     # Turn logging on/off
-    def logging(switch, **options)
+    def logging(switch, logger = nil)
       if switch == :on
-        Yake.logger = Yake::Logger.new
+        Yake.logger = logger
       elsif switch == :off
-        Yake.logger = nil
+        Yake.logger = ::Logger.new(nil)
       else
         raise Errors::UnknownLoggingSetting, switch
       end
@@ -29,4 +29,3 @@ module Yake
 end
 
 extend Yake::DSL
-Yake.logger = Yake::Logger.new

data/lib/yake/logger.rb

@@ -4,33 +4,41 @@ require "json"
 require "logger"
 
 module Yake
-  class Logger < ::Logger
-    def initialize(logdev = $stdout, *)
-      super
-      @progname  = "-"
-      @formatter = LambdaFormatter.new
+  module Logger
+    attr_accessor :logger
+
+    def logger
+      @logger ||= Yake.logger
     end
 
-    def wrap(event = nil, context = nil, &block)
-      @progname = "RequestId: #{ context.aws_request_id }" if context.respond_to?(:aws_request_id)
-      info("EVENT #{ event.to_json }")
-      yield(event, context).tap { |res| info("RETURN #{ res.to_json }") }
-    ensure
-      @progname = "-"
+    class << self
+      def new(logdev = $stdout)
+        ::Logger.new(logdev, progname: "-", formatter: Formatter.new)
+      end
     end
-  end
 
-  class LambdaFormatter < ::Logger::Formatter
-    Format = "%s %s %s\n"
+    class Formatter < ::Logger::Formatter
+      Format = "%s %s %s\n"
 
-    def call(severity, time, progname, msg)
-      Format % [ severity, progname, msg2str(msg).strip ]
+      def call(severity, time, progname, msg)
+        Format % [ severity, progname, msg2str(msg).strip ]
+      end
     end
   end
 
-  module Loggable
+  class << self
     attr_accessor :logger
-  end
 
-  extend Loggable
+    def logger
+      @logger ||= Logger.new
+    end
+
+    def wrap(event = nil, context = nil, &block)
+      logger.progname = "RequestId: #{ context.aws_request_id }" if context.respond_to?(:aws_request_id)
+      logger.info("EVENT #{ event.to_json }")
+      yield(event, context).tap { |res| logger.info("RETURN #{ res.to_json }") }
+    ensure
+      logger.progname = "-"
+    end
+  end
 end

data/lib/yake/version.rb

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

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: yake
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.2.0
 platform: ruby
 authors:
 - Alexander Mancevice
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2021-04-27 00:00:00.000000000 Z
+date: 2021-05-14 00:00:00.000000000 Z
 dependencies: []
 description:
 email: