charly v0.3.0

🐈 The Charly Programming Language | Written by @KCreate
  • v0.3.0 - February 11, 2017
  • v0.2.0 - January 2, 2017
  • v0.0.1 - October 15, 2016

Build Status Version License


Warning: This project is no longer being actively maintained. You can find the new project at KCreate/charly-vm

The Charly programming language

Charly is a dynamic, weakly-typed multi-paradigm programming language. This repository contains a Crystal implementation of the language.

Motivation and Goals

I've always been interested in the development and design of new programming languages. This is my first try at writing an actual language. My primary goal was to learn how to teach a machine what my language looks like and what it should do. Based on the experiences I've made while working on Charly, I now feel comfortable to experiment with lower-level technology such as virtual machines or compilers.

This implementation uses a tree-based execution model, which is (as opposed to a bytecode interpreter) rather trivial to implement. Given that I never took any classes or read any books about this topic, it was the easiest way for me to put up a working language. Charly might well switch to a bytecode-interpreter in the future, but only once I've gathered enough experience to feel comfortable with writing a virtual-machine for it.

If you're interested in writing your own programming language, I've compiled a list of resources you may find useful.

Syntax and language guide

Visit the website for an introduction to the language.


  1. Install Crystal
  2. Clone this repo with git clone
  3. Run

You will be prompted for your admin password (used to copy to /usr/local/bin).

After that you need to set the CHARLYDIR environment variable. Just add the following line to your .bashrc, .zshrc, etc. Replace the path with the path to the Charly source code (e.g The path to the git repo).

export CHARLYDIR=~/GitHub/charly-lang/charly

You can also build the interpreter via the following command:

$ mkdir bin
$ crystal build src/ --release -o bin/charly

This will place the executable in the bin folder.

OS Support

I'm developing on macOS 10.12 so it should work without any problems on that. The CI Build runs on Ubuntu 12.04.5 LTS.

CLI options

$ charly -v
Charly 0.3.0 [bb5b857] (15. March 2017)
$ charly -h
Usage: charly [filename] [flags] [arguments]
    -f FLAG, --flag FLAG             Set a flag
    -h, --help                       Print this help message
    -v, --version                    Prints the version number
    --license                        Prints the license

    ast                              Display the AST of the userfile
    dotdump                          Dump dot language displaying the AST
    tokens                           Display tokens of the userfile
    lint                             Don't execute after parsing (linting)

53 internal methods are loaded

Using the built-in REPL

$ charly repl
> 2 + 2
> "test"
> $ * 4
> func increment(a) { a + 1 }
> increment(25)
> print("hello world")
hello world
> .exit

If you need to pass arguments or flags to a REPL session you can do so via the repl command

$ charly repl these are all arguments
[these, are, all, arguments]


github statistic
  • 184
  • 0
  • 6
  • 14
  • 11 days ago
  • September 20, 2016

MIT License

Synced at

Fri, 03 Apr 2020 21:49:37 GMT