https://github.com/inim-repl/INim

Interactive Nim shell / REPL / Playground
https://github.com/inim-repl/INim

nim nim-lang nim-language nimble repl

Last synced: 2 days ago
JSON representation

Interactive Nim shell / REPL / Playground

• Host: GitHub
• URL: https://github.com/inim-repl/INim
• Owner: inim-repl
• License: mit
• Created: 2018-02-18T16:53:08.000Z (over 6 years ago)
• Default Branch: master
• Last Pushed: 2024-07-04T17:49:45.000Z (4 months ago)
• Last Synced: 2024-11-14T06:05:02.502Z (2 days ago)
• Topics: nim, nim-lang, nim-language, nimble, repl
• Language: Nim
• Homepage:
• Size: 2.6 MB
• Stars: 643
• Watchers: 20
• Forks: 23
• Open Issues: 28
• Metadata Files:
  • Readme: README.md
  • License: LICENSE
  • Security: SECURITY.md

Awesome Lists containing this project

README

        
# INim: interactive shell (REPL)

![Nim CI](https://github.com/inim-repl/INim/workflows/Nim%20CI/badge.svg)

```

nimble install inim

```



## Features

* Runs on Linux, macOS and Windows

* Auto-indent (`if`, `for`, `proc`, `var`, ...)

* Arrow keys support (command history and line navigation)

* Prints out value and type of discarded expressions: ```>>> x```

* Uses current `nim` compiler in PATH

* Runs in the current directory: `import` your local modules (access to exported* symbols)

* Preload existing source code (access to non-exported* symbols): `inim -s example.nim`

* Optional Colorized output

* Edit lines using $EDITOR (Ctrl-X)

* Built in tools like ipython (cd(), ls(), pwd(), call()) enabled with `--withTools`

* When piped a file or some code, INim will execute that code and exit

* Extra compiler options can be specified by adding them as arguments inim with the -d flag (ie `inim -d:ssl -d:DEBUG`)

* Flags can turned on with `-d` by adding a `--` prefix to arguments (ie -d:--threads:on)

## Configuration

`inim --createRcFile`, for persistent configuration which is loaded from these locations:

* Linux & macOS: `~/.config/inim`

* Windows: `%APPDATA%\inim`

The config allows you to change the defaults for:

* Style

  * `prompt`: Set prompt string (default: "inim> ")

  * `showTypes`: Show var types when printing without echo (default: true)

  * `showColor`: Output results with pretty colors

* History

  * persistent history (default: true)

* Features

  * `withTools`: Enable built in tools

## Contributing

Pull requests and suggestions are welcome.