Rustpy-xlsxwriter

Added

Performance improvement release.

- Added optimizations across the library. For larger files this version is 10%
faster than previous versions.

These optimizations were provided by Adrián Delgado, see [GitHub Issue 23].

- Added crate feature `zlib` which adds a dependency on zlib and a C compiler
but is around 1.6x faster for larger files. With this feature enabled it is
even faster than the native C version libxlsxwriter by around 1.4x for large
files.

See also the [Performance] section of the user guide.

[GitHub Issue 23]: https://github.com/jmcnamara/rust_xlsxwriter/issues/23
[Performance]: https://rustxlsxwriter.github.io/performance.html

Added

- Added support for formatting and setting chart points via the [`ChartPoint`]
struct. This is mainly useful as the way of specifying segment colors in Pie
charts.

See the updated [Pie Chart] example in the user guide.

- Added support for formatting and setting chart markers via the [`ChartMarker`]
struct.

- Added [`Chart::set_rotation()`] and [`Chart::set_hole_size()`] methods for Pie and Doughnut charts.

- Added support to differentiate between `Color::Default` and
`Color::Automatic` colors for Excel elements. These are usually equivalent
but there are some cases where the "Automatic" color, which can be set at a
system level, is different from the Default color.

[Pie Chart]: https://rustxlsxwriter.github.io/examples/pie_chart.html
[`ChartPoint`]: https://docs.rs/rust_xlsxwriter/latest/rust_xlsxwriter/chart/struct.ChartPoint.html
[`ChartMarker`]: https://docs.rs/rust_xlsxwriter/latest/rust_xlsxwriter/chart/struct.ChartMarker.html
[`Chart::set_rotation()`]: https://docs.rs/rust_xlsxwriter/latest/rust_xlsxwriter/chart/struct.Chart.html#method.set_rotation
[`Chart::set_hole_size()`]: https://docs.rs/rust_xlsxwriter/latest/rust_xlsxwriter/chart/struct.Chart.html#method.set_hole_size

Added

- Added formatting for the chart title and axes via the the [`ChartFormat`]
struct.

Added

- Added formatting for the chart area, plot area, and legend via the the
[`ChartFormat`] struct.

Added

- Added chart formatting for Lines, Borders, Solid fills and Pattern fills via
the [`ChartFormat`] struct. This is currently only available for chart series
but it will be extended in the next release for most other chart elements.

See also the [Chart Fill Pattern] example in the user guide.

- Added `IntoColor` trait to allow syntactic shortcuts for [`Color`]
parameters in methods. So now you can set a RGB color like this
`object.set_color("FF7F50")` instead of the more verbose
`object.set_color(Color::RGB(0xFF7F50))`. This addition doesn't require
any API changes from the end user.

- Added [`Worksheet::insert_image_fit_to_cell()`] method to add an image to a
worksheet and scale it so that it fits in a cell. This method can be useful
when creating a product spreadsheet with a column of images for each product.

See also the [insert_image_to_fit] example in the user guide.

- Added [`Chart::series.set_gap()`] and [`Chart::series.set_overlap()`] method to control layout
of histogram style charts.

[`ChartFormat`]: https://docs.rs/rust_xlsxwriter/latest/rust_xlsxwriter/chart/struct.ChartFormat.html
[Chart Fill Pattern]: https://rustxlsxwriter.github.io/examples/chart_pattern.html
[insert_image_to_fit]: https://rustxlsxwriter.github.io/examples/insert_image_to_fit.html
[`Chart::series.set_gap()`]: https://docs.rs/rust_xlsxwriter/latest/rust_xlsxwriter/chart/struct.ChartSeries.html#method.set_gap
[`Chart::series.set_overlap()`]: https://docs.rs/rust_xlsxwriter/latest/rust_xlsxwriter/chart/struct.ChartSeries.html#method.set_overlap
[`Worksheet::insert_image_fit_to_cell()`]: https://docs.rs/rust_xlsxwriter/latest/rust_xlsxwriter/worksheet/struct.Worksheet.html#method.insert_image_fit_to_cell

Added

- Added support for resizing and object positioning to the [`Chart`] struct.

- Added handling for `chrono` date/time types to the generic
[`Worksheet::write()`] method.