CubeLang 0.1.4

Domain-specific programming language made for solving twisting cube puzzles

CubeLang

CubeLang is a strongly and statically typed domain-specific procedural programming language created for solving twisting cube puzzles like Rubik's cubes.

---

Installation

CubeLang requires Python 3.6 or newer to functions. For the information on how to install Python, please refer to the download page.

The easiest way to install CubeLang is by using pip. On how to install pip please refer to the manual.

pip install CubeLang

After the installation, cubelang and cubelang-scramble command-line utilities will be available.

Development

For the development of CubeLang clone this repository and install dependencies.

git clone https://github.com/poletaevvlad/CubeLang.git
cd CubeLang
pip install lark-parser termcolor
pip install -r test_requirements.txt

Tests for the interpreter are located in the test directory, tests for the example programs are in the test_examples directory. CubeLang uses pytest for testing.

Examples

There are two example programs written in CubeLang. They are located in the examples directory of the GitHub repository.

The results of executing example programs are shown below.

Beginner's method (3×3×3 cube) @ examples/beginner

Pocket cube (2×2×2 cube) @ examples/pocket-cube

Documentation

You can find the language documentation in the docs directory in the root of this repository.

Documentation consists of the following sections:

Usage @ docs/usage.md
Describes the command line arguments for the interpreter and scrambler utility application.

Variables and types @ docs/types.md
Describes how to define a variable, determine it's scope. Lists data types, supported by CubeLang.

Operators @ docs/operators.md
Lists binary and unary operators supported by CubeLang.

Conditions and loops @ docs/statements.md
Shows the syntax of most execution controlling operators: conditions, loops, and orient operator.

Cube turns and rotations @ docs/actions.md
Shows the syntax of cube turning and rotating commands used by the language and some of the interpreter's command line arguments.

Indexing @ docs/indexing.md
Describes how to access sticker colors of a cube.

Standard library @ docs/stdlib.md
A reference for all functions and constants included in the standard library.

License

This software is licensed under MIT license. Please refer to LICENSE file of this repository for more information.

Copyright © Vlad Poletaev, 2019, 2020