write_xlsx 1.00.0 → 1.01.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: bde6d7de8885eab3b8b2ccd4c1ec5b682b55b9893a730c3475d5c0e0b6aca459
-  data.tar.gz: c6f347da459b3a80bb699632d5aee762fb80de9ebde962463406618a2ed62c1f
+  metadata.gz: 7488f5d7a2fb2d8d2538dfad0e469015596350f36b8c92fb6ad92c30413fc76a
+  data.tar.gz: 42633fda58820d75b54c6248796c7dec91e2acfc3016ac7dfbea0331c8531353
 SHA512:
-  metadata.gz: 9c562aa8183d3d5bfa800aa961883620ae645107e5de36f7559efdbd2624384cc810d6b1c5098f36bd8508f72c7f6177803fd4f54713c068c59cc4d983da2091
-  data.tar.gz: 6af5a9bb53da31ad5e1eca9de975fe5ee68233be6712cecc939d3fc77496d38a23639f43be66bc8a520895e43de6dadb5f3278893711e23397151967912d07b5
+  metadata.gz: ea3fa967b302439de1ddced9c20011f14eeafd8025b424bf7edd33f34215428fd6f9155264336e36a771ee345f13a4ad764abef8bc4c39a88e2d8aa9d8c769b1
+  data.tar.gz: fd4f6e52efcb4e2163d0346e5b13ec21312c73ad1fb2b1d79ab4f81d51411e15eb9308ec0249e52b1082e97c696f94b3651e6ce1676eb011f7420623eda7530c

data/.gitignore

@@ -6,6 +6,7 @@ GTAGS
 .bundle
 .config
 .yardoc
+.byebug_history
 Gemfile.lock
 InstalledFiles
 _site

data/Changes

@@ -1,5 +1,20 @@
 Change history of write_xlsx rubygem.
 
+2021-02-08 v1.01.0
+
+   Added support for stacked and East Asian vertical chart fonts.
+
+   Added option to control positioning of charts or images when cells are
+   resized.
+
+   Added support for combining Pie/Doughnut charts.
+
+   Fixed sizing of cell comment boxes when they cross columns/rows that have
+   size changes that occur after the comment is written. Comments should
+   now behave like other worksheet objects such as images and charts.
+
+   Fix for structured reference in chart ranges.
+
 2021-01-23 v1.00.0
 
    Fixed issue where images that started in hidden rows/columns weren't placed

data/examples/a_simple.rb

@@ -7,7 +7,7 @@
 # write text and numbers to an Excel xlsx file.
 #
 # reverse(c), March 2001, John McNamara, jmcnamara@cpan.org
-# convert to ruby by Hideo NAKAMURA, cxn03651@msj.biglobe.ne.jp
+# convert to ruby by Hideo NAKAMURA, nakamura.hideo@gmail.com
 #
 
 require 'write_xlsx'

data/examples/add_vba_project.rb

@@ -10,7 +10,7 @@
 # used to extract the vbaProject.bin file.
 #
 # reverse('(c)'), November 2012, John McNamara, jmcnamara@cpan.org
-# convert to ruby by Hideo NAKAMURA, cxn03651@msj.biglobe.ne.jp
+# convert to ruby by Hideo NAKAMURA, nakamura.hideo@gmail.com
 #
 
 require 'write_xlsx'

data/examples/array_formula.rb

@@ -7,7 +7,7 @@
 # array formulas.
 #
 # reverse(c), August 2004, John McNamara, jmcnamara@cpan.org
-# convert to ruby by Hideo NAKAMURA, cxn03651@msj.biglobe.ne.jp
+# convert to ruby by Hideo NAKAMURA, nakamura.hideo@gmail.com
 #
 
 require 'write_xlsx'

data/examples/chart_area.rb

@@ -6,7 +6,7 @@
 # A demo of an Area chart in Excel::Writer::XLSX.
 #
 # reverse('ｩ'), March 2011, John McNamara, jmcnamara@cpan.org
-# convert to ruby by Hideo NAKAMURA, cxn03651@msj.biglobe.ne.jp
+# convert to ruby by Hideo NAKAMURA, nakamura.hideo@gmail.com
 #
 
 require 'write_xlsx'
@@ -53,6 +53,9 @@
 chart.set_style(11)
 
 # Insert the chart into the worksheet (with an offset).
-worksheet.insert_chart('D2', chart, 25, 10)
+worksheet.insert_chart(
+  'D2', chart,
+  :x_offset => 25, :y_offset => 10
+)
 
 workbook.close

data/examples/chart_bar.rb

@@ -6,7 +6,7 @@
 # A demo of an Bar chart in Excel::Writer::XLSX.
 #
 # reverse('c'), March 2011, John McNamara, jmcnamara@cpan.org
-# convert to ruby by Hideo NAKAMURA, cxn03651@msj.biglobe.ne.jp
+# convert to ruby by Hideo NAKAMURA, nakamura.hideo@gmail.com
 #
 
 require 'write_xlsx'
@@ -53,6 +53,9 @@
 chart.set_style(11)
 
 # Insert the chart into the worksheet (with an offset).
-worksheet.insert_chart('D2', chart, 25, 10)
+worksheet.insert_chart(
+  'D2', chart,
+  :x_offset => 25, :y_offset => 10
+)
 
 workbook.close

data/examples/chart_clustered.rb

@@ -5,7 +5,7 @@
 # A demo of a clustered category chart in Excel::Writer::XLSX.
 #
 # reverse ('(c)'), March 2015, John McNamara, jmcnamara@cpan.org
-# convert to ruby by Hideo NAKAMURA, cxn03651@msj.biglobe.ne.jp
+# convert to ruby by Hideo NAKAMURA, nakamura.hideo@gmail.com
 #
 
 require 'write_xlsx'

data/examples/chart_column.rb

@@ -6,7 +6,7 @@
 # A demo of an Area chart in Excel::Writer::XLSX.
 #
 # reverse('ｩ'), March 2011, John McNamara, jmcnamara@cpan.org
-# convert to ruby by Hideo NAKAMURA, cxn03651@msj.biglobe.ne.jp
+# convert to ruby by Hideo NAKAMURA, nakamura.hideo@gmail.com
 #
 
 require 'write_xlsx'
@@ -53,6 +53,9 @@
 chart.set_style(11)
 
 # Insert the chart into the worksheet (with an offset).
-worksheet.insert_chart('D2', chart, 25, 10)
+worksheet.insert_chart(
+  'D2', chart,
+  :x_offset => 25, :y_offset => 10
+)
 
 workbook.close

data/examples/chart_combined.rb

@@ -6,7 +6,7 @@
 # An example of a Combined chart in WriteXLSX.
 #
 # reverse ('(c)'), March 2015, John McNamara, jmcnamara@cpan.org
-# convert to ruby by Hideo NAKAMURA, cxn03651@msj.biglobe.ne.jp
+# convert to ruby by Hideo NAKAMURA, nakamura.hideo@gmail.com
 #
 
 require 'write_xlsx'

data/examples/chart_data_table.rb

@@ -7,7 +7,7 @@
 # WriteXLSX.
 #
 # reverse ('(c)'), December 2012, John McNamara, jmcnamara@cpan.org
-# convert to ruby by Hideo NAKAMURA, cxn03651@msj.biglobe.ne.jp
+# convert to ruby by Hideo NAKAMURA, nakamura.hideo@gmail.com
 #
 
 require 'write_xlsx'
@@ -54,7 +54,10 @@
 chart1.set_table
 
 # Insert the chart into the worksheet (with an offset).
-worksheet.insert_chart('D2', chart1, 25, 10)
+worksheet.insert_chart(
+  'D2', chart1,
+  :x_offset => 25, :y_offset => 10
+)
 
 #
 # Create a second charat.
@@ -88,6 +91,9 @@
 chart2.set_legend(:position => 'none')
 
 # Insert the chart into the worksheet (with an offset).
-worksheet.insert_chart('D18', chart2, 25, 11)
+worksheet.insert_chart(
+  'D18', chart2,
+  :x_offset => 25, :y_offset => 11
+)
 
 workbook.close

data/examples/chart_data_tools.rb

@@ -10,7 +10,7 @@
 # High-Low Lines and Up-Down Bars.
 #
 # reverse ('(c)'), December 2012, John McNamara, jmcnamara@cpan.org
-# convert to ruby by Hideo NAKAMURA, cxn03651@msj.biglobe.ne.jp
+# convert to ruby by Hideo NAKAMURA, nakamura.hideo@gmail.com
 #
 
 require 'write_xlsx'
@@ -62,7 +62,10 @@
 chart1.set_title(:name => 'Chart with Trendlines')
 
 # Insert the chart into the worksheet (with an offset).
-worksheet.insert_chart('D2', chart1, 25, 10)
+worksheet.insert_chart(
+  'D2', chart1,
+  :x_offset => 25, :y_offset => 10
+)
 
 
 #######################################################################
@@ -91,7 +94,10 @@
 chart2.set_title(:name => 'Chart with Data Labels and Markers')
 
 # Insert the chart into the worksheet (with an offset).
-worksheet.insert_chart('D18', chart2, 25, 10)
+worksheet.insert_chart(
+  'D18', chart2,
+  :x_offset => 25, :y_offset => 10
+)
 
 
 #######################################################################
@@ -119,7 +125,10 @@
 chart3.set_title(:name => 'Chart with Error Bars')
 
 # Insert the chart into the worksheet (with an offset).
-worksheet.insert_chart('D34', chart3, 25, 10)
+worksheet.insert_chart(
+  'D34', chart3,
+  :x_offset => 25, :y_offset => 10
+)
 
 
 #######################################################################
@@ -149,7 +158,10 @@
 chart4.set_title(:name => 'Chart with Up-Down Bars')
 
 # Insert the chart into the worksheet (with an offset).
-worksheet.insert_chart('D50', chart4, 25, 10)
+worksheet.insert_chart(
+  'D50', chart4,
+  :x_offset => 25, :y_offset => 10
+)
 
 
 #######################################################################
@@ -179,7 +191,10 @@
 chart5.set_title(:name => 'Chart with High-Low Lines')
 
 # Insert the chart into the worksheet (with an offset).
-worksheet.insert_chart('D66', chart5, 25, 10)
+worksheet.insert_chart(
+  'D66', chart5,
+  :x_offset => 25, :y_offset => 10
+)
 
 
 #######################################################################
@@ -209,6 +224,9 @@
 chart6.set_title(:name => 'Chart with Drop Lines')
 
 # Insert the chart into the worksheet (with an offset).
-worksheet.insert_chart('D82', chart6, 25, 10)
+worksheet.insert_chart(
+  'D82', chart6,
+  :x_offset => 25, :y_offset => 10
+)
 
 workbook.close

data/examples/chart_doughnut.rb

@@ -12,7 +12,7 @@
 # formatting to each point in the series.
 #
 # reverse ('(c)'), March 2011, John McNamara, jmcnamara@cpan.org
-# convert to ruby by Hideo NAKAMURA, cxn03651@msj.biglobe.ne.jp
+# convert to ruby by Hideo NAKAMURA, nakamura.hideo@gmail.com
 #
 
 require 'write_xlsx'
@@ -50,7 +50,10 @@
 chart1.set_style(10)
 
 # Insert the chart into the worksheet (with an offset).
-worksheet.insert_chart('C2', chart1, 25, 10)
+worksheet.insert_chart(
+  'C2', chart1,
+  :x_offset => 25, :y_offset => 10
+)
 
 
 #
@@ -77,7 +80,10 @@
 
 
 # Insert the chart into the worksheet (with an offset).
-worksheet.insert_chart('C18', chart2, 25, 10)
+worksheet.insert_chart(
+  'C18', chart2,
+  :x_offset => 25, :y_offset => 10
+)
 
 
 #
@@ -101,7 +107,10 @@
 chart3.set_rotation(90)
 
 # Insert the chart into the worksheet (with an offset).
-worksheet.insert_chart('C34', chart3, 25, 10)
+worksheet.insert_chart(
+  'C34', chart3,
+  :x_offset => 25, :y_offset => 10
+)
 
 
 #
@@ -125,6 +134,9 @@
 chart4.set_hole_size(33)
 
 # Insert the chart into the worksheet (with an offset).
-worksheet.insert_chart('C50', chart4, 25, 10)
+worksheet.insert_chart(
+  'C50', chart4,
+  :x_offset => 25, :y_offset => 10
+)
 
 workbook.close

data/examples/chart_gauge.rb

@@ -0,0 +1,73 @@
+# #!/usr/bin/env ruby
+
+# #######################################################################
+# #
+# # A demo of an Gauge Chart in WriteXLSX gem.
+# #
+# # A Gauge Chart isn't a native chart type in Excel. It is constructed by
+# # combining a doughnut chart and a pie chart and by using some non-filled
+# # elements. This example follows the following online example of how to create
+# # a Gauge Chart in Excel: https://www.excel-easy.com/examples/gauge-chart.html
+# #
+# # reverse ('(c)'), May 2019, John McNamara, jmcnamara@cpan.org
+# # convert to ruby by Hideo NAKAMURA, nakamura.hideo@gmail.com
+# #
+
+require 'write_xlsx'
+
+workbook  = WriteXLSX.new('chart_gauge.xlsx')
+worksheet = workbook.add_worksheet
+
+chart_doughnut = workbook.add_chart(:type => 'doughnut', :embedded => 1)
+chart_pie      = workbook.add_chart(:type => 'pie', :embedded => 1)
+
+# Add some data for the Doughnut and Pie charts. This is set up so the
+# gauge goes from 0-100. It is initially set at 75%.
+worksheet.write_col('H2', ['Donut', 25, 50, 25, 100])
+worksheet.write_col('I2', ['Pie', 75, 1, '=200-I4-I3'])
+
+# Configure the doughnut chart as the background for the gauge.
+chart_doughnut.add_series(
+    :name   => '=Sheet1!$H$2',
+    :values => '=Sheet1!$H$3:$H$6',
+    :points => [
+        { :fill => { :color => 'green' } },
+        { :fill => { :color => 'yellow' } },
+        { :fill => { :color => 'red' } },
+        { :fill => { :none  => 1 } }
+    ]
+)
+
+# Rotate chart so the gauge parts are above the horizontal.
+chart_doughnut.set_rotation(270)
+
+# Turn off the chart legend.
+chart_doughnut.set_legend(:none => 1)
+
+# Turn off the chart fill and border.
+chart_doughnut.set_chartarea(
+    :border => { :none  => 1 },
+    :fill   => { :none  => 1 }
+)
+
+# Configure the pie chart as the needle for the gauge.
+chart_pie.add_series(
+    :name   => '=Sheet1!$I$2',
+    :values => '=Sheet1!$I$3:$I$6',
+    :points => [
+        { :fill => { :none  => 1 } },
+        { :fill => { :color => 'black' } },
+        { :fill => { :none  => 1 } }
+    ]
+)
+
+# Rotate the pie chart/needle to align with the doughnut/gauge.
+chart_pie.set_rotation(270)
+
+# Combine the pie and doughnut charts.
+chart_doughnut.combine(chart_pie)
+
+# Insert the chart into the worksheet.
+worksheet.insert_chart('A1', chart_doughnut)
+
+workbook.close

data/examples/chart_line.rb

@@ -6,7 +6,7 @@
 # A demo of a Line chart in Excel::Writer::XLSX.
 #
 # reverse('ｩ'), March 2011, John McNamara, jmcnamara@cpan.org
-# convert to ruby by Hideo NAKAMURA, cxn03651@msj.biglobe.ne.jp
+# convert to ruby by Hideo NAKAMURA, nakamura.hideo@gmail.com
 #
 
 require 'write_xlsx'
@@ -53,6 +53,9 @@
 chart.set_style(10)
 
 # Insert the chart into the worksheet (with an offset).
-worksheet.insert_chart('D2', chart, 25, 10)
+worksheet.insert_chart(
+  'D2', chart,
+  :x_offset => 25, :y_offset => 10
+)
 
 workbook.close

data/examples/chart_pareto.rb

@@ -6,7 +6,7 @@
 # A demo of a Pareto chart in Excel::Writer::XLSX.
 #
 # reverse ('(c)'), March 2015, John McNamara, jmcnamara@cpan.org
-# convert to ruby by Hideo NAKAMURA, cxn03651@msj.biglobe.ne.jp
+# convert to ruby by Hideo NAKAMURA, nakamura.hideo@gmail.com
 #
 
 require 'write_xlsx'

data/examples/chart_pie.rb

@@ -12,7 +12,7 @@
 # assign formatting to each point in the series.
 #
 # reverse(c), March 2011, John McNamara, jmcnamara@cpan.org
-# convert to ruby by Hideo NAKAMURA, cxn03651@msj.biglobe.ne.jp
+# convert to ruby by Hideo NAKAMURA, nakamura.hideo@gmail.com
 #
 
 require 'write_xlsx'
@@ -50,7 +50,10 @@
 chart1.set_style(10)
 
 # Insert the chart into the worksheet (with an offset).
-worksheet.insert_chart('C2', chart1, 25, 10)
+worksheet.insert_chart(
+  'C2', chart1,
+  :x_offset => 25, :y_offset => 10
+)
 
 #
 # Create a Pie chart with user defined segment colors.
@@ -74,6 +77,9 @@
 # Add a title.
 chart2.set_title(:name => 'Pie Chart with user defined colors')
 
-worksheet.insert_chart('C18', chart2, 25, 10)
+worksheet.insert_chart(
+  'C18', chart2,
+  :x_offset => 25, :y_offset => 10
+)
 
 workbook.close