0.3.2 • Public • Published

    ava-codemods Build Status

    Translations: Français

    Codemods for AVA that simplifies upgrading to newer versions and migrating to AVA

    Codemods are small programs that help you automate changes to your codebase. Think of them as search and replace on steroids.

    This module contains a set of codemods that enable you to upgrade your code between various AVA releases and migrate from existing test runners to AVA. It is maintained by the AVA team, and will be updated anytime we introduce breaking API changes.


    $ npm install --global ava-codemods

    This installs two binaries ava-codemods and tape-to-ava.

    Migrating to AVA

    Currently we support migrating from tape to AVA.

    $ tape-to-ava --help
          $ tape-to-ava <path> [options]
        path	Files or directory to transform. Can be a glob like src/**.test.js
          --force, -f	Bypass Git safety checks and forcibly run codemods
          --dry, -d		Dry run (no changes are made to files)
          --parser		The parser to use for parsing your source files (babel | babylon | flow)  [babel]

    To transform all test files in a directory run tape-to-ava mySrcFolder in your terminal. Only files requiring or importing tape will be transformed. Notice the console output for errors, manual intervention might be required.

    As we cannot statically determine if your sequential tape tests are able to run in parallel, all tests are transformed into test.serial. To speed up the AVA test execution you can remove .serial where applicable.

    Upgrade AVA version

    $ ava-codemods --help
        $ ava-codemods [<file|glob> ...]
        --force, -f    Bypass safety checks and forcibly run codemods
      Available upgrades
        - 0.16.x → 0.17.x
        - 0.13.x → 0.14.x

    Simply run ava-codemods in your terminal and answer a few questions. You can pass a filename directly to the CLI. If you do not, you will be prompted for one.

    Ensure you have a backup of your tests or commit the latest changes before running this.

    Supported codemods

    Upgrading to 0.17.x

    • Renaming t.error() to t.ifError()

    Upgrading to 0.14.x

    • Renaming t.ok() to t.truthy()
    • Renaming t.notOk() to t.falsy()
    • Renaming t.same() to t.deepEqual()
    • Renaming t.notSame() to t.notDeepEqual()


    MIT © James Talmage


    npm i ava-codemods

    DownloadsWeekly Downloads






    Last publish


    • vdemedes
    • novemberborn
    • sindresorhus