AMP-Toolbox CLI


The AMP Toolbox command line interface consists of a Node.js program called amp that can be run from a Windows, macOS, of UNIX-compatible command line environment. This way, AMP Toolbox can easily be integrated into a command line build process.

Supported commands:

- curls: generate AMP cache URL(s)
- download: download the AMP runtime
- help: lists all commands
- lint: checks document for errors
- optimize: runs AMP Optimizer for a given URL or file
- runtime-version: shows the current AMP runtime version [production]
- update-cache removes documents from the AMP Caches
- version: shows the current AMP Toolbox version

Installation

Install via:

``shell
$ npm install @ampproject/toolbox-cli -g
`

Commands

$3

Translate a URL to AMP Cache URLs:

`shell
$ amp curls https://amp.dev
`

$3

Download a complete AMP runtime:

`shell
$ amp download
`

Supports options for specifying a custom host, version, and destination directory. See amp help download for the complete list.

$3

Displays the help menu, listing all available commands:

`shell
$ amp help
`

Pass a command to get more information about this specific command

`shell
$ amp help [command]
`

Example:

`shell
$ amp help update-cache
`

$3

Runs the AMP Linter for the given URL:

`shell
$ amp lint https://amp.dev
`

$3

Runs AMP Optimizer for the given file or URL:

`shell
$ amp optimize https://amp.dev
`

or

`shell
$ amp optimize file.html
`

$3

Prints the current AMP version:

`shell
$ amp runtime-version
=> 011905291911450
`

Supports options for specifying a custom host or getting the canary version. See amp help runtime-version for the complete list.

$3

Uses the AMP update-cache API to update documents stored in AMP Caches.

It requires the public and private keys to be generated, as described on the documentation. Only the private key is required to generate the cache invalidation URLs, but the public key must be made available to the AMP Caches, as described in the guidelines.

By default, the application will look for the private key on a file called privateKey.pem, on the current working directory.

`shell
$ amp update-cache https://www.example.com/
`

Optionally, use the --privateKey parameter to specify the path for the private key.

`shell
$ amp update-cache https://www.example.com/ --privateKey /path/to/private-key.pem
`

$3

Prints the current AMP Toolbox version:
`shell
$ amp version

=> v2.7.6
``