ant-server 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: acabc2e20fc8bae1543886e5199127f83097f601627c57c32ed47bd1c2c5110c
+  data.tar.gz: d21714db5880cffba818daeab9b081d538fb7ea17e6d01271bd79333dd965bae
+SHA512:
+  metadata.gz: e6944cd4e4f34945a9e22032b35956fc10618a3833bd59d6cd1ebf0d02f8aa5a7d71541a4cde84a716f3a9f0bbde6b3dfbae2a8171459b75892a71ed18fe300b
+  data.tar.gz: 4cc1e301c82ee8316f36d211a36353d3444b986307ffa4674c27bb9fcbc4fc5cb2a32a43435ada917168c10e59a0ea9b5002912155a91593fb65e11b524040aa

data/lib/ant/server.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+require 'ant/core'
+
+require_relative 'version'
+require_relative 'server/response'
+require_relative 'server/format'

data/lib/ant/server/format.rb

@@ -0,0 +1,45 @@
+# frozen_string_literal: true
+
+module Ant
+  module Server
+    ##
+    # See Exceptions module, since this is based on the exceptions too.
+    # This will wrap a json object into a standard format, where the response
+    # will contain some metadata about the status of the request
+    class Format
+      INTERNAL_SERVER_ERROR_CODE = 'INTERNAL_SERVER_ERROR'
+      INTERNAL_SERVER_ERROR_MESSAGE = 'Unexpected error ocurred!'
+      ##
+      # success means there were no errors during the execution of the request
+      # it sends the result in the data field.
+      def success(response)
+        { status: :success, data: response.result || response.data }
+      end
+
+      ##
+      # an error on the request. It gives the details of the error.
+      def fail(response)
+        error_format(:fail, response.code, response.message, response.data)
+      end
+
+      ##
+      # an error found while resolving the request.
+      def error(response)
+        error_format(:error, response.code, response.message, response.data)
+      end
+
+      ##
+      # an unhandled error ocurred during the execution of the request.
+      def fatal(_data)
+        error_format(:fatal, INTERNAL_SERVER_ERROR_CODE,
+                     INTERNAL_SERVER_ERROR_MESSAGE, {})
+      end
+
+      ##
+      # helper to sumarize fatal and error status
+      def error_format(level, code, message, data)
+        { status: level, code: code, message: message, data: data }
+      end
+    end
+  end
+end

data/lib/ant/server/grape.rb

@@ -0,0 +1,90 @@
+# frozen_string_literal: true
+
+module Ant
+  module Server
+    # Descorator for using grape with ant.
+    # This will implement:
+    # - exception handling
+    # - logs
+    # - JSend format
+    module GrapeDecorator
+      def self.handler
+        lambda do |env, level, ex|
+          params = env['api.endpoint'].params
+          request = env['api.endpoint'].request
+          pkg = RequestResponse.new(request: request, params: params)
+          pkg.exception = ex
+          Server::Response.logger.send(level, pkg)
+          Server::Response.format.send(level, pkg)
+        end
+      end
+
+      HTTP_CODES = {
+        success: 200, fail: 400, error: 500, fatal: 500
+      }.freeze
+
+      def self.extract_http_code(exception, level)
+        default = HTTP_CODES[level] || 500
+        exception.respond_to?(:http_code) ? exception.http_code : default
+      end
+
+      def self.configure_custom_exceptions(base)
+        Server::Response.resources(:exceptions).each do |exception_class, level|
+          base.rescue_from(exception_class) do |ex|
+            response = Ant::Server::GrapeDecorator.handler.call(env, level, ex)
+            http_code = Ant::Server::GrapeDecorator.extract_http_code(ex, level)
+            error!(response, http_code)
+          end
+        end
+      end
+
+      # :nocov: #
+      def self.configure_grape_exceptions(base)
+        base.rescue_from(Grape::Exceptions::Base) do |ex|
+          ant_ex = Ant::Exceptions::AntFail.new(ex.message)
+          response = Ant::Server::GrapeDecorator
+                     .handler.call(env, :fail, ant_ex)
+          error!(response, 400)
+        end
+      end
+      # :nocov: #
+
+      def self.configure_global_exception_handler(base)
+        base.rescue_from(:all) do |ex|
+          level = :fatal
+          response = Ant::Server::GrapeDecorator.handler.call(env, level, ex)
+          http_code = Ant::Server::GrapeDecorator.extract_http_code(ex, level)
+          error!(response, http_code)
+        end
+      end
+
+      def self.configure_handlers(base)
+        configure_custom_exceptions(base)
+        configure_grape_exceptions(base)
+        configure_global_exception_handler(base)
+      end
+
+      def self.included(base)
+        base.formatter(:json, lambda do |response, _|
+          pkg = RequestResponse.new(request: {}, params: {})
+          pkg.result = response
+          Server::Response.format.send(:success, pkg).to_json
+        end)
+        configure_logger(base)
+        configure_handlers(base)
+      end
+
+      def self.configure_logger(base)
+        base.before do
+          params[:__init_time] = Time.now
+        end
+        base.after do
+          params = env['api.endpoint'].params
+          request = env['api.endpoint'].request
+          pkg = RequestResponse.new(request: request, params: params)
+          Server::Response.logger.access(pkg)
+        end
+      end
+    end
+  end
+end

data/lib/ant/server/logger.rb

@@ -0,0 +1,50 @@
+# frozen_string_literal: true
+
+require 'ant/logger'
+module Ant
+  module Server
+    # Implements monitoring. This will add logs.
+    # Currently it only support CuteLogger format, but it will be deprecated
+    # in order to support a new log (actually kind of the same format).
+    class Logger
+      include Ant::Logger
+      def access_data(response)
+        {
+          path: response.path,
+          ip: response.ip,
+          verb: response.verb,
+          processing_time:
+            (Time.now - response.params[:__init_time]).to_f * 1000
+        }
+      end
+
+      def access(response)
+        log_info('Requesting resource', access_data(response))
+      end
+
+      def success(response)
+        log_info('Success request', access_data(response))
+      end
+
+      def fail(response)
+        log_info('Fail Response',
+                 access_data(response)
+                  .merge(message: response.exception.message))
+      end
+
+      def error(response)
+        log_warn('Error dectected on response', access_data(response).merge(
+                                                  error: response.exception
+                                                ))
+      end
+
+      def fatal(response)
+        log_error('Unexpected error on response',
+                  access_data(response).merge(
+                    error: response.exception,
+                    data: response.params
+                  ))
+      end
+    end
+  end
+end

data/lib/ant/server/request_response.rb

@@ -0,0 +1,42 @@
+# frozen_string_literal: true
+
+module Ant
+  module Server
+    # Wraps the request and the response into an object so it is easier
+    # to track monitoring logs and format the response after the endpoint was
+    # executed
+    class RequestResponse
+      attr_reader :params, :exception, :result, :start_timestamp
+      attr_writer :exception, :result, :start_timestamp
+      def initialize(request:, params:)
+        @request = request
+        @params = params
+        @start_timestamp = Time.now
+      end
+
+      def data
+        @exception.data
+      end
+
+      def code
+        @exception.code
+      end
+
+      def verb
+        @request.request_method
+      end
+
+      def ip
+        @request.ip
+      end
+
+      def message
+        @exception.message
+      end
+
+      def path
+        @request.env['PATH_INFO']
+      end
+    end
+  end
+end

data/lib/ant/server/response.rb

@@ -0,0 +1,82 @@
+# frozen_string_literal: true
+
+require_relative 'format'
+require_relative 'logger'
+require_relative 'request_response'
+
+module Ant
+  module Server
+    ##
+    # This module provides a function to wrap lambdas arround grape/sinatra
+    # You can mount this module as helper in your application and wrap the block
+    # with the method `process_request`
+    module Response
+      include Exceptions
+      extend DRY::ResourceInjector
+
+      class << self
+        attr_reader :logger, :format
+
+        def log_mode(mode)
+          @logger = resource(:loggers, mode)
+        end
+
+        def format_mode(mode)
+          @format = resource(:formats, mode)
+        end
+
+        def recover_from!(exception_class, level)
+          register(:exceptions, exception_class, level)
+        end
+
+        def configure_defaults!
+          recover_from!(Exceptions::AntSuccess, :success)
+          recover_from!(Exceptions::AntFail, :fail)
+          recover_from!(Exceptions::AntError, :error)
+          register(:loggers, :cute_logger, Server::Logger.new)
+          register(:formats, :jsend, Server::Format.new)
+          log_mode(:cute_logger)
+          format_mode(:jsend)
+        end
+      end
+
+      def exception_handler(exception)
+        Server::Response.resources(:exceptions).each do |klass, recover|
+          return recover if exception.is_a?(klass)
+        end
+        exception.is_a?(StandardError) ? :fatal : nil
+      end
+
+      def handle(resolver, data)
+        if resolver
+          Server::Response.logger.send(resolver, data)
+          Server::Response.format.send(resolver, data)
+        else
+          Server::Response.logger.fatal(data)
+          raise(data.exception)
+        end
+      end
+
+      def process_request
+        params[:__init_time] = Time.now
+        data = RequestResponse.new(request: request, params: params)
+        resolver = :success
+        Server::Response.logger.access(data)
+        begin
+          raise(AntError, 'No implementation given') unless block_given?
+
+          data.result = yield
+          # rubocop: disable RescueException
+        rescue Exception => ex
+          # rubocop: enable RescueException
+          data.exception = ex
+          resolver = exception_handler(ex)
+        end
+        handle(resolver, data)
+      end
+    end
+  end
+end
+
+# Allow backwards compatibility
+Ant::Server::Response.configure_defaults!

data/lib/ant/version.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+module Ant
+  module Server
+    VERSION = '0.1.0'
+  end
+end

metadata

@@ -0,0 +1,204 @@
+--- !ruby/object:Gem::Specification
+name: ant-server
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Gilberto Vargas
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2019-10-07 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: ant-core
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
+- !ruby/object:Gem::Dependency
+  name: ant-logger
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
+- !ruby/object:Gem::Dependency
+  name: grape
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.2'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.2'
+- !ruby/object:Gem::Dependency
+  name: minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+- !ruby/object:Gem::Dependency
+  name: mocha
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.8'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.8'
+- !ruby/object:Gem::Dependency
+  name: pry
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.10'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.10'
+- !ruby/object:Gem::Dependency
+  name: rack-minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+- !ruby/object:Gem::Dependency
+  name: rdoc
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '6.1'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '6.1'
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.16'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.16'
+- !ruby/object:Gem::Dependency
+  name: webmock
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.5'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.5'
+description: This gems can be used along a server app with jsonformat messages
+email:
+- tachoguitar@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/ant/server.rb
+- lib/ant/server/format.rb
+- lib/ant/server/grape.rb
+- lib/ant/server/logger.rb
+- lib/ant/server/request_response.rb
+- lib/ant/server/response.rb
+- lib/ant/version.rb
+homepage: https://github.com/tachomex/ant
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.0.3
+signing_key: 
+specification_version: 4
+summary: Implements ANT format on server applications
+test_files: []