/ lioness Public

The Lioness Programming Language

# louisdh/lioness

## Folders and files

NameName
Last commit message
Last commit date

## History

464 Commits

### XcodeTemplate.md

Lioness CubSavannaKit

# The Lioness Programming Language

Lioness is a high-level, dynamic, programming language designed for mathematical purposes. This project includes a lexer, parser, compiler and interpreter. All of these are 100% written in Swift without dependencies.

The syntax of Lioness is inspired by Swift, and its feature set is akin to shader languages such as GLSL.

The standard library (abbreviated: stdlib) contains basic functions for number manipulation, including: max/min, ceil, floor, trigonometry, etc. However, more trivial functions, such as to calculate prime numbers, are not considered relevant for the standard library.

## Source examples

The following Lioness code calculates factorials recursively:

```func factorial(x) returns {

if x > 1 {
return x * factorial(x - 1)
}

return 1
}

a = factorial(5) // a = 120```

The following Lioness code uses a `do times` loop:

```a = 1
n = 10
do n times {
a += a
}
// a = 1024```

More examples can be found here.

## Features

• Minimalistic, yet expressive, syntax
• No type system, language is dynamic
• 5 basic operators: `+`, `-`, `/`, `*` and `^`
• `^` means "to the power of", e.g. `2^10` equals 1024
• all operators have a shorthand, e.g. `+=` for `+`
• Numbers
• All numbers are floating point
• Booleans
• Can be evaluated from comparison
• Can be defined by literal: `true` or `false`
• Functions
• Supports parameters, returning and recursion
• Can be declared inside other functions
• Structs
• Can contain any type, including other structs
• Loops
• `for`
• `while`
• `do times`
• `repeat while`
• `break`
• `continue`
• `if` / `else` / `else if` statements

## Running

Since the project does not rely on any dependencies, running it requires no setup.

### macOS

Open `Lioness.xcworkspace` (preferably in the latest non-beta version of Xcode) and run the `macOS Example` target. The example will run the code in `A.lion`. The output will be printed to the console.

## Installing framework

### Using Swift Package Manager

Add to your `Package.swift` file's `dependencies` section:

```.Package(url: "https://github.com/louisdh/lioness.git",
majorVersion: 0, minor: 5)```

### Using CocoaPods

Add the following line to your `Podfile`:

`pod 'Lioness', '~> 0.5'`

### Using Carthage

Add the following line to your `Cartfile`:

`github "louisdh/lioness" ~> 0.5`

Run `carthage update` to build the framework and drag the built `Lioness.framework` into your Xcode project.

## Standard Library

Please note: Lioness is currently in beta

The Standard Library is currently under active development. There currently is no one document with everything from the stdlib. The best place to look for what's available is in the source files.

• Structs
• Completion suggestions (given an incomplete source string and insertion point)
• Breakpoint support in interpreter
• Stdlib documentation (Dash?)
• Compiler warnings
• Compiler optimizations
• Faster Lexer (without regex)
• Support emoticons for identifier names
• `guard` statement
• A lot more unit tests
• Linux support

## Xcode file template

Lioness source files can easily be created with Xcode, see XcodeTemplate.md for instructions.

## Architecture

A detailed explanation of the project's architecture can be found here.

The Lioness Programming Language

0.5.2 Latest
Jul 14, 2017

## Packages 0

No packages published