Scry

Scry is a code analysis server for Crystal. It is an implementation of a common language protocol. It is being built as a server for VSCode, but is compatible with any client that implements this protocol.

The server is implemented in Crystal.

Installation

To install Scry download it from the releases page or compile the latest version using:

Note: Crystal is required in order to compile Scry.

git clone https://github.com/crystal-lang-tools/scry.git
cd scry
shards build --verbose --release

Then, set your LSP client's scry binary path to point to scry/bin/scry.

Known issues

• Completion feature is still experimental.
• Unexpected diagnostics can appear on files using implicit require, try using explicit require at top of your files.
• Go to definition only works for some methods and variables. Go to classes or macros definition is not supported yet.
• Symbol listing works per file, searching for workspace symbols is not supported yet.

Roadmap

Ongoing, in our free time.

The goal is to implement all of the currently supported Language Server features.

• Completion (WIP): compute completion items at a given cursor position.
• Diagnostics (WIP): provides problem detection for text document.
• Document Formatting (WIP): this includes formatting of whole documents, document ranges and formatting on type.
• Goto Definition: (WIP) provides go to definition support for a symbol selected in a text document.
• Document Highlights: highlights all 'equal' symbols in a text document.
• Hover: provides hover information for a symbol selected in a text document.
• Signature Help: provides signature help for a symbol selected in a text document.
• Find References: finds all project-wide references for a symbol selected in a text document.
• List Document Symbols: (WIP) lists all symbols defined in a text document.
• List Workspace Symbols: (WIP) lists all project-wide symbols.
• Code Actions: compute commands for a given text document and range.
• CodeLens: compute CodeLens statistics for a given text document. (OK, maybe not this one)
• rename: project-wide rename of a symbol.

Contributing

1. Fork it https://github.com/crystal-lang-tools/scry/fork
2. Create your feature branch git checkout -b my-new-feature
3. Commit your changes git commit -am 'Add some feature'
4. Push to the branch git push origin my-new-feature
5. Create a new Pull Request

Contributors

• @kofno Ryan L. Bell - creator, maintainer
• @keplersj Kepler Sticka-Jones - contributor
• @faustinoaq Faustino Aguilar - contributor
• @laginha87 Filipe Correia - contributor
• @bmulvihill Bryan Mulvihill - contributor

See all of Scry's contributors