shopify-cli 0.9.2 → 1.0.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c2b12fdb1aec476c1b05eee2e33817d3636f76927d4cdc5700347344b687e28d
-  data.tar.gz: 83411b72925dbe120a4c89fa1d715f3fe61a7596ed4d356f03b537ea6bb31481
+  metadata.gz: 2311f814efc977b70f6a1e4541e4e7a2daf627a900397a08d1868eaedbd17ba8
+  data.tar.gz: be52f7301fcdd6f8ab377209dc50d587bbf9bfcbd7f7cc461fba702c59a1620f
 SHA512:
-  metadata.gz: 3557bcc2a93f0775a294b0c2d1c784949e84602155de21d3d3db89237ae7e50bbf3ba591bdc329ca6074ae27178444c6c939cd42ac361dcb5a9d50a9de4e8567
-  data.tar.gz: 78ebf53316d6bebf24bb04832a5b052512d46df48f9f71cc3f388305c6210cd0ec32b2f1ba9151cd80d8199a26142c8684775f93198d7d9b61bf1291d1d39732
+  metadata.gz: 8c1a078a7e1a78d8616fd6f0ff3dfdf52a635a756f62eb897d8a14da59ba14162a9c83e4f0384ea5ad240efaf649b3f55812b345a9a334ca9de713730d6e1c0f
+  data.tar.gz: f8d4cd3489a73d5ea9fe29f57b4687cecaf60ed3440334c2b85e726ac18621036968f8141e5dc0fe91ef2995000cf77ccf7025d3667a27c6b77c83b704690b61

data/CHANGELOG.md

@@ -1,13 +1,34 @@
-Version 0.9.2
+Version 1.0.3
+------
+* Fix a bug which causes an error in the `populate` and `generate` commands when prompting for the shop name
+
+Version 1.0.2
+------
+* Fix missing shop parameter to AdminAPI.query() call (impacting populate and generate commands)
+
+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
+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
+Version 0.9.0 - Internal Test Version
 ------
 * Initial test release of gem-based CLI

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,75 @@
+---
+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
+```
+
+### To check that Shopify App CLI is installed correctly:
+
+```console
+$ shopify version
+1.0.0
+$
+```
+
+> Note 1: the version displayed may be newer.
+
+> Note 2: If you have the `shopify_api` gem installed, you may see the following response:
+> ```console
+> shopify command is no longer bundled with shopify_api.
+> if you need these tools, install the shopify_cli gem
+> ```
+> 
+> If so, then you will also need to upgrade the `shopify_api` gem to v9.2.0+ to remove a deprecated `shopify` command that is contained in that gem.
+>
+> If you also have the `shopify_app` gem (which depends on `shopify_api` gem), you'll need to install or update `shopify_api` first, then uninstall the older version.
+> 
+> To get a list of the version(s) of `shopify_api` currently installed:
+> ```console
+> $ gem list shopify_api
+> ```
+> 
+> To install the latest version:
+> ```console
+> $ gem install shopify_api
+> ```
+> 
+> To uninstall the older version:
+> ```console
+> $ gem uninstall shopify_api -v x.y.z
+> ```
+> Replace x.y.z with a version number listed from the `gem list` command.  Repeat as needed.

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

@@ -0,0 +1,96 @@
+---
+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. Reload your terminal
+
+### 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.
+
+### 3. Reload your terminal
+
+For the changes above to take effect, exit your terminal, and start a new one.
+
+If you try running `shopify` now, you should get a `command not found` error.
+
+> If you have the `shopify_api` gem installed, you may see the following response:
+> ```console
+> shopify command is no longer bundled with shopify_api.
+> if you need these tools, install the shopify_cli gem
+> ```
+> 
+> If so, then you will also need to upgrade the `shopify_api` gem to v9.2.0+ to remove a deprecated `shopify` command that is contained in that gem.
+>
+> If you also have the `shopify_app` gem (which depends on `shopify_api` gem), you'll need to install or update `shopify_api` first, then uninstall the older version.
+> 
+> To get a list of the version(s) of `shopify_api` currently installed:
+> ```console
+> $ gem list shopify_api
+> ```
+> 
+> To install the latest version:
+> ```console
+> $ gem install shopify_api
+> ```
+> 
+> To uninstall the older version:
+> ```console
+> $ gem uninstall shopify_api -v x.y.z
+> ```
+> Replace x.y.z with a version number listed from the `gem list` command.  Repeat as needed.
+
+## 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

@@ -2,7 +2,7 @@
 
 module Extension
   class Project < ShopifyCli::ProjectType
-    hidden_project_type
+    hidden_feature
     creator 'App Extension', 'Extension::Commands::Create'
 
     register_command('Extension::Commands::Build', "build")
@@ -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