GitPlanet

Cheap and reliable Node.js hosting starts at $3/month, and $1/month static HTML hosting

Created with love in Canada, visit hostnodejs.com today

Feel like to post an Ad? Learn Details
All Projects → antlr → Jetbrains Plugin Sample

antlr / Jetbrains Plugin Sample

Licence: bsd-2-clause
A sample plugin for jetbrains IDEs that uses an ANTLR grammar for a nontrivial custom language.

Programming Languages

java
68154 projects - #9 most used programming language

Sample IntelliJ plugin using ANTLR grammar

This is a demonstration of ANTLRv4 library for IntelliJ plugins, which makes it easy to create plugins for IntelliJ-based IDEs based on an ANTLRv4 grammar.

Running the plugin for the first time

Make sure the Gradle plugin is installed in your IDE, go to File -> Open, select the build.gradle file and choose Open as Project.

If you already imported the project when it was not based on Gradle, then choose the option to delete the existing project and reimport it.

Once the IDE is done downloading dependencies and refreshing the project, you can use the Gradle tool window and use the following Tasks:

  • build > assemble to build the project
  • intellij > runIde to run the plugin in a sandboxed instance

Noteworthy things

Gradle build

The build is based on Gradle, and uses the gradle-intellij-plugin, which makes it easy to:

  • pull dependencies, especially the IntelliJ SDK and antlr4-intellij-adaptor
  • build and run tests in a CI environment on different versions of the SDK
  • generate lexers & parsers from your grammars, thanks to the ANTLR plugin for Gradle
  • publish plugins to the JetBrains Plugins Repository
  • configure the project for occasional contributors 🙂

ANTLRPsiNode

PSI nodes defined in the plugin extend ANTLRPsiNode and IdentifierDefSubtree, which automatically makes them PsiNameIdentifierOwners.

Error highlighting

Errors are shown by SampleExternalAnnotator, which makes use of org.antlr.intellij.adaptor.xpath.XPath to detect references to unknown functions.

ParserDefinition

SampleParserDefinition uses several handy classes from the adaptor library:

  • PSIElementTypeFactory to generate IElementTypes from tokens and rules defined in your ANTLRv4 grammar
  • ANTLRLexerAdaptor to bind generated lexers to a com.intellij.lexer.Lexer
  • ANTLRParserAdaptor to bind generated parsers to a com.intellij.lang.PsiParser

Misc

WARNING. Turn on Dragon speech recognition for Mac and do a rename. GUI deadlocks. Every time. Turn off dragon. No problem ever. See JetBrains forum.

Note that the project description data, including the texts, logos, images, and/or trademarks, for each open source project belongs to its rightful owner. If you wish to add or remove any projects, please contact us at [email protected].