Skip to content

Fix issue with numeric character in group of options#19

Merged
bcoe merged 1 commit into
yargs:masterfrom
elas7:fix-group
Aug 7, 2016
Merged

Fix issue with numeric character in group of options#19
bcoe merged 1 commit into
yargs:masterfrom
elas7:fix-group

Conversation

@elas7

@elas7 elas7 commented Apr 3, 2016

Copy link
Copy Markdown
Member

When checking a group of options, if there is any number in the characters following the key being currently evaluated, then everything after the current key will be set as its value. This happens because the regex that checks for numbers is missing a ^ at the beginning, so strings like 'abc123' are considered numbers.

An issue caused by this is that, for example, calling -abc=123 results in {"_": [], "a": "bc=123"} instead of {"_": [], "a": true, "b": true, "c": 123}

@coveralls

Copy link
Copy Markdown

Coverage Status

Coverage remained the same at 100.0% when pulling d527a45 on elas7:fix-group into 48b1e6a on yargs:master.

Comment thread test/yargs-parser.js
})

it('should set n to the numeric value 123, with n at the end of a group', function () {
var argv = parser([ '-ab5n123' ])

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

part of me would expect this to equal:

a: true
b: true
5: true
n: true
1: true
2: true
3: true

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

This is an odd edge case. I would expect something like -x1 to be parsed as x: 1, which I think is common among most POSIX bins, but I don't know what the typical interpretation of -x1y5 is.

In this test case, I would expect the result to be one of the following:

  1. a: true, b: 5, n: 123
  2. a: true, b: true, 5: true, n: 123

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

To me, option .2. feels a little more useful, I can't think of a situation where I want 5: true but I can imagine a lazy person writing -x1y5 and expecting:

{x: 1, y:5}

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

I would honestly expect it to be parsed like @bcoe noted in the first comment. I've actually not seen it in other bins, but I would expect grouping short options to not offer assigning values at all, because it's not really obvious to which options the values shall apply. As an example:
-xy1 could mean:

  1. Assign 1 to x and y, or
  2. Assign 1 to y and true to x

Even if we would document it, it's just not obvious if you read something like this.
Additionally, currently we do assigning values to options with either a = or a space:
--value=1 and --value 1
if we now allowed typing values of a certain kind right after the name of the option, wouldn't that kinda break the consistency?

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

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

I agree with @maxrimue that we should better not assign values on short option groups based on kinds of values, most of the time it is not really obvious what the user is trying to do.

Yet, the current behavior is that numbers at the end of an options group are set as the value of the last key. Maybe we could add a configuration to yargs-parser to toggle that off?

@bcoe

bcoe commented Apr 9, 2016

Copy link
Copy Markdown
Member

@nexdrew mind lending @elas7 and I a second set of eyes?

@bcoe bcoe added the Next Major label May 1, 2016
@bcoe

bcoe commented May 1, 2016

Copy link
Copy Markdown
Member

@elas7 you've swayed me in your argument for how parsing should be applied. I think it's worth kicking this change to the next major release of yargs however, it has the potential to change parsing behavior in a way that is hard for folks to debug.

@maxrimue maxrimue mentioned this pull request Jul 9, 2016
10 tasks
@bcoe
bcoe merged commit f743236 into yargs:master Aug 7, 2016
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants