OBDb tooling

A Visual Studio Code extension for OBDb signal editing tooling.

Features

• Hover Information: Hover over signal IDs in JSON files to see which model years support the specific signal

Requirements

• VS Code version 1.99.0 or higher
• A project structure that includes model year test cases in tests/test_cases/[year] directories

Installation

From VSIX File

1. Download the latest .vsix file from the releases page
2. In VS Code, go to Extensions view (Ctrl+Shift+X)
3. Click "..." at the top of the Extensions view
4. Select "Install from VSIX..." and choose the downloaded file

In devcontainers

Add to your devcontainer.json:

"customizations": {
  "vscode": {
    "extensions": [
      "https://github.com/OBDb/vscode-obdb/releases/download/v[VERSION]/signalid-hover-info-[VERSION].vsix"
    ]
  }
}

Replace [VERSION] with the actual version number.

How It Works

The extension:

1. Detects when you hover over an ID in a JSON file within the signalsets directory
2. Scans the project structure for matching signal IDs in test cases across different model years
3. Displays a hover card showing all model years that support the specific signal ID

Development

Setup

# Install dependencies
npm install

# Compile the extension
npm run compile

# Watch mode during development
npm run watch

Build & Package

# Prepare for publishing
npm run vscode:prepublish

# Package as VSIX
npm install -g @vscode/vsce
vsce package

Release Process

This extension uses GitHub Actions for automated builds and releases:

1. Create and push a tag with format v*.*.* (e.g., v0.1.0)
2. The CI will automatically build, package, and create a GitHub release

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.