Changelog #98

Author: lnicola

generated_assists.adoc

@@ -762,6 +762,32 @@ fn foo<T: Copy + Clone>() { }
 ```
 
 
+[discrete]
+=== `generate_constant`
+**Source:** https://github.com/rust-analyzer/rust-analyzer/blob/master/crates/ide_assists/src/handlers/generate_constant.rs#L12[generate_constant.rs]
+
+Generate a named constant.
+
+.Before
+```rust
+struct S { i: usize }
+impl S { pub fn new(n: usize) {} }
+fn main() {
+    let v = S::new(CAPA┃CITY);
+}
+```
+
+.After
+```rust
+struct S { i: usize }
+impl S { pub fn new(n: usize) {} }
+fn main() {
+    const CAPACITY: usize = ┃;
+    let v = S::new(CAPACITY);
+}
+```
+
+
 [discrete]
 === `generate_default_from_enum_variant`
 **Source:** https://github.com/rust-analyzer/rust-analyzer/blob/master/crates/ide_assists/src/handlers/generate_default_from_enum_variant.rs#L6[generate_default_from_enum_variant.rs]
@@ -1206,7 +1232,7 @@ impl Person {
 
 [discrete]
 === `inline_call`
-**Source:** https://github.com/rust-analyzer/rust-analyzer/blob/master/crates/ide_assists/src/handlers/inline_call.rs#L156[inline_call.rs]
+**Source:** https://github.com/rust-analyzer/rust-analyzer/blob/master/crates/ide_assists/src/handlers/inline_call.rs#L155[inline_call.rs]
 
 Inlines a function or method body creating a `let` statement per parameter unless the parameter
 can be inlined. The parameter will be inlined either if it the supplied argument is a simple local
@@ -1999,6 +2025,30 @@ fn main() {
 ```
 
 
+[discrete]
+=== `replace_try_expr_with_match`
+**Source:** https://github.com/rust-analyzer/rust-analyzer/blob/master/crates/ide_assists/src/handlers/replace_try_expr_with_match.rs#L18[replace_try_expr_with_match.rs]
+
+Replaces a `try` expression with a `match` expression.
+
+.Before
+```rust
+fn handle() {
+    let pat = Some(true)┃?;
+}
+```
+
+.After
+```rust
+fn handle() {
+    let pat = match Some(true) {
+        Some(it) => it,
+        None => return None,
+    };
+}
+```
+
+
 [discrete]
 === `sort_items`
 **Source:** https://github.com/rust-analyzer/rust-analyzer/blob/master/crates/ide_assists/src/handlers/sort_items.rs#L12[sort_items.rs]

generated_config.adoc

@@ -136,6 +136,11 @@ Only applies when `#rust-analyzer.completion.addCallParenthesis#` is set.
 --
 Whether to add parenthesis when completing functions.
 --
+[[rust-analyzer.completion.snippets]]rust-analyzer.completion.snippets (default: `{}`)::
++
+--
+Custom completion snippets.
+--
 [[rust-analyzer.completion.postfix.enable]]rust-analyzer.completion.postfix.enable (default: `true`)::
 +
 --
@@ -355,8 +360,14 @@ Whether to show `Method References` lens. Only applies when
 [[rust-analyzer.lens.references]]rust-analyzer.lens.references (default: `false`)::
 +
 --
-Whether to show `References` lens. Only applies when
-`#rust-analyzer.lens.enable#` is set.
+Whether to show `References` lens for Struct, Enum, Union and Trait.
+Only applies when `#rust-analyzer.lens.enable#` is set.
+--
+[[rust-analyzer.lens.enumVariantReferences]]rust-analyzer.lens.enumVariantReferences (default: `false`)::
++
+--
+Whether to show `References` lens for Enum Variants.
+Only applies when `#rust-analyzer.lens.enable#` is set.
 --
 [[rust-analyzer.lens.forceCustomCommands]]rust-analyzer.lens.forceCustomCommands (default: `true`)::
 +

generated_diagnostic.adoc

@@ -31,7 +31,7 @@ This diagnostic is shown for macro expansion errors.
 
 
 === mismatched-arg-count
-**Source:** https://github.com/rust-analyzer/rust-analyzer/blob/master/crates/ide_diagnostics/src/handlers/mismatched_arg_count.rs#L3[mismatched_arg_count.rs]
+**Source:** https://github.com/rust-analyzer/rust-analyzer/blob/master/crates/ide_diagnostics/src/handlers/mismatched_arg_count.rs#L10[mismatched_arg_count.rs]
 
 This diagnostic is triggered if a function is invoked with an incorrect amount of arguments.
 

generated_features.adoc

@@ -376,7 +376,7 @@ image::https://user-images.githubusercontent.com/48062697/113020661-b6922200-917
 
 
 === Magic Completions
-**Source:** https://github.com/rust-analyzer/rust-analyzer/blob/master/crates/ide_completion/src/lib.rs#L33[lib.rs]
+**Source:** https://github.com/rust-analyzer/rust-analyzer/blob/master/crates/ide_completion/src/lib.rs#L37[lib.rs]
 
 In addition to usual reference completion, rust-analyzer provides some ✨magic✨
 completions as well:
@@ -447,7 +447,7 @@ image::https://user-images.githubusercontent.com/48062697/113065573-04298180-91b
 
 
 === Memory Usage
-**Source:** https://github.com/rust-analyzer/rust-analyzer/blob/master/crates/ide_db/src/apply_change.rs#L67[apply_change.rs]
+**Source:** https://github.com/rust-analyzer/rust-analyzer/blob/master/crates/ide_db/src/apply_change.rs#L41[apply_change.rs]
 
 Clears rust-analyzer's internal database and prints memory usage statistics.
 
@@ -798,6 +798,59 @@ be parsed as a valid structural search and replace rule.
 ```
 
 
+=== User Snippet Completions
+**Source:** https://github.com/rust-analyzer/rust-analyzer/blob/master/crates/ide_completion/src/snippet.rs#L5[snippet.rs]
+
+rust-analyzer allows the user to define custom (postfix)-snippets that may depend on items to be accessible for the current scope to be applicable.
+
+A custom snippet can be defined by adding it to the `rust-analyzer.completion.snippets` object respectively.
+
+[source,json]
+----
+{
+  "rust-analyzer.completion.snippets": {
+    "thread spawn": {
+      "prefix": ["spawn", "tspawn"],
+      "body": [
+        "thread::spawn(move || {",
+        "\t$0",
+        ")};",
+      ],
+      "description": "Insert a thread::spawn call",
+      "requires": "std::thread",
+      "scope": "expr",
+    }
+  }
+}
+----
+
+In the example above:
+
+* `"thread spawn"` is the name of the snippet.
+
+* `prefix` defines one or more trigger words that will trigger the snippets completion.
+Using `postfix` will instead create a postfix snippet.
+
+* `body` is one or more lines of content joined via newlines for the final output.
+
+* `description` is an optional description of the snippet, if unset the snippet name will be used.
+
+* `requires` is an optional list of item paths that have to be resolvable in the current crate where the completion is rendered.
+On failure of resolution the snippet won't be applicable, otherwise the snippet will insert an import for the items on insertion if
+the items aren't yet in scope.
+
+* `scope` is an optional filter for when the snippet should be applicable. Possible values are:
+** for Snippet-Scopes: `expr`, `item` (default: `item`)
+** for Postfix-Snippet-Scopes: `expr`, `type` (default: `expr`)
+
+The `body` field also has access to placeholders as visible in the example as `$0`.
+These placeholders take the form of `$number` or `${number:placeholder_text}` which can be traversed as tabstop in ascending order starting from 1,
+with `$0` being a special case that always comes last.
+
+There is also a special placeholder, `${receiver}`, which will be replaced by the receiver expression for postfix snippets, or nothing in case of normal snippets.
+It does not act as a tabstop.
+
+
 === View Crate Graph
 **Source:** https://github.com/rust-analyzer/rust-analyzer/blob/master/crates/ide/src/view_crate_graph.rs#L10[view_crate_graph.rs]
 

thisweek/_posts/2021-10-11-changelog-98.adoc

@@ -0,0 +1,47 @@
+= Changelog #98
+:sectanchors:
+:page-layout: post
+
+Commit: commit:ed4b312fa777ebb39ba1348fe3df574c441a485e[] +
+Release: release:2021-10-11[]
+
+== Sponsors
+
+**Become a sponsor:** On https://opencollective.com/rust-analyzer/[OpenCollective] or
+https://github.com/sponsors/rust-analyzer[GitHub Sponsors].
+
+== New Features
+
+* pr:10476[] (first contribution) add `replace_try_expr_with_match` assist:
++
+image::https://user-images.githubusercontent.com/308347/136434480-f0ae5b34-36cb-4bbf-98ca-4b77b58482e1.gif[]
+* pr:10447[] (first contribution) implement enum variant code lens:
++
+image::https://user-images.githubusercontent.com/308347/136690713-9eb5f108-af80-41c3-86e2-8250b6ef9a40.gif[]
+* pr:10458[] implement custom user snippets:
++
+image::https://user-images.githubusercontent.com/3757771/136059454-ceccfc2c-2c90-46da-8ad1-bac9c2e83ec1.gif[]
+* pr:10459[] add "Generate constant" assist:
++
+image::https://user-images.githubusercontent.com/13777628/135885262-c80de86f-5555-4f84-9508-822243f8a876.gif[]
+* pr:10474[] support `let...else`.
+* pr:10499[] make "mismatched arggument counts" diagnostic range more precise.
+
+== Fixes
+
+* pr:10479[] fix index out of bounds panic in name resolution.
+* pr:10456[] avoid cycle when lowering predicates for associated item lookup.
+* pr:10482[] fix `inline_call` trying to use an uncached syntax node in `Semantics`.
+* pr:10460[] only add `proc_macro` to prelude in proc-macro crates.
+* pr:10477[] fix parsing of macro call inside generic args.
+* pr:10449[] fix parsing of `Some(1..)`.
+* pr:10420[] parse outer attributes on `StructPatternEtCetera`.
+* pr:10480[] change snake case fix to match rustc implementation.
+
+== Internal Improvements
+
+* pr:10504[] (first contribution) remove needless clones
+* pr:10467[] optimize code lens for references and implementations.
+* pr:10494[], pr:10495[], pr:10496[], pr:10497[], pr:10501[], pr:10507[], pr:10508[], pr:10509[], pr:10510[], pr:10512[], pr:10514[] start new macro test suite
+* pr:10457[] remove support for pre-1.47 sysroots.
+* pr:10440[] fix Clippy warnings and replace some ``if let``s with `match`.