filterKaapi


NamefilterKaapi JSON
Version 0.1.4 PyPI version JSON
download
home_pageNone
SummaryFilterKaapi: A Tamil-inspired programming language
upload_time2025-09-01 16:21:10
maintainerNone
docs_urlNone
authorChiddesh
requires_python>=3.7
licenseMIT
keywords
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # ☕ 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:

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

### After installation, run:

```bash
kaapi main.kaapi
```

Or start the interactive REPL:

```bash
kaapi
```

### 🔤 Language Syntax

Input

```bash
notepaniko <var_name> "message"
```

- example
  ```bash
  notepaniko name "Enter Name"
  kaapi name
  ```
- output
  ```bash
  "Enter Name:" your_name
  your_name
  ```

Printing

```bash
kaapi "Vanakkam Chennai!"
```

- output

  ```bash
  Vanakkam Chennai!
  ```

Variables

```bash
vechiko x = 10
kaapi x
```

- output

  ```bash
  10
  ```

Lists

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

- output
  ```bash
  [1,2,3,4,5]
  ```

List Operations

```bash
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
  ```bash
  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

```bash
kaapi (5 + 3) * 2
```

- output

  ```bash
  10
  ```

Functions

```bash
seyyu function_name(args)
    body
mudinchu
```

- example

  ```bash
  seyyu add(a,b)
      kaapi a + b
  mudinchu

  add(2,5)
  ```

- output

  ```bash
  7
  ```

If/Else

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

- output

  ```bash
  Periya number
  ```

While Loop

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

- output

  ```bash
  0
  1
  2
  3
  4
  ```

## 🛠 Project Structure

```bash
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.

            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "filterKaapi",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.7",
    "maintainer_email": null,
    "keywords": null,
    "author": "Chiddesh",
    "author_email": null,
    "download_url": "https://files.pythonhosted.org/packages/ca/17/fe61e851057ef290ebf281214c7fa6c479bb7e4a687da9c40915209e6697/filterkaapi-0.1.4.tar.gz",
    "platform": null,
    "description": "# \u2615 FilterKaapi Language\n\nFilterKaapi is a **Tamil-inspired programming language** written in Python.  \nJust like Chennai's famous filter coffee, this language is simple, strong, and gives a warm kick to coding!\n\n\ud83d\udd8b\ufe0f **Keywords are in Tamil** to make coding feel closer to home:\n\n- `kaapi` \u2192 print (like pouring kaapi \u2615)\n- `vechiko` \u2192 variable declaration (means \"keep it\")\n- `iruntha ... ilana ...` \u2192 if ... else\n- `varai` \u2192 while loop\n- `seyyu` \u2192 Functions\n- `notepaniko` \u2192 Input from user\n- `push,pop,remove,length` \u2192 List operations\n\n---\n\n## \ud83d\ude80 Features\n\n- \ud83d\udcdd **Tamil keywords** for programming basics\n- \u2795 Arithmetic operations (`+`, `-`, `*`, `/`, `%`, `//`)\n- \ud83d\udd11 Variables with `vechiko`\n- \ud83d\udd0d Conditional logic with `iruntha ... ilana ...`\n- \ud83d\udd01 `varai` for loops\n- \ud83d\udce6 `seyyu` for functions\n- \ud83d\udda5\ufe0f REPL and script execution support\n- \ud83d\udccb List support with built-in functions:\n  - `push` \u2192 add an element to a list\n  - `pop` \u2192 remove last element\n  - `remove` \u2192 remove a specific value\n  - `length` \u2192 get list size\n\n---\n\n## \ud83d\udce6 Installation\n\nFor now, install from source:\n\n```bash\ngit clone https://github.com/chiddesh/filterKaapi.git\ncd filterKaapi\npip install .\n```\n\n### After installation, run:\n\n```bash\nkaapi main.kaapi\n```\n\nOr start the interactive REPL:\n\n```bash\nkaapi\n```\n\n### \ud83d\udd24 Language Syntax\n\nInput\n\n```bash\nnotepaniko <var_name> \"message\"\n```\n\n- example\n  ```bash\n  notepaniko name \"Enter Name\"\n  kaapi name\n  ```\n- output\n  ```bash\n  \"Enter Name:\" your_name\n  your_name\n  ```\n\nPrinting\n\n```bash\nkaapi \"Vanakkam Chennai!\"\n```\n\n- output\n\n  ```bash\n  Vanakkam Chennai!\n  ```\n\nVariables\n\n```bash\nvechiko x = 10\nkaapi x\n```\n\n- output\n\n  ```bash\n  10\n  ```\n\nLists\n\n```bash\nvechiko myList = [1,2,3,4,5]\nkaapi myList\n```\n\n- output\n  ```bash\n  [1,2,3,4,5]\n  ```\n\nList Operations\n\n```bash\nvechiko myList = [1,2,3,4,5]\nkaapi myList[0] \u2192 indexing\npush myList[6] \u2192 push operation appends\nkaapi myList\npop mylist \u2192 pop's last element\nkaapi myList\nremove myList[1] \u2192 remove a particular element\nkaapi myList\nlen myList \u2192 print the length of the list\nkaapi myList\n```\n\n- output\n  ```bash\n  1 \u2192 after indexing\n  [1,2,3,4,5,6] \u2192 after push operation\n  [1,2,3,4,5] \u2192 after pop operation\n  [2,3,4,5] \u2192 after remove operation\n  4 \u2192 len operation\n  ```\n\nArithmetic\n\n```bash\nkaapi (5 + 3) * 2\n```\n\n- output\n\n  ```bash\n  10\n  ```\n\nFunctions\n\n```bash\nseyyu function_name(args)\n    body\nmudinchu\n```\n\n- example\n\n  ```bash\n  seyyu add(a,b)\n      kaapi a + b\n  mudinchu\n\n  add(2,5)\n  ```\n\n- output\n\n  ```bash\n  7\n  ```\n\nIf/Else\n\n```bash\n5 > 3 iruntha kaapi \"Periya number\" ilana kaapi \"Siriya number\"\n```\n\n- output\n\n  ```bash\n  Periya number\n  ```\n\nWhile Loop\n\n```bash\nvechiko i = 0\nvarai i < 5\n    kaapi i\n    vechiko i = i + 1\nend\n```\n\n- output\n\n  ```bash\n  0\n  1\n  2\n  3\n  4\n  ```\n\n## \ud83d\udee0 Project Structure\n\n```bash\nkaapi_lang/\n \u251c\u2500\u2500 __init__.py\n \u251c\u2500\u2500 cli.py           # CLI entry point\n \u251c\u2500\u2500 interpreter.py   # Evaluator\n \u251c\u2500\u2500 lexer.py         # Tokenizer\n \u251c\u2500\u2500 parser.py        # Parser\n \u2514\u2500\u2500 main.py          # Runner\n\nsetup.py              # For packaging\n```\n\n# \ud83d\udc68\u200d\ud83d\udcbb Author\n\nCreated with \u2764\ufe0f in Chennai by Chiddesh Ram\\\nInspired by strong Filter Kaapi and a love for coding.\n",
    "bugtrack_url": null,
    "license": "MIT",
    "summary": "FilterKaapi: A Tamil-inspired programming language",
    "version": "0.1.4",
    "project_urls": null,
    "split_keywords": [],
    "urls": [
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "343d27ef7e28fdfabf240825a9c8ed44a4c8fe53b4e7ad5c3518d4cbcf08cb3d",
                "md5": "a0235813e2867978da5529b106bc7fea",
                "sha256": "a5e038ff21d1ea4ddaedc64e16f9679c8a38f8da10bb03d19c25147aa02fa0aa"
            },
            "downloads": -1,
            "filename": "filterkaapi-0.1.4-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "a0235813e2867978da5529b106bc7fea",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.7",
            "size": 9069,
            "upload_time": "2025-09-01T16:21:09",
            "upload_time_iso_8601": "2025-09-01T16:21:09.754991Z",
            "url": "https://files.pythonhosted.org/packages/34/3d/27ef7e28fdfabf240825a9c8ed44a4c8fe53b4e7ad5c3518d4cbcf08cb3d/filterkaapi-0.1.4-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "ca17fe61e851057ef290ebf281214c7fa6c479bb7e4a687da9c40915209e6697",
                "md5": "66511bd50b127e73ab4f0f2f8dec059a",
                "sha256": "c35197267f1c5c03a11c21797c452cfb00757e3f9b47f7f23b5ccced6936199e"
            },
            "downloads": -1,
            "filename": "filterkaapi-0.1.4.tar.gz",
            "has_sig": false,
            "md5_digest": "66511bd50b127e73ab4f0f2f8dec059a",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.7",
            "size": 6970,
            "upload_time": "2025-09-01T16:21:10",
            "upload_time_iso_8601": "2025-09-01T16:21:10.942662Z",
            "url": "https://files.pythonhosted.org/packages/ca/17/fe61e851057ef290ebf281214c7fa6c479bb7e4a687da9c40915209e6697/filterkaapi-0.1.4.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2025-09-01 16:21:10",
    "github": false,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "lcname": "filterkaapi"
}
        
Elapsed time: 0.86532s