Home - News ( United States | United Kingdom | Italy | Germany ) - Football scores

Showing content from https://docs.aws.amazon.com/sdkforruby/api/Aws/Resources/Documenter/HasManyOperationDocumenter.html below:

HasManyOperationDocumenter — AWS SDK for Ruby V2

You are viewing documentation for version 2 of the AWS SDK for Ruby. Version 3 documentation can be found here.

#api_request, #api_request_name, #api_request_params, #builder, #called_operation, #operation_name, #resource_class, #resource_class_name, #source, #target_resource_class, #target_resource_class_name, #yard_class

• #batch_examples_tag ⇒ Object
• #docstring ⇒ Object
• #enumerate_example_tag ⇒ Object
• #enumerate_with_limit_example_tag ⇒ Object
• #example_tags ⇒ Object
• #return_tag ⇒ Object
• #target_resource_batch_operations ⇒ Object
• #target_resource_batches? ⇒ Boolean

#initialize, #method_object

45
46
47
48
49
50
51
52
53
54
55
56

# File 'aws-sdk-resources/lib/aws-sdk-resources/documenter/has_many_operation_documenter.rb', line 45

def batch_examples_tag
  example = []
  example << "@example Batch operations callable on the returned collection"
  target_resource_batch_operations.each do |name, operation|
    if operation.respond_to?(:request)
      example << ""
      example << "  # calls Client##{operation.request.method_name} on each batch"
      example << "  #{variable_name}.#{@operation_name}.#{name}"
    end
  end
  tag(example.join("\n"))
end

6
7
8
9
10
11
12
13

# File 'aws-sdk-resources/lib/aws-sdk-resources/documenter/has_many_operation_documenter.rb', line 6

def docstring
  super + ' ' + <<-DOCSTRING.lstrip
Returns a {Resources::Collection Collection} of {#{target_resource_class_name}}
resources. No API requests are made until you call an enumerable method on the
collection. {#{called_operation}} will be called multiple times until every
{#{target_resource_class_name}} has been yielded.
  DOCSTRING
end

27
28
29
30
31
32
33
34

# File 'aws-sdk-resources/lib/aws-sdk-resources/documenter/has_many_operation_documenter.rb', line 27

def enumerate_example_tag
  tag(<<-EXAMPLE.strip)
@example Enumerating {#{target_resource_class_name}} resources.
  #{variable_name}.#{@operation_name}.each do |#{target_resource_class_name.downcase}|
    # yields each #{target_resource_class_name.downcase}
  end
  EXAMPLE
end

36
37
38
39
40
41
42
43

# File 'aws-sdk-resources/lib/aws-sdk-resources/documenter/has_many_operation_documenter.rb', line 36

def enumerate_with_limit_example_tag
  tag(<<-EXAMPLE.strip)
@example Enumerating {#{target_resource_class_name}} resources with a limit.
  #{variable_name}.#{@operation_name}.limit(10).each do |#{target_resource_class_name.downcase}|
    # yields at most 10 #{@operation_name}
  end
  EXAMPLE
end

19
20
21
22
23
24
25

# File 'aws-sdk-resources/lib/aws-sdk-resources/documenter/has_many_operation_documenter.rb', line 19

def example_tags
  tags = super
  tags << enumerate_example_tag
  tags << enumerate_with_limit_example_tag
  tags << batch_examples_tag if target_resource_batches?
  tags
end

15
16
17

# File 'aws-sdk-resources/lib/aws-sdk-resources/documenter/has_many_operation_documenter.rb', line 15

def return_tag
  tag("@return [Collection<#{target_resource_class_name}>]")
end

62
63
64

# File 'aws-sdk-resources/lib/aws-sdk-resources/documenter/has_many_operation_documenter.rb', line 62

def target_resource_batch_operations
  target_resource_class.batch_operations
end

58
59
60

# File 'aws-sdk-resources/lib/aws-sdk-resources/documenter/has_many_operation_documenter.rb', line 58

def target_resource_batches?
  target_resource_batch_operations.count > 0
end

RetroSearch is an open source project built by @garambo | Open a GitHub Issue

Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo

HTML: 3.2 | Encoding: UTF-8 | Version: 0.7.4