lib/nfoiled.rb

   1 require 'nfoiled/terminal'
   2 require 'nfoiled/window'
   3
   4 require 'ncurses'
   5
   6 ##
   7 # See `README.markdown`.
   8 module Nfoiled
   9   Version = 0
  10
  11   class <<self
  12     attr_accessor :initialized; alias_method :initialized?, :initialized
  13
  14     ##
  15     # This module method is responsible for setting up the entirety of Nfoiled's
  16     # overall environment. It will be called before any other Nfoiled
  17     # functionality is allowed. In most cases, this will be called for you.
  18     #
  19     # This method also schedules `Nfoiled::finalize` to be automatically run
  20     # `at_exit`.
  21     def initialize!
  22       self.initialized = true
  23       Terminal.default = Terminal.new unless Terminal.current
  24       at_exit { Nfoiled.finalize }
  25     end
  26
  27     ##
  28     # This module method ensures that Nfoiled is initialized. It simply calls
  29     # `Nfoiled::initialize!` if Nfoiled hasn't already been initialized.
  30     def initialize
  31       initialize! unless initialized?
  32     end
  33     public :initialize
  34
  35     ##
  36     # This method is responsible for tearing down any environment set up by the
  37     # `Ncurses::initialize!` method.
  38     def finalize!
  39       self.initialized = false
  40       ::Ncurses.endwin
  41       Terminal.terminals.each {|t| t.destroy! }
  42       Terminal.current, Terminal.default = nil
  43     end
  44
  45     ##
  46     # This module method ensures that Nfoiled is finalize. It simply calls
  47     # `Nfoiled::finalize!` if Nfoiled hasn't already been finalized.
  48     def finalize
  49       # TODO: Ensure finalization on fatal errors or interrupts
  50       finalize! if initialized?
  51     end
  52   end
  53
  54 end