"yes, I'm the creator" -- Araq, 2013-07-26 19:28:32.

Nim differs from many other compilers in that it is really fast, and being so fast makes it suited to provide external queries for text editors about the source code being written. Through the idetools command of the compiler, any IDE can query a .nim source file and obtain useful information like definition of symbols or suggestions for completion.

This document will guide you through the available options. If you want to look at practical examples of idetools support you can look at the test files found in the Test suite or various editor integrations already available.

Idetools invocation

Specifying the location of the query

All of the available idetools commands require you to specify a query location through the --track or --trackDirty switches. The general idetools invocations are:

nim idetools --track:FILE,LINE,COL <switches> proj.nim

Or:

nim idetools --trackDirty:DIRTY_FILE,FILE,LINE,COL <switches> proj.nim