Struct ide_db::source_change::SourceChangeBuilder

pub struct SourceChangeBuilder {
    pub edit: TextEditBuilder,
    pub file_id: FileId,
    pub source_change: SourceChange,
    pub trigger_signature_help: bool,
    pub mutated_tree: Option<TreeMutator>,
    pub snippet_builder: Option<SnippetBuilder>,
}

Fields

edit: TextEditBuilder

file_id: FileId

source_change: SourceChange

trigger_signature_help: bool

mutated_tree: Option<TreeMutator>

Maps the original, immutable SyntaxNode to a clone_for_update twin.

snippet_builder: Option<SnippetBuilder>

Keeps track of where to place snippets

Implementations

impl SourceChangeBuilder

pub fn new(file_id: FileId) -> SourceChangeBuilder

pub fn edit_file(&mut self, file_id: FileId)

pub fn make_mut<N: AstNode>(&mut self, node: N) -> N

pub fn make_syntax_mut(&mut self, node: SyntaxNode) -> SyntaxNode

Returns a copy of the node, suitable for mutation.

Syntax trees in rust-analyzer are typically immutable, and mutating operations panic at runtime. However, it is possible to make a copy of the tree and mutate the copy freely. Mutation is based on interior mutability, and different nodes in the same tree see the same mutations.

The typical pattern for an assist is to find specific nodes in the read phase, and then get their mutable counterparts using make_mut in the mutable state.

pub fn delete(&mut self, range: TextRange)

Remove specified range of text.

pub fn insert(&mut self, offset: TextSize, text: impl Into<String>)

Append specified text at the given offset

pub fn replace(&mut self, range: TextRange, replace_with: impl Into<String>)

Replaces specified range of text with a given string.

pub fn replace_ast<N: AstNode>(&mut self, old: N, new: N)

pub fn create_file(&mut self, dst: AnchoredPathBuf, content: impl Into<String>)

pub fn move_file(&mut self, src: FileId, dst: AnchoredPathBuf)

pub fn trigger_signature_help(&mut self)

pub fn add_tabstop_before(&mut self, _cap: SnippetCap, node: impl AstNode)

Adds a tabstop snippet to place the cursor before node

pub fn add_tabstop_after(&mut self, _cap: SnippetCap, node: impl AstNode)

Adds a tabstop snippet to place the cursor after node

pub fn add_tabstop_before_token(&mut self, _cap: SnippetCap, token: SyntaxToken)

Adds a tabstop snippet to place the cursor before token

pub fn add_tabstop_after_token(&mut self, _cap: SnippetCap, token: SyntaxToken)

Adds a tabstop snippet to place the cursor after token

pub fn add_placeholder_snippet(&mut self, _cap: SnippetCap, node: impl AstNode)

Adds a snippet to move the cursor selected over node

pub fn add_placeholder_snippet_group( &mut self, _cap: SnippetCap, nodes: Vec<SyntaxNode> )

Adds a snippet to move the cursor selected over nodes

This allows for renaming newly generated items without having to go through a separate rename step.

pub fn finish(self) -> SourceChange