Merge ~ycheng-twn/pc-enablement/+git/oem-scripts:0001_launchpad_api_handy into ~oem-solutions-engineers/pc-enablement/+git/oem-scripts:master

[Yuan-Chen Cheng]

launchpad-api: refine message and add handy test

[Yuan-Chen Cheng (ycheng-twn)]

+ cat output/oem-scripts-0.99-1f89055-in-docker-focal-summary.log
autopkgtest-collect-credentials PASS
autopkgtest-oem-scripts-auto PASS
pkg-somerville-meta PASS
pkg-stella-meta PASS
pkg-sutton-meta PASS
bug-bind PASS
get-private-ppa PASS
jq-lp PASS
launchpad-api PASS
lp-bug PASS
oem-meta-packages PASS
pkg-list PASS
review-merge-proposal PASS
run-autopkgtest PASS
setup-apt-dir PASS
mir-bug SKIP exit status 77 and marked as skippable
git-url-insteadof-setting PASS
recovery-from-iso.sh PASS
mir-bug-verification PASS

[Shih-Yuan Lee (fourdollars)]

Please use "Here Documents" instead.

review: Needs Fixing

[Shih-Yuan Lee (fourdollars)]

LGTM

review: Approve

diff --git a/debian/changelog b/debian/changelog
index a693a9a..378680c 100644
--- a/debian/changelog
+++ b/debian/changelog
@@ -1,3 +1,9 @@
+oem-scripts (0.99) UNRELEASED; urgency=medium
+
+  * launchpad-api: refine message and add handy test.
+
+ -- Yuan-Chen Cheng <[e-mail]>  Fri, 04 Jun 2021 13:00:53 +0800
+
 oem-scripts (0.98) focal; urgency=medium
 
   * Black all Python files.
diff --git a/launchpad-api b/launchpad-api
index d812b8f..aa4001e 100755
--- a/launchpad-api
+++ b/launchpad-api
@@ -23,6 +23,33 @@ fi
 LAUNCHPAD_URL="${LAUNCHPAD_URL:=https://launchpad.net}"
 LAUNCHPAD_API="${LAUNCHPAD_API:=https://api.launchpad.net/}"
 
+usage_auth_failed()
+{
+    >&2 cat <<EOF
+=== Failure as accessing the web service.
+
+It could be command error OR your authentication token is removed or expired.
+If you think it's the authentication issue, you can try to backup/remove
+the config.ini, get authentication token and try again.
+
+Ex:
+
+  $ mv ~/.config/oem-scripts/config.ini ~/.config/oem-scripts/config.ini.backup
+  $ launchpad-api get devel/people/+me
+  $ # try your command after reset token by using above commands.
+
+EOF
+}
+
+usage()
+{
+    >&2 cat <<EOF
+=== Useage:
+  $ launchpad-api get devel/people/+me # same as "launchpad-api test"
+  $ launchpad-api get devel/people/+me ws.op==getArchiveSubscriptionURLs
+EOF
+}
+
 get_token()
 {
     [ "x$debug" = "x1" ] && echo "oauth_consumer_key=${oauth_consumer_key}"
@@ -97,7 +124,7 @@ get_api()
         oauth_timestamp=="$(date +%s)" \
         oauth_token=="${oauth_token}" \
         oauth_version=="1.0" \
-        "$@"
+        "$@" || ( usage_auth_failed ; usage )
 }
 
 patch_api()
@@ -162,10 +189,14 @@ case "$1" in
         shift
         post_api "$@"
         ;;
+    ("test")
+        get_api devel/people/+me
+        ;;
     ("debug")
         debug=1
         get_api devel/people/+me
         ;;
     (*)
+        usage
         ;;
 esac