Is there a recommended way to migrate code that now lives in a library?

[gvolpe]

I have a Cache ability defined in this project that now lives in a separate library. Is there a recommended way of replacing the former with the library? The handler's type signature has changed, but the rest remains the same. Thanks!

NB: I read the docs here but couldn't find anything about it: https://www.unison-lang.org/docs/tooling/project-workflows/

[rlmark]

Hi @gvolpe, I've cloned your project and library locally and this is a bit of an unconventional workflow (you'd be one of the first to try it 🙏), but should get you most of the way there.

lib.install your cache library into your forex project:

@gvolpe/forex/main> lib.install @gvolpe cache

Then move your Cache type into the lib namespace with this structure:

@gvolpe/forex/main> move Cache lib.oldCache.Cache

Issue the upgrade command and then upgrade to the oldCache to your new version.

@gvolpe/forex/main> upgrade oldCache gvolpe_cache_0_0_1 

The upgrade will create a temporary branch for you to resolve the difference between the old version of your cache to the new version. There's no magic here, you'll have to resolve the remaining errors, but once you get the project typechecking, run update again and your code should be migrated to the new cache. Then you can delete the top-level Cache ability and namespace. The UCM won't let you delete it unless it's truly not used (if that is not the case, let us know.)

[gvolpe]

That worked wonderfully, thank you so much! 🥳

Then you can delete the top-level Cache ability and namespace. The UCM won't let you delete it unless it's truly not used (if that is not the case, let us know.)

FWIW this bit wasn't necessary. It looks like it was sorted with the previous steps 👍🏽