domains / families / software-engineering / kotlin-tooling-immutable-collections-0-5-x-migration

kotlin-tooling-immutable-collections-0-5-x-migration

separate

Migrate Kotlin (and Java) code from kotlinx.collections.immutable 0.3.x / 0.4.x to the latest 0.5.x. The 0.5.x line renames every copy-returning method on PersistentList / PersistentMap / PersistentSet / PersistentCollection to a participial form per KEEP-0459 (add→adding, removeAt→removingAt, set→replacingAt, put→putting, clear→cleared, …) and deprecates the old names (WARNING, with ReplaceWith). Driven by the compiler: bump the version, recompile, and apply the rename each deprecation warning names. Use when the user mentions kotlinx.collections.immutable 0.5.x, PersistentList migration, "Use adding() instead", KEEP-0459, or sees deprecation warnings from kotlinx.collections.immutable.

When to use

• kotlinx.collections.immutable 0.5.x migration
• PersistentList migration
• KEEP-0459 compliance
• Fixing deprecation warnings from kotlinx.collections.immutable
• Renaming copy-returning methods to participial forms

When not to use

• Migrating to 0.6.x or later
• Projects already on the latest 0.5.x
• Renaming methods on MutableList, MutableMap, or MutableSet
• Renaming methods on Builder types

Skill page

Source