Merge pull request #127 from arduino/per1234/recursive-default-false

Make the default value of the --recursive flag false

Author: per1234

internal/cli/cli.go

@@ -35,7 +35,7 @@ func Root() *cobra.Command {
 	rootCommand.PersistentFlags().String("format", "text", "The output format can be {text|json}.")
 	rootCommand.PersistentFlags().String("library-manager", "", "Configure the rules for libraries in the Arduino Library Manager index. Can be {submit|update|false}.\nsubmit: Also run additional rules required to pass before a library is accepted for inclusion in the index.\nupdate: Also run additional rules required to pass before new releases of a library already in the index are accepted.\nfalse: Don't run any Library Manager-specific rules.")
 	rootCommand.PersistentFlags().String("project-type", "all", "Only check projects of the specified type and their subprojects. Can be {sketch|library|all}.")
-	rootCommand.PersistentFlags().String("recursive", "true", "Search path recursively for Arduino projects to check. Can be {true|false}.")
+	rootCommand.PersistentFlags().Bool("recursive", false, "Search path recursively for Arduino projects to check. Can be {true|false}.")
 	rootCommand.PersistentFlags().String("report-file", "", "Save a report on the rules to this file.")
 	rootCommand.PersistentFlags().BoolP("verbose", "v", false, "Show more information while running rules.")
 	rootCommand.PersistentFlags().Bool("version", false, "Print version and timestamp of the build.")

internal/configuration/configuration.go

@@ -81,11 +81,7 @@ func Initialize(flags *pflag.FlagSet, projectPaths []string) error {
 		return fmt.Errorf("--project-type flag value %s not valid", superprojectTypeFilterString)
 	}
 
-	recursiveString, _ := flags.GetString("recursive")
-	recursive, err = strconv.ParseBool(recursiveString)
-	if err != nil {
-		return fmt.Errorf("--recursive flag value %s not valid", recursiveString)
-	}
+	recursive, _ = flags.GetBool("recursive")
 
 	reportFilePathString, _ := flags.GetString("report-file")
 	reportFilePath = paths.New(reportFilePathString)

internal/configuration/configuration_test.go

@@ -159,9 +159,6 @@ func TestInitializeProjectType(t *testing.T) {
 func TestInitializeRecursive(t *testing.T) {
 	flags := test.ConfigurationFlags()
 
-	flags.Set("recursive", "foo")
-	assert.Error(t, Initialize(flags, projectPaths))
-
 	flags.Set("recursive", "true")
 	assert.Nil(t, Initialize(flags, projectPaths))
 	assert.True(t, Recursive())

internal/project/packageindex/packageindex.go

@@ -81,5 +81,5 @@ func Find(folderPath *paths.Path) (*paths.Path, error) {
 		}
 	}
 
-	return nil, fmt.Errorf("No package index file found in %s", folderPath)
+	return nil, nil
 }

internal/project/packageindex/packageindex_test.go

@@ -70,7 +70,7 @@ func TestFind(t *testing.T) {
 		{"Single", testDataPath.Join("HasPackageIndex"), testDataPath.Join("HasPackageIndex", "package_foo_index.json"), assert.Nil},
 		{"Multiple", testDataPath.Join("HasMultiple"), testDataPath.Join("HasMultiple", "package_foo_index.json"), assert.Nil},
 		{"Valid extension fallback", testDataPath.Join("HasJSON"), testDataPath.Join("HasJSON", "foo.json"), assert.Nil},
-		{"None", testDataPath.Join("HasNone"), nil, assert.NotNil},
+		{"None", testDataPath.Join("HasNone"), nil, assert.Nil},
 	}
 
 	for _, testTable := range testTables {

internal/project/projectdata/packageindex.go

@@ -21,7 +21,9 @@ import (
 
 // InitializeForPackageIndex gathers the package index rule data for the specified project.
 func InitializeForPackageIndex() {
-	packageIndex, packageIndexLoadError = packageindex.LoadIndex(ProjectPath())
+	if ProjectPath() != nil {
+		packageIndex, packageIndexLoadError = packageindex.LoadIndex(ProjectPath())
+	}
 }
 
 var packageIndex *packageindex.Index

internal/rule/ruleconfiguration/ruleconfiguration.go

@@ -1481,6 +1481,22 @@ var configurations = []Type{
 		ErrorModes:       []rulemode.Type{rulemode.Strict},
 		RuleFunction:     rulefunction.IncorrectArduinoDotHFileNameCase,
 	},
+	{
+		ProjectType:      projecttype.PackageIndex,
+		SuperprojectType: projecttype.All,
+		Category:         "data",
+		Subcategory:      "general",
+		ID:               "IS001",
+		Brief:            "missing",
+		Description:      "",
+		MessageTemplate:  "No package index was found in specified project path. See: https://arduino.github.io/arduino-cli/latest/package_index_json-specification/",
+		DisableModes:     nil,
+		EnableModes:      []rulemode.Type{rulemode.Default},
+		InfoModes:        nil,
+		WarningModes:     nil,
+		ErrorModes:       []rulemode.Type{rulemode.Default},
+		RuleFunction:     rulefunction.PackageIndexMissing,
+	},
 	{
 		ProjectType:      projecttype.PackageIndex,
 		SuperprojectType: projecttype.All,

internal/rule/rulefunction/packageindex.go

@@ -22,8 +22,21 @@ import (
 
 // The rule functions for package indexes.
 
+// PackageIndexMissing checks whether a file resembling a package index was found in the specified project folder.
+func PackageIndexMissing() (result ruleresult.Type, output string) {
+	if projectdata.ProjectPath() == nil {
+		return ruleresult.Fail, ""
+	}
+
+	return ruleresult.Pass, ""
+}
+
 // PackageIndexJSONFormat checks whether the package index file is a valid JSON document.
 func PackageIndexJSONFormat() (result ruleresult.Type, output string) {
+	if projectdata.ProjectPath() == nil {
+		return ruleresult.NotRun, "Package index not found"
+	}
+
 	if isValidJSON(projectdata.ProjectPath()) {
 		return ruleresult.Pass, ""
 	}
@@ -33,6 +46,10 @@ func PackageIndexJSONFormat() (result ruleresult.Type, output string) {
 
 // PackageIndexFormat checks for invalid package index data format.
 func PackageIndexFormat() (result ruleresult.Type, output string) {
+	if projectdata.ProjectPath() == nil {
+		return ruleresult.NotRun, "Package index not found"
+	}
+
 	if projectdata.PackageIndexLoadError() != nil {
 		return ruleresult.Fail, projectdata.PackageIndexLoadError().Error()
 	}

internal/rule/rulefunction/packageindex_test.go

@@ -59,6 +59,15 @@ func checkPackageIndexRuleFunction(ruleFunction Type, testTables []packageIndexR
 	}
 }
 
+func TestPackageIndexMissing(t *testing.T) {
+	testTables := []packageIndexRuleFunctionTestTable{
+		{"Missing", "missing", ruleresult.Fail, ""},
+		{"Present", "valid-package-index", ruleresult.Pass, ""},
+	}
+
+	checkPackageIndexRuleFunction(PackageIndexMissing, testTables, t)
+}
+
 func TestPackageIndexJSONFormat(t *testing.T) {
 	testTables := []packageIndexRuleFunctionTestTable{
 		{"Invalid JSON", "invalid-JSON", ruleresult.Fail, ""},