feat: enable version refreshing when calling list by default

Author: kylef

CHANGELOG.md

@@ -2,6 +2,11 @@
 
 ## Master
 
+### Enhancements
+
+- Fetching a list of versions that can be installed (`swiftenv install --list`)
+  will now fetch an updated list of versions.
+
 ### Bug Fixes
 
 - Prevent `swiftenv install` picking up on unrelated `$URL` environment

docs/getting-started.md

@@ -26,7 +26,7 @@ $ swiftenv install 3.0
 You can list all versions of Swift:
 
 ```shell
-$ swiftenv install --list --refresh
+$ swiftenv install --list
 ```
 
 You can also list all binary snapshots of Swift that you can install.

libexec/swiftenv-install

@@ -251,6 +251,7 @@ get_version_list() {
   CACHE_FILE="$CACHE_DIR/versions-${platform}.txt"
 
   if $refresh; then
+    vlog "Updating version cache"
     # FIXME: Add support for architecture to swiftenv api
     mkdir -p $CACHE_DIR
     curl -s -H 'Accept: text/plain' "https://swiftenv-api.fuller.li/versions?platform=$platform" > "$CACHE_FILE"
@@ -267,7 +268,7 @@ get_version_list() {
 
 clean=true
 list=false
-refresh=false
+refresh=true
 snapshots=false
 build=auto
 verbose=false
@@ -302,6 +303,7 @@ for args in "$@"; do
   elif [ "$args" = "--no-refresh" ]; then
     refresh=false
   elif [ "$args" = "--complete" ]; then
+    refresh=false
     completes=true
   elif [ "$args" = "--build" ]; then
     build=true
@@ -345,6 +347,8 @@ vlog() {
 if $completes; then
   echo "--list"
   echo "--list-snapshots"
+  echo "--refresh"
+  echo "--no-refresh"
   echo "--verbose"
   echo "--no-verbose"
   echo "--verify"

share/man/man1/swiftenv-install.1

@@ -4,7 +4,7 @@
 swiftenv-install \- Install a version of Swift
 
 .SH SYNOPSIS
-swiftenv install [\-\-verbose] [\-\-list] [\-\-list-snapshots] [\-\-[no\-]build] [\-\-[no\-]set\-global] [\-\-[no\-]set\-local] [--no-clean] [\-\-[no\-]user] <version>
+swiftenv install [\-\-verbose] [\-\-list] [\-\-list-snapshots] [\-\-no\-refresh] [\-\-[no\-]build] [\-\-[no\-]set\-global] [\-\-[no\-]set\-local] [--no-clean] [\-\-[no\-]user] <version>
 
 .SH DESCRIPTION
 
@@ -27,9 +27,16 @@ Lists all the Swift releases that can be installed.
 \-\-refresh
 
 .RS
+On by default.
 When used in conjunction with \-\-list, fetches an updated information.
 .RE
 
+\-\-no\-refresh
+
+.RS
+Force using local version information with \-\-list.
+.RE
+
 \-\-list-snapshots
 
 .RS