sqs_processor 0.1.1 → 0.1.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6efefaed76c0681bb284588331b52a371f49642879819faa4e102e2a03b4db7f
-  data.tar.gz: 15192a15f7e5d75f584817733a9c8fc50ee2489c4e06273705fa1abc9f7c2499
+  metadata.gz: b236be094b122ba859d742bff3fb3973e70cc9328dcd14244517ac09c4adec45
+  data.tar.gz: 32d709d43420508be56b438e6ae2958efd6ad5aeef23e1a4408fd296a87e0bb0
 SHA512:
-  metadata.gz: 4102296039c1b78b61cf5f7d41ad159465fc45b41678fb8953301ea667220b8a1b656771e7650454a1c3464c6e45fb7ffc6a4402342b78ffb370afde873c43b0
-  data.tar.gz: c497b6a153e6c7a2c4acad647e11180e14f61e6b4037c9591dce3c8f5aca93bd6b9a17c5144c8ac49ae3337a209e4cf3879d8482df1af1fca2417f121f88e035
+  metadata.gz: bc53c5db71dea861a64b1e282e7466ff9378fc664c0fa3bbe0c161189211f31d3ef925b1da122e4d1a29b8c4cb3fcdcc29acefc71ddc9342002cc6166ad22ba4
+  data.tar.gz: 208bb5ac50214e931dc0935a13d01cdac120460ad1c80a10a8fb060890a86cb07ad353d9730eff40f25d8724bb9d75db598a2564ae342de24837b4afbc6b4dac

data/README.md

@@ -58,37 +58,7 @@ DATA_SYNC_SQS_QUEUE_URL=https://sqs.us-east-1.amazonaws.com/123456789012/your-qu
 
 ## Usage
 
-### Command Line Usage
-
-```bash
-sqs_processor [options]
-```
-
-### Command Line Options
-
-```bash
-sqs_processor [options]
-
-Options:
-  -q, --queue-url URL              SQS Queue URL
-  -r, --region REGION              AWS Region
-  -m, --max-messages NUMBER        Max messages per batch (default: 10)
-  -v, --visibility-timeout SECONDS Visibility timeout in seconds (default: 30)
-  -h, --help                       Show this help message
-```
-
-### Examples
-
-```bash
-# Basic usage with environment variables
-sqs_processor
-
-# Specify queue URL and region
-sqs_processor -q https://sqs.us-west-2.amazonaws.com/123456789012/my-queue -r us-west-2
-
-# Custom batch size and visibility timeout
-sqs_processor -m 5 -v 60
-```
+The gem is designed to be used programmatically in your Ruby applications.
 
 ### Programmatic Usage
 
@@ -97,14 +67,14 @@ sqs_processor -m 5 -v 60
 ```ruby
 require 'sqs_processor'
 
-# Create a processor instance
+# Create a processor instance with AWS credentials
 processor = SQSProcessor::Processor.new(
   queue_url: 'https://sqs.us-east-1.amazonaws.com/123456789012/my-queue',
-  region: 'us-east-1',
-  max_messages: 10,
-  visibility_timeout: 30,
   aws_access_key_id: 'your-access-key',
-  aws_secret_access_key: 'your-secret-key'
+  aws_secret_access_key: 'your-secret-key',
+  aws_region: 'us-east-1',
+  max_messages: 10,
+  visibility_timeout: 30
 )
 
 # Start processing messages
@@ -117,8 +87,7 @@ The gem uses a hook-based approach for message processing. You must implement th
 
 ### Hook Method
 
-The `handle_message(message, body)` method receives:
-- `message`: The SQS message object (contains message_id, receipt_handle, etc.)
+The `handle_message(body)` method receives:
 - `body`: The parsed JSON body of the message
 
 Return `true` if processing was successful (message will be deleted from queue), or `false` if processing failed (message will remain in queue for retry).
@@ -141,8 +110,8 @@ To implement custom message processing logic, create a subclass of `SQSProcessor
 require 'sqs_processor'
 
 class MyCustomProcessor < SQSProcessor::Processor
-  def handle_message(message, body)
-    # This method receives the SQS message object and parsed body
+  def handle_message(body)
+    # This method receives the parsed message body
     # Return true if processing was successful, false otherwise
     
     case body['event_type']
@@ -174,9 +143,9 @@ end
 # Usage
 processor = MyCustomProcessor.new(
   queue_url: 'your-queue-url',
-  region: 'us-east-1',
   aws_access_key_id: 'your-access-key',
-  aws_secret_access_key: 'your-secret-key'
+  aws_secret_access_key: 'your-secret-key',
+  aws_region: 'us-east-1'
 )
 processor.process_messages
 ```
@@ -188,13 +157,12 @@ processor.process_messages
 The `SQSProcessor::Processor.new` method accepts the following parameters:
 
 - `queue_url:` (required) - The SQS queue URL
-- `region:` (optional, default: 'us-east-1') - AWS region
+- `aws_access_key_id:` (required) - AWS access key ID
+- `aws_secret_access_key:` (required) - AWS secret access key
+- `aws_region:` (optional, default: 'us-east-1') - AWS region
+- `aws_session_token:` (optional) - AWS session token for temporary credentials
 - `max_messages:` (optional, default: 10) - Maximum messages per batch
 - `visibility_timeout:` (optional, default: 30) - Message visibility timeout in seconds
-- `aws_access_key_id:` (optional) - AWS access key ID
-- `aws_secret_access_key:` (optional) - AWS secret access key
-- `aws_session_token:` (optional) - AWS session token for temporary credentials
-- `aws_credentials:` (optional) - Pre-configured AWS credentials object
 - `logger:` (optional) - Custom logger instance
 
 ### Environment Variables

data/lib/sqs_processor/processor.rb

@@ -11,20 +11,14 @@ module SQSProcessor
   class Processor
     attr_reader :sqs_client, :queue_url, :logger
 
-    def initialize(queue_url:, region: 'us-east-1', max_messages: 10, visibility_timeout: 30,
-                   aws_access_key_id: nil, aws_secret_access_key: nil, aws_session_token: nil,
-                   aws_credentials: nil, logger: nil)
+    def initialize(queue_url:, aws_access_key_id:, aws_secret_access_key:, aws_region: 'us-east-1',
+                   aws_session_token: nil, max_messages: 10, visibility_timeout: 30, logger: nil)
       @queue_url = queue_url
-      @region = region
       @max_messages = max_messages
       @visibility_timeout = visibility_timeout
-      @aws_credentials = aws_credentials
-      @aws_access_key_id = aws_access_key_id
-      @aws_secret_access_key = aws_secret_access_key
-      @aws_session_token = aws_session_token
 
       setup_logger(logger)
-      setup_sqs_client
+      setup_sqs_client(aws_access_key_id, aws_secret_access_key, aws_session_token, aws_region)
 
       raise 'Queue URL is required.' unless @queue_url
     end
@@ -37,19 +31,10 @@ module SQSProcessor
       end
     end
 
-    def setup_sqs_client
-      credentials = if @aws_credentials
-                      @aws_credentials
-                    elsif @aws_access_key_id && @aws_secret_access_key
-                      Aws::Credentials.new(@aws_access_key_id, @aws_secret_access_key, @aws_session_token)
-                    elsif ENV['DATA_SYNC_AWS_ACCESS_KEY_ID'] && ENV['DATA_SYNC_AWS_SECRET_ACCESS_KEY']
-                      Aws::Credentials.new(ENV['DATA_SYNC_AWS_ACCESS_KEY_ID'], ENV['DATA_SYNC_AWS_SECRET_ACCESS_KEY'])
-                    else
-                      Aws::Credentials.new
-                    end
-
+    def setup_sqs_client(aws_access_key_id, aws_secret_access_key, aws_session_token, aws_region)
+      credentials = Aws::Credentials.new(aws_access_key_id, aws_secret_access_key, aws_session_token)
       @sqs_client = Aws::SQS::Client.new(
-        region: @region,
+        region: aws_region,
         credentials: credentials
       )
     end

data/lib/sqs_processor/version.rb

@@ -1,3 +1,3 @@
 module SQSProcessor
-  VERSION = "0.1.1"
+  VERSION = "0.1.2"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: sqs_processor
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.1.2
 platform: ruby
 authors:
 - Unni Tallman
@@ -125,14 +125,12 @@ description: A comprehensive Ruby gem for processing messages from Amazon SQS qu
   with configurable message handling, error recovery, and extensible processing logic.
 email:
 - unni@bigbinary.com
-executables:
-- sqs_processor
+executables: []
 extensions: []
 extra_rdoc_files: []
 files:
 - LICENSE
 - README.md
-- bin/sqs_processor
 - lib/sqs_processor.rb
 - lib/sqs_processor/processor.rb
 - lib/sqs_processor/version.rb

data/bin/sqs_processor

@@ -1,77 +0,0 @@
-#!/usr/bin/env ruby
-
-require 'sqs_processor'
-require 'optparse'
-
-def parse_options
-  options = {
-    queue_url: nil,
-    region: nil,
-    max_messages: 10,
-    visibility_timeout: 30
-  }
-
-  OptionParser.new do |opts|
-    opts.banner = 'Usage: sqs_processor [options]'
-
-    opts.on('-q', '--queue-url URL', 'SQS Queue URL') do |url|
-      options[:queue_url] = url
-    end
-
-    opts.on('-r', '--region REGION', 'AWS Region') do |region|
-      options[:region] = region
-    end
-
-    opts.on('-m', '--max-messages NUMBER', Integer, 'Max messages per batch (default: 10)') do |num|
-      options[:max_messages] = num
-    end
-
-    opts.on('-v', '--visibility-timeout SECONDS', Integer, 'Visibility timeout in seconds (default: 30)') do |timeout|
-      options[:visibility_timeout] = timeout
-    end
-
-    opts.on('-h', '--help', 'Show this help message') do
-      puts opts
-      exit
-    end
-  end.parse!
-
-  options
-end
-
-if __FILE__ == $0
-  options = parse_options
-
-  begin
-    # Load environment variables
-    Dotenv.load
-
-    # Get queue URL from options or environment
-    queue_url = options[:queue_url] || ENV.fetch('DATA_SYNC_SQS_QUEUE_URL', nil)
-
-    unless queue_url
-      puts 'Error: Queue URL is required. Set DATA_SYNC_SQS_QUEUE_URL environment variable or use -q option.'
-      exit 1
-    end
-
-    processor = SQSProcessor::Processor.new(
-      queue_url: queue_url,
-      region: options[:region] || ENV['DATA_SYNC_AWS_REGION'] || 'us-east-1',
-      max_messages: options[:max_messages],
-      visibility_timeout: options[:visibility_timeout],
-      aws_access_key_id: ENV.fetch('DATA_SYNC_AWS_ACCESS_KEY_ID', nil),
-      aws_secret_access_key: ENV.fetch('DATA_SYNC_AWS_SECRET_ACCESS_KEY', nil),
-      aws_session_token: ENV.fetch('DATA_SYNC_AWS_SESSION_TOKEN', nil)
-    )
-
-    # Show queue attributes before starting
-    processor.get_queue_attributes
-
-    # Start processing messages
-    processor.process_messages
-  rescue StandardError => e
-    puts "Error: #{e.message}"
-    puts e.backtrace.join("\n")
-    exit 1
-  end
-end