Artificonfig VSCode Extension

A modern, modular VSCode extension for working with artificonfig YAML and JSON configuration files. Provides real-time validation, intelligent navigation, and robust autocompletion for Python-based configuration workflows.

What's New in v1.4.4

• Improved language selection: Only .json and .yaml files under a configs folder are now associated with the Artificonfig language. Files outside these folders are not affected.
• Better word/module definition: Word definition now matches the entire module string, not just single words, for more accurate navigation and validation.
• Improved class existence resolution: Python module resolution is now performed using a Python script, supporting internal libraries and imports defined in __init__.py files. This enables more robust and accurate class validation.
• YAML linting scope improved: Linting is now only applied to .yaml files under configs directories, avoiding false positives elsewhere.
• Performance: Caching is still in place for Python module resolution, improving performance, though initial loading may take about 1s.

Features

• Syntax Highlighting: For YAML and JSON artificonfig files.
• Go to Definition: Instantly jump to Python class definitions (local or installed) referenced in __config_class and __target_class fields.
• CONFIG_LINK Navigation: Click on @CONFIG_LINK references to open linked configuration files or directories.
• Real-Time Validation: See errors and warnings as you type, including missing classes, broken links, and schema issues.
• Autocompletion: Get suggestions for artificonfig keywords, class names, and config parameters.
• Easy Configuration Creation: Use commands to scaffold new command, object, or simple configuration files in YAML or JSON.

Installation

Install directly from the VSCode Marketplace (recommended):

1. Open VSCode and go to the Extensions view (Ctrl+Shift+X)
2. Search for artificonfig-vscode and click Install

Or, install from a VSIX file:

code --install-extension artificonfig-vscode-1.4.4.vsix

Commands

• Artificonfig: Create Command Configuration – Scaffold a new command config file
• Artificonfig: Create Object Configuration – Scaffold a new object config file
• Artificonfig: Create Simple Configuration – Scaffold a new simple config file

Usage

• Go to Definition: Place your cursor on a Python class reference and press F12 or right-click → Go to Definition.
• CONFIG_LINK Navigation: Click on @CONFIG_LINK references to open the linked config file or directory.
• Autocompletion: Start typing artificonfig keywords or class names for suggestions.
• Validation: Errors and warnings appear as you type, and in the Problems panel.

Requirements

• VSCode 1.74.0 or higher
• Python extension (for best class navigation)

Extension Settings

• artificonfig.scanWorkspaceOnStartup: Enable/disable scanning the workspace for Python files on startup (default: off; now handled at runtime).

Known Issues

• Some advanced Python class resolution may not work for all class definitions or environments.
• Navigation to installed packages depends on Python environment detection.
• If you use the Red Hat YAML extension, conflicts may occur.