Allow tool to be downloaded without index

design/pkgs.go

@@ -86,7 +86,8 @@ var IndexPayload = Type("arduino.index", func() {
 })
 
 var ToolPayload = Type("arduino.tool", func() {
-	Description("A tool is an executable program that can upload sketches.")
+	Description(`A tool is an executable program that can upload sketches. 
+	If url is absent the tool will be searched among the package index installed`)
 	TypeName("ToolPayload")
 
 	Attribute("name", String, "The name of the tool", func() {
@@ -99,6 +100,12 @@ var ToolPayload = Type("arduino.tool", func() {
 		Example("arduino")
 	})
 
+	Attribute("url", String, `The url where the package can be found. Optional. 
+	If present checksum must also be present.`)
+
+	Attribute("checksum", String, `A checksum of the archive. Mandatory when url is present. 
+	This ensures that the package is downloaded correcly.`)
+
 	Required("name", "version", "packager")
 })
 

gen/http/openapi.yaml

@@ -39,7 +39,7 @@ paths:
             type: array
             items:
               type: string
-              example: Qui magnam saepe quisquam.
+              example: Harum nostrum qui ipsa minima quia dolorem.
         "400":
           description: Bad Request response.
           schema:
@@ -160,6 +160,11 @@ paths:
         description: The version of the tool
         required: true
         type: string
+      - name: RemoveRequestBody
+        in: body
+        required: true
+        schema:
+          $ref: '#/definitions/ToolsRemoveRequestBody'
       responses:
         "200":
           description: OK response.
@@ -215,7 +220,7 @@ definitions:
       temporary:
         type: boolean
         description: Is the error temporary?
-        example: true
+        example: false
       timeout:
         type: boolean
         description: Is the error a timeout?
@@ -226,8 +231,8 @@ definitions:
       id: 123abc
       message: parameter 'p' must be an integer
       name: bad_request
-      temporary: false
-      timeout: false
+      temporary: true
+      timeout: true
     required:
     - name
     - id
@@ -242,7 +247,7 @@ definitions:
       fault:
         type: boolean
         description: Is the error a server-side fault?
-        example: false
+        example: true
       id:
         type: string
         description: ID is a unique identifier for this particular occurrence of the
@@ -264,15 +269,15 @@ definitions:
       timeout:
         type: boolean
         description: Is the error a timeout?
-        example: true
+        example: false
     description: url invalid (default view)
     example:
-      fault: true
+      fault: false
       id: 123abc
       message: parameter 'p' must be an integer
       name: bad_request
-      temporary: true
-      timeout: true
+      temporary: false
+      timeout: false
     required:
     - name
     - id
@@ -287,7 +292,7 @@ definitions:
       fault:
         type: boolean
         description: Is the error a server-side fault?
-        example: true
+        example: false
       id:
         type: string
         description: ID is a unique identifier for this particular occurrence of the
@@ -312,11 +317,11 @@ definitions:
         example: true
     description: url invalid (default view)
     example:
-      fault: true
+      fault: false
       id: 123abc
       message: parameter 'p' must be an integer
       name: bad_request
-      temporary: false
+      temporary: true
       timeout: false
     required:
     - name
@@ -355,6 +360,11 @@ definitions:
     title: ToolsInstallRequestBody
     type: object
     properties:
+      checksum:
+        type: string
+        description: "A checksum of the archive. Mandatory when url is present. \n\tThis
+          ensures that the package is downloaded correcly."
+        example: Occaecati eum.
       name:
         type: string
         description: The name of the tool
@@ -363,18 +373,42 @@ definitions:
         type: string
         description: The packager of the tool
         example: arduino
+      url:
+        type: string
+        description: "The url where the package can be found. Optional. \n\tIf present
+          checksum must also be present."
+        example: Sit quod dolor repellat.
       version:
         type: string
         description: The version of the tool
         example: 6.3.0-arduino9
     example:
+      checksum: Id ut totam.
       name: avrdude
       packager: arduino
+      url: Vero ipsum corporis nihil.
       version: 6.3.0-arduino9
     required:
     - name
     - version
     - packager
+  ToolsRemoveRequestBody:
+    title: ToolsRemoveRequestBody
+    type: object
+    properties:
+      checksum:
+        type: string
+        description: "A checksum of the archive. Mandatory when url is present. \n\tThis
+          ensures that the package is downloaded correcly."
+        example: Nobis officia optio inventore.
+      url:
+        type: string
+        description: "The url where the package can be found. Optional. \n\tIf present
+          checksum must also be present."
+        example: Inventore exercitationem.
+    example:
+      checksum: Qui modi dolorem.
+      url: In voluptatibus.
   ToolsToolResponseCollection:
     title: 'Mediatype identifier: application/vnd.arduino.tool; type=collection; view=default'
     type: array
@@ -389,3 +423,9 @@ definitions:
     - name: avrdude
       packager: arduino
       version: 6.3.0-arduino9
+    - name: avrdude
+      packager: arduino
+      version: 6.3.0-arduino9
+    - name: avrdude
+      packager: arduino
+      version: 6.3.0-arduino9