Implement nonlocal variables scoping rule for rename refactor

未關閉
#935 0 則留言 0 個 reaction 已指派 0 人 在 GitHub 檢視

維護者通常 6 天內回覆

@ryanchou1994 已經在處理了。

開始於 2026年11月6日。

  • #936 來自 @ryanchou1994 —— 未關閉

評估

難度
4/5
預估耗時
3-5 天
新手友好度
48/100
Issue 類型
功能
描述清晰度
基本清楚
活躍度
活躍
技術堆疊
python

研究方向

Start by reading the rename refactor implementation and its tests for variable scope handling; the issue does not name specific files or tests. Trace how definitions and references are resolved across nested functions, then add coverage for the nonlocal cases in the example. Done means renaming the variable defined in outer updates its nested nonlocal references and read, while leaving the global name and inner4 variable unchanged.

由索引模型根據 Issue 內容生成。

描述

bug

Is your feature request related to a problem? Please describe.

Rename refactor does not understand nonlocal variables scoping rules at all.

Describe the solution you'd like

Given this code:

var_x = "global"        # shadowed variable in global scope should not be renamed

def outer():
    def inner1():
        nonlocal var_x  # when renaming this
        var_x = 1

    def inner2():
        nonlocal var_x  # declared nonlocal from a different inner function, should be renamed
        var_x = 2

    def inner3():
        print(var_x)    # undeclared read-only nonlocal, should be renamed

    def inner4():
        var_x = 4       # this creates separate scope, should not be renamed 
 
   var_x = None        # this is the definition location of the var_x, should be renamed
    # var_x: int        # variable can also be declared by type hint without assignment

    return var_x

Currently rename refactor only rename variables in one function at a time.

  1. Expected code after refactoring: All instances of var_x insider outer, except inner4 should be renamed.

  2. Describe the error or unexpected result that you are getting: currently, each function gets treated as their own scope and inner functions variables don't get renamed and vice versa

Editor information (please complete the following information):

  • Rope version: 1.15.2
主要語言
Python
星號
2.2k
分支
197
平均合併
2 天 20 小時
30 天內合併 PR
9

環境準備

從這裡開始

  1. 先讀完整個 Issue,再讀專案的貢獻指南。
  2. 在 Issue 下留言說明你要接手 —— 這能避免兩個人做同樣的事。
  3. Fork 儲存庫,在一個分支上完成修改。
  4. 送出 Pull Request,並在描述裡引用這個 Issue 編號。

python-rope/rope 的其他 Issue

查看 python-rope/rope 的全部 Issue

相似的 Issue

更多 Python Issue

把新 issue 寄到你的電子郵件信箱

精選適合新手參與的 GitHub issue 摘要。