dudupopkhadze / jeka

Jeka is a Dog-Robot, he can do complex stuff with combining basic instructions

Jeka

Jeka is project inspired by Karel.

Karel is an educational programming language for beginners, created by Richard E. Pattis in his book Karel The Robot: A Gentle Introduction to the Art of Programming.

What is Jeka

Jeka is friendly dog that lives in an environment consisting of a grid of streets (left-right) and avenues (up-down). Jeka understands basic instructions:

• moveForward: Jeka moves by one square in the direction he is facing
• turnLeft: Jeka turns 90 ° left
• woof: Jeka barks at you (friendly)
• frontIsClear: Jeka tells you if you can move forward in the facing direction
• hasBones: Jeka tells you if there is a bone on the current position
• putBone: Jeka puts a bone on the square he is standing at
• pickBone: Jeka picks a bone from the square he is standing at

How does Jeka work?

Jeka has 4 main modules:

• Mustang (custom language interpreter that takes the code you write and translates it to the commands known to Jeka)
• BoardController (module that takes care of drawing Jeka, Jeka's World and Jeka's moves)
• Engine (module that is responsible for connecting Mustang and BoardController
• CodeController (module that takes care of getting user's input to the Engine)

Demo Code

Valid Jeka code example (success of running directly this code depends in the Jeka's World)

moveForward();
turnLeft();

fun turnRight(){
  turnLeft();
  turnLeft();
}

var i = 0;

while(i < 5){
  turnRight();
  i = i + 1;
}

while(frontIsClear()){
  moveForward();
}

while(hasBones()){
  pickBone();
}

putBone();

turnRight();

Running Locally

In the project directory, you can run:

npm start

Runs the app in the development mode on port: 3000.

npm run ts

Typescript check.

npm run build

Builds the app for production to the build folder.

jeka's Issues

putBone & pickBone

• render bone svg
• add bones location in board config
• implement putBone
• implement pickBone
• implement boneExists

Dynamic Board Size

Right now board is hard-coded

• make board size dynamic
• UI for selecting board size

Available Commands Modal

Add woof function to Jeka

Feature request:
It would be cool to have woof function which talks with browser web audio API for Jeka to bark.

Obstacles

Implement Karel-like obstacles

• setup types/config for board obstacles
• draw obstacles
• integrate in engine

FrontIsClear

Implement frontIsClear();

• return boolean depending on if jeka can move forward in the facing direction