Sandboxes

Sandboxes / starters for different languages

It is useful for skipping most of the set-up phase ⏩ to :

• do a kata / exercise 🥋
• start a project 🏗️
• test something in an isolated environment 🧫

What is in the box ? 📦

• With a focus on reproducibility

  It is possible to use it without Nix, but reproducibility cannot be guaranteed as you may have installed an incompatible version

• Always with sample code 🧩

• Always with tests 🧪

• Trying to use standard tools depending on the ecosystem 🧰

• Trying to have a formatter 🪄

• Trying to have a linter 🔎

Usage

Online with GitPod

On you own machine

Requirements

• Install Nix
  • Preferably with nix-installer
• Install DirEnv
• Install Git

List sandboxes

export NIX_CONFIG='extra-experimental-features = flakes nix-command'
nix run 'gitlab:pinage404/nix-sandboxes'

Get one sandbox

e.g. for Rust

export NIX_CONFIG='extra-experimental-features = flakes nix-command'
nix run 'gitlab:pinage404/nix-sandboxes' rust ./your_new_project_directory

Optional steps

VSCode

If you want to use VSCode

1. Install VSCode

2. Open from the command line in the folder

   code .
   

3. Install recommanded extensions

   • Prefer a video ? Watch the video tutorial

Cache

To avoid rebuilding things that have already been built elsewhere, use Cachix

1. Install Cachix

2. Use Nix's cache

   cachix use pinage404-nix-sandboxes
   

Baby steps

If you want to use git-gamble : a tool that blends TDD (Test Driven Development) + TCR (test && commit || revert) to make sure to develop the right thing 😌, baby step by baby step 👶🦶

The tool is already included right out of the box, and tests should pass

git gamble --pass