Skip to content
Friendly Interactive Shell and Expressive Programming Language
Go HTML CSS JavaScript Shell Makefile
Branch: master
Clone or download

Latest commit

xiaq pkg/eval/exc: Rename is-*-error to is-*-exc.
These predicates are for exceptions, not errors. Moreover, Elvish doesn't really
have a concept of errors, only exceptions.

This addresses #208.
Latest commit 65eeda9 May 31, 2020

Files

Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
cmd cmd/website/macros: Small refactors. Apr 27, 2020
pkg pkg/eval/exc: Rename is-*-error to is-*-exc. May 31, 2020
tools Deploy to bintray from Cirrus CI, and remove Travis config. Apr 3, 2020
website pkg/eval: Support passing any value to "fail". May 31, 2020
.appveyor.yml .appveyor.yml: Reintroduce an install script. Apr 5, 2020
.cirrus.yml .cirrus.yml: Do not fail skipped coverage script. Apr 14, 2020
.dockerignore Update .dockerignore. Oct 16, 2018
.gitattributes Use .gitattributes to filter go sources through goimports Feb 10, 2014
.gitignore Makefile: _cover/ -> cover/. Dec 23, 2019
CONTRIBUTING.md Update CONTRIBUTING.md, and add a NEXT-RELEASE.md symlink. May 31, 2020
Dockerfile Update Dockerfile. Oct 22, 2018
LICENSE Project rename: das -> elvish Jan 29, 2014
Makefile Deploy to bintray from Cirrus CI, and remove Travis config. Apr 3, 2020
NEXT-RELEASE.md Update CONTRIBUTING.md, and add a NEXT-RELEASE.md symlink. May 31, 2020
README.md README.md: Remove the license badge. Apr 4, 2020
go.mod Upgrade dependencies. Mar 25, 2020
go.sum Upgrade dependencies. Mar 25, 2020
main.go Drop the web subprogram from the main program. Apr 24, 2020

README.md

Elvish: Friendly Interactive Shell and Expressive Programming Language

Test Status on Linux Test Status on macOS Test Status on FreeBSD Test status on Windows Test Coverage Go Report Card GoDoc Twitter

Elvish is a friendly interactive shell and an expressive programming language. It runs on Linux, BSDs, macOS and Windows. Despite its pre-1.0 status, it is already suitable for most daily interactive use.

Visit the official website https://elv.sh for prebuilt binaries, blog posts, documentation and other resources.

User groups (all connected with matterbridge): Gitter Telegram Group #elvish on freenode #elvish:matrix.org

Building Elvish

Most users can just use prebuilt binaries and do not need to build from source.

To build Elvish from source, you need

  • A supported OS: Linux, {Free,Net,Open}BSD, macOS, or Windows.

    NOTE: Windows support is experimental, and only Windows 10 is supported.

  • Go >= 1.13.

To build Elvish from source, follow these steps:

# 1. Start from any directory you want to store Elvish's source code
# 2. Clone the Git repository
git clone https://github.com/elves/elvish
# 3. Change into the repository
cd elvish
# 4. Build and install Elvish
make get

This will install Elvish to ~/go/bin.

Alternatively, you can also just use go get to install Elvish:

go get -u github.com/elves/elvish

This will clone the Git repository to ~/go/src/github.com/elves/elvish, updating it if already exists, and install Elvish to ~/go/bin. However, Elvish built this way will lack version information, although it is otherwise fully functional.

Some tips on installation:

  • Remember to add $HOME/go/bin to your PATH so that you can run elvish directly.

  • If you want to install Elvish to a different place, follow these steps to set GOPATH, and Elvish will be installed to $GOPATH/bin instead.

Contributing to Elvish

See CONTRIBUTING.md for more notes for contributors.

You can’t perform that action at this time.