beef331 / website

Code for the official Nim programming language website
https://nim-lang.org
19 stars 1 forks source link

grab #42

Closed metagn closed 2 years ago

metagn commented 2 years ago

Name: grab

Author: metagn

Posting:

Adds a grab statement for installing and importing Nimble packages directly through Nim code, similar to Groovy's Grape and @Grab. Works with NimScript, as all the computation is done at compile time.

This installs the package globally, and can affect compilation time. For this reason it should generally only be used for scripts and snippets and the like.

import grab

# install the package `regex` if not installed already, and import it
grab "regex"

assert "abc.123".match(re"\w+\.\d+")

# run install command with the given arguments
grab package("-y https://github.com/arnetheduck/nim-result@#HEAD",
             name = "result", forceInstall = true): # clarify package name to correctly query path
  # imports from the package directory
  import results

func works(): Result[int, string] =
  result.ok(123)

func fails(): Result[int, string] =
  result.err("abc")

assert works().isOk
assert fails().error == "abc"

Install with:

nimble install grab