UNPKG

@google/clasp

Version:

Develop Apps Script Projects locally

56 lines (44 loc) 2.43 kB
# Clasp configuration files A Clasp project uses the following configuration files: File | Default | Description --- | --- | --- Clasp project file | `./.clasp.json` | Specifies which Apps Script project to interact with (and how) Clasp ignore file | `.claspignore` in the same directory as the Clasp project file | Specifies files are ignored by `push` and `watch` commands Google Auth file | `~/.clasprc.json` (global) or `.clasprc.json` in the same directory as the Clasp project file (local) | OAuth 2.0 authentication and authorization to access Google APIs. Authentication is global by default. Apps Script project manifest | `<rootDir>/appsscript.json` | Specifies basic project information (cf. [Manifests](https://developers.google.com/apps-script/concepts/manifests)) Typescript configuration file | `<rootDir>/tsconfig.json` | Used for user specific compiling options (limited support.) ## Environment variables Environment variables can be set in order to specify the location of the following configuration files: File | Environment variable | Comment --- | --- | --- Clasp project file | `clasp_config_project` | The filename must start with a dot '.' Clasp ignore file | `clasp_config_ignore` | Google Auth file | `clasp_config_auth` | The filename must start with a dot '.' ## Command line options Command line options can be used in order to specify the location of the following configuration files: File | Environment variable | Comment --- | --- | --- Clasp project file | `-P <path>` or `--project <path>` | The filename must start with a dot '.' Clasp ignore file | `-I <path>` or `--ignore <path>` | Google Auth file | `-A <path>` or `--auth <path>` | The filename must start with a dot '.' > Note: command line options have precedence over environment variables ## Usage of configuration files per command Command | Project file | ignore file | Auth file | Manifest file --- | --- | --- | --- | --- login | | | Write (`--creds` option) | logout | | | Delete | create | Write | | Read | Write clone | Write | | Read | Write pull | Read | | Read | Write push | Read | Read | Read | Read status | Read | Read | | Read open | Read | | Read | ??? deployments | Read | | Read | ??? deploy | Read | | Read | Read undeploy | Read | | Read | ??? version | Read | | Read | ??? versions | Read | | Read | ??? list | | | Read | logs | ??? | | Read | ??? run | Read | | Read | ??? apis | ??? | | Read | ???