Skip to content

chore: Rename Component::name_in_manifest and short_name_in_manifest method to name and short_name#4778

Open
Cloud0310 wants to merge 1 commit intorust-lang:mainfrom
Cloud0310:rename-method
Open

chore: Rename Component::name_in_manifest and short_name_in_manifest method to name and short_name#4778
Cloud0310 wants to merge 1 commit intorust-lang:mainfrom
Cloud0310:rename-method

Conversation

@Cloud0310
Copy link

@Cloud0310 Cloud0310 commented Mar 26, 2026

These function on Component is not related to Manifest, so renaming them to distinguish against Manifest::name() and Manifest::short_name().

Founded this problem when I was dealing with #4768. By naming, two functions looks like should be the same, but they're actually different things.

ref: src/dist/manifest.rs#L55-L62 src/dist/manifest.rs#L55-L62

…t_name` accordingly

In `Component`, these methods are not related to the final name
associated with manifest.
On the `Manifest` side, it have `name` and `short_name` for get the
re-mapped component names.
So, I think renaming these func names in Component helps clarify the the
code.
@Cloud0310 Cloud0310 changed the title refactor: Rename Component::name_in_manifest and short_name_in_manifest method to name and short_name chore: Rename Component::name_in_manifest and short_name_in_manifest method to name and short_name Mar 26, 2026
Copy link
Contributor

@djc djc left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Makes sense to me, thanks!

View changes since this review

Copy link
Member

@rami3l rami3l left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

}

pub fn short_name_in_manifest(&self) -> &String {
pub fn short_name(&self) -> &String {
Copy link
Member

@rami3l rami3l Mar 26, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Nit: Kind of pre-existing, but I'd argue that to make this even less of a confusion going forward, it'd be cool to add doc comments to explicitly compare the Component:: and Manifest:: functions in question. It can be really simple.

How about something like the following in the impl Manifest block (not sure about the syntax, but the overall idea should be clear):

/// Returns the [`Component`]'s short name (not including the target) before renaming.
/// For the name after renaming, see [`Component::short_name()`].
/// Returns the [`Component`]'s name (including the target) before renaming.
/// For the name after renaming, see [`Component::name()`].

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants