pikapy 0.5

Pikachu interpreter written in Python

Pikachu Interpreter

This is an interpreter for Pikachu for Python 2.7.x

The definition of the esoteric programming language named 'pikachu' can be found here. This is built as a cleaner version of https://github.com/joelsmithjohnson/pikachu-interpreter.

Installation:

1. Run $ pip install pikapy

2. Go to your Sublime Packages folder, which defaults to ~/Library/Application Support/Sublime Text 3/Packages on Mac OSX and on Windows, create a new folder called Pikachu, and copy pikachu.sublime-syntax to there.

3. In the same Packages folder, find Color Scheme - Default, and copy pikachu.sublime-color-scheme there.

4. In Sublime Text, go to Preferences → Color Scheme, and select Pikachu.

Usage

In the command line, go to the installation directory, and run:

$ pikachu <pikachu filename> [arguments*]

Pikachu Language

In Pikachu, you have two Pikachus (i.e. stacks): pi pikachu and pika pikachu. Upon starting a Pikachu script, the arguments are pushed into pi pikachu in the order they're given.

Pikachu Syntax

Arithmetic Operations

• pi pika <PIKACHU> - add the top two values in the given Pikachu, and push the sum to the same Pikachu
• pika pi <PIKACHU> - subtract the top value in the Pikachu from the second top, then push the difference
• pi pikachu <PIKACHU> - multiply the top two values in the Pikachu, and push the product
• pikachu <PIKACHU> - divide the second-from-the-top value in the Pikachu by the top value, then push the product

Stack Operations

• pika pikachu <PIKACHU> - pop the top value from the Pikachu, and print as a number
• pikachu pikachu <PIKACHU> - pop the top value from the Pikachu, and print as ASCII
• <PIKACHU> - pop the top value from the Pikachu
• <n terms> <PIKACHU> - push n into the PIkachu
• <pi pika> - push the top value of pika pikachu into pi pikachu
• <pika pi> - push the top value of pi pikachu into pika pikachu

Control Operations

• pikachu pikachu - if the top values of both Pikachus are equal, goto line n, where n is the number of terms in the following line
• pika pika - if the top values of both Pikachus are not equal, goto line n, where n is the number of terms in the following line

Note: Pikachus start counting lines from 1, not 0

Other Options

• pi pi - push to pika pikachu a random number between 1 and n, where n is the top value in pika pikachu
• chu - anything that comes after a chu, is treated as a comment, and will be ignored by the interpreter. This includes any line beginning with the word chu.

Note: Things in this section are not part of the original definition of the language, rather features added for the convenience of the programming Pikachus