refactor: Replace hardcoded language config with API-based dynamic loading

- Add GetLanguageTools() API client for /api/v3/languages/tools
- Replace embedded YAML with BuildLanguagesConfigFromAPI()
- Clean tool-to-API-language mapping instead of complex switch logic
- Update integration tests with richer API-sourced extensions

Eliminates tech debt and provides dynamic file extension updates.

Author: andrzej-janczak

cmd/analyze.go

@@ -7,6 +7,7 @@ import (
 	"codacy/cli-v2/tools"
 	"codacy/cli-v2/tools/lizard"
 	reviveTool "codacy/cli-v2/tools/revive"
+	"codacy/cli-v2/utils/logger"
 	"encoding/json"
 	"fmt"
 	"log"
@@ -18,6 +19,7 @@ import (
 
 	codacyclient "codacy/cli-v2/codacy-client"
 
+	"github.com/sirupsen/logrus"
 	"github.com/spf13/cobra"
 	"gopkg.in/yaml.v3"
 )
@@ -373,6 +375,9 @@ func runTool(workDirectory string, toolName string, pathsToCheck []string, outpu
 func validatePaths(paths []string) error {
 	for _, path := range paths {
 		if _, err := os.Stat(path); os.IsNotExist(err) {
+			logger.Error("Analysis failed because path does not exist", logrus.Fields{
+				"path": path,
+			})
 			return fmt.Errorf("❌ Error: cannot find file or directory '%s'", path)
 		}
 	}

cmd/configsetup/setup.go

@@ -18,6 +18,8 @@ import (
 	"codacy/cli-v2/tools/pylint"
 	reviveTool "codacy/cli-v2/tools/revive"
 	"codacy/cli-v2/utils"
+
+	"gopkg.in/yaml.v3"
 )
 
 // Configuration file names - extracted as constants to avoid duplication
@@ -194,33 +196,24 @@ func (r *reviveConfigCreator) GetConfigFileName() string { return "revive.toml"
 func (r *reviveConfigCreator) GetToolName() string       { return "Revive" }
 
 func CreateLanguagesConfigFileLocal(toolsConfigDir string) error {
-	content := `tools:
-    - name: pylint
-      languages: [Python]
-      extensions: [.py]
-    - name: eslint
-      languages: [JavaScript, TypeScript, JSX, TSX]
-      extensions: [.js, .jsx, .ts, .tsx]
-    - name: pmd
-      languages: [Java, JavaScript, JSP, Velocity, XML, Apex, Scala, Ruby, VisualForce]
-      extensions: [.java, .js, .jsp, .vm, .xml, .cls, .trigger, .scala, .rb, .page, .component]
-    - name: trivy
-      languages: [Multiple]
-      extensions: []
-    - name: dartanalyzer
-      languages: [Dart]
-      extensions: [.dart]
-    - name: lizard
-      languages: [C, CPP, Java, "C#", JavaScript, TypeScript, VueJS, "Objective-C", Swift, Python, Ruby, "TTCN-3", PHP, Scala, GDScript, Golang, Lua, Rust, Fortran, Kotlin, Solidity, Erlang, Zig, Perl]
-      extensions: [.c, .cpp, .cc, .h, .hpp, .java, .cs, .js, .jsx, .ts, .tsx, .vue, .m, .swift, .py, .rb, .ttcn, .php, .scala, .gd, .go, .lua, .rs, .f, .f90, .kt, .sol, .erl, .zig, .pl]
-    - name: semgrep
-      languages: [C, CPP, "C#", Generic, Go, Java, JavaScript, JSON, Kotlin, Python, TypeScript, Ruby, Rust, JSX, PHP, Scala, Swift, Terraform]
-      extensions: [.c, .cpp, .h, .hpp, .cs, .go, .java, .js, .json, .kt, .py, .ts, .rb, .rs, .jsx, .php, .scala, .swift, .tf, .tfvars]
-    - name: codacy-enigma-cli
-      languages: [Multiple]
-      extensions: []`
-
-	return writeConfigFile(filepath.Join(toolsConfigDir, LanguagesConfigFileName), []byte(content))
+	// Build tool language configurations from API
+	configTools, err := tools.BuildLanguagesConfigFromAPI()
+	if err != nil {
+		return fmt.Errorf("failed to build languages config from API: %w", err)
+	}
+
+	// Create the config structure
+	config := domain.LanguagesConfig{
+		Tools: configTools,
+	}
+
+	// Marshal to YAML
+	data, err := yaml.Marshal(config)
+	if err != nil {
+		return fmt.Errorf("failed to marshal languages config to YAML: %w", err)
+	}
+
+	return writeConfigFile(filepath.Join(toolsConfigDir, LanguagesConfigFileName), data)
 }
 
 func CreateGitIgnoreFile() error {

codacy-client/client.go

@@ -253,3 +253,21 @@ func GetRepositoryLanguages(initFlags domain.InitFlags) ([]domain.Language, erro
 
 	return languagesResponse.Languages, nil
 }
+
+// GetLanguageTools fetches the default language file extensions from the API
+func GetLanguageTools() ([]domain.LanguageTool, error) {
+	baseURL := fmt.Sprintf("%s/api/v3/languages/tools", CodacyApiBase)
+
+	bodyResponse, err := getRequest(baseURL, "")
+	if err != nil {
+		return nil, fmt.Errorf("failed to get language tools: %w", err)
+	}
+
+	var languageToolsResponse domain.LanguageToolsResponse
+	err = json.Unmarshal(bodyResponse, &languageToolsResponse)
+	if err != nil {
+		return nil, fmt.Errorf("failed to unmarshal language tools response: %w", err)
+	}
+
+	return languageToolsResponse.Data, nil
+}

domain/language.go

@@ -14,6 +14,17 @@ type LanguagesResponse struct {
 	Languages []Language `json:"languages"`
 }
 
+// LanguageTool represents a language tool with its file extensions from the API
+type LanguageTool struct {
+	Name           string   `json:"name"`
+	FileExtensions []string `json:"fileExtensions"`
+}
+
+// LanguageToolsResponse represents the structure of the language tools API response
+type LanguageToolsResponse struct {
+	Data []LanguageTool `json:"data"`
+}
+
 // ToolLanguageInfo contains language and extension information for a tool
 type ToolLanguageInfo struct {
 	Name       string   `yaml:"name"`

integration-tests/config-discover/expected/tools-configs/languages-config.yaml

@@ -7,19 +7,22 @@ tools:
       extensions: [.dart]
     - name: eslint
       languages: [JavaScript, TypeScript, JSX, TSX]
-      extensions: [.js, .jsx, .ts, .tsx]
+      extensions: [.js, .jsm, .jsx, .mjs, .ts, .tsx, .vue]
     - name: lizard
       languages: [C, CPP, Java, C#, JavaScript, TypeScript, VueJS, Objective-C, Swift, Python, Ruby, TTCN-3, PHP, Scala, GDScript, Golang, Lua, Rust, Fortran, Kotlin, Solidity, Erlang, Zig, Perl]
-      extensions: [.c, .cpp, .cc, .h, .hpp, .java, .cs, .js, .jsx, .ts, .tsx, .vue, .m, .swift, .py, .rb, .ttcn, .php, .scala, .gd, .go, .lua, .rs, .f, .f90, .kt, .sol, .erl, .zig, .pl]
+      extensions: [.c, .cc, .cpp, .cxx, .gemspec, .go, .h, .hpp, .ino, .java, .jbuilder, .js, .jsm, .jsx, .kt, .kts, .mjs, .opal, .php, .podspec, .py, .rake, .rb, .rlib, .rs, .scala, .swift, .ts, .tsx, .vue]
     - name: pmd
       languages: [Java, JavaScript, JSP, Velocity, XML, Apex, Scala, Ruby, VisualForce]
-      extensions: [.java, .js, .jsp, .vm, .xml, .cls, .trigger, .scala, .rb, .page, .component]
+      extensions: [.gemspec, .java, .jbuilder, .js, .jsm, .jsx, .mjs, .opal, .podspec, .pom, .rake, .rb, .scala, .vue, .wsdl, .xml, .xsl]
     - name: pylint
       languages: [Python]
       extensions: [.py]
+    - name: revive
+      languages: [Go]
+      extensions: [.go]
     - name: semgrep
       languages: [C, CPP, C#, Generic, Go, Java, JavaScript, JSON, Kotlin, Python, TypeScript, Ruby, Rust, JSX, PHP, Scala, Swift, Terraform]
-      extensions: [.c, .cpp, .h, .hpp, .cs, .go, .java, .js, .json, .kt, .py, .ts, .rb, .rs, .jsx, .php, .scala, .swift, .tf, .tfvars]
+      extensions: [.c, .cc, .cpp, .cxx, .gemspec, .go, .h, .hpp, .ino, .java, .jbuilder, .js, .jsm, .json, .jsx, .kt, .kts, .mjs, .opal, .php, .podspec, .py, .rake, .rb, .rlib, .rs, .scala, .swift, .tf, .ts, .tsx, .vue]
     - name: trivy
       languages: [Multiple]
       extensions: []

integration-tests/init-with-token/expected/tools-configs/languages-config.yaml

@@ -1,19 +1,28 @@
 tools:
+    - name: codacy-enigma-cli
+      languages: [Multiple]
+      extensions: []
+    - name: dartanalyzer
+      languages: [Dart]
+      extensions: [.dart]
+    - name: eslint
+      languages: [JavaScript, TypeScript, JSX, TSX]
+      extensions: [.js, .jsm, .jsx, .mjs, .ts, .tsx, .vue]
+    - name: lizard
+      languages: [C, CPP, Java, C#, JavaScript, TypeScript, VueJS, Objective-C, Swift, Python, Ruby, TTCN-3, PHP, Scala, GDScript, Golang, Lua, Rust, Fortran, Kotlin, Solidity, Erlang, Zig, Perl]
+      extensions: [.c, .cc, .cpp, .cxx, .gemspec, .go, .h, .hpp, .ino, .java, .jbuilder, .js, .jsm, .jsx, .kt, .kts, .mjs, .opal, .php, .podspec, .py, .rake, .rb, .rlib, .rs, .scala, .swift, .ts, .tsx, .vue]
+    - name: pmd
+      languages: [Java, JavaScript, JSP, Velocity, XML, Apex, Scala, Ruby, VisualForce]
+      extensions: [.gemspec, .java, .jbuilder, .js, .jsm, .jsx, .mjs, .opal, .podspec, .pom, .rake, .rb, .scala, .vue, .wsdl, .xml, .xsl]
     - name: pylint
       languages: [Python]
       extensions: [.py]
-    - name: lizard
-      languages: [Java, JavaScript, Python]
-      extensions: [.java, .js, .jsm, .jsx, .mjs, .py, .vue]
-    - name: pmd
-      languages: [Java, JavaScript]
-      extensions: [.java, .js, .jsm, .jsx, .mjs, .vue]
-    - name: eslint
-      languages: [JavaScript]
-      extensions: [.js, .jsm, .jsx, .mjs, .vue]
+    - name: revive
+      languages: [Go]
+      extensions: [.go]
+    - name: semgrep
+      languages: [C, CPP, C#, Generic, Go, Java, JavaScript, JSON, Kotlin, Python, TypeScript, Ruby, Rust, JSX, PHP, Scala, Swift, Terraform]
+      extensions: [.c, .cc, .cpp, .cxx, .gemspec, .go, .h, .hpp, .ino, .java, .jbuilder, .js, .jsm, .json, .jsx, .kt, .kts, .mjs, .opal, .php, .podspec, .py, .rake, .rb, .rlib, .rs, .scala, .swift, .tf, .ts, .tsx, .vue]
     - name: trivy
       languages: [Multiple]
       extensions: []
-    - name: semgrep
-      languages: [Java, JavaScript, JSON, Python]
-      extensions: [.java, .js, .jsm, .json, .jsx, .mjs, .py, .vue]

integration-tests/init-without-token/expected/tools-configs/languages-config.yaml

@@ -1,25 +1,28 @@
 tools:
-    - name: pylint
-      languages: [Python]
-      extensions: [.py]
-    - name: eslint
-      languages: [JavaScript, TypeScript, JSX, TSX]
-      extensions: [.js, .jsx, .ts, .tsx]
-    - name: pmd
-      languages: [Java, JavaScript, JSP, Velocity, XML, Apex, Scala, Ruby, VisualForce]
-      extensions: [.java, .js, .jsp, .vm, .xml, .cls, .trigger, .scala, .rb, .page, .component]
-    - name: trivy
+    - name: codacy-enigma-cli
       languages: [Multiple]
       extensions: []
     - name: dartanalyzer
       languages: [Dart]
       extensions: [.dart]
+    - name: eslint
+      languages: [JavaScript, TypeScript, JSX, TSX]
+      extensions: [.js, .jsm, .jsx, .mjs, .ts, .tsx, .vue]
     - name: lizard
-      languages: [C, CPP, Java, "C#", JavaScript, TypeScript, VueJS, "Objective-C", Swift, Python, Ruby, "TTCN-3", PHP, Scala, GDScript, Golang, Lua, Rust, Fortran, Kotlin, Solidity, Erlang, Zig, Perl]
-      extensions: [.c, .cpp, .cc, .h, .hpp, .java, .cs, .js, .jsx, .ts, .tsx, .vue, .m, .swift, .py, .rb, .ttcn, .php, .scala, .gd, .go, .lua, .rs, .f, .f90, .kt, .sol, .erl, .zig, .pl]
+      languages: [C, CPP, Java, C#, JavaScript, TypeScript, VueJS, Objective-C, Swift, Python, Ruby, TTCN-3, PHP, Scala, GDScript, Golang, Lua, Rust, Fortran, Kotlin, Solidity, Erlang, Zig, Perl]
+      extensions: [.c, .cc, .cpp, .cxx, .gemspec, .go, .h, .hpp, .ino, .java, .jbuilder, .js, .jsm, .jsx, .kt, .kts, .mjs, .opal, .php, .podspec, .py, .rake, .rb, .rlib, .rs, .scala, .swift, .ts, .tsx, .vue]
+    - name: pmd
+      languages: [Java, JavaScript, JSP, Velocity, XML, Apex, Scala, Ruby, VisualForce]
+      extensions: [.gemspec, .java, .jbuilder, .js, .jsm, .jsx, .mjs, .opal, .podspec, .pom, .rake, .rb, .scala, .vue, .wsdl, .xml, .xsl]
+    - name: pylint
+      languages: [Python]
+      extensions: [.py]
+    - name: revive
+      languages: [Go]
+      extensions: [.go]
     - name: semgrep
-      languages: [C, CPP, "C#", Generic, Go, Java, JavaScript, JSON, Kotlin, Python, TypeScript, Ruby, Rust, JSX, PHP, Scala, Swift, Terraform]
-      extensions: [.c, .cpp, .h, .hpp, .cs, .go, .java, .js, .json, .kt, .py, .ts, .rb, .rs, .jsx, .php, .scala, .swift, .tf, .tfvars]
-    - name: codacy-enigma-cli
+      languages: [C, CPP, C#, Generic, Go, Java, JavaScript, JSON, Kotlin, Python, TypeScript, Ruby, Rust, JSX, PHP, Scala, Swift, Terraform]
+      extensions: [.c, .cc, .cpp, .cxx, .gemspec, .go, .h, .hpp, .ino, .java, .jbuilder, .js, .jsm, .json, .jsx, .kt, .kts, .mjs, .opal, .php, .podspec, .py, .rake, .rb, .rlib, .rs, .scala, .swift, .tf, .ts, .tsx, .vue]
+    - name: trivy
       languages: [Multiple]
       extensions: []

tools/language_config.go

@@ -68,6 +68,77 @@ func GetDefaultToolLanguageMapping() map[string]domain.ToolLanguageInfo {
 	return DefaultToolLanguageMap
 }
 
+// BuildLanguagesConfigFromAPI builds the tool language configuration from API data
+func BuildLanguagesConfigFromAPI() ([]domain.ToolLanguageInfo, error) {
+	// Fetch language tools from API
+	languageTools, err := codacyclient.GetLanguageTools()
+	if err != nil {
+		return nil, fmt.Errorf("failed to fetch language tools from API: %w", err)
+	}
+
+	// Create a map of language names to file extensions from API
+	languageExtensionsMap := make(map[string][]string)
+	for _, langTool := range languageTools {
+		languageExtensionsMap[strings.ToLower(langTool.Name)] = langTool.FileExtensions
+	}
+
+	// Simple mapping: tool → real API languages it supports
+	toolToAPILanguages := map[string][]string{
+		"pylint":            {"python"},
+		"eslint":            {"javascript", "typescript"},
+		"pmd":               {"java", "javascript", "jsp", "velocity", "xml", "apex", "scala", "ruby", "visualforce"},
+		"trivy":             {}, // Special case - works with multiple languages
+		"dartanalyzer":      {"dart"},
+		"lizard":            {"c", "cpp", "java", "csharp", "javascript", "typescript", "objective c", "swift", "python", "ruby", "php", "scala", "go", "rust", "fortran", "kotlin"},
+		"semgrep":           {"c", "cpp", "csharp", "go", "java", "javascript", "json", "kotlin", "python", "typescript", "ruby", "rust", "php", "scala", "swift", "terraform"},
+		"codacy-enigma-cli": {}, // Special case - works with multiple languages
+		"revive":            {"go"},
+	}
+
+	// Build tool configurations
+	var configTools []domain.ToolLanguageInfo
+	for _, toolInfo := range DefaultToolLanguageMap {
+		// Get API languages this tool supports
+		apiLanguages, exists := toolToAPILanguages[toolInfo.Name]
+		if !exists {
+			// Fallback to original configuration if tool not in mapping
+			configTools = append(configTools, toolInfo)
+			continue
+		}
+
+		updatedTool := domain.ToolLanguageInfo{
+			Name:       toolInfo.Name,
+			Languages:  toolInfo.Languages, // Keep original language names for display
+			Extensions: []string{},
+		}
+
+		// Build extensions set from API data
+		extensionsSet := make(map[string]struct{})
+		for _, apiLang := range apiLanguages {
+			if extensions, exists := languageExtensionsMap[apiLang]; exists {
+				for _, ext := range extensions {
+					extensionsSet[ext] = struct{}{}
+				}
+			}
+		}
+
+		// Convert set to sorted slice
+		for ext := range extensionsSet {
+			updatedTool.Extensions = append(updatedTool.Extensions, ext)
+		}
+		slices.Sort(updatedTool.Extensions)
+
+		// If no extensions found from API, fallback to hardcoded extensions
+		if len(updatedTool.Extensions) == 0 {
+			updatedTool.Extensions = toolInfo.Extensions
+		}
+
+		configTools = append(configTools, updatedTool)
+	}
+
+	return configTools, nil
+}
+
 // CreateLanguagesConfigFile creates languages-config.yaml based on API response
 func CreateLanguagesConfigFile(apiTools []domain.Tool, toolsConfigDir string, toolIDMap map[string]string, initFlags domain.InitFlags) error {
 	// Build a list of tool language info for enabled tools