What tools do you use when developing Janet?

[tupini07]

Hi all! I've recently started playing around with Janet and I've been pleasantly surprised by how easy it is to express myself with it!

I'm currently using NeoVim with https://github.com/Olical/conjure/ as my IDE, and find that the workflow is great, although I do miss the fact that I'm not getting autocomplete for symbols I define 😢 (though this might be because of a misconfiguration on my part).

Anyway, I saw that on Janet's homepage there's a list of supported editors and plugins, and that got me wondering: what is the most popular development environment for other folks when it comes to Janet?

[sogaiu]

Janet Tools / Resources

What follows is a grouped write-up of some Janet tools / resources I'm aware of.

Editor

Neovim/Vim

The general sense I get from following the channels is that most folks use Neovim/Vim. I think most of them use Conjure.

Emacs

For Emacs I know there are a few users (including me). There is more than one major mode for Janet:

• ALSchwalm's janet-mode
• Ruin0x11's janet-mode

and there are forks of both of these (presumably because the upstream maintainers are busy or some other reason).

Update: There is also a work-in-progress tree-sitter-based major mode.

Apart from the major modes, there are at least 3 modes for repl interaction:

• ijanet-mode
• inf-janet
• ajrepl

There is also an auxilliary package (janet-editor-elf) that provides some goodies.

Overall, it's not a one-stop-shop sort of situation for Emacs + Janet.

Kakoune

I know at least one current Kakoune user (along with at least one other person who may or may not still be using Kakoune).

VSCode

I have heard of one person who uses a fok of the VSCode extension.

Other

I know two others who do their own thing entirely. One of them uses and develops freja (which is written mostly in Janet).

Formatting

• jfmt which uses spork/fmt
• jindt which uses jandent (in turn based on spork/fmt, but tries to do a few things differently)

Linting

• janet executable's built-in -k option
• for Kakoune there is jakoune lint from jakoune
• for Emacs there is at least flycheck-janet (I think @ahungry may also have an effort too)

Testing

See this summary.

Docs

• Official docs
• uvtc's Janet Notes and Examples
• Draft Zeal Docset for Janet

Code

Examples

• Janet repository's examples directory
• Janet repository's test directory
• boot.janet
• JanetDocs
• Janet Category at Rosetta Code
• janet-eg (which can use data from JanetDocs)

Collections / Libraries

• The official package listing
• Powered by Janet (though I don't know if it's active recently)
• The 3 lists of repositories of Janet code mentioned here

PEG Examples

• Janet repository's tests
• some of margaret's tests
• a selection of samples from folks' repositories

Miscellaneous

Tree-sitter

There are 2 tree-sitter grammars for Janet (GrayJack's and sogaiu's). This is relevant for at least Neovim and Emacs. For Neovim, the nvim-treesitter project has made a lot of general progress but AFAIK neither Janet grammar has been integrated there. For Emacs, one of the grammars was integrated into elisp-tree-sitter, but IIUC there is a separate effort to integrate tree-sitter into Emacs itself but that effort is still in its infancy and AFAIK almost no languages are supported there ATM.

difftastic has some support for Janet via one of the two grammars.

LSP

There is at least one effort by JohnDoneth. I'm not sure what the status of it is.

[tupini07]

wow thanks a lot for the quick answer and for providing so many details! This is immensely helpful to orient a newcomer to Janet as myself. I really appreciate it, and hopefully your explanation and links will be useful for other folks as well