[breaking] refactor: made some golang modules private (#2447)

* Replaced 'executils' with go-paths library equivalent

* Made 'buildcache' private

* Made 'table'' private

* Updated docs

Author: cmaglie

.licenses/go/github.com/arduino/go-paths-helper.dep.yml

@@ -1,6 +1,6 @@
 ---
 name: github.com/arduino/go-paths-helper
-version: v1.9.2
+version: v1.10.0
 type: go
 summary: 
 homepage: https://pkg.go.dev/github.com/arduino/go-paths-helper

arduino/builder/builder.go

@@ -33,7 +33,6 @@ import (
 	"github.com/arduino/arduino-cli/arduino/libraries"
 	"github.com/arduino/arduino-cli/arduino/libraries/librariesmanager"
 	"github.com/arduino/arduino-cli/arduino/sketch"
-	"github.com/arduino/arduino-cli/executils"
 	rpc "github.com/arduino/arduino-cli/rpc/cc/arduino/cli/commands/v1"
 	"github.com/arduino/go-paths-helper"
 	"github.com/arduino/go-properties-orderedmap"
@@ -492,7 +491,7 @@ func (b *Builder) build() error {
 	return nil
 }
 
-func (b *Builder) prepareCommandForRecipe(buildProperties *properties.Map, recipe string, removeUnsetProperties bool) (*executils.Process, error) {
+func (b *Builder) prepareCommandForRecipe(buildProperties *properties.Map, recipe string, removeUnsetProperties bool) (*paths.Process, error) {
 	pattern := buildProperties.Get(recipe)
 	if pattern == "" {
 		return nil, fmt.Errorf(tr("%[1]s pattern is missing"), recipe)
@@ -525,7 +524,7 @@ func (b *Builder) prepareCommandForRecipe(buildProperties *properties.Map, recip
 		}
 	}
 
-	command, err := executils.NewProcess(nil, parts...)
+	command, err := paths.NewProcess(nil, parts...)
 	if err != nil {
 		return nil, err
 	}
@@ -536,7 +535,7 @@ func (b *Builder) prepareCommandForRecipe(buildProperties *properties.Map, recip
 	return command, nil
 }
 
-func (b *Builder) execCommand(command *executils.Process) error {
+func (b *Builder) execCommand(command *paths.Process) error {
 	if b.logger.Verbose() {
 		b.logger.Info(utils.PrintableCommand(command.GetArgs()))
 		command.RedirectStdoutTo(b.logger.Stdout())

arduino/builder/core.go

@@ -24,8 +24,8 @@ import (
 
 	"github.com/arduino/arduino-cli/arduino/builder/cpp"
 	"github.com/arduino/arduino-cli/arduino/builder/internal/utils"
-	"github.com/arduino/arduino-cli/buildcache"
 	f "github.com/arduino/arduino-cli/internal/algorithms"
+	"github.com/arduino/arduino-cli/internal/buildcache"
 	"github.com/arduino/go-paths-helper"
 	"github.com/pkg/errors"
 )

arduino/builder/internal/compilation/database.go

@@ -20,7 +20,6 @@ import (
 	"fmt"
 	"os"
 
-	"github.com/arduino/arduino-cli/executils"
 	"github.com/arduino/arduino-cli/i18n"
 	"github.com/arduino/go-paths-helper"
 )
@@ -71,7 +70,7 @@ func (db *Database) SaveToFile() {
 }
 
 // Add adds a new CompilationDatabase entry
-func (db *Database) Add(target *paths.Path, command *executils.Process) {
+func (db *Database) Add(target *paths.Path, command *paths.Process) {
 	commandDir := command.GetDir()
 	if commandDir == "" {
 		// This mimics what Cmd.Run also does: Use Dir if specified,

arduino/builder/internal/compilation/database_test.go

@@ -18,7 +18,6 @@ package compilation
 import (
 	"testing"
 
-	"github.com/arduino/arduino-cli/executils"
 	"github.com/arduino/go-paths-helper"
 	"github.com/stretchr/testify/require"
 )
@@ -28,7 +27,7 @@ func TestCompilationDatabase(t *testing.T) {
 	require.NoError(t, err)
 	defer tmpfile.Remove()
 
-	cmd, err := executils.NewProcess(nil, "gcc", "arg1", "arg2")
+	cmd, err := paths.NewProcess(nil, "gcc", "arg1", "arg2")
 	require.NoError(t, err)
 	db := NewDatabase(tmpfile)
 	db.Add(paths.New("test"), cmd)

arduino/builder/internal/diagnostics/compiler_detection.go

@@ -20,7 +20,7 @@ import (
 	"path/filepath"
 	"strings"
 
-	"github.com/arduino/arduino-cli/executils"
+	"github.com/arduino/go-paths-helper"
 	semver "go.bug.st/relaxed-semver"
 )
 
@@ -34,7 +34,7 @@ type DetectedCompiler struct {
 
 // This function is overridden for mocking unit tests
 var runProcess = func(args ...string) []string {
-	if cmd, err := executils.NewProcess(nil, args...); err == nil {
+	if cmd, err := paths.NewProcess(nil, args...); err == nil {
 		out := &bytes.Buffer{}
 		cmd.RedirectStdoutTo(out)
 		cmd.Run()

arduino/builder/internal/preprocessor/arduino_preprocessor.go

@@ -23,7 +23,6 @@ import (
 
 	"github.com/arduino/arduino-cli/arduino/builder/internal/utils"
 	"github.com/arduino/arduino-cli/arduino/sketch"
-	"github.com/arduino/arduino-cli/executils"
 	"github.com/arduino/go-paths-helper"
 	"github.com/arduino/go-properties-orderedmap"
 	"github.com/pkg/errors"
@@ -66,7 +65,7 @@ func PreprocessSketchWithArduinoPreprocessor(sk *sketch.Sketch, buildPath *paths
 		return nil, nil, errors.WithStack(err)
 	}
 
-	command, err := executils.NewProcess(nil, parts...)
+	command, err := paths.NewProcess(nil, parts...)
 	if err != nil {
 		return nil, nil, err
 	}

arduino/builder/internal/preprocessor/ctags.go

@@ -27,7 +27,6 @@ import (
 	"github.com/arduino/arduino-cli/arduino/builder/cpp"
 	"github.com/arduino/arduino-cli/arduino/builder/internal/preprocessor/internal/ctags"
 	"github.com/arduino/arduino-cli/arduino/sketch"
-	"github.com/arduino/arduino-cli/executils"
 	"github.com/arduino/arduino-cli/i18n"
 	"github.com/arduino/go-paths-helper"
 	"github.com/arduino/go-properties-orderedmap"
@@ -195,7 +194,7 @@ func RunCTags(sourceFile *paths.Path, buildProperties *properties.Map) ([]byte,
 	if err != nil {
 		return nil, nil, err
 	}
-	proc, err := executils.NewProcess(nil, parts...)
+	proc, err := paths.NewProcess(nil, parts...)
 	if err != nil {
 		return nil, nil, err
 	}

arduino/builder/internal/preprocessor/gcc.go

@@ -21,7 +21,6 @@ import (
 	"strings"
 
 	"github.com/arduino/arduino-cli/arduino/builder/cpp"
-	"github.com/arduino/arduino-cli/executils"
 	f "github.com/arduino/arduino-cli/internal/algorithms"
 	"github.com/arduino/go-paths-helper"
 	"github.com/arduino/go-properties-orderedmap"
@@ -69,7 +68,7 @@ func GCC(sourceFilePath *paths.Path, targetFilePath *paths.Path, includes paths.
 	// to create a /dev/null.d dependency file, which won't work.
 	args = f.Filter(args, f.NotEquals("-MMD"))
 
-	proc, err := executils.NewProcess(nil, args...)
+	proc, err := paths.NewProcess(nil, args...)
 	if err != nil {
 		return nil, nil, err
 	}

arduino/cores/packagemanager/install_uninstall.go

@@ -24,7 +24,6 @@ import (
 	"github.com/arduino/arduino-cli/arduino"
 	"github.com/arduino/arduino-cli/arduino/cores"
 	"github.com/arduino/arduino-cli/arduino/cores/packageindex"
-	"github.com/arduino/arduino-cli/executils"
 	rpc "github.com/arduino/arduino-cli/rpc/cc/arduino/cli/commands/v1"
 	"github.com/arduino/go-paths-helper"
 	"github.com/pkg/errors"
@@ -239,7 +238,7 @@ func (pme *Explorer) RunPreOrPostScript(installDir *paths.Path, prefix string) (
 	}
 	script := installDir.Join(scriptFilename)
 	if script.Exist() && script.IsNotDir() {
-		cmd, err := executils.NewProcessFromPath(pme.GetEnvVarsForSpawnedProcess(), script)
+		cmd, err := paths.NewProcessFromPath(pme.GetEnvVarsForSpawnedProcess(), script)
 		if err != nil {
 			return []byte{}, []byte{}, err
 		}