token-upgrade: Add CLI and docs (#3593)

* token-upgrade: Add CLI and docs

* Remove build.rs and build by hand

* Exclude token-upgrade-cli from cargo-build-test

* Use user-friendly token-client response printing

* Make docs consistent with implementation + other feedback

* Remove integer arithmetic

* Make required parameters `required()`

Author: joncinque

.github/workflows/pull-request-token-upgrade.yml

@@ -60,3 +60,50 @@ jobs:
 
       - name: Build and test
         run: ./ci/cargo-test-sbf.sh token-upgrade
+
+  cargo-build-test-cli:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v2
+
+      - name: Set env vars
+        run: |
+          source ci/rust-version.sh
+          echo "RUST_STABLE=$rust_stable" >> $GITHUB_ENV
+          source ci/solana-version.sh
+          echo "SOLANA_VERSION=$solana_version" >> $GITHUB_ENV
+
+      - uses: actions-rs/toolchain@v1
+        with:
+          toolchain: ${{ env.RUST_STABLE }}
+          override: true
+          profile: minimal
+
+      - uses: actions/cache@v2
+        with:
+          path: |
+            ~/.cargo/registry
+            ~/.cargo/git
+          key: cargo-build-${{ hashFiles('**/Cargo.lock') }}-${{ env.RUST_STABLE }}
+
+      - uses: actions/cache@v2
+        with:
+          path: ~/.cache/solana
+          key: solana-${{ env.SOLANA_VERSION }}
+
+      - name: Install dependencies
+        run: |
+          ./ci/install-build-deps.sh
+          ./ci/install-program-deps.sh
+          echo "$HOME/.local/share/solana/install/active_release/bin" >> $GITHUB_PATH
+
+      - name: Build dependent programs
+        run: |
+          cargo build-sbf --manifest-path ./token/program/Cargo.toml
+          cargo build-sbf --manifest-path ./token/program-2022/Cargo.toml
+          cargo build-sbf --manifest-path ./associated-token-account/program/Cargo.toml
+          cargo build-sbf --manifest-path ./token-upgrade/program/Cargo.toml
+
+      - name: Run CLI tests
+        run: |
+          cargo test --manifest-path ./token-upgrade/cli/Cargo.toml