shopify-cli 0.9.0 → 1.0.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4994302e6b4675d919d6eba3f29037f6531e9d763332e688f6a4e2008a9f8785
-  data.tar.gz: de8db4ec0be15baac70f091548861364919543c193e0c73ecf94e43ac645b9fa
+  metadata.gz: fa8d08ea4c9f452ea672ebe158f4e900eda442cc17aa46905d25aa53a7f3a673
+  data.tar.gz: 516ee988dee9309aa0e3319d576fe5fcd13065fa08b0b9a4d648fced6642d26e
 SHA512:
-  metadata.gz: ba5c507a109d2511dc33382152f46aebbfa0ffb80d8e1f34e588730ecbead56ccc476df04d9e902120c1beecd3e69a957415e73c30b11ade137a9572f94fba73
-  data.tar.gz: d4dcd572be32221413d30ebb28acb1a66bf8f8290a6825159c92802e149f48a93cde4dea6d5eb13a0a82e52af34c5a02403328b0e98566f0ef83078875fca942
+  metadata.gz: dc4c9b95106709203f6153310bdee08183b3bad45f1ff7f3512b408fabfa478391ca4e5adbfe6cc6b2aaaea655363067de9bacb39a8ff02016e5df03aa7366de
+  data.tar.gz: 503b6c26f1c57e65f5a22b5171faa8d9e5117c404ca02bec6a92af571cadf17f74918fd8bcf2b993100b0e09b3f20576dbeca401cbbb93c7f2355ac389bdf6ed

data/.github/CODEOWNERS

@@ -1 +1,4 @@
 *       @shopify/platform-dev-tools-education
+
+/lib/project_types/script/ @shopify/scripts
+/test/project_types/script/ @shopify/scripts

data/CHANGELOG.md

@@ -0,0 +1,26 @@
+Version 1.0.1
+------
+* Fixed an issue with RVM taking over the shell shim fd when it was not in use
+
+Version 1.0.0
+------
+* Release the installer-based version of the CLI
+
+Version 0.9.3 - Internal Test Version
+------
+* Rebased to master
+* Removed auto-generated files from builds directory
+
+Version 0.9.2 - Internal Test Version
+------
+* Rebased to master, to pull in 7+ Pull Requests
+* Updates to dependencies to package files (updated Ruby version)
+
+Version 0.9.1 - Internal Test Version
+------
+* Updated required Ruby version for the CLI
+* Minor fixes for the build / release process
+
+Version 0.9.0 - Internal Test Version
+------
+* Initial test release of gem-based CLI

data/RELEASING.md

@@ -0,0 +1,51 @@
+## Releasing Shopify CLI
+
+1. Check the Semantic Versioning page for info on how to version the new release: http://semver.org
+
+2. Create a branch named `release_X_Y_Z` (replacing `X_Y_Z` with the intended release version)
+   ```
+   $ git checkout -b release_X_Y_Z
+   ```
+
+3. Update the version of Shopify CLI in `lib/shopify-cli/version.rb`
+
+4. Add an entry for the new release to `CHANGELOG.md`
+
+5. Commit the changes with a commit message like "Packaging for release X.Y.Z"
+   ```
+   $ git commit -am "Packaging for release vX.Y.Z"
+   ```
+
+6. Push out the changes
+   ```
+   $ git push -u origin release_X_Y_Z
+   ```
+
+7. Open a PR for the branch, get necessary approvals from code owners and merge into main branch. Note that the PR title will be the release note in Shipit, so make sure it mentions the release
+
+8. Deploy using Shipit
+
+9. On local machine and _AFTER_ gem has been published to https://rubygems.org, run
+   ```
+   $ rake package
+   ```
+   This will generate the `.deb`, `.rpm` and brew formula files, which will be located in `packaging/builds/X.Y.Z/`.
+
+10. Clone the `Shopify/homebrew-shopify` repository (if not already cloned), and then
+    * create a branch named `release_X_Y_Z_of_shopify-cli`
+    * update the brew formula in `shopify-cli.rb` with the generated formula in `packaging/builds/X.Y.Z/` in the `Shopify/shopify-app-cli` repo (from step 9)
+    * commit the change and create a PR on the [Shopify Homebrew repository](https://github.com/Shopify/homebrew-shopify)
+    * when PR is approved, merge into main branch
+
+11. Go to [releases](https://github.com/Shopify/shopify-app-cli/releases) page of `Shopify/shopify-app-cli` repo and create a new release:
+    * use the tag created in step 8 by Shipit (should be "vX.Y.Z")
+    * release title = "Version X.Y.Z"
+    * description should be 
+      ```
+      Release of version X.Y.Z of Shopify App CLI
+    
+      Please refer to [CHANGELOG](https://github.com/Shopify/shopify-app-cli/blob/master/CHANGELOG.md) for details.
+      ```
+    * upload the `.deb` and `.rpm` files from `packaging/builds/X.Y.Z/` (generated in step 9)
+    * if it's a pre-release version, select the "This is a pre-release" checkbox
+    * and click "Publish release".

data/Rakefile

@@ -76,11 +76,6 @@ namespace :package do
 
   task all: [:debian, :rpm, :homebrew]
 
-  desc("Builds a gem of the CLI")
-  task :gem do
-    ShopifyCli::Packager.new.build_gem
-  end
-
   desc("Builds a Debian package of the CLI")
   task :debian do
     ShopifyCli::Packager.new.build_debian
@@ -92,7 +87,7 @@ namespace :package do
   end
 
   desc("Builds a Homebrew package of the CLI")
-  task :homebrew => :"package:gem" do
+  task :homebrew do
     ShopifyCli::Packager.new.build_homebrew
   end
 end

data/docs/_config.yml

@@ -14,3 +14,6 @@ defaults:
       path: ""
     values:
       toc: true
+
+plugins:
+  - jekyll-redirect-from

data/docs/_data/nav.yml

@@ -5,6 +5,15 @@ sidebar:
   - title: Getting started
     section: getting-started
     url: /getting-started/
+    subnav:
+      - title: Install
+        url: /getting-started/install/
+      - title: Upgrade
+        url: /getting-started/upgrade/
+      - title: Uninstall
+        url: /getting-started/uninstall/
+      - title: Migrate from a legacy version
+        url: /getting-started/migrate/
   - title: Core commands
     section: core
     url: /core/

data/docs/getting-started/index.md

@@ -1,6 +1,7 @@
 ---
 title: Getting started
 section: getting-started
+toc: false
 ---
 
 Developers should have some prior knowledge of the [Shopify app ecosystem](https://shopify.dev/concepts/apps). Shopify App CLI creates apps using either [Node.js](https://nodejs.org/) or [Ruby on Rails](https://rubyonrails.org/).
@@ -8,11 +9,8 @@ Developers should have some prior knowledge of the [Shopify app ecosystem](https
 ## Requirements
 
 - [Ruby](https://www.ruby-lang.org) 2.5.1+ 
-- [Node.js](https://nodejs.org) 10.0.0+
-- [curl](https://curl.haxx.se)
 - A [Shopify partner account](https://partners.shopify.com/signup)
 - A [Shopify development store](https://help.shopify.com/en/partners/dashboard/development-stores#create-a-development-store) to install and test apps
-- An [ngrok](https://ngrok.com/) account (free or paid) for local development
 
 ### Windows requirements
 
@@ -21,41 +19,8 @@ You’ll need to install the following tools to use Shopify App CLI on Windows:
 - [Linux Subsystem for Windows](https://docs.microsoft.com/en-us/windows/wsl/install-win10)
 - [Ubuntu VM](https://www.microsoft.com/en-ca/p/ubuntu/9nblggh4msv6)
 
-## Install
+## Next steps
 
-Shopify App CLI installs using a shell script. Download and run it in your terminal with one command:
-
-```console
-eval "$(curl -sS https://raw.githubusercontent.com/Shopify/shopify-app-cli/master/install.sh)"
-```
-
-[View shell script source](https://raw.githubusercontent.com/Shopify/shopify-app-cli/master/install.sh)
-
-
-## Uninstall
-
-There are two steps to completely uninstall Shopify App CLI:
-
-1. Delete the CLI files
-1. Remove the `shopify` command from your shell profile
-
-### 1. Delete the CLI files
-
-By default, Shopify App CLI is installed in your home directory. All the files are contained in a hidden directory called `.shopify-app-cli`. Delete that directory to uninstall.
-
-### 2. Remove the `shopify` command from your shell
-
-During the install process, Shopify App CLI adds a line to your shell configuration. This line is typically located in the `.bash_profile` file in your home directory (depending on your system, it may also be found in `.bash_login` or `.profile`). It will look similar to this:
-
-```sh
-# The line won’t look exactly like this. `HOME_DIR` will instead be the absolute path to your home directory.
-if [[ -f /HOME_DIR/.shopify-cli/shopify.sh ]]; then source /HOME_DIR/.shopify-cli/shopify.sh; fi
-```
-
-You can use `grep` to search for the correct file in your home directory. This command will return the name of the relevant file, and the line number where it appears:
-
-```console
-$ grep -Ens "^if.+\.shopify-app-cli/shopify\.sh.+fi$" ~/\.*
-```
-
-Deleting or commenting out the relevant line in your shell profile will remove `shopify` as a command. You may need to reload your shell.
+- [Install the CLI]({{ site.baseurl }}/getting-started/install/)
+- [Upgrade]({{ site.baseurl }}/getting-started/upgrade/)
+- [Uninstall]({{ site.baseurl }}/getting-started/uninstall/)

data/docs/getting-started/install/index.md

@@ -0,0 +1,39 @@
+---
+title: Install Shopify App CLI
+section: getting-started
+toc: false
+redirect_from: "/install/"
+---
+
+Shopify App CLI can be installed using a variety of package managers.
+
+### Homebrew (macOS)
+
+You’ll need to run `brew tap` first to add Shopify’s third-party repositories to Homebrew.
+
+```console
+$ brew tap shopify/shopify
+$ brew install shopify-cli
+```
+
+### apt (Debian, Ubuntu)
+
+You’ll need to install a downloaded .deb file with an explicit version number. Check the [releases page](https://github.com/Shopify/shopify-app-cli/releases) to make sure you install the latest package.
+
+```console
+$ sudo apt install shopify-cli-x.y.z.deb
+```
+
+### yum (CentOS 8+, Fedora, Red Hat, SUSE)
+
+You’ll need to install a downloaded .rpm file with an explicit version number. Check the [releases page](https://github.com/Shopify/shopify-app-cli/releases) to make sure you install the latest package.
+
+```console
+$ sudo yum install shopify-cli-x.y.x.rpm
+```
+
+### Ruby gem
+
+```console
+$ gem install shopify-cli
+```

data/docs/getting-started/migrate/index.md

@@ -0,0 +1,63 @@
+---
+title: Migrate from the legacy Shopify App CLI
+section: getting-started
+redirect_from: "/migrate/"
+---
+
+As of version 0.9.0, Shopify App CLI is installed and managed as a software package, instead of as a git repository. If you’re using a legacy version, you’ll need to perform a one-time migration to keep using the CLI. Follow these steps to remove the legacy version and reinstall as a package.
+
+## Check whether you’re using the legacy version
+
+Prior to version 0.9.0, Shopify App CLI was installed as a Git repository. You can determine if you’re running a legacy version by running this command:
+
+```console
+$ shopify version
+```
+
+If you get a “Command not found” error, then you’re using a legacy version and will need to uninstall it manually.
+
+## 1. Uninstall the legacy Shopify App CLI
+
+There are two steps to completely uninstall the legacy version of Shopify App CLI:
+
+1. Delete the legacy CLI files
+1. Remove the legacy `shopify` command from your shell profile
+
+### 1. Delete the CLI files
+
+By default, Shopify App CLI was installed in your home directory. All the files are contained in a hidden directory called `.shopify-app-cli`. Delete it to uninstall:
+
+```console
+$ rm -rf ~/.shopify-app-cli/
+```
+
+### 2. Remove the `shopify` command from your shell
+
+During the install process, Shopify App CLI added a line to your shell configuration. This line could be located in one of a few possible files in your home directory:
+
+- `~/.bash_profile`
+- `~/.zshrc`
+- `~/.bash_login`
+- `~/.profile`
+- `~/.config/fish/config.fish`
+
+It will look similar to one of the lines below. The exact syntax may vary depending on your system:
+
+```sh
+# The line won’t look *exactly* like this. `HOME_DIR` will instead be the absolute path to your home directory.
+if [[ -f /HOME_DIR/.shopify-cli/shopify.sh ]]; then source /HOME_DIR/.shopify-cli/shopify.sh; fi
+
+# The line might not be wrapped in an `if` statement. Example:
+[ -f "/HOME_DIR/.shopify-app-cli/shopify.sh" ] && source "/HOME_DIR/.shopify-app-cli/shopify.sh"
+```
+
+Deleting or commenting out the relevant line in your shell profile will remove `shopify` as a command. You may need to reload your shell.
+
+## 2. Install the new version
+
+Next, install the most recent version of Shopify App CLI. Follow the [install directions]({{ site.baseurl }}/getting-started/install/) for your platform.
+
+## 3. Re-authenticate the CLI
+
+The migration process moves some configuration files, so you’ll need to re-authenticate the CLI with your Shopify Partner Dashboard. The CLI will automatically prompt you to re-authenticate when needed.
+

data/docs/getting-started/uninstall/index.md

@@ -0,0 +1,37 @@
+---
+title: Uninstall Shopify App CLI
+section: getting-started
+toc: false
+redirect_from: "/uninstall/"
+---
+
+Shopify App CLI can be removed from your system using the same package manager you used to install it.
+
+### Homebrew (macOS)
+
+```console
+$ brew uninstall shopify-cli
+```
+
+### apt (Debian, Ubuntu)
+
+```console
+$ sudo apt remove shopify-cli
+```
+
+### yum (CentOS 8+, Fedora, Red Hat, SUSE)
+
+```console
+$ sudo yum remove shopify-cli
+```
+
+### Ruby gem
+
+```console
+$ gem uninstall shopify-cli
+```
+
+## Uninstall a legacy version
+
+If you’re using a legacy version of the CLI (`<0.9.0`), you’ll need to [uninstall it manually]({{ site.baseurl }}/getting-started/migrate/#1-uninstall-the-old-cli).
+

data/docs/getting-started/upgrade/index.md

@@ -0,0 +1,37 @@
+---
+title: Upgrade Shopify App CLI
+section: getting-started
+toc: false
+redirect_from: "/upgrade/"
+---
+
+You can manage upgrades to Shopify App CLI with the package manager for your platform.
+
+### Homebrew (macOS)
+
+```console
+$ brew update
+$ brew upgrade shopify-cli
+```
+
+### apt (Debian, Ubuntu)
+
+On Debian-based Linux distributions, download the latest `.deb` file for Shopify App CLI from the [releases page](https://github.com/Shopify/shopify-app-cli/releases) and install it to update.
+
+```console
+$ sudo apt install shopify-cli-x.y.z.deb
+```
+
+### yum (CentOS 8+, Fedora, Red Hat, SUSE)
+
+On Red Hat–based Linux distributions, download the latest `.rpm` file for Shopify App CLI from the [releases page](https://github.com/Shopify/shopify-app-cli/releases) and install it to update.
+
+```console
+$ sudo yum install shopify-cli-x.y.z.rpm
+```
+
+### Ruby gem
+
+```console
+$ gem update shopify-cli
+```

data/docs/index.md

@@ -10,18 +10,17 @@ Shopify App CLI helps you build Shopify apps faster. It quickly scaffolds Node.j
 
 ## Quick start
 
-1. Install Shopify App CLI:
-    ```console
-    $ eval "$(curl -sS https://raw.githubusercontent.com/Shopify/shopify-app-cli/master/install.sh)"
-    ```
+1. [Install Shopify App CLI]({{ site.baseurl }}{% link getting-started/install/index.md %}).
 2. Create an app:
     ```console
     $ shopify create
     ```
-3. Start and install your app on a Shopify Development store:
+3. Start and install your app on a Shopify development store:
     ```console
     $ shopify serve
     ```
     ```console
     $ shopify open
-    ```
+    ```
+
+**[Learn more in our Getting Started guide]({{ site.baseurl }}{% link getting-started/index.md %})**

data/lib/project_types/extension/cli.rb

@@ -30,6 +30,7 @@ module Extension
   module Tasks
     autoload :UserErrors, Project.project_filepath('tasks/user_errors')
     autoload :GetApps, Project.project_filepath('tasks/get_apps')
+    autoload :GetApp, Project.project_filepath('tasks/get_app')
     autoload :CreateExtension, Project.project_filepath('tasks/create_extension')
     autoload :UpdateDraft, Project.project_filepath('tasks/update_draft')
 
@@ -37,6 +38,7 @@ module Extension
       autoload :RegistrationConverter, Project.project_filepath('tasks/converters/registration_converter')
       autoload :VersionConverter, Project.project_filepath('tasks/converters/version_converter')
       autoload :ValidationErrorConverter, Project.project_filepath('tasks/converters/validation_error_converter')
+      autoload :AppConverter, Project.project_filepath('tasks/converters/app_converter')
     end
   end
 
@@ -51,7 +53,6 @@ module Extension
     autoload :ArgoSetupStep, Project.project_filepath('features/argo_setup_step')
     autoload :ArgoSetupSteps, Project.project_filepath('features/argo_setup_steps')
     autoload :ArgoDependencies, Project.project_filepath('features/argo_dependencies')
-    autoload :TunnelUrl, Project.project_filepath('features/tunnel_url')
   end
 
   module Models

data/lib/project_types/extension/commands/tunnel.rb

@@ -37,7 +37,7 @@ module Extension
       private
 
       def status
-        tunnel_url = Features::TunnelUrl.fetch
+        tunnel_url = ShopifyCli::Tunnel.urls.first
 
         if tunnel_url.nil?
           @ctx.puts(@ctx.message('tunnel.no_tunnel_running'))