refactoring.nvim

<div align="center">
  <h1>refactoring.nvim</h1>
  <h5>The Refactoring library based off the Refactoring book by Martin Fowler</h5>
  <h6>'If I use an environment that has good automated refactorings, I can trust those refactorings' - Martin Fowler</h6>
</div>

### Tree-sitter and LSP powered refactoring

- Provides refactoring and print-debugging operators (see `:h operator`) powered by LSP and tree-sitter.
- Supports dot-repeat and any textobject/motion.
- Allows fine-grained customization while providing reasonable defaults.

More details on [Features](#features)

---

## Demo

https://github.com/user-attachments/assets/70b15d18-197a-4135-abe0-1fb4a6c06319

## Features

- Inline variable:
  - Inline the definition of the variable under cursor into **all** its references.
  - Requires:
    - LSP server with support for `textDocument/references` and `textDocument/definition`
    - Tree-sitter parser and queries (`refactor_reference` and `refactor_variable`)
- Extract variable:
  - Extract an expression, and **all** its usages in a buffer, into a variable.
  - Requires:
    - Tree-sitter parser and queries (`refactor_scope` and `refactor_output_statement`)
- Inline function:
  - Inline the definition of the function under cursor into **all** its references (only supports functions with a single return statement).
  - Requires:
    - LSP server with support for `textDocument/references` and `textDocument/definition`
    - Tree-sitter parser and queries (`refactor_function` and `refactor_function_call`)
- Extract function:
  - Extract text into a function and replace it with a call to that function.
  - Requires:
    - Tree-sitter parser and queries (`refactor_reference`, `refactor_scope`, `refactor_output_function` and `refactor_input_function`)
- Print location:
  - Inserts a debug print statement with the location under cursor (e.g. `some_function#if#for`).
  - Requires:
    - Tree-sitter parser and queries (`refactor_comment` and `refactor_output_statement`)
- Print variable:
  - Inserts a debug print statement with **all** the variable and locations (e.g. `some_function#if#for`) in the selected range.
  - Requires:
    - Tree-sitter parser and queries (`refactor_comment`, `refactor_reference`, `refactor_output_statement` and `refactor_scope`)
- Print expression:
  - Inserts a debug print statement with the selected expression and location (e.g. `some_function#if#for`).
  - Requires:
    - Tree-sitter parser and queries (`refactor_comment` and `refactor_output_statement`)
- Debug print cleanup:
  - Cleanup the debug print statements in the selected range.
  - Requires:
    - Tree-sitter parser and queries (`refactor_comment`)

> [!NOTE]
> Tree-sitter queries for supported languages are bundled with `refactoring.nvim`

## Installation

`refactoring.nvim` requires Neovim `0.12.5`.

<details>
<summary>With <code>vim.pack</code></summary>

```lua
vim.pack.add {
  -- `async.nvim` is only required for Neovim 0.12. If you are using Neovim 0.13, you do