RistPy

Just a programming language made to shorten the Python code

R  - Rist
I  - Is
S  - Short
T  - Text
Py - Python

Usage

First of all, it should be installed by

python3 -m pip install -U RistLang

Create a file named main.rist
A sample code is given here

@+ os, pprint

cls$(): os.system("cls" if os.name == "nt" else "clear")

cls()

something$(arg: Union[str, int]){
  pprint.pprint(["myText", [arg]])
}
something{"text2"}

Then in your shell

rist run main.rist

Or if you want to compile into python file then run in your shell

rist run main.rist --compile-to rist_compiled_main.py

Or in your python file

from ristpy import rist, E, W

print(rist("main.rist"))
# if you want some text to compile then

code = """
$p$():...
"""
print(rist(code, fp=False))
# if you wanna execute then
rist(code, fp=False, flags=E) # E flag means execute
rist('main.rist', flags=E)
# compile code somewhere
rist("main.rist", flags=W, compile_to="main.py") # W flag means write
# if execute too then
rist("main.rist", flags=W|E, compile_to="main.py")

Syntax

Importing

What can it Import?

It can Import all python modules

How to Import?

In python you do import asyncio

In rist you have to do @+ asyncio

In python you do from aiohttp import web

In rist you have to do +@ aiohttp @+ web

Functions

How do i make a function?

Making a function

# synchronous func;
foo$(): # <name_of_func> + $
  pass

# asynchronous func
$bar$(): # $ + <name_of_func> + $
  pass

How do i call it?

Calling a function

# synchronous function
foo()
# asynchronous func
?bar() # ? + <name_of_func>

Comments

To use comments in this language, use #, Just like Python

For example:-

# Some comment

MultiFile Project

For Multiple File projects, make a file named ristconf.json

Format of the file is

{
  "main": "<main file>",
  "dirs": [
    "<directories to use>"
  ],
  "ignore": [
    "<files to ignore>"
  ],
  "snippets": {
    "<macro name>": [
      "line1",
      "line2"
    ]
  },
  "snippets_py": {
    "<macro name>": [
      "line1",
      "line2"
    ]
  }
}

Here main key is required while others are optional

A sample file is given here

{
  "main": "main.rist",
  "dirs": ["dir_example"],
  "ignore": ["not_to_compile.rist"],
  "snippets": {
    "a": [
      "$p{0}",
      "$p{1}",
      "$p{2}"
    ]
  },
  "snippets_py": {
    "b": [
      "print(3)",
      "print(4)",
      "print(5)"
    ]
  }
}

Now the question arises, what is the snippets key given here.

Here you can create macros which you can directly import in rist files

Working with macros

Syntax

{
  "snippets": {
    "<name of macro>": [
      "Line 1, (in rist)",
      "Line 2, (in rist)",
      "and so on...(in rist)"
    ]
  },
  "snippets_py": {
    "<name of macro>": [
      "Line 1, (in Python)",
      "Line 2, (in Python)",
      "and so on...(in Python)"
    ]
  }
}

For example

{
  "main": "main.rist",
  "snippets": {
    "a": [
      "@+ math",
      "foo$(a:int,b:int){return math.sqrt(a)+math.sqrt(b)}"
    ]
  },
  "snippets_py": {
    "b": [
      "print(3)",
      "print(4)"
    ]
  }
}

You can use it by %- <name of macro> -%

%- a -%

# inside function
func${}:
  %- b -%

Note: Nothing other should be there in the lines containing %- syntax

Encryptions/Decryptions

Encryptions and Decryptions too comes with rist. You can encrypt anything with rist!

Encrypting from shell

If you want to encrypt something, then just run this in your shell

rist encrypt --filepath <file_to_encrypt> --output <encrypted_output_file> --key <any_integer> --depth 2

Here, key is any number of your choice which will be the passcode and it is optional. Generates automatically if not given Depth is also a number, between 1 to 8 which specifies the layers/times it will be encrypted. It is 1 by default

For example:

rist encrypt --filepath myfile.rist --output myfile.rist.enc --key 22 --depth 2

Encrypting from rist

If you want to encrypt something from rist, then

+@ ristpy @+ encrypt

text="Some_Text"
encrypted=encrypt(text,22,depth=2)
print(encrypted)

Decrypting from shell

If you want to Decrypt something, then just run this in your shell

rist decrypt --filepath <file_to_decrypt> --output <decrypted_output_file> --key <your_key> --depth <the_depth_you_used>

For example:

rist decrypt --filepath myfile.rist.enc --output myfile.rist --key 22 --depth 2

Decrypting from rist

If you want to decrypt something from rist, then

+@ ristpy @+ decrypt

text="1100 1254 1166 1254 726 1122 1166 1210 1166 726 1122 1166 1122 1078 726 1122 1122 1166 1166 726 1122 1100 1100 1122 726 1100 1254 1232 1078 726 1122 1122 1166 1166 726 1122 1210 1210 1122 726 1122 1188 1232 1166"
decrypted=decrypt(text,22,depth=2)
print(decrypted)