[![Commitizen friendly](https://img.shields.io/badge/commitizen-friendly-brightgreen.svg)](http://commitizen.github.io/cz-cli/)

Overview

Features

• Combines the most popular and effective development tools

  🤖 Use Babel to write and compile modern Javascript to Google Apps Script's ECMA spec.

  💬 Leverage ESLint to catch syntax errors and future bugs before deployment.

  ☕️ Use Mocha to follow Test-Driven-Development practices.

  • Webpack combines transpiling, minification, linting, and bundling into a single process.

Construct a Development Environment :construction_worker:

1. Run command to init a project:

   • npm: npm init gas-project [destination] [options]
   • yarn: yarn create gas-project [destination] [options] Note - If destination default is the current working directory

2. Answer the prompts and configure your development workspace.
3. Install dependencies using preferred package manager

Project Directory, Hard Defaults

The output directory will have the following structure:

  [target]/
    - .babelrc
    - .editorconfig
    - .eslintrc
    - .eslintignore
    - .gitignore
    - webpack.config.js
    + config/
     - appsscript.json
     - .clasp.json
       [ ... ]
    + dist/

    + src/
      - index.js
      - main.js

Detailed Usage Information

Arguments & Options 🏁

Arguments

| Name | Required | Default Value | Description | | -------- | --------- | ------------------------- | --------------------------------------------------------------------------------------------------------------------------------------- | | target | No | Current working directory | Directory. Relative paths are resolved from the current working directory. Will create non-existent directory (but not recursively). |

CLI Prompt & Package.json Field Default Values

Default Responses : How .npmrc and .yarnrc values are resolved

This program uses the 'rc' package internally to locate and utilize .npmrc / .yarnrc files/content at run time.

--

📑

Detailed File Creation Information

Package.json

devDependencies

A series of prompts regarding field values for the generated package.json file follow.

Aside from these fields, the package file contains a number of predefined properties within devDependencies. The majority of these modules are webpack loaders/plugins, eslint configurations/plugins, babel plugins, or @types/* definitions.

Detail of the provided dependencies, their version, and a brief explanation of their necessity is provided in the table below.

| devDependency package | Version | Purpose | | -------------------------------------------------- | -------------- | -------------- | | @babel/core | ^7.1.5 | Coming Soon | | @babel/plugin-proposal-class-properties | ^7.1.0 | Coming Soon | | @babel/plugin-proposal-object-rest-spread | ^7.0.0 | Coming Soon | | @babel/plugin-transform-member-expression-literals | ^7.0.0 | Coming Soon | | @babel/plugin-transform-object-assign | ^7.0.0 | Coming Soon | | @babel/plugin-transform-property-literals | ^7.0.0 | Coming Soon | | @babel/preset-env | ^7.1.5 | Coming Soon | | @google/clasp | ^1.6.3 | Coming Soon | | @types/google-apps-script | ^0.0.31 | Coming Soon | | babel-eslint | ^10.0.1 | Coming Soon | | babel-loader | ^8.0.4 | Coming Soon | | babel-plugin-add-module-exports | ^1.0.0 | Coming Soon | | babel-plugin-array-includes | ^2.0.3 | Coming Soon | | clean-webpack-plugin | ^0.1.19 | Coming Soon | | copy-webpack-plugin | ^4.6.0 | Coming Soon | | eslint | ^5.9.0 | Coming Soon | | eslint-loader | ^2.1.1 | Coming Soon | | eslint-plugin-googleappsscript | ^1.0.1 | Coming Soon | | gas-lib | ^2.0.2 | Coming Soon | | gas-webpack-plugin | ^0.3.0 | Coming Soon | | uglifyjs-webpack-plugin | ^2.0.1 | Coming Soon | | webpack | ^4.25.1 | Coming Soon | | webpack-cli | ^3.1.2 | Coming Soon |

Eslint

In order to provide an eslint configuration file for the environment, create-gas-project exposes a partial eslint configuration object, containing properties and values specific to the Apps Script environment & tooling.

-- Base ESlint Configuration Object --

   {
     "root" : true,
     "plugins": [
       "googleappsscript"
     ],
     "globals": {
       "Calendar": true,
       "CalendarApp": true,
       "CardService": true,
       "Charts": true,
       "ContactsApp": true,
       "DataStudioApp": true,
       "DocumentApp": true,
       "Drive": true,
       "DriveApp": true,
       "FirebaseApp": true,
       "FormApp": true,
       "Gmail": true,
       "GmailApp": true,
       "GroupsApp": true,
       "HtmlService": true,
       "LanguageApp": true,
       "MailApp": true,
       "Maps": true,
       "OAuth1": true,
       "OAuth2": true,
       "PropertiesService": true,
       "SitesApp": true,
       "Slides": true,
       "SlidesApp": true,
       "SpreadsheetApp": true
     },
     "env": {
       “googleappsscript/googleappsscript” : true
     },
     "parser": "babel-eslint",
     "parseroptions" : {
       "sourceType" : "module"
     }
   }

In order to provide a complete and valid configuration to eslint, create-gas-project then adds an extends property to the object and prompts the user to select a value from the following:

• 'eslint:recommended' (default)
• 'standard'
• 'airbnb-base'
• A file system path to another configuration file

Once confirmed to be valid, the resolved absolute path is then assigned as the value of the "``extends``" field for the project’s eslint configuration.

Project Eslint Configuration The following settings are required in the Apps Script project’s development directory eslint configuration to ensure all tooling works as expected:

CREATING NEW

Actions

If existing files, confirm modification