googshift

library0.9.10jsnpmunverified

Googshift is a jscodeshift-based migration tool for converting Google Closure Compiler codebases (goog.require, goog.provide, goog.module) to ES6 modules. The current stable version is 0.9.10. It provides two main transforms: goog_provide_to_goog_module and goog_module_to_es6_module. This tool is essential for teams migrating legacy Closure Compiler projects to modern JavaScript module systems, offering a codemod approach that reduces manual effort compared to rewriting imports and exports by hand.

devops

npm install googshift

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · GOOGSHIFT

googshift

devopsjavascriptv0.9.10

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

default

✓ const jscodeshift = require('jscodeshift');

✗ import jscodeshift from 'jscodeshift';

jscodeshift is typically used via CLI, but when programmatic, use CommonJS require.

Shows programmatic use of googshift transforms with jscodeshift to convert goog.provide to goog.module.

const jscodeshift = require('jscodeshift'); const fs = require('fs'); const path = require('path'); // Read a transform file const transformContent = fs.readFileSync( path.join(__dirname, 'transforms/goog_provide_to_goog_module.js'), 'utf8' ); // Example: use transform on a source string const source = `goog.provide('my.Module');`; const output = jscodeshift(source, transformContent); console.log(output);

Debug

Known issues

gotchaTransforms may not handle all edge cases like aliased imports or complex namespaces.

fix

Review transformed output manually and fix any remaining references.

affects: all

gotchaRequires jscodeshift to be installed separately; it is a peer dependency.

fix

Run npm install jscodeshift as a dev dependency.

affects: all

Errors

Common errors & fixes

Cannot find module 'jscodeshift'

jscodeshift is not installed or not in node_modules.

fix

Install jscodeshift: npm install --save-dev jscodeshift

TypeError: Cannot read property 'find' of undefined

Transform function is not correctly exported or undefined.

fix

Ensure the transform file exports a function: module.exports = function(fileInfo, api) { ... }

Upgrade

Version history

0.9.10latest on npm

Audit

Dependencies

jscodeshiftrequiredCore dependency for running codemod transforms

Agent activity

4 hits · last 30 days

node

Resources

githubhttps://github.com/gberaudo/googshift ↗

packagegoogshift ↗

homepagehttps://github.com/gberaudo/googshift#readme ↗