Add new function: unset_conditional_format (#28)

- Update unit tests

Author: Leo012345678

excelize.py

@@ -5668,6 +5668,30 @@ def unprotect_workbook(self, *password: str) -> None:
         if err != "":
             raise RuntimeError(err)
 
+    def unset_conditional_format(self, sheet: str, range_ref: str) -> None:
+        """
+        Unset the conditional format by given worksheet name and range
+        reference.
+
+        Args:
+            sheet (str): The worksheet name
+            range_ref (str): The top-left and right-bottom cell range reference
+
+        Returns:
+            None: Return None if no error occurred, otherwise raise a
+            RuntimeError with the message.
+        """
+        prepare_args(
+            [sheet, range_ref],
+            [argsRule("sheet", [str]), argsRule("range_ref", [str])],
+        )
+        lib.UnsetConditionalFormat.restype = c_char_p
+        err = lib.UnsetConditionalFormat(
+            self.file_index, sheet.encode(ENCODE), range_ref.encode(ENCODE)
+        ).decode(ENCODE)
+        if err != "":
+            raise RuntimeError(err)
+
     def update_linked_value(self) -> None:
         """
         Fix linked values within a spreadsheet are not updating in Office Excel

main.go

@@ -2807,6 +2807,21 @@ func UnprotectWorkbook(idx int, password *C.char, verify bool) *C.char {
 	return C.CString(emptyString)
 }
 
+// UnsetConditionalFormat provides a function to unset the conditional format
+// by given worksheet name and range reference.
+//
+//export UnsetConditionalFormat
+func UnsetConditionalFormat(idx int, sheet, rangeRef *C.char) *C.char {
+	f, ok := files.Load(idx)
+	if !ok {
+		return C.CString(errFilePtr)
+	}
+	if err := f.(*excelize.File).UnsetConditionalFormat(C.GoString(sheet), C.GoString(rangeRef)); err != nil {
+		return C.CString(err.Error())
+	}
+	return C.CString(emptyString)
+}
+
 // UpdateLinkedValue fix linked values within a spreadsheet are not updating in
 // Office Excel application. This function will be remove value tag when met a
 // cell have a linked value.

test_excelize.py

@@ -1980,6 +1980,17 @@ def test_conditional_format(self):
             str(context.exception),
             "expected type list for argument 'opts', but got int",
         )
+
+        self.assertIsNone(f.unset_conditional_format("Sheet1", "A1:A10"))
+        with self.assertRaises(RuntimeError) as context:
+            f.unset_conditional_format("SheetN", "A1:A10")
+        self.assertEqual(str(context.exception), "sheet SheetN does not exist")
+        with self.assertRaises(TypeError) as context:
+            f.unset_conditional_format("Sheet1", 1)
+        self.assertEqual(
+            str(context.exception),
+            "expected type str for argument 'range_ref', but got int",
+        )
         self.assertIsNone(f.save_as(os.path.join("test", "TestConditionalFormat.xlsx")))
         self.assertIsNone(f.close())