Add new function: get_sheet_props (#23)

- Update unit tests
- Upgrade the dependencies package version

Author: JerryLuo-2005

excelize.py

@@ -2059,6 +2059,21 @@ def get_workbook_props(self) -> WorkbookPropsOptions:
             return c_value_to_py(res.opts, WorkbookPropsOptions())
         raise RuntimeError(err)
 
+    def get_sheet_props(self, sheet_name: str) -> Optional[SheetPropsOptions]:
+        """
+        Get worksheet properties.
+
+        Returns:
+            Optional[SheetPropsOptions]: Return the sheet property options if no
+            error occurred, otherwise raise a RuntimeError with the message.
+        """
+        lib.GetSheetProps.restype = types_go._GetSheetPropsResult
+        res = lib.GetSheetProps(self.file_index, sheet_name.encode(ENCODE))
+        err = res.err.decode(ENCODE)
+        if not err:
+            return c_value_to_py(res.opts, SheetPropsOptions())
+        raise RuntimeError(err)
+
     def group_sheets(self, sheets: List[str]) -> None:
         """
         Group worksheets by given worksheets name. Group worksheets must contain

go.mod

@@ -3,7 +3,7 @@ module github.com/xuri/excelize-py
 go 1.23.0
 
 require (
-	github.com/xuri/excelize/v2 v2.9.2-0.20250517173208-bb1105b08996
+	github.com/xuri/excelize/v2 v2.9.2-0.20250527011656-c46099ee67be
 	golang.org/x/image v0.27.0
 )
 

go.sum

@@ -13,8 +13,8 @@ github.com/tiendc/go-deepcopy v1.6.0 h1:0UtfV/imoCwlLxVsyfUd4hNHnB3drXsfle+wzSCA
 github.com/tiendc/go-deepcopy v1.6.0/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.20250517173208-bb1105b08996 h1:+LFbX4Ds4p6O13TrQJODD8UnG3J/Q1whc26C4M/vo8E=
-github.com/xuri/excelize/v2 v2.9.2-0.20250517173208-bb1105b08996/go.mod h1:x7L6pKz2dvo9ejrRuD8Lnl98z4JLt0TGAwjhW+EiP8s=
+github.com/xuri/excelize/v2 v2.9.2-0.20250527011656-c46099ee67be h1:hPXzrTtRmS2byp4c5RRKmj4vYahw5Yw0+ZGVfMojI00=
+github.com/xuri/excelize/v2 v2.9.2-0.20250527011656-c46099ee67be/go.mod h1:x7L6pKz2dvo9ejrRuD8Lnl98z4JLt0TGAwjhW+EiP8s=
 github.com/xuri/nfp v0.0.1 h1:MDamSGatIvp8uOmDP8FnmjuQpu90NzdJxo7242ANR9Q=
 github.com/xuri/nfp v0.0.1/go.mod h1:WwHg+CVyzlv/TX9xqBFXEZAuxOPxn2k1GNHwG41IIUQ=
 golang.org/x/crypto v0.38.0 h1:jt+WWG8IZlBnVbomuhg2Mdq0+BBQaHbtqHEFEigjUV8=

main.go

@@ -111,7 +111,7 @@ var (
 			return reflect.ValueOf(C.uint(uint32(goVal.Uint()))), nil
 		},
 		reflect.Uint8: func(goVal reflect.Value, kind reflect.Kind) (reflect.Value, error) {
-			return reflect.ValueOf(C.uchar(int8(goVal.Uint()))), nil
+			return reflect.ValueOf(C.uint(uint32(goVal.Uint()))), nil
 		},
 		reflect.Uint32: func(goVal reflect.Value, kind reflect.Kind) (reflect.Value, error) {
 			return reflect.ValueOf(C.uint(uint32(goVal.Uint()))), nil
@@ -1388,6 +1388,25 @@ func GetSheetName(idx int, sheetIndex int) C.struct_StringErrorResult {
 	return C.struct_StringErrorResult{val: C.CString(f.(*excelize.File).GetSheetName(sheetIndex)), err: C.CString(emptyString)}
 }
 
+// GetSheetProps provides a function to get worksheet properties.
+//
+//export GetSheetProps
+func GetSheetProps(idx int, sheet *C.char) C.struct_GetSheetPropsResult {
+	f, ok := files.Load(idx)
+	if !ok {
+		return C.struct_GetSheetPropsResult{err: C.CString(errFilePtr)}
+	}
+	opts, err := f.(*excelize.File).GetSheetProps(C.GoString(sheet))
+	if err != nil {
+		return C.struct_GetSheetPropsResult{err: C.CString(err.Error())}
+	}
+	cVal, err := goValueToC(reflect.ValueOf(opts), reflect.ValueOf(&C.struct_SheetPropsOptions{}))
+	if err != nil {
+		return C.struct_GetSheetPropsResult{err: C.CString(err.Error())}
+	}
+	return C.struct_GetSheetPropsResult{opts: cVal.Elem().Interface().(C.struct_SheetPropsOptions), err: C.CString(emptyString)}
+}
+
 // GetStyle provides a function to get style definition by given style index.
 //
 //export GetStyle

test_excelize.py

@@ -833,6 +833,11 @@ def test_add_form_control(self):
         self.assertIsNone(
             f.set_sheet_props("Sheet1", excelize.SheetPropsOptions(code_name="Sheet1"))
         )
+        props = f.get_sheet_props("Sheet1")
+        self.assertEqual(props.code_name, "Sheet1")
+        with self.assertRaises(RuntimeError) as context:
+            f.get_sheet_props("SheetN")
+        self.assertEqual(str(context.exception), "sheet SheetN does not exist")
         with self.assertRaises(RuntimeError) as context:
             f.set_sheet_props("SheetN", excelize.SheetPropsOptions(code_name="Sheet1"))
         self.assertEqual(str(context.exception), "sheet SheetN does not exist")

types_c.h

@@ -152,6 +152,7 @@ struct Font
     int *ColorTheme;
     double ColorTint;
     char *VertAlign;
+    int *Charset;
 };
 
 // Alignment directly maps the alignment settings of the cells.
@@ -807,6 +808,12 @@ struct GetWorkbookPropsResult
     char *err;
 };
 
+struct GetSheetPropsResult
+{
+    struct SheetPropsOptions opts;
+    char *err;
+};
+
 struct GetSheetMapResult {
     int ArrLen;
     struct IntStringResult *Arr;

types_go.py

@@ -127,6 +127,7 @@ class _Font(Structure):
         ("ColorTheme", POINTER(c_int)),
         ("ColorTint", c_double),
         ("VertAlign", c_char_p),
+        ("Charset", POINTER(c_int)),
     ]
 
 
@@ -797,6 +798,13 @@ class _GetWorkbookPropsResult(Structure):
     ]
 
 
+class _GetSheetPropsResult(Structure):
+    _fields_ = [
+        ("opts", _SheetPropsOptions),
+        ("err", c_char_p),
+    ]
+
+
 class _GetSheetMapResult(Structure):
     _fields_ = [
         ("ArrLen", c_int),

types_py.py

@@ -265,6 +265,7 @@ class Font:
     color_theme: Optional[int] = None
     color_tint: float = 0
     vert_align: str = ""
+    charset: Optional[int] = None
 
 
 @dataclass