rspreadsheet 0.2.15 → 0.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 8c4d7239e35070d3406af3f5c7aadb872d5c0038
-  data.tar.gz: e06d7243078d7531984714f29ed403ce62fcc9df
+  metadata.gz: b7c4756f4b74164e9aeafb35af79f923aff8a5fa
+  data.tar.gz: 04814801b5e23bd0d4077ffbe39a65fbc7401d67
 SHA512:
-  metadata.gz: dfe7532c19164f3f96611793df3eb75e2c5d67c9c3763cfaee72e88f1e060ec54d9c0978c3e59183520ddc05f0ab5a88d09f8e5e03d15fc4397de5a78740c81f
-  data.tar.gz: f84bbe8045dfe515ac18e50df5a7482e7e6ba0282b57ba2f1ffa50991d3aec3b45a60c7080d7183a867a3839bd7f639a801b0b7e90b9d7aec9a1a59ab1a5fa34
+  metadata.gz: e9e8fd002a0fdd21bd453b62088df71ece09d107eb6b6b8217f6805e989e0c18d63d376d8e7c338b2b8c292f7d46deec8dab8b161372a59978b10b33990de417
+  data.tar.gz: 59db224cb0928ee5494f79583e6f340ecba729670688e39f0a64216647947a274022e73740f801bbe0e639984d7806d610484742805f469a2c8df0d033dfebaa

data/.gitignore

@@ -43,4 +43,7 @@ Gemfile.lock
 
 # specific to the project
 /*.ods
-/spec/testfile1/
+/spec/testfile1/
+
+#temporary
+/w

data/.travis.yml

@@ -1,13 +1,14 @@
 language: ruby
 cache: bundler
 rvm:
-  - 2.2.3
-  - 2.2.0
-  - 2.1.7
   - 2.0.0
-  - 1.9.3
+  - 2.1.10
+  - 2.2.6
+  - 2.3.3
+  - 2.4.0
 script: 'bundle exec rake'
 before_install:
+  - gem uninstall libxml-ruby
   - gem update bundler
 notifications:
   email:

data/DEVEL_BLOG.md

@@ -1,5 +1,13 @@
 See [GUIDE.md](GUIDE.md#conventions) for syntax conventions.
 
+## Installation troubleshooting
+
+After you have cloned the source run `bundle` command in gem directory to install needed tools. If there are any errors try to
+
+  1. Make sure that necessary tools are installed. In debian based distros you may try this  `apt-get install make gcc`. In other distros, use their native way to install tools. 
+  2. If you have installed `ruby-libxml` than you may want to comment out the line containing libxml-ruby dependency in rspreadseet.gemspec file before running bundle.
+  3. Comment out `guard` and `guard-rspec` lines from gemfile if you use ruby version less than 2.2.1.
+
 ## Ideas/wishlist
 
   * In future inntroduce syntax like `sheet.range('C3:E4')` for mass operations.
@@ -13,6 +21,8 @@ See [GUIDE.md](GUIDE.md#conventions) for syntax conventions.
   * implement to_csv
   * longterm plan - go through other used libraries and try to find out whose syntax could be adopted, so this library is drop in replacement (possibly with some config options) for them
   * iterative generation like this
+  * Currently the way you insert cells and rows is that you insert empty one and than copy values. It would be interesting to add "duplicate" method as well as other "copy pasting" stuff, which would be more forward compatible.
+  * Optionally allow negative coordinates count from end
  
  ```ruby
 RSpreadsheet.generate('pricelist.ods') do 
@@ -53,7 +63,7 @@ RSpreadsheet.generate('pricelist.ods') do
 * array returned by rows of cells can have predefined dummy object as defaults for out of range indexes
 
 
-##Guiding ideas
+## Guiding ideas
   * xml document is always synchronized with the data. So the save is trivial.
   * no duplication of data. Objects like RowArray should containg minimum information. This one exists solely to speed up cell search. Taken to extream it is questionable, whether we need such objects at all, it might be possible to always work with xml directly.
   * all cells and rows only server as proxy. they hold index and worksheet pointer and everytime read or write is done, the xml is newly searched. until there is a xmlnode caching we have no problem
@@ -62,6 +72,12 @@ RSpreadsheet.generate('pricelist.ods') do
 ## Known Issues
   * currently there is a confusing syntax @worksheet.rows(1).cells[5] which returns a cell object in SIXT column, which is not intended. It is side effecto of Row#cells returning an array
     
+## Release notes
+
+  2017-01
+  * basic image handling implemented (issue [#24](https://github.com/gorn/rspreadsheet/issues/24))
+  * bug corrected: inserted row was not empty, but rather copy of the row below.
+    
 ## Developing this gem
 
 ### Automated testing
@@ -84,7 +100,7 @@ RSpreadsheet.generate('pricelist.ods') do
 5. When happy, increment the version number and `git add .; git commit -am'commit message'; git push`
 6. ``rake release`` - creates a version tag in git and pushes the code to github + Rubygems. After this is succesfull the new version appears as release in Github and RubyGems.
 
-gem alternativa to points 3-6
+gem alternative to points 3-6
 
     gem build rspreadsheet.gemspec              -\   These two lines together are in install.sh
     sudo gem install rspreadsheet-x.y.z.gem     -/   which should be invoked from parent directory

data/GUIDE.md

@@ -28,6 +28,11 @@ You can mix these two at will, for example like this
 @row[4] = 10
 ````
 
+### Working with images
+@sheet.insert_image_to('10.21mm','15mm','image.png')
+i = @sheet.images.first
+i.move_to('100mm','99.98mm')
+
 ## Examples
 
   * [basic functionality](https://gist.github.com/gorn/42e33d086d9b4fda10ec) 

data/Guardfile

@@ -13,13 +13,13 @@ end
 # classical part
 scope group: :normal
 
-group :normal do
-  guard 'rspec' do watch_all end
+group :normal, cmd: "bundle exec rspec" do
+  guard 'rspec', cmd: 'bundle exec rspec' do watch_all end
 end
 
 # see http://stackoverflow.com/questions/18501471/guard-how-to-run-specific-tags-from-w-in-guards-console
 group :focus do
-  guard 'rspec', cli: '--tag focus' do watch_all end
+  guard 'rspec', cmd: 'bundle exec rspec --tag focus' do watch_all end
 end
 
 #group :f do

data/README.md

@@ -1,5 +1,5 @@
+[![Build Status](https://api.travis-ci.org/gorn/rspreadsheet.svg?branch=master)](https://travis-ci.org/gorn/rspreadsheet) [![Coverage Status](https://coveralls.io/repos/gorn/rspreadsheet/badge.svg?branch=master&service=github)](https://coveralls.io/r/gorn/rspreadsheet) [![User opinion wanted](https://badge.waffle.io/gorn/rspreadsheet.png?label=user opinion wanted&title=User opinion wanted)](https://waffle.io/gorn/rspreadsheet)  
 
-[![Build Status](https://api.travis-ci.org/gorn/rspreadsheet.svg?branch=master)](https://travis-ci.org/gorn/rspreadsheet) [![Coverage Status](https://coveralls.io/repos/gorn/rspreadsheet/badge.png)](https://coveralls.io/r/gorn/rspreadsheet) [![User opinion wanted](https://badge.waffle.io/gorn/rspreadsheet.png?label=user opinion wanted&title=User opinion wanted)](https://waffle.io/gorn/rspreadsheet)
 # rspreadsheet
  
 Manipulating spreadsheets with Ruby. Read, **modify**, write or create new OpenDocument Spreadsheet files from ruby code. 
@@ -32,7 +32,10 @@ sheet.row(5).cellvalues.sum
 sheet.row(5).cells.sum{ |cell| cell.value.to_f }
 
 # or set formula to a cell
-sheet.A1.formula='=SUM(A2:A9)'
+sheet.cell('A1').formula='=SUM(A2:A9)'
+
+# insert company logo to the file
+sheet.insert_image_to('10mm','15mm','company_logo.png')
 
 # iterating over list of people and displaying the data
 total = 0
@@ -47,11 +50,8 @@ book.save
 book.save('different_filename.ods')
 ```
 
-This is also pubished as Gist **where you can leave you comments and suggestions**:
-
-  * [basic functionality](https://gist.github.com/gorn/42e33d086d9b4fda10ec) 
-  * [extended examples](https://gist.github.com/gorn/b432e6a69e82628349e6) of lots of alternative syntax
-  * [GUIDE.md](GUIDE.md) some other notes
+  * [More examples](https://gist.github.com/gorn/b432e6a69e82628349e6) of lots of alternative syntax **you can leave you comments and suggestions there**
+  * [Guide to using Rspreadsheet](GUIDE.md) some other notes
 
 ## Installation and Configuration
 
@@ -76,12 +76,12 @@ Alhought this gem is still in beta stage I use in everyday and it works fine. Cu
 
 ### Programmers
 
-1. [Fork it](http://github.com/gorn/rspreadsheet/fork)
+1. [Fork it](http://github.com/gorn/rspreadsheet/fork) and clone it ([troubleshooting](https://github.com/gorn/rspreadsheet/blob/master/DEVEL_BLOG.md#installation-troubleshooting))
 2. Create your feature branch (`git checkout -b my-new-feature`)
 3. Commit your changes (`git commit -am 'Add some feature'`)
 4. Push to the branch (`git push origin my-new-feature`)
 5. Create new Pull Request
- 
+
 ## Why another OpenDocument spreadsheet gem?
 
 I would be glad to safe myself work, but surprisingly, there are not that many gems for OpenDocument spreadsheets. Most of them also look abandoned and inactive, or can only read or write spreadsheets, but not modify them. I have investigated these options (you might as well):

data/lib/helpers/class_extensions.rb

@@ -1,49 +1,112 @@
-# @private
+if  RUBY_VERSION > '2.1'
 
-class LibXML::XML::Node
-  def elements
-    result = []
-    each_element { |e| result << e }
-    return result
-  end
-  # if node2 contains at least all that I do
-  def simplification_of?(node2)
-    first_diff(node2).nil?
-  end
-  # return first difference where self has something more than node2 does
-  def first_diff(node2)
-    where = self.path.split('/').last
+  module ClassExtensions
+
+    refine Array do
+      def sum(identity = 0, &block)
+        if block_given?
+          map(&block).sum(identity)
+        else
+          inject(0){ |sum, element| sum.to_f + element.to_f } || identity
+        end
+      end
+    end
     
-    return "#{where}> Equivalent node does not exist: #{self.name} != NOTHING" if node2.nil?
-    return "#{where}> Names are different: #{self.name} != #{node2.name}" if (self.name != node2.name)
-    self.attributes.each do |attr|
-      return "#{where}> Attribute #{attr} have diffent values: #{attr.value} != #{node2.attributes[attr.name]}" unless node2.attributes[attr.name] == attr.value
+    refine LibXML::XML::Node do
+      def equals?(node2); raise 'nic' end
+      def ==(node2)  
+        self.simplification_of?(node2) and node2.simplification_of?(self)
+      end
+      # if node2 contains at least all that I do
+      def simplification_of?(node2)
+        first_diff(node2).nil?
+      end
+      # return first difference where self has something more than node2 does
+      def first_diff(node2)
+        where = self.path.split('/').last
+        
+        return "#{where}> Equivalent node does not exist: #{self.name} != NOTHING" if node2.nil?
+        return "#{where}> Names are different: #{self.name} != #{node2.name}" if (self.name != node2.name)
+        self.attributes.each do |attr|
+          return "#{where}> Attribute #{attr} have diffent values: #{attr.value} != #{node2.attributes[attr.name]}" unless node2.attributes[attr.name] == attr.value
+        end
+
+        elems1 = self.elements
+        elems2 = node2.elements
+        return "#{where}> elements have different number of subelements #{elems1.length} !=  #{elems2.length}" if (elems1.length != elems2.length)
+        
+        elems1.each_index do |i|
+          raise "Nil for i=#{i}" if elems1[i].nil?
+          if (elems1[i].node_type_name == 'text') 
+            if elems2[i].nil? || (elems1[i].to_s) != (elems2[i].to_s)
+              return  "#{where}> #{i+1}th text subelements are different: #{elems1[i].to_s} != #{elems2[i].to_s}"
+            end
+          elsif (elems1[i].node_type_name == 'element') 
+            unless elems1[i].simplification_of?(elems2[i])
+              return "#{where}/[#{i+1}]#{elems1[i].first_diff(elems2[i])}"
+            end
+          end
+        end
+          
+        return nil
+      end
+      def elements
+        result = []
+        each_element { |e| result << e }
+        return result
+      end
     end
     
-    elems1 = self.elements
-    elems2 = node2.elements
-#     return "#{where}> elements have different number of subelements #{elems1.length} !=  #{elems2.length}" if (elems1.length != elems2.length) 
-    elems1.length.times do |i|
-      if (elems1[i].node_type_name == 'text') && ((elems1[i].to_s != elems2[i].to_s) )
-        return  "#{where}> #{i+1}th text subelements are different: #{elems1[i].to_s} != #{elems2[i].to_s}"
-      elsif (elems1[i].node_type_name == 'element') && (!elems1[i].simplification_of?(elems2[i]))
-        return "#{where}/[#{i+1}]#{elems1[i].first_diff(elems2[i])}"
+  end # module ClassExtensions
+
+else # Monkeypatching
+
+  class Array
+    def sum(identity = 0, &block)
+      if block_given?
+        map(&block).sum(identity)
+      else
+        inject(0){ |sum, element| sum.to_f + element.to_f } || identity
       end
     end
-       
-    return nil
-  end
-  def equals?(node2)  #TODO redefine == with this
-    self.simplification_of?(node2) and node2.simplification_of?(self)
   end
-end
 
-class Array
-  def sum(identity = 0, &block)
-    if block_given?
-      map(&block).sum(identity)
-    else
-      inject(0){ |sum, element| sum.to_f + element.to_f } || identity
+  class LibXML::XML::Node
+    def ==(node2)  
+      self.simplification_of?(node2) and node2.simplification_of?(self)
+    end
+    # if node2 contains at least all that I do
+    def simplification_of?(node2)
+      first_diff(node2).nil?
+    end
+    # return first difference where self has something more than node2 does
+    def first_diff(node2)
+      where = self.path.split('/').last
+      
+      return "#{where}> Equivalent node does not exist: #{self.name} != NOTHING" if node2.nil?
+      return "#{where}> Names are different: #{self.name} != #{node2.name}" if (self.name != node2.name)
+      self.attributes.each do |attr|
+        return "#{where}> Attribute #{attr} have diffent values: #{attr.value} != #{node2.attributes[attr.name]}" unless node2.attributes[attr.name] == attr.value
+      end
+      
+      elems1 = self.elements
+      elems2 = node2.elements
+  #     return "#{where}> elements have different number of subelements #{elems1.length} !=  #{elems2.length}" if (elems1.length != elems2.length) 
+      elems1.length.times do |i|
+        if (elems1[i].node_type_name == 'text') && ((elems1[i].to_s != elems2[i].to_s) )
+          return  "#{where}> #{i+1}th text subelements are different: #{elems1[i].to_s} != #{elems2[i].to_s}"
+        elsif (elems1[i].node_type_name == 'element') && (!elems1[i].simplification_of?(elems2[i]))
+          return "#{where}/[#{i+1}]#{elems1[i].first_diff(elems2[i])}"
+        end
+      end
+        
+      return nil
+    end
+    def elements
+      result = []
+      each_element { |e| result << e }
+      return result
     end
   end
+
 end

data/lib/rspreadsheet.rb

@@ -1,8 +1,9 @@
 require 'rspreadsheet/version'
 require 'rspreadsheet/workbook'
 require 'rspreadsheet/worksheet'
-require 'helpers/class_extensions'
 require 'helpers/configuration'
+# refinements
+require 'helpers/class_extensions'
 
 module Rspreadsheet
   extend Configuration

data/lib/rspreadsheet/cell.rb

@@ -3,12 +3,15 @@
 # @title rspreadsheet Cell
 
 require 'andand'
-require 'rspreadsheet/xml_tied'
+require 'rspreadsheet/xml_tied_item'
 require 'date'
+require 'time'
 require 'bigdecimal'
 require 'bigdecimal/util' # for to_d method
+require 'helpers/class_extensions'
 
 module Rspreadsheet
+using ClassExtensions if RUBY_VERSION > '2.1'
 
 ###
 # Represents a cell in spreadsheet which has coordinates, contains value, formula and can be formated.
@@ -17,30 +20,33 @@ module Rspreadsheet
 #     @worksheet.cells(5,2)
 #
 # Note that when using syntax like `@worksheet[5,2]` or `@worksheet.B5` you won't get this object, but rather the value of the cell.
+# More precisely it is equvalient to @worksheet.cells(5,2).value.
+# 
 
 class Cell < XMLTiedItem
-  attr_accessor :worksheet, :coli, :rowi
-  # `xml_options[:xml_items_node_name]` gives the name of the tag representing cell
-  # `xml_options[:number-columns-repeated]` gives the name of the previous tag which sais how many times the item is repeated
-  def xml_options; {:xml_items_node_name => 'table-cell', :xml_repeated_attribute => 'number-columns-repeated'} end
+  attr_accessor :worksheet 
+  attr_reader :rowi
+  InternalDateFormat = '%Y-%m-%d'
+  InternalTimeFormat = 'PT%HH%MM%SS'
+#   InternalTimeFormat = 'PT%HH%MM%SS,%LS'
   
-  ## defining abstract methods from XMLTiedItem
-  # returns parent XMLTiedArray object of myself (XMLTiedItem)
+  # @!group XMLTiedItem related methods and extensions  
+  def xml_options; {:xml_items_node_name => 'table-cell', :xml_repeated_attribute => 'number-columns-repeated'} end
   def parent; row end
-  def index; @coli end
-  def set_index(value); @coli=value end
+  def coli; index end
+    
   def set_rowi(arowi); @rowi = arowi end # this should ONLY be used by parent row
   def initialize(aworksheet,arowi,acoli)
     raise "First parameter should be Worksheet object not #{aworksheet.class}" unless aworksheet.kind_of?(Rspreadsheet::Worksheet)
     @worksheet = aworksheet
     @rowi = arowi
-    @coli = acoli
+    initialize_xml_tied_item(row,acoli)
   end
   def row; @worksheet.rows(rowi) end
   def coordinates; [rowi,coli] end
   def to_s; value.to_s end
   def valuexml; self.valuexmlnode.andand.inner_xml end
-  def valuexmlnode; self.xmlnode.children.first end
+  def valuexmlnode; self.xmlnode.elements.first end
   # use this to find node in cell xml. ex. xmlfind('.//text:a') finds all link nodes
   def valuexmlfindall(path)
     valuexmlnode.nil? ? [] : valuexmlnode.find(path)
@@ -49,7 +55,7 @@ class Cell < XMLTiedItem
     valuexmlfindall(path).first
   end
   def inspect
-    "#<Rspreadsheet::Cell:Cell\n row:#{rowi}, col:#{coli} address:#{address}\n type: #{guess_cell_type.to_s}, value:#{value}\n mode: #{mode}\n>"
+    "#<Rspreadsheet::Cell\n row:#{rowi}, col:#{coli} address:#{address}\n type: #{guess_cell_type.to_s}, value:#{value}\n mode: #{mode}, format: #{format.inspect}\n>"
   end
   def value
     gt = guess_cell_type
@@ -58,7 +64,8 @@ class Cell < XMLTiedItem
         when gt == nil then nil
         when gt == Float then xmlnode.attributes['value'].to_f
         when gt == String then xmlnode.elements.first.andand.content.to_s
-        when gt == Date then Date.strptime(xmlnode.attributes['date-value'].to_s, '%Y-%m-%d')
+        when gt == Date then Date.strptime(xmlnode.attributes['date-value'].to_s, InternalDateFormat)
+        when gt == Time then Time.strptime(xmlnode.attributes['time-value'].to_s, InternalTimeFormat)
         when gt == :percentage then xmlnode.attributes['value'].to_f
         when gt == :currency then xmlnode.attributes['value'].to_d
       end
@@ -86,8 +93,14 @@ class Cell < XMLTiedItem
         when gt == Date then 
           remove_all_value_attributes_and_content(xmlnode)
           set_type_attribute('date')
-          Tools.set_ns_attribute(xmlnode,'office','date-value', avalue.strftime('%Y-%m-%d'))
-          xmlnode << Tools.prepare_ns_node('text','p', avalue.strftime('%Y-%m-%d')) 
+          avalue = avalue.strftime(InternalDateFormat)
+          Tools.set_ns_attribute(xmlnode,'office','date-value', avalue)
+          xmlnode << Tools.prepare_ns_node('text','p', avalue)
+        when gt == Time then
+          remove_all_value_attributes_and_content(xmlnode)
+          set_type_attribute('time')
+          Tools.set_ns_attribute(xmlnode,'office','time-value', avalue.strftime(InternalTimeFormat))
+          xmlnode << Tools.prepare_ns_node('text','p', avalue.strftime('%H:%M'))
         when gt == :percentage then
           remove_all_value_attributes_and_content(xmlnode)
           set_type_attribute('percentage')
@@ -105,6 +118,7 @@ class Cell < XMLTiedItem
   def remove_all_value_attributes_and_content(node=xmlnode)
     if att = Tools.get_ns_attribute(node, 'office','value') then att.remove! end
     if att = Tools.get_ns_attribute(node, 'office','date-value') then att.remove! end
+    if att = Tools.get_ns_attribute(node, 'office','time-value') then att.remove! end
     if att = Tools.get_ns_attribute(node, 'table','formula') then att.remove! end
     node.content=''
   end
@@ -120,6 +134,7 @@ class Cell < XMLTiedItem
       when gct == Float  then :float
       when gct == String then :string
       when gct == Date   then :date
+      when gct == Time   then :time
       when gct == :percentage then :percentage
       when gct == :unassigned then :unassigned
       when gct == :currency then :currency
@@ -132,28 +147,29 @@ class Cell < XMLTiedItem
     # try guessing by value
     valueguess = case avalue
       when Numeric then Float
+      when Time then Time
       when Date then Date
       when String,nil then nil
       else nil
     end
     result = valueguess
 
-    if valueguess.nil? # valueguess is most important
-      # if not succesfull then try guessing by type from node xml
+    if valueguess.nil? # valueguess is most important if not succesfull then try guessing by type from node xml
       typ = xmlnode.nil? ? 'N/A' : xmlnode.attributes['value-type']
       typeguess = case typ
         when nil then nil
         when 'float' then Float
         when 'string' then String
+        when 'time' then Time
         when 'date' then Date
         when 'percentage' then :percentage
         when 'N/A' then :unassigned
         when 'currency' then :currency
         else 
-          if xmlnode.children.size == 0
+          if xmlnode.elements.size == 0
             nil
           else 
-            raise "Unknown type at #{coordinates.to_s} from #{xmlnode.to_s} / children size=#{xmlnode.children.size.to_s} / type=#{xmlnode.attributes['value-type'].to_s}"
+            raise "Unknown type at #{coordinates.to_s} from #{xmlnode.to_s} / elements size=#{xmlnode.elements.size.to_s} / type=#{xmlnode.attributes['value-type'].to_s}"
           end
       end
 
@@ -209,6 +225,11 @@ class Cell < XMLTiedItem
     Tools.set_ns_attribute(xmlnode,'table','formula','of:'+formulastring.to_s)
   end
   def blank?; self.type==:empty or self.type==:unassigned end
+  
+  def border_top;    format.border_top end
+  def border_right;  format.border_right end
+  def border_bottom; format.border_bottom end
+  def border_left;   format.border_left end
 
 end
 
@@ -249,6 +270,7 @@ class CellFormat
   end
   def background_color=(value); set_cell_style_node_attribute('background-color',  value) end
   def set_cell_style_node_attribute(attribute_name,value)
+    @cell.detach if @cell.mode != :regular
     if cell_style_node.nil?
       self.create_cell_style_node
       raise 'Style node was not correctly initialized' if cell_style_node.nil?
@@ -300,10 +322,79 @@ class CellFormat
   def currency
     Tools.get_ns_attribute_value(cellnode,'office','currency',nil) 
   end
+  #returns object representing top border of the cell
+  def top;    @top    ||= Border.new(self,:top)  end
+  def bottom; @bottom ||= Border.new(self,:bottom) end
+  def left;   @left   ||= Border.new(self,:left) end
+  def right;  @right  ||= Border.new(self,:right) end
+  alias :border_top :top
+  alias :border_right :right
+  alias :border_bottom :bottom
+  alias :border_left :left
+  
+  def inspect
+    "#<Rspreadsheet::CellFormat bold:#{bold?.inspect}, borders:#{top.get_value_string.inspect} #{right.get_value_string.inspect} #{bottom.get_value_string.inspect} #{left.get_value_string.inspect}>"
+  end
+  
 end
 
+# represents one of the borders of a cell
+class Border
+  def initialize(cellformat,side)
+    @cellformat = cellformat
+    @side = side.to_s
+    raise "Wrong side of border object, can be top, bottom, left or right" unless ['left','right','top','bottom'].include? @side
+  end
+  def cellnode; @cell.xmlnode end
+  def attribute_name; "border-#{@side}" end
+  
+  def width=(value); set_border_string_part(1, value) end
+  def style=(value); set_border_string_part(2, value.to_s) end
+  def color=(value); set_border_string_part(3, value) end
+  def width; get_border_string_part(1).to_f end
+  def style; get_border_string_part(2) end
+  def color; get_border_string_part(3) end
+  def delete
+    @cellformat.set_cell_style_node_attribute(attribute_name, 'none')
+  end
+    
+    
+  ## internals  
+   
+  # set parth-th part of string which represents the border. String looks like "0.06pt solid #00ee00"
+  # part is 1 for width, 2 for style or 3 for color
+  def set_border_string_part(part,value)
+    current_value = @cellformat.get_cell_style_node_attribute(attribute_name)
+    
+    if current_value.nil? or (current_value=='none')
+      value_array = ['0.75pt', 'solid', '#000000']  # set default values
+    else
+      value_array = current_value.split(' ')  
+    end
+    raise 'Strange border attribute value. Does not have 3 parts' unless value_array.length == 3
+    value_array[part-1]=value
+    @cellformat.set_cell_style_node_attribute(attribute_name, value_array.join(' '))
+  end
+  
+  def get_border_string_part(part)
+    current_value = @cellformat.get_cell_style_node_attribute(attribute_name) || @cellformat.get_cell_style_node_attribute('border')
+    if current_value.nil? or (current_value=='none')
+      return nil
+    else
+      value_array = current_value.split(' ')  
+      raise 'Strange border attribute value. Does not have 3 parts' unless value_array.length == 3
+      return value_array[part-1]
+    end
+  end
+  
+  def get_value_string
+    @cellformat.get_cell_style_node_attribute(attribute_name)
+  end
+  
 end
 
+end # module
+