asPy - Assamese Python Transpiler

Project Name: asPy — Assamese → Python Transpiler & VS Code Extension
Objective: Build a functional VS Code extension enabling Assamese programming by transpiling Assamese code into Python and executing it seamlessly within VS Code.

Project Overview
The asPy project aims to make programming accessible in Indian regional languages—starting with Assamese. The solution must allow users to:
Write code in Assamese in .aspy files inside VS Code.

Click “Run” to:
Transpile Assamese → Python.

Execute the Python code in a controlled environment.
Display both transpiled Python and program output inside VS Code.
The extension should work offline, bundle the Python transpiler engine, and provide cross-platform support (Windows primary, Linux/macOS secondary).

Scope of Work
Core Components
ComponentDescriptionTranspiler Engine (Python)Converts Assamese keywords & identifiers to Python equivalents using a JSON mapping. Executes code in a sandbox. (Already designed in MVP)VS Code Extension (TypeScript)Provides UI, command registration, syntax highlighting, and communication with the transpiler backend.Backend BridgeThe extension launches a bundled Python process (runner_cli.py) that handles transpilation and execution.Syntax HighlightingTextMate grammar to highlight Assamese keywords and built-ins.Output Panel / WebviewDisplays transpiled Python and program output side by side.

Functional Requirements
a. Language Handling
File extension: .aspy
Syntax highlighting for Assamese keywords (from mapping.json).
Supports Assamese digits ০–৯ and transliterated functions.
b. Commands & Features
CommandActionaspy.runRuns current file; shows transpiled Python + output.aspy.showPythonShows transpiled Python only.aspy.newSampleInserts a “Hello World” Assamese template.
c. Settings
KeyTypeDefaultDescriptionaspy.pythonPathstringautoCustom Python interpreter path.aspy.mappingPathstringinternalPath to keyword mapping file.aspy.maxExecMillisnumber3000Max runtime per execution (ms).
d. Output
Opens a new VS Code panel or webview showing:
### Transpiled Python
<code>
### Output
<result>
Handles runtime errors gracefully (show traceback in red).
e. Security
Executes in restricted sandbox (safe builtins only).
Enforces timeout and memory safety (limit execution time to avoid infinite loops).

Technical Stack
LayerTechnologyBackendPython 3.10+FrontendTypeScript (VS Code Extension API)Editor FrameworkVS CodePackagingvsce (Visual Studio Code Extension Manager)JSON MappingAssamese → Python keyword dictionary

Deliverables
VS Code Extension Package (aspy-x.y.vsix)
Installable extension with bundled backend.
Includes syntax highlighting and run commands.
Source Code Repository

Organized as:
vscode-aspy/
├─ extension/
├─ backend/
├─ syntaxes/
├─ tests/
└─ README.md
Backend (Python)
Finalized version of transpiler and sandbox.
runner_cli.py entry for extension.

Documentation
Setup & installation guide.
Developer guide (for extending to other languages).
User guide (how to write and run Assamese code).

Sample Programs
Hello World, Loop, Function, File I/O.

Testing Suite
Unit tests for transpiler.
Integration tests for extension.

Development Milestones
PhaseTimelineDeliverables1. Setup & Repo CreationWeek 1Repo scaffolding, Python backend integrated.2. VS Code Extension CoreWeek 2Commands, panel rendering, backend bridge.3. Syntax & SettingsWeek 3TextMate grammar, settings.json.4. Testing & DebuggingWeek 4End-to-end test cases, cross-platform check.5. Packaging & DocumentationWeek 5.vsix build, README, walkthrough video.

Acceptance Criteria
Extension installs via .vsix and detects .aspy files.
Assamese syntax highlighting works.
Pressing Run executes transpiler + sandbox → displays Python + output.
Handles Unicode digits and strings.
Works on Windows without manual Python configuration.
Packaging size < 30 MB.
Fully documented setup and usage.

Post-Delivery Expectations:
Source code rights transferred to client.
Developer to provide 1-month post-delivery support for debugging and stability issues.
Optional roadmap (v1.1):
Auto-completion from mapping.json.
Error localization (Assamese error messages).
Language Server Protocol (LSP) integration.

Future Vision
Expand to Bodo, Khasi, Manipuri, Mizo etc.
Integrate with DesiCodes platform for community sharing.
Add online compiler version (web sandbox).