https://github.com/joshuboi77/c-dictionary
C list of keywords and identifiers built into a VSCode extension
https://github.com/joshuboi77/c-dictionary
c dictionary programming-language vscode vscode-extension
Last synced: 4 months ago
JSON representation
C list of keywords and identifiers built into a VSCode extension
- Host: GitHub
- URL: https://github.com/joshuboi77/c-dictionary
- Owner: joshuboi77
- Created: 2025-09-13T17:10:12.000Z (5 months ago)
- Default Branch: main
- Last Pushed: 2025-09-14T04:08:34.000Z (5 months ago)
- Last Synced: 2025-09-14T06:08:56.630Z (5 months ago)
- Topics: c, dictionary, programming-language, vscode, vscode-extension
- Language: JavaScript
- Homepage:
- Size: 127 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# C Token Analyzer
A VSCode extension that provides live C token analysis with definitions from your comprehensive C dictionary.
## Features
- **Live Hover Information**: Hover over any C token to see its definition and usage
- **Visual Token Analysis Panel**: View all tokens organized by type with positions and descriptions
- **Status Bar Integration**: See current token information in the status bar
- **Comprehensive Dictionary**: Uses your complete C reference dictionary for accurate definitions
- **Real-time Analysis**: Updates as you type
## How to Use
1. **Install the Extension**: Copy the extension folder to your VSCode extensions directory
2. **Open a C File**: The extension activates automatically when you open `.c` files
3. **Hover for Definitions**: Hover over any token (keywords, operators, identifiers) to see definitions
4. **View Token Panel**: Check the "C Token Analysis" panel in the Explorer view
5. **Click Tokens**: Click any token in the panel to open its detailed definition
6. **Browse Dictionary**: Use "Show C Dictionary" command to browse all C language tokens
7. **Command Palette**: Use `Ctrl+Shift+P` and search for "C Token Analyzer" commands
## Commands
- `C Token Analyzer: Show Token Information` - Shows info for token at cursor
- `C Token Analyzer: Analyze Current File` - Analyzes all tokens in current file
- `C Token Analyzer: Show C Dictionary` - Opens the complete C Language Dictionary
- `C Token Analyzer: Show Token Definition` - Shows detailed definition for a specific token
## Requirements
- VSCode 1.74.0 or higher
- **No external files needed** - All 650+ C token definitions are embedded!
## Installation
### Option A: Manual (quickest)
1. Copy the `c-token-analyzer` folder to your VSCode extensions directory:
- Windows: `%USERPROFILE%\.vscode\extensions\`
- macOS: `~/.vscode/extensions/`
- Linux: `~/.vscode/extensions/`
2. Optionally rename to include version, e.g. `c-token-analyzer-0.0.1`
3. Reload VS Code window (`Ctrl+Shift+P` → "Developer: Reload Window")
4. Open a C file to activate the extension
### Option B: Package a VSIX (requires Node.js and `vsce`)
1. Install vsce: `npm i -g @vscode/vsce`
2. Package:
```bash
cd c-token-analyzer
vsce package --allow-missing-repository --skip-license
```
3. Install the generated `.vsix`:
- All platforms: `code --install-extension .vsix`
## Development
To modify or regenerate the embedded dictionary files:
1. Generate the C dictionary JS outputs from `C_Dictionary.md`:
```bash
# From repository root
python generate_c_dictionary_js.py --source C_Dictionary.md --out-dir c-token-analyzer
```
2. Edit `c-token-analyzer/extension.js` or `package.json` as needed
3. Reload VS Code window to see changes
## Features in Detail
### Hover Provider
- Shows token definitions when you hover over C keywords, operators, and identifiers
- Includes examples and detailed descriptions from your C dictionary
### Token Analysis Panel
- **Visual tree view** showing all tokens organized by type
- **Token groups**: keywords, operators, identifiers, literals, strings
- **Click tokens** to jump to their location in the code
- **Hover tooltips** show token descriptions
- **Live updates** as you type
- **Position information** (line:column) for each token
### Status Bar
- Displays current token information as you move your cursor
- Shows token name and type in real-time
### Embedded Dictionary
- **650+ token definitions** embedded directly in the extension
- All definitions extracted from the comprehensive `C_Dictionary.md`
- **Completely portable** - works anywhere without external files
- Covers keywords, operators, and standard library functions
## Configuration
The extension can be configured in VSCode settings:
- `c-token-analyzer.enableHover`: Enable/disable hover information (default: true)
- `c-token-analyzer.showPanel`: Show/hide the token analysis panel (default: true)