Skip to content

Latest commit

 

History

History
101 lines (56 loc) · 2.98 KB

dev-tools.md

File metadata and controls

101 lines (56 loc) · 2.98 KB
Raw

Development Tools

REPL

The REPL is all you need to do your first steps with Venice.

For more ambitious work choose Gitpod or VSCodium.

Gitpod

Start a Venice Gitpod workspace in your browser

Fire up a Venice Gitpod workspace in your browser by opening the URL https://gitpod.io/#https://github.com/jlangch/venice. Gitpod will ask you to login to GitHub and will launch a Venice workspace container for you in the cloud, containing a full Linux environment. It will also clone the Venice repository and build it. If you don't have a GitHub login yet, please sign up for GitHub.

Gitpod gives you a full development environment and a REPL within your browser without needing to install anything on your local machine.

Useful VSCode extensions

VSCode settings.json

{
    "files.associations": {
        "*.venice": "clojure"
    },
    
    "workbench.colorTheme": "Tomorrow Night Blue",
    "redhat.telemetry.enabled": false    
    
    "editor.insertSpaces": true,
    "editor.tabSize": 2,
    "editor.detectIndentation": false,
    "editor.rulers": [80, {"column": 100, "color": "#ffcc00"}]   
}

VSCodium

VSCodium is a community-driven, fully open-source project derived from the VS Code source code.

5 reason to choose VSCodium:

1. VSCodium is fully open-source
2. VSCodium looks and works exactly like VS Code
3. VSCodium doesn’t have proprietary extensions
4. VSCodium doesn’t track your activity (disabled telemetry by default)
5. VSCodium supports VS Code extensions

VSCodium uses Open VSX Registry as its marketplace.

Tips to start with

Adjust VSCodium "settings.json" to support Venice files

You can open the settings.json file with the Preferences: Open User Settings (JSON) command in the Command Palette (Ctrl+Shift+P). Once the file is open in an editor add these lines:

{
    "files.associations": {
        "*.venice": "clojure"
    },
    
    "workbench.colorTheme": "Tomorrow Night Blue",
    
    "editor.insertSpaces": true,
    "editor.tabSize": 2,
    "editor.detectIndentation": false,
    "editor.rulers": [80, {"column": 100, "color": "#ffcc00"}]   
}

and save the file.

MacOS: Set VSCodium as the default app for ".venice" and ".json" files

  1. Select a Venice or Json file in the Finder and choose File > Get Info
  2. In the Open With section select VSCodium and click Change All and confirm.

Formatting

You can format a JSON document using ⇧⌥F or "Format Document" from the context menu.