42 releases
new 0.9.3 | Apr 2, 2024 |
---|---|
0.9.2 | Mar 18, 2024 |
0.8.23 | Feb 19, 2024 |
0.8.16 | Dec 24, 2023 |
0.3.0 | Mar 19, 2023 |
#1080 in Magic Beans
510 downloads per month
Used in ink-lsp-server
1.5MB
36K
SLoC
ink! Analyzer
A library for semantic analysis of ink! smart contract code.
It implements utilities for performing semantic analysis of ink! smart contract code. It therefore implements the core functionality of ink! analyzer at a high level.
It currently implements an Analysis entry point that accepts a string representation (&str
) of ink! smart contract code as input and defines associated methods that compute:
- diagnostics - errors and warnings based on ink! semantic rules.
- quickfixes - suggested edits/code actions for diagnostic errors and warnings.
- completions - completion suggestions for ink! attribute macros and arguments.
- code/intent actions - contextual assists for adding relevant ink! attribute macros, arguments and entities.
- hover content - descriptive/informational text for ink! attribute macros and arguments.
- inlay hints - inline type and format information for ink! attribute arguments values
(e.g.
u32 | _ | @
for ink! message selectors). - signature help - popup information for valid ink! attribute arguments for the current context/cursor position.
Installation
Run the following Cargo command in your project directory
cargo add ink-analyzer
Usage
Example:
Analyzing ink! smart contract code.
use ink_analyzer::{Analysis, TextSize, TextRange, Version};
fn do_analysis() {
// Smart contract code.
let code = r#"
#[ink::contract]
mod my_contract {
#[ink(storage)]
pub struct MyContract {
value: bool,
}
// --snip--
}
"#;
// Creates analysis snapshot.
let analysis = Analysis::new(code, Version::V4);
// Computes diagnostics.
let diagnostics = analysis.diagnostics();
dbg!(&diagnostics);
// Sets the cursor position.
let position = TextSize::from(9);
// Computes completions.
let completions = analysis.completions(position);
dbg!(&completions);
// Sets the focus range.
let range = TextRange::new(position, TextSize::from(25));
// Computes code/intent actions.
let actions = analysis.actions(range);
dbg!(&actions);
// Gets hover content.
let hover = analysis.hover(range);
dbg!(&hover);
// Computes inlay hints.
let inlay_hints = analysis.inlay_hints(None);
dbg!(&inlay_hints);
// Computes signature help.
let signature_help = analysis.signature_help(TextSize::from(71));
dbg!(&signature_help);
}
fn project_code_stubs() {
// Generates ink! project code stubs/snippets.
let project = ink_analyzer::new_project(String::from("hello_world"), Version::V5);
dbg!(&project);
}
Documentation
https://docs.rs/ink-analyzer/latest/ink_analyzer/
Or you can access documentation locally by running the following command from the project root
cargo doc -p ink-analyzer --open
Testing
You can run unit and integration tests for all the core functionality by running the following command from the project root
cargo test -p ink-analyzer
License
Licensed under either MIT or Apache-2.0 license at your option.
Contribution
Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.
Dependencies
~7–18MB
~227K SLoC