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 v2.0.0

Major Features

• Intelligent Autocompletion
  • Smart Python class suggestions from both local and installed packages
  • Multi-level CONFIG_LINK path completion with directory support
  • Context-aware completions for artificonfig keywords and markers

Improvements

• Enhanced Python Integration
  • Improved support for local packages and src/ directory structures
  • Optimized package scanning and caching
  • Better multi-level CONFIG_LINK completions for deep navigation

Fixes

• Fixed JSON CONFIG_LINK underlining for paths with dots and dashes
• Improved CONFIG_LINK resolution logic
• Enhanced validation and navigation capabilities

Previous Updates

• Fixed CONFIG_LINK resolution conflict: Resolved issue where "Follow Link" functionality failed when there was a folder with the same name as a command file. CONFIG_LINK paths now use exact path matching, ensuring accurate navigation to nested configuration files.

Previous Updates (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-2.0.0.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.