AHCodeCompiler 1.0.2

A Python SDK for code compilation by Akash Halder. It allows developers to use this SDK and create their frontend for online code compilation

A lightweight Python SDK to compile and execute code using a powerful code-execution API. Perfect for building online code editors, testing environments, and educational platforms.

✅ A Python port of the original TypeScript SDK

🎯 Try the live demo here: https://www.akashhalder.in/code-compiler

---

✨ Features

• Fetch supported runtimes with versions
• Execute code in 50+ programming languages
• Built-in error/output handling
• Easy to plug into any Python backend or CLI tool

---

📦 Installation

pip install ah-code-compiler-sdk

🚀 Usage (Python)

import AHCodeCompiler.compiler as compiler

# Get all run-time Environment
runtimes = compiler.get_runtimes()
print("Available Runtimes: \n", runtimes)

# Execute Code of the Supported Language
result = compiler.execute_code(
    language="javascript",
    version="18.15.0",
    files=[
        {
            "name": "main.js",
            "content": "console.log('Hello from JavaScript!');"
        }
    ]
)

# Extract output and error
stdout = result.get('run', {}).get('stdout')
stderr = result.get('run', {}).get('stderr')

# Conditional rendering
if stdout:
    print("✅ Output:")
    print(stdout.strip())
elif stderr:
    print("❌ Error:")
    print(stderr.strip())
else:
    print("⚠️ No output or error received.")

Or,

from AHCodeCompiler import AHCodeCompiler

compiler = AHCodeCompiler()

# Get all run-time Environment
runtimes = compiler.get_runtimes() 
print("Available runtimes: \n", runtimes)

# Execute Code of the Supported Language
result = compiler.execute(
    language="javascript",
    version="18.15.0",
    files=[
        {
            "name": "main.js",
            "content": "console.log('Hello from JavaScript!');"
        }
    ]
)

# Extract output and error
stdout = result.get('run', {}).get('stdout')
stderr = result.get('run', {}).get('stderr')

# Conditional rendering
if stdout:
    print("✅ Output:")
    print(stdout.strip())
elif stderr:
    print("❌ Error:")
    print(stderr.strip())
else:
    print("⚠️ No output or error received.")

---

📚 API Reference

class AHCodeCompiler

Main SDK wrapper for all functionality.

get_runtimes() -> list[dict]

Fetch all supported runtimes.

Returns:

[
  {
    "language": "python3",
    "version": "3.10.0",
    "aliases": ["py", "py3"],
    "runtime": "python"
  },
  ...
]

execute_code(language: str, version: str, files: list[dict]) -> dict

Execute code for the given language and version.

Example:

compiler.execute_code(
    language="python3",
    version="3.10.0",
    files=[
        {"name": "main.py", "content": "print('Hello World')"}
    ]
)

🌍 Supported Languages

Some of the popular languages supported:

• Python (python3)
• JavaScript (node)
• C++
• Java
• Go
• Rust
• TypeScript
• C#
• Ruby
• PHP
• ...and more

Use get_runtimes() to fetch the latest list.

📄 License

MIT License © Akash Halder