Add new function: get_sheet_visible (#25)

- Update unit tests

Author: Leopard31415926

excelize.py

@@ -863,7 +863,7 @@ def add_chart(self, sheet: str, cell: str, chart: Chart, **combo: Chart) -> None
 
         Set properties of the chart title. The properties that can be set are:
 
-       	    title
+            title
 
         title: Set the name (title) for the chart. The name is displayed above
         the chart. The name can also be a formula such as Sheet1!$A$1 or a list
@@ -2961,6 +2961,34 @@ def get_sheet_name(self, sheet: int) -> str:
             return res.val.decode(ENCODE)
         raise RuntimeError(err)
 
+    def get_sheet_visible(self, sheet: str) -> bool:
+        """
+        Get visible state of the sheet by given sheet name.
+
+        Args:
+            sheet (str): The sheet name.
+
+        Returns:
+            bool: Return the sheet visible if no error occurred, otherwise raise
+            a RuntimeError with the message.
+
+        Example:
+            For example, get the visible state of "Sheet1":
+
+            ```python
+            try:
+                visible = f.get_sheet_visible("Sheet1")
+            except RuntimeError as err:
+                print(err)
+            ```
+        """
+        lib.GetSheetVisible.restype = types_go._BoolErrorResult
+        res = lib.GetSheetVisible(self.file_index, sheet.encode(ENCODE))
+        err = res.err.decode(ENCODE)
+        if not err:
+            return res.val
+        raise RuntimeError(err)
+
     def get_style(self, style_id: int) -> Optional[Style]:
         """
         Get style definition by given style ID.

main.go

@@ -1439,6 +1439,22 @@ func GetSheetProps(idx int, sheet *C.char) C.struct_GetSheetPropsResult {
 	return C.struct_GetSheetPropsResult{opts: cVal.Elem().Interface().(C.struct_SheetPropsOptions), err: C.CString(emptyString)}
 }
 
+// GetSheetVisible provides a function to get worksheet visible by given
+// worksheet name.
+//
+//export GetSheetVisible
+func GetSheetVisible(idx int, sheet *C.char) C.struct_BoolErrorResult {
+	f, ok := files.Load(idx)
+	if !ok {
+		return C.struct_BoolErrorResult{val: C._Bool(false), err: C.CString(errFilePtr)}
+	}
+	visible, err := f.(*excelize.File).GetSheetVisible(C.GoString(sheet))
+	if err != nil {
+		return C.struct_BoolErrorResult{val: C._Bool(visible), err: C.CString(err.Error())}
+	}
+	return C.struct_BoolErrorResult{val: C._Bool(visible), err: C.CString(emptyString)}
+}
+
 // GetStyle provides a function to get style definition by given style index.
 //
 //export GetStyle

test_excelize.py

@@ -1571,6 +1571,14 @@ def test_sheet_visible(self):
             str(context.exception),
             "the sheet can not contain any of the characters :\/?*[or]",
         )
+        self.assertTrue(f.get_sheet_visible("Sheet1"))
+        self.assertFalse(f.get_sheet_visible("Sheet2"))
+        with self.assertRaises(RuntimeError) as context:
+            f.get_sheet_visible("Sheet:1")
+        self.assertEqual(
+            str(context.exception),
+            "the sheet can not contain any of the characters :\/?*[or]",
+        )
         self.assertIsNone(f.save_as(os.path.join("test", "TestSheetVisible.xlsx")))
         self.assertIsNone(f.close())