eTamil Support (VS Code Extension)

Complete VS Code extension for eTamil programming language with syntax highlighting, code snippets, compiler installation, and integrated coding support.

✨ Features

Language Support

• Language ID: etamil
• File Extensions: .etamil, .qmz
• Syntax Highlighting: Tamil + romanized keyword support
• Comments: Single-line (//) comments
• Bracket Matching: Automatic bracket and brace pairing
• Auto-indentation: Smart indentation for blocks

Core Keywords (Tamil / English)

Control Flow:

• எனில் / enil - If conditional
• இன்றேல் / inREl - Else clause
• சுற்று / cuRRu - Loop

I/O Operations:

• அச்சு / accu - Print output
• உள்ளிடு / uLLitu - Read input

File Operations:

• கோப்பு_திற / kOppu_qiRa - Open file
• கோப்பு_மூடு / kOppu_mUtu - Close file
• கோப்பு_படி / kOppu_pati - Read from file
• கோப்பு_எழுது / kOppu_ezuqu - Write to file

CSV Operations:

• தரவுரை_படி / qaravurY_pati - Read CSV
• தரவுரை_எழுது / qaravurY_ezuqu - Write CSV

Database Operations:

• தளம்_இணை / qaLam_iNY - Connect to database
• தளம்_பிரி / qaLam_piri - Disconnect from database
• தளம்_வினா / qaLam_vinA - Database query
• தளம்_செய் / qaLam_cey - Execute command
• தளம்_செருக / qaLam_ceruka - Insert into database
• தளம்_புதுப்பி / qaLam_puquppi - Update database
• தளம்_நீக்கு / qaLam_nIkku - Delete from database

Data Types:

• எண் / eN - Integer/Number
• பின்னம் / pinnam - Float
• சொல் / col - String
• பொது / poqu - Boolean

Financial & Accounting ✨ NEW:

• வரவு / varavu - Credit
• பற்று / paRRu - Debit
• இருப்பு / iruppu - Balance
• வருவாய் / varuvAy - Revenue
• செலவு / celavu - Expense
• வருமானம் / varumAnam - Income
• பயன் / payan - Profit
• இழப்பு / izappu - Loss
• வரி / vari - Tax
• வங்கி / vawki - Bank
• பணம் / paNam - Cash
• ... and 28+ more financial keywords
• உரை / urY - Text
• அணி / aNi - Array
• தேதி / qEqi - Date

Compiler Installation

Build from source with Rust:

git clone https://github.com/Maruff/etamil_compiler.git
cd etamil_compiler/etamil_compiler
cargo build --release

🚀 Quick Start

1. Install the Extension

• Open VS Code Extension Marketplace
• Search for "eTamil Support"
• Click Install
• On activation, the extension will prompt to install the eTamil compiler (optional)

2. Create Your First Program

• Create a file: hello.etamil
• Type the code below:

அச்சு "வணக்கம் உலகம்";

3. Run Your Program

etamil --vm hello.etamil

Or with piped input:

echo "test input" | etamil --vm hello.etamil

📝 eTamil Coding Guide

Basic Structure

Variables and Data Types

Basic Syntax

Variables and Output

// Declare a variable with integer type
எண் age = 25;

// Print output
அச்சு "Hello World";
அச்சு "வணக்கம் உலகம்";
அச்சு age;

Reading Input

// Declare variable
எண் income;

// Read user input into variable
அச்சு "Enter your income: ";
உள்ளிடு income;

Conditional Logic (If-Else)

// Simple if condition
(age > 18) எனில் {
    அச்சு "You are an adult";
}

// If-Else condition
(age > 18) எனில் {
    அச்சு "You are an adult";
}
இன்றேல் {
    அச்சு "You are a minor";
}

Loops

// Loop from 1 to 10
சுற்று i = 1; i <= 10; i = i + 1; {
    அச்சு i;
}

File Operations

// Read from file
கோப்பு_திற "input.txt";
சொல் data;
கோப்பு_படி "input.txt", data;
அச்சு data;
கோப்பு_மூடு "input.txt";

// Write to file
கோப்பு_திற "output.txt";
கோப்பு_எழுது "output.txt", "Hello from eTamil!";
கோப்பு_மூடு "output.txt";

CSV Operations

// Write CSV data
கோப்பு_திற "data.csv";
தரவுரை_எழுது "data.csv", "name,age,city";
தரவுரை_எழுது "data.csv", "ராஜா,25,Chennai";
கோப்பு_மூடு "data.csv";

// Read CSV data
கோப்பு_திற "data.csv";
தரவுரை_படி "data.csv", data;
அச்சு data;
கோப்பு_மூடு "data.csv";

Database Operations

// Connect to database
தளம்_இணை "sqlite", "mydb.db";

// Query database
தளம்_வினா "SELECT * FROM users";

// Execute command
தளம்_செய் "CREATE TABLE users (id INT, name TEXT)";

// Disconnect
தளம்_பிரி "sqlite";

Complete Example: Simple Calculator

// Simple calculator - adds two numbers
// Usage: echo "10 20" | etamil --vm calc.etamil

// Declare variables
எண் a = 10;
எண் b = 20;
எண் sum;

// Calculate sum
sum = a + b;

// Print result
அச்சு "a: ";
அச்சு a;
அச்சு "b: ";
அச்சு b;
அச்சு "sum: ";
அச்சு sum;

Output:

a: 10
b: 20
sum: 30

🔧 Installation Methods

Linux

Option 1: From GitHub (Recommended)

# Build from source (requires Rust)
git clone https://github.com/Maruff/etamil_compiler.git
cd etamil_compiler/etamil_compiler
cargo build --release
# Binary is at: target/release/etamil_compiler or etamil_compiler.exe

📋 Language Keywords Reference

Tamil Keywords

Core Keywords

Data Types

File Operations

CSV Operations

Database Operations

Operators

🎯 Common Workflows

Basic Script Development

1. Create a .etamil file with eTamil code
2. Use the IntelliSense (Ctrl+Space) for keyword suggestions
3. Run with: etamil --vm yourfile.etamil

🐛 Troubleshooting

Issue: etamil: command not found

Solution: Ensure installation completed and binary is in PATH

# Verify installation
which etamil          # Linux/macOS
where etamil.exe      # Windows

# If not found, reinstall via extension command

Issue: UTF-8 Encoding Issues (Windows)

Solution: Ensure VS Code is set to UTF-8 encoding

• In VS Code, click the encoding indicator in the status bar (bottom right)
• Select "UTF-8" encoding before saving eTamil files

Issue: Permission Denied on Linux

Solution: Ensure the compiler binary is executable and in PATH

chmod +x /path/to/etamil
# Verify: etamil --version

Issue: Syntax Errors When Running Code

Solution: Check you're using the correct keyword syntax

• Use அச்சு for print (not print)
• Use உள்ளிடு for input (not input)
• Use எனில் for if (not if)

📖 Additional Resources

• Official Repository: https://github.com/Maruff/etamil_compiler
• Documentation: See docs/ folder in repository
• Examples: See etamil_compiler/examples/ in repository
• Issue Tracker: https://github.com/Maruff/etamil_compiler/issues

✅ Snippets Quick Reference

Type these shortcuts in an .etamil file:

VS Code Snippets: The extension provides code templates for common constructs. Press Ctrl+Space while typing to see available keywords and autocomplete suggestions.

Example Workflow:

1. Type: அச்சு "Hello" (or use autocomplete)
2. Press Enter to execute
3. Use Ctrl+Space to discover more keywords

📞 Support

• Report bugs: https://github.com/Maruff/etamil_compiler/issues
• Ask questions in documentation
• Check examples for reference

Version: 0.2.0
Last Updated: January 31, 2026
Status: Production Ready