File: utility_core.go

package info (click to toggle)
arduino-cli 1.2.2-1
  • links: PTS, VCS
  • area: main
  • in suites: experimental
  • size: 65,096 kB
  • sloc: cpp: 6,520; sh: 196; python: 30; makefile: 28
file content (79 lines) | stat: -rw-r--r-- 3,197 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
// This file is part of arduino-cli.
//
// Copyright 2020 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 (
	"github.com/arduino/arduino-cli/internal/arduino/cores"
	rpc "github.com/arduino/arduino-cli/rpc/cc/arduino/cli/commands/v1"
)

// platformToRPCPlatformMetadata converts our internal structure to the RPC structure.
func platformToRPCPlatformMetadata(platform *cores.Platform) *rpc.PlatformMetadata {
	return &rpc.PlatformMetadata{
		Id:                platform.String(),
		Maintainer:        platform.Package.Maintainer,
		Website:           platform.Package.WebsiteURL,
		Email:             platform.Package.Email,
		ManuallyInstalled: platform.ManuallyInstalled,
		Deprecated:        platform.Deprecated,
		Indexed:           platform.Indexed,
	}
}

// platformReleaseToRPC converts our internal structure to the RPC structure.
// Note: this function does not touch the "Installed" field of rpc.Platform as it's not always clear that the
// platformRelease we're currently converting is actually installed.
func platformReleaseToRPC(platformRelease *cores.PlatformRelease) *rpc.PlatformRelease {
	// If the boards are not installed yet, the `platformRelease.Boards` will be a zero length slice.
	// In such case, we have to use the `platformRelease.BoardsManifest` instead.
	// So that we can retrieve the name of the boards at least.
	var boards []*rpc.Board
	if len(platformRelease.Boards) > 0 {
		boards = make([]*rpc.Board, len(platformRelease.Boards))
		i := 0
		for _, b := range platformRelease.Boards {
			boards[i] = &rpc.Board{
				Name: b.Name(),
				Fqbn: b.FQBN(),
			}
			i++
		}
	} else {
		boards = make([]*rpc.Board, len(platformRelease.BoardsManifest))
		i := 0
		for _, m := range platformRelease.BoardsManifest {
			boards[i] = &rpc.Board{
				Name: m.Name,
				// FQBN is not available. Boards have to be installed first (-> `boards.txt`).
			}
			i++
		}
	}

	// This field make sense only if the platformRelease is installed otherwise is an "undefined behaviour"
	missingMetadata := platformRelease.IsInstalled() && !platformRelease.HasMetadata()
	return &rpc.PlatformRelease{
		Name:            platformRelease.Name,
		Help:            &rpc.HelpResources{Online: platformRelease.Platform.Package.Help.Online},
		Boards:          boards,
		Version:         platformRelease.Version.String(),
		Installed:       platformRelease.IsInstalled(),
		MissingMetadata: missingMetadata,
		Types:           []string{platformRelease.Category},
		Deprecated:      platformRelease.Deprecated,
		Compatible:      platformRelease.IsCompatible(),
	}
}