Bob/bob-language-extension/INSTALLATION.md
Bobby Lucero 72a1b82b43 More things
- Add while, for, and do-while loops with break/continue
- Implement assignment statements (prevents if(x=10) bugs)
- Keep assignment expressions only for for-loop clauses
- Fix critical memory management bug (dangling pointers in cleanup)
- Add automatic memory cleanup with conservative reference counting
- Consolidate documentation into single reference file
- Add comprehensive test coverage for all loop types and edge cases
- VSCode extension for bob highlighting and snippets
2025-08-06 00:57:36 -04:00

2.7 KiB

Bob Language Extension Installation Guide

Quick Installation

cd bob-language-extension
./install.sh

Option 2: Manual Installation

  1. Copy the extension files to your VS Code extensions directory:

    • macOS: ~/.vscode/extensions/bob-language-0.1.0/
    • Linux: ~/.vscode/extensions/bob-language-0.1.0/
    • Windows: %APPDATA%\Code\User\extensions\bob-language-0.1.0\
  2. Restart VS Code/Cursor

Option 3: VSIX Package

cd bob-language-extension
./package-vsix.sh

Then install the generated .vsix file in VS Code/Cursor.

Features Included

Syntax Highlighting

  • Keywords: if, else, while, for, break, continue, return, var, func
  • Built-in functions: print, assert, input, type, toString, toNumber, time
  • Data types: numbers, strings, booleans, none
  • Operators: arithmetic, comparison, logical, bitwise, compound assignment

Code Snippets

Type these prefixes and press Tab:

  • func - Function definition
  • if - If statement
  • while - While loop
  • for - For loop
  • var - Variable declaration
  • print - Print statement
  • assert - Assert statement
  • anon - Anonymous function
  • test - Test function

Language Features

  • Auto-closing brackets and quotes
  • Smart indentation
  • Comment support (// and /* */)
  • Code folding
  • Hover information for built-in functions
  • IntelliSense completion

Color Theme

  • "Bob Dark" theme included
  • Optimized colors for Bob syntax

Testing the Extension

  1. Open VS Code/Cursor
  2. Open the example.bob file in the extension directory
  3. You should see syntax highlighting, code completion, and snippets working

File Association

Files with .bob extension will automatically be recognized as Bob language files.

Troubleshooting

Extension not working?

  1. Check that the extension is installed in the correct directory
  2. Restart VS Code/Cursor completely
  3. Check the Extensions panel (Ctrl+Shift+X) to see if the extension is listed

Syntax highlighting not working?

  1. Make sure your file has a .bob extension
  2. Check the language mode in the bottom-right corner of VS Code
  3. Manually select "Bob" as the language mode if needed

Snippets not working?

  1. Type the snippet prefix (e.g., func)
  2. Press Ctrl+Space to trigger suggestions
  3. Select the snippet and press Tab

Development

To modify the extension:

  1. Edit the files in the extension directory
  2. Run npm run compile to rebuild TypeScript
  3. Reload VS Code/Cursor to see changes

Support

For issues or questions:

  1. Check the README.md file
  2. Look at the example.bob file for syntax examples
  3. Review the TextMate grammar in syntaxes/bob.tmLanguage.json