filterKaapi 0.1.4

FilterKaapi: A Tamil-inspired programming language

☕ FilterKaapi Language

FilterKaapi is a Tamil-inspired programming language written in Python.
Just like Chennai's famous filter coffee, this language is simple, strong, and gives a warm kick to coding!

🖋️ Keywords are in Tamil to make coding feel closer to home:

• kaapi → print (like pouring kaapi ☕)
• vechiko → variable declaration (means "keep it")
• iruntha ... ilana ... → if ... else
• varai → while loop
• seyyu → Functions
• notepaniko → Input from user
• push,pop,remove,length → List operations

---

🚀 Features

• 📝 Tamil keywords for programming basics
• ➕ Arithmetic operations (+, -, *, /, %, //)
• 🔑 Variables with vechiko
• 🔍 Conditional logic with iruntha ... ilana ...
• 🔁 varai for loops
• 📦 seyyu for functions
• 🖥️ REPL and script execution support
• 📋 List support with built-in functions:
  • push → add an element to a list
  • pop → remove last element
  • remove → remove a specific value
  • length → get list size

---

📦 Installation

For now, install from source:

git clone https://github.com/chiddesh/filterKaapi.git
cd filterKaapi
pip install .

After installation, run:

kaapi main.kaapi

Or start the interactive REPL:

kaapi

🔤 Language Syntax

Input

notepaniko <var_name> "message"

• example

  notepaniko name "Enter Name"
  kaapi name
  

• output

  "Enter Name:" your_name
  your_name
  

Printing

kaapi "Vanakkam Chennai!"

• output

  Vanakkam Chennai!
  

Variables

vechiko x = 10
kaapi x

• output

  10
  

Lists

vechiko myList = [1,2,3,4,5]
kaapi myList

• output

  [1,2,3,4,5]
  

List Operations

vechiko myList = [1,2,3,4,5]
kaapi myList[0] → indexing
push myList[6] → push operation appends
kaapi myList
pop mylist → pop's last element
kaapi myList
remove myList[1] → remove a particular element
kaapi myList
len myList → print the length of the list
kaapi myList

• output

  1 → after indexing
  [1,2,3,4,5,6] → after push operation
  [1,2,3,4,5] → after pop operation
  [2,3,4,5] → after remove operation
  4 → len operation
  

Arithmetic

kaapi (5 + 3) * 2

• output

  10
  

Functions

seyyu function_name(args)
    body
mudinchu

• example

  seyyu add(a,b)
      kaapi a + b
  mudinchu
  
  add(2,5)
  

• output

  7
  

If/Else

5 > 3 iruntha kaapi "Periya number" ilana kaapi "Siriya number"

• output

  Periya number
  

While Loop

vechiko i = 0
varai i < 5
    kaapi i
    vechiko i = i + 1
end

• output

  0
  1
  2
  3
  4
  

🛠 Project Structure

kaapi_lang/
 ├── __init__.py
 ├── cli.py           # CLI entry point
 ├── interpreter.py   # Evaluator
 ├── lexer.py         # Tokenizer
 ├── parser.py        # Parser
 └── main.py          # Runner

setup.py              # For packaging

👨‍💻 Author

Created with ❤️ in Chennai by Chiddesh Ram
Inspired by strong Filter Kaapi and a love for coding.