ooxml_excel 0.0.2 → 0.0.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: e5989596afa2991677b2986fc66c4aa8be2c24af
-  data.tar.gz: ddffed3aadfe48b0f9a7d4c5299eed9a441dbe54
+  metadata.gz: db608f8f90704e4f7f3497890e3749cff05de557
+  data.tar.gz: b787c6251283d5faa92ec2760212b9d22e8c1049
 SHA512:
-  metadata.gz: c6add5668d0617f49da6bf79f3c0dd3083ae797cfe9b2a75b844fea1091c6a396a6479ba443973b28bd74a0a7de1a6287692529b831b2816b30d320f830030b8
-  data.tar.gz: 9ee8046efadb7a0fdf9b89a12f29e7e110b3819bb49f60f3ed9f06103246f4da5ae7748b5aeb0645dc99644ca3f9caa54da4f522fb39807ba83b5fc991e630c1
+  metadata.gz: e8b5f88a02e9b792321e4012d711ac85431c826b332b7546223ed9cecb79dd2544490c7fb8d1bdeda90935e10e01806f0a47b34bdd64a025ee4f21b8a72978b8
+  data.tar.gz: 7b4f356262e48233ecfd2f13508cb055457f8b2e1f012377e871b14e59e9be0fb3f2a15058e84e75b84b21fa37606738c06b5dd367b26633974a25b391e85497

data/README.md

@@ -45,27 +45,29 @@ sheet.rows[0].cells # longer way to do it
 sheet[0][0] # Access the first cell of the row
 sheet.rows[0].cells[0] # longer way to do it
 
-sheet[0][0].value # Access cell values
+sheet[0][0].value # Access cell value
 sheet.rows[0].cells[0].value # longer way to do it
 
+ooxml_excel['Test Sheet 1'][0][0].value
 ```
 
-### Iterating to each row:
+### Iterating through each row:
 ```
 # as an array of strings
 ooxml_excel.sheet('Test Sheet 1').each_row do |row|
   # Do something here...
+  p row # ['text', 'text']
 end
 
 # as an array of objects
 ooxml_excel.sheet('Test Sheet 1').each_row_as_object do |row|
   # Do something here...
-  p row
+  p row.cells # [OOXML::Excel::Row::Cell, ...]
 end
 
 ```
 
-### Fetching Columns:
+### Fetching Columns
 ```
 # Fetch all columns
 ooxml_excel.sheet('Test Sheet 1').columns
@@ -75,8 +77,7 @@ ooxml_excel.sheet('Test Sheet 1').column(1).hidden? # column index
 ooxml_excel.sheet('Test Sheet 1').column('A').hidden? # column letter
 ```
 
-### Fetching Styles:
-
+### Fetching Styles
 ```
 # Font
 font_object = ooxml_excel.sheet('Test Sheet 1').font('A1')
@@ -90,8 +91,22 @@ fill_object = ooxml_excel.sheet('Test Sheet 1').fill('A1')
 fill_object.bg_color # FFE10000
 fill_object.fg_color # FFE10000
 ```
+### Fetching Data from named/cell range
+```
+# named range
+ooxml_excel.named_range('my_named_range') # ['value' 'from', 'range']
+
+# cell range
+ooxml['Lists'!$A$1:$A$6] # ['1','2','3','4','5','6']
 
-### Data Validation
+# or
+ooxml['Lists'!A1:A6] # ['1','2','3','4','5','6']
+
+# or loading a single value
+ooxml['Lists'!A1] # ['1']
+
+```
+### Fetching Data Validation
 ```
 # All Validations
 data_validations = ooxml_excel.sheet('Test Sheet 1').data_validations

data/lib/ooxml_excel/excel.rb

@@ -4,10 +4,10 @@ module OOXML
     attr_reader :comments
     def initialize(spreadsheet, load_only_sheet:nil)
       @spreadsheet = spreadsheet
+      @workbook = nil
       @sheets = {}
       @comments = {}
       # @themes = []
-      @workbook = nil
       @load_only_sheet = nil
       @styles = nil
       load_xml_contents
@@ -30,8 +30,32 @@ module OOXML
       sheet
     end
 
+    def [](text)
+      # immediately treat as cell range if an exclamation point is detected
+      # otherwise, normally load a sheet
+      text.include?('!') ? load_list_values(text) : sheet(text)
+    end
+
+    def named_range(name)
+      # "Hidden11390550_39"=>"Hidden!$B$734:$B$735"
+      # ooxml.named_range('Hidden11390550_107')
+      # a typical named range would be be
+      # yes_no => 'Lists'!$A$1:$A$6
+      defined_name = @workbook.defined_names[name]
+      load_list_values(defined_name) if defined_name.present?
+    end
+
     private
 
+    def load_list_values(range_text)
+      # get the sheet name => 'Lists'
+      sheet_name = range_text.gsub(/[\$\']/, '').scan(/^[^!]*/).first
+      # fetch the cell range => '$A$1:$A$6'
+      cell_range = range_text.gsub(/\$/, '').scan(/(?<=!).+/).first
+      # get the sheet object and fetch the cells in range
+      sheet(sheet_name).list_values_from_formula(cell_range)
+    end
+
     # Currently supports DataValidation (comment), columns (check if hidden)
     # TODO: list values, Font styles (if bold, colored in red etc..), background color
     def load_xml_contents

data/lib/ooxml_excel/helper/list.rb

@@ -4,6 +4,7 @@ module OOXML
 
       # excel.rb
       # fetch dropdown values based on given data validation formula
+      # this will be depracated: use #named_range instead
       def list_values(formula)
         # "Lists!$J$2:$J$4"
         # transform into useful info

data/lib/ooxml_excel/version.rb

@@ -1,5 +1,5 @@
 module OOXML
   class Excel
-    VERSION = "0.0.2"
+    VERSION = "0.0.3"
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: ooxml_excel
 version: !ruby/object:Gem::Version
-  version: 0.0.2
+  version: 0.0.3
 platform: ruby
 authors:
 - James Mones