melos icon indicating copy to clipboard operation
melos copied to clipboard

`melos bootstrap` should consider `path` when comparing two `GitReference`s

Open mateusfccp opened this issue 1 year ago • 6 comments

Is there an existing issue for this?

  • [X] I have searched the existing issues.

Version

4.1.0

Description

The _updateDependencies method in the bootstrap command checks if two DependencyReferences are equal to decide if it should update the dependencies of the modules:

https://github.com/invertase/melos/blob/ed826b39761039ba545d3ae7b18f491726d7ebe1/packages/melos/lib/src/commands/bootstrap.dart#L335C1-L362C1

However, the GitReference equals operator considers only the url and ref fields. As a consequence, if you change the path without changing the url or the ref in melos.yaml, the references are not going to be updated in the modules.

I actually lost some hours of work trying to understand why my references were not being updated.

Running melos clean before the bootstrap does not solves the problem.

Thus, Melos should consider the path field when the DependencyReference is a GitReference.

Steps to reproduce

In any Melos project that has at least one git dependency on melos.yaml:

  1. Run melos bootstrap
  2. Change the reference path to something else
  3. Run melos bootstrap again

Expected behavior

The modules references should be updated accordingly to the new path.

Screenshots

No response

Additional context and comments

Workaround: currently, you can workaround this by changing either the url or the ref to something different (it may not exist), run melos bootstrap, revert the changes and run melos bootstrap again.

mateusfccp avatar Mar 12 '24 19:03 mateusfccp

Good catch! Do you want to provide a PR for this?

spydon avatar Mar 12 '24 20:03 spydon

I may open a PR fixing it tomorrow.

If https://github.com/j4qfrost/pubspec/issues/9 is ever solved we may want to revert the code, but the repository seems to be abandoned (there are some open PRs that were never reviewed).

Maybe we should consider forking it or using pubspec2?

mateusfccp avatar Mar 12 '24 22:03 mateusfccp

Maybe we should consider forking it or using pubspec2?

We could ask the author if they would be willing to transfer the repository and the package to one of our pub publishers first, I can do that tomorrow.

spydon avatar Mar 12 '24 22:03 spydon

Maybe it is better to move to pubspec2, since it seems quite well maintained. Could you open an issue/PR there and see if we could get that change in? If so we could start depending on that instead.

spydon avatar Mar 13 '24 08:03 spydon

pubspec2 repository has no issues enabled. I'm going to try to contact @bsutton or @onepub-dev.

mateusfccp avatar Mar 13 '24 10:03 mateusfccp

I've reached out to @bsutton and he said that he's working on a pubspec_manager, a package to supersede both pubspec and pubspec2.

Using pubspec_manager would require much more changes, as the API is completely different, and I don't know what are the plans of the Melos team. Thus, for now, I am going to provide a PR to fix this issue while still using pubspec and open another issue regarding the replacement of pubspec, as it has been abandoned.

mateusfccp avatar Mar 13 '24 17:03 mateusfccp