easemob 0.0.1 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 8468de1f0eb25f0cb4f5fd7182cd537f5a065f22
-  data.tar.gz: d9ded95865eb429592ac84d43e6bfdefa77e427f
+  metadata.gz: 56ed81345e9a563df461fd8429d9d00cb3458a79
+  data.tar.gz: 8e1e91fd5bd5f05f98d4e8ac1f06fa87b8a84884
 SHA512:
-  metadata.gz: d2b122d07608493b2857b6baf14ae02260d00149542342954b19e5409684a178152635480d8c3eac9f9597451e85005508577d24b1df4db883d0fbf981734815
-  data.tar.gz: ad09e35e5b0f5e974e302e4b021d6406ec987c6f98d135a55de75a4eca00018a9085b276b459332a37d1b0837ee7075f40294d8fa61edf0e13c8195ca95330b5
+  metadata.gz: fb273fa328e8ec22595d7c5399830187fcc4ba814b9c0b0437509c253cb4b7c03a95eade2fbc33f45c6a6d6263284dc1db084ae8d1b8a3ef068f95b6618ac5ca
+  data.tar.gz: 2e6d665da1c25459436c770edb202a63c9862c27c7353f893410d1e2c7adc880211d206a8a1cc9ceb829671e6d282ea1b0577f7f9fdeb6d6a5658ee82a8f0c97

data/.codeclimate.yml

@@ -0,0 +1,16 @@
+---
+engines:
+  duplication:
+    enabled: true
+    config:
+      languages:
+      - ruby
+  fixme:
+    enabled: true
+  rubocop:
+    enabled: true
+ratings:
+  paths:
+  - "**.rb"
+exclude_paths:
+- spec/

data/.gitignore

@@ -11,4 +11,6 @@
 /tmp/
 *.sublime-workspace
 spec/examples.txt
+spec/easemob_logo_download.png
+spec/easemob_logo_thumbnail.png
 .byebug_history

data/.travis.yml

@@ -1,5 +1,6 @@
 sudo: false
 language: ruby
 rvm:
-  - 2.3.1
-before_install: gem install bundler -v 1.13.3
+  - 2.2.5
+cache: bundler
+bundler_args: --jobs=3 --retry=3

data/README.md

@@ -1,6 +1,11 @@
-# Easemob
+![Easemob Logo](https://raw.githubusercontent.com/bayetech/easemob/master/spec/easemob_logo.png)
 
-Easemob is an unofficial easemob IM instant message gem, inspired from [huanxin](https://github.com/RobotJiang/ruby-for-huanxin) a lot.
+easemob [![Gem Version][version-badge]][rubygems] [![Build Status][travis-badge]][travis] [![Code Climate][codeclimate-badge]][codeclimate] [![Code Coverage][codecoverage-badge]][codecoverage]
+=======
+
+An unofficial [Easemob IM instant message service](http://www.easemob.com/product/im) integration gem, inspired from [huanxin](https://github.com/RobotJiang/ruby-for-huanxin) a lot.
+
+`easemob` gem provide [ALL the RESTful API in server side integration](http://docs.easemob.com/im/100serverintegration/10intro).
 
 ## Installation
 
@@ -46,3 +51,13 @@ Bug reports and pull requests are welcome on GitHub at https://github.com/bayete
 
 The gem is available as open source under the terms of the [MIT License](http://opensource.org/licenses/MIT).
 
+
+
+[version-badge]: https://badge.fury.io/rb/easemob.svg
+[rubygems]: https://rubygems.org/gems/easemob
+[travis-badge]: https://travis-ci.org/bayetech/easemob.svg
+[travis]: https://travis-ci.org/bayetech/easemob
+[codeclimate-badge]: https://codeclimate.com/github/bayetech/easemob/badges/gpa.svg
+[codeclimate]: https://codeclimate.com/github/bayetech/easemob
+[codecoverage-badge]: https://codeclimate.com/github/bayetech/easemob/badges/coverage.svg
+[codecoverage]: https://codeclimate.com/github/bayetech/easemob/coverage

data/lib/easemob/chatlog.rb

@@ -0,0 +1,12 @@
+module Easemob
+  module Chatlog
+    def chatmessages(after: nil, before: nil, limit: 10, cursor: nil)
+      raise ArgumentError, 'Either give after or before, not both when call chatmessages' if after && before
+      params = { limit: limit }
+      params[:cursor] = cursor unless cursor.nil?
+      params[:ql] = "select * where timestamp>#{after.to_i}" unless after.nil?
+      params[:ql] = "select * where timestamp<#{before.to_i}" unless before.nil?
+      request :get, 'chatmessages', params: params
+    end
+  end
+end

data/lib/easemob/chatrooms.rb

@@ -0,0 +1,49 @@
+module Easemob
+  module Chatrooms
+    def create_chatroom(chatroom_name, description, owner, maxusers: 200, members: nil)
+      jd = { name: chatroom_name, description: description, owner: owner, maxusers: maxusers }
+      jd[:members] = members unless members.nil?
+      request :post, 'chatrooms', json: jd
+    end
+
+    def get_chatroom(chatroom_id)
+      request :get, "chatrooms/#{chatroom_id}"
+    end
+
+    def query_chatrooms
+      request :get, 'chatrooms'
+    end
+
+    def user_joined_chatrooms(username)
+      request :get, "users/#{username}/joined_chatrooms"
+    end
+
+    def delete_chatroom(chatroom_id)
+      request :delete, "chatrooms/#{chatroom_id}"
+    end
+
+    def modify_chatroom(chatroom_id, chatroom_name: nil, description: nil, maxusers: nil)
+      jd = {}
+      jd[:name] = chatroom_name unless chatroom_name.nil?
+      jd[:description] = description unless description.nil?
+      jd[:maxusers] = maxusers unless maxusers.nil?
+      request :put, "chatrooms/#{chatroom_id}", json: jd
+    end
+
+    def user_join_chatroom(chatroom_id, username:)
+      request :post, "chatrooms/#{chatroom_id}/users/#{username}"
+    end
+
+    def user_leave_chatroom(chatroom_id, username:)
+      request :delete, "chatrooms/#{chatroom_id}/users/#{username}"
+    end
+
+    def chatroom_add_users(chatroom_id, usernames:)
+      request :post, "chatrooms/#{chatroom_id}/users", json: { usernames: [*usernames] }
+    end
+
+    def chatroom_remove_users(chatroom_id, usernames:)
+      request :delete, "chatrooms/#{chatroom_id}/users/#{[*usernames].join(',')}"
+    end
+  end
+end

data/lib/easemob/fileoperation.rb

@@ -0,0 +1,13 @@
+module Easemob
+  module Fileoperation
+    def upload_chatfile(file_path, restrict_access: true)
+      request :upload, 'chatfiles', form: { file: HTTP::FormData::File.new(file_path),
+                                            hack: 'X' }, # Existing here for http-form_data 1.0.1 handle single param improperly, see https://github.com/httprb/form_data.rb/issues/4
+                                    restrict_access: restrict_access
+    end
+
+    def download_chatfile(chatfile_uuid, share_secret: nil, thumbnail: false)
+      request :download, "chatfiles/#{chatfile_uuid}", share_secret: share_secret, thumbnail: thumbnail
+    end
+  end
+end

data/lib/easemob/groups.rb

@@ -0,0 +1,71 @@
+module Easemob
+  module Groups
+    def create_group(groupname, description, owner, members: nil, is_public: true, maxusers: 200, is_approval: false)
+      jd = { groupname: groupname, desc: description, public: is_public, owner: owner, users: maxusers, approval: is_approval }
+      jd[:members] = members unless members.nil?
+      request :post, 'chatgroups', json: jd
+    end
+
+    def get_groups(group_ids)
+      request :get, "chatgroups/#{[*group_ids].join(',')}"
+    end
+
+    def query_groups(limit = 50, cursor: nil)
+      params = { limit: limit }
+      params[:cursor] = cursor unless cursor.nil?
+      request :get, 'chatgroups', params: params
+    end
+
+    def query_group_users(group_id)
+      request :get, "chatgroups/#{group_id}/users"
+    end
+
+    def query_group_blocks(group_id)
+      request :get, "chatgroups/#{group_id}/blocks/users"
+    end
+
+    def user_joined_chatgroups(username)
+      request :get, "users/#{username}/joined_chatgroups"
+    end
+
+    def delete_group(group_id)
+      request :delete, "chatgroups/#{group_id}"
+    end
+
+    def modify_group(group_id, groupname: nil, description: nil, maxusers: nil)
+      jd = {}
+      jd[:groupname] = groupname unless groupname.nil?
+      jd[:description] = description unless description.nil?
+      jd[:maxusers] = maxusers unless maxusers.nil?
+      request :put, "chatgroups/#{group_id}", json: jd
+    end
+
+    def user_join_group(group_id, username:)
+      request :post, "chatgroups/#{group_id}/users/#{username}"
+    end
+
+    def user_leave_group(group_id, username:)
+      request :delete, "chatgroups/#{group_id}/users/#{username}"
+    end
+
+    def group_add_users(group_id, usernames:)
+      request :post, "chatgroups/#{group_id}/users", json: { usernames: [*usernames] }
+    end
+
+    def group_remove_users(group_id, usernames:)
+      request :delete, "chatgroups/#{group_id}/users/#{[*usernames].join(',')}"
+    end
+
+    def group_set_owner(group_id, newowner:)
+      request :put, "chatgroups/#{group_id}", json: { newowner: newowner }
+    end
+
+    def add_to_group_block(group_id, to_block_usernames:)
+      request :post, "chatgroups/#{group_id}/blocks/users", json: { usernames: [*to_block_usernames] }
+    end
+
+    def remove_from_group_block(group_id, blocked_usernames:)
+      request :delete, "chatgroups/#{group_id}/blocks/users/#{[*blocked_usernames].join(',')}"
+    end
+  end
+end

data/lib/easemob/messages.rb

@@ -0,0 +1,54 @@
+module Easemob
+  module Messages
+    def message_to(target, target_type: :users, text:,
+                   from: nil, ext: nil)
+      jd = { target_type: target_type, target: [*target],
+             msg: { type: :txt, txt: text } }
+      jd[:from] = from unless from.nil?
+      jd[:ext] = ext unless ext.nil?
+      request :post, 'messages', json: jd
+    end
+
+    def image_to(target, target_type: :users, url:, filename:,
+                 secret: nil, from: nil, image_size: nil, ext: nil)
+      jd = { target_type: target_type, target: [*target],
+             msg: { type: :img, filename: filename, url: url } }
+      jd[:msg][:secret] = secret unless secret.nil?
+      jd[:from] = from unless from.nil?
+      jd[:size] = image_size unless image_size.nil?
+      jd[:ext] = ext unless ext.nil?
+      request :post, 'messages', json: jd
+    end
+
+    def audio_to(target, target_type: :users, url:, filename:, length:,
+                 secret: nil, from: nil, ext: nil)
+      jd = { target_type: target_type, target: [*target],
+             msg: { type: :audio, url: url, filename: filename, length: length } }
+      jd[:msg][:secret] = secret unless secret.nil?
+      jd[:from] = from unless from.nil?
+      jd[:ext] = ext unless ext.nil?
+      request :post, 'messages', json: jd
+    end
+
+    def video_to(target, target_type: :users, url:, filename:, length:, file_length:, thumb:,
+                 secret: nil, thumb_secret: nil, from: nil, ext: nil)
+      jd = { target_type: target_type, target: [*target],
+             msg: { type: :video, filename: filename, thumb: thumb, length: length,
+                    file_length: file_length, url: url } }
+      jd[:msg][:secret] = secret unless secret.nil?
+      jd[:msg][:thumb_secret] = thumb_secret unless thumb_secret.nil?
+      jd[:from] = from unless from.nil?
+      jd[:ext] = ext unless ext.nil?
+      request :post, 'messages', json: jd
+    end
+
+    def command_to(target, target_type: :users, action:,
+                   from: nil, ext: nil)
+      jd = { target_type: target_type, target: [*target],
+             msg: { type: :cmd, action: action } }
+      jd[:from] = from unless from.nil?
+      jd[:ext] = ext unless ext.nil?
+      request :post, 'messages', json: jd
+    end
+  end
+end

data/lib/easemob/users.rb

@@ -1,7 +1,95 @@
 module Easemob
   module Users
-    def create_user(username, password, nickname = nil)
-      do_post('users', username: username, password: password, nickname: nickname)
+    def create_user(username, password, nickname: nil)
+      valid_username!(username)
+      jd = { username: username, password: password }
+      jd[:nickname] = nickname unless nickname.nil?
+      request :post, 'users', json: jd
+    end
+
+    def create_users(users)
+      users.map { |user| valid_username!(user['username'] || user[:username]) }
+      request :post, 'users', json: users
+    end
+
+    def get_user(username)
+      request :get, "users/#{username}"
+    end
+
+    def query_users(limit = 50, cursor: nil)
+      params = { limit: limit }
+      params[:cursor] = cursor unless cursor.nil?
+      request :get, 'users', params: params
+    end
+
+    def delete_user(username)
+      request :delete, "users/#{username}"
+    end
+
+    def delete_users!(number = 100)
+      request :delete, 'users', params: { limit: number }
+    end
+
+    def reset_user_password(username, newpassword:)
+      request :put, "users/#{username}/password", json: { newpassword: newpassword }
+    end
+
+    def set_user_nickname(username, nickname:)
+      request :put, "users/#{username}", json: { nickname: nickname }
+    end
+
+    def add_user_friend(owner_username, friend_username:)
+      request :post, "users/#{owner_username}/contacts/users/#{friend_username}"
+    end
+
+    def remove_user_friend(owner_username, friend_username:)
+      request :delete, "users/#{owner_username}/contacts/users/#{friend_username}"
+    end
+
+    def query_user_friends(owner_username)
+      request :get, "users/#{owner_username}/contacts/users"
+    end
+
+    def add_to_user_block(owner_username, to_block_usernames:)
+      request :post, "users/#{owner_username}/blocks/users", json: { usernames: [*to_block_usernames] }
+    end
+
+    def remove_from_user_block(owner_username, blocked_username:)
+      request :delete, "users/#{owner_username}/blocks/users/#{blocked_username}"
+    end
+
+    def query_user_blocks(owner_username)
+      request :get, "users/#{owner_username}/blocks/users"
+    end
+
+    def get_user_status(username)
+      request :get, "users/#{username}/status"
+    end
+
+    def get_user_offline_msg_count(owner_username)
+      request :get, "users/#{owner_username}/offline_msg_count"
+    end
+
+    def get_user_offline_msg_status(username, msg_id)
+      request :get, "users/#{username}/offline_msg_status/#{msg_id}"
+    end
+
+    def deactivate_user(username)
+      request :post, "users/#{username}/deactivate"
+    end
+
+    def activate_user(username)
+      request :post, "users/#{username}/activate"
+    end
+
+    def disconnect_user(username)
+      request :get, "users/#{username}/disconnect"
+    end
+
+    private
+
+    def valid_username!(username)
+      raise UserNameError, "#{username} is invalid for easemob" unless username[/[a-zA-Z0-9_-]*/] == username
     end
   end
 end

data/lib/easemob/version.rb

@@ -1,3 +1,3 @@
 module Easemob
-  VERSION = '0.0.1'.freeze
+  VERSION = '0.2.0'.freeze
 end

data/lib/easemob.rb

@@ -4,8 +4,16 @@ require 'connection_pool'
 require 'easemob/version'
 require 'easemob/token'
 require 'easemob/users'
+require 'easemob/groups'
+require 'easemob/chatrooms'
+require 'easemob/chatlog'
+require 'easemob/fileoperation'
+require 'easemob/messages'
 
 module Easemob
+  class UserNameError < RuntimeError; end
+  class QuotaLimitError < RuntimeError; end
+
   class << self
     attr_accessor :client_id     # 使用 APP 的 client_id
     attr_accessor :client_secret # 和 client_secret 获取授权管理员 token
@@ -22,40 +30,36 @@ module Easemob
   @random_generator = Random.new
   @http_pool = 5
   @http_timeout = 5
+  @token_file_path = nil
 
-  def self.head_url
-    "#{@base_url}/#{@org_name}/#{@app_name}"
-  end
-
-  def self.token_file_path
-    @token_file_path || "/tmp/easemob_#{@org_name}_#{@app_name}_token"
-  end
-
-  def self.httprbs
-    @httprbs ||= ConnectionPool.new(size: @http_pool, timeout: @http_timeout) { HTTP.persistent @base_url }
-  end
-
-  def self.do_post(resource, body_hash)
+  # Make an HTTP request with the given verb to easemob server
+  # @param verb [Symbol]
+  # @param resource [String]
+  # @option options [Hash]
+  # @return [HTTP::Response]
+  def self.request(verb, resource, options = {})
     httprbs.with do |http|
-      res = do_post_request(http, resource, body_hash)
+      res = do_request(verb, http, resource, options)
       case res.code
       # 401:（未授权）请求要求身份验证。对于需要 token 的接口，服务器可能返回此响应。
-      when 401, 408
+      when 401
         Token.refresh
-        res = do_post_request(http, resource, body_hash)
+        res = do_request(verb, http, resource, options)
       # 408:（请求超时）服务器等候请求时发生超时。
       when 408
-        res = do_post_request(http, resource, body_hash)
+        res = do_request(verb, http, resource, options)
+      # 503:（服务不可用）请求接口超过调用频率限制，即接口被限流。
+      when 429, 503
+        sleep 1
+        res = do_request(verb, http, resource, options)
+        raise QuotaLimitError, 'Return http status code is 429/503, hit quota limit of Easemob service,' if [429, 503].include?(res.code)
       end
       res
     end
   end
 
-  def self.do_post_request(http, resource, body_hash)
-    http.headers('Authorization' => "Bearer #{token}")
-        .post "#{head_url}/#{resource}", json: body_hash
-  end
-
+  # Get admin access token from easemob server
+  # @return access_token [String]
   def self.token
     # Possible two worker running, one worker refresh token, other unaware, so must read every time
     access_token, remain_life_seconds = Token.read_from_store
@@ -63,7 +67,50 @@ module Easemob
     access_token
   end
 
+  def self.chatfile_url(chatfile_uuid)
+    "#{@base_url}/#{@org_name}/#{@app_name}/chatfiles/#{chatfile_uuid}"
+  end
+
   class << self
     include Users
+    include Groups
+    include Chatrooms
+    include Chatlog
+    include Fileoperation
+    include Messages
+  end
+
+  private_class_method
+
+  def self.do_request(verb, http, resource, options)
+    http = http.headers('Authorization' => "Bearer #{token}")
+    case verb
+    when :upload
+      restrict_access = options.delete(:restrict_access) || true
+      http.headers('restrict-access' => restrict_access)
+          .request(:post, "#{head_url}/#{resource}", options)
+    when :download
+      header = { 'Accept' => 'application/octet-stream' }
+      share_secret = options.delete(:share_secret)
+      header['share-secret'] = share_secret unless share_secret.nil?
+      thumbnail = options.delete(:thumbnail)
+      header['thumbnail'] = thumbnail if thumbnail
+      http.headers(header)
+          .request(:get, "#{head_url}/#{resource}")
+    else
+      http.request(verb, "#{head_url}/#{resource}", options)
+    end
+  end
+
+  def self.httprbs
+    @httprbs ||= ConnectionPool.new(size: @http_pool, timeout: @http_timeout) { HTTP.persistent @base_url }
+  end
+
+  def self.head_url
+    "#{@base_url}/#{@org_name}/#{@app_name}"
+  end
+
+  def self.token_file_path
+    @token_file_path || "/tmp/easemob_#{@org_name}_#{@app_name}_token"
   end
 end

metadata

@@ -1,14 +1,36 @@
 --- !ruby/object:Gem::Specification
 name: easemob
 version: !ruby/object:Gem::Version
-  version: 0.0.1
+  version: 0.2.0
 platform: ruby
 authors:
 - Eric Guo
 autorequire: 
 bindir: exe
-cert_chain: []
-date: 2016-10-11 00:00:00.000000000 Z
+cert_chain:
+- |
+  -----BEGIN CERTIFICATE-----
+  MIIDeDCCAmCgAwIBAgIBATANBgkqhkiG9w0BAQUFADBBMRMwEQYDVQQDDAplcmlj
+  Lmd1b2N6MRUwEwYKCZImiZPyLGQBGRYFZ21haWwxEzARBgoJkiaJk/IsZAEZFgNj
+  b20wHhcNMTYwNzExMTUyMTU2WhcNMTcwNzExMTUyMTU2WjBBMRMwEQYDVQQDDApl
+  cmljLmd1b2N6MRUwEwYKCZImiZPyLGQBGRYFZ21haWwxEzARBgoJkiaJk/IsZAEZ
+  FgNjb20wggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQC6LSiHb79c6Krm
+  TeoHq5fko/QJownbKLtlzHmWCGb6B38mIPqYZBSmfaK9EZr6DTf7TJWB7e/u2+Ep
+  bXCqdUxRDbQZig52DvKfljfgOD/YzALHKAckuk/sskvM2pdtRIowJSYAG/Hz2j1d
+  mngRZaIDd/09CNttRsgCDXZl+qqsNJKCQWZ3T8OdqmlpwkIxo7llKEQ578fQwgZ3
+  8uE4RLMv8fOdFv0EzGXbRyFLCT2WEAH5Ns2Jv12KKbvYCTICdJ36cSV8hOUZT0fG
+  y4FxEXtV9uJVJv3BJ5LE84TWdNiMI1lbFul72p09vebUe2N0Hru3XDnfq69XJ+9e
+  nZC9MFk/AgMBAAGjezB5MAkGA1UdEwQCMAAwCwYDVR0PBAQDAgSwMB0GA1UdDgQW
+  BBR/fjIribDcJvWvxPh+zv2kFGRAejAfBgNVHREEGDAWgRRlcmljLmd1b2N6QGdt
+  YWlsLmNvbTAfBgNVHRIEGDAWgRRlcmljLmd1b2N6QGdtYWlsLmNvbTANBgkqhkiG
+  9w0BAQUFAAOCAQEAIA++aoEJOSbTwQml1cQ+z2psV2R18HKYR7ZM8bGEm9PxGyLt
+  DcpqGIL65VctVjqVzD4RTvDrsFhVICL5o0rLYpC4Qm5jBpx+E2s/akJSDsQcOO12
+  qk+IDlQHJjhf7DOg0+XAIj1/QTvq8s3QrrD8NRoIvGcAXVzqAafcG9NOGIXpqFS1
+  ZdwgixrYZK4p/Z+qIJFiuGvBauegUn0x7WDln52cWXgb+a/oYPBjGtBAZznhSy+R
+  R5k6Ma92sW8jupX4cqbSu9rntdVQkNRpoHIrfU0MZT0cKsg/D1zMteylxrO3KMsz
+  SPQRv+nrI1J0zevFqb8010heoR8SDyUA0Mm3+Q==
+  -----END CERTIFICATE-----
+date: 2016-10-17 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: http
@@ -92,13 +114,14 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '3.5'
-description: Helping rubyist integration with easemob IM service (环信 - 即时通讯云) easier.
+description: Helping rubyist integration with Easemob IM service (环信 - 即时通讯云) easier.
 email:
 - eric.guocz@gmail.com
 executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- ".codeclimate.yml"
 - ".gitignore"
 - ".rspec"
 - ".rubocop.yml"
@@ -106,6 +129,11 @@ files:
 - LICENSE.txt
 - README.md
 - lib/easemob.rb
+- lib/easemob/chatlog.rb
+- lib/easemob/chatrooms.rb
+- lib/easemob/fileoperation.rb
+- lib/easemob/groups.rb
+- lib/easemob/messages.rb
 - lib/easemob/token.rb
 - lib/easemob/users.rb
 - lib/easemob/version.rb
@@ -132,5 +160,5 @@ rubyforge_project:
 rubygems_version: 2.6.7
 signing_key: 
 specification_version: 4
-summary: An unofficial easemob IM instant message gem.
+summary: An unofficial Easemob IM(instant message) service integration gem
 test_files: []

metadata.gz.sig

@@ -0,0 +1,3 @@
+�V�Ag*'��>���9f$���(�k\Ugj
+�	�GPUKM@���Y<�LZ�bχ�r"�j;���i9!]�N��F�*rɦ,���u����X	/�X(\ ��0�Wt��#[B��+���*;^�>_ހ����9��_�dt�h���ʯC󨂻`48<���
+�PLd�-^���B�����#��JE�
}Qjƭ/ſo^�z2&