tape/tap transition guide

[timoxley]

Would make migrating from tape easier if AVA & tape shared the same API.

Below is the full list of tape apis that don't exist in AVA. Most of these would only require a simple alias e.g. Test.prototype.deepEqual = Test.prototype.same

Though it's possible there's benefit in divorcing the tape API entirely & just keeping the current, simpler API. For example, not sure if it was ever a good idea to support both deepEquals and deepEqual other than to encourage bikeshedding within a team about which one to use.

const TapeTest = require('tape/lib/test')
const AVATest = require('ava/lib/test')
Object.keys(TapeTest.prototype).filter(k => !Object.keys(AVATest.prototype).includes(k))

[ 'test',
  'comment',
  'timeoutAfter',
  '_end',
  '_exit',
  '_pendingAsserts',
  'skip',
  'notok',
  'iferror',
  'ifErr',
  'strictEquals',
  'strictEqual',
  'isEqual',
  'equals',
  'equal',
  'isInequal',
  'doesNotEqual',
  'isNot',
  'isNotEqual',
  'notStrictEquals',
  'notStrictEqual',
  'notEquals',
  'notEqual',
  'isEquivalent',
  'deepEquals',
  'deepEqual',
  'looseEquals',
  'looseEqual',
  'deepLooseEqual',
  'isInequivalent',
  'isNotEquivalent',
  'isNotDeeply',
  'isNotDeepEqual',
  'notDeeply',
  'notEquivalent',
  'notDeepEqual',
  'notLooseEquals',
  'notLooseEqual',
  'notDeepLooseEqual' ]

Related to #96

[sindresorhus]

I looked into this a while ago. The problem is that tape already have aliases for equal AVA methods, but with different behavior. Mainly, we have t.same which means deep strict equal, tape's t.same means deep non-strict equal. We have t.true which means val === true, while the tape version is just an alias for t.ok which is !!val.

[timoxley]

@sindresorhus ahh understood, this makes sense. Can close.

[sindresorhus]

I'll keep it open as I want to do a transition guide, maybe even an automated script (that would be cool!).

[nvartolomei]

Those could be written as codemods btw https://github.com/facebook/jscodeshift

[sindresorhus]

@nvartolomei Yup, that would be rad. I've been thinking about this for a while.

Opened a separate issue → #644.

[novemberborn]

Also see discussion in #445.