3a3b8f5700
The PureEvaler abstraction made things unnecessarily complex; it's better to just create a real Evaler for tests is pretty. The Evaler has a new ReplaceBuiltin method to make it easier to construct the expected test result. |
||
|---|---|---|
| .github/workflows | ||
| cmd | ||
| pkg | ||
| tools | ||
| website | ||
| .cirrus.yml | ||
| .codecov.yml | ||
| .codespellrc | ||
| .dockerignore | ||
| .gitattributes | ||
| .gitignore | ||
| .gitlab-ci.yml | ||
| .prettierrc | ||
| 0.19.0-release-notes.md | ||
| CONTRIBUTING.md | ||
| Dockerfile | ||
| go.mod | ||
| go.sum | ||
| LICENSE | ||
| Makefile | ||
| PACKAGING.md | ||
| README.md | ||
| SECURITY.md | ||
Elvish: Expressive Programming Language + Versatile Interactive Shell
Elvish is an expressive programming language and a versatile interactive shell, combined into one seamless package. It runs on Linux, BSDs, macOS and Windows.
Despite its pre-1.0 status, it is already suitable for most daily interactive use.
User groups (all connected thanks to Matrix):
Documentation
Documentation for Elvish lives on the official website https://elv.sh, including:
-
Reference docs, including the language reference, the
elvishcommand, and all the modules in the standard library -
Blog posts, including release notes
The source for the documentation is in the website directory.
Building Elvish
Most users do not need to build Elvish from source. Prebuilt binaries for the latest commit are provided for Linux amd64, macOS amd64, macOS arm64, Windows amd64 and many other platforms.
To build Elvish from source, you need
-
A supported OS: Linux, {Free,Net,Open}BSD, macOS, or Windows 10.
NOTE: Windows 10 support is experimental.
-
Go >= 1.18.
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 $GOBIN, which defaults to $GOPATH/bin or
~/go/bin if $GOPATH is not set.
To install it elsewhere, override ELVISH_MAKE_BIN in the make command:
make get ELVISH_MAKE_BIN=./elvish # Install to the repo root
make get ELVISH_MAKE_BIN=/usr/local/bin/elvish # Install to /usr/local/bin
Experimental plugin support
Elvish has experimental support for building and importing plugins, modules written in Go.
However, since plugin support relies on dynamic linking, it is not enabled in the official prebuilt binaries. You need to build Elvish from source, and make sure that CGo is enabled:
make get CGO_ENABLED=1
To build a plugin, see this example.
Packaging Elvish
See PACKAGING.md for notes for packagers.
Contributing to Elvish
See CONTRIBUTING.md for notes for contributors.