code-lab-assist

A powerful academic programming tool that generates structured lab problems and solutions across multiple programming languages. It is designed to streamline lessons for instructors and tutors, and it also supports heuristic POML generation.

Features

• Multi-Language Support: Generate code templates for Python, JavaScript, TypeScript, Java, C, C++, and C#
• Versatile Code Templates: Generate functions, classes, and interfaces with appropriate language-specific syntax
• Automated Testing: Generate comprehensive test suites for all supported languages
• User-Friendly Interface: Interactive Jupyter notebook interface for easy lab creation
• Heuristic POML Generation: Generate powerful and intuitive POML prompts for any purpose

Getting Started

Prerequisites

• Python 3.6+
• IDE support for Python, Jupyter notebooks, and GitHub Copilot (or an OpenCode installation instead of GitHub Copilot)
• ipykernel and ipywidgets python packages for Jupyter notebook execution (see requirements.txt)
• poml python package for rendering POML prompts (see requirements.txt)
• Language-specific compilers/interpreters for testing code

Usage

1. Launch the Jupyter notebook interface (code_lab_ui.ipynb)
2. Use the interactive form to specify:
   • Programming language
   • Code type (function, class, or interface)
   • Name
   • Problem description
   • Parameters
3. Click "Generate" to create your lab

POML Renderer

The project includes a simplified POML renderer (poml_renderer.py) for rendering POML prompts with context variables. The renderer is designed to be minimal and straightforward:

python poml_renderer.py

Features:

• Renders prompt.poml
• Loads context from prompt_context.json (optional)
• Outputs rendered content directly to stdout
• Minimal, clean implementation without command-line complexity

Config Files:

• prompt.poml - The POML prompt file to render
• prompt_context.json - Context variables (optional, uses empty context if not found)