matrix_sdk 2.5.0 → 2.8.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 24a67aeb6af66f75480104c5c0dc44987e2fe54163ed96047da58bf091476752
-  data.tar.gz: e5935a94b430a1b195b55d748415cc0ad95ea649e32f5e97045cc82726dd2bd3
+  metadata.gz: fd493a721423c1f1a7da7b2ff678ad8e1a949f258fe613616ebedab39d5ae204
+  data.tar.gz: 52e6563d1dbb42cd5acddf3809df720fb6ecc5b6f49cbdc14606450e908c32c6
 SHA512:
-  metadata.gz: 1ea88ea4c76b573dad7b03aeba49e91b8f7c01040118c38032b49ca00cfbe687bd931c4e17387545e27df529f6ae06fc835ee964b5e79489fb0c5cf84186b35b
-  data.tar.gz: e2a6a5cd78e7629ffb2cc4af5ec9c9154f2f63db570479ebb2c6fa9aff13b7b231bea877d56694ae799019698af8d4a87394f88fa162dcb172dbbd1ede09fc8f
+  metadata.gz: 1fa0a6cbae2b6fa8ab91961df79082017be6a50028cc7b318ad70a5be9c76b8488b4b24cbef5e5a768ac34076236430683d518c18fccb296290599427bd71095
+  data.tar.gz: f62ad6791ee5f3921869d2431e55e3a1f44501af1b8c966a957fbcacbcaf809edb2e47b8d8b65d1393c268ff58b19e21fc966b1660c671d4d257121bf832dadf

data/CHANGELOG.md

@@ -1,3 +1,30 @@
+## 2.8.0 - 2022-08-19
+
+- Drops support for EoL Ruby 2.6
+- Adds helpers for accessing room state
+- Fixes Client#sync_token usage
+- Improves caching of state events in rooms
+
+## 2.7.0 - 2022-08-12
+
+- Adds a bot subsystem + DSL 
+  - [An example](examples/bot_api.rb) can be found in the examples folder
+- Adds additional useful helpers for Room and User
+- Fixes Client.new_for_domain
+- Improves the handling of MXIDs as strings
+- Improves handling of caches for rooms
+- Improves Client shutdown when using Client#start_listener_thread
+- Improves account data handling, with caches on both Client and Room level
+
+## 2.6.0 - 2022-07-15
+
+- Adds some multi-thread usage support to the API (create your API/client with `threadsafe: :multithread/true/false`)
+    The API will currently default to running with multi-threaded requests. In case your application is single-threaded - or never performs requests from multiple threads - then you can set `threadsafe: true/false` to support connection reuse.
+- Changes room finding to ignore non-canonical aliases by default
+- Improves room alias handling
+- Improves Ruby 3.0+ support
+- Improves debug output by supporting PP (Ruby pretty print) on all MatrixSdk objects
+
 ## 2.5.0 - 2022-01-14
 
 - Adds preliminary support for the Matrix v1.1 `client/v3` API

data/README.md

@@ -8,6 +8,8 @@ Live YARD documentation can be found at; https://ruby-sdk.ananace.dev
 
 ## Example usage
 
+For more fully-featured examples, check the [examples](examples/) folder.
+
 ```ruby
 # Raw API usage
 require 'matrix_sdk'
@@ -24,7 +26,7 @@ api.request :get, :federation_v1, '/version'
 ```
 
 ```ruby
-# Client wrapper
+# Client wrapper with login
 require 'matrix_sdk'
 
 client = MatrixSdk::Client.new 'https://example.com'
@@ -41,7 +43,7 @@ hq.send_text "This is an example message - don't actually do this ;)"
 ```
 
 ```ruby
-# Client wrapper
+# Client wrapper with token
 require 'matrix_sdk'
 
 client = MatrixSdk::Client.new 'https://example.com'
@@ -56,6 +58,19 @@ client.rooms.count
 # => 5
 ```
 
+```ruby
+#!/bin/env ruby
+# Bot DSL
+require 'matrix_sdk/bot'
+
+command :plug do
+  room.send_text <<~PLUG
+    The Ruby SDK is a fine method for writing applications communicating over the Matrix protocol.
+    It can easily be integrated with Rails, and it supports most client/bot use-cases.
+  PLUG
+end
+```
+
 ## Contributing
 
 Bug reports and pull requests are welcome on GitHub at https://github.com/ananace/ruby-matrix-sdk

data/lib/matrix_sdk/api.rb

@@ -19,7 +19,7 @@ module MatrixSdk
     }.freeze
 
     attr_accessor :access_token, :connection_address, :connection_port, :device_id, :autoretry, :global_headers
-    attr_reader :homeserver, :validate_certificate, :open_timeout, :read_timeout, :well_known, :proxy_uri
+    attr_reader :homeserver, :validate_certificate, :open_timeout, :read_timeout, :well_known, :proxy_uri, :threadsafe
 
     ignore_inspect :access_token, :logger
 
@@ -39,7 +39,10 @@ module MatrixSdk
     # @option params [Hash] :global_headers Additional headers to set for all requests
     # @option params [Boolean] :skip_login Should the API skip logging in if the HS URL contains user information
     # @option params [Boolean] :synapse (true) Is the API connecting to a Synapse instance
-    # @option params [Hash] :well_known The .well-known object that the server was discovered through, should not be set manually
+    # @option params [Boolean,:multithread] :threadsafe (:multithread) Should the connection be threadsafe/mutexed - or
+    #   safe for simultaneous multi-thread usage. Will default to +:multithread+ - a.k.a. per-thread HTTP connections
+    #   and requests
+    # @note Using threadsafe +:multithread+ currently doesn't support connection re-use
     def initialize(homeserver, **params)
       @homeserver = homeserver
       raise ArgumentError, 'Homeserver URL must be String or URI' unless @homeserver.is_a?(String) || @homeserver.is_a?(URI)
@@ -64,7 +67,9 @@ module MatrixSdk
       @global_headers.merge!(params.fetch(:global_headers)) if params.key? :global_headers
       @synapse = params.fetch(:synapse, true)
       @http = nil
-      @http_lock = Mutex.new
+      @inflight = []
+
+      self.threadsafe = params.fetch(:threadsafe, :multithread)
 
       ([params.fetch(:protocols, [:CS])].flatten - protocols).each do |proto|
         self.class.include MatrixSdk::Protocols.const_get(proto)
@@ -244,6 +249,17 @@ module MatrixSdk
       @proxy_uri = proxy_uri
     end
 
+    # @param [Boolean,:multithread] threadsafe What level of thread-safety the API should use
+    # @return [Boolean,:multithread]
+    def threadsafe=(threadsafe)
+      raise ArgumentError, 'Threadsafe must be either a boolean or :multithread' unless [true, false, :multithread].include? threadsafe
+      raise ArugmentError, 'JRuby only support :multithread/false for threadsafe' if RUBY_ENGINE == 'jruby' && threadsafe == true
+
+      @threadsafe = threadsafe
+      @http_lock = nil unless threadsafe == true
+      @threadsafe
+    end
+
     # Perform a raw Matrix API request
     #
     # @example Simple API query
@@ -284,14 +300,25 @@ module MatrixSdk
         print_http(req_obj, id: req_id)
         response = duration = nil
 
-        @http_lock.synchronize do
+        loc_http = http
+        perform_request = proc do
+          @inflight << loc_http
           dur_start = Time.now
-          response = http.request req_obj
+          response = loc_http.request req_obj
           dur_end = Time.now
           duration = dur_end - dur_start
         rescue EOFError
           logger.error 'Socket closed unexpectedly'
           raise
+        ensure
+          @inflight.delete loc_http
+        end
+
+        if @threadsafe == true
+          http_lock.synchronize { perform_request.call }
+        else
+          perform_request.call
+          loc_http.finish if @threadsafe == :multithread
         end
         print_http(response, duration: duration, id: req_id)
 
@@ -333,6 +360,10 @@ module MatrixSdk
       ret
     end
 
+    def stop_inflight
+      @inflight.each(&:finish)
+    end
+
     private
 
     def construct_request(method:, url:, **options)
@@ -395,18 +426,26 @@ module MatrixSdk
 
       host = (@connection_address || homeserver.host)
       port = (@connection_port || homeserver.port)
-      @http ||= if proxy_uri
-                  Net::HTTP.new(host, port, proxy_uri.host, proxy_uri.port, proxy_uri.user, proxy_uri.password)
-                else
-                  Net::HTTP.new(host, port)
-                end
-
-      @http.open_timeout = open_timeout if open_timeout
-      @http.read_timeout = read_timeout if read_timeout
-      @http.use_ssl = homeserver.scheme == 'https'
-      @http.verify_mode = validate_certificate ? ::OpenSSL::SSL::VERIFY_PEER : ::OpenSSL::SSL::VERIFY_NONE
-      @http.start
-      @http
+
+      connection = @http unless @threadsafe == :multithread
+      connection ||= if proxy_uri
+                       Net::HTTP.new(host, port, proxy_uri.host, proxy_uri.port, proxy_uri.user, proxy_uri.password)
+                     else
+                       Net::HTTP.new(host, port)
+                     end
+
+      connection.open_timeout = open_timeout if open_timeout
+      connection.read_timeout = read_timeout if read_timeout
+      connection.use_ssl = homeserver.scheme == 'https'
+      connection.verify_mode = validate_certificate ? ::OpenSSL::SSL::VERIFY_PEER : ::OpenSSL::SSL::VERIFY_NONE
+      connection.start
+      @http = connection unless @threadsafe == :multithread
+
+      connection
+    end
+
+    def http_lock
+      @http_lock ||= Mutex.new if @threadsafe == true
     end
   end
 end