lambda_loadout 0.0.1

data/lib/lambda_loadout.rb

@@ -0,0 +1,101 @@
+# frozen_string_literal: true
+
+require_relative 'lambda_loadout/version'
+require_relative 'lambda_loadout/logger'
+require_relative 'lambda_loadout/metrics'
+require_relative 'lambda_loadout/middleware'
+require_relative 'lambda_loadout/errors'
+require_relative 'lambda_loadout/error_notifier'
+require_relative 'lambda_loadout/global'
+
+# LambdaLoadout - AWS Lambda Powertools for Ruby
+#
+# A Ruby implementation of AWS Lambda Powertools providing:
+# - Structured logging with Lambda context enrichment
+# - CloudWatch Metrics via Embedded Metric Format (EMF)
+# - Automatic error tracking and alerting
+# - Lambda middleware for easy integration
+#
+# @example Basic usage
+#   require 'lambda_loadout'
+#
+#   logger = LambdaLoadout::Logger.new(service: "payment")
+#   metrics = LambdaLoadout::Metrics.new(namespace: "MyApp", service: "payment")
+#
+#   def lambda_handler(event:, context:)
+#     LambdaLoadout.with_logging_and_metrics(logger, metrics, context) do
+#       logger.info("Processing payment")
+#       metrics.add_metric(name: "PaymentProcessed", unit: "Count", value: 1)
+#
+#       { statusCode: 200, body: "Success" }
+#     end
+#   end
+module LambdaLoadout
+  class Error < StandardError; end
+
+  # Helper method to wrap Lambda handler with logging and metrics
+  #
+  # @param logger [LambdaLoadout::Logger] Logger instance
+  # @param metrics [LambdaLoadout::Metrics] Metrics instance
+  # @param context [Object] Lambda context
+  # @param event [Hash] Lambda event (optional, required for error notifications)
+  # @param capture_cold_start [Boolean] Whether to capture cold start metric
+  # @param error_notification_config [Hash, nil] Error notification configuration
+  #   - :sns_topic_arn [String] SNS topic ARN for error notifications
+  #   - :region [String] AWS region (optional, defaults to AWS_REGION env var)
+  # @yield Block containing Lambda handler logic
+  # @return [Object] Result of the block
+  #
+  # @example With error notifications
+  #   LambdaLoadout.with_logging_and_metrics(
+  #     logger, metrics, context, event: event,
+  #     error_notification_config: { sns_topic_arn: ENV['ERROR_NOTIFICATION_TOPIC_ARN'] }
+  #   ) do
+  #     # Your Lambda code here
+  #   end
+  def self.with_logging_and_metrics(logger, metrics, context, event: nil, capture_cold_start: true,
+                                    error_notification_config: nil, &block)
+    logger.inject_lambda_context(context)
+
+    begin
+      result = block.call
+      metrics.add_cold_start_metric(context) if capture_cold_start
+      result
+    rescue StandardError => e
+      logger.error('Lambda execution failed', e)
+      metrics.add_metric(name: 'LambdaError', unit: 'Count', value: 1)
+
+      # Send error notification if configured
+      if error_notification_config && error_notification_config[:sns_topic_arn]
+        notifier = ErrorNotifier.new(
+          sns_topic_arn: error_notification_config[:sns_topic_arn],
+          logger: logger,
+          region: error_notification_config[:region]
+        )
+
+        notifier.notify(error: e, context: context, event: event || {})
+      end
+
+      raise
+    ensure
+      metrics.flush
+    end
+  end
+
+  # Check if running in AWS Lambda environment
+  #
+  # @return [Boolean] true if running in Lambda
+  def self.in_lambda?
+    !ENV['AWS_LAMBDA_FUNCTION_NAME'].nil?
+  end
+
+  # Get cold start status
+  #
+  # @return [Boolean] true if this is a cold start
+  def self.cold_start?
+    @cold_start ||= true
+    current_cold_start = @cold_start
+    @cold_start = false
+    current_cold_start
+  end
+end

data.tar.gz.sig

@@ -0,0 +1,3 @@
+�K�l���op,�K��f�e�<�e�{��t�m�
a�����[�.�������
+�f����md'2[���ݣ��,��bp
+S����
��5��,���f�

metadata

@@ -0,0 +1,168 @@
+--- !ruby/object:Gem::Specification
+name: lambda_loadout
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Andy Davis
+bindir: bin
+cert_chain:
+- |
+  -----BEGIN CERTIFICATE-----
+  MIIEdDCCAtygAwIBAgIBATANBgkqhkiG9w0BAQsFADBAMQ4wDAYDVQQDDAVhZ2Vu
+  dDEZMBcGCgmSJomT8ixkARkWCXN0b3d6aWxsYTETMBEGCgmSJomT8ixkARkWA2Nv
+  bTAeFw0yNjA2MDgxOTExNTlaFw0yNzA2MDgxOTExNTlaMEAxDjAMBgNVBAMMBWFn
+  ZW50MRkwFwYKCZImiZPyLGQBGRYJc3Rvd3ppbGxhMRMwEQYKCZImiZPyLGQBGRYD
+  Y29tMIIBojANBgkqhkiG9w0BAQEFAAOCAY8AMIIBigKCAYEAupBquKI/4WvXOgND
+  pXyqH2GllZs1wG4TWWdn/DoMg45UoCwD+AWEuGrIdInBCpPN8vEJNJWPoM/RrU+b
+  xRBZT4uUk00bnZRW2SYh5GJSqBoBR+rWc2DGkXyGfdRU2sQvkB0+is6ChgQ61WMM
+  33LE9+loBlVsZ6EVtrc18Uh2OW0mJpe0hN2nmBrxZqqOZigxC4DKRMFHvpRkxSb6
+  mD4kit1AcwX9NEWJsXxrPaetL/SB/VbXaEZX93XAvp6USaXvCWt4slkDS2mIvqtn
+  9DtGC43LFC7SDGbnsG9PVenQgVCi8UWFPUAab0PqZSlmi3Qlbhw8qTGPp5Cbv4vz
+  qjC2UGPOQigA/7lbbGRhCohMrjOVHMAQwkcgiIqtolUoYlnvPMIy+m3pdvgDv/PH
+  bsZGvXQ7i0458xsmp1vaKthZocVAR+GboHbuIiYPUnO45ccXUQ00x6365tTe7mZi
+  NvmUYdAGbQmVvFqyxF7IYA6sF74L2Lstu0knSfss557bAe1HAgMBAAGjeTB3MAkG
+  A1UdEwQCMAAwCwYDVR0PBAQDAgSwMB0GA1UdDgQWBBSnxTL/lNBCeLqpeVIX6AUY
+  kel4zjAeBgNVHREEFzAVgRNhZ2VudEBzdG93emlsbGEuY29tMB4GA1UdEgQXMBWB
+  E2FnZW50QHN0b3d6aWxsYS5jb20wDQYJKoZIhvcNAQELBQADggGBACm9Fjit/UCv
+  FxlKqeiCTIG94cIx+QrWAOJSx9knKydwUec1u04D/DbfZjTn3C2Bj227QgxeUn+6
+  if3e2v7zAk1896hLmGYzML0+nxQPb0vmtdLR7HETUlSKTVabcv1fbwLyjsuGrBvk
+  y51vOEzUEZ508a9yepLYqrQu1kOju4d57c9oA5l3H0mMKWz7av9tFj0B+STvuaWk
+  HRYDWc5HgOEVTyV+w0uFt2Kw4OCb8C42uSvC5RfYYtw78MSP+5Ru+LXJ7XOtmuN0
+  E6GVmofQ17ig9O3rgfFbMendSInrRmvPIGswvM1yivq9NOllFbdck2OJKPx6FCJF
+  7SJIkXQfc9P4B5iASIV1d1FsE0YX+g3jHXPJK/4mGL5bAyBKzpMfQB/mg6vQBzkh
+  aOKPwcreFj7TznBl89R5tNS9wZQfPVR98zgPyocddWhK18eQNMSBUnv4eeJ8PPbk
+  DovL+G8ajHDZ9fjH/+GVYHEMuiVdLarXrKJpHC1VfGTTUAp4NSEpUQ==
+  -----END CERTIFICATE-----
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: aws-sdk-sns
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+- !ruby/object:Gem::Dependency
+  name: json
+  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'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.12'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.12'
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.22'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.22'
+description: Structured logging, CloudWatch metrics (EMF), error handling, and alerting
+  for AWS Lambda functions. Implement serverless best practices with minimal overhead.
+email:
+- andy@stowzilla.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- LICENSE.txt
+- README.md
+- certs/stowzilla.pem
+- lib/lambda_loadout.rb
+- lib/lambda_loadout/error_notifier.rb
+- lib/lambda_loadout/errors.rb
+- lib/lambda_loadout/global.rb
+- lib/lambda_loadout/logger.rb
+- lib/lambda_loadout/metrics.rb
+- lib/lambda_loadout/middleware.rb
+- lib/lambda_loadout/version.rb
+homepage: https://github.com/stowzilla/lambda-loadout
+licenses:
+- MIT
+metadata:
+  rubygems_mfa_required: 'true'
+  homepage_uri: https://github.com/stowzilla/lambda-loadout
+  source_code_uri: https://github.com/stowzilla/lambda-loadout/tree/main
+  changelog_uri: https://github.com/stowzilla/lambda-loadout/blob/main/CHANGELOG.md
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.2'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.6.9
+specification_version: 4
+summary: AWS Lambda Powertools for Ruby - Observability toolkit for AWS Lambda
+test_files: []