caracal 0.1.0

data/lib/caracal/core/models/list_model.rb

@@ -0,0 +1,130 @@
+require 'caracal/core/models/base_model'
+require 'caracal/core/models/list_item_model'
+require 'caracal/errors'
+
+
+module Caracal
+  module Core
+    module Models
+      
+      # This class encapsulates the logic needed to store and manipulate
+      # list data.
+      #
+      class ListModel < BaseModel
+        
+        #-------------------------------------------------------------
+        # Configuration
+        #-------------------------------------------------------------
+        
+        # constants
+        const_set(:DEFAULT_LIST_TYPE,  :unordered)
+        const_set(:DEFAULT_LIST_LEVEL, 0)
+        
+        # accessors
+        attr_reader :list_type
+        attr_reader :list_level
+        
+        
+        # initialization
+        def initialize(**options, &block)
+          @list_type  = DEFAULT_LIST_TYPE
+          @list_level = DEFAULT_LIST_LEVEL
+          
+          super options, &block
+        end
+        
+        
+        #-------------------------------------------------------------
+        # Public Instance Methods
+        #-------------------------------------------------------------
+    
+        #=============== GETTERS ==============================
+        
+        # This method returns only those items owned directly 
+        # by this list.
+        #
+        def items
+          @items ||= []
+        end
+        
+        # This method returns a hash, where the keys are levels
+        # and the values are the list type at that level.
+        #
+        def level_map
+          recursive_items.reduce({}) do |hash, item|
+            hash[item.list_item_level] = item.list_item_type
+            hash
+          end
+        end
+      
+        # This method returns a flattened array containing every 
+        # item within this list's tree.
+        #
+        def recursive_items
+          items.map do |model|
+            if model.nested_list.nil?
+              model
+            else
+              [model, model.nested_list.recursive_items]
+            end
+          end.flatten
+        end
+        
+        
+        #=============== SETTERS ==============================
+        
+        # integers
+        [:level].each do |m|
+          define_method "#{ m }" do |value|
+            instance_variable_set("@list_#{ m }", value.to_i)
+          end
+        end
+
+        # symbols
+        [:type].each do |m|
+          define_method "#{ m }" do |value|
+            instance_variable_set("@list_#{ m }", value.to_s.to_sym)
+          end
+        end
+        
+        
+        #=============== SUB-METHODS ===========================
+        
+        # .li
+        def li(*args, **options, &block)
+          options.merge!({ content: args[0]    }) unless args[0].nil?
+          options.merge!({ type:    list_type  })
+          options.merge!({ level:   list_level })
+          
+          model = Caracal::Core::Models::ListItemModel.new(options, &block)
+          if model.valid?
+            items << model
+          else
+            raise Caracal::Errors::InvalidModelError, 'List item must have at least one run.'
+          end
+        end
+        
+        
+        #=============== VALIDATION ===========================
+        
+        def valid?
+          a = [:type, :level]
+          required = a.map { |m| send("list_#{ m }") }.compact.size == a.size
+          required && !items.empty?
+        end
+        
+        
+        #-------------------------------------------------------------
+        # Private Instance Methods
+        #-------------------------------------------------------------
+        private
+        
+        def option_keys
+          [:type, :level]
+        end
+        
+      end
+      
+    end
+  end
+end

data/lib/caracal/core/models/list_style_model.rb

@@ -0,0 +1,129 @@
+module Caracal
+  module Core
+    module Models
+      
+      # This class encapsulates the logic needed to store and manipulate
+      # list style data.
+      #
+      class ListStyleModel < BaseModel
+        
+        #-------------------------------------------------------------
+        # Configuration
+        #-------------------------------------------------------------
+        
+        # constants
+        const_set(:TYPE_MAP,              { ordered: 1, unordered: 2 })
+        const_set(:DEFAULT_STYLE_LEFT,    720)      # units in twips 
+        const_set(:DEFAULT_STYLE_LINE,    360)      # units in twips 
+        const_set(:DEFAULT_STYLE_ALIGN,   :left)
+        const_set(:DEFAULT_STYLE_START,   1)
+        const_set(:DEFAULT_STYLE_RESTART, true)
+        
+        # accessors
+        attr_reader :style_type
+        attr_reader :style_level
+        attr_reader :style_format
+        attr_reader :style_value
+        attr_reader :style_start
+        attr_reader :style_align
+        attr_reader :style_left
+        attr_reader :style_line
+        attr_reader :style_restart
+        
+        
+        # initialization
+        def initialize(**options, &block)
+          @style_align   = DEFAULT_STYLE_ALIGN
+          @style_left    = DEFAULT_STYLE_LEFT
+          @style_line    = DEFAULT_STYLE_LINE
+          @style_start   = DEFAULT_STYLE_START
+          @style_restart = DEFAULT_STYLE_RESTART
+          
+          super options, &block
+        end
+        
+        
+        #-------------------------------------------------------------
+        # Public Class Methods
+        #-------------------------------------------------------------
+        
+        def self.formatted_type(type)
+          TYPE_MAP.fetch(type.to_s.to_sym)
+        end
+        
+        
+        #-------------------------------------------------------------
+        # Public Instance Methods
+        #-------------------------------------------------------------
+    
+        #=============== GETTERS ==============================
+        
+        def formatted_type
+          self.class.formatted_type(style_type)
+        end
+        
+        def formatted_restart
+          v = style_restart ? '1' : '0'
+        end
+        
+        
+        #=============== SETTERS ==============================
+        
+        # booleans
+        [:restart].each do |m|
+          define_method "#{ m }" do |value|
+            instance_variable_set("@style_#{ m }", !!value)
+          end
+        end
+        
+        # integers
+        [:level, :left, :line, :start].each do |m|
+          define_method "#{ m }" do |value|
+            instance_variable_set("@style_#{ m }", value.to_i)
+          end
+        end
+        
+        # strings
+        [:format, :value].each do |m|
+          define_method "#{ m }" do |value|
+            instance_variable_set("@style_#{ m }", value.to_s)
+          end
+        end
+        
+        # symbols
+        [:type, :align].each do |m|
+          define_method "#{ m }" do |value|
+            instance_variable_set("@style_#{ m }", value.to_s.to_sym)
+          end
+        end
+        
+        
+        #=============== STATE ================================
+        
+        def matches?(type, level)
+          style_type == type.to_s.to_sym && style_level == level.to_i
+        end
+        
+        
+        #=============== VALIDATION ===========================
+        
+        def valid?
+          a = [:type, :level, :format, :value]
+          a.map { |m| send("style_#{ m }") }.compact.size == a.size
+        end
+        
+        
+        #-------------------------------------------------------------
+        # Private Instance Methods
+        #-------------------------------------------------------------
+        private
+        
+        def option_keys
+          [:type, :level, :format, :value, :align, :left, :line, :start]
+        end
+        
+      end
+      
+    end
+  end
+end

data/lib/caracal/core/models/margin_model.rb

@@ -0,0 +1,76 @@
+require 'caracal/core/models/base_model'
+
+
+module Caracal
+  module Core
+    module Models
+      
+      # This class handles block options passed to the margins
+      # method.
+      #
+      class MarginModel < BaseModel
+        
+        #-------------------------------------------------------------
+        # Configuration
+        #-------------------------------------------------------------
+        
+        # constants
+        const_set(:DEFAULT_MARGIN_TOP,    0)  # units in twips
+        const_set(:DEFAULT_MARGIN_BOTTOM, 0)  # units in twips
+        const_set(:DEFAULT_MARGIN_LEFT,   0)  # units in twips
+        const_set(:DEFAULT_MARGIN_RIGHT,  0)  # units in twips
+        
+        # accessors
+        attr_reader :margin_top
+        attr_reader :margin_bottom
+        attr_reader :margin_left
+        attr_reader :margin_right
+        
+        
+        # initialization
+        def initialize(**options, &block)
+          @margin_top    = DEFAULT_MARGIN_TOP
+          @margin_bottom = DEFAULT_MARGIN_BOTTOM
+          @margin_left   = DEFAULT_MARGIN_LEFT
+          @margin_right  = DEFAULT_MARGIN_RIGHT
+          
+          super options, &block
+        end
+        
+        
+        #-------------------------------------------------------------
+        # Public Methods
+        #-------------------------------------------------------------
+        
+        #=============== SETTERS ==============================
+        
+        # integers
+        [:bottom, :left, :right, :top].each do |m|
+          define_method "#{ m }" do |value|
+            instance_variable_set("@margin_#{ m }", value.to_i)
+          end
+        end
+        
+        
+        #=============== VALIDATION ==============================
+        
+        def valid?
+          dims = [:bottom, :left, :right, :top]
+          dims.map { |d| send("margin_#{ d }") }.all? { |d| d > 0 }
+        end
+        
+        
+        #-------------------------------------------------------------
+        # Private Instance Methods
+        #-------------------------------------------------------------
+        private
+        
+        def option_keys
+          [:top, :bottom, :left, :right]
+        end
+        
+      end
+      
+    end
+  end
+end

data/lib/caracal/core/models/page_break_model.rb

@@ -0,0 +1,15 @@
+require 'caracal/core/models/base_model'
+
+
+module Caracal
+  module Core
+    module Models
+      
+      # This class encapsulates the logic needed to store and manipulate
+      # page break data.
+      #
+      class PageBreakModel < BaseModel; end
+      
+    end
+  end
+end

data/lib/caracal/core/models/page_number_model.rb

@@ -0,0 +1,69 @@
+require 'caracal/core/models/base_model'
+
+
+module Caracal
+  module Core
+    module Models
+      
+      # This class handles block options passed to the page_numbers
+      # method.
+      #
+      class PageNumberModel < BaseModel
+        
+        #-------------------------------------------------------------
+        # Configuration
+        #-------------------------------------------------------------
+        
+        # constants
+        const_set(:DEFAULT_PAGE_NUMBER_SHOW,  false)
+        const_set(:DEFAULT_PAGE_NUMBER_ALIGN, :center)
+        
+        # accessors
+        attr_reader :page_number_align
+        attr_reader :page_number_show
+        
+        # initialization
+        def initialize(**options, &block)
+          @page_number_show  = DEFAULT_PAGE_NUMBER_SHOW
+          @page_number_align = DEFAULT_PAGE_NUMBER_ALIGN
+          
+          super options, &block
+        end
+        
+        
+        #-------------------------------------------------------------
+        # Public Methods
+        #-------------------------------------------------------------
+    
+        #=============== SETTERS ==============================
+        
+        def align(value)
+          @page_number_align = value.to_s.to_sym
+        end
+        
+        def show(value)
+          @page_number_show = !!value
+        end
+        
+        
+        #=============== VALIDATION ===========================
+        
+        def valid?
+          (!page_number_show || [:left, :center, :right].include?(page_number_align))
+        end
+        
+        
+        #-------------------------------------------------------------
+        # Private Instance Methods
+        #-------------------------------------------------------------
+        private
+        
+        def option_keys
+          [:align, :show]
+        end
+        
+      end
+      
+    end
+  end
+end

data/lib/caracal/core/models/page_size_model.rb

@@ -0,0 +1,70 @@
+require 'caracal/core/models/base_model'
+
+
+module Caracal
+  module Core
+    module Models
+      
+      # This class handles block options passed to the page size
+      # method.
+      #
+      class PageSizeModel < BaseModel
+        
+        #-------------------------------------------------------------
+        # Configuration
+        #-------------------------------------------------------------
+        
+        # constants
+        const_set(:DEFAULT_PAGE_WIDTH,  12240)  # 8.5in  in twips
+        const_set(:DEFAULT_PAGE_HEIGHT, 15840)  # 11.0in in twips
+        
+        # accessors
+        attr_reader :page_width
+        attr_reader :page_height
+        
+        # initialization
+        def initialize(**options, &block)
+          @page_width  = DEFAULT_PAGE_WIDTH
+          @page_height = DEFAULT_PAGE_HEIGHT
+          
+          super options, &block
+        end
+        
+        
+        #-------------------------------------------------------------
+        # Public Methods
+        #-------------------------------------------------------------
+    
+        #=============== SETTERS ==============================
+        
+        def height(value)
+          @page_height = value.to_i
+        end
+        
+        def width(value)
+          @page_width = value.to_i
+        end
+        
+        
+        #=============== VALIDATION ==============================
+        
+        def valid?
+          dims = [page_width, page_height]
+          dims.all? { |d| d > 0 }
+        end
+        
+        
+        #-------------------------------------------------------------
+        # Private Instance Methods
+        #-------------------------------------------------------------
+        private
+        
+        def option_keys
+          [:width, :height]
+        end
+        
+      end
+      
+    end
+  end
+end