nix-ide

Ported from vscode-nix-ide.

Because some APIs of vscode are missing in coc.nvim, disable some features temporarily:

• validate range: miss vscode.document.validateRange()
• rerun linter only when document is dirty: miss vscode.document.isDirty
• open URL of language server: miss vscode.env.openExternal()

Install

• coc-marketplace
• npm
• vim:

" command line
CocInstall coc-nix
" or add the following code to your vimrc
let g:coc_global_extensions = ['coc-nix', 'other coc-plugins']

Adds nix language support for VSCode Editor.

Features

• Syntax Highlight

  • Thanks to https://github.com/wmertens/sublime-nix for the grammar file

  

  • Nix code snippets inside markdown files also work.

  

Language Servers

Full editing support when using a language server. Generally, any nix LSP implementation should work. The following are tested so far:

• nil
• nixd

{
  "nix.enableLanguageServer": true,
  "nix.serverPath": "nil"
  // "nix.serverPath": "nixd"
}

Pass settings to the language server via serverSettings.

{
  "nix.serverSettings": {
    // settings for 'nil' LSP
    "nil": {
      "diagnostics": {
        "ignored": ["unused_binding", "unused_with"]
      },
      "formatting": {
        "command": ["nixpkgs-fmt"]
      }
    }
  }
}

{
    "nix.serverSettings": {
        // settings for 'nixd' LSP
        "nixd": {
            "formatting": {
                "command": [ "nixpkgs-fmt" ]
            },
            "options": {
                // By default, this entriy will be read from `import <nixpkgs> { }`
                // You can write arbitary nix expression here, to produce valid "options" declaration result.
                // Tip: for flake-based configuration, utilize `builtins.getFlake`
                "nixos": {
                    "expr": "(builtins.getFlake \"/absolute/path/to/flake\").nixosConfigurations.<name>.options"
                },
                "home-manager": {
                    "expr": "(builtins.getFlake \"/absolute/path/to/flake\").homeConfigurations.<name>.options"
                }
            }
        }
  }
}

Standalone (No LSP)

When Language Server support is not enabled some tools can still be used.

• Enable formatting support by setting nix.formatterPath to any command which can accept file contents on stdin and return formatted text on stdout; e.g.,

{
  "nix.formatterPath": "nixpkgs-fmt" // default
  // "nix.formatterPath": "nixfmt"
  // "nix.formatterPath": ["treefmt", "--stdin", "{file}"]
  // "nix.formatterPath": ["nix", "fmt", "--", "-"] // using flakes with `formatter = pkgs.alejandra;`
}

• Error Report

  • Using nix-instantiate errors reported

  

• Snippets

Todos

PRs welcome for them

• embedded language syntax support for bash
• path completion - https://github.com/ChristianKohler/PathIntellisense

Installation

Visual Studio Code

Hit F1 and enter the ext install jnoortheen.nix-ide command or search for nix-ide.

*.vsix file

The extension can be downloaded from the release page.

Installing the extension Locally

Just clone the GitHub repository under your local extensions folder:

• Windows: %USERPROFILE%\.vscode\extensions
• Mac / Linux: $HOME/.vscode/extensions

Contributing

• Document the purpose of functions and classes.
• Please mention a new feature in the README.md Features section when adding it. Use screenshots when applicable.
• Conventional Commit style should be used for commit messages as it is used to generate changelog.

Development

There is direnv and nix-shell support so a dev environment can be created with the nix-shell command or a one-time direnv allow at the root of the repo.

Press F5 in VSCode to run an Extension Development Host instance with the extension installed.

TypeScript is used to develop the extension.

yarn install # install dependencies
yarn build   # build the extension

Releasing a new version

• fill .env from .env.template

# this is needed to publish extensions to [openvsx](https://open-vsx.org/) from local machine.
yarn env-cmd

# this will generate changelog and will create a GitHub release. This will also trigger jobs to publish the extension.
yarn release

# to manually publish the extension
yarn publish

Special thanks to

• wmertens for writing the syntax definitions.
• The extension vscode-fish is modified to work for nix .

Links

• Extension page at vscode marketplace
• https://open-vsx.org/extension/jnoortheen/nix-ide