📦➔🦋 Store and retrieve files on the Atmosphere
various
+154
-63
+4
-7
README.md
+4
-7
README.md
···
27
27
* 🟢 **macOS**: Compatible with built-in version of Bash (3.2)
28
28
* 🟡 **Windows**: MinGW (Cygwin, Git Bash, MSYS2, etc.) and WSL (see Linux caveats above)
29
29
* This repository **does not** provide a native version for Windows
30
-
* 🟢 **BSD**: FreeBSD, NetBSD and OpenBSD; other non-detected BSDs should work (see ¹)
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
33
* **Bash³:** 3.x or later
···
43
43
* [`websocat`](https://github.com/vi/websocat) _(optional: needed for `stream`)_
44
44
* **ATProto account**
45
45
* Both [Bluesky PBC-operated](https://bsky.social) and self-hosted accounts supported
46
-
* If you're using a `bsky.network` (`@*.bsky.social`) account, limit the amount of files you upload to Bluesky PBC's servers. Heed the copyright warning: **do not upload copyrighted files.**
46
+
* If you're using a `bsky.network` (`@*.bsky.social`) account, limit the amount of files you upload to Bluesky PBC's servers. Heed the copyright warning: **do not upload copyrighted files**
47
47
* `did:web` accounts supported!
48
48
* Confirmed to work on [Bluesky PDS](https://github.com/bluesky-social/pds) and [millipds](https://github.com/DavidBuchanan314/millipds)
49
49
* Other PDSs remain untested, but if they implement standard `com.atproto.*` endpoints, there should be no reason these won't work
···
64
64
65
65
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
66
67
-
* **Linux/Windows/BSD/Solaris**
67
+
* __Linux/Windows/*BSD/Solaris__
68
68
* Install: `$HOME/.local/bin/atfile`
69
69
* As `sudo`/`root`: `/usr/local/bin/atfile`
70
70
* Config: `$HOME/.config/atfile.env`
···
123
123
124
124
* **¹** You can bypass OS detection in one of two ways:
125
125
* Set `ATFILE_SKIP_UNSUPPORTED_OS=1`<br />Be careful! There's a reason some OSes are not supported
126
-
* Set `ATFILE_FORCE_OS=<os>`<br />This overrides the OS detected. Possible values:
127
-
* BSD: `bsd-freebsd`, `bsd-netbsd`, `bsd-openbsd`
128
-
* Linux: `linux`, `linux-mingw`, `linux-musl`, `linux-termux`
129
-
* Other: `haiku`, `macos`, `solaris`
126
+
* Set `ATFILE_FORCE_OS=<os>`<br />This overrides the OS detected. Possible values: `bsd`, `haiku`, `linux`, `linux-mingw`, `linux-musl`, `linux-termux`, `macos`, `solaris`, `unknown`
130
127
* **²** musl-powered distros do not use GNU/glibc packages, and have problems currently
131
128
* Known musl distros: Alpine, Chimera, Dragora, Gentoo (musl), Morpheus, OpenWrt, postmarketOS, Sabotage, Void
132
129
* Bypassing OS detection (see ¹) will work, but dates will not be handled correctly
+5
atfile.sh
+5
atfile.sh
···
59
59
unset ATFILE_DEVEL_ENTRY
60
60
unset ATFILE_DEVEL_SOURCE
61
61
62
+
#if [ -p /dev/stdin ] ||\
63
+
# [[ "$0" == "bash" || $0 == *"/bin/bash" ]]; then
64
+
# atfile.devel.die "Piping is not supported"
65
+
#fi
66
+
62
67
if [[ "${BASH_SOURCE[0]}" != "$0" ]]; then
63
68
ATFILE_DEVEL=1
64
69
ATFILE_DEVEL_DIR="$(dirname "${BASH_SOURCE[0]}")"
+56
-1
src/commands/install.sh
+56
-1
src/commands/install.sh
···
1
1
#!/usr/bin/env bash
2
2
3
3
function atfile.install() {
4
-
atfile.die "Not implemented"
4
+
override_path="$1"
5
+
override_version="$2"
6
+
7
+
uid="$(id -u)"
8
+
conf_file="atfile.env"
9
+
install_file="atfile"
10
+
unset conf_dir
11
+
unset install_dir
12
+
13
+
atfile.util.check_prog "curl"
14
+
atfile.util.check_prog "jq"
15
+
16
+
if [[ $_os_supported == 0 ]]; then
17
+
atfile.die "Unsupported OS (${_os//unknown-/})"
18
+
fi
19
+
20
+
if [[ $_os == "haiku" ]]; then
21
+
install_dir="/boot/system/non-packaged/bin"
22
+
conf_dir="$HOME/config/settings"
23
+
else
24
+
if [[ $uid == 0 ]]; then
25
+
install_dir="/usr/local/bin"
26
+
27
+
if [[ -z $SUDO_DIR ]]; then
28
+
conf_dir="/root/.config"
29
+
else
30
+
if [[ $_os == "macos" ]]; then
31
+
conf_dir="$(eval echo ~"$SUDO_USER")/Library/Application Support"
32
+
else
33
+
conf_dir="$(eval echo ~"$SUDO_USER")/.config"
34
+
fi
35
+
fi
36
+
else
37
+
install_dir="$(eval echo ~"$USER")/.local/bin"
38
+
conf_dir="$(eval echo ~"$USER")/.config"
39
+
40
+
if [[ $_os == "macos" ]]; then
41
+
conf_dir="$(eval echo ~"$USER")/Library/Application Support"
42
+
else
43
+
conf_dir="$(eval echo ~"$USER")/.config"
44
+
fi
45
+
fi
46
+
47
+
# INVESTIGATE: What happens during `sudo`?
48
+
if [[ -n "$XDG_CONFIG_HOME" ]]; then
49
+
conf_dir="$XDG_CONFIG_HOME"
50
+
fi
51
+
fi
52
+
53
+
[[ -n "$override_path" ]] && install_dir="$override_path"
54
+
55
+
atfile.say.debug "Installing...\n↳ OS: $_os\n↳ Install: $install_dir/$install_file\n↳ Config: $conf_dir/$conf_file"
56
+
57
+
if [[ -f "$install_dir/$install_file" ]]; then
58
+
atfile.die "Already installed ($install_dir/$install_file)"
59
+
fi
5
60
}
+1
-1
src/commands/old_cmds.sh
+1
-1
src/commands/old_cmds.sh
+7
-2
src/commands/update.sh
+7
-2
src/commands/update.sh
···
4
4
function atfile.update() {
5
5
cmd="$1"
6
6
unset error
7
+
is_git=0
8
+
9
+
if [ -x "$(command -v git)" ] && [[ -d "$_prog_dir/.git" ]] && [[ "$(atfile.util.get_realpath "$(pwd)")" == "$_prog_dir" ]]; then
10
+
is_git=1
11
+
fi
7
12
8
13
if [[ "$cmd" == "check-only" ]]; then
9
14
# shellcheck disable=SC2154
···
11
16
# shellcheck disable=SC2154
12
17
[[ $_disable_updater == 1 ]] && return
13
18
# shellcheck disable=SC2154
14
-
[[ $_is_git == 1 && $_enable_update_git_clobber == 0 ]] && return
19
+
[[ $is_git == 1 && $_enable_update_git_clobber == 0 ]] && return
15
20
# shellcheck disable=SC2154
16
21
[[ $_output_json == 1 ]] && return
17
22
···
78
83
return
79
84
fi
80
85
81
-
[[ $_is_git == 1 && $_enable_update_git_clobber == 0 ]] &&\
86
+
[[ $is_git == 1 && $_enable_update_git_clobber == 0 ]] &&\
82
87
atfile.die "Cannot update in Git repository"
83
88
[[ $_disable_updater == 1 ]] &&\
84
89
atfile.die "Cannot update system-managed version: update from your package manager"
+69
-40
src/entry.sh
+69
-40
src/entry.sh
···
1
1
#!/usr/bin/env bash
2
2
3
-
# Global variables
3
+
# Environment
4
4
5
-
## General
5
+
## Early-start global variables
6
6
7
-
_start="$(atfile.util.get_date "" "%s")"
7
+
_start="$(atfile.util.get_date "" "%s")" # 1
8
+
_envvar_prefix="ATFILE" # 2
9
+
_debug="$(atfile.util.get_envvar "${_envvar_prefix}_DEBUG" "0")" # 3
8
10
_command="$1"
9
11
_command_args=("${@:2}")
10
-
_envvar_prefix="ATFILE"
11
12
_os="$(atfile.util.get_os)"
12
-
_is_git=0
13
+
_os_supported=0
14
+
_is_piped=0
13
15
_is_sourced=0
14
16
_meta_author="{:meta_author:}"
15
17
_meta_did="{:meta_did:}"
···
17
19
_meta_year="{:meta_year:}"
18
20
_now="$(atfile.util.get_date)"
19
21
_version="{:version:}"
22
+
23
+
## "Hello, world!"
24
+
25
+
atfile.say.debug "Reticulating splines..."
26
+
27
+
## OS detection
28
+
29
+
atfile.say.debug "Detected OS: $_os"
30
+
31
+
if [[ $_os != "unknown-"* ]] &&\
32
+
[[ $_os == "bsd" ]] ||\
33
+
[[ $_os == "haiku" ]] ||\
34
+
[[ $_os == "linux" ]] ||\
35
+
[[ $_os == "linux-mingw" ]] ||\
36
+
[[ $_os == "linux-termux" ]] ||\
37
+
[[ $_os == "macos" ]] ; then
38
+
_os_supported=1
39
+
fi
40
+
41
+
## Pipe detection
42
+
43
+
if [ -p /dev/stdin ] ||\
44
+
[[ "$0" == "bash" || $0 == *"/bin/bash" ]]; then
45
+
_is_piped=1
46
+
atfile.say.debug "Piping: $0"
47
+
fi
48
+
49
+
## Source detection
50
+
51
+
if [[ -n ${BASH_SOURCE[0]} ]]; then
52
+
if [[ "$0" != "${BASH_SOURCE[0]}" ]]; then
53
+
if [[ "$ATFILE_DEVEL" == 1 ]]; then
54
+
if [[ -n "$ATFILE_DEVEL_SOURCE" ]]; then
55
+
_is_sourced=1
56
+
atfile.say.debug "Sourcing: $ATFILE_DEVEL_SOURCE"
57
+
fi
58
+
else
59
+
_is_sourced=1
60
+
atfile.say.debug "Sourcing: ${BASH_SOURCE[0]}"
61
+
fi
62
+
fi
63
+
fi
64
+
65
+
# Installation
66
+
67
+
if [[ $_is_piped == 1 ]] ||\
68
+
[[ "$1" == "install" ]]; then
69
+
if [[ "$1" == "install" ]]; then
70
+
atfile.install "$2" "$3"
71
+
install_exit="$?"
72
+
else
73
+
atfile.install "$1" "$2"
74
+
install_exit="$?"
75
+
fi
76
+
77
+
atfile.util.print_seconds_since_start_debug
78
+
exit $install_exit
79
+
fi
80
+
81
+
# Global variables
20
82
21
83
## Reflection
22
84
···
150
212
151
213
# Setup
152
214
153
-
atfile.say.debug "Starting up..."
154
-
155
-
## Source detection
156
-
157
-
if [[ "$0" != "${BASH_SOURCE[0]}" ]]; then
158
-
if [[ "$ATFILE_DEVEL" == 1 ]]; then
159
-
if [[ -n "$ATFILE_DEVEL_SOURCE" ]]; then
160
-
_is_sourced=1
161
-
atfile.say.debug "Sourcing: $ATFILE_DEVEL_SOURCE"
162
-
fi
163
-
else
164
-
_is_sourced=1
165
-
atfile.say.debug "Sourcing: ${BASH_SOURCE[0]}"
166
-
fi
167
-
fi
168
-
169
215
## Envvar correction
170
216
171
217
### Overrides
···
202
248
atfile.say.debug "Setting ${_envvar_prefix}_MAX_LIST to $_max_list_fallback\n↳ Maximum is $_max_list_fallback" &&\
203
249
_max_list=$_max_list_fallback
204
250
205
-
## Git detection
206
-
207
-
if [ -x "$(command -v git)" ] && [[ -d "$_prog_dir/.git" ]] && [[ "$(atfile.util.get_realpath "$(pwd)")" == "$_prog_dir" ]]; then
208
-
_is_git=1
209
-
fi
210
-
211
251
## OS detection
212
252
213
-
atfile.say.debug "Checking OS is supported...\n↳ Detected: $_os"
214
-
is_os_supported=0
215
-
216
-
if [[ $_os != "unknown-"* ]] &&\
217
-
[[ $_os == "bsd-"* ]] ||\
218
-
[[ $_os == "haiku" ]] ||\
219
-
[[ $_os == "linux" ]] ||\
220
-
[[ $_os == "linux-mingw" ]] ||\
221
-
[[ $_os == "linux-termux" ]] ||\
222
-
[[ $_os == "macos" ]] ; then
223
-
is_os_supported=1
224
-
fi
253
+
atfile.say.debug "Checking OS is supported..."
225
254
226
-
if [[ $is_os_supported == 0 ]]; then
255
+
if [[ $_os_supported == 0 ]]; then
227
256
if [[ $_skip_unsupported_os_warn == 0 ]]; then
228
257
atfile.die "Unsupported OS (${_os//unknown-/})\n↳ Set ${_envvar_prefix}_SKIP_UNSUPPORTED_OS_WARN=1 to ignore"
229
258
else