ActRef: Enhancing the Understanding of Python Code Refactoring with Action-Based Analysis

TL;DR

ActRef is a novel framework that improves detection and understanding of Python code refactorings by analyzing code change actions, achieving high accuracy and covering multiple refactoring types and levels.

Contribution

This paper introduces ActRef, a new action-based analysis framework that enhances Python refactoring detection across various types and granularities, surpassing existing tools.

Findings

Achieves high precision (0.80) and recall (0.92) in refactoring detection.

Effectively identifies multiple refactoring types and levels.

Outperforms existing baselines like PyRef and ChatGPT-4 in detection accuracy.

Abstract

Refactoring, the process of improving the code structure of a software system without altering its behavior, is crucial for managing code evolution in software development. Identifying refactoring actions in source code is essential for understanding software evolution and guiding developers in maintaining and improving the code quality. This study presents an action-based Refactoring Analysis Framework named ActRef, a novel algorithm designed to advance the detection and understanding of Python refactorings through a unique code change action-based analysis of code changes. ActRef mining multiple refactoring types (e.g., move, rename, extract, and inline operations) based on diff actions, covering multiple granularity levels including variable, method, class, and module levels. By focusing on the code change actions, ActRef provides a Python-adaptive solution to detect intricate refactoring patterns. Our evaluation, conducted on 1,914 manually validated refactoring instances from 136 open-source Python projects. The evaluation results show that ActRef achieves high precision(0.80) and recall(0.92), effectively identifying multiple refactoring types. Compared with leading baselines, including PyRef, PyRef with MLRefScanner, DeepSeek-R1 and ChatGPT-4, ActRef consistently demonstrates superior performance in detecting Python refactorings across various types. While matching PyRef in runtime efficiency, ActRef supports a broader spectrum of refactoring types and more refactoring mining levels. ActRef shows an effective and scalable approach for mining refactorings in dynamic Python codebases and introduces a new perspective on understanding code.