Add support for .xz and .zst archive format (#2012)

* Upgraded extract to v3.1.0

* Updated docs

.licenses/go/github.com/codeclysm/extract/v3.dep.yml

@@ -1,6 +1,6 @@
 ---
 name: github.com/codeclysm/extract/v3
-version: v3.0.2
+version: v3.1.0
 type: go
 summary: Package extract allows to extract archives in zip, tar.gz or tar.bz2 formats
   easily.

.licenses/go/github.com/h2non/filetype.dep.yml

@@ -1,6 +1,6 @@
 ---
 name: github.com/h2non/filetype
-version: v1.0.8
+version: v1.1.3
 type: go
 summary: 
 homepage: https://pkg.go.dev/github.com/h2non/filetype

.licenses/go/github.com/h2non/filetype/matchers.dep.yml

@@ -1,12 +1,12 @@
 ---
 name: github.com/h2non/filetype/matchers
-version: v1.0.8
+version: v1.1.3
 type: go
 summary: 
 homepage: https://pkg.go.dev/github.com/h2non/filetype/matchers
 license: mit
 licenses:
-- sources: filetype@v1.0.8/LICENSE
+- sources: filetype@v1.1.3/LICENSE
   text: |
     The MIT License
 
@@ -32,6 +32,6 @@ licenses:
     WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
     FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
     OTHER DEALINGS IN THE SOFTWARE.
-- sources: filetype@v1.0.8/README.md
+- sources: filetype@v1.1.3/README.md
   text: MIT - Tomas Aparicio
 notices: []

.licenses/go/github.com/h2non/filetype/matchers/isobmff.dep.yml

@@ -1,12 +1,12 @@
 ---
 name: github.com/h2non/filetype/matchers/isobmff
-version: v1.0.8
+version: v1.1.3
 type: go
 summary: 
 homepage: https://pkg.go.dev/github.com/h2non/filetype/matchers/isobmff
 license: mit
 licenses:
-- sources: filetype@v1.0.8/LICENSE
+- sources: filetype@v1.1.3/LICENSE
   text: |
     The MIT License
 
@@ -32,6 +32,6 @@ licenses:
     WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
     FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
     OTHER DEALINGS IN THE SOFTWARE.
-- sources: filetype@v1.0.8/README.md
+- sources: filetype@v1.1.3/README.md
   text: MIT - Tomas Aparicio
 notices: []

.licenses/go/github.com/h2non/filetype/types.dep.yml

@@ -1,12 +1,12 @@
 ---
 name: github.com/h2non/filetype/types
-version: v1.0.8
+version: v1.1.3
 type: go
 summary: 
 homepage: https://pkg.go.dev/github.com/h2non/filetype/types
 license: mit
 licenses:
-- sources: filetype@v1.0.8/LICENSE
+- sources: filetype@v1.1.3/LICENSE
   text: |
     The MIT License
 
@@ -32,6 +32,6 @@ licenses:
     WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
     FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
     OTHER DEALINGS IN THE SOFTWARE.
-- sources: filetype@v1.0.8/README.md
+- sources: filetype@v1.1.3/README.md
   text: MIT - Tomas Aparicio
 notices: []

.licenses/go/github.com/ulikunitz/xz.dep.yml

@@ -0,0 +1,37 @@
+---
+name: github.com/ulikunitz/xz
+version: v0.5.11
+type: go
+summary: Package xz supports the compression and decompression of xz files.
+homepage: https://pkg.go.dev/github.com/ulikunitz/xz
+license: bsd-3-clause
+licenses:
+- sources: LICENSE
+  text: |
+    Copyright (c) 2014-2022  Ulrich Kunitz
+    All rights reserved.
+
+    Redistribution and use in source and binary forms, with or without
+    modification, are permitted provided that the following conditions are met:
+
+    * Redistributions of source code must retain the above copyright notice, this
+      list of conditions and the following disclaimer.
+
+    * Redistributions in binary form must reproduce the above copyright notice,
+      this list of conditions and the following disclaimer in the documentation
+      and/or other materials provided with the distribution.
+
+    * My name, Ulrich Kunitz, may not be used to endorse or promote products
+      derived from this software without specific prior written permission.
+
+    THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+    AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+    IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+    DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+    FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+    DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+    SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+    CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+    OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+    OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+notices: []

.licenses/go/github.com/ulikunitz/xz/internal/hash.dep.yml

@@ -0,0 +1,37 @@
+---
+name: github.com/ulikunitz/xz/internal/hash
+version: v0.5.11
+type: go
+summary: Package hash provides rolling hashes.
+homepage: https://pkg.go.dev/github.com/ulikunitz/xz/internal/hash
+license: bsd-3-clause
+licenses:
+- sources: xz@v0.5.11/LICENSE
+  text: |
+    Copyright (c) 2014-2022  Ulrich Kunitz
+    All rights reserved.
+
+    Redistribution and use in source and binary forms, with or without
+    modification, are permitted provided that the following conditions are met:
+
+    * Redistributions of source code must retain the above copyright notice, this
+      list of conditions and the following disclaimer.
+
+    * Redistributions in binary form must reproduce the above copyright notice,
+      this list of conditions and the following disclaimer in the documentation
+      and/or other materials provided with the distribution.
+
+    * My name, Ulrich Kunitz, may not be used to endorse or promote products
+      derived from this software without specific prior written permission.
+
+    THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+    AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+    IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+    DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+    FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+    DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+    SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+    CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+    OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+    OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+notices: []

.licenses/go/github.com/ulikunitz/xz/internal/xlog.dep.yml

@@ -0,0 +1,38 @@
+---
+name: github.com/ulikunitz/xz/internal/xlog
+version: v0.5.11
+type: go
+summary: Package xlog provides a simple logging package that allows to disable certain
+  message categories.
+homepage: https://pkg.go.dev/github.com/ulikunitz/xz/internal/xlog
+license: bsd-3-clause
+licenses:
+- sources: xz@v0.5.11/LICENSE
+  text: |
+    Copyright (c) 2014-2022  Ulrich Kunitz
+    All rights reserved.
+
+    Redistribution and use in source and binary forms, with or without
+    modification, are permitted provided that the following conditions are met:
+
+    * Redistributions of source code must retain the above copyright notice, this
+      list of conditions and the following disclaimer.
+
+    * Redistributions in binary form must reproduce the above copyright notice,
+      this list of conditions and the following disclaimer in the documentation
+      and/or other materials provided with the distribution.
+
+    * My name, Ulrich Kunitz, may not be used to endorse or promote products
+      derived from this software without specific prior written permission.
+
+    THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+    AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+    IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+    DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+    FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+    DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+    SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+    CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+    OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+    OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+notices: []

.licenses/go/github.com/ulikunitz/xz/lzma.dep.yml

@@ -0,0 +1,37 @@
+---
+name: github.com/ulikunitz/xz/lzma
+version: v0.5.11
+type: go
+summary: Package lzma supports the decoding and encoding of LZMA streams.
+homepage: https://pkg.go.dev/github.com/ulikunitz/xz/lzma
+license: bsd-3-clause
+licenses:
+- sources: xz@v0.5.11/LICENSE
+  text: |
+    Copyright (c) 2014-2022  Ulrich Kunitz
+    All rights reserved.
+
+    Redistribution and use in source and binary forms, with or without
+    modification, are permitted provided that the following conditions are met:
+
+    * Redistributions of source code must retain the above copyright notice, this
+      list of conditions and the following disclaimer.
+
+    * Redistributions in binary form must reproduce the above copyright notice,
+      this list of conditions and the following disclaimer in the documentation
+      and/or other materials provided with the distribution.
+
+    * My name, Ulrich Kunitz, may not be used to endorse or promote products
+      derived from this software without specific prior written permission.
+
+    THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+    AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+    IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+    DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+    FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+    DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+    SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+    CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+    OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+    OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+notices: []

docs/package_index_json-specification.md

@@ -350,7 +350,11 @@ Here is the Boards Manager entry created by the example: ![Boards Manager screen
 
 ## Installation archive structure
 
-The installation archives contain the Board support files. Supported formats are .zip, .tar.bz2, and .tar.gz.
+The installation archives contain the Board support files.
+
+Supported formats are `.zip`, `.tar.bz2`, and `.tar.gz`. Starting from Arduino CLI >=0.30.0 support for `.tar.xz`, and
+`.tar.zst` has been added, by the way, if you want to keep compatiblity with older versions of Arduino IDE and Arduino
+CLI we recommend using one of the older formats.
 
 The folder structure of the core archive is slightly different from the standard manually installed Arduino IDE 1.5+
 compatible hardware folder structure. You must remove the architecture folder(e.g., `avr` or `arm`), moving all the

docsgen/go.mod

@@ -16,7 +16,7 @@ require (
 	github.com/arduino/go-timeutils v0.0.0-20171220113728-d1dd9e313b1b // indirect
 	github.com/arduino/go-win32-utils v0.0.0-20180330194947-ed041402e83b // indirect
 	github.com/cmaglie/pb v1.0.27 // indirect
-	github.com/codeclysm/extract/v3 v3.0.2 // indirect
+	github.com/codeclysm/extract/v3 v3.1.0 // indirect
 	github.com/cpuguy83/go-md2man/v2 v2.0.0 // indirect
 	github.com/creack/goselect v0.1.2 // indirect
 	github.com/djherbis/buffer v1.1.0 // indirect
@@ -26,13 +26,14 @@ require (
 	github.com/fsnotify/fsnotify v1.4.9 // indirect
 	github.com/gofrs/uuid v3.2.0+incompatible // indirect
 	github.com/golang/protobuf v1.5.2 // indirect
-	github.com/h2non/filetype v1.0.8 // indirect
+	github.com/h2non/filetype v1.1.3 // indirect
 	github.com/hashicorp/hcl v1.0.0 // indirect
 	github.com/inconshreveable/mousetrap v1.0.0 // indirect
 	github.com/jbenet/go-context v0.0.0-20150711004518-d14ea06fba99 // indirect
 	github.com/josharian/intern v1.0.0 // indirect
 	github.com/juju/errors v0.0.0-20181118221551-089d3ea4e4d5 // indirect
 	github.com/kevinburke/ssh_config v0.0.0-20190725054713-01f96b0aa0cd // indirect
+	github.com/klauspost/compress v1.15.13 // indirect
 	github.com/konsorten/go-windows-terminal-sequences v1.0.1 // indirect
 	github.com/leonelquinteros/gotext v1.4.0 // indirect
 	github.com/magiconair/properties v1.8.5 // indirect
@@ -60,6 +61,7 @@ require (
 	github.com/spf13/viper v1.8.1 // indirect
 	github.com/src-d/gcfg v1.4.0 // indirect
 	github.com/subosito/gotenv v1.2.0 // indirect
+	github.com/ulikunitz/xz v0.5.11 // indirect
 	github.com/xanzy/ssh-agent v0.2.1 // indirect
 	go.bug.st/cleanup v1.0.0 // indirect
 	go.bug.st/downloader/v2 v2.1.1 // indirect