Contents

module Vedeu

  # Provides the main loop for a Vedeu application.
  #
  # Each time Vedeu starts one cycle in the application loop, it triggers the
  # `:tick` event. A completion of that cycle will trigger `:tock`. This can be
  # used by the client application for timing amongst other things.
  #
  class MainLoop

    trap('SIGTERM') { stop! }
    trap('TERM')    { stop! }
    trap('INT')     { stop! }

    # :nocov:
    # Start the main loop.
    #
    # @return [void]
    # @yieldreturn [void] The client application.
    def self.start!
      @started = true
      @loop    = true

      while @loop
        yield

        safe_exit_point!
      end
    rescue VedeuInterrupt
    end
    # :nocov:

    # Signal that we wish to terminate the running application.
    #
    # @return [void]
    def self.stop!
      @loop = false
    end

    # Check the application has started and we wish to continue running.
    #
    # @raise [VedeuInterrupt] When we wish to terminate the running application.
    # @return [void]
    def self.safe_exit_point!
      if @started && !@loop
        fail VedeuInterrupt

      else
        Vedeu.trigger(:tock, Time.now.to_f)

      end
    end

  end # MainLoop

end # Vedeu

Version data entries

3 entries across 3 versions & 1 rubygems

Version	Path
vedeu-0.4.18	lib/vedeu/main_loop.rb
vedeu-0.4.17	lib/vedeu/main_loop.rb
vedeu-0.4.16	lib/vedeu/main_loop.rb