README.md

   1 # miniREPL [![Codacy Badge](https://app.codacy.com/project/badge/Grade/1ffc16cdfeca4a53b37e97a8a9a8957b)](https://www.codacy.com/manual/lemao.vrm07/minirepl?utm_source=github.com&amp;utm_medium=referral&amp;utm_content=vrmiguel/minirepl&amp;utm_campaign=Badge_Grade)  [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
   2
   3 A work-in-progress small arithmetic REPL written in pure C++11.
   4
   5 ## Usage
   6
   7 An example follows:
   8 ```C
   9 miniREPL -- github.com/vrmiguel/minirepl
  10 >>> myVar = -2^3 - 4*5
  11 -28
  12 >>> myVar
  13 -28
  14 >>> 4*7^2
  15 196
  16 >>> 6*8 - 2*3
  17 42
  18 >>> a = 2
  19 2
  20 >>> b=a^a
  21 4
  22 >>> b^a + a^b
  23 32
  24 >>> a = 2*b
  25 8
  26 ```
  27
  28 The REPL currently only deals in integers and has no parenthesis support yet.
  29 Variables can be created with any combination of upper and lower-case characters.
  30
  31 ## Building
  32
  33 ### With QMake
  34
  35 On the root folder, run ```qmake && make```.
  36
  37 Start the REPL with `./minirepl`.
  38
  39 The QMake version used here is 3.1.
  40 A compiler supporting at least C++11 is needed, with no extra dependencies
  41
  42 ### A more lengthy way
  43
  44 On the root folder, run ```g++ -c -pipe -std=gnu++11 -Wall -W -fPIC -I. Sources/main.cpp Sources/interp.cpp Sources/_os.cpp Sources/token.cpp```, followed by ```g++ -Wl,-O1 -o minirepl main.o interp.o _os.o token.o```.
  45
  46 The `-std=gnu++11` flag can be freely switched to `-std=c++11` if so wished.