oplang: Compiler for OpLang, an esoteric programming language
Downloads
- oplang-0.2.0.0.tar.gz [browse] (Cabal source package)
- Package description (as included in the package)
Maintainer's Corner
For package maintainers and hackage trustees
Candidates
| Versions [RSS] | 0.1.0.0, 0.2.0.0, 0.3.0.0, 0.3.0.1, 0.4.0.0, 0.4.0.1, 0.5.0.0 |
|---|---|
| Change log | CHANGELOG.md |
| Dependencies | base (>=4.14 && <5), containers (>=0.6.2 && <0.7), directory (>=1.3.6 && <1.4), filepath (>=1.4.2 && <1.5), megaparsec (>=9.2 && <9.3), mtl (>=2.2.2 && <2.3), optparse-applicative (>=0.16 && <0.17), process (>=1.6.9 && <1.7), text (>=1.2.4 && <1.3), text-builder (>=0.6.6 && <0.7), transformers (>=0.5.6 && <0.6) [details] |
| License | GPL-3.0-only |
| Copyright | Copyright (C) 2019-2022 Alex Ionescu |
| Author | Alex Ionescu |
| Maintainer | alxi.2001@gmail.com |
| Uploaded | by aionescu at 2022-03-19T21:54:43Z |
| Category | Compiler |
| Home page | https://github.com/aionescu/oplang#readme |
| Bug tracker | https://github.com/aionescu/oplang/issues |
| Source repo | head: git clone https://github.com/aionescu/oplang |
| Executables | oplang |
| Downloads | 653 total (29 in the last 30 days) |
| Rating | (no votes yet) [estimated by Bayesian average] |
| Your Rating | |
| Status | Docs not available [build log] Last success reported on 2022-03-19 [all 1 reports] |
Readme for oplang-0.2.0.0
[back to package description]oplang
OpLang is a stack-based esoteric programming language based on Brainfuck.
Installing
The compiler is available on Hackage, and can be installed via cabal.
cabal install oplang
Usage
To compile an OpLang file with default options, use:
oplang code.op
./code.out
For a list of available command-line options, use oplang --help.
Building from source
Prerequisites:
GHC>=8.10cabal>=3.0
(Both can be installed via ghcup)
cabal build
cabal run . -- <args>
Language Features
OpLang is a strict superset of Brainfuck.
Its main improvement is the addition of user-defined operators, which are analogous to user-defined functions in languages like C or Python.
The "memory tape" in OpLang is specific to each operator invocation (akin to the stack space allocated for functions in C), and there is a separate "stack" which persists across operator invocations.
Each cell in the tape(s) and stack is 1 byte, and overflow/underflow is allowed.
The default size of the stack is 4KB, and the default size for each memory tape is 64KB. These can be modified via the command-line.
Syntax
OpLang has 10 "intrinsic" operators, 8 of which are the Brainfuck operators, with the same semantics:
+: Increment the current cell-: Decrement the current cell<: Move the current cell pointer to the left>: Move the current cell pointer to the right,: Read a character from stdin and store its ASCII value in the current cell.: Interpret the current cell as an ASCII character and print it to stdout[: Begin a loop (i.e. if the value at the current cell is zero, jump to the next])]: End a loop (i.e. if the value at the current cell is non-zero, jump to the previous[)
And 2 of them are new operators that modify the stack:
;: Pop a value from the stack and store it into the current cell:: Push the value of the current cell onto the stack
An OpLang program consists of a series of custom operator definitions, followed by the "toplevel" (similar to a main() function in other languages).
An operator definition consists of the operator's name, followed by the operator's body, enclosed in {/}.
Single-line comments are supported, and are introduced by the # character.
Here's a simple program that reads a character from stdin, adds 3 to it, and prints it back:
a { ; +++ : }
,: a ;.
For more example programs, see the Examples folder.
License
This repository is licensed under the terms of the GNU General Public License v3.
For more details, see the license file.