fix: reject non-YAML extensions for --sqlconfig flag

Author: dlevy-msft-sql

README.md

@@ -84,6 +84,17 @@ sqlcmd config connection-strings
 sqlcmd config view
 ```
 
+#### Custom Configuration Files
+
+The `--sqlconfig` flag specifies a custom configuration file. Files must be **YAML format** with a `.yaml` or `.yml` extension:
+
+```
+sqlcmd config --sqlconfig ./myproject.yaml add-endpoint --name ep1434 --address localhost --port 1434
+sqlcmd config --sqlconfig ./myproject.yaml view
+```
+
+The default file (`~/.sqlcmd/sqlconfig`) has no extension but is also YAML.
+
 ### Versions
 
 To see all version tags to choose from (2017, 2019, 2022 etc.), and install a specific version, run:

cmd/modern/root.go

@@ -121,7 +121,7 @@ func (c *Root) addGlobalFlags() {
 		String:        &c.configFilename,
 		DefaultString: config.DefaultFileName(),
 		Name:          "sqlconfig",
-		Usage:         localizer.Sprintf("configuration file"),
+		Usage:         localizer.Sprintf("YAML configuration file (.yaml or .yml extension)"),
 	})
 
 	/* BUG(stuartpa): - At the moment this is a top level flag, but it doesn't

internal/config/config.go

@@ -4,12 +4,14 @@
 package config
 
 import (
+	"fmt"
 	. "github.com/microsoft/go-sqlcmd/cmd/modern/sqlconfig"
 	"github.com/microsoft/go-sqlcmd/internal/io/file"
 	"github.com/microsoft/go-sqlcmd/internal/io/folder"
 	"github.com/microsoft/go-sqlcmd/internal/pal"
 	"os"
 	"path/filepath"
+	"strings"
 	"testing"
 )
 
@@ -24,6 +26,13 @@ func SetFileName(name string) {
 		panic("name is empty")
 	}
 
+	ext := strings.ToLower(filepath.Ext(name))
+	if ext != "" && ext != ".yaml" && ext != ".yml" {
+		panic(fmt.Sprintf(
+			"configuration file %q has unsupported extension %q (must be .yaml or .yml)",
+			name, ext))
+	}
+
 	filename = name
 
 	file.CreateEmptyIfNotExists(filename)

internal/config/config_test.go

@@ -392,6 +392,17 @@ func TestNegConfig_SetFileName(t *testing.T) {
 	})
 }
 
+func TestNegConfig_SetFileNameBadExtension(t *testing.T) {
+	assert.PanicsWithValue(t,
+		`configuration file "foo.json" has unsupported extension ".json" (must be .yaml or .yml)`,
+		func() { SetFileName("foo.json") })
+	assert.PanicsWithValue(t,
+		`configuration file "config.toml" has unsupported extension ".toml" (must be .yaml or .yml)`,
+		func() { SetFileName("config.toml") })
+	assert.NotPanics(t, func() { SetFileName(pal.FilenameInUserHomeDotDirectory(".sqlcmd", "sqlconfig-test-yaml.yaml")) })
+	assert.NotPanics(t, func() { SetFileName(pal.FilenameInUserHomeDotDirectory(".sqlcmd", "sqlconfig-test-yml.yml")) })
+}
+
 func TestNegConfig_SetCurrentContextName(t *testing.T) {
 	assert.Panics(t, func() {
 		SetCurrentContextName("does not exist")

internal/translations/catalog.go

@@ -47,11 +47,9 @@
             "fuzzy": true
         },
         {
-            "id": "configuration file",
-            "message": "configuration file",
-            "translation": "Konfigurationsdatei",
-            "translatorComment": "Copied from source.",
-            "fuzzy": true
+            "id": "YAML configuration file (.yaml or .yml extension)",
+            "message": "YAML configuration file (.yaml or .yml extension)",
+            "translation": ""
         },
         {
             "id": "log level, error=0, warn=1, info=2, debug=3, trace=4",

internal/translations/locales/de-DE/out.gotext.json

@@ -47,9 +47,9 @@
             "fuzzy": true
         },
         {
-            "id": "configuration file",
-            "message": "configuration file",
-            "translation": "configuration file",
+            "id": "YAML configuration file (.yaml or .yml extension)",
+            "message": "YAML configuration file (.yaml or .yml extension)",
+            "translation": "YAML configuration file (.yaml or .yml extension)",
             "translatorComment": "Copied from source.",
             "fuzzy": true
         },

internal/translations/locales/en-US/out.gotext.json

@@ -47,11 +47,9 @@
             "fuzzy": true
         },
         {
-            "id": "configuration file",
-            "message": "configuration file",
-            "translation": "archivo de configuración",
-            "translatorComment": "Copied from source.",
-            "fuzzy": true
+            "id": "YAML configuration file (.yaml or .yml extension)",
+            "message": "YAML configuration file (.yaml or .yml extension)",
+            "translation": ""
         },
         {
             "id": "log level, error=0, warn=1, info=2, debug=3, trace=4",

internal/translations/locales/es-ES/out.gotext.json

@@ -47,11 +47,9 @@
             "fuzzy": true
         },
         {
-            "id": "configuration file",
-            "message": "configuration file",
-            "translation": "fichier de configuration",
-            "translatorComment": "Copied from source.",
-            "fuzzy": true
+            "id": "YAML configuration file (.yaml or .yml extension)",
+            "message": "YAML configuration file (.yaml or .yml extension)",
+            "translation": ""
         },
         {
             "id": "log level, error=0, warn=1, info=2, debug=3, trace=4",

internal/translations/locales/fr-FR/out.gotext.json

@@ -47,11 +47,9 @@
             "fuzzy": true
         },
         {
-            "id": "configuration file",
-            "message": "configuration file",
-            "translation": "file di configurazione",
-            "translatorComment": "Copied from source.",
-            "fuzzy": true
+            "id": "YAML configuration file (.yaml or .yml extension)",
+            "message": "YAML configuration file (.yaml or .yml extension)",
+            "translation": ""
         },
         {
             "id": "log level, error=0, warn=1, info=2, debug=3, trace=4",