Code Monkey home page Code Monkey logo

parcel-optimizer-gas's Introduction

parcel-optimizer-gas

Version License: MIT Twitter: VladoDev

๐ŸŒ€ Parcel plugin that enables Google App Script bundling.

This is the plugin for Parcel v2. The plugin for the first version can be found here.

๐Ÿ“ฆ Installation

# Installs the plugin and saves it as a development dependency
npm i parcel-optimizer-gas -D

๐Ÿ”Œ Configuration

We need to create .parcelrc configuration file and add the plugin to optimizers like this:

Syntax "..." instructs Parcel to apply the plugin on top of existing JS optimizations

{
  "extends": "@parcel/config-default",
  "optimizers": {
    "*.js": ["...", "parcel-optimizer-gas"]
  }
}

โ˜๏ธ Usage

This plugin modifies the Parcel bundle to be Google App Script compatible. Parcel uses process called uglifying when generating your production build. Uglifying is the process of converting long function/variable names into shorter versions i.e. onInstall becomes j. This is a problem since Google's runtime expects explicit onInstall method to be available in global scope. This applies to other methods as well. That's why default Parcel bundle doesn't work on Google's runtime environment.

By attaching methods to the globalThis in source code, you prevent uglifying and with a bit of the plugin's magic your code works on Google's runtime environment.

๐Ÿ  Single file

index.js

// Runs when user installs extension
globalThis.onInstall = e => {
  onOpen();
};

// Runs as soon as user opens a document
globalThis.onOpen = e => {
  DocumentApp.getUi() // Or SlidesApp or FormApp.
    .createMenu('My Add-on')
    .addItem('Open', 'showSidebar')
    .addToUi();
};

๐Ÿ’ซ Multiple files

Google App Script runtime environment differs from normal JS environment that you are used to in your Browser or Node.js. There are simply no modules. Everything is loaded in one global scope/namespace.

index.js

require('./my-module');

// Runs when user installs extension
globalThis.onInstall = e => {
  customFunction();
};

my-module.js

globalThis.customFunction = () => {
  console.log('Hello from Google App Script!');
};

๐Ÿš€ Build

parcel build index.js -> produces bundle which you can manually upload to your Google App Script project or push it from CLI with clasp.

๐Ÿ‘จ Author

Vladimir Mikulic

๐Ÿค Contributing

Contributions, issues and feature requests are welcome!

๐Ÿ“ License

This project is licensed under MIT license.

๐Ÿ‘จโ€๐Ÿš€ Show your support

Give a โญ๏ธ if this project helped you!

parcel-optimizer-gas's People

Contributors

marcomow avatar vladimirmikulic avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.