twilio-ruby 5.45.1 → 5.49.0

data/lib/twilio-ruby/rest/video/v1/composition.rb

@@ -155,20 +155,21 @@ module Twilio
           #   Layouts}[https://www.twilio.com/docs/video/api/compositions-resource#specifying-video-layouts]
           #   for more info. Please, be aware that either video_layout or audio_sources have
           #   to be provided to get a valid creation request
-          # @param [String] audio_sources An array of track names from the same group room
-          #   to merge into the new composition. Can include zero or more track names. The new
-          #   composition includes all audio sources specified in `audio_sources` except for
-          #   those specified in `audio_sources_excluded`. The track names in this parameter
-          #   can include an asterisk as a wild card character, which will match zero or more
-          #   characters in a track name. For example, `student*` includes `student` as well
-          #   as `studentTeam`. Please, be aware that either video_layout or audio_sources
-          #   have to be provided to get a valid creation request
-          # @param [String] audio_sources_excluded An array of track names to exclude. The
-          #   new composition includes all audio sources specified in `audio_sources` except
-          #   for those specified in `audio_sources_excluded`. The track names in this
+          # @param [Array[String]] audio_sources An array of track names from the same group
+          #   room to merge into the new composition. Can include zero or more track names.
+          #   The new composition includes all audio sources specified in `audio_sources`
+          #   except for those specified in `audio_sources_excluded`. The track names in this
           #   parameter can include an asterisk as a wild card character, which will match
-          #   zero or more characters in a track name. For example, `student*` excludes
-          #   `student` as well as `studentTeam`. This parameter can also be empty.
+          #   zero or more characters in a track name. For example, `student*` includes
+          #   `student` as well as `studentTeam`. Please, be aware that either video_layout or
+          #   audio_sources have to be provided to get a valid creation request
+          # @param [Array[String]] audio_sources_excluded An array of track names to
+          #   exclude. The new composition includes all audio sources specified in
+          #   `audio_sources` except for those specified in `audio_sources_excluded`. The
+          #   track names in this parameter can include an asterisk as a wild card character,
+          #   which will match zero or more characters in a track name. For example,
+          #   `student*` excludes `student` as well as `studentTeam`. This parameter can also
+          #   be empty.
           # @param [String] resolution A string that describes the columns (width) and rows
           #   (height) of the generated composed video in pixels. Defaults to `640x480`.
           #   The string's format is `{width}x{height}` where:
@@ -404,13 +405,13 @@ module Twilio
           end
 
           ##
-          # @return [String] The array of track names to include in the composition
+          # @return [Array[String]] The array of track names to include in the composition
           def audio_sources
             @properties['audio_sources']
           end
 
           ##
-          # @return [String] The array of track names to exclude from the composition
+          # @return [Array[String]] The array of track names to exclude from the composition
           def audio_sources_excluded
             @properties['audio_sources_excluded']
           end

data/lib/twilio-ruby/rest/video/v1/composition_hook.rb

@@ -167,17 +167,17 @@ module Twilio
           #   composition hook in terms of regions. See {Specifying Video
           #   Layouts}[https://www.twilio.com/docs/video/api/compositions-resource#specifying-video-layouts]
           #   for more info.
-          # @param [String] audio_sources An array of track names from the same group room
-          #   to merge into the compositions created by the composition hook. Can include zero
-          #   or more track names. A composition triggered by the composition hook includes
-          #   all audio sources specified in `audio_sources` except those specified in
-          #   `audio_sources_excluded`. The track names in this parameter can include an
+          # @param [Array[String]] audio_sources An array of track names from the same group
+          #   room to merge into the compositions created by the composition hook. Can include
+          #   zero or more track names. A composition triggered by the composition hook
+          #   includes all audio sources specified in `audio_sources` except those specified
+          #   in `audio_sources_excluded`. The track names in this parameter can include an
           #   asterisk as a wild card character, which matches zero or more characters in a
           #   track name. For example, `student*` includes tracks named `student` as well as
           #   `studentTeam`.
-          # @param [String] audio_sources_excluded An array of track names to exclude. A
-          #   composition triggered by the composition hook includes all audio sources
-          #   specified in `audio_sources` except for those specified in
+          # @param [Array[String]] audio_sources_excluded An array of track names to
+          #   exclude. A composition triggered by the composition hook includes all audio
+          #   sources specified in `audio_sources` except for those specified in
           #   `audio_sources_excluded`. The track names in this parameter can include an
           #   asterisk as a wild card character, which matches zero or more characters in a
           #   track name. For example, `student*` excludes `student` as well as `studentTeam`.
@@ -323,17 +323,17 @@ module Twilio
           #   composition hook in terms of regions. See {Specifying Video
           #   Layouts}[https://www.twilio.com/docs/video/api/compositions-resource#specifying-video-layouts]
           #   for more info.
-          # @param [String] audio_sources An array of track names from the same group room
-          #   to merge into the compositions created by the composition hook. Can include zero
-          #   or more track names. A composition triggered by the composition hook includes
-          #   all audio sources specified in `audio_sources` except those specified in
-          #   `audio_sources_excluded`. The track names in this parameter can include an
+          # @param [Array[String]] audio_sources An array of track names from the same group
+          #   room to merge into the compositions created by the composition hook. Can include
+          #   zero or more track names. A composition triggered by the composition hook
+          #   includes all audio sources specified in `audio_sources` except those specified
+          #   in `audio_sources_excluded`. The track names in this parameter can include an
           #   asterisk as a wild card character, which matches zero or more characters in a
           #   track name. For example, `student*` includes tracks named `student` as well as
           #   `studentTeam`.
-          # @param [String] audio_sources_excluded An array of track names to exclude. A
-          #   composition triggered by the composition hook includes all audio sources
-          #   specified in `audio_sources` except for those specified in
+          # @param [Array[String]] audio_sources_excluded An array of track names to
+          #   exclude. A composition triggered by the composition hook includes all audio
+          #   sources specified in `audio_sources` except for those specified in
           #   `audio_sources_excluded`. The track names in this parameter can include an
           #   asterisk as a wild card character, which matches zero or more characters in a
           #   track name. For example, `student*` excludes `student` as well as `studentTeam`.
@@ -496,13 +496,13 @@ module Twilio
           end
 
           ##
-          # @return [String] The array of track names to include in the compositions created by the composition hook
+          # @return [Array[String]] The array of track names to include in the compositions created by the composition hook
           def audio_sources
             @properties['audio_sources']
           end
 
           ##
-          # @return [String] The array of track names to exclude from the compositions created by the composition hook
+          # @return [Array[String]] The array of track names to exclude from the compositions created by the composition hook
           def audio_sources_excluded
             @properties['audio_sources_excluded']
           end
@@ -575,17 +575,17 @@ module Twilio
           #   composition hook in terms of regions. See {Specifying Video
           #   Layouts}[https://www.twilio.com/docs/video/api/compositions-resource#specifying-video-layouts]
           #   for more info.
-          # @param [String] audio_sources An array of track names from the same group room
-          #   to merge into the compositions created by the composition hook. Can include zero
-          #   or more track names. A composition triggered by the composition hook includes
-          #   all audio sources specified in `audio_sources` except those specified in
-          #   `audio_sources_excluded`. The track names in this parameter can include an
+          # @param [Array[String]] audio_sources An array of track names from the same group
+          #   room to merge into the compositions created by the composition hook. Can include
+          #   zero or more track names. A composition triggered by the composition hook
+          #   includes all audio sources specified in `audio_sources` except those specified
+          #   in `audio_sources_excluded`. The track names in this parameter can include an
           #   asterisk as a wild card character, which matches zero or more characters in a
           #   track name. For example, `student*` includes tracks named `student` as well as
           #   `studentTeam`.
-          # @param [String] audio_sources_excluded An array of track names to exclude. A
-          #   composition triggered by the composition hook includes all audio sources
-          #   specified in `audio_sources` except for those specified in
+          # @param [Array[String]] audio_sources_excluded An array of track names to
+          #   exclude. A composition triggered by the composition hook includes all audio
+          #   sources specified in `audio_sources` except for those specified in
           #   `audio_sources_excluded`. The track names in this parameter can include an
           #   asterisk as a wild card character, which matches zero or more characters in a
           #   track name. For example, `student*` excludes `student` as well as `studentTeam`.

data/lib/twilio-ruby/rest/video/v1/recording.rb

@@ -30,8 +30,8 @@ module Twilio
           # @param [recording.Status] status Read only the recordings that have this status.
           #   Can be: `processing`, `completed`, or `deleted`.
           # @param [String] source_sid Read only the recordings that have this `source_sid`.
-          # @param [String] grouping_sid Read only recordings with this `grouping_sid`,
-          #   which may include a `participant_sid` and/or a `room_sid`.
+          # @param [Array[String]] grouping_sid Read only recordings with this
+          #   `grouping_sid`, which may include a `participant_sid` and/or a `room_sid`.
           # @param [Time] date_created_after Read only recordings that started on or after
           #   this {ISO 8601}[https://en.wikipedia.org/wiki/ISO_8601] date-time with time
           #   zone.
@@ -67,8 +67,8 @@ module Twilio
           # @param [recording.Status] status Read only the recordings that have this status.
           #   Can be: `processing`, `completed`, or `deleted`.
           # @param [String] source_sid Read only the recordings that have this `source_sid`.
-          # @param [String] grouping_sid Read only recordings with this `grouping_sid`,
-          #   which may include a `participant_sid` and/or a `room_sid`.
+          # @param [Array[String]] grouping_sid Read only recordings with this
+          #   `grouping_sid`, which may include a `participant_sid` and/or a `room_sid`.
           # @param [Time] date_created_after Read only recordings that started on or after
           #   this {ISO 8601}[https://en.wikipedia.org/wiki/ISO_8601] date-time with time
           #   zone.
@@ -120,8 +120,8 @@ module Twilio
           # @param [recording.Status] status Read only the recordings that have this status.
           #   Can be: `processing`, `completed`, or `deleted`.
           # @param [String] source_sid Read only the recordings that have this `source_sid`.
-          # @param [String] grouping_sid Read only recordings with this `grouping_sid`,
-          #   which may include a `participant_sid` and/or a `room_sid`.
+          # @param [Array[String]] grouping_sid Read only recordings with this
+          #   `grouping_sid`, which may include a `participant_sid` and/or a `room_sid`.
           # @param [Time] date_created_after Read only recordings that started on or after
           #   this {ISO 8601}[https://en.wikipedia.org/wiki/ISO_8601] date-time with time
           #   zone.

data/lib/twilio-ruby/rest/video/v1/room.rb

@@ -48,8 +48,8 @@ module Twilio
           # @param [Boolean] record_participants_on_connect Whether to start recording when
           #   Participants connect. ***This feature is not available in `peer-to-peer`
           #   rooms.***
-          # @param [room.VideoCodec] video_codecs An array of the video codecs that are
-          #   supported when publishing a track in the room.  Can be: `VP8` and `H264`.
+          # @param [Array[room.VideoCodec]] video_codecs An array of the video codecs that
+          #   are supported when publishing a track in the room.  Can be: `VP8` and `H264`.
           #   ***This feature is not available in `peer-to-peer` rooms***
           # @param [String] media_region The region for the media server in Group Rooms.
           #   Can be: one of the {available Media
@@ -357,6 +357,7 @@ module Twilio
                 'duration' => payload['duration'] == nil ? payload['duration'] : payload['duration'].to_i,
                 'type' => payload['type'],
                 'max_participants' => payload['max_participants'].to_i,
+                'max_concurrent_published_tracks' => payload['max_concurrent_published_tracks'] == nil ? payload['max_concurrent_published_tracks'] : payload['max_concurrent_published_tracks'].to_i,
                 'record_participants_on_connect' => payload['record_participants_on_connect'],
                 'video_codecs' => payload['video_codecs'],
                 'media_region' => payload['media_region'],
@@ -458,6 +459,12 @@ module Twilio
             @properties['max_participants']
           end
 
+          ##
+          # @return [String] The maximum number of published tracks allowed in the room at the same time
+          def max_concurrent_published_tracks
+            @properties['max_concurrent_published_tracks']
+          end
+
           ##
           # @return [Boolean] Whether to start recording when Participants connect
           def record_participants_on_connect
@@ -465,7 +472,7 @@ module Twilio
           end
 
           ##
-          # @return [room.VideoCodec] An array of the video codecs that are supported when publishing a track in the room
+          # @return [Array[room.VideoCodec]] An array of the video codecs that are supported when publishing a track in the room
           def video_codecs
             @properties['video_codecs']
           end

data/lib/twilio-ruby/rest/video/v1/room/room_participant/room_participant_subscribe_rule.rb

@@ -138,7 +138,7 @@ module Twilio
               end
 
               ##
-              # @return [String] A collection of Subscribe Rules that describe how to include or exclude matching tracks
+              # @return [Array[String]] A collection of Subscribe Rules that describe how to include or exclude matching tracks
               def rules
                 @properties['rules']
               end

data/lib/twilio-ruby/rest/video/v1/room/room_recording_rule.rb

@@ -114,7 +114,7 @@ module Twilio
             end
 
             ##
-            # @return [String] A collection of recording Rules that describe how to include or exclude matching tracks for recording
+            # @return [Array[String]] A collection of recording Rules that describe how to include or exclude matching tracks for recording
             def rules
               @properties['rules']
             end

data/lib/twilio-ruby/rest/voice/v1.rb

@@ -29,11 +29,12 @@ module Twilio
         # @return [Twilio::REST::Voice::V1::ByocTrunkList]
         def byoc_trunks(sid=:unset)
           if sid.nil?
-            raise ArgumentError, 'sid cannot be nil'
-          elsif sid == :unset
-            @byoc_trunks ||= ByocTrunkList.new self
+              raise ArgumentError, 'sid cannot be nil'
+          end
+          if sid == :unset
+              @byoc_trunks ||= ByocTrunkList.new self
           else
-            ByocTrunkContext.new(self, sid)
+              ByocTrunkContext.new(self, sid)
           end
         end
 
@@ -44,11 +45,12 @@ module Twilio
         # @return [Twilio::REST::Voice::V1::ConnectionPolicyList]
         def connection_policies(sid=:unset)
           if sid.nil?
-            raise ArgumentError, 'sid cannot be nil'
-          elsif sid == :unset
-            @connection_policies ||= ConnectionPolicyList.new self
+              raise ArgumentError, 'sid cannot be nil'
+          end
+          if sid == :unset
+              @connection_policies ||= ConnectionPolicyList.new self
           else
-            ConnectionPolicyContext.new(self, sid)
+              ConnectionPolicyContext.new(self, sid)
           end
         end
 
@@ -65,11 +67,12 @@ module Twilio
         # @return [Twilio::REST::Voice::V1::IpRecordList]
         def ip_records(sid=:unset)
           if sid.nil?
-            raise ArgumentError, 'sid cannot be nil'
-          elsif sid == :unset
-            @ip_records ||= IpRecordList.new self
+              raise ArgumentError, 'sid cannot be nil'
+          end
+          if sid == :unset
+              @ip_records ||= IpRecordList.new self
           else
-            IpRecordContext.new(self, sid)
+              IpRecordContext.new(self, sid)
           end
         end
 
@@ -80,11 +83,12 @@ module Twilio
         # @return [Twilio::REST::Voice::V1::SourceIpMappingList]
         def source_ip_mappings(sid=:unset)
           if sid.nil?
-            raise ArgumentError, 'sid cannot be nil'
-          elsif sid == :unset
-            @source_ip_mappings ||= SourceIpMappingList.new self
+              raise ArgumentError, 'sid cannot be nil'
+          end
+          if sid == :unset
+              @source_ip_mappings ||= SourceIpMappingList.new self
           else
-            SourceIpMappingContext.new(self, sid)
+              SourceIpMappingContext.new(self, sid)
           end
         end
 

data/lib/twilio-ruby/rest/voice/v1/dialing_permissions/country.rb

@@ -334,7 +334,7 @@ module Twilio
             end
 
             ##
-            # @return [String] The E.164 assigned country codes(s)
+            # @return [Array[String]] The E.164 assigned country codes(s)
             def country_codes
               @properties['country_codes']
             end

data/lib/twilio-ruby/rest/wireless/v1.rb

@@ -33,11 +33,12 @@ module Twilio
         # @return [Twilio::REST::Wireless::V1::CommandList]
         def commands(sid=:unset)
           if sid.nil?
-            raise ArgumentError, 'sid cannot be nil'
-          elsif sid == :unset
-            @commands ||= CommandList.new self
+              raise ArgumentError, 'sid cannot be nil'
+          end
+          if sid == :unset
+              @commands ||= CommandList.new self
           else
-            CommandContext.new(self, sid)
+              CommandContext.new(self, sid)
           end
         end
 
@@ -47,11 +48,12 @@ module Twilio
         # @return [Twilio::REST::Wireless::V1::RatePlanList]
         def rate_plans(sid=:unset)
           if sid.nil?
-            raise ArgumentError, 'sid cannot be nil'
-          elsif sid == :unset
-            @rate_plans ||= RatePlanList.new self
+              raise ArgumentError, 'sid cannot be nil'
+          end
+          if sid == :unset
+              @rate_plans ||= RatePlanList.new self
           else
-            RatePlanContext.new(self, sid)
+              RatePlanContext.new(self, sid)
           end
         end
 
@@ -61,11 +63,12 @@ module Twilio
         # @return [Twilio::REST::Wireless::V1::SimList]
         def sims(sid=:unset)
           if sid.nil?
-            raise ArgumentError, 'sid cannot be nil'
-          elsif sid == :unset
-            @sims ||= SimList.new self
+              raise ArgumentError, 'sid cannot be nil'
+          end
+          if sid == :unset
+              @sims ||= SimList.new self
           else
-            SimContext.new(self, sid)
+              SimContext.new(self, sid)
           end
         end
 

data/lib/twilio-ruby/rest/wireless/v1/rate_plan.rb

@@ -127,9 +127,9 @@ module Twilio
           # @param [Boolean] national_roaming_enabled Whether SIMs can roam on networks
           #   other than the home network (T-Mobile USA) in the United States. See {national
           #   roaming}[https://www.twilio.com/docs/wireless/api/rateplan-resource#national-roaming].
-          # @param [String] international_roaming The list of services that SIMs capable of
-          #   using GPRS/3G/4G/LTE data connectivity can use outside of the United States. Can
-          #   be: `data`, `voice`, and `messaging`.
+          # @param [Array[String]] international_roaming The list of services that SIMs
+          #   capable of using GPRS/3G/4G/LTE data connectivity can use outside of the United
+          #   States. Can be: `data`, `voice`, and `messaging`.
           # @param [String] national_roaming_data_limit The total data usage (download and
           #   upload combined) in Megabytes that the Network allows during one month on
           #   non-home networks in the United States. The metering period begins the day of
@@ -371,7 +371,7 @@ module Twilio
           end
 
           ##
-          # @return [String] The services that SIMs capable of using GPRS/3G/4G/LTE data connectivity can use outside of the United States
+          # @return [Array[String]] The services that SIMs capable of using GPRS/3G/4G/LTE data connectivity can use outside of the United States
           def international_roaming
             @properties['international_roaming']
           end

data/lib/twilio-ruby/twiml/voice_response.rb

@@ -48,9 +48,11 @@ module Twilio
       # ring_tone:: Ringtone allows you to override the ringback tone that Twilio will play back to the caller while executing the Dial
       # recording_track:: To indicate which audio track should be recorded
       # sequential:: Used to determine if child TwiML nouns should be dialed in order, one after the other (sequential) or dial all at once (parallel). Default is false, parallel
+      # refer_url:: Webhook that will receive future SIP REFER requests
+      # refer_method:: The HTTP method to use for the refer Webhook
       # keyword_args:: additional attributes
-      def dial(number: nil, action: nil, method: nil, timeout: nil, hangup_on_star: nil, time_limit: nil, caller_id: nil, record: nil, trim: nil, recording_status_callback: nil, recording_status_callback_method: nil, recording_status_callback_event: nil, answer_on_bridge: nil, ring_tone: nil, recording_track: nil, sequential: nil, **keyword_args)
-        dial = Dial.new(number: number, action: action, method: method, timeout: timeout, hangup_on_star: hangup_on_star, time_limit: time_limit, caller_id: caller_id, record: record, trim: trim, recording_status_callback: recording_status_callback, recording_status_callback_method: recording_status_callback_method, recording_status_callback_event: recording_status_callback_event, answer_on_bridge: answer_on_bridge, ring_tone: ring_tone, recording_track: recording_track, sequential: sequential, **keyword_args)
+      def dial(number: nil, action: nil, method: nil, timeout: nil, hangup_on_star: nil, time_limit: nil, caller_id: nil, record: nil, trim: nil, recording_status_callback: nil, recording_status_callback_method: nil, recording_status_callback_event: nil, answer_on_bridge: nil, ring_tone: nil, recording_track: nil, sequential: nil, refer_url: nil, refer_method: nil, **keyword_args)
+        dial = Dial.new(number: number, action: action, method: method, timeout: timeout, hangup_on_star: hangup_on_star, time_limit: time_limit, caller_id: caller_id, record: record, trim: trim, recording_status_callback: recording_status_callback, recording_status_callback_method: recording_status_callback_method, recording_status_callback_event: recording_status_callback_event, answer_on_bridge: answer_on_bridge, ring_tone: ring_tone, recording_track: recording_track, sequential: sequential, refer_url: refer_url, refer_method: refer_method, **keyword_args)
 
         yield(dial) if block_given?
         append(dial)
@@ -337,9 +339,11 @@ module Twilio
       # connector_name:: Unique name for Stream Connector
       # url:: URL of the remote service where the Stream is routed
       # track:: Track to be streamed to remote service
+      # status_callback:: Status Callback URL
+      # status_callback_method:: Status Callback URL method
       # keyword_args:: additional attributes
-      def stream(name: nil, connector_name: nil, url: nil, track: nil, **keyword_args)
-        stream = Stream.new(name: name, connector_name: connector_name, url: url, track: track, **keyword_args)
+      def stream(name: nil, connector_name: nil, url: nil, track: nil, status_callback: nil, status_callback_method: nil, **keyword_args)
+        stream = Stream.new(name: name, connector_name: connector_name, url: url, track: track, status_callback: status_callback, status_callback_method: status_callback_method, **keyword_args)
 
         yield(stream) if block_given?
         append(stream)
@@ -426,9 +430,11 @@ module Twilio
       # connector_name:: Unique name for Stream Connector
       # url:: URL of the remote service where the Stream is routed
       # track:: Track to be streamed to remote service
+      # status_callback:: Status Callback URL
+      # status_callback_method:: Status Callback URL method
       # keyword_args:: additional attributes
-      def stream(name: nil, connector_name: nil, url: nil, track: nil, **keyword_args)
-        stream = Stream.new(name: name, connector_name: connector_name, url: url, track: track, **keyword_args)
+      def stream(name: nil, connector_name: nil, url: nil, track: nil, status_callback: nil, status_callback_method: nil, **keyword_args)
+        stream = Stream.new(name: name, connector_name: connector_name, url: url, track: track, status_callback: status_callback, status_callback_method: status_callback_method, **keyword_args)
 
         yield(stream) if block_given?
         append(stream)
@@ -1144,13 +1150,37 @@ module Twilio
       # connector_name:: Unique name for Stream Connector
       # url:: URL of the remote service where the Stream is routed
       # track:: Track to be streamed to remote service
+      # status_callback:: Status Callback URL
+      # status_callback_method:: Status Callback URL method
       # keyword_args:: additional attributes
-      def stream(name: nil, connector_name: nil, url: nil, track: nil, **keyword_args)
-        stream = Stream.new(name: name, connector_name: connector_name, url: url, track: track, **keyword_args)
+      def stream(name: nil, connector_name: nil, url: nil, track: nil, status_callback: nil, status_callback_method: nil, **keyword_args)
+        stream = Stream.new(name: name, connector_name: connector_name, url: url, track: track, status_callback: status_callback, status_callback_method: status_callback_method, **keyword_args)
 
         yield(stream) if block_given?
         append(stream)
       end
+
+      ##
+      # Create a new <VirtualAgent> element
+      # connector_name:: Defines the conversation profile Dialogflow needs to use
+      # language:: Language to be used by Dialogflow to transcribe speech
+      # sentiment_analysis:: Whether sentiment analysis needs to be enabled or not
+      # status_callback:: URL to post status callbacks from Twilio
+      # keyword_args:: additional attributes
+      def virtual_agent(connector_name: nil, language: nil, sentiment_analysis: nil, status_callback: nil, **keyword_args)
+        append(VirtualAgent.new(connector_name: connector_name, language: language, sentiment_analysis: sentiment_analysis, status_callback: status_callback, **keyword_args))
+      end
+    end
+
+    ##
+    # <VirtualAgent> TwiML Noun
+    class VirtualAgent < TwiML
+      def initialize(**keyword_args)
+        super(**keyword_args)
+        @name = 'VirtualAgent'
+
+        yield(self) if block_given?
+      end
     end
 
     ##