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.2

• @SIMPLE_CONFIG support: Full support for simple config files, including validation, navigation, completions, and scaffolding.
• Improved YAML compatibility: Better coexistence with the Red Hat YAML extension; artificonfig features only activate for files containing artificonfig markers.
• Major internal refactor: The server is now fully modular, with dedicated modules for Python class resolution, config link navigation, validation, and symbol extraction. This makes the extension more maintainable and ready for future features.
• Up-to-date features: Real-time validation, improved navigation, and smarter autocompletion for artificonfig workflows.

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.2.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.