0.15.0 upgrade guide

[davidchambers]

Changes: v0.14.0...v0.15.1

Removals:

• ❌ R.isNaN remove functions deprecated in v0.14.0 #1112

Deprecations:

• 💾 R.arity deprecate R.arity #1111
• 💾 R.eq value-based equality #1096, Deprecate eq and deepEq #1190
• 💾 R.eqDeep value-based equality #1096, Deprecate eq and deepEq #1190
• 💾 R.filterIndexed Creates a common 'addIndex' function. Closes #484. #1061
• 💾 R.forEachIndexed Creates a common 'addIndex' function. Closes #484. #1061
• 💾 R.invoke deprecate R.invoke #1146
• 💾 R.mapIndexed Creates a common 'addIndex' function. Closes #484. #1061
• 💾 R.reduceIndexed Creates a common 'addIndex' function. Closes #484. #1061
• 💾 R.reduceRightIndexed Creates a common 'addIndex' function. Closes #484. #1061
• 💾 R.rejectIndexed Creates a common 'addIndex' function. Closes #484. #1061
• 💾 R.strIndexOf dispatch in R.indexOf and R.lastIndexOf #1113
• 💾 R.strLastIndexOf dispatch in R.indexOf and R.lastIndexOf #1113
• 💾 R.substring deprecate R.substring #1184
• 💾 R.substringFrom derive R.take and R.drop from R.slice #1159
• 💾 R.substringTo derive R.take and R.drop from R.slice #1159

Changes:

• all Ramda functions now accept any compliant placeholder, not just R.__ identify R.__ by special property rather than by identity #1156
• all Ramda functions except R.identical now use value-based equality value-based equality #1096
• R.chain is now a transducer R.chain transducer, closes #1033 #1101
• R.evolve is now recursive Make R.evolve recursive/deep #1141
• R.forEach now dispatches to forEach if available Dispatch forEach #1138
• R.identical (née R.eq) now handles new Number(0) correctly fix handling of new Number(0) in R.eq #1099
• R.identical (née R.eq) no longer always returns true when given NaN as its first argument fix bug causing R.eq(NaN, x) to evaluate true for every x #1100
• R.indexOf and R.lastIndexOf now dispatch to their respective methods if available dispatch in R.indexOf and R.lastIndexOf #1113
• ⚠️ R.invoker no longer accepts initial arguments Remove support for supplying initial arguments to R.invoker #1147
• R.pick now supports numbers as property names Add support to R.pick for numbers #1122
• ⚠️ R.propOr now returns the default value if the property is present but null/undefined Returning default value from propOr on nil object #1014
• R.take and R.drop can now operate on strings derive R.take and R.drop from R.slice #1159

Additions:

• 🆕 R.addIndex Creates a common 'addIndex' function. Closes #484. #1061
• 🆕 R.equals value-based equality #1096
• 🆕 R.identical value-based equality #1096
• 🆕 R.reduced expose "reduced" to public API #1118

[TheLudd]

Any reason eq and eqDeep were not deprecated?

[paldepind]

Any reason eq and eqDeep were not deprecated?

I don't think it was discussed. But upgrading will in most cases be as simple as replacing R.eq with R.equals.

[TheLudd]

But upgrading will in most cases be as simple as replacing R.eq with R.equals.

I'm sure it is.

But since ramda did decide to go on this deprecation track, I would appreciate a version 0.15.1 with these restored and deprecated. They could be removed in 0.16.0.

[CrossEye]

Yup, not sure how we missed that.

[davidchambers]

I just published v0.15.1. I'll update the original post to reflect these changes: v0.15.0...v0.15.1.

[TheLudd]

Thanks @davidchambers

[jethrolarson]

R.reduced 👍 🎉

[kwijibo]

Out of interest, why is reduceIndexed deprecated?

[CrossEye]

@kwijibo: All of the xxxIndexed functions are now handled by R.addIndex

    var reduceIndexed = R.addIndex(R.reduce)
    // or
    R.addIndex(R.reduce)((acc, val, i, list) => /* ... */, init, list);

See #1061

[kwijibo]

Ah thanks @CrossEye