aadhithya / rajinipp

Programming language based on Iconic dialogues of Rajinikanth. 🤘🏽

rajini++

rajini++ (rajiniPP) the programming language is a tribute to the one and only superstar and based on the iconic dialogues of Rajinikanth. This is a hobby project and is not meant to be used for serious software development.

Superstar Rajinikanth

• Who is Rajinikanth?
• Rajinikanth on Wikipedia.

Installation

• rajinipp requires python >= 3.8. Install python from here.

• Install the rajini++ interpreter using the following command: pip install rajinipp

• test installation: rajinipp version

Getting started

rajini++ is not a feature rich language and is not intended for serious use. It is rather a hobby project and a tribute to the one and only superstar.

Run programs

hello_world.rpp:

LAKSHMI START
DOT "Hello, World!";
MAGIZHCHI

• Run the hello_world.rpp program:

  rajinipp run examples/hello_world.rpp

will result in the following output:

Resources

• Learn the rajini++ language:
  • The rajini++ language documentation can be found at the rajiniPP Wiki.
  • Example programs can be found here: Example Programs.
• The rajini++ Language Spec: The rajini++ commands and its equivalent in python3 can be found at the rajiniPP Language Spec wiki.
• The rajinipp Interpreter Documentation: The documentation for the rajinipp interpreter can be found here.

Acknowledgements

• A lot of learnings from DIVSPL and its accompanying pycon talk.
• A lot of learnings from this pycon talk by Alex Gaynor.
• Workflows setup based on poetry_pypi_template.
• This project is inspired by the ArnoldC project.

Roadmap

rajini++ Features

• Math Ops
  • SUM
  • SUB
  • MUL
  • DIV
  • MOD
• Unary Ops
• print multiple objects with the same statement.
• variable declaration
• variable access
• variable manipulation
• bool data type
• float datatype
• logical ops
• if statement
• if-else statement
• for loop
• while loop
• functions
• functions with return
• functions with arguments
• Execute python code in rajini++ scripts

rajinipp package

• rajinipp python runner:
  • rajinipp.api.require: load rajini++ code into python program.
  • rajinipp.runner.RppRunner.exec: execute rajini++ programs in python loaded as string.
  • rajinipp.runner.RppRunner.eval:
    • eval rajini++ statement in python scripts [limited support].
    • support flow control statements.
    • eval function calls from loaded rajini++ code and return output.
• rajinipp shell to run rajini++ commands from the terminal.
  • limited support using rajinipp.runner.RppRunner.eval.
  • complete support to all rajini++ features.

General

• Add tests.
• semantic releases.

rajinipp's Issues

set up github actions

Github actions to do the following:

• Code checks: Linting, formatting
• semantic versioning on the master branch
• tests: unit tests
• tag, build and publish to registry: manual step

add support for functions

• support declaring and calling functions

add support to Boolean variables

• add support to Boolean variables.

allow semantic-release to push to master

https://python-semantic-release.readthedocs.io/en/latest/automatic-releases/github-actions.html

feat: embed python code in rajini++ programs

• Since rajini++ is not feature rich, we want to be able to embed python code in rajini++ scripts for functions not supported by rajini++

Tasks

• allow execution of python statements in rajini++ programs.

support conditional ops

• add support for conditional ops:
• GT (>)
• GTE (>=)
• LT (<)
• LTE (<=)
• NEQ (!=)
• EQ (==)

reorganize project and simpler productions

• project is a bit clunky. need to re-organize it to make it lighter and simpler.
• look into simplifying production rules.

refactor __main__ and api enhancements

• currently code in rajinipp.__main__.run() is duplicated in rajinipp.api.exec().
• rajinipp.api.exec() can only execute complete rajini++ programs.

Tasks

• reduce code duplication and improve abstraction
• support executing single statements in rajinipp.api.exec()

CI: Semantic versioning and release fails

• semantic versioning and release fails.

support if statement

• add support for if statements

runner: support importing rpp files.

• we want to be able import rpp files and access methods/variables from the imported file using the RppRunner.eval() function.

Tasks

• allow importing rpp files in python scripts

pages for rajinipp

• set up a GitHub pages page for rajini++.

add support for loops

add support for:

• For Loops
• While Loops
• Tests for both

fix examples

• rajini++ examples use old syntax. This causes the tests and eventually the pipelines to fail.
• [ ] update the example code to new syntax

add repo information to pyproject.toml

• add readme
• add repository link
• add project link
  and other metadata to pyproject.toml

This is needed to add these Information to pipit release

Add "Enna Koduma Saravanan Idhu" for Error reporting

Idhu epdi irukku!

Bug while Running the RPP programs

Bug Report

Checklist

• I am running the latest version of rajinipp.
• I have searched the issues(open / closed) for this issue.
• I have checked the project wiki.
• This problem is reproducible.
• This is not a feature request.

Current Behaviour

(rajini) C:\Users\ABIPRAVI\rajini>rajinipp version
Traceback (most recent call last):
  File "C:\Users\ABIPRAVI\AppData\Local\Programs\Python\Python310-32\lib\runpy.py", line 196, in _run_module_as_main
    return _run_code(code, main_globals, None,
  File "C:\Users\ABIPRAVI\AppData\Local\Programs\Python\Python310-32\lib\runpy.py", line 86, in _run_code
    exec(code, run_globals)
  File "C:\Users\ABIPRAVI\Envs\rajini\Scripts\rajinipp.exe\__main__.py", line 4, in <module>
  File "C:\Users\ABIPRAVI\Envs\rajini\lib\site-packages\rajinipp\__init__.py", line 2, in <module>
    from . import ast, lexer, parser, runner, utils
  File "C:\Users\ABIPRAVI\Envs\rajini\lib\site-packages\rajinipp\runner.py", line 16, in <module>
    from .utils import read_yml
  File "C:\Users\ABIPRAVI\Envs\rajini\lib\site-packages\rajinipp\utils.py", line 1, in <module>
    import yaml
ModuleNotFoundError: No module named 'yaml'

Expected Behaviour

Version data

Steps to Reproduce

1. Make sure to install the PyYAML automatically in the requirements

pip install PyYAML

Stack Trace / Screenshot

General Info

• rajinipp version:latest
• python version:10
• os platform:Windows

Annoying Warning

Bug Report

Checklist

• I am running the latest version of rajinipp.
• I have searched the issues(open / closed) for this issue.
• I have checked the project wiki.
• This problem is reproducible.
• This is not a feature request.

Current Behaviour

| WARNING | rajinipp.runner:init:35 - LineParser supports only a subset of rajini++ features.
I'm not sure why this warning pops up even for a fresh install.

Expected Behaviour

Warning could be avoided

Steps to Reproduce

Just normal installation and running it

Stack Trace / Screenshot

General Info

• rajinipp version: v0.3.1
• python version: v3.9.2
• os platform: Linux

refactor parser to reduce code complexity

• parser.Parser is too complex and hard to read.