https://github.com/soplang/vscodelanguagesupport
vsCode Language Support for Soplang
https://github.com/soplang/vscodelanguagesupport
language-support sop soplang vscode-extension
Last synced: 3 months ago
JSON representation
vsCode Language Support for Soplang
- Host: GitHub
- URL: https://github.com/soplang/vscodelanguagesupport
- Owner: soplang
- License: mit
- Created: 2025-03-06T23:21:13.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-04-11T12:34:20.000Z (about 1 year ago)
- Last Synced: 2025-04-11T13:45:35.896Z (about 1 year ago)
- Topics: language-support, sop, soplang, vscode-extension
- Language: JavaScript
- Homepage:
- Size: 126 KB
- Stars: 6
- Watchers: 1
- Forks: 1
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# Soplang for VS Code
VS Code language support for [Soplang](https://github.com/soplang/soplang), a programming language designed for Somali speakers.
## Features
This extension provides comprehensive language support for Soplang in Visual Studio Code:
- **Syntax Highlighting**: Full syntax highlighting for Soplang keywords, strings, comments, and operators
- **Code Execution**: Run Soplang files directly from VS Code
- **Formatting**: Automatic code formatting for Soplang files
- **Hover Information**: Documentation for Soplang keywords when hovering
- **Spell Checking**: Integration with Code Spell Checker for Soplang keywords
- **Snippets**: Common code snippets for faster development
- **Error Detection**: (Optional) Diagnostics for common syntax errors
## Installation
1. Open VS Code
2. Go to Extensions (Ctrl+Shift+X)
3. Search for "Soplang"
4. Click Install
## Running Soplang Files
You can run Soplang files (`.sop` or `.so` extensions) in multiple ways:
- **Context Menu**: Right-click on a file and select "Run Soplang File"
- **Keyboard Shortcut**: Press `Ctrl+Shift+R` (or `Cmd+Shift+R` on Mac)
- **Command Palette**: Press `Ctrl+Shift+P` and type "Run Soplang File"
- **Editor Title**: Click the Soplang icon in the top-right of the editor
The file will be automatically saved before running.
## Configuration
This extension provides several configuration options:
### Error Detection
By default, error detection is disabled. To enable it:
1. Open Settings (`Ctrl+,`)
2. Search for "soplang"
3. Check the "Enable Diagnostics" option
```json
"soplang.enableDiagnostics": true
```
### Formatting
Automatic formatting on save is enabled by default for Soplang files. You can disable it in the settings:
```json
"[soplang]": {
"editor.formatOnSave": false
}
```
## Language Features
### Syntax Highlighting
All Soplang keywords are properly highlighted:
- `door` - Variable declaration
- `hawl` - Function declaration
- `qor` - Print statement
- `gelin` - Read input
- `haddii`, `haddii_kale`, `ugudambeyn` - Conditionals
- `kuceli`, `intay` - Loops
- ...and many more
### Hover Documentation
Hover over any Soplang keyword to see documentation, examples, and usage tips.
### Code Snippets
Type these prefixes and press Tab to use code snippets:
- `door` - Variable declaration
- `hawl` - Function declaration
- `if` - If statement
- `for` - For loop
- `while` - While loop
## Requirements
- Visual Studio Code v1.95.0 or higher
- The [Code Spell Checker](https://marketplace.visualstudio.com/items?itemName=streetsidesoftware.code-spell-checker) extension (automatically installed)
## Troubleshooting
### Soplang files not running
Make sure the `soplang` command is available in your PATH. If not, you can install it by following the instructions at [Soplang GitHub repository](https://github.com/soplang/soplang).
### Syntax highlighting not working
If syntax highlighting is not working, try:
1. Reload VS Code window (Ctrl+Shift+P > "Reload Window")
2. Ensure the file has `.sop` or `.so` extension
## Contributing
The source code for this extension is available on [GitHub](https://github.com/soplang/vsCodeLanguageSupport). Contributions are welcome!
## License
This extension is licensed under the [MIT License](LICENSE).