📦➔🦋 Store and retrieve files on the Atmosphere
various
+25
-15
+4
-3
README.md
+4
-3
README.md
···
30
30
* 🟢 __*BSD__: FreeBSD, NetBSD, OpenBSD, and other *BSD's
31
31
* 🟢 **Haiku**: [Yes, really](https://bsky.app/profile/did:plc:kv7sv4lynbv5s6gdhn5r5vcw/post/3lboqznyqgs26)
32
32
* 🔴 **Solaris**: <span title="Don't we all?">Has issues</span>; low priority
33
+
* 🔴 **SerenityOS**: Untested
33
34
* **Bash³:** 3.x or later
34
35
* **Packages**
35
36
* [`curl`](https://curl.se)
···
64
65
65
66
This will automatically fetch the latest version of ATFile and install it in an appropriate location, as well as creating a blank configuration file. Once downloaded and installed, the locations used will be output. They are as follows:
66
67
67
-
* __Linux/Windows/*BSD/Solaris__
68
+
* __Linux/Windows/*BSD/Solaris/SerenityOS__
68
69
* Install: `$HOME/.local/bin/atfile`
69
70
* As `sudo`/`root`: `/usr/local/bin/atfile`
70
71
* Config: `$HOME/.config/atfile.env`
···
83
84
84
85
To install manually, see [tags on @zio.sh/atfile](https://tangled.sh/@zio.sh/atfile/tags), and download the required version under **Artifacts**. This can be stored and run from anywhere (and is identical to the version `curl|bash` fetched — this installed version can also be moved to custom locations at whim).
85
86
86
-
Don't forget to mark as executable with `chmod +x atfile.sh`. It's also a good idea to remove the version from the filename, as ATFile can update itself (with `atfile update`) and will overwrite the file (this functionality can be disabled with `ATFILE_DISABLE_UPDATER=1`).
87
+
Don't forget to mark as executable with `chmod +x atfile.sh`. It's also a good idea to remove the version from the filename, as ATFile can update itself (with `atfile update`) and will overwrite the file (this functionality can be disabled with `ATFILE_DISABLE_UPDATE_COMMAND=1`).
87
88
88
89
Config locations are identical to those above (see **Automatic ("`curl|bash`")** above). To use a custom path, set `$ATFILE_PATH_CONF`. Variables can also be used (and overridden) with exports — see **`atfile help` ➔ Environment Variables** for more.
89
90
···
121
122
122
123
* **¹** You can bypass OS detection in one of two ways:
123
124
* Set `ATFILE_SKIP_UNSUPPORTED_OS=1`<br />Be careful! There's a reason some OSes are not supported
124
-
* Set `ATFILE_FORCE_OS=<os>`<br />This overrides the OS detected. Possible values: `bsd`, `haiku`, `linux`, `linux-mingw`, `linux-musl`, `linux-termux`, `macos`, and `solaris`.
125
+
* Set `ATFILE_FORCE_OS=<os>`<br />This overrides the OS detected. Possible values: `bsd`, `haiku`, `linux`, `linux-mingw`, `linux-musl`, `linux-termux`, `macos`, `serenity`, and `solaris`.
125
126
* **²** musl-powered distros do not use GNU/glibc packages, and have problems currently
126
127
* Known musl distros: Alpine, Chimera, Dragora, Gentoo (musl), Morpheus, OpenWrt, postmarketOS, Sabotage, Void
127
128
* Bypassing OS detection (see ¹) will work, but dates will not be handled correctly
+3
-1
src/commands/help.sh
+3
-1
src/commands/help.sh
···
168
168
${_envvar_prefix}_DEBUG <bool¹> (default: 0)
169
169
Print debug outputs
170
170
⚠️ When output is JSON (${_envvar_prefix}_OUTPUT_JSON=1), sets to 0
171
+
${_envvar_prefix}_DISABLE_SETUP_DIR_CREATION <bool¹> (default: $_disable_setup_dir_creation)
172
+
Disable directory creation during setup
171
173
${_envvar_prefix}_DISABLE_UPDATE_CHECKING <bool¹> (default: $_disable_update_checking_default)
172
174
Disable periodic update checking when command finishes
173
-
${_envvar_prefix}_DISABLE_UPDATER <bool¹> (default: $_disable_updater_default)
175
+
${_envvar_prefix}_DISABLE_UPDATE_COMMAND <bool¹> (default: $_disable_update_command_default)
174
176
Disable \`update\` command\n
175
177
¹ A bool in Bash is 1 (true) or 0 (false)
176
178
² These servers are ran by @$handle. You can trust us!"
+2
-1
src/commands/something_broke.sh
+2
-1
src/commands/something_broke.sh
···
74
74
$(atfile.something_broke.print_envvar "DEVEL_SOURCE")
75
75
$(atfile.something_broke.print_envvar "DEVEL_PUBLISH" "$_devel_publish_default")
76
76
$(atfile.something_broke.print_envvar "DISABLE_PBC_FALLBACK" "$_disable_pbc_fallback_default")
77
+
$(atfile.something_broke.print_envvar "DISABLE_SETUP_DIR_CREATION" "$_disable_setup_dir_creation_default")
77
78
$(atfile.something_broke.print_envvar "DISABLE_UPDATE_CHECKING" "$_disable_update_checking_default")
78
-
$(atfile.something_broke.print_envvar "DISABLE_UPDATER" "$_disable_updater_default")
79
+
$(atfile.something_broke.print_envvar "DISABLE_UPDATE_COMMAND" "$_disable_update_command_default")
79
80
↳ ${_envvar_prefix}_DIST_PASSWORD: $([[ -n $(atfile.util.get_envvar "${_envvar_prefix}_DIST_PASSWORD") ]] && echo "(Set)")
80
81
$(atfile.something_broke.print_envvar "DIST_USERNAME" "$_dist_username_default")
81
82
$(atfile.something_broke.print_envvar "ENABLE_FINGERPRINT" "$_enable_fingerprint_default")
+6
-6
src/commands/update.sh
+6
-6
src/commands/update.sh
···
14
14
# shellcheck disable=SC2154
15
15
[[ $_disable_update_checking == 1 ]] && return
16
16
# shellcheck disable=SC2154
17
-
[[ $_disable_updater == 1 ]] && return
17
+
[[ $_disable_update_command == 1 ]] && return
18
18
# shellcheck disable=SC2154
19
19
[[ $is_git == 1 && $_enable_update_git_clobber == 0 ]] && return
20
20
# shellcheck disable=SC2154
···
78
78
fi
79
79
;;
80
80
"install")
81
+
[[ $is_git == 1 && $_enable_update_git_clobber == 0 ]] &&\
82
+
atfile.die "Cannot update in Git repository"
83
+
[[ $_disable_update_command == 1 ]] &&\
84
+
atfile.die "Cannot update system-managed version: update from your package manager"
85
+
81
86
if [[ $update_available == 0 ]]; then
82
87
atfile.say "No updates found"
83
88
return
84
89
fi
85
-
86
-
[[ $is_git == 1 && $_enable_update_git_clobber == 0 ]] &&\
87
-
atfile.die "Cannot update in Git repository"
88
-
[[ $_disable_updater == 1 ]] &&\
89
-
atfile.die "Cannot update system-managed version: update from your package manager"
90
90
91
91
# shellcheck disable=SC2154
92
92
temp_updated_path="$_prog_dir/${_prog}-${latest_version}.tmp"
+8
-4
src/entry.sh
+8
-4
src/entry.sh
···
141
141
142
142
_devel_publish_default=0
143
143
_disable_pbc_fallback_default=0
144
+
_disable_setup_dir_creation_default=0
144
145
_disable_update_checking_default=0
145
-
_disable_updater_default=0
146
+
_disable_update_command_default=0
146
147
_dist_username_default="$_meta_did"
147
148
_enable_fingerprint_default=0
148
149
_enable_update_git_clobber_default=0
···
169
170
170
171
_devel_publish="$(atfile.util.get_envvar "${_envvar_prefix}_DEVEL_PUBLISH" $_devel_publish_default)"
171
172
_disable_pbc_fallback="$(atfile.util.get_envvar "${_envvar_prefix}_DISABLE_PBC_FALLBACK" $_disable_pbc_fallback_default)"
173
+
_disable_setup_dir_creation="$(atfile.util.get_envvar "${_envvar_prefix}_DISABLE_SETUP_DIR_CREATION" "$_disable_setup_dir_creation_default")"
172
174
_disable_update_checking="$(atfile.util.get_envvar "${_envvar_prefix}_DISABLE_UPDATE_CHECKING" $_disable_update_checking_default)"
173
-
_disable_updater="$(atfile.util.get_envvar "${_envvar_prefix}_DISABLE_UPDATER" $_disable_updater_default)"
175
+
_disable_update_command="$(atfile.util.get_envvar "${_envvar_prefix}_DISABLE_UPDATE_COMMAND" $_disable_update_command_default)"
174
176
_dist_password="$(atfile.util.get_envvar "${_envvar_prefix}_DIST_PASSWORD")"
175
177
_dist_username="$(atfile.util.get_envvar "${_envvar_prefix}_DIST_USERNAME" $_dist_username_default)"
176
178
_enable_fingerprint="$(atfile.util.get_envvar "${_envvar_prefix}_ENABLE_FINGERPRINT" "$_enable_fingerprint_default")"
···
262
264
263
265
## Directory creation
264
266
265
-
atfile.util.create_dir "$_path_cache"
266
-
atfile.util.create_dir "$_path_blobs_tmp"
267
+
if [[ $_disable_setup_dir_creation == 0 ]]; then
268
+
atfile.util.create_dir "$_path_cache"
269
+
atfile.util.create_dir "$_path_blobs_tmp"
270
+
fi
267
271
268
272
## Program detection
269
273