evy

README

Evy

Evy is a simple programming language, made to learn coding. Try it out.

Evy bridges the gap between block-based languages like Scratch and conventional languages like Python or JavaScript. It has a minimalist syntax with fewer special characters and advanced concepts than most programming languages. Evy has a small set of built-in functions that are easy to understand and remember, but it still is powerful enough for user interaction, games, and animations.

🌱 Getting Started

You can try Evy online at play.evy.dev and browse the examples. Alternatively you can install the evy toolchain locally.

Here is a "hello world" program in Evy

print "Hello World!"

Screencast: How to code a simple animation in Evy.

Animation source code

📖 Documentation

Here are some resources for learning more about Evy:

• Learn and Practise: A guided tour that teaches you programming using Evy.
• Syntax by Example: A collection of examples that illustrate the Evy syntax.
• Built-in Documentation: Details on built-in functions and events in Evy.
• Language Specification: A formal definition of the Evy syntax and language.

For questions and discussions, join the Evy community on Discord.

📦 Installation

You can install the Evy toolchain locally to run it from your command line. To learn how to use the Evy toolchain, read the usage documentation or run evy --help.

Linux and Windows

Download the latest release for your platform, unzip it and add evy to your path.

macOS

Use Homebrew to install evy.

brew install evylang/tap/evy

💻 Development

The Evy interpreter is written in Go and built using the Go and TinyGo compilers. TinyGo targets WebAssembly, which allows Evy source code to be parsed and run in a web browser. The browser runtime is written in plain JavaScript without the use of frameworks.

To build the Evy source code, clone this repository and activate Hermit in your terminal. Then, build the sources with

make all

You can list make targets, execute a full CI run locally or serve the frontend locally with

make help
make ci
make serve

Hermit automatically installs tools.

Hermit

The tools used in this repository, such as Make, Go and Node, are automatically downloaded by Hermit when needed. Hermit ensures that developers on Mac, Linux, and GitHub Actions CI use the same version of the same tools. Cloning this repo is the only installation step necessary.

There are two ways to use the tools in the Evy repository. You can either prefix them with bin/, for example bin/make all. Or, you can activate Hermit in your shell with

. ./bin/activate-hermit

This will add the tools to your path, so you can use them without having to prefix them with bin/.

You can auto-activate Hermit when changing into the evy source directory by installing Hermit shell hooks with

hermit shell-hooks

🙏 Thanks

Evy would not be here today without the help of many people.

• camh: Thank you for your support, guidance, generosity and endless patience.
• Jason: Thank you for donating the Evy website design. It is beautiful!
• @ckaser: Thank you for creating the fantastic easylang language, which was a major inspiration for Evy.
• @fcostin: Thank you for the Splash of Trig sample, your wisdom and your willingness to help.
• @starkcoffee, @alecthomas, @loislambeth: Thank you for your insights, support, and encouragement. I am grateful for your friendship!
• My daughter Mali: Thank you for being keen to learn programming and for testing Evy with me.

Documentation

Overview

Evy parses, runs, and formats Evy source code.

Evy on the command line supports all built-in functions except for graphics functions and event handlers. Only the web interface on play.evy.dev supports graphics and events.

The Evy toolchain has two subcommands: run and fmt.

Usage: evy <command> [flags]

evy is a tool for managing evy source code.

Flags:
  -h, --help       Show context-sensitive help.
  -V, --version    Print version information

Commands:
  run [<source>] [flags]
    Run Evy program.

  fmt [<files> ...] [flags]
    Format Evy files.

  serve export <dir> [flags]
    Export embedded content.

  serve start [flags]
    Start web server, default for "evy serve".

Run "evy <command> --help" for more information on a command.