Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/surrsurus/gazelle

Gazelle - A scripting language inspired by LISP and Scheme
https://github.com/surrsurus/gazelle

deer experiment functional functional-programming haskell interpreter lambda-calculus lisp lisp-interpreter python repl scheme scheme-interpreter scripting-language

Last synced: 3 months ago
JSON representation

Gazelle - A scripting language inspired by LISP and Scheme

Host: GitHub
URL: https://github.com/surrsurus/gazelle
Owner: surrsurus
License: gpl-3.0
Archived: true
Created: 2016-01-27T19:00:47.000Z (almost 9 years ago)
Default Branch: master
Last Pushed: 2018-11-20T15:55:52.000Z (almost 6 years ago)
Last Synced: 2024-05-15T12:47:04.756Z (6 months ago)
Topics: deer, experiment, functional, functional-programming, haskell, interpreter, lambda-calculus, lisp, lisp-interpreter, python, repl, scheme, scheme-interpreter, scripting-language
Language: Python
Homepage:
Size: 96.7 KB
Stars: 11
Watchers: 4
Forks: 0
Open Issues: 3
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md

Awesome Lists containing this project

README

# gazelle [![Build Status](https://travis-ci.org/surrsurus/gazelle.svg?branch=master)](https://travis-ci.org/surrsurus/gazelle) ![Python Version](https://img.shields.io/badge/python-3.6-green.svg) [![License: GPL v3](https://img.shields.io/badge/License-GPL%20v3-blue.svg)](https://www.gnu.org/licenses/gpl-3.0)

Gazelle is a tiny lisp-like scripting language built with Python.

Gazelle is:
- **Easy to setup**
- Have Python? You can run Gazelle. Gazelle requires no external dependencies (that shouldn't be already downloaded)
- **Inspired by LISP and Scheme**
- Gazelle code is written entirely with prefix notation in the form `(procedure expression)`
- Gazelle has no true AST, instead the programmer ends up directly coding the AST for Gazelle to interpret
- Only 3 fundamental types: Atoms, Lists, and Procedures
- **Extendable**
- Adding features to Gazelle is simple and easy through editing the python source or via directly programming in Gazelle itself

Not convinced? Gazelle can be used to write answers to Project Euler questions. Here's problem 1:

```scheme
(return (sum (filter (\ (n) (or (= (% n 5) 0) (= (% n 3) 0))) (range 1000))))
```

## Getting Started

Here's how you can get started programming in Gazelle.

### Prerequisites

Before you can run Gazelle, you'll need to have [Python 3.6](https://www.python.org/downloads/) installed for your respective OS. Then, make sure to download either the [latest release](https://github.com/surrsurus/gazelle/releases) of Gazelle or the latest master.

### Running Gazelle

For more detail, check out the [getting started guide](https://github.com/surrsurus/gazelle/wiki/Getting-Started)

#### Windows

To run the repl, run `python gazelle.py` in the root directory from the commandline.

#### Linux/OSX

To run the repl on linux/OSX, you can run `python3 gazelle.py` in the root directory of Gazelle.

### Basic Usage

The Gazelle REPL provides all the basic utility you need to begin toying with it.

In addition, files can be ran by using a file path as your argument such as `python gazelle.py ./example/euler/one.gel` and files can be run in succession such as `python gazelle.py ./example/euler/one.gel ./example/euler/two.gel`

### Running the Tests

First, install the testing requirements.

```
$ pip install -r requirements.txt
```

To run the tests, run `pytest tests/testsuite.py` from the root directory. This will start the tests and get benchmarking data.

### Code Examples

Take a look at the [getting started guide](https://github.com/surrsurus/gazelle/wiki/Getting-Started) and our [documentation](https://github.com/surrsurus/gazelle/wiki/Documentation) to learn how to code with Gazelle. You can view example programs in the [examples folder](https://github.com/surrsurus/gazelle/tree/master/example) packaged with Gazelle.

## Contributing

Take a look at [this page](https://github.com/surrsurus/gazelle/blob/master/CONTRIBUTING.md) you can contribute to Gazelle.

## License

GPL

This code is released under the GNU GENERAL PUBLIC LICENSE. All works in this repository are meant to be utilized under this license. You are entitled to remix, remodify, and redistribute this program as you see fit, under the condition that all derivative works must use the GPL Version 3.

## Acknowledgements

- Inspiration from [here](http://norvig.com/lispy2.html)
- The original [LISP paper by McCarthy](http://www-formal.stanford.edu/jmc/recursive.html)