0.3.0 • Published 4 years ago

modster v0.3.0

Weekly downloads
23
License
-
Repository
-
Last release
4 years ago

Modster

Codemod-ing, the easy way.

Modster is a plugin system and CLI for consuming and executing jscodeshift codemods, in a way that is not terrible.

In Modster, you pick your codemod from a list of codemods, answer a few questions to have it configured, choose a file or directory to run against - and off you go!

Easy? Yes, much. ✌️

Modster in action

Modster in full action

Installation

E.g. using yarn:

$ yarn install modster
$ yarn modster

Configuration

.codemods.js

Modster is configured via a configuration file, typically named .codemods.js. It is expected to export an object with the following fields:

FieldTypeRequiredDescription
packageManagerstringYour package manager; typically yarn or npm.
sourceDirectorystringThe directory on which you want codemods to operate. You can further limit the scope of a codemod when running Modster.
extensionsstring[]The file extensions you want to run codemods against. Passed to jscodeshift as the --ext option.
parserstringThe parser to use for parsig source files. One of babel \| babylon \| flow \| ts \| tsx. Passed to jscodeshift as the --parser option.
pluginsstring[]A list of Modster plugins, following the eslint-style plugin name convention. See below for a list of existing plugins and how to create your own plugins.
postUpdateTasksfunctionA function of the shape (updatedFiles: string[]) => { name: string; cmd: string }[], receiving the list of files modified by a codemod, and return a list of tasks to be executed. Every task has a name (e.g. prettier) and a command to be execute (e.g. yarn run prettier ...).

CLI options

Modster takes two optional CLI options, --config <path-to-file>, and --dry.

OptionDescription
--config <path-to-file>The path to Modster's configuration file, relative to process.cwd(). Defaults to ./codemods.
--dryIf set, runs jscodeshift in a dry run. Post-update tasks are printed but not executed.

Plugins

Modster uses a plugin system to consume codemods, similar to how e.g. eslint consumes linting rules. It is important to understand that Modser comes with no built-in codemod functionality; running Modster without plugins therefore doesn't make a huge amount of sense. But good news! - using and even writing Modster plugins is dead simple:

Existing plugins

To consume a Modster plugin, you simply install it as an npm package, e.g. using yarn:

yarn install modster-plugin-hello-world

... and add it to your .codemods.js, following the eslint-style plugin naming convention:

module.exports = {
    // ...
    plugins: [
        // ...
+      'hello-world'
    ]
}

See below for a list of Modster plugins:

PluginDescription
Hello WorldA minimal plugin example; mostly a reference for developing new plugins.

To add a plugin to this list, please raise a PR.

Developing plugins

See Developing Modster plugins.

Contributions

Yes please!