npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

@ampproject/toolbox-runtime-fetch

v2.10.1

Published

Download the AMP runtime

Downloads

534

Readme

AMP Download Runtime

npm version

The AMP Download Runtime tool fetches a complete, compiled AMP runtime and saves it to disk. You can use this tool to fetch AMP Project releases from cdn.ampproject.org or direct it to download an AMP runtime hosted elsewhere.

Special handling is included for amp-geo. For hosting environments that dynamically modify amp-geo.js when served, this tool restores the content to its unpatched state.

Installation

Install via:

npm install @ampproject/toolbox-runtime-fetch --save

Options

  • dest (required string): Specify the destination directory where the AMP runtime should be saved. The runtime will be downloaded to an RTV-specific path under dest.
  • clear (optional boolean): Remove all contents from the destination directory before saving the AMP runtime. Defaults to true.
  • rtv (optional string): Specify the runtime version to download. Defaults to the latest production version available.
  • ampUrlPrefix (optional string): Specify the URL where the AMP runtime is hosted. Defaults to https://cdn.ampproject.org.

Note: When downloading AMP Project releases, the runtime version (rtv) is obtained by prepending 01 (production) or 00 (canary) to the version. For example, the rtv for production release 2003101714470 is 012003101714470.

Usage

Basic usage:

const downloadRuntime = require('@ampproject/toolbox-runtime-fetch');

let result;

// Download the latest AMP Project release to /tmp/amp/rtv/<rtv>,
// where <rtv> is detected automatically
result = await downloadRuntime.getRuntime({
  dest: '/tmp/amp' // Windows filesystem paths are also supported
});

// Download a specific version of the AMP runtime from Bing
result = await downloadRuntime.getRuntime({
  dest: '/tmp/amp' // Windows filesystem paths are also supported
  rtv: '011912201827130',
  ampPrefixUrl: 'https://www.bing-amp.com'
});

/**
 * The object returned from getRuntime() includes the success or failure status,
 * as well as data about the AMP runtime that was downloaded:
 * {
 *   status: {boolean} Overall AMP runtime download status
 *   error: {string} Error message on failure
 *   count: {number} Number of files in the AMP runtime
 *   url: {string} URL to AMP runtime
 *   dest: {string} Path to directory where AMP runtime was downloaded
 *   rtv: {string} Runtime version of AMP runtime
 * }
 */