@@ -22,160 +22,263 @@ option go_package = "github.com/arduino/arduino-cli/rpc/commands";
22
22
import "commands/common.proto" ;
23
23
24
24
message LibraryDownloadReq {
25
+ // Arduino Core Service instance from the `Init` response.
25
26
Instance instance = 1 ;
27
+ // Name of the library.
26
28
string name = 2 ;
29
+ // The version of the library to download.
27
30
string version = 3 ;
28
31
}
29
32
30
33
message LibraryDownloadResp {
34
+ // Progress of the library download.
31
35
DownloadProgress progress = 1 ;
32
36
}
33
37
34
38
message LibraryInstallReq {
39
+ // Arduino Core Service instance from the `Init` response.
35
40
Instance instance = 1 ;
41
+ // Name of the library.
36
42
string name = 2 ;
43
+ // The version of the library to install.
37
44
string version = 3 ;
38
45
}
39
46
40
47
message LibraryInstallResp {
48
+ // Progress of the library download.
41
49
DownloadProgress progress = 1 ;
50
+ // Description of the current stage of the installation.
42
51
TaskProgress task_progress = 2 ;
43
52
}
44
53
45
54
message LibraryUninstallReq {
55
+ // Arduino Core Service instance from the `Init` response.
46
56
Instance instance = 1 ;
57
+ // Name of the library.
47
58
string name = 2 ;
59
+ // The version of the library to uninstall.
48
60
string version = 3 ;
49
61
}
50
62
51
63
message LibraryUninstallResp {
64
+ // Description of the current stage of the uninstallation.
52
65
TaskProgress task_progress = 1 ;
53
66
}
54
67
55
68
message LibraryUpgradeAllReq {
69
+ // Arduino Core Service instance from the `Init` response.
56
70
Instance instance = 1 ;
57
71
}
58
72
59
73
message LibraryUpgradeAllResp {
74
+ // Progress of the downloads of files needed for the upgrades.
60
75
DownloadProgress progress = 1 ;
76
+ // Description of the current stage of the upgrade.
61
77
TaskProgress task_progress = 2 ;
62
78
}
63
79
64
80
message LibraryResolveDependenciesReq {
81
+ // Arduino Core Service instance from the `Init` response.
65
82
Instance instance = 1 ;
83
+ // Name of the library.
66
84
string name = 2 ;
85
+ // The version of the library to check dependencies of. If no version is
86
+ // specified, dependencies of the newest version will be listed.
67
87
string version = 3 ;
68
88
}
69
89
70
90
message LibraryResolveDependenciesResp {
91
+ // Dependencies of the library.
71
92
repeated LibraryDependencyStatus dependencies = 1 ;
72
93
}
73
94
74
95
message LibraryDependencyStatus {
96
+ // The name of the library dependency.
75
97
string name = 1 ;
98
+ // The required version of the library dependency.
76
99
string versionRequired = 2 ;
100
+ // Version of the library dependency currently installed.
77
101
string versionInstalled = 3 ;
78
102
}
79
103
80
104
message LibrarySearchReq {
105
+ // Arduino Core Service instance from the `Init` response.
81
106
Instance instance = 1 ;
107
+ // The search query.
82
108
string query = 2 ;
83
109
}
84
110
85
111
enum LibrarySearchStatus {
112
+ // No search results were found.
86
113
failed = 0 ;
114
+ // Search results were found.
87
115
success = 1 ;
88
116
}
89
117
90
118
message LibrarySearchResp {
119
+ // The results of the search.
91
120
repeated SearchedLibrary libraries = 1 ;
121
+ // Whether the search yielded results.
92
122
LibrarySearchStatus status = 2 ;
93
123
}
94
124
95
125
message SearchedLibrary {
126
+ // Library name.
96
127
string name = 1 ;
128
+ // The index data for the available versions of the library. The key of the
129
+ // map is the library version.
97
130
map <string , LibraryRelease > releases = 2 ;
131
+ // The index data for the latest version of the library.
98
132
LibraryRelease latest = 3 ;
99
133
}
100
134
101
135
message LibraryRelease {
136
+ // Value of the `author` field in library.properties.
102
137
string author = 1 ;
138
+ // Value of the `version` field in library.properties.
103
139
string version = 2 ;
140
+ // Value of the `maintainer` field in library.properties.
104
141
string maintainer = 3 ;
142
+ // Value of the `sentence` field in library.properties.
105
143
string sentence = 4 ;
144
+ // Value of the `paragraph` field in library.properties.
106
145
string paragraph = 5 ;
146
+ // Value of the `url` field in library.properties.
107
147
string website = 6 ;
148
+ // Value of the `category` field in library.properties.
108
149
string category = 7 ;
150
+ // Value of the `architectures` field in library.properties.
109
151
repeated string architectures = 8 ;
152
+ // The type categories of the library, as defined in the libraries index.
153
+ // Possible values: `Arduino`, `Partner`, `Recommended`, `Contributed`,
154
+ // `Retired`.
110
155
repeated string types = 9 ;
156
+ // Information about the library archive file.
111
157
DownloadResource resources = 10 ;
158
+ // Value of the `license` field in library.properties.
112
159
string license = 11 ;
160
+ // Value of the `includes` field in library.properties.
113
161
repeated string provides_includes = 12 ;
162
+ // The names of the library's dependencies, as defined by the 'depends'
163
+ // field of library.properties.
114
164
repeated LibraryDependency dependencies = 13 ;
115
165
}
116
166
117
167
message LibraryDependency {
168
+ // Library name of the dependency.
118
169
string name = 1 ;
170
+ // Version constraint of the dependency.
119
171
string version_constraint = 2 ;
120
172
}
121
173
122
174
message DownloadResource {
175
+ // Download URL of the library archive.
123
176
string url = 1 ;
177
+ // Filename of the library archive.
124
178
string archivefilename = 2 ;
179
+ // Checksum of the library archive.
125
180
string checksum = 3 ;
181
+ // File size of the library archive.
126
182
int64 size = 4 ;
183
+ // The directory under the staging subdirectory of the data directory the
184
+ // library archive file will be downloaded to.
127
185
string cachepath = 5 ;
128
186
}
129
187
130
188
message LibraryListReq {
189
+ // Arduino Core Service instance from the `Init` response.
131
190
Instance instance = 1 ;
191
+ // Whether to include built-in libraries (from platforms and the Arduino
192
+ // IDE) in the listing.
132
193
bool all = 2 ;
194
+ // Whether to list only libraries for which there is a newer version than
195
+ // the installed version available in the libraries index.
133
196
bool updatable = 3 ;
134
197
}
135
198
136
199
message LibraryListResp {
200
+ // List of installed libraries.
137
201
repeated InstalledLibrary installed_library = 1 ;
138
202
}
139
203
140
204
message InstalledLibrary {
205
+ // Information about the library.
141
206
Library library = 1 ;
207
+ // When the `updatable` field of the `LibraryList` request is set to `true`,
208
+ // this will contain information on the latest version of the library in the
209
+ // libraries index.
142
210
LibraryRelease release = 2 ;
143
211
}
144
212
145
213
message Library {
214
+ // The library's directory name.
146
215
string name = 1 ;
216
+ // Value of the `author` field in library.properties.
147
217
string author = 2 ;
218
+ // Value of the `maintainer` field in library.properties.
148
219
string maintainer = 3 ;
220
+ // Value of the `sentence` field in library.properties.
149
221
string sentence = 4 ;
222
+ // Value of the `paragraph` field in library.properties.
150
223
string paragraph = 5 ;
224
+ // Value of the `url` field in library.properties.
151
225
string website = 6 ;
226
+ // Value of the `category` field in library.properties.
152
227
string category = 7 ;
228
+ // Value of the `architectures` field in library.properties.
153
229
repeated string architectures = 8 ;
230
+ // The type categories of the library. Possible values: `Arduino`,
231
+ // `Partner`, `Recommended`, `Contributed`, `Retired`.
154
232
repeated string types = 9 ;
233
+ // The path of the library directory.
155
234
string install_dir = 10 ;
235
+ // The location of the library's source files.
156
236
string source_dir = 11 ;
237
+ // The location of the library's `utility` directory.
157
238
string utility_dir = 12 ;
239
+ // If `location` is `platform_builtin` or `referenced_platform_builtin`, the
240
+ // identifying string for the platform containing the library
241
+ // (e.g., `arduino:avr@1.8.2`).
158
242
string container_platform = 14 ;
243
+ // Value of the `name` field in library.properties.
159
244
string real_name = 16 ;
245
+ // Value of the `dot_a_linkage` field in library.properties.
160
246
bool dot_a_linkage = 17 ;
247
+ // Value of the `precompiled` field in library.properties.
161
248
bool precompiled = 18 ;
249
+ // Value of the `ldflags` field in library.properties.
162
250
string ld_flags = 19 ;
251
+ // A library.properties file is not present in the library's root directory.
163
252
bool is_legacy = 20 ;
253
+ // Value of the `version` field in library.properties.
164
254
string version = 21 ;
255
+ // Value of the `license` field in library.properties.
165
256
string license = 22 ;
257
+ // The data from the library's library.properties file, including unused
258
+ // fields.
166
259
map <string , string > properties = 23 ;
260
+ // The location type of the library installation.
167
261
LibraryLocation location = 24 ;
262
+ // The library format type.
168
263
LibraryLayout layout = 25 ;
169
264
}
170
265
171
266
enum LibraryLayout {
267
+ // Library is in the 1.0 Arduino library format.
172
268
flat_layout = 0 ;
269
+ // Library is in the 1.5 Arduino library format.
173
270
recursive_layout = 1 ;
174
271
}
175
272
176
273
enum LibraryLocation {
274
+ // In the `libraries` subdirectory of the Arduino IDE installation.
177
275
ide_builtin = 0 ;
178
- user = 1 ; // (sketchbook)
276
+ // In the `libraries` subdirectory of the user directory (sketchbook).
277
+ user = 1 ;
278
+ // In the `libraries` subdirectory of a platform.
179
279
platform_builtin = 2 ;
280
+ // When `LibraryLocation` is used in a context where a board is specified,
281
+ // this indicates the library is in the `libraries` subdirectory of a
282
+ // platform referenced by the board's platform.
180
283
referenced_platform_builtin = 3 ;
181
284
}
0 commit comments