Giter VIP home page Giter VIP logo

nix-env-selector's Introduction

πŸ‡ΊπŸ‡¦ Support Ukraine πŸ‡ΊπŸ‡¦

Hi folks, My name is Roman Valihura. I'm the author of this extension. I'm Ukrainian. I was born in Ukraine. I'm living here at the moment.

As you all know Russia invaded my country. Russia has already killed thousands of civilians and continues the war and terror in Ukraine. I have the luck that my region is pretty far from the frontline. But even here, I'm living in the air-alarm reality. The reality where you should wake up in the middle of the night and go into the shelter. Because a rocket flies over your region.

Like a lot of Ukrainians now I became a volunteer in this hard time for my country. We with a team producing Individual First Aid Kits for the Ukrainian army. If you have a wish and ability to support the activity, you can make a donation on our website, which we made to collect funds for producing First Aid Kits.

More datails on the aidkit.shop

Thank you for your attention!

Nix Environment Selector

nix-env-selector-logo

Extension that lets you use environments declared in .nix files in Visual Studio Code.

Motivation

Nix package manager provides a way of creating isolated environments with a specific configuration of packages. These environments are usually activated in the terminal and are not convenient to use within an IDE.

One option is to run nix-shell on the command line and then launch code within the activated shell. However, this process can quickly become tedious. Nix Environment Selector provides an alternative: can automatically apply the environment.

Getting started

  • Install Nix package manager.
  • Restart VS Code (to make sure that nix-shell is in the PATH)
  • Install the extension.
  • Create the Nix environment config (like default.nix or shell.nix) in the root of your project's workspace.
  • Open Command Palette (Ctrl + Shift + P) and run Nix-Env: Select Environment command.
  • Choose the Nix environment you'd like to apply.
  • Wait for the environment to build.
  • Restart VS Code to apply the built environment.

Example

Haskell project

To run a Haskell application you need to have GHC (Haskell compiler) installed. With Nix package manager we can create an isolated environment containing only the GHC version and the dependencies that the project needs without polluting the user's environment.

Environment configuration in shell.nix:

{ pkgs ? import <nixpkgs> { } }:
with pkgs;

let
  haskellDeps = ps: with ps; [
    base
    lens
    mtl
    random
  ];
  haskellEnv = haskell.packages.ghc865.ghcWithPackages haskellDeps;
in mkShell {
  buildInputs = [
    haskellEnv
    haskellPackages.cabal-install
    gdb
  ];
}

Now let's try to open our project in Visual Studio Code.

Without Env Demo

As you can see VS Code can't find the GHC compiler. Let's apply the environment declared in shell.nix.

With Env Demo

Bingo πŸŽ‰πŸŽ‰πŸŽ‰. Everything is working now 😈

Configuration

You can configure the extension in .vscode/settings.json file (located in the root of the workspace). Here are the configuration settings:

Setting Default Description
nixEnvSelector.nixFile null Path to the Nix config file
nixEnvSelector.packages [] List packages using as -p nix-shell args
nixEnvSelector.args null Custom args string for nix-shell. EX: -A <something> --pure
nixEnvSelector.nixShellPath null Custom path for nix-shell executable

Supported Platforms

  • MacOS
  • Linux
  • Windows (with Remote - WSL extension)

Support

If you like the extension and want to support author, click the button bellow.

donate

License

MIT

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    πŸ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. πŸ“ŠπŸ“ˆπŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❀️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.