File: sqs.rb

package info (click to toggle)
ruby-aws-sdk 1.67.0-2
  • links: PTS, VCS
  • area: main
  • in suites: bookworm, bullseye, buster
  • size: 6,840 kB
  • sloc: ruby: 28,436; makefile: 7
file content (80 lines) | stat: -rw-r--r-- 2,519 bytes parent folder | download | duplicates (4)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
# Copyright 2011-2013 Amazon.com, Inc. or its affiliates. All Rights Reserved.
#
# Licensed under the Apache License, Version 2.0 (the "License"). You
# may not use this file except in compliance with the License. A copy of
# the License is located at
#
#     http://aws.amazon.com/apache2.0/
#
# or in the "license" file accompanying this file. This file is
# distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF
# ANY KIND, either express or implied. See the License for the specific
# language governing permissions and limitations under the License.

require 'aws/core'
require 'aws/sqs/config'

module AWS

  # Provides an expressive, object-oriented interface to Amazon SQS.
  #
  # ## Credentials
  #
  # You can setup default credentials for all AWS services via
  # AWS.config:
  #
  #     AWS.config(
  #       :access_key_id => 'YOUR_ACCESS_KEY_ID',
  #       :secret_access_key => 'YOUR_SECRET_ACCESS_KEY')
  #
  # Or you can set them directly on the SQS interface:
  #
  #     sqs = AWS::SQS.new(
  #       :access_key_id => 'YOUR_ACCESS_KEY_ID',
  #       :secret_access_key => 'YOUR_SECRET_ACCESS_KEY')
  #
  # ## Queues and Messages
  #
  # Amazon SQS is a distributed queue system that enables web
  # service applications to quickly and reliably queue messages that
  # one component in the application generates to be consumed by
  # another component. A queue is a temporary repository for
  # messages that are awaiting processing.
  #
  # You can access your queues using the {#queues} collection.  For
  # example, to create a queue, use {QueueCollection#create}:
  #
  #     queue = sqs.queues.create("myqueue")
  #
  # Or to find out what queues you have in your account:
  #
  #     pp sqs.queues.collect(&:url)
  #
  # See the {Queue} class for more information on how to send and
  # receive messages.
  #
  # @!attribute [r] client
  #   @return [Client] the low-level SQS client object
  class SQS

    autoload :Client, 'aws/sqs/client'
    autoload :Errors, 'aws/sqs/errors'
    autoload :Queue, 'aws/sqs/queue'
    autoload :QueueCollection, 'aws/sqs/queue_collection'
    autoload :Policy, 'aws/sqs/policy'
    autoload :ReceivedMessage, 'aws/sqs/received_message'
    autoload :ReceivedSNSMessage, 'aws/sqs/received_sns_message'

    include Core::ServiceInterface

    endpoint_prefix 'sqs'

    # @return [QueueCollection] The collection of all {Queue}
    #   objects in your account.
    def queues
      QueueCollection.new(:config => config)
    end

  end

end