YunoHost/doc
1
0
Fork 0
mirror of https://github.com/YunoHost/doc.git synced 2024-09-03 20:06:26 +02:00
Code Issues Projects Releases Packages Wiki Activity

[CI] Update app helpers/resources for debian/11.1.14 (#2236)

Browse source
This commit is contained in:
YunoHost Bot 2023-03-09 17:26:26 +01:00 • committed by GitHub
parent 8752fd9fb8
commit 5a987a0fed
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
2 changed files with 232 additions and 129 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

293
pages/06.contribute/10.packaging_apps/80.resources/11.helpers/packaging_apps_helpers.md
View file

@ -7,7 +7,7 @@ routes:
default: '/packaging_apps_helpers' default: '/packaging_apps_helpers'
--- ---
Doc auto-generated by [this script](https://github.com/YunoHost/yunohost/blob/756b0930c2a179f0c2b8b0582c10e692a17861a2/doc/generate_helper_doc.py) on 03/03/2023 (YunoHost version 11.1.13) Doc auto-generated by [this script](https://github.com/YunoHost/yunohost/blob/4971127b9c117047a78513b71c594b70ba7ede6c/doc/generate_helper_doc.py) on 09/03/2023 (YunoHost version 11.1.14)
## APPS ## APPS
@ -25,7 +25,7 @@ Requires YunoHost version *.*.* or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/756b0930c2a179f0c2b8b0582c10e692a17861a2/helpers/apps#L9) [Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4971127b9c117047a78513b71c594b70ba7ede6c/helpers/apps#L9)
[/details] [/details]
---------------- ----------------
@ -41,7 +41,7 @@ Requires YunoHost version *.*.* or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/756b0930c2a179f0c2b8b0582c10e692a17861a2/helpers/apps#L65) [Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4971127b9c117047a78513b71c594b70ba7ede6c/helpers/apps#L65)
[/details] [/details]
---------------- ----------------
@ -65,7 +65,7 @@ Requires YunoHost version 2.2.4 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/756b0930c2a179f0c2b8b0582c10e692a17861a2/helpers/apt#L53) [Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4971127b9c117047a78513b71c594b70ba7ede6c/helpers/apt#L53)
[/details] [/details]
---------------- ----------------
@ -86,7 +86,7 @@ Requires YunoHost version 2.2.4 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/756b0930c2a179f0c2b8b0582c10e692a17861a2/helpers/apt#L75) [Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4971127b9c117047a78513b71c594b70ba7ede6c/helpers/apt#L75)
[/details] [/details]
---------------- ----------------
@ -100,7 +100,7 @@ Requires YunoHost version 2.2.4 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/756b0930c2a179f0c2b8b0582c10e692a17861a2/helpers/apt#L107) [Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4971127b9c117047a78513b71c594b70ba7ede6c/helpers/apt#L107)
[/details] [/details]
---------------- ----------------
@ -117,7 +117,7 @@ Requires YunoHost version 2.2.4 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/756b0930c2a179f0c2b8b0582c10e692a17861a2/helpers/apt#L117) [Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4971127b9c117047a78513b71c594b70ba7ede6c/helpers/apt#L117)
[/details] [/details]
---------------- ----------------
@ -134,7 +134,7 @@ Requires YunoHost version 2.2.4 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/756b0930c2a179f0c2b8b0582c10e692a17861a2/helpers/apt#L128) [Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4971127b9c117047a78513b71c594b70ba7ede6c/helpers/apt#L128)
[/details] [/details]
---------------- ----------------
@ -151,7 +151,7 @@ Requires YunoHost version 2.2.4 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/756b0930c2a179f0c2b8b0582c10e692a17861a2/helpers/apt#L138) [Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4971127b9c117047a78513b71c594b70ba7ede6c/helpers/apt#L138)
[/details] [/details]
---------------- ----------------
@ -168,7 +168,7 @@ Requires YunoHost version 2.7.2 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/756b0930c2a179f0c2b8b0582c10e692a17861a2/helpers/apt#L148) [Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4971127b9c117047a78513b71c594b70ba7ede6c/helpers/apt#L148)
[/details] [/details]
---------------- ----------------
@ -190,7 +190,7 @@ Requires YunoHost version 2.6.4 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/756b0930c2a179f0c2b8b0582c10e692a17861a2/helpers/apt#L225) [Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4971127b9c117047a78513b71c594b70ba7ede6c/helpers/apt#L225)
[/details] [/details]
---------------- ----------------
@ -207,7 +207,7 @@ Requires YunoHost version 3.8.1 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/756b0930c2a179f0c2b8b0582c10e692a17861a2/helpers/apt#L338) [Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4971127b9c117047a78513b71c594b70ba7ede6c/helpers/apt#L338)
[/details] [/details]
---------------- ----------------
@ -223,7 +223,7 @@ Requires YunoHost version 2.6.4 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/756b0930c2a179f0c2b8b0582c10e692a17861a2/helpers/apt#L357) [Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4971127b9c117047a78513b71c594b70ba7ede6c/helpers/apt#L357)
[/details] [/details]
---------------- ----------------
@ -243,7 +243,7 @@ Requires YunoHost version 3.8.1 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/756b0930c2a179f0c2b8b0582c10e692a17861a2/helpers/apt#L385) [Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4971127b9c117047a78513b71c594b70ba7ede6c/helpers/apt#L385)
[/details] [/details]
---------------- ----------------
@ -316,7 +316,7 @@ Requires YunoHost version 3.5.0 or higher for the argument `--not_mandatory`
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/756b0930c2a179f0c2b8b0582c10e692a17861a2/helpers/backup#L64) [Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4971127b9c117047a78513b71c594b70ba7ede6c/helpers/backup#L64)
[/details] [/details]
---------------- ----------------
@ -330,7 +330,7 @@ Requires YunoHost version 2.6.4 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/756b0930c2a179f0c2b8b0582c10e692a17861a2/helpers/backup#L179) [Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4971127b9c117047a78513b71c594b70ba7ede6c/helpers/backup#L179)
[/details] [/details]
---------------- ----------------
@ -375,7 +375,7 @@ Requires YunoHost version 3.5.0 or higher for the argument --not_mandatory
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/756b0930c2a179f0c2b8b0582c10e692a17861a2/helpers/backup#L238) [Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4971127b9c117047a78513b71c594b70ba7ede6c/helpers/backup#L238)
[/details] [/details]
---------------- ----------------
@ -394,7 +394,7 @@ Requires YunoHost version 2.6.4 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/756b0930c2a179f0c2b8b0582c10e692a17861a2/helpers/backup#L306) [Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4971127b9c117047a78513b71c594b70ba7ede6c/helpers/backup#L306)
[/details] [/details]
---------------- ----------------
@ -416,7 +416,7 @@ Requires YunoHost version 2.6.4 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/756b0930c2a179f0c2b8b0582c10e692a17861a2/helpers/backup#L357) [Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4971127b9c117047a78513b71c594b70ba7ede6c/helpers/backup#L357)
[/details] [/details]
---------------- ----------------
@ -435,7 +435,7 @@ Requires YunoHost version 3.3.1 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/756b0930c2a179f0c2b8b0582c10e692a17861a2/helpers/backup#L397) [Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4971127b9c117047a78513b71c594b70ba7ede6c/helpers/backup#L397)
[/details] [/details]
---------------- ----------------
@ -458,7 +458,7 @@ Requires YunoHost version 2.7.2 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/756b0930c2a179f0c2b8b0582c10e692a17861a2/helpers/backup#L432) [Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4971127b9c117047a78513b71c594b70ba7ede6c/helpers/backup#L432)
[/details] [/details]
---------------- ----------------
@ -481,7 +481,7 @@ Requires YunoHost version 2.7.2 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/756b0930c2a179f0c2b8b0582c10e692a17861a2/helpers/backup#L480) [Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4971127b9c117047a78513b71c594b70ba7ede6c/helpers/backup#L480)
[/details] [/details]
---------------- ----------------
@ -558,7 +558,7 @@ Requires YunoHost version 4.1.0 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/756b0930c2a179f0c2b8b0582c10e692a17861a2/helpers/fail2ban#L64) [Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4971127b9c117047a78513b71c594b70ba7ede6c/helpers/fail2ban#L64)
[/details] [/details]
---------------- ----------------
@ -572,7 +572,7 @@ Requires YunoHost version 3.5.0 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/756b0930c2a179f0c2b8b0582c10e692a17861a2/helpers/fail2ban#L119) [Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4971127b9c117047a78513b71c594b70ba7ede6c/helpers/fail2ban#L119)
[/details] [/details]
---------------- ----------------
@ -600,7 +600,7 @@ Requires YunoHost version 3.8.1 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/756b0930c2a179f0c2b8b0582c10e692a17861a2/helpers/hardware#L13) [Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4971127b9c117047a78513b71c594b70ba7ede6c/helpers/hardware#L13)
[/details] [/details]
---------------- ----------------
@ -623,7 +623,7 @@ Requires YunoHost version 3.8.1 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/756b0930c2a179f0c2b8b0582c10e692a17861a2/helpers/hardware#L75) [Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4971127b9c117047a78513b71c594b70ba7ede6c/helpers/hardware#L75)
[/details] [/details]
---------------- ----------------
@ -644,7 +644,7 @@ Requires YunoHost version 2.4.0 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/756b0930c2a179f0c2b8b0582c10e692a17861a2/helpers/logging#L10) [Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4971127b9c117047a78513b71c594b70ba7ede6c/helpers/logging#L10)
[/details] [/details]
---------------- ----------------
@ -661,7 +661,7 @@ Requires YunoHost version 3.2.0 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/756b0930c2a179f0c2b8b0582c10e692a17861a2/helpers/logging#L30) [Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4971127b9c117047a78513b71c594b70ba7ede6c/helpers/logging#L30)
[/details] [/details]
---------------- ----------------
@ -678,7 +678,7 @@ Requires YunoHost version 3.2.0 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/756b0930c2a179f0c2b8b0582c10e692a17861a2/helpers/logging#L56) [Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4971127b9c117047a78513b71c594b70ba7ede6c/helpers/logging#L56)
[/details] [/details]
---------------- ----------------
@ -695,7 +695,7 @@ Requires YunoHost version 3.2.0 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/756b0930c2a179f0c2b8b0582c10e692a17861a2/helpers/logging#L73) [Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4971127b9c117047a78513b71c594b70ba7ede6c/helpers/logging#L73)
[/details] [/details]
---------------- ----------------
@ -714,7 +714,7 @@ Requires YunoHost version 3.2.0 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/756b0930c2a179f0c2b8b0582c10e692a17861a2/helpers/logging#L92) [Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4971127b9c117047a78513b71c594b70ba7ede6c/helpers/logging#L92)
[/details] [/details]
---------------- ----------------
@ -733,7 +733,7 @@ Requires YunoHost version 3.2.0 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/756b0930c2a179f0c2b8b0582c10e692a17861a2/helpers/logging#L113) [Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4971127b9c117047a78513b71c594b70ba7ede6c/helpers/logging#L113)
[/details] [/details]
---------------- ----------------
@ -752,7 +752,7 @@ Requires YunoHost version 3.2.0 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/756b0930c2a179f0c2b8b0582c10e692a17861a2/helpers/logging#L134) [Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4971127b9c117047a78513b71c594b70ba7ede6c/helpers/logging#L134)
[/details] [/details]
---------------- ----------------
@ -771,7 +771,7 @@ Requires YunoHost version 3.2.0 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/756b0930c2a179f0c2b8b0582c10e692a17861a2/helpers/logging#L155) [Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4971127b9c117047a78513b71c594b70ba7ede6c/helpers/logging#L155)
[/details] [/details]
---------------- ----------------
@ -790,7 +790,7 @@ Requires YunoHost version 3.2.0 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/756b0930c2a179f0c2b8b0582c10e692a17861a2/helpers/logging#L176) [Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4971127b9c117047a78513b71c594b70ba7ede6c/helpers/logging#L176)
[/details] [/details]
---------------- ----------------
@ -810,7 +810,7 @@ Requires YunoHost version 3.5.0 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/756b0930c2a179f0c2b8b0582c10e692a17861a2/helpers/logging#L237) [Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4971127b9c117047a78513b71c594b70ba7ede6c/helpers/logging#L237)
[/details] [/details]
---------------- ----------------
@ -825,7 +825,7 @@ Requires YunoHost version 3.6.0 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/756b0930c2a179f0c2b8b0582c10e692a17861a2/helpers/logging#L325) [Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4971127b9c117047a78513b71c594b70ba7ede6c/helpers/logging#L325)
[/details] [/details]
---------------- ----------------
@ -854,7 +854,7 @@ Requires YunoHost version 3.2.0 or higher for the argument `--specific_user`
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/756b0930c2a179f0c2b8b0582c10e692a17861a2/helpers/logrotate#L18) [Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4971127b9c117047a78513b71c594b70ba7ede6c/helpers/logrotate#L18)
[/details] [/details]
---------------- ----------------
@ -868,7 +868,7 @@ Requires YunoHost version 2.6.4 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/756b0930c2a179f0c2b8b0582c10e692a17861a2/helpers/logrotate#L109) [Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4971127b9c117047a78513b71c594b70ba7ede6c/helpers/logrotate#L109)
[/details] [/details]
---------------- ----------------
@ -885,7 +885,7 @@ Requires YunoHost version 4.2 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/756b0930c2a179f0c2b8b0582c10e692a17861a2/helpers/multimedia#L11) [Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4971127b9c117047a78513b71c594b70ba7ede6c/helpers/multimedia#L11)
[/details] [/details]
---------------- ----------------
@ -905,7 +905,7 @@ Requires YunoHost version 4.2 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/756b0930c2a179f0c2b8b0582c10e692a17861a2/helpers/multimedia#L64) [Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4971127b9c117047a78513b71c594b70ba7ede6c/helpers/multimedia#L64)
[/details] [/details]
---------------- ----------------
@ -922,7 +922,7 @@ Requires YunoHost version 4.2 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/756b0930c2a179f0c2b8b0582c10e692a17861a2/helpers/multimedia#L93) [Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4971127b9c117047a78513b71c594b70ba7ede6c/helpers/multimedia#L93)
[/details] [/details]
---------------- ----------------
@ -955,7 +955,7 @@ Requires YunoHost version 2.2.4 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/756b0930c2a179f0c2b8b0582c10e692a17861a2/helpers/mysql#L15) [Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4971127b9c117047a78513b71c594b70ba7ede6c/helpers/mysql#L15)
[/details] [/details]
---------------- ----------------
@ -973,7 +973,7 @@ Requires YunoHost version 2.2.4 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/756b0930c2a179f0c2b8b0582c10e692a17861a2/helpers/mysql#L36) [Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4971127b9c117047a78513b71c594b70ba7ede6c/helpers/mysql#L36)
[/details] [/details]
---------------- ----------------
@ -991,7 +991,7 @@ Requires YunoHost version 2.2.4 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/756b0930c2a179f0c2b8b0582c10e692a17861a2/helpers/mysql#L60) [Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4971127b9c117047a78513b71c594b70ba7ede6c/helpers/mysql#L60)
[/details] [/details]
---------------- ----------------
@ -1012,7 +1012,7 @@ Requires YunoHost version 2.2.4 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/756b0930c2a179f0c2b8b0582c10e692a17861a2/helpers/mysql#L128) [Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4971127b9c117047a78513b71c594b70ba7ede6c/helpers/mysql#L128)
[/details] [/details]
---------------- ----------------
@ -1031,7 +1031,7 @@ Requires YunoHost version 2.2.4 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/756b0930c2a179f0c2b8b0582c10e692a17861a2/helpers/mysql#L160) [Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4971127b9c117047a78513b71c594b70ba7ede6c/helpers/mysql#L160)
[/details] [/details]
---------------- ----------------
@ -1053,7 +1053,7 @@ Requires YunoHost version 2.6.4 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/756b0930c2a179f0c2b8b0582c10e692a17861a2/helpers/mysql#L198) [Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4971127b9c117047a78513b71c594b70ba7ede6c/helpers/mysql#L198)
[/details] [/details]
---------------- ----------------
@ -1071,7 +1071,7 @@ Requires YunoHost version 2.6.4 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/756b0930c2a179f0c2b8b0582c10e692a17861a2/helpers/mysql#L224) [Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4971127b9c117047a78513b71c594b70ba7ede6c/helpers/mysql#L224)
[/details] [/details]
---------------- ----------------
@ -1095,7 +1095,7 @@ Requires YunoHost version 2.6.4 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/756b0930c2a179f0c2b8b0582c10e692a17861a2/helpers/network#L12) [Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4971127b9c117047a78513b71c594b70ba7ede6c/helpers/network#L12)
[/details] [/details]
---------------- ----------------
@ -1116,7 +1116,7 @@ Requires YunoHost version 3.8.0 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/756b0930c2a179f0c2b8b0582c10e692a17861a2/helpers/network#L36) [Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4971127b9c117047a78513b71c594b70ba7ede6c/helpers/network#L36)
[/details] [/details]
---------------- ----------------
@ -1137,7 +1137,7 @@ Requires YunoHost version 2.2.4 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/756b0930c2a179f0c2b8b0582c10e692a17861a2/helpers/network#L99) [Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4971127b9c117047a78513b71c594b70ba7ede6c/helpers/network#L99)
[/details] [/details]
---------------- ----------------
@ -1158,7 +1158,7 @@ Requires YunoHost version 2.2.4 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/756b0930c2a179f0c2b8b0582c10e692a17861a2/helpers/network#L119) [Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4971127b9c117047a78513b71c594b70ba7ede6c/helpers/network#L119)
[/details] [/details]
---------------- ----------------
@ -1186,7 +1186,7 @@ Requires YunoHost version 4.1.0 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/756b0930c2a179f0c2b8b0582c10e692a17861a2/helpers/nginx#L19) [Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4971127b9c117047a78513b71c594b70ba7ede6c/helpers/nginx#L19)
[/details] [/details]
---------------- ----------------
@ -1200,7 +1200,7 @@ Requires YunoHost version 2.7.2 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/756b0930c2a179f0c2b8b0582c10e692a17861a2/helpers/nginx#L41) [Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4971127b9c117047a78513b71c594b70ba7ede6c/helpers/nginx#L41)
[/details] [/details]
---------------- ----------------
@ -1214,7 +1214,7 @@ Requires YunoHost version 11.1.9 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/756b0930c2a179f0c2b8b0582c10e692a17861a2/helpers/nginx#L52) [Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4971127b9c117047a78513b71c594b70ba7ede6c/helpers/nginx#L52)
[/details] [/details]
---------------- ----------------
@ -1268,7 +1268,7 @@ Requires YunoHost version 2.7.12 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/756b0930c2a179f0c2b8b0582c10e692a17861a2/helpers/nodejs#L74) [Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4971127b9c117047a78513b71c594b70ba7ede6c/helpers/nodejs#L74)
[/details] [/details]
---------------- ----------------
@ -1292,7 +1292,7 @@ Requires YunoHost version 2.7.12 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/756b0930c2a179f0c2b8b0582c10e692a17861a2/helpers/nodejs#L114) [Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4971127b9c117047a78513b71c594b70ba7ede6c/helpers/nodejs#L114)
[/details] [/details]
---------------- ----------------
@ -1310,7 +1310,7 @@ Requires YunoHost version 2.7.12 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/756b0930c2a179f0c2b8b0582c10e692a17861a2/helpers/nodejs#L191) [Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4971127b9c117047a78513b71c594b70ba7ede6c/helpers/nodejs#L191)
[/details] [/details]
---------------- ----------------
@ -1383,7 +1383,7 @@ Requires YunoHost version 3.7.0 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/756b0930c2a179f0c2b8b0582c10e692a17861a2/helpers/permission#L66) [Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4971127b9c117047a78513b71c594b70ba7ede6c/helpers/permission#L66)
[/details] [/details]
---------------- ----------------
@ -1402,7 +1402,7 @@ Requires YunoHost version 3.7.0 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/756b0930c2a179f0c2b8b0582c10e692a17861a2/helpers/permission#L152) [Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4971127b9c117047a78513b71c594b70ba7ede6c/helpers/permission#L152)
[/details] [/details]
---------------- ----------------
@ -1420,7 +1420,7 @@ Requires YunoHost version 3.7.0 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/756b0930c2a179f0c2b8b0582c10e692a17861a2/helpers/permission#L169) [Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4971127b9c117047a78513b71c594b70ba7ede6c/helpers/permission#L169)
[/details] [/details]
---------------- ----------------
@ -1443,7 +1443,7 @@ Requires YunoHost version 3.7.0 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/756b0930c2a179f0c2b8b0582c10e692a17861a2/helpers/permission#L192) [Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4971127b9c117047a78513b71c594b70ba7ede6c/helpers/permission#L192)
[/details] [/details]
---------------- ----------------
@ -1466,7 +1466,7 @@ Requires YunoHost version 3.7.0 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/756b0930c2a179f0c2b8b0582c10e692a17861a2/helpers/permission#L260) [Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4971127b9c117047a78513b71c594b70ba7ede6c/helpers/permission#L260)
[/details] [/details]
---------------- ----------------
@ -1487,7 +1487,7 @@ Requires YunoHost version 3.7.1 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/756b0930c2a179f0c2b8b0582c10e692a17861a2/helpers/permission#L329) [Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4971127b9c117047a78513b71c594b70ba7ede6c/helpers/permission#L329)
[/details] [/details]
---------------- ----------------
@ -1502,7 +1502,7 @@ Requires YunoHost version 4.1.2 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/756b0930c2a179f0c2b8b0582c10e692a17861a2/helpers/permission#L359) [Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4971127b9c117047a78513b71c594b70ba7ede6c/helpers/permission#L359)
[/details] [/details]
---------------- ----------------
@ -1513,7 +1513,7 @@ Requires YunoHost version 4.1.2 or higher.
**Example**: `if ynh_legacy_permissions_exists then ynh_legacy_permissions_delete_all # You can recreate the required permissions here with ynh_permission_create fi Requires YunoHost version 4.1.2 or higher.` **Example**: `if ynh_legacy_permissions_exists then ynh_legacy_permissions_delete_all # You can recreate the required permissions here with ynh_permission_create fi Requires YunoHost version 4.1.2 or higher.`
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/756b0930c2a179f0c2b8b0582c10e692a17861a2/helpers/permission#L379) [Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4971127b9c117047a78513b71c594b70ba7ede6c/helpers/permission#L379)
[/details] [/details]
---------------- ----------------
@ -1571,7 +1571,7 @@ Requires YunoHost version 4.1.0 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/756b0930c2a179f0c2b8b0582c10e692a17861a2/helpers/php#L59) [Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4971127b9c117047a78513b71c594b70ba7ede6c/helpers/php#L59)
[/details] [/details]
---------------- ----------------
@ -1585,7 +1585,7 @@ Requires YunoHost version 2.7.2 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/756b0930c2a179f0c2b8b0582c10e692a17861a2/helpers/php#L257) [Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4971127b9c117047a78513b71c594b70ba7ede6c/helpers/php#L257)
[/details] [/details]
---------------- ----------------
@ -1604,7 +1604,7 @@ Requires YunoHost version 4.2 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/756b0930c2a179f0c2b8b0582c10e692a17861a2/helpers/php#L490) [Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4971127b9c117047a78513b71c594b70ba7ede6c/helpers/php#L490)
[/details] [/details]
---------------- ----------------
@ -1624,7 +1624,7 @@ Requires YunoHost version 4.2 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/756b0930c2a179f0c2b8b0582c10e692a17861a2/helpers/php#L522) [Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4971127b9c117047a78513b71c594b70ba7ede6c/helpers/php#L522)
[/details] [/details]
---------------- ----------------
@ -1657,7 +1657,7 @@ Requires YunoHost version 3.5.0 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/756b0930c2a179f0c2b8b0582c10e692a17861a2/helpers/postgresql#L18) [Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4971127b9c117047a78513b71c594b70ba7ede6c/helpers/postgresql#L18)
[/details] [/details]
---------------- ----------------
@ -1675,7 +1675,7 @@ Requires YunoHost version 3.5.0 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/756b0930c2a179f0c2b8b0582c10e692a17861a2/helpers/postgresql#L39) [Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4971127b9c117047a78513b71c594b70ba7ede6c/helpers/postgresql#L39)
[/details] [/details]
---------------- ----------------
@ -1693,7 +1693,7 @@ Requires YunoHost version 3.5.0 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/756b0930c2a179f0c2b8b0582c10e692a17861a2/helpers/postgresql#L64) [Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4971127b9c117047a78513b71c594b70ba7ede6c/helpers/postgresql#L64)
[/details] [/details]
---------------- ----------------
@ -1714,7 +1714,7 @@ Requires YunoHost version 3.5.0 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/756b0930c2a179f0c2b8b0582c10e692a17861a2/helpers/postgresql#L135) [Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4971127b9c117047a78513b71c594b70ba7ede6c/helpers/postgresql#L135)
[/details] [/details]
---------------- ----------------
@ -1732,7 +1732,7 @@ Requires YunoHost version 3.5.0 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/756b0930c2a179f0c2b8b0582c10e692a17861a2/helpers/postgresql#L168) [Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4971127b9c117047a78513b71c594b70ba7ede6c/helpers/postgresql#L168)
[/details] [/details]
---------------- ----------------
@ -1750,7 +1750,7 @@ Requires YunoHost version 3.5.0 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/756b0930c2a179f0c2b8b0582c10e692a17861a2/helpers/postgresql#L190) [Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4971127b9c117047a78513b71c594b70ba7ede6c/helpers/postgresql#L190)
[/details] [/details]
---------------- ----------------
@ -1772,7 +1772,7 @@ Requires YunoHost version 2.7.13 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/756b0930c2a179f0c2b8b0582c10e692a17861a2/helpers/postgresql#L234) [Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4971127b9c117047a78513b71c594b70ba7ede6c/helpers/postgresql#L234)
[/details] [/details]
---------------- ----------------
@ -1790,7 +1790,7 @@ Requires YunoHost version 2.7.13 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/756b0930c2a179f0c2b8b0582c10e692a17861a2/helpers/postgresql#L265) [Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4971127b9c117047a78513b71c594b70ba7ede6c/helpers/postgresql#L265)
[/details] [/details]
---------------- ----------------
@ -1811,7 +1811,7 @@ Requires YunoHost version 2.2.4 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/756b0930c2a179f0c2b8b0582c10e692a17861a2/helpers/setting#L10) [Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4971127b9c117047a78513b71c594b70ba7ede6c/helpers/setting#L10)
[/details] [/details]
---------------- ----------------
@ -1830,7 +1830,7 @@ Requires YunoHost version 2.2.4 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/756b0930c2a179f0c2b8b0582c10e692a17861a2/helpers/setting#L36) [Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4971127b9c117047a78513b71c594b70ba7ede6c/helpers/setting#L36)
[/details] [/details]
---------------- ----------------
@ -1848,7 +1848,7 @@ Requires YunoHost version 2.2.4 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/756b0930c2a179f0c2b8b0582c10e692a17861a2/helpers/setting#L62) [Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4971127b9c117047a78513b71c594b70ba7ede6c/helpers/setting#L62)
[/details] [/details]
---------------- ----------------
@ -1868,7 +1868,7 @@ Requires YunoHost version 2.6.4 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/756b0930c2a179f0c2b8b0582c10e692a17861a2/helpers/setting#L123) [Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4971127b9c117047a78513b71c594b70ba7ede6c/helpers/setting#L123)
[/details] [/details]
---------------- ----------------
@ -1889,7 +1889,7 @@ Requires YunoHost version 2.6.4 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/756b0930c2a179f0c2b8b0582c10e692a17861a2/helpers/setting#L145) [Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4971127b9c117047a78513b71c594b70ba7ede6c/helpers/setting#L145)
[/details] [/details]
---------------- ----------------
@ -1914,7 +1914,7 @@ Requires YunoHost version 2.2.4 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/756b0930c2a179f0c2b8b0582c10e692a17861a2/helpers/string#L13) [Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4971127b9c117047a78513b71c594b70ba7ede6c/helpers/string#L13)
[/details] [/details]
---------------- ----------------
@ -1936,7 +1936,7 @@ Requires YunoHost version 2.6.4 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/756b0930c2a179f0c2b8b0582c10e692a17861a2/helpers/string#L40) [Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4971127b9c117047a78513b71c594b70ba7ede6c/helpers/string#L40)
[/details] [/details]
---------------- ----------------
@ -1958,7 +1958,7 @@ Requires YunoHost version 2.7.7 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/756b0930c2a179f0c2b8b0582c10e692a17861a2/helpers/string#L71) [Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4971127b9c117047a78513b71c594b70ba7ede6c/helpers/string#L71)
[/details] [/details]
---------------- ----------------
@ -1981,7 +1981,7 @@ Requires YunoHost version 2.2.4 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/756b0930c2a179f0c2b8b0582c10e692a17861a2/helpers/string#L103) [Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4971127b9c117047a78513b71c594b70ba7ede6c/helpers/string#L103)
[/details] [/details]
---------------- ----------------
@ -2007,7 +2007,7 @@ Requires YunoHost version 4.1.0 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/756b0930c2a179f0c2b8b0582c10e692a17861a2/helpers/systemd#L15) [Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4971127b9c117047a78513b71c594b70ba7ede6c/helpers/systemd#L15)
[/details] [/details]
---------------- ----------------
@ -2024,7 +2024,7 @@ Requires YunoHost version 2.7.2 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/756b0930c2a179f0c2b8b0582c10e692a17861a2/helpers/systemd#L38) [Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4971127b9c117047a78513b71c594b70ba7ede6c/helpers/systemd#L38)
[/details] [/details]
---------------- ----------------
@ -2046,7 +2046,7 @@ Requires YunoHost version 3.5.0 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/756b0930c2a179f0c2b8b0582c10e692a17861a2/helpers/systemd#L67) [Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4971127b9c117047a78513b71c594b70ba7ede6c/helpers/systemd#L67)
[/details] [/details]
---------------- ----------------
@ -2070,7 +2070,7 @@ Requires YunoHost version 2.2.4 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/756b0930c2a179f0c2b8b0582c10e692a17861a2/helpers/user#L12) [Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4971127b9c117047a78513b71c594b70ba7ede6c/helpers/user#L12)
[/details] [/details]
---------------- ----------------
@ -2092,7 +2092,7 @@ Requires YunoHost version 2.2.4 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/756b0930c2a179f0c2b8b0582c10e692a17861a2/helpers/user#L33) [Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4971127b9c117047a78513b71c594b70ba7ede6c/helpers/user#L33)
[/details] [/details]
---------------- ----------------
@ -2110,7 +2110,7 @@ Requires YunoHost version 2.4.0 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/756b0930c2a179f0c2b8b0582c10e692a17861a2/helpers/user#L53) [Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4971127b9c117047a78513b71c594b70ba7ede6c/helpers/user#L53)
[/details] [/details]
---------------- ----------------
@ -2129,7 +2129,7 @@ Requires YunoHost version 2.2.4 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/756b0930c2a179f0c2b8b0582c10e692a17861a2/helpers/user#L64) [Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4971127b9c117047a78513b71c594b70ba7ede6c/helpers/user#L64)
[/details] [/details]
---------------- ----------------
@ -2148,7 +2148,7 @@ Requires YunoHost version 3.5.0.2 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/756b0930c2a179f0c2b8b0582c10e692a17861a2/helpers/user#L82) [Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4971127b9c117047a78513b71c594b70ba7ede6c/helpers/user#L82)
[/details] [/details]
---------------- ----------------
@ -2177,7 +2177,7 @@ Requires YunoHost version 2.6.4 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/756b0930c2a179f0c2b8b0582c10e692a17861a2/helpers/user#L111) [Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4971127b9c117047a78513b71c594b70ba7ede6c/helpers/user#L111)
[/details] [/details]
---------------- ----------------
@ -2194,7 +2194,7 @@ Requires YunoHost version 2.6.4 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/756b0930c2a179f0c2b8b0582c10e692a17861a2/helpers/user#L153) [Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4971127b9c117047a78513b71c594b70ba7ede6c/helpers/user#L153)
[/details] [/details]
---------------- ----------------
@ -2208,7 +2208,7 @@ Requires YunoHost version 4.1.7 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/756b0930c2a179f0c2b8b0582c10e692a17861a2/helpers/user#L179) [Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4971127b9c117047a78513b71c594b70ba7ede6c/helpers/user#L179)
[/details] [/details]
---------------- ----------------
@ -2229,7 +2229,7 @@ Requires YunoHost version 2.6.4 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/756b0930c2a179f0c2b8b0582c10e692a17861a2/helpers/utils#L58) [Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4971127b9c117047a78513b71c594b70ba7ede6c/helpers/utils#L58)
[/details] [/details]
---------------- ----------------
@ -2240,40 +2240,77 @@ Requires YunoHost version 2.6.4 or higher.
**Arguments**: **Arguments**:
- `-d`, `--dest_dir=`: Directory where to setup sources - `-d`, `--dest_dir=`: Directory where to setup sources
- `-s`, `--source_id=`: Name of the source, defaults to `app` - `-s`, `--source_id=`: Name of the source, defaults to `main` (when the sources resource exists in manifest.toml) or (legacy) `app` otherwise
- `-k`, `--keep=`: Space-separated list of files/folders that will be backup/restored in $dest_dir, such as a config file you don't want to overwrite. For example 'conf.json secrets.json logs/' - `-k`, `--keep=`: Space-separated list of files/folders that will be backup/restored in $dest_dir, such as a config file you don't want to overwrite. For example 'conf.json secrets.json logs/'
- `-r`, `--full_replace=`: Remove previous sources before installing new sources - `-r`, `--full_replace=`: Remove previous sources before installing new sources
**Details**:<br/> **Details**:<br/>
#### New 'sources' resources
(See also the resources documentation which may be more complete?)
This helper will read infos from the 'sources' resources in the manifest.toml of the app
and expect a structure like:
```toml
[resources.sources]
[resources.sources.main]
url = "https://some.address.to/download/the/app/archive"
sha256 = "0123456789abcdef" # The sha256 sum of the asset obtained from the URL
```
# Optional flags:
format = "tar.gz"/xz/bz2 # automatically guessed from the extension of the URL, but can be set explicitly. Will use `tar` to extract
"zip" # automatically guessed from the extension of the URL, but can be set explicitly. Will use `unzip` to extract
"docker" # useful to extract files from an already-built docker image (instead of rebuilding them locally). Will use `docker-image-extract` to extract
"whatever" # an arbitrary value, not really meaningful except to imply that the file won't be extracted
in_subdir = true # default, there's an intermediate subdir in the archive before accessing the actual files
false # sources are directly in the archive root
n # (special cases) an integer representing a number of subdirs levels to get rid of
extract = true # default if file is indeed an archive such as .zip, .tar.gz, .tar.bz2, ...
= false # default if file 'format' is not set and the file is not to be extracted because it is not an archive but a script or binary or whatever asset.
# in which case the file will only be `mv`ed to the location possibly renamed using the `rename` value
rename = "whatever_your_want" # to be used for convenience when `extract` is false and the default name of the file is not practical
platform = "linux/amd64" # (defaults to "linux/$YNH_ARCH") to be used in conjonction with `format = "docker"` to specify which architecture to extract for
You may also define assets url and checksum per-architectures such as:
```toml
[resources.sources]
[resources.sources.main]
amd64.url = "https://some.address.to/download/the/app/archive/when/amd64"
amd64.sha256 = "0123456789abcdef"
armhf.url = "https://some.address.to/download/the/app/archive/when/armhf"
armhf.sha256 = "fedcba9876543210"
```
In which case ynh_setup_source --dest_dir="$install_dir" will automatically pick the appropriate source depending on the arch
#### Legacy format '.src'
This helper will read `conf/${source_id}.src`, download and install the sources. This helper will read `conf/${source_id}.src`, download and install the sources.
The src file need to contains: The src file need to contains:
``` ```
SOURCE_URL=Address to download the app archive SOURCE_URL=Address to download the app archive
SOURCE_SUM=Control sum SOURCE_SUM=Sha256 sum
# (Optional) Program to check the integrity (sha256sum, md5sum...). Default: sha256
SOURCE_SUM_PRG=sha256
# (Optional) Archive format. Default: tar.gz
SOURCE_FORMAT=tar.gz SOURCE_FORMAT=tar.gz
# (Optional) Put false if sources are directly in the archive root. Default: true
# Instead of true, SOURCE_IN_SUBDIR could be the number of sub directories to remove.
SOURCE_IN_SUBDIR=false SOURCE_IN_SUBDIR=false
# (Optionnal) Name of the local archive (offline setup support). Default: ${src_id}.${src_format}
SOURCE_FILENAME=example.tar.gz SOURCE_FILENAME=example.tar.gz
# (Optional) If it set as false don't extract the source. Default: true
# (Useful to get a debian package or a python wheel.)
SOURCE_EXTRACT=(true|false) SOURCE_EXTRACT=(true|false)
# (Optionnal) Name of the plateform. Default: "linux/$YNH_ARCH"
SOURCE_PLATFORM=linux/arm64/v8 SOURCE_PLATFORM=linux/arm64/v8
``` ```
The helper will: The helper will:
- Check if there is a local source archive in `/opt/yunohost-apps-src/$APP_ID/$SOURCE_FILENAME` - Download the specific URL if there is no local archive
- Download `$SOURCE_URL` if there is no local archive - Check the integrity with the specific sha256 sum
- Check the integrity with `$SOURCE_SUM_PRG -c --status`
- Uncompress the archive to `$dest_dir`. - Uncompress the archive to `$dest_dir`.
- If `$SOURCE_IN_SUBDIR` is true, the first level directory of the archive will be removed. - If `in_subdir` is true, the first level directory of the archive will be removed.
- If `$SOURCE_IN_SUBDIR` is a numeric value, the N first level directories will be removed. - If `in_subdir` is a numeric value, the N first level directories will be removed.
- Patches named `sources/patches/${src_id}-*.patch` will be applied to `$dest_dir` - Patches named `sources/patches/${src_id}-*.patch` will be applied to `$dest_dir`
- Extra files in `sources/extra_files/$src_id` will be copied to dest_dir - Extra files in `sources/extra_files/$src_id` will be copied to dest_dir
@ -2281,7 +2318,7 @@ Requires YunoHost version 2.6.4 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/756b0930c2a179f0c2b8b0582c10e692a17861a2/helpers/utils#L111) [Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4971127b9c117047a78513b71c594b70ba7ede6c/helpers/utils#L149)
[/details] [/details]
---------------- ----------------
@ -2307,7 +2344,7 @@ Requires YunoHost version 2.6.4 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/756b0930c2a179f0c2b8b0582c10e692a17861a2/helpers/utils#L285) [Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4971127b9c117047a78513b71c594b70ba7ede6c/helpers/utils#L389)
[/details] [/details]
---------------- ----------------
@ -2365,7 +2402,7 @@ Requires YunoHost version 4.1.0 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/756b0930c2a179f0c2b8b0582c10e692a17861a2/helpers/utils#L369) [Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4971127b9c117047a78513b71c594b70ba7ede6c/helpers/utils#L473)
[/details] [/details]
---------------- ----------------
@ -2409,7 +2446,7 @@ Requires YunoHost version 4.3 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/756b0930c2a179f0c2b8b0582c10e692a17861a2/helpers/utils#L523) [Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4971127b9c117047a78513b71c594b70ba7ede6c/helpers/utils#L627)
[/details] [/details]
---------------- ----------------
@ -2428,7 +2465,7 @@ Requires YunoHost version 4.3 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/756b0930c2a179f0c2b8b0582c10e692a17861a2/helpers/utils#L600) [Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4971127b9c117047a78513b71c594b70ba7ede6c/helpers/utils#L704)
[/details] [/details]
---------------- ----------------
@ -2444,7 +2481,7 @@ Requires YunoHost version 2.7.12 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/756b0930c2a179f0c2b8b0582c10e692a17861a2/helpers/utils#L715) [Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4971127b9c117047a78513b71c594b70ba7ede6c/helpers/utils#L819)
[/details] [/details]
---------------- ----------------
@ -2461,7 +2498,7 @@ Requires YunoHost version 2.6.4 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/756b0930c2a179f0c2b8b0582c10e692a17861a2/helpers/utils#L746) [Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4971127b9c117047a78513b71c594b70ba7ede6c/helpers/utils#L850)
[/details] [/details]
---------------- ----------------
@ -2481,7 +2518,7 @@ Requires YunoHost version 3.5.0 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/756b0930c2a179f0c2b8b0582c10e692a17861a2/helpers/utils#L780) [Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4971127b9c117047a78513b71c594b70ba7ede6c/helpers/utils#L884)
[/details] [/details]
---------------- ----------------
@ -2506,7 +2543,7 @@ Requires YunoHost version 3.5.0 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/756b0930c2a179f0c2b8b0582c10e692a17861a2/helpers/utils#L823) [Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4971127b9c117047a78513b71c594b70ba7ede6c/helpers/utils#L927)
[/details] [/details]
---------------- ----------------
@ -2529,7 +2566,7 @@ Requires YunoHost version 3.5.0 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/756b0930c2a179f0c2b8b0582c10e692a17861a2/helpers/utils#L852) [Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4971127b9c117047a78513b71c594b70ba7ede6c/helpers/utils#L956)
[/details] [/details]
---------------- ----------------
@ -2552,7 +2589,7 @@ Requires YunoHost version 3.5.0 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/756b0930c2a179f0c2b8b0582c10e692a17861a2/helpers/utils#L877) [Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4971127b9c117047a78513b71c594b70ba7ede6c/helpers/utils#L981)
[/details] [/details]
---------------- ----------------
@ -2584,7 +2621,7 @@ Requires YunoHost version 3.8.0 or higher.
[Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/756b0930c2a179f0c2b8b0582c10e692a17861a2/helpers/utils#L907) [Dude, show me the code!](https://github.com/YunoHost/yunohost/blob/4971127b9c117047a78513b71c594b70ba7ede6c/helpers/utils#L1011)
[/details] [/details]
---------------- ----------------

68
pages/06.contribute/10.packaging_apps/80.resources/15.appresources/packaging_apps_resources.md
View file

@ -7,7 +7,7 @@ routes:
default: '/packaging_apps_resources' default: '/packaging_apps_resources'
--- ---
Doc auto-generated by [this script](https://github.com/YunoHost/yunohost/blob/756b0930c2a179f0c2b8b0582c10e692a17861a2/doc/generate_resource_doc.py) on 03/03/2023 (YunoHost version ('11.1.13',)) Doc auto-generated by [this script](https://github.com/YunoHost/yunohost/blob/4971127b9c117047a78513b71c594b70ba7ede6c/doc/generate_resource_doc.py) on 09/03/2023 (YunoHost version ('11.1.14',))
---------------- ----------------
@ -210,6 +210,72 @@ xmpp_client.exposed = "TCP" # here, we're telling that the port needs to be publ
---------------- ----------------
## Sources
Declare what are the sources / assets used by this app. Typically, this corresponds to some tarball published by the upstream project, that needs to be downloaded and extracted in the install dir using the ynh_setup_source helper.
This resource is intended both to declare the assets, which will be parsed by ynh_setup_source during the app script runtime, AND to prefetch and validate the sha256sum of those asset before actually running the script, to be able to report an error early when the asset turns out to not be available for some reason.
Various options are available to accomodate the behavior according to the asset structure
##### Example:
```toml
[resources.sources]
[resources.sources.main]
url = "https://github.com/foo/bar/archive/refs/tags/v1.2.3.tar.gz"
sha256 = "01ba4719c80b6fe911b091a7c05124b64eeece964e09c058ef8f9805daca546b"
```
Or more complex examples with several element, including one with asset that depends on the arch
```toml
[resources.sources]
[resources.sources.main]
in_subdir = false
amd64.url = "https://github.com/foo/bar/archive/refs/tags/v1.2.3.amd64.tar.gz"
amd64.sha256 = "01ba4719c80b6fe911b091a7c05124b64eeece964e09c058ef8f9805daca546b"
i386.url = "https://github.com/foo/bar/archive/refs/tags/v1.2.3.amd64.tar.gz"
i386.sha256 = "53c234e5e8472b6ac51c1ae1cab3fe06fad053beb8ebfd8977b010655bfdd3c3"
armhf.url = "https://github.com/foo/bar/archive/refs/tags/v1.2.3.armhf.tar.gz"
armhf.sha256 = "4355a46b19d348dc2f57c046f8ef63d4538ebb936000f3c9ee954a27460dd865"
[resources.sources.zblerg]
url = "https://zblerg.com/download/zblerg"
sha256 = "1121cfccd5913f0a63fec40a6ffd44ea64f9dc135c66634ba001d10bcf4302a2"
format = "script"
rename = "zblerg.sh"
```
##### Properties (for each source):
- `prefetch` : `true` (default) or `false`, wether or not to pre-fetch this asset during the provisioning phase of the resource. If several arch-dependent url are provided, YunoHost will only prefetch the one for the current system architecture.
- `url` : the asset's URL
- If the asset's URL depend on the architecture, you may instead provide `amd64.url`, `i386.url`, `armhf.url` and `arm64.url` (depending on what architectures are supported), using the same `dpkg --print-architecture` nomenclature as for the supported architecture key in the manifest
- `sha256` : the asset's sha256sum. This is used both as an integrity check, and as a layer of security to protect against malicious actors which could have injected malicious code inside the asset...
- Same as `url` : if the asset's URL depend on the architecture, you may instead provide `amd64.sha256`, `i386.sha256`, ...
- `format` : The "format" of the asset. It is typically automatically guessed from the extension of the URL (or the mention of "tarball", "zipball" in the URL), but can be set explicitly:
- `tar.gz`, `tar.xz`, `tar.bz2` : will use `tar` to extract the archive
- `zip` : will use `unzip` to extract the archive
- `docker` : useful to extract files from an already-built docker image (instead of rebuilding them locally). Will use `docker-image-extract`
- `whatever`: whatever arbitrary value, not really meaningful except to imply that the file won't be extracted (eg because it's a .deb to be manually installed with dpkg/apt, or a script, or ...)
- `in_subdir`: `true` (default) or `false`, depending on if there's an intermediate subdir in the archive before accessing the actual files. Can also be `N` (an integer) to handle special cases where there's `N` level of subdir to get rid of to actually access the files
- `extract` : `true` or `false`. Defaults to `true` for archives such as `zip`, `tar.gz`, `tar.bz2`, ... Or defaults to `false` when `format` is not something that should be extracted. When `extract = false`, the file will only be `mv`ed to the location, possibly renamed using the `rename` value
- `rename`: some string like `whatever_your_want`, to be used for convenience when `extract` is `false` and the default name of the file is not practical
- `platform`: for example `linux/amd64` (defaults to `linux/$YNH_ARCH`) to be used in conjonction with `format = "docker"` to specify which architecture to extract for
##### Provision/Update:
- For elements with `prefetch = true`, will download the asset (for the appropriate architecture) and store them in `/var/cache/yunohost/download/$app/$source_id`, to be later picked up by `ynh_setup_source`. (NB: this only happens during install and upgrade, not restore)
##### Deprovision:
- Nothing (just cleanup the cache)
----------------
## System User ## System User
Provision a system user to be used by the app. The username is exactly equal to the app id Provision a system user to be used by the app. The username is exactly equal to the app id