Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Consider using human/natural sort order #143

Open
tanriol opened this issue Aug 27, 2019 · 7 comments
Open

Consider using human/natural sort order #143

tanriol opened this issue Aug 27, 2019 · 7 comments

Comments

@tanriol
Copy link

tanriol commented Aug 27, 2019

Names used in libraries quite often contain numbers. In general, a sequence of digits in a name seems to be usually a number, not just a sequence of digits. However, rustfmt's sort order does not take that into account. For example, if I import several nom parsers for various integers, rustfmt suggests the following order

use nom::number::complete::{le_u128, le_u16, le_u32, le_u64, le_u8};

which feels really weird compared to

use nom::number::complete::{le_u8, le_u16, le_u32, le_u64, le_u128};

It would be great if the rustfmt sort order matched the natural expectations.

@tanriol tanriol changed the title consider using human/natural sort order Consider using human/natural sort order Aug 27, 2019
@joshtriplett
Copy link
Member

Agreed. We should use the versionsort/strverscmp algorithm, documented at https://www.gnu.org/software/libc/manual/html_node/String_002fArray-Comparison.html .

@tanriol
Copy link
Author

tanriol commented Aug 28, 2019

Hm. Looking at the linked documentation

Digits are determined by the isdigit function and are thus subject to the current locale.

is my expectation correct that rustfmt should not rely on the environment locale and should sort according to some default?

Also, what's the process here? Is anything needed before implementation and rustfmt PR?

@strega-nil
Copy link

@tanriol it's likely that as an MVP, we should just do strverscmp in the C locale (i.e., 0-9 are digits and are read from left to right, big end to small end)

@tanriol
Copy link
Author

tanriol commented Aug 28, 2019

Would it be better to depend on some crate providing natural/version sort or to write an internal function for that?

@joshtriplett
Copy link
Member

@tanriol I meant that as a general description of the algorithm. I would expect us to use 0-9 here for now, and I think we can implement the algorithm ourselves in Rust unless there's a crate handy that you already know of.

@tanriol
Copy link
Author

tanriol commented Aug 29, 2019

Working on a PR and testing it, I'm seeing contradictions between actual tests and comment in them. Which ones should I follow?

@tanriol
Copy link
Author

tanriol commented Aug 29, 2019

The PR is up as rust-lang/rustfmt#3764.

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

No branches or pull requests

3 participants