| nixos-options | helm-nixos-options | ivy-nixos-options | company-nixos-options | nix-sandbox | | [[http://melpa.org/#/nixos-options][http://melpa.org/packages/nixos-options-badge.svg]] | [[http://melpa.org/#/helm-nixos-options][http://melpa.org/packages/helm-nixos-options-badge.svg]] | [[http://melpa.org/packages/ivy-nixos-options-badge.svg]] | [[http://melpa.org/#/company-nixos-options][http://melpa.org/packages/company-nixos-options-badge.svg]] | [[https://melpa.org/#/nix-sandbox][file:https://melpa.org/packages/nix-sandbox-badge.svg]] |
[[https://gitter.im/travisbhartwell/nix-emacs?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge][https://badges.gitter.im/Join Chat.svg]] [[https://www.waffle.io/travisbhartwell/nix-emacs][https://badge.waffle.io/travisbhartwell/nix-emacs.svg]]
** Usage
*** helm-nixos-options
The function =helm-nixos-options= is the one that you want to bind. You are free to choose where and if you want it global you can have this.
(global-set-key (kbd "C-c C-S-n") 'helm-nixos-options)
It looks like this
[[file:img/helm-nixos-options-candidates.png]]
The description of the option is shown in the minibuffer
If you want more information, there is a detailed buffer when you press =return=
[[file:img/helm-nixos-options-doc-buffer.png]]
There are also other actions like inserting the current match into the buffer
[[file:img/helm-nixos-options.gif]]
*** ivy-nixos-options
Use this if you don't want the rather heavy =helm= dependency. The function =ivy-nixos-options= is the one that you want to bind. You are free to choose where and if you want it global you can have this.
(global-set-key (kbd "C-c C-S-n") 'ivy-nixos-options)
(setq ivy-nixos-options-default 1) ; defines what function is being called when pressing return. I like to have it set to 2 ; All of the actions can always be called when pressing M-o ; 1 = show the docs buffer (default) ; 2 = insert the string ; 3 = only show the description of the command
It looks like this
[[file:img/ivy-nixos-options-candidates.png]]
If you want more information, there is a detailed buffer when you press =return=
[[file:img/ivy-nixos-options-doc-buffer.png]]
There are also other actions like inserting the current match into the buffer. The builtin help menu from ivy (display with =M-o=) shows all possible options. e.g. =M-o i= will insert the option
[[file:img/ivy-nixos-options-actions.png]]
*** company-nixos-options
Add company-nixos-options to allowed company-mode backends list
(add-to-list 'company-backends 'company-nixos-options)
For now it shows the documentation of the option in a popup-buffer.
[[file:img/company-nixos-options.gif]]
*** nix-sandbox
Utility functions to work with nix sandboxes.
**** Flycheck
With this configuration [[http://www.flycheck.org/][flycheck]] can find executables of checkers that would be only accessible via =nix-shell=:
(setq flycheck-command-wrapper-function (lambda (command) (apply 'nix-shell-command (nix-current-sandbox) command)) flycheck-executable-find (lambda (cmd) (nix-executable-find (nix-current-sandbox) cmd)))
**** Haskell Mode
Add these lines to your configuration to allow [[https://github.com/haskell/haskell-mode][haskell-mode]] to look for =ghc= in the current sandbox.
(setq haskell-process-wrapper-function (lambda (args) (apply 'nix-shell-command (nix-current-sandbox) args)))