ably-rest 1.0.5 → 1.1.3

data/lib/submodules/ably-ruby/lib/ably/models/idiomatic_ruby_wrapper.rb

@@ -144,11 +144,11 @@ module Ably::Models
       @attributes
     end
 
-    # Takes the underlying Hash object and returns it in as a JSON ready Hash object using snakeCase for compability with the Ably service.
+    # Takes the underlying Hash object and returns it in as a JSON ready Hash object using camelCase for compability with the Ably service.
     # Note name clashes are ignored and will result in loss of one or more values
     # @example
     #   wrapper = IdiomaticRubyWrapper({ 'mixedCase': true, mixed_case: false, 'snake_case': 1 })
-    #   wrapper.as_json({ 'mixedCase': true, 'snakeCase': 1 })
+    #   wrapper.as_json => { 'mixedCase': true, 'snakeCase': 1 }
     def as_json(*args)
       attributes.each_with_object({}) do |key_val, new_hash|
         key                      = key_val[0]
@@ -161,7 +161,7 @@ module Ably::Models
     end
 
     # Converts the current wrapped mixedCase object to JSON
-    # using mixedCase syntax as expected by the Realtime API
+    # using snakedCase syntax as expected by the Realtime API
     def to_json(*args)
       as_json(args).to_json
     end
@@ -170,7 +170,7 @@ module Ably::Models
     # Note name clashes are ignored and will result in loss of one or more values
     # @example
     #   wrapper = IdiomaticRubyWrapper({ 'mixedCase': true, mixed_case: false, 'snake_case': 1 })
-    #   wrapper.to_hash({ mixed_case: true, snake_case: 1 })
+    #   wrapper.to_hash => { mixed_case: true, snake_case: 1 }
     def to_hash(*args)
       each_with_object({}) do |key_val, object|
         key, val    = key_val
@@ -210,14 +210,14 @@ module Ably::Models
     # key is not found in mixedCase.
     def source_key_for(symbolized_key)
       format_preferences = [
-        proc { |key_sym| convert_to_mixed_case(key_sym) },
-        proc { |key_sym| key_sym.to_sym },
-        proc { |key_sym| key_sym.to_s },
-        proc { |key_sym| convert_to_mixed_case(key_sym).to_sym },
-        proc { |key_sym| convert_to_lower_case(key_sym) },
-        proc { |key_sym| convert_to_lower_case(key_sym).to_sym },
-        proc { |key_sym| convert_to_mixed_case(key_sym, force_camel: true) },
-        proc { |key_sym| convert_to_mixed_case(key_sym, force_camel: true).to_sym }
+        lambda { |key_sym| convert_to_mixed_case(key_sym) },
+        lambda { |key_sym| key_sym.to_sym },
+        lambda { |key_sym| key_sym.to_s },
+        lambda { |key_sym| convert_to_mixed_case(key_sym).to_sym },
+        lambda { |key_sym| convert_to_lower_case(key_sym) },
+        lambda { |key_sym| convert_to_lower_case(key_sym).to_sym },
+        lambda { |key_sym| convert_to_mixed_case(key_sym, force_camel: true) },
+        lambda { |key_sym| convert_to_mixed_case(key_sym, force_camel: true).to_sym }
       ]
 
       preferred_format = format_preferences.detect do |format|

data/lib/submodules/ably-ruby/lib/ably/models/message.rb

@@ -62,9 +62,11 @@ module Ably::Models
 
       set_attributes_object attributes
 
-      ensure_utf_8 :name,      name,      allow_nil: true
-      ensure_utf_8 :client_id, client_id, allow_nil: true
-      ensure_utf_8 :encoding,  encoding,  allow_nil: true
+      self.attributes[:name] = ensure_utf_8(:name, name, allow_nil: true) if name
+      self.attributes[:client_id] = ensure_utf_8(:client_id, client_id, allow_nil: true) if client_id
+      self.attributes[:encoding] = ensure_utf_8(:encoding,  encoding,  allow_nil: true) if encoding
+
+      self.attributes.freeze
     end
 
     %w( name client_id encoding ).each do |attribute|
@@ -145,7 +147,7 @@ module Ably::Models
     end
 
     def set_attributes_object(new_attributes)
-      @attributes = IdiomaticRubyWrapper(new_attributes.clone.freeze, stop_at: [:data, :extras])
+      @attributes = IdiomaticRubyWrapper(new_attributes.clone, stop_at: [:data, :extras])
     end
 
     def logger

data/lib/submodules/ably-ruby/lib/ably/models/presence_message.rb

@@ -69,9 +69,11 @@ module Ably::Models
 
       set_attributes_object attributes
 
-      ensure_utf_8 :client_id,     client_id,     allow_nil: true
-      ensure_utf_8 :connection_id, connection_id, allow_nil: true
-      ensure_utf_8 :encoding,      encoding,      allow_nil: true
+      self.attributes[:client_id] = ensure_utf_8(:client_id, client_id, allow_nil: true) if client_id
+      self.attributes[:connection_id] = ensure_utf_8(:connection_id, connection_id, allow_nil: true) if connection_id
+      self.attributes[:encoding] = ensure_utf_8(:encoding, encoding, allow_nil: true) if encoding
+
+      self.attributes.freeze
     end
 
     %w( client_id data encoding ).each do |attribute|
@@ -167,7 +169,7 @@ module Ably::Models
     end
 
     def set_attributes_object(new_attributes)
-      @attributes = IdiomaticRubyWrapper(new_attributes.clone.freeze, stop_at: [:data])
+      @attributes = IdiomaticRubyWrapper(new_attributes.clone, stop_at: [:data])
     end
 
     def logger

data/lib/submodules/ably-ruby/lib/ably/models/protocol_message.rb

@@ -198,12 +198,42 @@ module Ably::Models
 
     # @api private
     def has_backlog_flag?
-      flags & 2 == 2
+      flags & 2 == 2 # 2^1
     end
 
     # @api private
     def has_channel_resumed_flag?
-      flags & 4 == 4
+      flags & 4 == 4 # 2^2
+    end
+
+    # @api private
+    def has_local_presence_flag?
+      flags & 8 == 8 # 2^3
+    end
+
+    # @api private
+    def has_transient_flag?
+      flags & 16 == 16 # 2^4
+    end
+
+    # @api private
+    def has_attach_presence_flag?
+      flags & 65536 == 65536 # 2^16
+    end
+
+    # @api private
+    def has_attach_publish_flag?
+      flags & 131072 == 131072 # 2^17
+    end
+
+    # @api private
+    def has_attach_subscribe_flag?
+      flags & 262144 == 262144 # 2^18
+    end
+
+    # @api private
+    def has_attach_presence_subscribe_flag?
+      flags & 524288 == 524288 # 2^19
     end
 
     def connection_details

data/lib/submodules/ably-ruby/lib/ably/models/push_channel_subscription.rb

@@ -0,0 +1,89 @@
+module Ably::Modules
+  module Conversions
+    private
+    # Convert push_channel_subscription argument to a {Ably::Models::PushChannelSubscription} object
+    #
+    # @param push_channel_subscription [Ably::Models::PushChannelSubscription,Hash,nil] A device details object
+    #
+    # @return [Ably::Models::PushChannelSubscription]
+    def PushChannelSubscription(push_channel_subscription)
+      case push_channel_subscription
+      when Ably::Models::PushChannelSubscription
+        push_channel_subscription
+      else
+        Ably::Models::PushChannelSubscription.new(push_channel_subscription)
+      end
+    end
+  end
+end
+
+module Ably::Models
+  # An object representing a devices details, used currently for push notifications
+  #
+  # @!attribute [r] channel
+  #   @return [String] The realtime pub/sub channel this subscription is registered to
+  # @!attribute [r] client_id
+  #   @return [String] Client ID that is assigned to one or more registered push devices
+  # @!attribute [r] device_id
+  #   @return [String] Unique device identifier assigned to the push device
+  #
+  class PushChannelSubscription < Ably::Exceptions::BaseAblyException
+    include Ably::Modules::ModelCommon
+
+    # @param hash_object   [Hash,nil]  Device detail attributes
+    #a
+    def initialize(hash_object = {})
+      @raw_hash_object = hash_object || {}
+      @hash_object     = IdiomaticRubyWrapper(hash_object)
+
+      if !attributes[:client_id] && !attributes[:device_id]
+        raise ArgumentError, 'Either client_id or device_id must be provided'
+      end
+      if attributes[:client_id] && attributes[:device_id]
+        raise ArgumentError, 'client_id and device_id cannot both be provided, they are mutually exclusive'
+      end
+      if !attributes[:channel]
+        raise ArgumentError, 'channel is required'
+      end
+    end
+
+    # Constructor for channel subscription by device ID
+    #
+    # @param channel    [String]  the realtime pub/sub channel this subscription is registered to
+    # @param device_id  [String]  Unique device identifier assigned to the push device
+    #
+    # @return [PushChannelSubscription]
+    #
+    def self.for_device(channel, device_id)
+      PushChannelSubscription.new(channel: channel, device_id: device_id)
+    end
+
+    # Constructor for channel subscription by client ID
+    #
+    # @param channel    [String]  the realtime pub/sub channel this subscription is registered to
+    # @param client_id  [String]  Client ID that is assigned to one or more registered push devices
+    #
+    # @return [PushChannelSubscription]
+    #
+    def self.for_client_id(channel, client_id)
+      PushChannelSubscription.new(channel: channel, client_id: client_id)
+    end
+
+    %w(channel client_id device_id).each do |attribute|
+      define_method attribute do
+        attributes[attribute.to_sym]
+      end
+
+      define_method "#{attribute}=" do |val|
+        unless val.nil? || val.kind_of?(String)
+          raise ArgumentError, "#{attribute} must be nil or a string value"
+        end
+        attributes[attribute.to_sym] = val
+      end
+    end
+
+    def attributes
+      @hash_object
+    end
+  end
+end

data/lib/submodules/ably-ruby/lib/ably/modules/async_wrapper.rb

@@ -44,7 +44,7 @@ module Ably::Modules
       Ably::Util::SafeDeferrable.new(logger).tap do |deferrable|
         deferrable.callback(&success_callback) if success_callback
 
-        operation_with_exception_handling = proc do
+        operation_with_exception_handling = lambda do
           begin
             yield
           rescue StandardError => err
@@ -57,7 +57,7 @@ module Ably::Modules
           end
         end
 
-        complete_callback = proc do |result|
+        complete_callback = lambda do |result|
           deferrable.succeed result
         end
 

data/lib/submodules/ably-ruby/lib/ably/modules/conversions.rb

@@ -96,7 +96,7 @@ module Ably::Modules
       unless options[:allow_nil] && string_value.nil?
         raise ArgumentError, "#{field_name} must be a String" unless string_value.kind_of?(String)
       end
-      string_value.encode!(Encoding::UTF_8) if string_value
+      string_value.encode(Encoding::UTF_8) if string_value
     rescue Encoding::UndefinedConversionError, Encoding::InvalidByteSequenceError => e
       raise ArgumentError, "#{field_name} could not be converted to UTF-8: #{e.message}"
     end
@@ -113,7 +113,7 @@ module Ably::Modules
         payload.kind_of?(Array) ||
         payload.nil?
 
-      raise Ably::Exceptions::UnsupportedDataType.new('Invalid data payload', 400, 40011)
+      raise Ably::Exceptions::UnsupportedDataType.new('Invalid data payload', 400, Ably::Exceptions::Codes::INVALID_MESSAGE_DATA_OR_ENCODING)
     end
   end
 end

data/lib/submodules/ably-ruby/lib/ably/modules/encodeable.rb

@@ -27,7 +27,7 @@ module Ably::Modules
       end
 
       # Return an Array of Message or Presence objects from the encoded Array of JSON-like objects, using the optional channel options
-      # @param message_objects [Array<Hash>] Array of JSON-like objects with encoded messages
+      # @param message_object_array [Array<Hash>] Array of JSON-like objects with encoded messages
       # @param channel_options [Hash] Channel options, currently reserved for Encryption options
       # @return [Array<Message,Presence>]
       def from_encoded_array(message_object_array, channel_options = {})
@@ -95,7 +95,7 @@ module Ably::Modules
 
         previous_encoding = message_attributes[:encoding]
         encoders.each do |encoder|
-          encoder.send method, message_attributes, channel_options
+          encoder.public_send method, message_attributes, channel_options
         end
       end until previous_encoding == message_attributes[:encoding]
 

data/lib/submodules/ably-ruby/lib/ably/modules/event_emitter.rb

@@ -31,7 +31,7 @@ module Ably
         # @option options [Proc] :coerce_into A lambda/Proc that is used to coerce the event names for all events. This is useful to ensure the event names conform to a naming or type convention.
         #
         # @example
-        #   configure_event_emitter coerce_into: Proc.new { |event| event.to_sym }
+        #   configure_event_emitter coerce_into: lambda { |event| event.to_sym }
         #
         def configure_event_emitter(options = {})
           @event_emitter_coerce_proc = options[:coerce_into]
@@ -158,7 +158,7 @@ module Ably
       # #emit automatically deletes any blocks that return true thus allowing a block to be run once
       def proc_for_block(block, options = {})
         {
-          emit_proc: Proc.new do |*args|
+          emit_proc: lambda do |*args|
             block.call(*args)
             true if options[:delete_once_run]
           end,

data/lib/submodules/ably-ruby/lib/ably/modules/exception_codes.rb

@@ -0,0 +1,128 @@
+# This file is generated by running `rake :generate_error_codes`
+# Do not manually modify this file
+# Generated at: 2018-09-18 18:28:58 UTC
+#
+module Ably
+  module Exceptions
+    module Codes
+      NO_ERROR                                                                         = 10000
+      BAD_REQUEST                                                                      = 40000
+      INVALID_REQUEST_BODY                                                             = 40001
+      INVALID_PARAMETER_NAME                                                           = 40002
+      INVALID_PARAMETER_VALUE                                                          = 40003
+      INVALID_HEADER                                                                   = 40004
+      INVALID_CREDENTIAL                                                               = 40005
+      INVALID_CONNECTION_ID                                                            = 40006
+      INVALID_MESSAGE_ID                                                               = 40007
+      INVALID_CONTENT_LENGTH                                                           = 40008
+      MAXIMUM_MESSAGE_LENGTH_EXCEEDED                                                  = 40009
+      INVALID_CHANNEL_NAME                                                             = 40010
+      STALE_RING_STATE                                                                 = 40011
+      INVALID_CLIENT_ID                                                                = 40012
+      INVALID_MESSAGE_DATA_OR_ENCODING                                                 = 40013
+      RESOURCE_DISPOSED                                                                = 40014
+      INVALID_DEVICE_ID                                                                = 40015
+      BATCH_ERROR                                                                      = 40020
+      INVALID_PUBLISH_REQUEST_UNSPECIFIED                                              = 40030
+      INVALID_PUBLISH_REQUEST_INVALID_CLIENTSPECIFIED_ID                               = 40031
+      UNAUTHORIZED                                                                     = 40100
+      INVALID_CREDENTIALS                                                              = 40101
+      INCOMPATIBLE_CREDENTIALS                                                         = 40102
+      INVALID_USE_OF_BASIC_AUTH_OVER_NONTLS_TRANSPORT                                  = 40103
+      TIMESTAMP_NOT_CURRENT                                                            = 40104
+      NONCE_VALUE_REPLAYED                                                             = 40105
+      UNABLE_TO_OBTAIN_CREDENTIALS_FROM_GIVEN_PARAMETERS                               = 40106
+      ACCOUNT_DISABLED                                                                 = 40110
+      ACCOUNT_RESTRICTED_CONNECTION_LIMITS_EXCEEDED                                    = 40111
+      ACCOUNT_BLOCKED_MESSAGE_LIMITS_EXCEEDED                                          = 40112
+      ACCOUNT_BLOCKED                                                                  = 40113
+      ACCOUNT_RESTRICTED_CHANNEL_LIMITS_EXCEEDED                                       = 40114
+      APPLICATION_DISABLED                                                             = 40120
+      KEY_ERROR_UNSPECIFIED                                                            = 40130
+      KEY_REVOKED                                                                      = 40131
+      KEY_EXPIRED                                                                      = 40132
+      KEY_DISABLED                                                                     = 40133
+      TOKEN_ERROR_UNSPECIFIED                                                          = 40140
+      TOKEN_REVOKED                                                                    = 40141
+      TOKEN_EXPIRED                                                                    = 40142
+      TOKEN_UNRECOGNISED                                                               = 40143
+      INVALID_JWT_FORMAT                                                               = 40144
+      INVALID_TOKEN_FORMAT                                                             = 40145
+      CONNECTION_BLOCKED_LIMITS_EXCEEDED                                               = 40150
+      OPERATION_NOT_PERMITTED_WITH_PROVIDED_CAPABILITY                                 = 40160
+      ERROR_FROM_CLIENT_TOKEN_CALLBACK                                                 = 40170
+      FORBIDDEN                                                                        = 40300
+      ACCOUNT_DOES_NOT_PERMIT_TLS_CONNECTION                                           = 40310
+      OPERATION_REQUIRES_TLS_CONNECTION                                                = 40311
+      APPLICATION_REQUIRES_AUTHENTICATION                                              = 40320
+      UNABLE_TO_ACTIVATE_ACCOUNT_DUE_TO_PLACEMENT_CONSTRAINT_UNSPECIFIED               = 40330
+      UNABLE_TO_ACTIVATE_ACCOUNT_DUE_TO_PLACEMENT_CONSTRAINT_INCOMPATIBLE_ENVIRONMENT  = 40331
+      UNABLE_TO_ACTIVATE_ACCOUNT_DUE_TO_PLACEMENT_CONSTRAINT_INCOMPATIBLE_SITE         = 40332
+      NOT_FOUND                                                                        = 40400
+      METHOD_NOT_ALLOWED                                                               = 40500
+      RATE_LIMIT_EXCEEDED_NONFATAL_REQUEST_REJECTED_UNSPECIFIED                        = 42910
+      MAX_PERCONNECTION_PUBLISH_RATE_LIMIT_EXCEEDED_NONFATAL_UNABLE_TO_PUBLISH_MESSAGE = 42911
+      RATE_LIMIT_EXCEEDED_FATAL                                                        = 42920
+      MAX_PERCONNECTION_PUBLISH_RATE_LIMIT_EXCEEDED_FATAL_CLOSING_CONNECTION           = 42921
+      INTERNAL_ERROR                                                                   = 50000
+      INTERNAL_CHANNEL_ERROR                                                           = 50001
+      INTERNAL_CONNECTION_ERROR                                                        = 50002
+      TIMEOUT_ERROR                                                                    = 50003
+      REQUEST_FAILED_DUE_TO_OVERLOADED_INSTANCE                                        = 50004
+      REACTOR_OPERATION_FAILED                                                         = 70000
+      REACTOR_OPERATION_FAILED_POST_OPERATION_FAILED                                   = 70001
+      REACTOR_OPERATION_FAILED_POST_OPERATION_RETURNED_UNEXPECTED_CODE                 = 70002
+      REACTOR_OPERATION_FAILED_MAXIMUM_NUMBER_OF_CONCURRENT_INFLIGHT_REQUESTS_EXCEEDED = 70003
+      EXCHANGE_ERROR_UNSPECIFIED                                                       = 71000
+      FORCED_REATTACHMENT_DUE_TO_PERMISSIONS_CHANGE                                    = 71001
+      EXCHANGE_PUBLISHER_ERROR_UNSPECIFIED                                             = 71100
+      NO_SUCH_PUBLISHER                                                                = 71101
+      PUBLISHER_NOT_ENABLED_AS_AN_EXCHANGE_PUBLISHER                                   = 71102
+      EXCHANGE_PRODUCT_ERROR_UNSPECIFIED                                               = 71200
+      NO_SUCH_PRODUCT                                                                  = 71201
+      PRODUCT_DISABLED                                                                 = 71202
+      NO_SUCH_CHANNEL_IN_THIS_PRODUCT                                                  = 71203
+      EXCHANGE_SUBSCRIPTION_ERROR_UNSPECIFIED                                          = 71300
+      SUBSCRIPTION_DISABLED                                                            = 71301
+      REQUESTER_HAS_NO_SUBSCRIPTION_TO_THIS_PRODUCT                                    = 71302
+      CONNECTION_FAILED                                                                = 80000
+      CONNECTION_FAILED_NO_COMPATIBLE_TRANSPORT                                        = 80001
+      CONNECTION_SUSPENDED                                                             = 80002
+      DISCONNECTED                                                                     = 80003
+      ALREADY_CONNECTED                                                                = 80004
+      INVALID_CONNECTION_ID_REMOTE_NOT_FOUND                                           = 80005
+      UNABLE_TO_RECOVER_CONNECTION_MESSAGES_EXPIRED                                    = 80006
+      UNABLE_TO_RECOVER_CONNECTION_MESSAGE_LIMIT_EXCEEDED                              = 80007
+      UNABLE_TO_RECOVER_CONNECTION_CONNECTION_EXPIRED                                  = 80008
+      CONNECTION_NOT_ESTABLISHED_NO_TRANSPORT_HANDLE                                   = 80009
+      INVALID_OPERATION_INVALID_TRANSPORT_HANDLE                                       = 80010
+      UNABLE_TO_RECOVER_CONNECTION_INCOMPATIBLE_AUTH_PARAMS                            = 80011
+      UNABLE_TO_RECOVER_CONNECTION_INVALID_OR_UNSPECIFIED_CONNECTION_SERIAL            = 80012
+      PROTOCOL_ERROR                                                                   = 80013
+      CONNECTION_TIMED_OUT                                                             = 80014
+      INCOMPATIBLE_CONNECTION_PARAMETERS                                               = 80015
+      OPERATION_ON_SUPERSEDED_TRANSPORT                                                = 80016
+      CONNECTION_CLOSED                                                                = 80017
+      INVALID_CONNECTION_ID_INVALID_FORMAT                                             = 80018
+      CLIENT_CONFIGURED_AUTHENTICATION_PROVIDER_REQUEST_FAILED                         = 80019
+      CONTINUITY_LOSS_DUE_TO_MAXIMUM_SUBSCRIBE_MESSAGE_RATE_EXCEEDED                   = 80020
+      CLIENT_RESTRICTION_NOT_SATISFIED                                                 = 80030
+      CHANNEL_OPERATION_FAILED                                                         = 90000
+      CHANNEL_OPERATION_FAILED_INVALID_CHANNEL_STATE                                   = 90001
+      CHANNEL_OPERATION_FAILED_EPOCH_EXPIRED_OR_NEVER_EXISTED                          = 90002
+      UNABLE_TO_RECOVER_CHANNEL_MESSAGES_EXPIRED                                       = 90003
+      UNABLE_TO_RECOVER_CHANNEL_MESSAGE_LIMIT_EXCEEDED                                 = 90004
+      UNABLE_TO_RECOVER_CHANNEL_NO_MATCHING_EPOCH                                      = 90005
+      UNABLE_TO_RECOVER_CHANNEL_UNBOUNDED_REQUEST                                      = 90006
+      CHANNEL_OPERATION_FAILED_NO_RESPONSE_FROM_SERVER                                 = 90007
+      MAXIMUM_NUMBER_OF_CHANNELS_PER_CONNECTION_EXCEEDED                               = 90010
+      UNABLE_TO_ENTER_PRESENCE_CHANNEL_NO_CLIENTID                                     = 91000
+      UNABLE_TO_ENTER_PRESENCE_CHANNEL_INVALID_CHANNEL_STATE                           = 91001
+      UNABLE_TO_LEAVE_PRESENCE_CHANNEL_THAT_IS_NOT_ENTERED                             = 91002
+      UNABLE_TO_ENTER_PRESENCE_CHANNEL_MAXIMUM_MEMBER_LIMIT_EXCEEDED                   = 91003
+      UNABLE_TO_AUTOMATICALLY_REENTER_PRESENCE_CHANNEL                                 = 91004
+      PRESENCE_STATE_IS_OUT_OF_SYNC                                                    = 91005
+      MEMBER_IMPLICITLY_LEFT_PRESENCE_CHANNEL_CONNECTION_CLOSED                        = 91100
+    end
+  end
+end

data/lib/submodules/ably-ruby/lib/ably/modules/model_common.rb

@@ -42,10 +42,23 @@ module Ably::Modules
       attributes.hash
     end
 
+    def to_s
+      representation = attributes.map do |key, val|
+        if val.nil?
+          nil
+        else
+          val_str = val.to_s
+          val_str = "#{val_str[0...80]}..." if val_str.length > 80
+          "#{key}=#{val_str}"
+        end
+      end
+      "<#{self.class.name}: #{representation.compact.join(', ')}>"
+    end
+
     module ClassMethods
       # Return a new instance of this object using the provided JSON-like object or JSON string
-      # @param [Hash, String] JSON-like object or JSON string
-      # @return a new instance o this object
+      # @param json_like_object  [Hash, String]  JSON-like object or JSON string
+      # @return a new instance to this object
       def from_json(json_like_object)
         if json_like_object.kind_of?(String)
           new(JSON.parse(json_like_object))