diff --git a/docs/cli.html b/docs/cli.html index 392c64c39..ef0354646 100644 --- a/docs/cli.html +++ b/docs/cli.html @@ -256,6 +256,7 @@
  • logs
  • migrate
  • promote
  • +
  • pull
  • push
  • register
  • scaffold
  • @@ -1017,6 +1018,32 @@

    promote

    +
    +
    +

    pull

    +
    +
    + +
    +
    +
    +
    +
    +
    +

    Retrieve and update your local integration files with the latest version.

    +

    Usage: zapier pull

    This command updates your local integration files with the latest version. You will be prompted with a confirmation dialog before continuing if there any destructive file changes.

    Zapier may release new versions of your integration with bug fixes or new features. In the event this occurs, you will be unable to do the following until your local files are updated by running zapier pull:

      +
    • push to the promoted version
    • +
    • promote a new version
    • +
    • migrate users from one version to another
    • +

    Flags

      +
    • -d, --debug | Show extra debugging output.
    • +
    +
    +
    + +
    +
    +

    push

    diff --git a/docs/cli.md b/docs/cli.md index 10a9de7b8..7baebca81 100644 --- a/docs/cli.md +++ b/docs/cli.md @@ -553,6 +553,24 @@ Check `zapier jobs` to track the status of the promotion. Or use `zapier history * `zapier promote 1.0.0` +## pull + +> Retrieve and update your local integration files with the latest version. + +**Usage**: `zapier pull` + +This command updates your local integration files with the latest version. You will be prompted with a confirmation dialog before continuing if there any destructive file changes. + +Zapier may release new versions of your integration with bug fixes or new features. In the event this occurs, you will be unable to do the following until your local files are updated by running `zapier pull`: + +* push to the promoted version +* promote a new version +* migrate users from one version to another + +**Flags** +* `-d, --debug` | Show extra debugging output. + + ## push > Build and upload the current integration. diff --git a/docs/index.html b/docs/index.html index 2a4afb8b6..7de4b9b2f 100644 --- a/docs/index.html +++ b/docs/index.html @@ -249,6 +249,7 @@
  • Private App Version (default)
  • Sharing an App Version
  • Promoting an App Version
  • +
  • Pulling Latest Version from Zapier
  • Converting an Existing App
  • @@ -474,6 +475,7 @@

    Table of Contents

  • Private App Version (default)
  • Sharing an App Version
  • Promoting an App Version
  • +
  • Pulling Latest Version from Zapier
  • Converting an Existing App
  • @@ -1058,6 +1060,7 @@

    Deploying an App Version

  • zapier deprecate 1.0.0 2020-06-01 - mark a version as deprecated, but let users continue to use it (we'll email them)
  • zapier env:set 1.0.0 KEY=VALUE - set an environment variable to some value
  • zapier delete:version 1.0.0 - delete a version entirely. This is mostly for clearing out old test apps you used personally. It will fail if there are any users. You probably want deprecate instead.
  • +
  • zapier pull - pull the latest version from Zapier server. This is used in the event that Zapier made an update since your last version.
  • Note: To see the changes that were just pushed reflected in the browser, you have to manually refresh the browser each time you push.

    @@ -1143,6 +1146,24 @@

    Promoting an App Version

    +
    +
    +

    Pulling Latest Version from Zapier

    +
    +
    + +
    +
    +
    +
    +
    +

    Zapier may fix bugs or add new features to your integration and release a new version. If you attempt to use zapier push and we've released a newer version, you will be prevented from pushing until you run zapier pull to update your local files with the latest version.

    Any destructive file changes will prompt you with a confirmation dialog before continuing.

    +
    +
    + +
    +
    +

    Converting an Existing App

    diff --git a/packages/cli/README-source.md b/packages/cli/README-source.md index fed94c8c0..84d573854 100644 --- a/packages/cli/README-source.md +++ b/packages/cli/README-source.md @@ -245,6 +245,7 @@ If you'd like to manage your **Version**, use these commands: * `zapier deprecate 1.0.0 2020-06-01` - mark a version as deprecated, but let users continue to use it (we'll email them) * `zapier env:set 1.0.0 KEY=VALUE` - set an environment variable to some value * `zapier delete:version 1.0.0` - delete a version entirely. This is mostly for clearing out old test apps you used personally. It will fail if there are any users. You probably want `deprecate` instead. +* `zapier pull` - pull the latest version from Zapier server. This is used in the event that Zapier made an update since your last version. > Note: To see the changes that were just pushed reflected in the browser, you have to manually refresh the browser each time you push. @@ -285,6 +286,12 @@ zapier migrate 1.0.0 1.0.1 zapier deprecate 1.0.0 2020-06-01 ``` +### Pulling Latest Version from Zapier + +Zapier may fix bugs or add new features to your integration and release a new version. If you attempt to use `zapier push` and we've released a newer version, you will be prevented from pushing until you run `zapier pull` to update your local files with the latest version. + +Any destructive file changes will prompt you with a confirmation dialog before continuing. + ## Converting an Existing App If you have an existing Zapier [legacy Web Builder app](https://platform.zapier.com/conversion/maintaining), you can use it as a template to kickstart your local application. diff --git a/packages/cli/README.md b/packages/cli/README.md index af595c8db..a07d1f9d4 100644 --- a/packages/cli/README.md +++ b/packages/cli/README.md @@ -47,6 +47,7 @@ This doc describes the latest CLI version (**15.17.0**), as of this writing. If * [Private App Version (default)](#private-app-version-default) * [Sharing an App Version](#sharing-an-app-version) * [Promoting an App Version](#promoting-an-app-version) + * [Pulling Latest Version from Zapier](#pulling-latest-version-from-zapier) - [Converting an Existing App](#converting-an-existing-app) - [Authentication](#authentication) * [Basic](#basic) @@ -399,6 +400,7 @@ If you'd like to manage your **Version**, use these commands: * `zapier deprecate 1.0.0 2020-06-01` - mark a version as deprecated, but let users continue to use it (we'll email them) * `zapier env:set 1.0.0 KEY=VALUE` - set an environment variable to some value * `zapier delete:version 1.0.0` - delete a version entirely. This is mostly for clearing out old test apps you used personally. It will fail if there are any users. You probably want `deprecate` instead. +* `zapier pull` - pull the latest version from Zapier server. This is used in the event that Zapier made an update since your last version. > Note: To see the changes that were just pushed reflected in the browser, you have to manually refresh the browser each time you push. @@ -439,6 +441,12 @@ zapier migrate 1.0.0 1.0.1 zapier deprecate 1.0.0 2020-06-01 ``` +### Pulling Latest Version from Zapier + +Zapier may fix bugs or add new features to your integration and release a new version. If you attempt to use `zapier push` and we've released a newer version, you will be prevented from pushing until you run `zapier pull` to update your local files with the latest version. + +Any destructive file changes will prompt you with a confirmation dialog before continuing. + ## Converting an Existing App If you have an existing Zapier [legacy Web Builder app](https://platform.zapier.com/conversion/maintaining), you can use it as a template to kickstart your local application. diff --git a/packages/cli/docs/cli.html b/packages/cli/docs/cli.html index 392c64c39..ef0354646 100644 --- a/packages/cli/docs/cli.html +++ b/packages/cli/docs/cli.html @@ -256,6 +256,7 @@
  • logs
  • migrate
  • promote
  • +
  • pull
  • push
  • register
  • scaffold
  • @@ -1017,6 +1018,32 @@

    promote

    +
    +
    +

    pull

    +
    +
    + +
    +
    +
    +
    +
    +
    +

    Retrieve and update your local integration files with the latest version.

    +

    Usage: zapier pull

    This command updates your local integration files with the latest version. You will be prompted with a confirmation dialog before continuing if there any destructive file changes.

    Zapier may release new versions of your integration with bug fixes or new features. In the event this occurs, you will be unable to do the following until your local files are updated by running zapier pull:

      +
    • push to the promoted version
    • +
    • promote a new version
    • +
    • migrate users from one version to another
    • +

    Flags

      +
    • -d, --debug | Show extra debugging output.
    • +
    +
    +
    + +
    +
    +

    push

    diff --git a/packages/cli/docs/cli.md b/packages/cli/docs/cli.md index 10a9de7b8..7baebca81 100644 --- a/packages/cli/docs/cli.md +++ b/packages/cli/docs/cli.md @@ -553,6 +553,24 @@ Check `zapier jobs` to track the status of the promotion. Or use `zapier history * `zapier promote 1.0.0` +## pull + +> Retrieve and update your local integration files with the latest version. + +**Usage**: `zapier pull` + +This command updates your local integration files with the latest version. You will be prompted with a confirmation dialog before continuing if there any destructive file changes. + +Zapier may release new versions of your integration with bug fixes or new features. In the event this occurs, you will be unable to do the following until your local files are updated by running `zapier pull`: + +* push to the promoted version +* promote a new version +* migrate users from one version to another + +**Flags** +* `-d, --debug` | Show extra debugging output. + + ## push > Build and upload the current integration. diff --git a/packages/cli/docs/index.html b/packages/cli/docs/index.html index 2a4afb8b6..7de4b9b2f 100644 --- a/packages/cli/docs/index.html +++ b/packages/cli/docs/index.html @@ -249,6 +249,7 @@
  • Private App Version (default)
  • Sharing an App Version
  • Promoting an App Version
  • +
  • Pulling Latest Version from Zapier
  • Converting an Existing App
  • @@ -474,6 +475,7 @@

    Table of Contents

  • Private App Version (default)
  • Sharing an App Version
  • Promoting an App Version
  • +
  • Pulling Latest Version from Zapier
  • Converting an Existing App
  • @@ -1058,6 +1060,7 @@

    Deploying an App Version

  • zapier deprecate 1.0.0 2020-06-01 - mark a version as deprecated, but let users continue to use it (we'll email them)
  • zapier env:set 1.0.0 KEY=VALUE - set an environment variable to some value
  • zapier delete:version 1.0.0 - delete a version entirely. This is mostly for clearing out old test apps you used personally. It will fail if there are any users. You probably want deprecate instead.
  • +
  • zapier pull - pull the latest version from Zapier server. This is used in the event that Zapier made an update since your last version.
  • Note: To see the changes that were just pushed reflected in the browser, you have to manually refresh the browser each time you push.

    @@ -1143,6 +1146,24 @@

    Promoting an App Version

    +
    +
    +

    Pulling Latest Version from Zapier

    +
    +
    + +
    +
    +
    +
    +
    +

    Zapier may fix bugs or add new features to your integration and release a new version. If you attempt to use zapier push and we've released a newer version, you will be prevented from pushing until you run zapier pull to update your local files with the latest version.

    Any destructive file changes will prompt you with a confirmation dialog before continuing.

    +
    +
    + +
    +
    +

    Converting an Existing App

    diff --git a/packages/cli/src/oclif/commands/pull.js b/packages/cli/src/oclif/commands/pull.js index 869c98c71..2352d85da 100644 --- a/packages/cli/src/oclif/commands/pull.js +++ b/packages/cli/src/oclif/commands/pull.js @@ -45,8 +45,16 @@ class PullCommand extends ZapierBaseCommand { } PullCommand.flags = buildFlags(); -PullCommand.description = - 'Pull the source code of the latest version of your integration from Zapier, overwriting your local integration files.'; +PullCommand.description = `Retrieve and update your local integration files with the latest version. + +This command updates your local integration files with the latest version. You will be prompted with a confirmation dialog before continuing if there any destructive file changes. + +Zapier may release new versions of your integration with bug fixes or new features. In the event this occurs, you will be unable to do the following until your local files are updated by running \`zapier pull\`: + +* push to the promoted version +* promote a new version +* migrate users from one version to another`; + PullCommand.skipValidInstallCheck = true; module.exports = PullCommand; diff --git a/packages/cli/src/oclif/oCommands.js b/packages/cli/src/oclif/oCommands.js index 7ae5804f2..c04888a77 100644 --- a/packages/cli/src/oclif/oCommands.js +++ b/packages/cli/src/oclif/oCommands.js @@ -31,6 +31,7 @@ module.exports = { logout: require('./commands/logout'), migrate: require('./commands/migrate'), promote: require('./commands/promote'), + pull: require('./commands/pull'), push: require('./commands/push'), scaffold: require('./commands/scaffold'), register: require('./commands/register'),