PureBasic Syntax Highlighter for VS Code

This extension provides rich syntax highlighting and development tools for PureBasic (.pb, .pbi) in Visual Studio Code.

---

Features

• Syntax Highlighting: Comprehensive coloring for PureBasic keywords, strings, comments, and constants.
• Run: Quickly run your code without debugging using Ctrl+F5.
• Debug: Launch the external PureBasic Debugger seamlessly with F5.
• Build: Compile your code into an executable.
• Auto-Discovery: Automatically finds the PureBasic compiler (pbcompiler) in standard installation locations.

---

Requirements

• PureBasic Installed: You must have PureBasic installed on your system.
• Compiler Path: If the extension cannot find pbcompiler automatically, you may need to configure the path.

---

Setup

1. Install the Extension.
2. Open a PureBasic file (.pb).
3. Run or Debug:
   • Press F5 to Start Debugging (launches code with the /DEBUGGER flag, opening the PureBasic standalone debugger).
   • Press Ctrl+F5 to Run Without Debugging.
4. Build:
   • Open the Command Palette (Ctrl+Shift+P).
   • Type PureBasic: Build Executable to compile your code into an .exe file.

Configuration

If your PureBasic installation is in a custom location, add the following to your VS Code settings.json:

{
    "purebasic.compilerPath": "C:\\MyCustomPath\\PureBasic\\Compilers\\pbcompiler.exe"
}

---

Known Issues

• The extension relies on the external PureBasic debugger window; it does not currently integrate into the VS Code debug pane variables/watch window.

---

Release Notes

0.0.1

• Initial release with syntax highlighting, run, and debug support.

---

Building from Source

To build the extension from source:

1. Clone the repository:

   git clone https://github.com/duty1g/vscode-purebasic.git
   cd vscode-purebasic

2. Install dependencies:

   npm install

3. Package the extension:

   npm run package

   This will generate a .vsix file in the dist/ folder.

---

License

PureBasic Syntax Highlighter for VS Code is licensed under the MIT License. Made with 🖤 by @duty1g