Add first set of profile commands

commands/cmderrors/cmderrors.go

@@ -211,6 +211,20 @@ func (e *UnknownProfileError) GRPCStatus() *status.Status {
 	return status.New(codes.NotFound, e.Error())
 }
 
+// DuplicateProfileError is returned when the profile is a duplicate of an already existing one
+type DuplicateProfileError struct {
+	Profile string
+}
+
+func (e *DuplicateProfileError) Error() string {
+	return i18n.Tr("Profile '%s' already exists", e.Profile)
+}
+
+// GRPCStatus converts the error into a *status.Status
+func (e *DuplicateProfileError) GRPCStatus() *status.Status {
+	return status.New(codes.NotFound, e.Error())
+}
+
 // InvalidProfileError is returned when the profile has errors
 type InvalidProfileError struct {
 	Cause error
@@ -435,7 +449,7 @@ func (e *PlatformLoadingError) Unwrap() error {
 	return e.Cause
 }
 
-// LibraryNotFoundError is returned when a platform is not found
+// LibraryNotFoundError is returned when a library is not found
 type LibraryNotFoundError struct {
 	Library string
 	Cause   error
@@ -883,3 +897,15 @@ func (e *InstanceNeedsReinitialization) GRPCStatus() *status.Status {
 		WithDetails(&rpc.InstanceNeedsReinitializationError{})
 	return st
 }
+
+// MissingProfileError is returned when the Profile is mandatory and not specified
+type MissingProfileError struct{}
+
+func (e *MissingProfileError) Error() string {
+	return i18n.Tr("Missing Profile name")
+}
+
+// GRPCStatus converts the error into a *status.Status
+func (e *MissingProfileError) GRPCStatus() *status.Status {
+	return status.New(codes.InvalidArgument, e.Error())
+}

commands/service_profile_dump.go

@@ -0,0 +1,47 @@
+// This file is part of arduino-cli.
+//
+// Copyright 2025 ARDUINO SA (http://www.arduino.cc/)
+//
+// This software is released under the GNU General Public License version 3,
+// which covers the main part of arduino-cli.
+// The terms of this license can be found at:
+// https://www.gnu.org/licenses/gpl-3.0.en.html
+//
+// You can be released from the requirements of the above licenses by purchasing
+// a commercial license. Buying such a license is mandatory if you want to
+// modify or otherwise use the software for commercial activities involving the
+// Arduino software without disclosing the source code of your own applications.
+// To purchase a commercial license, send an email to license@arduino.cc.
+
+package commands
+
+import (
+	"context"
+	"encoding/json"
+	"fmt"
+
+	"github.com/arduino/arduino-cli/commands/cmderrors"
+	"github.com/arduino/arduino-cli/internal/arduino/sketch"
+	rpc "github.com/arduino/arduino-cli/rpc/cc/arduino/cli/commands/v1"
+	"github.com/arduino/go-paths-helper"
+)
+
+// ProfileDump dumps the content of the project file.
+func (s *arduinoCoreServerImpl) ProfileDump(ctx context.Context, req *rpc.ProfileDumpRequest) (*rpc.ProfileDumpResponse, error) {
+	sk, err := sketch.New(paths.New(req.GetSketchPath()))
+	if err != nil {
+		return nil, err
+	}
+	switch req.GetDumpFormat() {
+	case "yaml":
+		return &rpc.ProfileDumpResponse{EncodedProfile: sk.Project.AsYaml()}, nil
+	case "json":
+		data, err := json.MarshalIndent(sk.Project, "", "  ")
+		if err != nil {
+			return nil, fmt.Errorf("error marshalling settings: %v", err)
+		}
+		return &rpc.ProfileDumpResponse{EncodedProfile: string(data)}, nil
+	default:
+		return nil, &cmderrors.InvalidArgumentError{Message: fmt.Sprintf("unsupported format: %s", req.GetDumpFormat())}
+	}
+}

commands/service_profile_init.go

@@ -0,0 +1,114 @@
+// This file is part of arduino-cli.
+//
+// Copyright 2025 ARDUINO SA (http://www.arduino.cc/)
+//
+// This software is released under the GNU General Public License version 3,
+// which covers the main part of arduino-cli.
+// The terms of this license can be found at:
+// https://www.gnu.org/licenses/gpl-3.0.en.html
+//
+// You can be released from the requirements of the above licenses by purchasing
+// a commercial license. Buying such a license is mandatory if you want to
+// modify or otherwise use the software for commercial activities involving the
+// Arduino software without disclosing the source code of your own applications.
+// To purchase a commercial license, send an email to license@arduino.cc.
+
+package commands
+
+import (
+	"context"
+	"errors"
+	"fmt"
+	"sync"
+
+	"github.com/arduino/arduino-cli/commands/cmderrors"
+	"github.com/arduino/arduino-cli/commands/internal/instances"
+	"github.com/arduino/arduino-cli/internal/arduino/sketch"
+	"github.com/arduino/arduino-cli/internal/i18n"
+	"github.com/arduino/arduino-cli/pkg/fqbn"
+	rpc "github.com/arduino/arduino-cli/rpc/cc/arduino/cli/commands/v1"
+	"github.com/arduino/go-paths-helper"
+)
+
+// InitProfile creates a new project file if it does not exist. If a profile name with the associated FQBN is specified,
+// it is added to the project.
+func (s *arduinoCoreServerImpl) InitProfile(ctx context.Context, req *rpc.InitProfileRequest) (*rpc.InitProfileResponse, error) {
+	sketchPath := paths.New(req.GetSketchPath())
+	projectFilePath, err := sketchPath.Join("sketch.yaml").Abs()
+	if err != nil {
+		return nil, err
+	}
+
+	// Returns an error if the main file is missing from the sketch so there is no need to check if the path exists
+	sk, err := sketch.New(sketchPath)
+	if err != nil {
+		return nil, err
+	}
+
+	if !projectFilePath.Exist() {
+		err := projectFilePath.WriteFile([]byte("profiles:\n"))
+		if err != nil {
+			return nil, err
+		}
+	}
+
+	if req.GetProfileName() != "" {
+		if req.GetFqbn() == "" {
+			return nil, &cmderrors.MissingFQBNError{}
+		}
+
+		// Check that the profile name is unique
+		if profile, _ := sk.GetProfile(req.ProfileName); profile != nil {
+			return nil, &cmderrors.DuplicateProfileError{Profile: req.ProfileName}
+		}
+
+		pme, release, err := instances.GetPackageManagerExplorer(req.GetInstance())
+		if err != nil {
+			return nil, err
+		}
+		release = sync.OnceFunc(release)
+		defer release()
+
+		if pme.Dirty() {
+			return nil, &cmderrors.InstanceNeedsReinitialization{}
+		}
+
+		fqbn, err := fqbn.Parse(req.GetFqbn())
+		if err != nil {
+			return nil, &cmderrors.InvalidFQBNError{Cause: err}
+		}
+
+		// Automatically detect the target platform if it is installed on the user's machine
+		_, targetPlatform, _, _, _, err := pme.ResolveFQBN(fqbn)
+		if err != nil {
+			if targetPlatform == nil {
+				return nil, &cmderrors.PlatformNotFoundError{
+					Platform: fmt.Sprintf("%s:%s", fqbn.Vendor, fqbn.Architecture),
+					Cause:    errors.New(i18n.Tr("platform not installed")),
+				}
+			}
+			return nil, &cmderrors.InvalidFQBNError{Cause: err}
+		}
+
+		newProfile := &sketch.Profile{Name: req.GetProfileName(), FQBN: req.GetFqbn()}
+		// TODO: what to do with the PlatformIndexURL?
+		newProfile.Platforms = append(newProfile.Platforms, &sketch.ProfilePlatformReference{
+			Packager:     targetPlatform.Platform.Package.Name,
+			Architecture: targetPlatform.Platform.Architecture,
+			Version:      targetPlatform.Version,
+		})
+
+		sk.Project.Profiles = append(sk.Project.Profiles, newProfile)
+		// Set the profile as the default one if it's the only one
+		if req.DefaultProfile || len(sk.Project.Profiles) == 1 {
+			sk.Project.DefaultProfile = newProfile.Name
+		}
+
+		err = projectFilePath.WriteFile([]byte(sk.Project.AsYaml()))
+		if err != nil {
+			return nil, err
+		}
+	}
+
+	return &rpc.InitProfileResponse{ProjectFilePath: projectFilePath.String()}, nil
+}

commands/service_profile_lib_add.go

@@ -0,0 +1,86 @@
+// This file is part of arduino-cli.
+//
+// Copyright 2025 ARDUINO SA (http://www.arduino.cc/)
+//
+// This software is released under the GNU General Public License version 3,
+// which covers the main part of arduino-cli.
+// The terms of this license can be found at:
+// https://www.gnu.org/licenses/gpl-3.0.en.html
+//
+// You can be released from the requirements of the above licenses by purchasing
+// a commercial license. Buying such a license is mandatory if you want to
+// modify or otherwise use the software for commercial activities involving the
+// Arduino software without disclosing the source code of your own applications.
+// To purchase a commercial license, send an email to license@arduino.cc.
+
+package commands
+
+import (
+	"context"
+
+	"github.com/arduino/arduino-cli/commands/cmderrors"
+	"github.com/arduino/arduino-cli/commands/internal/instances"
+	"github.com/arduino/arduino-cli/internal/arduino/sketch"
+	rpc "github.com/arduino/arduino-cli/rpc/cc/arduino/cli/commands/v1"
+	paths "github.com/arduino/go-paths-helper"
+)
+
+// ProfileLibAdd adds a library to the specified profile or to the default profile.
+func (s *arduinoCoreServerImpl) ProfileLibAdd(ctx context.Context, req *rpc.ProfileLibAddRequest) (*rpc.ProfileLibAddResponse, error) {
+	sketchPath := paths.New(req.GetSketchPath())
+	projectFilePath, err := sketchPath.Join("sketch.yaml").Abs()
+	if err != nil {
+		return nil, err
+	}
+
+	// Returns an error if the main file is missing from the sketch so there is no need to check if the path exists
+	sk, err := sketch.New(sketchPath)
+	if err != nil {
+		return nil, err
+	}
+
+	// If no profile is specified, try to use the default one
+	profileName := sk.Project.DefaultProfile
+	if req.GetProfileName() != "" {
+		profileName = req.GetProfileName()
+	}
+	if profileName == "" {
+		return nil, &cmderrors.MissingProfileError{}
+	}
+
+	profile, err := sk.GetProfile(profileName)
+	if err != nil {
+		return nil, err
+	}
+
+	// Obtain the library index from the manager
+	li, err := instances.GetLibrariesIndex(req.GetInstance())
+	if err != nil {
+		return nil, err
+	}
+	version, err := parseVersion(req.LibVersion)
+	if err != nil {
+		return nil, err
+	}
+	libRelease, err := li.FindRelease(req.GetLibName(), version)
+	if err != nil {
+		return nil, err
+	}
+
+	// If the library has been already added to the profile, just update the version
+	if lib, _ := profile.GetLibrary(req.LibName, false); lib != nil {
+		lib.Version = libRelease.GetVersion()
+	} else {
+		profile.Libraries = append(profile.Libraries, &sketch.ProfileLibraryReference{
+			Library: req.GetLibName(),
+			Version: libRelease.GetVersion(),
+		})
+	}
+
+	err = projectFilePath.WriteFile([]byte(sk.Project.AsYaml()))
+	if err != nil {
+		return nil, err
+	}
+
+	return &rpc.ProfileLibAddResponse{LibName: req.LibName, LibVersion: libRelease.GetVersion().String(), ProfileName: profileName}, nil
+}

commands/service_profile_lib_remove.go

@@ -0,0 +1,66 @@
+// This file is part of arduino-cli.
+//
+// Copyright 2025 ARDUINO SA (http://www.arduino.cc/)
+//
+// This software is released under the GNU General Public License version 3,
+// which covers the main part of arduino-cli.
+// The terms of this license can be found at:
+// https://www.gnu.org/licenses/gpl-3.0.en.html
+//
+// You can be released from the requirements of the above licenses by purchasing
+// a commercial license. Buying such a license is mandatory if you want to
+// modify or otherwise use the software for commercial activities involving the
+// Arduino software without disclosing the source code of your own applications.
+// To purchase a commercial license, send an email to license@arduino.cc.
+
+package commands
+
+import (
+	"context"
+
+	"github.com/arduino/arduino-cli/commands/cmderrors"
+	"github.com/arduino/arduino-cli/internal/arduino/sketch"
+	rpc "github.com/arduino/arduino-cli/rpc/cc/arduino/cli/commands/v1"
+	paths "github.com/arduino/go-paths-helper"
+)
+
+// ProfileLibRemove removes a library from the specified profile or from the default profile.
+func (s *arduinoCoreServerImpl) ProfileLibRemove(ctx context.Context, req *rpc.ProfileLibRemoveRequest) (*rpc.ProfileLibRemoveResponse, error) {
+	sketchPath := paths.New(req.GetSketchPath())
+	projectFilePath, err := sketchPath.Join("sketch.yaml").Abs()
+	if err != nil {
+		return nil, err
+	}
+
+	// Returns an error if the main file is missing from the sketch so there is no need to check if the path exists
+	sk, err := sketch.New(sketchPath)
+	if err != nil {
+		return nil, err
+	}
+
+	// If no profile is specified, try to use the default one
+	profileName := sk.Project.DefaultProfile
+	if req.GetProfileName() != "" {
+		profileName = req.GetProfileName()
+	}
+	if profileName == "" {
+		return nil, &cmderrors.MissingProfileError{}
+	}
+
+	profile, err := sk.GetProfile(profileName)
+	if err != nil {
+		return nil, err
+	}
+
+	lib, err := profile.GetLibrary(req.LibName, true)
+	if err != nil {
+		return nil, err
+	}
+
+	err = projectFilePath.WriteFile([]byte(sk.Project.AsYaml()))
+	if err != nil {
+		return nil, err
+	}
+
+	return &rpc.ProfileLibRemoveResponse{LibName: lib.Library, LibVersion: lib.Version.String(), ProfileName: profileName}, nil
+}