Upgrade the Excelize library version

- Add dash and fill fields in the ChartLine class
- Add border field in the ChartMarker class
- Add font field in the ChartLegend class
- Add legend field in the ChartSeries class
- Add new ChartDashType class
- Support setting dash line and marker border type of charts
- Support setting dash type of line charts
- Support setting font for chart legends

Author: xuri

excelize.py

@@ -779,6 +779,7 @@ def add_chart(self, sheet: str, cell: str, chart: Chart, **combo: Chart) -> None
             categories
             values
             fill
+            legend
             line
             marker
             data_label
@@ -804,6 +805,9 @@ def add_chart(self, sheet: str, cell: str, chart: Chart, **combo: Chart) -> None
         fill: This set the format for the data series fill. The 'fill' property
         is optional
 
+        legend: This set the font of legend text for a data series. The 'legend'
+        property is optional.
+
         line: This sets the line format of the line chart. The 'line' property
         is optional and if it isn't supplied it will default style. The options
         that can be set are width and color. The range of width is 0.25pt -
@@ -837,6 +841,7 @@ def add_chart(self, sheet: str, cell: str, chart: Chart, **combo: Chart) -> None
 
             position
             show_legend_key
+            font
 
         position: Set the position of the chart legend. The default legend
         position is bottom. The available positions are:
@@ -848,8 +853,13 @@ def add_chart(self, sheet: str, cell: str, chart: Chart, **combo: Chart) -> None
             right
             top_right
 
-        ShowLegendKey: Set the legend keys shall be shown in data labels. The default
-        value is false.
+        show_legend_key: Set the legend keys shall be shown in data labels.
+        The default value is False.
+
+        font: Set the font properties of the chart legend text. The properties
+        that can be set are the same as the font object that is used for cell
+        formatting. The font family, size, color, bold, italic, underline, and
+        strike properties can be set.
 
         Set properties of the chart title. The properties that can be set are:
 
@@ -983,7 +993,7 @@ def add_chart(self, sheet: str, cell: str, chart: Chart, **combo: Chart) -> None
 
         reverse_order: Specifies that the categories or values on reverse order
         (orientation of the chart). The 'reverse_order' property is optional. The
-        default value is false.
+        default value is False.
 
         maximum: Specifies that the fixed maximum, 0 is auto. The 'maximum'
         property is optional. The default value is auto.
@@ -1033,6 +1043,9 @@ def add_chart(self, sheet: str, cell: str, chart: Chart, **combo: Chart) -> None
         Set chart size by 'dimension' property. The 'dimension' property is
         optional. The default width is 480, and height is 260.
 
+        Set chart legend for all data series by 'legend' property. The 'legend'
+        property is optional.
+
         Set the bubble size in all data series for the bubble chart or 3D bubble
         chart by 'bubble_sizes' property. The 'bubble_sizes' property is
         optional. The default width is 100, and the value should be great than 0
@@ -4938,7 +4951,7 @@ def set_sheet_visible(self, sheet: str, visible: bool, *very_hidden: bool) -> No
         Set worksheet visible by given worksheet name. A workbook must contain
         at least one visible worksheet. If the given worksheet has been
         activated, this setting will be invalidated. The third optional
-        very_hidden parameter only works when visible was false.
+        very_hidden parameter only works when visible was False.
 
         Args:
             sheet (str): The worksheet name

go.mod

@@ -3,8 +3,8 @@ module github.com/xuri/excelize-py
 go 1.23.0
 
 require (
-	github.com/xuri/excelize/v2 v2.9.2-0.20250705033143-4ac39a83f90d
-	golang.org/x/image v0.27.0
+	github.com/xuri/excelize/v2 v2.9.2-0.20250710001508-249b593d21b1
+	golang.org/x/image v0.29.0
 )
 
 require (
@@ -13,7 +13,7 @@ require (
 	github.com/tiendc/go-deepcopy v1.6.1 // indirect
 	github.com/xuri/efp v0.0.1 // indirect
 	github.com/xuri/nfp v0.0.2-0.20250530014748-2ddeb826f9a9 // indirect
-	golang.org/x/crypto v0.39.0 // indirect
-	golang.org/x/net v0.41.0 // indirect
-	golang.org/x/text v0.26.0 // indirect
+	golang.org/x/crypto v0.40.0 // indirect
+	golang.org/x/net v0.42.0 // indirect
+	golang.org/x/text v0.27.0 // indirect
 )

go.sum

@@ -13,17 +13,17 @@ github.com/tiendc/go-deepcopy v1.6.1 h1:uVRTItFeNHkMcLueHS7OCsxgxT9P8MzGB/taUa2Y
 github.com/tiendc/go-deepcopy v1.6.1/go.mod h1:toXoeQoUqXOOS/X4sKuiAoSk6elIdqc0pN7MTgOOo2I=
 github.com/xuri/efp v0.0.1 h1:fws5Rv3myXyYni8uwj2qKjVaRP30PdjeYe2Y6FDsCL8=
 github.com/xuri/efp v0.0.1/go.mod h1:ybY/Jr0T0GTCnYjKqmdwxyxn2BQf2RcQIIvex5QldPI=
-github.com/xuri/excelize/v2 v2.9.2-0.20250705033143-4ac39a83f90d h1:lCQQkdCgvaObmTrw0vjzvUbH1CyJE9yHgcj1a7Y1MU0=
-github.com/xuri/excelize/v2 v2.9.2-0.20250705033143-4ac39a83f90d/go.mod h1:isQygQdjiU88/HpJYtp+6TN/FH29HvVjWT8vFk3t5+w=
+github.com/xuri/excelize/v2 v2.9.2-0.20250710001508-249b593d21b1 h1:wj8xnLX7FjRxN+ua4A+UEB0IzTQwlN6zTQ1atbUgQRM=
+github.com/xuri/excelize/v2 v2.9.2-0.20250710001508-249b593d21b1/go.mod h1:isQygQdjiU88/HpJYtp+6TN/FH29HvVjWT8vFk3t5+w=
 github.com/xuri/nfp v0.0.2-0.20250530014748-2ddeb826f9a9 h1:+C0TIdyyYmzadGaL/HBLbf3WdLgC29pgyhTjAT/0nuE=
 github.com/xuri/nfp v0.0.2-0.20250530014748-2ddeb826f9a9/go.mod h1:WwHg+CVyzlv/TX9xqBFXEZAuxOPxn2k1GNHwG41IIUQ=
-golang.org/x/crypto v0.39.0 h1:SHs+kF4LP+f+p14esP5jAoDpHU8Gu/v9lFRK6IT5imM=
-golang.org/x/crypto v0.39.0/go.mod h1:L+Xg3Wf6HoL4Bn4238Z6ft6KfEpN0tJGo53AAPC632U=
-golang.org/x/image v0.27.0 h1:C8gA4oWU/tKkdCfYT6T2u4faJu3MeNS5O8UPWlPF61w=
-golang.org/x/image v0.27.0/go.mod h1:xbdrClrAUway1MUTEZDq9mz/UpRwYAkFFNUslZtcB+g=
-golang.org/x/net v0.41.0 h1:vBTly1HeNPEn3wtREYfy4GZ/NECgw2Cnl+nK6Nz3uvw=
-golang.org/x/net v0.41.0/go.mod h1:B/K4NNqkfmg07DQYrbwvSluqCJOOXwUjeb/5lOisjbA=
-golang.org/x/text v0.26.0 h1:P42AVeLghgTYr4+xUnTRKDMqpar+PtX7KWuNQL21L8M=
-golang.org/x/text v0.26.0/go.mod h1:QK15LZJUUQVJxhz7wXgxSy/CJaTFjd0G+YLonydOVQA=
+golang.org/x/crypto v0.40.0 h1:r4x+VvoG5Fm+eJcxMaY8CQM7Lb0l1lsmjGBQ6s8BfKM=
+golang.org/x/crypto v0.40.0/go.mod h1:Qr1vMER5WyS2dfPHAlsOj01wgLbsyWtFn/aY+5+ZdxY=
+golang.org/x/image v0.29.0 h1:HcdsyR4Gsuys/Axh0rDEmlBmB68rW1U9BUdB3UVHsas=
+golang.org/x/image v0.29.0/go.mod h1:RVJROnf3SLK8d26OW91j4FrIHGbsJ8QnbEocVTOWQDA=
+golang.org/x/net v0.42.0 h1:jzkYrhi3YQWD6MLBJcsklgQsoAcw89EcZbJw8Z614hs=
+golang.org/x/net v0.42.0/go.mod h1:FF1RA5d3u7nAYA4z2TkclSCKh68eSXtiFwcWQpPXdt8=
+golang.org/x/text v0.27.0 h1:4fGWRpyh641NLlecmyl4LOe6yDdfaYNrGb2zdfo4JV4=
+golang.org/x/text v0.27.0/go.mod h1:1D28KMCvyooCX9hBiosv5Tz/+YLxj0j7XhWjpSUF7CU=
 gopkg.in/yaml.v3 v3.0.1 h1:fxVm/GzAzEWqLHuvctI91KS9hhNmmWOoWu0XTYJS7CA=
 gopkg.in/yaml.v3 v3.0.1/go.mod h1:K4uyk7z7BCEPqu6E+C64Yfv1cQ7kz7rIZviUmN+EgEM=

types_c.h

@@ -442,24 +442,28 @@ struct ChartLegend
 {
     char *Position;
     bool ShowLegendKey;
-};
-
-// ChartMarker directly maps the format settings of the chart marker.
-struct ChartMarker
-{
-    struct Fill Fill;
-    char *Symbol;
-    int Size;
+    struct Font *Font;
 };
 
 // ChartLine directly maps the format settings of the chart line.
 struct ChartLine
 {
     unsigned char Type;
+	unsigned char Dash;
+	struct Fill Fill;
     bool Smooth;
     double Width;
 };
 
+// ChartMarker directly maps the format settings of the chart marker.
+struct ChartMarker
+{
+    struct ChartLine Border;
+    struct Fill Fill;
+    char *Symbol;
+    int Size;
+};
+
 // ChartSeries directly maps the format settings of the chart series.
 struct ChartSeries
 {
@@ -468,6 +472,7 @@ struct ChartSeries
     char *Values;
     char *Sizes;
     struct Fill Fill;
+    struct ChartLegend Legend;
     struct ChartLine Line;
     struct ChartMarker Marker;
     struct ChartDataLabel DataLabel;

types_go.py

@@ -413,22 +413,26 @@ class _ChartLegend(Structure):
     _fields_ = [
         ("Position", c_char_p),
         ("ShowLegendKey", c_bool),
+        ("Font", POINTER(_Font)),
     ]
 
 
-class _ChartMarker(Structure):
+class _ChartLine(Structure):
     _fields_ = [
+        ("Type", c_uint),
+        ("Dash", c_uint),
         ("Fill", _Fill),
-        ("Symbol", c_char_p),
-        ("Size", c_int),
+        ("Smooth", c_bool),
+        ("Width", c_double),
     ]
 
 
-class _ChartLine(Structure):
+class _ChartMarker(Structure):
     _fields_ = [
-        ("Type", c_uint),
-        ("Smooth", c_bool),
-        ("Width", c_double),
+        ("Border", _ChartLine),
+        ("Fill", _Fill),
+        ("Symbol", c_char_p),
+        ("Size", c_int),
     ]
 
 
@@ -439,6 +443,7 @@ class _ChartSeries(Structure):
         ("Values", c_char_p),
         ("Sizes", c_char_p),
         ("Fill", _Fill),
+        ("Legend", _ChartLegend),
         ("Line", _ChartLine),
         ("Marker", _ChartMarker),
         ("DataLabel", _ChartDataLabel),

types_py.py

@@ -59,6 +59,25 @@ class FormControlType(IntEnum):
     FormControlScrollBar = 7
 
 
+class ChartDashType(IntEnum):
+    """
+    ChartDashType defines the currently supported chart dash types enumeration.
+    """
+
+    ChartDashUnset = 0
+    ChartDashSolid = 1
+    ChartDashDot = 2
+    ChartDashDash = 3
+    ChartDashLgDash = 4
+    ChartDashSashDot = 5
+    ChartDashLgDashDot = 6
+    ChartDashLgDashDotDot = 7
+    ChartDashSysDash = 8
+    ChartDashSysDot = 9
+    ChartDashSysDashDot = 10
+    ChartDashSysDashDotDot = 11
+
+
 class ChartLineType(IntEnum):
     """
     ChartLineType defines the currently supported chart line types enumeration.
@@ -540,29 +559,34 @@ class ChartPlotArea:
 class ChartLegend:
     position: str = ""
     show_legend_key: bool = False
-
-
-@dataclass
-class ChartMarker:
-    fill: Fill = Fill
-    symbol: str = ""
-    size: int = 0
+    font: Optional[Font] = None
 
 
 @dataclass
 class ChartLine:
     type: ChartLineType = ChartLineType.ChartLineUnset
+    dash: ChartDashType = ChartDashType.ChartDashUnset
+    fill: Fill = Fill
     smooth: bool = False
     width: float = 0
 
 
+@dataclass
+class ChartMarker:
+    border: ChartLine = ChartLine
+    fill: Fill = Fill
+    symbol: str = ""
+    size: int = 0
+
+
 @dataclass
 class ChartSeries:
     name: str = ""
     categories: str = ""
     values: str = ""
     sizes: str = ""
     fill: Fill = Fill
+    legend: ChartLegend = ChartLegend
     line: ChartLine = ChartLine
     marker: ChartMarker = ChartMarker
     data_label: ChartDataLabel = ChartDataLabel