[Tool] changelog tool rename feature (Azure#25955)

* rename feature

* update function name

* become better

Author: BigCat20196

tools/azure-sdk-tools/packaging_tools/change_log.py

@@ -21,13 +21,16 @@ def __init__(self, old_report, new_report):
         self.optional_features = []
         self._old_report = old_report
         self._new_report = new_report
+        self.removed_operations = []
+        self.added_operations = []
 
     def sort(self):
         self.features.sort()
         self.breaking_changes.sort()
         self.optional_features.sort()
 
     def build_md(self):
+        self.compare_operation()
         self.sort()
         buffer = []
         if self.features:
@@ -73,10 +76,11 @@ def operation(self, diff_entry):
         # Is this a new operation, inside a known operation group?
         function_name, *remaining_path = remaining_path
         if not remaining_path:
+            # Simplify renaming func to begin_func change, put it into the compare_operation() for processing
             if is_deletion:
-                self.breaking_changes.append(_REMOVE_OPERATION.format(operation_name, function_name))
+                self.removed_operations.append(f'{operation_name}.{function_name}')
             else:
-                self.features.append(_ADD_OPERATION.format(operation_name, function_name))
+                self.added_operations.append(f'{operation_name}.{function_name}')
             return
 
         if remaining_path[0] == "metadata":
@@ -175,6 +179,23 @@ def client(self, old_report, new_report):
             self.breaking_changes.append(msg)
         return
 
+    def compare_operation(self):
+        '''
+        Record changelog like "rename operation.delete to operation.begin_delete"
+        instead of "remove operation.delete or add operation.begin_delete"
+        '''
+        while self.removed_operations:
+            op, old_function  = self.removed_operations.pop().split('.')
+            new_function = f'begin_{old_function}'
+            if f'{op}.{new_function}' in self.added_operations:
+                self.added_operations.remove(f'{op}.{new_function}')
+                self.breaking_changes.append(_RENAME_OPERATION.format(op, old_function, op, new_function))
+            else:
+                self.breaking_changes.append(_REMOVE_OPERATION.format(op, old_function))
+        for op_function in self.added_operations:
+            operation_name, function_name = op_function.split('.')
+            self.features.append(_ADD_OPERATION.format(operation_name, function_name))
+
 
 ## Features
 _ADD_OPERATION_GROUP = "Added operation group {}"
@@ -186,6 +207,7 @@ def client(self, old_report, new_report):
 ## Breaking Changes
 _REMOVE_OPERATION_GROUP = "Removed operation group {}"
 _REMOVE_OPERATION = "Removed operation {}.{}"
+_RENAME_OPERATION = "Renamed operation {}.{} to {}.{}"
 _REMOVE_OPERATION_PARAM = "Operation {}.{} no longer has parameter {}"
 _CLIENT_SIGNATURE_CHANGE = "Client name is changed from `{}` to `{}`"
 _CLIENT_SIGNATURE_CHANGE_WITHOUT_OLD = "Client name is changed to `{}`"