cura 0.0.1

data/lib/cura.rb

@@ -0,0 +1,13 @@
+if Kernel.respond_to?(:require)
+  require "cura/version"
+  require "cura/adapter"
+  require "cura/application"
+  require "cura/window"
+  require "cura/component/group"
+  require "cura/component/pack"
+  require "cura/component/label"
+  require "cura/component/button"
+  require "cura/component/listbox"
+  # require 'cura/component/scrollbar'
+  require "cura/component/textbox"
+end

data/lib/cura/adapter.rb

@@ -0,0 +1,67 @@
+if Kernel.respond_to?(:require)
+  require "cura/attributes/has_initialize"
+  require "cura/attributes/has_attributes"
+end
+
+module Cura
+  
+  # The base class for adapters.
+  class Adapter
+    
+    class << self
+      
+      # The list of all Adapter subclasses.
+      #
+      # @return [Array]
+      def all
+        @all ||= []
+      end
+      
+      def inherited(subclass)
+        all << subclass
+      end
+      
+      def mixins
+        @mixins ||= {}
+      end
+      
+      def mixin(value)
+        mixins.merge!(value.to_h)
+      end
+      
+    end
+    
+    include Attributes::HasInitialize
+    include Attributes::HasAttributes
+    
+    def initialize(attributes={})
+      @setup = false
+      
+      super
+    end
+    
+    def setup
+      @setup = true
+      
+      self.class.mixins.each { |type, mod| type.send(:include, mod) }
+      
+      self
+    end
+    
+    def setup?
+      @setup
+    end
+    
+    def clear
+      
+    end
+    
+    def cleanup
+      @setup = false
+      
+      self
+    end
+    
+  end
+  
+end

data/lib/cura/application.rb

@@ -0,0 +1,245 @@
+if Kernel.respond_to?(:require)
+  require "cura/attributes/has_attributes"
+  require "cura/attributes/has_windows"
+  require "cura/attributes/has_events"
+  require "cura/attributes/has_initialize"
+  
+  require "cura/component/base"
+  
+  require "cura/event/dispatcher"
+  
+  require "cura/event/click"
+  require "cura/event/focus"
+  require "cura/event/unfocus"
+  require "cura/event/handler"
+  require "cura/event/key_down"
+  require "cura/event/mouse_button"
+  require "cura/event/mouse_wheel_down"
+  require "cura/event/mouse_wheel_up"
+  require "cura/event/resize"
+  require "cura/event/selected"
+  
+  require "cura/event/middleware/dispatch"
+  require "cura/event/middleware/aimer/mouse_focus"
+  require "cura/event/middleware/aimer/target_option"
+  require "cura/event/middleware/aimer/dispatcher_target"
+  require "cura/event/middleware/translator/mouse_click"
+  
+  require "cura/error/invalid_adapter"
+    
+  require "cura/cursor"
+  require "cura/pencil"
+end
+
+module Cura
+  
+  # An application.
+  class Application
+    
+    class << self
+      
+      def run(attributes={})
+        new(attributes).run
+      end
+      
+    end
+    
+    include Attributes::HasInitialize
+    include Attributes::HasAttributes
+    include Attributes::HasWindows
+    include Attributes::HasEvents
+    
+    def initialize(attributes={})
+      super
+      
+      @running = false
+      @cursor = Cursor.new(application: self)
+      @pencil = Pencil.new
+      
+      setup_adapter
+      setup_dispatcher
+    end
+    
+    # @method adapter
+    # Get the adapter used for running this application.
+    #
+    # @return [Adapter]
+    
+    # @method adapter=(adapter)
+    # Set the adapter used for running this application.
+    # This cannot be set after #run is used.
+    #
+    # @param [Adapter] value The new adapter.
+    # @return [Adapter]
+    
+    attribute(:adapter) { |adapter| validate_adapter(adapter) }
+    
+    # Get the text cursor.
+    #
+    # @return [Cursor]
+    attr_reader :cursor
+    
+    # Get the pencil used for drawing.
+    #
+    # @return [Pencil]
+    attr_reader :pencil
+    
+    # Get the event dispatcher.
+    #
+    # @return [Event::Dispatcher]
+    attr_reader :dispatcher
+    
+    # Run this application.
+    #
+    # @return [Application] This application.
+    def run
+      run_event_loop
+      
+      self
+    ensure
+      @adapter.cleanup
+    end
+    
+    # Stop the application after the current run cycle.
+    #
+    # @return [Application] This application.
+    def stop
+      @running = false
+      
+      self
+    end
+    
+    # Stop the application immediently.
+    #
+    # @return [Application] This application.
+    def stop!
+      stop
+      @adapter.cleanup
+      
+      self
+    end
+    
+    # Check if this application is running.
+    #
+    # @return [Boolean]
+    def running?
+      @running
+    end
+    
+    # Get the currently focused component.
+    #
+    # @return [Component::Base]
+    def focused
+      @dispatcher.target
+    end
+    
+    # Set focus to a component.
+    #
+    # There can only be one component focused at a time within an application, if any.
+    # All dispatched events are sent to the currently focused component, or the application if no component is focused.
+    #
+    # @param [nil, Component::Base] component
+    # @return [Component::Base]
+    def focus(component)
+      raise TypeError, "component must be nil or be a Cura::Component::Base" unless component.nil? || component.is_a?(Cura::Component::Base)
+      
+      dispatch_event(:unfocus)
+      @dispatcher.target = component
+      dispatch_event(:focus)
+      
+      component
+    end
+    
+    # Dispatch an event.
+    #
+    # @param [#to_sym] event The name of the event class to create an instance of or an event instance.
+    # @param [#to_hash, #to_h] options
+    # @option options [#to_i] :target The optional target of the event.
+    # @return [Event::Base] The dispatched event.
+    def dispatch_event(event, options={})
+      @dispatcher.dispatch_event(event, options)
+    end
+    
+    # Add a window to this application.
+    #
+    # @param [Window] window
+    # @return [Window]
+    def add_window(window)
+      super
+      
+      window.application = self
+      
+      window
+    end
+
+    # Update all windows.
+    #
+    # @return [Application]
+    def update
+      update_windows
+      cursor.update
+      
+      self
+    end
+    
+    # Draw all windows.
+    #
+    # @return [Application]
+    def draw
+      draw_windows
+      
+      self
+    end
+    
+    # Instance inspection.
+    #
+    # @return [String]
+    def inspect
+      "#<#{self.class}>"
+    end
+
+    protected
+    
+    def setup_adapter
+      if @adapter.nil?
+        adapter_class ||= Adapter.all.first
+        raise Error::InvalidAdapter if adapter_class.nil?
+        
+        @adapter = adapter_class.new
+      end
+      
+      # TODO: If a class is given, run .new on it first
+      
+      @adapter.setup
+    end
+    
+    def setup_dispatcher
+      @dispatcher = Event::Dispatcher.new(application: self)
+      
+      @dispatcher.middleware << Event::Middleware::Aimer::MouseFocus.new
+      @dispatcher.middleware << Event::Middleware::Aimer::TargetOption.new
+      @dispatcher.middleware << Event::Middleware::Aimer::DispatcherTarget.new
+      @dispatcher.middleware << Event::Middleware::Dispatch.new
+      @dispatcher.middleware << Event::Middleware::Translator::MouseClick.new
+    end
+    
+    def validate_adapter(adapter)
+      # TODO: Raise error if ever set more than once
+      raise Error::InvalidAdapter unless adapter.is_a?(Cura::Adapter)
+      
+      adapter
+    end
+    
+    def run_event_loop
+      @running = true
+      
+      while @running
+        update
+        draw
+        dispatcher.run
+      end
+    end
+    
+  end
+  
+end

data/lib/cura/attributes/has_ancestry.rb

@@ -0,0 +1,40 @@
+module Cura
+  module Attributes
+    
+    # Allows an object to have a `parent` and `ancestors`.
+    module HasAncestry
+      
+      def initialize(attributes={})
+        @ancestors = []
+        
+        super
+      end
+      
+      # Get/set the parent of this object.
+      # It's not recommended to set this directly as it may break the ancestory chain.
+      #
+      # @return [Object]
+      attr_accessor :parent
+      
+      # Determine if this object has a parent.
+      #
+      # @return [Boolean]
+      def parent?
+        !@parent.nil?
+      end
+      
+      # Get the ancestors of this object.
+      #
+      # @return [Array<Object>]
+      def ancestors
+        if @parent.nil?
+          []
+        else
+          @parent.respond_to?(:ancestors) ? [@parent] + @parent.ancestors : [@parent]
+        end
+      end
+      
+    end
+    
+  end
+end

data/lib/cura/attributes/has_application.rb

@@ -0,0 +1,31 @@
+if Kernel.respond_to?(:require)
+  require "cura/application"
+  
+  require "cura/error/invalid_application"
+end
+
+module Cura
+  module Attributes
+    
+    # Allows an object to belong to a Cura::Application.
+    module HasApplication
+      
+      # Get the application of this object.
+      #
+      # @return [Application]
+      attr_reader :application
+      
+      # Set the application of this object.
+      #
+      # @param [Application] value
+      # @return [Application]
+      def application=(value)
+        raise Error::InvalidApplication unless value.nil? || value.is_a?(Cura::Application)
+        
+        @application = value
+      end
+      
+    end
+    
+  end
+end

data/lib/cura/attributes/has_attributes.rb

@@ -0,0 +1,89 @@
+module Cura
+  module Attributes
+
+    # Adds the `update_attributes` method.
+    module HasAttributes # TODO: Aspect::HasAttributes
+
+      # The class methods to be mixed in when included.
+      module ClassMethods
+
+        def attribute(name, options={}, &block)
+          options = options.to_h
+
+          if options[:query]
+            define_method("#{name}?") { instance_variable_get("@#{name}") }
+          else
+            attr_reader(name)
+          end
+
+          if options[:query]
+            define_method("#{name}=") do |value|
+              value = instance_exec(value, options, &block) unless block.nil?
+
+              instance_variable_set("@#{name}", !!value)
+            end
+          else
+            define_method("#{name}=") do |value|
+              value = instance_exec(value, options, &block) unless block.nil?
+
+              instance_variable_set("@#{name}", value)
+            end
+          end
+        end
+
+      end
+
+      class << self
+
+        def included(base)
+          base.extend(ClassMethods)
+        end
+
+      end
+
+      # Initialize this object by optionally updating attributes with a Hash.
+      #
+      # @param [#to_h] attributes Attributes to set after initializing.
+      def initialize(attributes={})
+        update_attributes(attributes)
+
+        super
+      end
+
+      # Update any attributes on this object.
+      #
+      # @param [#to_h] attributes
+      # @return [Hash] The attributes.
+      def update_attributes(attributes={})
+        attributes = convert_attributes(attributes)
+
+        attributes.each { |name, value| send("#{name}=", value) }
+      end
+
+      protected
+
+      VALID_SIZE_SYMBOLS = [:auto, :inherit]
+
+      def validate_size_attribute(value)
+        if value.is_a?(Symbol)
+          raise ArgumentError, "must be one of #{VALID_SIZE_SYMBOLS.join(', ')}" unless VALID_SIZE_SYMBOLS.include?(value)
+        else
+          value = value.to_i
+          value = 0 if value < 0
+        end
+
+        value
+      end
+
+      # Convert the attributes to a Hash and any other conversions that may need to happen.
+      #
+      # @param [#to_h] attributes
+      # @return [Hash] The attributes.
+      def convert_attributes(attributes={})
+        attributes.to_h
+      end
+
+    end
+
+  end
+end