npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

codemod-cli

v3.2.0

Published

a command line tool for generating, testing, and publishing codemods

Downloads

2,460

Readme

codemod-cli

codemod-cli is a command line tool for generating, testing, and publishing codemods.

Installation

npm install --global codemod-cli

# OR

yarn global add codemod-cli

Usage

The codemod-cli workflow is focused on managing a group of codemods.

To get started you first need a project. You can generate a new codemod-cli project via:

codemod-cli new <project-name>

This will create a small project structure (README.md, package.json, etc) which is ready to help you manage your codemods.

Once you have a project, you can generate a new codemod:

codemod-cli generate codemod <name of codemod> // jscodeshift js codemod
codemod-cli generate codemod <name of codemod> -t=hbs // ember-template-recast hbs codemod

This will setup a new codemod within your project at transforms/<name of codemod>/index.js along with a test harness, README, fixture directory, and an initial set of input/output fixtures.

Once you have tweaked your codemod and its fixtures to your liking, it is time to run your tests:

codemod-cli test

As you develop your codemod you may need additional fixtures (e.g. to test various combinations of inputs). To generate a new fixture, run the following:

codemod-cli generate fixture <name of codemod> <name of fixture>

This sets up two new files in transforms/<name of codemod>/__testfixtures__/ using the fixture name you provided. These fixtures are used by the testing harness to verify that your codemod is working properly.

Once you have things just how you like them with your new codemod (and your tests are passing :wink:) you can update your project's README and your transforms README via:

codemod-cli update-docs

File Types

By default the bin script that is generated for your codemod-cli project will run against .js and .ts files. If you'd like to change that (e.g. to run against .hbs or .jsx files) you can tweak your projects bin/cli.js script to add --extensions=hbs,jsx:

#!/usr/bin/env node
'use strict';

require('codemod-cli').runTransform(
  __dirname,
  process.argv[2],       /* transform name */,
  process.argv.slice(3), /* paths or globs */
  'hbs,jsx'
)

Debugging Workflow

Oftentimes, you want to debug the codemod or the transform to identify issues with the code or to understand how the transforms are working, or to troubleshoot why some tests are failing.

Hence we recommend a debugging work-flow like below to quickly find out what is causing the issue.

1. Place debugger statements

Add debugger statements, in appropriate places in the code. For example:

...
const params = a.value.params.map(p => {
  debugger;
  if(p.type === "SubExpression") {
    return transformNestedSubExpression(p)
...

2. Inspect the process with node debug

Here we are going to start the tests selectively in node debug mode. Since the codemod is bootstrapped using codemod-cli which is using jest in turn to run the tests, jest is having an option -t <name-of-spec> to run a particular set of tests instead of running the whole test suite.

We are making use of both these features to start our tests in this particular fashion. For more details on node debug, visit the official Node.js debugging guide, and for jest documentation on tests, here

node --inspect-brk ./node_modules/.bin/codemod-cli test -t '<fixture-name>'

For example, if you want to debug the null-subexp.input.hbs fixture or only that particular test case is failing because of an issue.

node --inspect-brk ./node_modules/.bin/codemod-cli test -t 'null-subexp'

Sometimes we need to use --runInBand flag for the debugger statements to be hit when focusing the test with jest

For example:

node --inspect-brk ./node_modules/.bin/jest --testNamePattern "ember-concurrency transforms correctly" --runInBand

Once you run the above command, your tests will start running in debug mode and your breakpoints will be triggered appropriately when that particular block of code gets executed. You can run the debugger inside Chrome browser dev-tools. More details on here

Contributing

Installation

Linting

  • yarn lint:js
  • yarn lint:js --fix

Running tests

  • yarn test

License

This project is licensed under the MIT License.