clasp

Develop Apps Script projects locally using clasp (Command Line Apps Script Projects).

$\"clasp\"$

To get started, try out the codelab!

Install

First download clasp:

npm i @google/clasp -g

Then enable Apps Script API: https://script.google.com/home/usersettings

Features

$\"world_map\"$ Develop Locally: clasp allows you to develop your Apps Script projects locally. That means you can check-in your code into source control, collaborate with other developers, and use your favorite tools to develop Apps Script.

$\"1234\"$ Manage Deployment Versions: Create, update, and view your multiple deployments of your project.

$\"file_folder\"$ Structure Code: clasp automatically converts your flat project on script.google.com into folders. For example:

On script.google.com:
- tests/slides.gs
- tests/sheets.gs
locally:
- tests/
  - slides.js
  - sheets.js

Commands

clasp

clasp login [--no-localhost]
clasp logout
clasp create [scriptTitle] [scriptParentId]
clasp clone <scriptId>
clasp pull
clasp push
clasp open
clasp deployments
clasp deploy [version] [description]
clasp redeploy <deploymentId> <version> <description>
clasp version [description]
clasp versions

How To...

Login/Logout

clasp login\nclasp logout\n

Run clasp login --no-localhost to manually enter a code instead of running a local server.

Create a New Apps Script Project

Files in the current directory are added to the project. Optinally provide a script title or parent G Suite doc ID.

clasp create [scriptTitle] [scriptParentId]\n

Clone an existing project in the current directory

clasp clone <scriptId>\n

Push/Pull

clasp push # Updates Apps Script project with local files\nclasp pull # Updates local files with Apps Script project\n

Update a Published Project / Deploy

To deploy a project:

Create an immutable version of the Apps Script project using clasp version
Deploy the version using clasp deploy [version]

clasp versions # List versions\nclasp version [description] # Create a new version with a description\n

then deploy...

clasp deploy [version] [description]\nclasp undeploy <deploymentId>\nclasp deployments # List all deployment IDs\n

Open the project on script.google.com

clasp open\n

Ignore Files

Create a file called .claspignore in the root directory of your Apps Script project. Add patterns as if it were a .gitignore, and they will be excluded from clasp push.

A sample .claspignore could look like:

**/**\n!build/Main.js\n!appsscript.json\n

This file ignores everything but the manifest and the bundle.

Note: the .claspignore file is parsed with Anymatch, making it match files differently from a typical .gitignore, especially with directories. To ignore a directory, use syntax like **/node_modules/**

Troubleshooting

The library requires Node version >= 4.7.4.

node -v # Check Node version\nsudo npm install n -g\nsudo n latest

Develop

The Apps Script CLI uses TypeScript to provide autocompletion and linting when developing. Use an IDE like Visual Studio Code for TypeScript autocompletion.

Setup

Install tsc: npm install -g typescript

After Making a Change

npm run build;\nclasp <command>

Submitting a Pull Request

Look over the test cases in test.sh, try cases that the PR may affect.
Run tslint: npm run lint.
Submit a pull request after testing and linting.

Publish

Build index.js locally. .gitignore/.npmignore will hide js/ts files appropriately.
Bump versions, then publish with: npm publish --access public

Powered by the Apps Script API.

BPMチャット