librevox 1.0.0 → 1.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8f95eefd05cef30353abe1f4f6d1ccc52a94f76e9cda32e7310d3d6fadf4a88c
-  data.tar.gz: 54ffebf6ea63c600fa318a3dd157c2952cf7c521ae0725dc7476a3101ebeee67
+  metadata.gz: 741f63e510f82a40cfbb818d889405e46327bda536843c891767d21fafc7032d
+  data.tar.gz: be1b2346b673120f343d2cfea7c6eb71fcc085a3e1bdcdcaa86989dd97705b8a
 SHA512:
-  metadata.gz: dc81d98faac06579bd731e2775475912feb28cc790c1aae59287889741a2ae5ce2b2585b1939e61b57a2a209807dbd634448589a811ddf48b170c98a35f39182
-  data.tar.gz: b8b7b694902ee40f43b910f340011578b5dda2e74ae238e008732bfc62c84d7dd6e672c513487437432a9ab94a06facc7cac0f0350cf090e8047c62ae94670dc
+  metadata.gz: 77ed21f1951ea0061315850c0222ac422bedd25baa1e18b3e73bc983d9be1cfd94c6d3f9628ddc2e1461405d6623c248bd72e2a9a2bb1f898df035b0303962ed
+  data.tar.gz: 53fde0404e9b427820018c805d15f1bbb65fe9108384db699702130fb6c0aecefd89a3865e06193b75a5bc04fb06e7d47957e3e179f80f0f16a1edd414e479be

data/README.md

@@ -1,3 +1,7 @@
+<p align="center">
+  <img src=".github/banner.svg" alt="Librevox" width="100%">
+</p>
+
 # Librevox
 
 A Ruby library for interacting with [FreeSWITCH](http://www.freeswitch.org) through [mod_event_socket](https://developer.signalwire.com/freeswitch/FreeSWITCH-Explained/Modules/mod_event_socket_1048924/), using async I/O.
@@ -267,12 +271,12 @@ being processed until the current application completes.
 Librevox runs two fibers for each outbound connection:
 
 - **Session fiber** (`run_session`) — runs the setup sequence and then
-  `session_initiated`. Each `command` or `application` call blocks the fiber
+  `session_initiated`. Each `send_message` or `application` call blocks the fiber
   until the reply arrives.
 - **Read fiber** (`read_loop`) — reads messages from the socket and dispatches
   them to `Async::Queue` instances, waking the session fiber.
 
-An `Async::Semaphore(1)` mutex on `command` ensures only one command is
+An `Async::Semaphore(1)` mutex on `send_message` ensures only one command is
 in-flight at a time, so replies are always delivered to the correct caller.
 This also serializes commands issued by event hooks (which run in their own
 fibers) with the main session flow.

data/lib/librevox/command_socket.rb

@@ -16,16 +16,19 @@ module Librevox
     end
 
     def connect
-      @socket = TCPSocket.open(@server, @port)
-      stream = IO::Stream(@socket)
+      socket = TCPSocket.open(@server, @port)
+      stream = IO::Stream(socket)
       @connection = Protocol::Connection.new(stream)
-      @connection.write "auth #{@auth}\n\n"
+      send_message "auth #{@auth}"
+    end
+
+    def send_message(msg)
+      @connection.send_message(msg)
       read_response
     end
 
     def command(*args)
-      @connection.write "#{super(*args)}\n\n"
-      read_response
+      send_message(super(*args))
     end
 
     def read_response
@@ -34,6 +37,13 @@ module Librevox
       end
     end
 
+    def application(uuid, app, args = nil)
+      parts = ["sendmsg #{uuid}", "call-command: execute", "execute-app-name: #{app}"]
+      parts << "execute-app-arg: #{args}" if args && !args.empty?
+      parts << "event-lock: true"
+      send_message parts.join("\n")
+    end
+
     def close
       @connection.close
     end

data/lib/librevox/listener/base.rb

@@ -6,7 +6,7 @@ require 'async/semaphore'
 module Librevox
   module Listener
     class Base
-      def initialize(connection = nil)
+      def initialize(connection)
         @connection = connection
         @reply_queue = Async::Queue.new
         @command_mutex = Async::Semaphore.new(1)
@@ -34,7 +34,7 @@ module Librevox
         end
 
         def command(*args)
-          @listener.command(super(*args))
+          @listener.send_message(super(*args))
         end
       end
 
@@ -48,9 +48,9 @@ module Librevox
         @command_delegate ||= CommandDelegate.new(self)
       end
 
-      def command(msg)
+      def send_message(msg)
         @command_mutex.acquire do
-          write "#{msg}\n\n"
+          @connection.send_message(msg)
           @reply_queue.dequeue
         end
       end
@@ -81,10 +81,6 @@ module Librevox
       def on_event(event)
       end
 
-      def write(data)
-        @connection&.write(data)
-      end
-
       def run_session
       end
 

data/lib/librevox/listener/inbound.rb

@@ -24,7 +24,7 @@ module Librevox
         barrier.async { client.run }
       end
 
-      def initialize(connection = nil, args = {})
+      def initialize(connection, args = {})
         super(connection)
         @auth = args[:auth] || "ClueCon"
       end
@@ -32,15 +32,15 @@ module Librevox
       def run_session
         Librevox.logger.info "Connected."
 
-        command "auth #{@auth}"
+        send_message "auth #{@auth}"
 
         events = self.class.subscribe_events || ['ALL']
-        command "event plain #{events.join(' ')}"
+        send_message "event plain #{events.join(' ')}"
 
         filters = self.class.subscribe_filters || {}
         filters.each do |header, values|
           [*values].each do |value|
-            command "filter #{header} #{value}"
+            send_message "filter #{header} #{value}"
           end
         end
 

data/lib/librevox/listener/outbound.rb

@@ -14,40 +14,33 @@ module Librevox
       end
 
       def application(app, args = nil, params = {})
-        parts = ["call-command: execute", "execute-app-name: #{app}"]
+        parts = ["sendmsg", "call-command: execute", "execute-app-name: #{app}"]
         parts << "execute-app-arg: #{args}" if args && !args.empty?
         parts << "event-lock: true"
 
-        response = sendmsg parts.join("\n")
+        send_message parts.join("\n")
+        response = @app_complete_queue.dequeue
         @session = response.content
 
         params[:variable] ? variable(params[:variable]) : nil
       end
 
-      def sendmsg(msg)
-        @command_mutex.acquire do
-          write "sendmsg\n#{msg}\n\n"
-          @reply_queue.dequeue          # command/reply ack
-        end
-        @app_complete_queue.dequeue     # CHANNEL_EXECUTE_COMPLETE
-      end
-
       attr_accessor :session
 
       # Called when a new session is initiated.
       def session_initiated
       end
 
-      def initialize(connection = nil)
+      def initialize(connection)
         super(connection)
         @session = nil
         @app_complete_queue = Async::Queue.new
       end
 
       def run_session
-        @session = command("connect").headers
-        command "myevents"
-        command "linger"
+        @session = send_message("connect").headers
+        send_message "myevents"
+        send_message "linger"
         session_initiated
         sleep # keep session alive for event hooks and child tasks
       end

data/lib/librevox/protocol/connection.rb

@@ -30,8 +30,8 @@ module Librevox
         end
       end
 
-      def write(data)
-        @stream.write(data)
+      def send_message(msg)
+        @stream.write("#{msg}\n\n")
         @stream.flush
       end
 

data/lib/librevox/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Librevox
-  VERSION = "1.0.0"
+  VERSION = "1.1.0"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: librevox
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 1.1.0
 platform: ruby
 authors:
 - Harry Vangberg