Add hint to use --replace flag when not explicitly replacing a release

[Pi-Cla]

Resolves gleam-lang/gleam#2271

[lpil]

We can't talk about the CLI here because this isn't the CLI. For example, if I were to make a web app using this library I wouldn't want it to talk about --replace in its JSON API or logs.

[Pi-Cla]

We can't talk about the CLI here because this isn't the CLI. For example, if I were to make a web app using this library I wouldn't want it to talk about --replace in its JSON API or logs.

Alright I will close this and open a different PR on the gleam cli. But first, what is the purpose of this line?

hexpm-rust/src/lib.rs

Line 453 in aa0ae05

if body.contains("--replace") {

At first glance this looks like something specific to gleam cli which would make me think it was alright to just directly modify the error message here instead of having to alter it at the gleam cli level.

[lpil]

The Hex API is unfortunately not very well designed. It was an implementation detail of Elixir's Mix build tool and as such makes references to Mix's CLI API in errors so the build tool can just print whatever is returned. It's also largely undocumented, to add to the fun.

This library deliberately hides away these issues to make it more suitable for third-party use. Note this is not a specifically Gleam CLI library. If it was it wouldn't be its own repo and package.