Haskell Run - VS Code Extension

Haskell Run is a simple VS Code extension that allows users to run Haskell code with a single button click.

Features

One-click execution of Haskell programs
Run individual functions directly from the editor
Automatic tool installation for missing dependencies
High-contrast theme support for accessibility
Integrated REPL management
Code snippets for common Haskell patterns
Comprehensive error handling with quick fixes
Detailed troubleshooting guide

Usage Guide

Running a Haskell File

Open any .hs file in VS Code.
Click the Run Haskell ▶️ button in the editor toolbar.
The output will be displayed in the VS Code terminal.

Running a Specific Function

Highlight the function you want to run.
Right-click and select Run Haskell Function.
If the function requires arguments, an input box will appear where you can enter them.
Press Enter, and the function will execute in GHCi.

🛠️ Installation

From VS Code Marketplace:

Open VS Code and navigate to Extensions (Ctrl+Shift+X or Cmd+Shift+X on macOS).
Search for Haskell Run.
Click Install and restart VS Code if necessary.

From GitHub:

Clone this repository:

git clone https://github.com/midhunann/Haskell-Run.git

Open the project in VS Code.
Install dependencies:
```
npm install
```

Run the extension in development mode:

npm run compile
code --extensionDevelopmentPath=.

Motive

While working with Haskell, students and developers often face challenges with manual compilation and execution of functions. Haskell Run was created to simplify this process, allowing users to:

Run Haskell scripts effortlessly with a single click.
Execute individual functions without needing to manually type them in the terminal.
Improve workflow efficiency by integrating execution seamlessly within VS Code.

Keyboard Shortcuts

Command	Windows/Linux	macOS
Run Haskell File	`Ctrl+Alt+R`	`Cmd+Alt+R`
Run Selected Function	`Ctrl+Alt+F`	`Cmd+Alt+F`
Restart REPL	`Ctrl+Alt+K`	`Cmd+Alt+K`
Clear REPL	`Ctrl+Alt+L`	`Cmd+Alt+L`

Code Snippets

Prefix	Description
`hmain`	Create a Haskell main function
`hprop`	Create a QuickCheck property
`hdata`	Create a Haskell data type
`hclass`	Create a Haskell type class

Configuration

The following settings are available:

haskellRun.defaultRunner: Choose between 'runghc', 'stack runghc', or 'cabal run'
haskellRun.timeout: Set timeout for long-running scripts (default: 30000ms)
haskellRun.reuseTerminal: Reuse existing terminal (default: true)
haskellRun.enableTelemetry: Enable anonymous usage data collection (default: false)

Troubleshooting

See our detailed Troubleshooting Guide for solutions to common issues.

License

This project is licensed under the MIT License.

Contributing

We welcome contributions! Feel free to open issues, fork the repository, and submit pull requests.

Feedback & Support

Issues & Bug Reports: GitHub Issues
Discussions & Suggestions: GitHub Discussions