fast_excel 0.4.1 → 0.5.0

data/libxlsxwriter/include/xlsxwriter/common.h

@@ -1,7 +1,7 @@
 /*
  * libxlsxwriter
  *
- * Copyright 2014-2019, John McNamara, jmcnamara@cpan.org. See LICENSE.txt.
+ * Copyright 2014-2022, John McNamara, jmcnamara@cpan.org. See LICENSE.txt.
  */
 
 /**
@@ -9,7 +9,7 @@
  *
  * @brief Common functions and defines for the libxlsxwriter library.
  *
- * <!-- Copyright 2014-2019, John McNamara, jmcnamara@cpan.org -->
+ * <!-- Copyright 2014-2022, John McNamara, jmcnamara@cpan.org -->
  *
  */
 #ifndef __LXW_COMMON_H__
@@ -25,6 +25,14 @@
 #define STATIC
 #endif
 
+#if __GNUC__ >= 5
+#define DEPRECATED(func, msg) func __attribute__ ((deprecated(msg)))
+#elif defined(_MSC_VER)
+#define DEPRECATED(func, msg) __declspec(deprecated, msg) func
+#else
+#define DEPRECATED(func, msg) func
+#endif
+
 /** Integer data type to represent a row value. Equivalent to `uint32_t`.
  *
  * The maximum row in Excel is 1,048,576.
@@ -42,7 +50,10 @@ enum lxw_boolean {
     /** False value. */
     LXW_FALSE,
     /** True value. */
-    LXW_TRUE
+    LXW_TRUE,
+    /** False value. Used to turn off a property that is default on, in order
+     *  to distinguish it from an uninitialized value. */
+    LXW_EXPLICIT_FALSE
 };
 
 /**
@@ -86,6 +97,9 @@ typedef enum lxw_error {
     /** Unknown zip error when closing xlsx file. */
     LXW_ERROR_ZIP_CLOSE,
 
+    /** Feature is not currently supported in this configuration. */
+    LXW_ERROR_FEATURE_NOT_SUPPORTED,
+
     /** NULL function parameter ignored. */
     LXW_ERROR_NULL_PARAMETER_IGNORED,
 
@@ -104,9 +118,6 @@ typedef enum lxw_error {
     /** Worksheet name is already in use. */
     LXW_ERROR_SHEETNAME_ALREADY_USED,
 
-    /** Worksheet name 'History' is reserved by Excel. */
-    LXW_ERROR_SHEETNAME_RESERVED,
-
     /** Parameter exceeds Excel's limit of 32 characters. */
     LXW_ERROR_32_STRING_LENGTH_EXCEEDED,
 
@@ -125,6 +136,9 @@ typedef enum lxw_error {
     /** Worksheet row or column index out of range. */
     LXW_ERROR_WORKSHEET_INDEX_OUT_OF_RANGE,
 
+    /** Maximum hyperlink length (2079) exceeded. */
+    LXW_ERROR_WORKSHEET_MAX_URL_LENGTH_EXCEEDED,
+
     /** Maximum number of worksheet URLs (65530) exceeded. */
     LXW_ERROR_WORKSHEET_MAX_NUMBER_URLS_EXCEEDED,
 
@@ -164,6 +178,9 @@ enum lxw_custom_property_types {
     LXW_CUSTOM_DATETIME
 };
 
+/* Size of MD5 byte arrays. */
+#define LXW_MD5_SIZE              16
+
 /* Excel sheetname max of 31 chars. */
 #define LXW_SHEETNAME_MAX         31
 
@@ -188,6 +205,9 @@ enum lxw_custom_property_types {
 /* Datetime string length. */
 #define LXW_DATETIME_LENGTH       sizeof("2016-12-12T23:00:00Z")
 
+/* GUID string length. */
+#define LXW_GUID_LENGTH           sizeof("{12345678-1234-1234-1234-1234567890AB}\0")
+
 #define LXW_EPOCH_1900            0
 #define LXW_EPOCH_1904            1
 
@@ -206,93 +226,134 @@ enum lxw_custom_property_types {
 #define LXW_SCHEMA_DOCUMENT  LXW_SCHEMA_ROOT "/officeDocument/2006/relationships"
 #define LXW_SCHEMA_CONTENT   LXW_SCHEMA_ROOT "/package/2006/content-types"
 
+/* Use REprintf() for error handling when compiled as an R library. */
+#ifdef USE_R_LANG
+#include <R.h>
+#define LXW_PRINTF REprintf
+#define LXW_STDERR
+#else
+#define LXW_PRINTF fprintf
+#define LXW_STDERR stderr,
+#endif
+
 #define LXW_ERROR(message)                      \
-    fprintf(stderr, "[ERROR][%s:%d]: " message "\n", __FILE__, __LINE__)
+    LXW_PRINTF(LXW_STDERR "[ERROR][%s:%d]: " message "\n", __FILE__, __LINE__)
 
 #define LXW_MEM_ERROR()                         \
     LXW_ERROR("Memory allocation failed.")
 
 #define GOTO_LABEL_ON_MEM_ERROR(pointer, label) \
-    if (!pointer) {                             \
-        LXW_MEM_ERROR();                        \
-        goto label;                             \
-    }
+    do {                                        \
+        if (!pointer) {                         \
+            LXW_MEM_ERROR();                    \
+            goto label;                         \
+        }                                       \
+    } while (0)
 
 #define RETURN_ON_MEM_ERROR(pointer, error)     \
-    if (!pointer) {                             \
-        LXW_MEM_ERROR();                        \
-        return error;                           \
-    }
+    do {                                        \
+        if (!pointer) {                         \
+            LXW_MEM_ERROR();                    \
+            return error;                       \
+        }                                       \
+    } while (0)
 
 #define RETURN_VOID_ON_MEM_ERROR(pointer)       \
-    if (!pointer) {                             \
-        LXW_MEM_ERROR();                        \
-        return;                                 \
-    }
+    do {                                        \
+        if (!pointer) {                         \
+            LXW_MEM_ERROR();                    \
+            return;                             \
+        }                                       \
+    } while (0)
 
 #define RETURN_ON_ERROR(error)                  \
-    if (error)                                  \
-        return error;
+    do {                                        \
+        if (error)                              \
+            return error;                       \
+    } while (0)
+
+#define RETURN_AND_ZIPCLOSE_ON_ERROR(error)     \
+        do {                                    \
+            if (error) {                        \
+                zipClose(self->zipfile, NULL);  \
+                return error;                   \
+            }                                   \
+        } while (0)
 
 #define LXW_WARN(message)                       \
-    fprintf(stderr, "[WARNING]: " message "\n")
+    LXW_PRINTF(LXW_STDERR "[WARNING]: " message "\n")
 
 /* We can't use variadic macros here since we support ANSI C. */
 #define LXW_WARN_FORMAT(message)                \
-    fprintf(stderr, "[WARNING]: " message "\n")
+    LXW_PRINTF(LXW_STDERR "[WARNING]: " message "\n")
 
 #define LXW_WARN_FORMAT1(message, var)          \
-    fprintf(stderr, "[WARNING]: " message "\n", var)
+    LXW_PRINTF(LXW_STDERR "[WARNING]: " message "\n", var)
 
 #define LXW_WARN_FORMAT2(message, var1, var2)    \
-    fprintf(stderr, "[WARNING]: " message "\n", var1, var2)
+    LXW_PRINTF(LXW_STDERR "[WARNING]: " message "\n", var1, var2)
+
+#define LXW_WARN_FORMAT3(message, var1, var2, var3) \
+    LXW_PRINTF(LXW_STDERR "[WARNING]: " message "\n", var1, var2, var3)
 
 /* Chart axis type checks. */
 #define LXW_WARN_CAT_AXIS_ONLY(function)                                   \
-    if (!axis->is_category) {                                              \
-        fprintf(stderr, "[WARNING]: "                                      \
-                function "() is only valid for category axes\n");          \
-       return;                                                             \
-    }
+    do {                                                                   \
+        if (!axis->is_category) {                                          \
+            LXW_PRINTF(LXW_STDERR "[WARNING]: "                            \
+                    function "() is only valid for category axes\n");      \
+           return;                                                         \
+        }                                                                  \
+    } while (0)
 
 #define LXW_WARN_VALUE_AXIS_ONLY(function)                                 \
-    if (!axis->is_value) {                                                 \
-        fprintf(stderr, "[WARNING]: "                                      \
+    do {                                                                   \
+        if (!axis->is_value) {                                             \
+            LXW_PRINTF(LXW_STDERR "[WARNING]: "                            \
                 function "() is only valid for value axes\n");             \
-       return;                                                             \
-    }
+                return;                                                    \
+        }                                                                  \
+    } while (0)
 
 #define LXW_WARN_DATE_AXIS_ONLY(function)                                  \
-    if (!axis->is_date) {                                                  \
-        fprintf(stderr, "[WARNING]: "                                      \
-                function "() is only valid for date axes\n");              \
-       return;                                                             \
-    }
+    do {                                                                   \
+        if (!axis->is_date) {                                              \
+            LXW_PRINTF(LXW_STDERR "[WARNING]: "                            \
+                    function "() is only valid for date axes\n");          \
+           return;                                                         \
+        }                                                                  \
+    } while (0)
 
 #define LXW_WARN_CAT_AND_DATE_AXIS_ONLY(function)                          \
-    if (!axis->is_category && !axis->is_date) {                            \
-        fprintf(stderr, "[WARNING]: "                                      \
+    do {                                                                   \
+        if (!axis->is_category && !axis->is_date) {                        \
+            LXW_PRINTF(LXW_STDERR "[WARNING]: "                            \
                 function "() is only valid for category and date axes\n"); \
-       return;                                                             \
-    }
+           return;                                                         \
+        }                                                                  \
+    } while (0)
 
 #define LXW_WARN_VALUE_AND_DATE_AXIS_ONLY(function)                        \
-    if (!axis->is_value && !axis->is_date) {                               \
-        fprintf(stderr, "[WARNING]: "                                      \
+    do {                                                                   \
+        if (!axis->is_value && !axis->is_date) {                           \
+            LXW_PRINTF(LXW_STDERR "[WARNING]: "                            \
                 function "() is only valid for value and date axes\n");    \
-       return;                                                             \
-    }
+            return;                                                        \
+        }                                                                  \
+    } while (0)
 
 #ifndef LXW_BIG_ENDIAN
+#define LXW_UINT16_HOST(n)    (n)
+#define LXW_UINT32_HOST(n)    (n)
+#define LXW_UINT16_NETWORK(n) ((((n) & 0x00FF) << 8) | (((n) & 0xFF00) >> 8))
 #define LXW_UINT32_NETWORK(n) ((((n) & 0xFF)       << 24) | \
                                (((n) & 0xFF00)     <<  8) | \
                                (((n) & 0xFF0000)   >>  8) | \
                                (((n) & 0xFF000000) >> 24))
-#define LXW_UINT16_NETWORK(n) ((((n) & 0x00FF) << 8) | (((n) & 0xFF00) >> 8))
-#define LXW_UINT32_HOST(n)    (n)
 #else
-#define LXW_UINT32_NETWORK(n) (n)
 #define LXW_UINT16_NETWORK(n) (n)
+#define LXW_UINT32_NETWORK(n) (n)
+#define LXW_UINT16_HOST(n)    ((((n) & 0x00FF) << 8) | (((n) & 0xFF00) >> 8))
 #define LXW_UINT32_HOST(n)    ((((n) & 0xFF)       << 24) | \
                                (((n) & 0xFF00)     <<  8) | \
                                (((n) & 0xFF0000)   >>  8) | \

data/libxlsxwriter/include/xlsxwriter/content_types.h

@@ -1,7 +1,7 @@
 /*
  * libxlsxwriter
  *
- * Copyright 2014-2019, John McNamara, jmcnamara@cpan.org. See LICENSE.txt.
+ * Copyright 2014-2022, John McNamara, jmcnamara@cpan.org. See LICENSE.txt.
  *
  * content_types - A libxlsxwriter library for creating Excel XLSX
  *                 content_types files.
@@ -53,9 +53,16 @@ void lxw_ct_add_chart_name(lxw_content_types *content_types,
                            const char *name);
 void lxw_ct_add_drawing_name(lxw_content_types *content_types,
                              const char *name);
+void lxw_ct_add_table_name(lxw_content_types *content_types,
+                           const char *name);
+void lxw_ct_add_comment_name(lxw_content_types *content_types,
+                             const char *name);
+void lxw_ct_add_vml_name(lxw_content_types *content_types);
+
 void lxw_ct_add_shared_strings(lxw_content_types *content_types);
 void lxw_ct_add_calc_chain(lxw_content_types *content_types);
 void lxw_ct_add_custom_properties(lxw_content_types *content_types);
+void lxw_ct_add_metadata(lxw_content_types *content_types);
 
 /* Declarations required for unit testing. */
 #ifdef TESTING

data/libxlsxwriter/include/xlsxwriter/core.h

@@ -1,7 +1,7 @@
 /*
  * libxlsxwriter
  *
- * Copyright 2014-2019, John McNamara, jmcnamara@cpan.org. See LICENSE.txt.
+ * Copyright 2014-2022, John McNamara, jmcnamara@cpan.org. See LICENSE.txt.
  *
  * core - A libxlsxwriter library for creating Excel XLSX core files.
  *

data/libxlsxwriter/include/xlsxwriter/custom.h

@@ -1,7 +1,7 @@
 /*
  * libxlsxwriter
  *
- * Copyright 2014-2019, John McNamara, jmcnamara@cpan.org. See LICENSE.txt.
+ * Copyright 2014-2022, John McNamara, jmcnamara@cpan.org. See LICENSE.txt.
  *
  * custom - A libxlsxwriter library for creating Excel custom property files.
  *

data/libxlsxwriter/include/xlsxwriter/drawing.h

@@ -1,7 +1,7 @@
 /*
  * libxlsxwriter
  *
- * Copyright 2014-2019, John McNamara, jmcnamara@cpan.org. See LICENSE.txt.
+ * Copyright 2014-2022, John McNamara, jmcnamara@cpan.org. See LICENSE.txt.
  *
  * drawing - A libxlsxwriter library for creating Excel XLSX drawing files.
  *
@@ -10,6 +10,7 @@
 #define __LXW_DRAWING_H__
 
 #include <stdint.h>
+#include <string.h>
 
 #include "common.h"
 
@@ -22,24 +23,12 @@ enum lxw_drawing_types {
     LXW_DRAWING_SHAPE
 };
 
-enum lxw_anchor_types {
-    LXW_ANCHOR_TYPE_NONE = 0,
-    LXW_ANCHOR_TYPE_IMAGE,
-    LXW_ANCHOR_TYPE_CHART
-};
-
-enum lxw_anchor_edit_types {
-    LXW_ANCHOR_EDIT_AS_NONE = 0,
-    LXW_ANCHOR_EDIT_AS_RELATIVE,
-    LXW_ANCHOR_EDIT_AS_ONE_CELL,
-    LXW_ANCHOR_EDIT_AS_ABSOLUTE
-};
-
 enum image_types {
     LXW_IMAGE_UNKNOWN = 0,
     LXW_IMAGE_PNG,
     LXW_IMAGE_JPEG,
-    LXW_IMAGE_BMP
+    LXW_IMAGE_BMP,
+    LXW_IMAGE_GIF
 };
 
 /* Coordinates used in a drawing object. */
@@ -52,18 +41,20 @@ typedef struct lxw_drawing_coords {
 
 /* Object to represent the properties of a drawing. */
 typedef struct lxw_drawing_object {
-    uint8_t anchor_type;
-    uint8_t edit_as;
+    uint8_t type;
+    uint8_t anchor;
     struct lxw_drawing_coords from;
     struct lxw_drawing_coords to;
-    uint32_t col_absolute;
-    uint32_t row_absolute;
+    uint64_t col_absolute;
+    uint64_t row_absolute;
     uint32_t width;
     uint32_t height;
     uint8_t shape;
+    uint32_t rel_index;
+    uint32_t url_rel_index;
     char *description;
-    char *url;
     char *tip;
+    uint8_t decorative;
 
     STAILQ_ENTRY (lxw_drawing_object) list_pointers;
 

data/libxlsxwriter/include/xlsxwriter/format.h

@@ -1,7 +1,7 @@
 /*
  * libxlsxwriter
  *
- * Copyright 2014-2019, John McNamara, jmcnamara@cpan.org. See LICENSE.txt.
+ * Copyright 2014-2022, John McNamara, jmcnamara@cpan.org. See LICENSE.txt.
  */
 
 /**
@@ -72,14 +72,14 @@
  * The type for RGB colors in libxlsxwriter. The valid range is `0x000000`
  * (black) to `0xFFFFFF` (white). See @ref working_with_colors.
  */
-typedef int32_t lxw_color_t;
+typedef uint32_t lxw_color_t;
 
 #define LXW_FORMAT_FIELD_LEN            128
 #define LXW_DEFAULT_FONT_NAME           "Calibri"
 #define LXW_DEFAULT_FONT_FAMILY         2
 #define LXW_DEFAULT_FONT_THEME          1
 #define LXW_PROPERTY_UNSET              -1
-#define LXW_COLOR_UNSET                 -1
+#define LXW_COLOR_UNSET                 0x000000
 #define LXW_COLOR_MASK                  0xFFFFFF
 #define LXW_MIN_FONT_SIZE               1.0
 #define LXW_MAX_FONT_SIZE               409.0
@@ -92,8 +92,10 @@ typedef int32_t lxw_color_t;
 
 /** Format underline values for format_set_underline(). */
 enum lxw_format_underlines {
+    LXW_UNDERLINE_NONE = 0,
+
     /** Single underline */
-    LXW_UNDERLINE_SINGLE = 1,
+    LXW_UNDERLINE_SINGLE,
 
     /** Double underline */
     LXW_UNDERLINE_DOUBLE,
@@ -157,9 +159,19 @@ enum lxw_format_alignments {
     LXW_ALIGN_VERTICAL_DISTRIBUTED
 };
 
+/**
+ * Diagonal border types.
+ *
+ */
 enum lxw_format_diagonal_types {
+
+    /** Cell diagonal border from bottom left to top right. */
     LXW_DIAGONAL_BORDER_UP = 1,
+
+    /** Cell diagonal border from top left to bottom right. */
     LXW_DIAGONAL_BORDER_DOWN,
+
+    /** Cell diagonal border in both directions. */
     LXW_DIAGONAL_BORDER_UP_DOWN
 };
 
@@ -348,10 +360,13 @@ typedef struct lxw_format {
     FILE *file;
 
     lxw_hash_table *xf_format_indices;
+    lxw_hash_table *dxf_format_indices;
     uint16_t *num_xf_formats;
+    uint16_t *num_dxf_formats;
 
     int32_t xf_index;
     int32_t dxf_index;
+    int32_t xf_id;
 
     char num_format[LXW_FORMAT_FIELD_LEN];
     char font_name[LXW_FORMAT_FIELD_LEN];
@@ -387,6 +402,8 @@ typedef struct lxw_format {
 
     lxw_color_t fg_color;
     lxw_color_t bg_color;
+    lxw_color_t dxf_fg_color;
+    lxw_color_t dxf_bg_color;
     uint8_t pattern;
     uint8_t has_fill;
     uint8_t has_dxf_fill;
@@ -418,6 +435,8 @@ typedef struct lxw_format {
     uint8_t color_indexed;
     uint8_t font_only;
 
+    uint8_t quote_prefix;
+
     STAILQ_ENTRY (lxw_format) list_pointers;
 } lxw_format;
 
@@ -431,6 +450,7 @@ typedef struct lxw_font {
     uint8_t bold;
     uint8_t italic;
     uint8_t underline;
+    uint8_t theme;
     uint8_t font_strikeout;
     uint8_t font_outline;
     uint8_t font_shadow;
@@ -483,12 +503,11 @@ extern "C" {
 lxw_format *lxw_format_new(void);
 void lxw_format_free(lxw_format *format);
 int32_t lxw_format_get_xf_index(lxw_format *format);
+int32_t lxw_format_get_dxf_index(lxw_format *format);
 lxw_font *lxw_format_get_font_key(lxw_format *format);
 lxw_border *lxw_format_get_border_key(lxw_format *format);
 lxw_fill *lxw_format_get_fill_key(lxw_format *format);
 
-lxw_color_t lxw_format_check_color(lxw_color_t color);
-
 /**
  * @brief Set the font used in the cell.
  *
@@ -672,6 +691,9 @@ void format_set_font_script(lxw_format *format, uint8_t style);
  *
  * @image html format_set_num_format.png
  *
+ * To set a number format that matches an Excel format category such as "Date"
+ * or "Currency" see @ref ww_formats_categories.
+ *
  * The number system used for dates is described in @ref working_with_dates.
  *
  * For more information on number formats in Excel refer to the
@@ -749,6 +771,7 @@ void format_set_num_format(lxw_format *format, const char *num_format);
  *  - The dollar sign in the above format appears as the defined local currency
  *    symbol.
  *  - These formats can also be set via format_set_num_format().
+ *  - See also @ref ww_formats_categories.
  */
 void format_set_num_format_index(lxw_format *format, uint8_t index);
 
@@ -1187,9 +1210,96 @@ void format_set_left_color(lxw_format *format, lxw_color_t color);
  */
 void format_set_right_color(lxw_format *format, lxw_color_t color);
 
-void format_set_diag_type(lxw_format *format, uint8_t value);
+/**
+ * @brief Set the diagonal cell border type.
+ *
+ * @param format Pointer to a Format instance.
+ * @param type   The #lxw_format_diagonal_types diagonal border type.
+ *
+ * Set the diagonal cell border type:
+ *
+ * @code
+ *     lxw_format *format1 = workbook_add_format(workbook);
+ *     format_set_diag_type(  format1, LXW_DIAGONAL_BORDER_UP);
+ *
+ *     lxw_format *format2 = workbook_add_format(workbook);
+ *     format_set_diag_type(  format2, LXW_DIAGONAL_BORDER_DOWN);
+ *
+ *     lxw_format *format3 = workbook_add_format(workbook);
+ *     format_set_diag_type(  format3, LXW_DIAGONAL_BORDER_UP_DOWN);
+ *
+ *     lxw_format *format4 = workbook_add_format(workbook);
+ *     format_set_diag_type(  format4, LXW_DIAGONAL_BORDER_UP_DOWN);
+ *     format_set_diag_border(format4, LXW_BORDER_HAIR);
+ *     format_set_diag_color( format4, LXW_COLOR_RED);
+ *
+ *     worksheet_write_string(worksheet, CELL("B3"),  "Text", format1);
+ *     worksheet_write_string(worksheet, CELL("B6"),  "Text", format2);
+ *     worksheet_write_string(worksheet, CELL("B9"),  "Text", format3);
+ *     worksheet_write_string(worksheet, CELL("B12"), "Text", format4);
+ * @endcode
+ *
+ * @image html diagonal_border.png
+ *
+ * The allowable border types are defined in #lxw_format_diagonal_types:
+ *
+ * - #LXW_DIAGONAL_BORDER_UP: Cell diagonal border from bottom left to top
+ *   right.
+ *
+ * - #LXW_DIAGONAL_BORDER_DOWN: Cell diagonal border from top left to bottom
+ *   right.
+ *
+ * - #LXW_DIAGONAL_BORDER_UP_DOWN: Cell diagonal border from top left to
+ *   bottom right. A combination of the 2 previous types.
+ *
+ * If the border style isn't specified with `format_set_diag_border()` then it
+ * will default to #LXW_BORDER_THIN.
+ */
+void format_set_diag_type(lxw_format *format, uint8_t type);
+
+/**
+ * @brief Set the diagonal cell border style.
+ *
+ * @param format Pointer to a Format instance.
+ * @param style  The #lxw_format_borders style.
+ *
+ * Set the diagonal border style. This should be a #lxw_format_borders value.
+ * See the example above.
+ *
+ */
+void format_set_diag_border(lxw_format *format, uint8_t style);
+
+/**
+ * @brief Set the diagonal cell border color.
+ *
+ * @param format Pointer to a Format instance.
+ * @param color  The cell diagonal border color.
+ *
+ * Set the diagonal border color. The color should be an RGB integer value,
+ * see @ref working_with_colors and the above example.
+ */
 void format_set_diag_color(lxw_format *format, lxw_color_t color);
-void format_set_diag_border(lxw_format *format, uint8_t value);
+
+/**
+ * @brief Turn on quote prefix for the format.
+ *
+ * @param format Pointer to a Format instance.
+ *
+ * Set the quote prefix property of a format to ensure a string is treated
+ * as a string after editing. This is the same as prefixing the string with
+ * a single quote in Excel. You don't need to add the quote to the
+ * string but you do need to add the format.
+ *
+ * @code
+ *     format = workbook_add_format(workbook);
+ *     format_set_quote_prefix(format);
+ *
+ *     worksheet_write_string(worksheet, 0, 0, "=Foo", format);
+ * @endcode
+ *
+ */
+void format_set_quote_prefix(lxw_format *format);
+
 void format_set_font_outline(lxw_format *format);
 void format_set_font_shadow(lxw_format *format);
 void format_set_font_family(lxw_format *format, uint8_t value);
@@ -1199,6 +1309,9 @@ void format_set_font_condense(lxw_format *format);
 void format_set_font_extend(lxw_format *format);
 void format_set_reading_order(lxw_format *format, uint8_t value);
 void format_set_theme(lxw_format *format, uint8_t value);
+void format_set_hyperlink(lxw_format *format);
+void format_set_color_indexed(lxw_format *format, uint8_t value);
+void format_set_font_only(lxw_format *format);
 
 /* Declarations required for unit testing. */
 #ifdef TESTING

data/libxlsxwriter/include/xlsxwriter/hash_table.h

@@ -1,7 +1,7 @@
 /*
  * libxlsxwriter
  *
- * Copyright 2014-2019, John McNamara, jmcnamara@cpan.org. See LICENSE.txt.
+ * Copyright 2014-2022, John McNamara, jmcnamara@cpan.org. See LICENSE.txt.
  *
  * hash_table - Hash table functions for libxlsxwriter.
  *

data/libxlsxwriter/include/xlsxwriter/metadata.h

@@ -0,0 +1,49 @@
+/*
+ * libxlsxwriter
+ *
+ * Copyright 2014-2022, John McNamara, jmcnamara@cpan.org. See LICENSE.txt.
+ *
+ * metadata - A libxlsxwriter library for creating Excel XLSX metadata files.
+ *
+ */
+#ifndef __LXW_METADATA_H__
+#define __LXW_METADATA_H__
+
+#include <stdint.h>
+
+#include "common.h"
+
+/*
+ * Struct to represent a metadata object.
+ */
+typedef struct lxw_metadata {
+
+    FILE *file;
+
+} lxw_metadata;
+
+
+/* *INDENT-OFF* */
+#ifdef __cplusplus
+extern "C" {
+#endif
+/* *INDENT-ON* */
+
+lxw_metadata *lxw_metadata_new(void);
+void lxw_metadata_free(lxw_metadata *metadata);
+void lxw_metadata_assemble_xml_file(lxw_metadata *self);
+
+/* Declarations required for unit testing. */
+#ifdef TESTING
+
+STATIC void _metadata_xml_declaration(lxw_metadata *self);
+
+#endif /* TESTING */
+
+/* *INDENT-OFF* */
+#ifdef __cplusplus
+}
+#endif
+/* *INDENT-ON* */
+
+#endif /* __LXW_METADATA_H__ */