fast_excel 0.4.1 → 0.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 81f6dc41f599591425a032e95046733c9a27b7b44e5f6d15f71c9040e1452eaf
-  data.tar.gz: 05ce040ed72e6c056311177c5753d6f363d8750515502054648cac440d3cde09
+  metadata.gz: 792a2afe9492aeeaba9fbb65da941d2b604a2fd14bf934b17662fdf05281ac32
+  data.tar.gz: 11795006b99d4fc9403fd3f85ab6babff417b1ed49341a2081073852063d2a71
 SHA512:
-  metadata.gz: f614c8458db906397a2c27825c302e4a0d7a3f2958ed7053a33c9bd2dcbfd063fd27e5a6a8b1a7b3d230afc23919f359d27e61b785ded07b6cf95de55081d711
-  data.tar.gz: cbc0d5436ddde9052359e069a2d4e706810b9bd9ed28c544eca6e072566d32af9fba8b762cb47c011400d676dc71d7b641902058758f97cab98f44a9baef5ff9
+  metadata.gz: 7215d937426efb2580ba947c727a60a519fb411a5504eb58162a1646057bd191812eae00394ac9c915a9f7f53a6acf6cfff66e4d773a8ac579bb3494164c3292
+  data.tar.gz: 9f381f209a7d4f7c22a0994ed241b2be0a67d994c400f7867529fa1fa95fbc6326189a9dc53588f0bfbc376933ffab6fee4eaee37f7ac57d6a4f68a66295c8cc

data/.github/workflows/test.yml

@@ -8,7 +8,7 @@ jobs:
       fail-fast: false
       matrix:
         os: [ubuntu-latest, macos-latest, windows-latest]
-        ruby: [2.7, '3.0', 3.1, 3.2]
+        ruby: [2.7, '3.0', 3.1, 3.2, 3.3]
 
     runs-on: ${{ matrix.os }}
 
@@ -26,9 +26,3 @@ jobs:
       - run: rake test
       - run: rake examples
       - run: gem build fast_excel.gemspec
-
-
-gobills-critical
-gp-di-critical
-
-gp-di-alert

data/CHANGELOG.md

@@ -1,3 +1,12 @@
+#### Version 0.5.0 - 02 jan 2024
+
+* Support ruby 3.3
+* Sync latest libxlsxwriter
+* Add support for writing cell comments
+* Add more examples
+* Fix compilation of minizip on NixOS (Thanks to @Mange)
+* On close set empty columns to default width (Thanks to @steffansluis)
+
 #### Version 0.4.1 - 13 jan 2023
 
 * Support ruby 3.2

data/Gemfile

@@ -4,7 +4,7 @@ gemspec
 
 gem 'rake'
 
-gem 'roo', '2.8.3', git: 'https://github.com/roo-rb/roo.git', tag: 'v2.8.3'
+gem 'roo'
 
 gem 'minitest'
 gem 'minitest-reporters'

data/examples/example.rb

@@ -22,6 +22,8 @@ worksheet.set_column(2, 2, 20, date_format)
 
 worksheet.write_row(0, ["message", "price", "date", "complete"], bold)
 
+worksheet.write_comment(2, 2, "Comment to field")
+
 for i in 1..1000
   worksheet.write_row(i, ["Hello", (rand * 10_000_000).round(2), Time.now, i % 2 == 0])
 

data/examples/example_date_time.rb

@@ -0,0 +1,38 @@
+require_relative '../lib/fast_excel'
+
+require 'date'
+require 'time'
+
+
+File.unlink("example_date_time.xlsx") if File.exist?("example_date_time.xlsx")
+
+workbook = FastExcel.open("example_date_time.xlsx", constant_memory: true)
+workbook.default_format.set(
+  font_size: 0, # user's default
+)
+worksheet = workbook.add_worksheet
+
+worksheet.set_columns_width(0, 4, 25)
+worksheet.set_column(1, 1, 25, workbook.number_format("[$-409]m/d/yy hh:mm;@"))
+
+intro = "Date and time in excel file stored as decimal number, it show number of days since January 1900, decimal part is for time of the day"
+worksheet.merge_range(0, 0, 0, 4, intro, nil)
+worksheet.write_value(1, 0, "")
+
+worksheet.append_row(['', 'Formatted as Date', 'No formatting, plain number'])
+
+worksheet.append_row(["Time.now", Time.now, Time.now, 'local timezone'])
+worksheet.append_row(["Time.now.utc", Time.now.utc, Time.now.utc, 'UTC timezone'])
+
+worksheet.append_row(["DateTime.now", DateTime.now, DateTime.now, 'local timezone'])
+dt = DateTime.now.new_offset("+02:00")
+worksheet.append_row(["DateTime new_offset", dt, dt, 'GMT+2 timezone'])
+
+today = Date.today
+worksheet.append_row(["Date.today", today, today])
+
+worksheet.append_row(["0 (just zero)", 0, 0, '00 January 1900'])
+
+
+workbook.close
+puts "Saved to file example_date_time.xlsx"

data/fast_excel.gemspec

@@ -1,13 +1,13 @@
 Gem::Specification.new do |s|
   s.name        = "fast_excel"
-  s.version     = "0.4.1"
+  s.version     = "0.5.0"
   s.author      = ["Pavel Evstigneev"]
   s.email       = ["pavel.evst@gmail.com"]
   s.homepage    = "https://github.com/paxa/fast_excel"
   s.summary     = %q{Ultra Fast Excel Writer}
   s.description = "Wrapper for libxlsxwriter using ffi"
   s.license     = 'MIT'
-  s.required_ruby_version = ['>= 2.0', '< 4.0']
+  s.required_ruby_version = ['>= 2.0']
 
   s.files       = `git ls-files`.split("\n")
   s.test_files  = []

data/lib/fast_excel/binding/format.rb

@@ -697,9 +697,14 @@ module Libxlsxwriter
     include FormatWrappers
     layout :file, :pointer,
            :xf_format_indices, :pointer, #HashTable.ptr,
+           :dxf_format_indices, :pointer,
            :num_xf_formats, :pointer,
+           :num_dxf_formats, :pointer,
+
            :xf_index, :int32_t,
            :dxf_index, :int32_t,
+           :xf_id, :int32_t,
+
            :num_format, [:char, 128],
            :font_name, [:char, 128],
            :font_scheme, [:char, 128],
@@ -708,6 +713,7 @@ module Libxlsxwriter
            :has_font, :uchar,
            :has_dxf_font, :uchar,
            :font_size, :double,
+
            :bold, :uchar,
            :italic, :uchar,
            :font_color, :int,
@@ -722,24 +728,32 @@ module Libxlsxwriter
            :font_extend, :uchar,
            :theme, :uchar,
            :hyperlink, :uchar,
+
            :hidden, :uchar,
            :locked, :uchar,
+
            :text_h_align, :uchar,
            :text_wrap, :uchar,
            :text_v_align, :uchar,
            :text_justlast, :uchar,
            :rotation, :short,
+
            :fg_color, :int,
            :bg_color, :int,
+           :dxf_fg_color, :int,
+           :dxf_bg_color, :int,
+
            :pattern, :uchar,
            :has_fill, :uchar,
            :has_dxf_fill, :uchar,
            :fill_index, :int,
            :fill_count, :int,
+
            :border_index, :int,
            :has_border, :uchar,
            :has_dxf_border, :uchar,
            :border_count, :int,
+
            :bottom, :uchar,
            :diag_border, :uchar,
            :diag_type, :uchar,
@@ -751,6 +765,7 @@ module Libxlsxwriter
            :left_color, :int,
            :right_color, :int,
            :top_color, :int,
+
            :indent, :uchar,
            :shrink, :uchar,
            :merge_range, :uchar,
@@ -758,6 +773,8 @@ module Libxlsxwriter
            :just_distrib, :uchar,
            :color_indexed, :uchar,
            :font_only, :uchar,
+
+           :quote_prefix, :uchar,
            :list_pointers, FormatListPointers.by_value
   end
 

data/lib/fast_excel/binding/workbook.rb

@@ -7,7 +7,9 @@ module Libxlsxwriter
   class WorkbookOptions < FFI::Struct
     layout :constant_memory, :uchar,
            :tmpdir, :string,
-           :use_zip64, :uchar
+           :use_zip64, :uchar,
+           :output_buffer, :pointer,
+           :output_buffer_size, :pointer
   end
 
   # = Fields:
@@ -174,6 +176,9 @@ module Libxlsxwriter
            :chartsheets, :pointer,
            :worksheet_names, WorksheetNames.ptr,
            :chartsheet_names, :pointer,
+           :image_md5s, :pointer,
+           :header_image_md5s, :pointer,
+           :background_md5s, :pointer,
            :charts, Charts.ptr,
            :ordered_charts, Charts.ptr,
            :formats, Formats.ptr,
@@ -181,26 +186,43 @@ module Libxlsxwriter
            :sst, Sst.ptr,
            :properties, DocProperties.ptr,
            :custom_properties, CustomProperties.ptr,
-           :filename, :pointer,
+           :filename, :string,
            :options, WorkbookOptions.by_value,
-           :num_sheets, :uint16,
-           :num_worksheets, :uint16,
-           :num_chartsheets, :uint16,
-           :first_sheet, :uint16,
-           :active_sheet, :uint16,
-           :num_xf_formats, :uint16,
+
+           :num_sheets,       :uint16,
+           :num_worksheets,   :uint16,
+           :num_chartsheets,  :uint16,
+           :first_sheet,      :uint16,
+           :active_sheet,     :uint16,
+           :num_xf_formats,   :uint16,
+           :num_dxf_formats,  :uint16,
            :num_format_count, :uint16,
-           :drawing_count, :uint16,
-           :font_count, :uint16,
-           :border_count, :uint16,
-           :fill_count, :uint16,
-           :optimize, :uchar,
-           :has_png, :uchar,
+           :drawing_count,    :uint16,
+           :comment_count,    :uint16,
+
+           :font_count,     :uint16,
+           :border_count,   :uint16,
+           :fill_count,     :uint16,
+           :optimize,       :uchar,
+           :max_url_length, :uint16,
+           :read_only,      :uchar,
+
+           :has_png,  :uchar,
            :has_jpeg, :uchar,
-           :has_bmp, :uchar,
+           :has_bmp,  :uchar,
+           :has_gif, :uchar,
+           :has_vml, :uchar,
+           :has_comments, :uchar,
+           :has_metadata, :uchar,
+
            :used_xf_formats, HashTable.ptr,
-           :vba_project, :pointer,
-           :vba_codename, :pointer
+           :used_dxf_formats, HashTable.ptr,
+
+           :vba_project, :string,
+           :vba_project_signature, :string,
+           :vba_codename, :string,
+
+           :default_url_format, :pointer
   end
 
   attach_function :workbook_default_format, :workbook_default_format, [Workbook], Format

data/lib/fast_excel/binding/worksheet.rb

@@ -209,7 +209,11 @@ module Libxlsxwriter
     def write_string(row, col, string, format)
       Libxlsxwriter.worksheet_write_string(self, row, col, string, format)
     end
-  
+
+    def write_comment(row, col, string)
+      Libxlsxwriter.worksheet_write_comment(self, row, col, string)
+    end
+
     # @param [Integer] row 
     # @param [Integer] col 
     # @param [String] formula 
@@ -684,29 +688,45 @@ module Libxlsxwriter
     include WorksheetWrappers
     layout :file, :pointer,
            :optimize_tmpfile, :pointer,
+           :optimize_buffer, :pointer,
+           :optimize_buffer_size, :size_t,
            :table, TableRows.ptr,
            :hyperlinks, TableRows.ptr,
+           :comments, TableRows.ptr,
            :array, :pointer,
            :merged_ranges, MergedRanges.ptr,
-           :selections, Selections.ptr,
+           #:selections, Selections.ptr,
            :data_validations, :pointer, # TODO add real definition for lxw_data_validations
+           :conditional_formats, :pointer,
+           :image_props, :pointer,
            :image_data, ImageData.ptr,
            :chart_data, ChartData.ptr,
+           :drawing_rel_ids, :pointer,
+           :vml_drawing_rel_ids, :pointer,
+           :comment_objs, :pointer,
+           :header_image_objs, :pointer,
+           :button_objs, :pointer,
+           :table_objs, :pointer,
+           :table_count, :uint16,
+
            :dim_rowmin, :uint32,
            :dim_rowmax, :uint32,
            :dim_colmin, :uint16,
            :dim_colmax, :uint16,
+
            :sst, Sst.ptr,
            :name, :string,
            :quoted_name, :string,
            :tmpdir, :pointer,
-           :index, :uint32,
-           :active, :uint8,
-           :selected, :uint8,
-           :hidden, :uint8,
+
+           :index, :uint16,
+           :active, :uchar,
+           :selected, :uchar,
+           :hidden, :uchar,
            :active_sheet, :pointer,
            :first_sheet, :pointer,
-           :is_chartsheet, :uint8,
+           :is_chartsheet, :uchar,
+
            :col_options, :pointer,
            :col_options_max, :uint16,
            :col_sizes, :pointer,
@@ -717,6 +737,7 @@ module Libxlsxwriter
            :row_size_changed, :uint8,
            :optimize, :uint8,
            :optimize_row, :pointer,
+
            :fit_height, :uint16,
            :fit_width, :uint16,
            :horizontal_dpi, :uint16,
@@ -726,6 +747,7 @@ module Libxlsxwriter
            :rel_count, :uint16,
            :vertical_dpi, :uint16,
            :zoom, :uint16,
+
            :filter_on,             :uint8,
            :fit_page,              :uint8,
            :hcenter,               :uint8,
@@ -747,8 +769,12 @@ module Libxlsxwriter
            :show_zeros,            :uint8,
            :vcenter,               :uint8,
            :zoom_scale_normal,     :uint8,
+           :black_white,           :uint8,
            :num_validations,       :uint8,
+           :has_dynamic_arrays,    :uint8,
+
            :vba_codename, :pointer,
+           :num_buttons, :uint16,
            :tab_color, :int,
            :margin_left, :double,
            :margin_right, :double,
@@ -756,30 +782,44 @@ module Libxlsxwriter
            :margin_bottom, :double,
            :margin_header, :double,
            :margin_footer, :double,
+
            :default_row_height, :double,
            :default_row_pixels, :uint,
            :default_col_pixels, :uint,
-           :default_row_zeroed, :uchar,
+           :default_row_zeroed, :uint8,
            :default_row_set, :uint8,
+           :outline_row_level, :uint8,
+           :outline_col_level, :uint8,
+
            :header_footer_changed, :uint8,
-           :header, [:char, 255],
-           :footer, [:char, 255],
+           :header, :pointer,
+           :footer, :pointer,
            :repeat_rows, RepeatRows.by_value,
            :repeat_cols, RepeatCols.by_value,
            :print_area, PrintArea.by_value,
            :autofilter, Autofilter.by_value,
+
            :merged_range_count, :uint16,
+           :max_url_length, :uint16,
+
            :hbreaks, :pointer,
            :vbreaks, :pointer,
            :hbreaks_count, :uint16,
            :vbreaks_count, :uint16,
+
+           :drawing_rel_id, :uint,
+           :vml_drawing_rel_id, :uint,
+
            :external_hyperlinks, :pointer,
            :external_drawing_links, :pointer,
            :drawing_links, :pointer,
+           :vml_drawing_links, :pointer,
+           :external_table_links, :pointer,
+
            :panes, Panes.by_value,
-           :protection, Protection.by_value,
-           :drawing, Drawing.ptr,
-           :list_pointers, WorksheetListPointers.by_value
+           :protection, Protection.by_value
+           # :drawing, Drawing.ptr,
+           # :list_pointers, WorksheetListPointers.by_value
   end
 
   # = Fields:
@@ -990,6 +1030,8 @@ module Libxlsxwriter
   # @scope class
   attach_function :worksheet_write_string, :worksheet_write_string, [Worksheet, :uint32, :ushort, :string, Format], :error
 
+  attach_function :worksheet_write_comment, :worksheet_write_comment, [Worksheet, :uint32, :ushort, :string], :error
+
   # @method worksheet_write_formula(worksheet, row, col, formula, format)
   # @param [Worksheet] worksheet 
   # @param [Integer] row 
@@ -1514,6 +1556,8 @@ module Libxlsxwriter
   # @scope class
   attach_function :worksheet_find_cell, :lxw_worksheet_find_cell, [Row, :ushort], Cell
 
+  attach_function :worksheet_add_table, :worksheet_add_table, [Worksheet, :uint, :ushort, :uint, :ushort, :pointer], :error
+
   # = Fields:
   # :rbe_left ::
   #   (FFI::Pointer(*WorksheetName)) 

data/lib/fast_excel/binding.rb

@@ -327,13 +327,13 @@ module Libxlsxwriter
     :error_zip_internal_error, 8,
     :error_zip_file_add, 9,
     :error_zip_close, 10,
-    :error_null_parameter_ignored, 11,
-    :error_parameter_validation, 12,
-    :error_sheetname_length_exceeded, 13,
-    :error_invalid_sheetname_character, 14,
-    :error_sheetname_start_end_apostrophe, 15,
-    :error_sheetname_already_used, 16,
-    :error_sheetname_reserved, 17,
+    :error_feature_not_supported, 11,
+    :error_null_parameter_ignored, 12,
+    :error_parameter_validation, 13,
+    :error_sheetname_length_exceeded, 14,
+    :error_invalid_sheetname_character, 15,
+    :error_sheetname_start_end_apostrophe, 16,
+    :error_sheetname_already_used, 17,
     :error_32_string_length_exceeded, 18,
     :error_128_string_length_exceeded, 19,
     :error_255_string_length_exceeded, 20,

data/lib/fast_excel.rb

@@ -36,13 +36,10 @@ module FastExcel
 
     filename = filename.to_s if defined?(Pathname) && filename.is_a?(Pathname)
 
-    workbook = if constant_memory
-      opt = Libxlsxwriter::WorkbookOptions.new
-      opt[:constant_memory] = 1
-      Libxlsxwriter.workbook_new_opt(filename, opt)
-    else
-      Libxlsxwriter.workbook_new(filename)
-    end
+    opt = Libxlsxwriter::WorkbookOptions.new
+    opt[:constant_memory] = constant_memory ? 1 : 0
+    workbook = Libxlsxwriter.workbook_new_opt(filename, opt)
+
     result = Libxlsxwriter::Workbook.new(workbook)
 
     if default_format
@@ -105,23 +102,33 @@ module FastExcel
     time.to_f / XLSX_DATE_DAY + XLSX_DATE_EPOCH_DIFF + offset / XLSX_DATE_DAY
   end
 
-  def self.print_ffi_obj(value)
-    puts "#{value.class}"
+  def self.print_ffi_obj(value, do_print: true, offset: "", deep: false)
+    result = "#{value.class}"
+
     value.members.each do |key|
-      field_val = if value[key].is_a?(FFI::Pointer) && value[key].null? || value[key].nil?
+      fval = value[key]
+      field_val = if fval.is_a?(FFI::Pointer) && fval.null? || fval.nil?
         "nil"
-      elsif value[key].is_a?(FFI::StructLayout::CharArray)
-        value[key].to_str.inspect
-      elsif value[key].is_a?(String)
-        value[key].inspect
-      elsif value[key].is_a?(Symbol)
-        value[key].inspect
+      elsif fval.is_a?(FFI::StructLayout::CharArray)
+        fval.to_str.inspect
+      elsif fval.is_a?(String)
+        fval.inspect
+      elsif fval.is_a?(Symbol)
+        fval.inspect
+      elsif fval.is_a?(FFI::Struct) && deep
+        print_ffi_obj(fval, do_print: false, offset: offset + "    ", deep: deep)
       else
-        value[key]
+        fval
       end
-      puts "* #{key}: #{field_val}"
+
+      result += "\n#{offset}* #{key}: #{field_val}"
+    end
+
+    if do_print
+      puts result
+    else
+      return result
     end
-    nil
   end
 
 
@@ -541,7 +548,7 @@ module FastExcel
 
     def close
       if auto_width?
-        @column_widths.each do |num, width|
+        @column_widths.transform_values!{ |width| width || DEF_COL_WIDTH }.each do |num, width|
           set_column_width(num, width + 0.2)
         end
       end

data/libxlsxwriter/.github/FUNDING.yml

@@ -0,0 +1 @@
+custom: ["paypal.me/xlsxwriter"]

data/libxlsxwriter/.github/ISSUE_TEMPLATE.md

@@ -0,0 +1,85 @@
+# libxlsxwriter: Reporting Bugs
+
+Here are some tips on reporting bugs in `libxlsxwriter`.
+
+### Upgrade to the latest version of the library
+
+Upgrade to the latest version of the library since the bug you are reporting
+may already be fixed.
+
+Check the [Changes][changes] section of the documentation to see what has
+changed in the latest versions.
+
+[changes]: http://libxlsxwriter.github.io/changes.html
+
+You can check which version of `libxlsxwriter` that you are using by checking
+the `xlsxwriter.h` header file or by adding the following to your program:
+
+```C
+#include <stdio.h>
+#include "xlsxwriter.h"
+
+int main() {
+
+    printf("Libxlsxwriter version = %s\n", lxw_version());
+
+    return 0;
+}
+```
+
+### Read the documentation
+
+Read or search the `libxlsxwriter` [documentation][docs] to see if the issue
+you are encountering is already explained.
+
+[docs]: http://libxlsxwriter.github.io/index.html
+
+### Look at the example programs
+
+There are many [examples programs][examples] in the distribution. Try to
+identify an example program that corresponds to your query and adapt it to use
+as a bug report.
+
+[examples]: http://libxlsxwriter.github.io/examples.html
+
+
+### Tips for submitting a bug report
+
+1.  Describe the problem as clearly and as concisely as possible.
+2.  Include a sample program. This is probably the most important step.
+    It is generally easier to describe a problem in code than in written
+    prose.
+3.  The sample program should be as small as possible to demonstrate the
+    problem. Don't copy and paste large non-relevant sections of your
+    program.
+
+A sample bug report is shown below. This format helps analyze and respond to
+the bug report more quickly.
+
+
+> Subject: Issue with SOMETHING
+>
+> Greetings,
+>
+> I am using libxlsxwriter to do SOMETHING but it appears to do SOMETHING ELSE.
+>
+> I am using CC version X.Y.Z, OS = uname and libxlsxwriter x.y.z.
+>
+> Here is some code that demonstrates the problem:
+>
+>
+>```C
+>#include "xlsxwriter.h"
+>
+>int main() {
+>
+>    lxw_workbook  *workbook  = workbook_new("bug_report.xlsx");
+>    lxw_worksheet *worksheet = workbook_add_worksheet(workbook, NULL);
+>
+>    worksheet_write_string(worksheet, 0, 0, "Hello", NULL);
+>    worksheet_write_number(worksheet, 1, 0, 123, NULL);
+>
+>    return workbook_close(workbook);
+>}
+>```
+>