optparse 0.4.0 → 0.5.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- checksums.yaml +4 -4
- data/.document +7 -0
- data/.rdoc_options +4 -0
- data/ChangeLog +219 -107
- data/doc/optparse/.document +1 -0
- data/doc/optparse/option_params.rdoc +1 -1
- data/doc/optparse/ruby/argument_abbreviation.rb +9 -0
- data/doc/optparse/tutorial.rdoc +23 -0
- data/lib/optparse/ac.rb +16 -0
- data/lib/optparse/kwargs.rb +8 -3
- data/lib/optparse/version.rb +9 -0
- data/lib/optparse.rb +147 -53
- metadata +7 -3
checksums.yaml
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
SHA256:
|
|
3
|
-
metadata.gz:
|
|
4
|
-
data.tar.gz:
|
|
3
|
+
metadata.gz: a5a9ef5004e5838005ad874fc163ebd1e6266d3319d08be502a8fb2d6b6b48a2
|
|
4
|
+
data.tar.gz: 94fb689cea59f667e4bc4788a6713a50cd829b4e552097994e7b9833f5f35432
|
|
5
5
|
SHA512:
|
|
6
|
-
metadata.gz:
|
|
7
|
-
data.tar.gz:
|
|
6
|
+
metadata.gz: 5d0d3a7e51d10a3636e337dfdbe6562ae32e5e4ee18ef61926460f964900f5341f75ae3dd308901e2c1bdf8d5e1c1bd4434d8fe1e2fc77b366bf68690fa9ec85
|
|
7
|
+
data.tar.gz: e494246dfe20878a07d79d3489918b9383a2ade4076023a4fd1ec5f973c2f8111066b85fa8e49b69303ff8ff7301adc4ad5c7d3cccde5650ef93afa9b7819030
|
data/.document
ADDED
data/.rdoc_options
ADDED
data/ChangeLog
CHANGED
|
@@ -1,163 +1,275 @@
|
|
|
1
1
|
-*- coding: utf-8 -*-
|
|
2
2
|
|
|
3
|
-
commit
|
|
4
|
-
Author:
|
|
5
|
-
AuthorDate:
|
|
6
|
-
Commit:
|
|
7
|
-
CommitDate:
|
|
3
|
+
commit 979bd76281d28044b3def3eadba233a87e62415a
|
|
4
|
+
Author: Nobuyoshi Nakada <nobu@ruby-lang.org>
|
|
5
|
+
AuthorDate: 2024-04-15 18:42:47 +0900
|
|
6
|
+
Commit: Nobuyoshi Nakada <nobu@ruby-lang.org>
|
|
7
|
+
CommitDate: 2024-04-15 18:42:47 +0900
|
|
8
8
|
|
|
9
|
-
|
|
9
|
+
[DOC] Split fetching commits and building package
|
|
10
10
|
|
|
11
|
-
commit
|
|
12
|
-
Author:
|
|
13
|
-
AuthorDate:
|
|
14
|
-
Commit:
|
|
15
|
-
CommitDate:
|
|
11
|
+
commit ca883bd3a1ac13957774fcb93e8bccd80b74c9d1
|
|
12
|
+
Author: Nobuyoshi Nakada <nobu@ruby-lang.org>
|
|
13
|
+
AuthorDate: 2024-04-15 18:21:31 +0900
|
|
14
|
+
Commit: Nobuyoshi Nakada <nobu@ruby-lang.org>
|
|
15
|
+
CommitDate: 2024-04-15 18:21:31 +0900
|
|
16
16
|
|
|
17
|
-
|
|
17
|
+
[DOC] git on Github Actions is old
|
|
18
18
|
|
|
19
|
-
|
|
20
|
-
Author: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
|
|
21
|
-
AuthorDate: 2023-09-11 03:20:53 +0000
|
|
22
|
-
Commit: Hiroshi SHIBATA <hsbt@ruby-lang.org>
|
|
23
|
-
CommitDate: 2023-09-11 14:02:17 +0900
|
|
19
|
+
It does not support `--unshallow-exclude` option.
|
|
24
20
|
|
|
25
|
-
|
|
21
|
+
commit 7f79bc820ff0e04a05204ec63c5fc3e9c85e14ad
|
|
22
|
+
Author: Nobuyoshi Nakada <nobu@ruby-lang.org>
|
|
23
|
+
AuthorDate: 2024-04-15 18:08:57 +0900
|
|
24
|
+
Commit: Nobuyoshi Nakada <nobu@ruby-lang.org>
|
|
25
|
+
CommitDate: 2024-04-15 18:08:57 +0900
|
|
26
26
|
|
|
27
|
-
|
|
28
|
-
- [Release notes](https://github.com/actions/checkout/releases)
|
|
29
|
-
- [Changelog](https://github.com/actions/checkout/blob/main/CHANGELOG.md)
|
|
30
|
-
- [Commits](https://github.com/actions/checkout/compare/v3...v4)
|
|
27
|
+
[DOC] Fix error when no tag found
|
|
31
28
|
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
...
|
|
29
|
+
commit add085df63d79d878a8901c42f2cfc3eec56307f
|
|
30
|
+
Author: Nobuyoshi Nakada <nobu@ruby-lang.org>
|
|
31
|
+
AuthorDate: 2024-04-15 15:57:09 +0900
|
|
32
|
+
Commit: Nobuyoshi Nakada <nobu@ruby-lang.org>
|
|
33
|
+
CommitDate: 2024-04-15 15:58:54 +0900
|
|
38
34
|
|
|
39
|
-
|
|
35
|
+
Fetch upto the previous tag for changelogs
|
|
40
36
|
|
|
41
|
-
commit
|
|
42
|
-
Author:
|
|
43
|
-
AuthorDate:
|
|
44
|
-
Commit:
|
|
45
|
-
CommitDate:
|
|
37
|
+
commit 436a5c516b67f8aec900f2361567c6fc163ade05
|
|
38
|
+
Author: Nobuyoshi Nakada <nobu@ruby-lang.org>
|
|
39
|
+
AuthorDate: 2024-04-15 15:08:19 +0900
|
|
40
|
+
Commit: Nobuyoshi Nakada <nobu@ruby-lang.org>
|
|
41
|
+
CommitDate: 2024-04-15 15:08:19 +0900
|
|
46
42
|
|
|
47
|
-
[DOC]
|
|
43
|
+
[DOC] Make timestamps in a ISO 8601-like format
|
|
48
44
|
|
|
49
|
-
commit
|
|
45
|
+
commit 3a2dcd72d1fdabf63218cd13c8c7953cb3c28f6b
|
|
50
46
|
Author: Nobuyoshi Nakada <nobu@ruby-lang.org>
|
|
51
|
-
AuthorDate:
|
|
47
|
+
AuthorDate: 2024-04-15 14:55:14 +0900
|
|
52
48
|
Commit: Nobuyoshi Nakada <nobu@ruby-lang.org>
|
|
53
|
-
CommitDate:
|
|
49
|
+
CommitDate: 2024-04-15 14:55:14 +0900
|
|
50
|
+
|
|
51
|
+
[DOC] Make ChangeLog non-empty
|
|
54
52
|
|
|
55
|
-
|
|
53
|
+
When the latest version is tagged at the head, there is no commit
|
|
54
|
+
between the tag and the head. Make from the previous tag.
|
|
56
55
|
|
|
57
|
-
commit
|
|
56
|
+
commit b7382c02f1092f2c0ef0f4096d3b8428e2adf3fa
|
|
58
57
|
Author: Nobuyoshi Nakada <nobu@ruby-lang.org>
|
|
59
|
-
AuthorDate:
|
|
58
|
+
AuthorDate: 2024-04-15 14:49:59 +0900
|
|
60
59
|
Commit: Nobuyoshi Nakada <nobu@ruby-lang.org>
|
|
61
|
-
CommitDate:
|
|
60
|
+
CommitDate: 2024-04-15 14:49:59 +0900
|
|
62
61
|
|
|
63
|
-
|
|
62
|
+
[DOC] Exclude CI-skipped commits from changelogs
|
|
64
63
|
|
|
65
|
-
commit
|
|
66
|
-
Author:
|
|
67
|
-
AuthorDate:
|
|
68
|
-
Commit:
|
|
69
|
-
CommitDate:
|
|
64
|
+
commit b49cb996afdd68e4eb373ba602c95b52c963d160
|
|
65
|
+
Author: Nobuyoshi Nakada <nobu@ruby-lang.org>
|
|
66
|
+
AuthorDate: 2024-04-15 14:24:19 +0900
|
|
67
|
+
Commit: Nobuyoshi Nakada <nobu@ruby-lang.org>
|
|
68
|
+
CommitDate: 2024-04-15 14:24:19 +0900
|
|
70
69
|
|
|
71
|
-
|
|
70
|
+
[DOC] Package files for RDoc
|
|
72
71
|
|
|
73
|
-
|
|
72
|
+
commit f5018a8b1ce82f7ac7458d00d099a454c3c03ea1
|
|
73
|
+
Author: Nobuyoshi Nakada <nobu@ruby-lang.org>
|
|
74
|
+
AuthorDate: 2024-04-15 14:05:43 +0900
|
|
75
|
+
Commit: Nobuyoshi Nakada <nobu@ruby-lang.org>
|
|
76
|
+
CommitDate: 2024-04-15 14:05:43 +0900
|
|
74
77
|
|
|
75
|
-
|
|
76
|
-
Author: Hiroshi SHIBATA <hsbt@ruby-lang.org>
|
|
77
|
-
AuthorDate: 2023-03-24 13:01:25 +0900
|
|
78
|
-
Commit: Hiroshi SHIBATA <hsbt@ruby-lang.org>
|
|
79
|
-
CommitDate: 2023-03-24 13:38:04 +0900
|
|
78
|
+
bump up to 0.5.0
|
|
80
79
|
|
|
81
|
-
|
|
80
|
+
commit ece4bb2673c7fa9f53133ba91bbffd423ebadc90
|
|
81
|
+
Author: Koichi Sasada <ko1@atdot.net>
|
|
82
|
+
AuthorDate: 2024-03-27 07:29:38 +0900
|
|
83
|
+
Commit: Koichi Sasada <ko1@atdot.net>
|
|
84
|
+
CommitDate: 2024-04-15 12:08:07 +0900
|
|
82
85
|
|
|
83
|
-
|
|
84
|
-
Author: Hiroshi SHIBATA <hsbt@ruby-lang.org>
|
|
85
|
-
AuthorDate: 2023-02-18 16:37:54 +0900
|
|
86
|
-
Commit: Hiroshi SHIBATA <hsbt@ruby-lang.org>
|
|
87
|
-
CommitDate: 2023-02-18 16:46:18 +0900
|
|
86
|
+
show warning for unused block
|
|
88
87
|
|
|
89
|
-
|
|
88
|
+
With verbopse mode (-w), the interpreter shows a warning if
|
|
89
|
+
a block is passed to a method which does not use the given block.
|
|
90
90
|
|
|
91
|
-
|
|
92
|
-
Author: Hiroshi SHIBATA <hsbt@ruby-lang.org>
|
|
93
|
-
AuthorDate: 2023-02-18 16:31:55 +0900
|
|
94
|
-
Commit: Hiroshi SHIBATA <hsbt@ruby-lang.org>
|
|
95
|
-
CommitDate: 2023-02-18 16:46:18 +0900
|
|
91
|
+
Warning on:
|
|
96
92
|
|
|
97
|
-
|
|
93
|
+
* the invoked method is not written in C
|
|
94
|
+
* the invoked method is not `initialize`
|
|
95
|
+
* not invoked with `super`
|
|
96
|
+
* the first time on the call-site with the invoked method
|
|
97
|
+
(`obj.foo{}` will be warned once if `foo` is same method)
|
|
98
98
|
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
|
|
99
|
+
[Feature #15554]
|
|
100
|
+
|
|
101
|
+
`Primitive.attr! :use_block` is introduced to declare that primitive
|
|
102
|
+
functions (written in C) will use passed block.
|
|
103
|
+
|
|
104
|
+
For minitest, test needs some tweak, so use
|
|
105
|
+
https://github.com/minitest/minitest/commit/ea9caafc0754b1d6236a490d59e624b53209734a
|
|
106
|
+
for `test-bundled-gems`.
|
|
107
|
+
|
|
108
|
+
ruby/ruby@9180e33ca3a5886fec3f9e0a2f48072b55914e65
|
|
109
|
+
|
|
110
|
+
commit 77dccce37cb9fd1b8fbc52160d4103d1c4579669
|
|
111
|
+
Author: Nobuyoshi Nakada <nobu@ruby-lang.org>
|
|
112
|
+
AuthorDate: 2024-03-01 01:24:05 +0900
|
|
113
|
+
Commit: Nobuyoshi Nakada <nobu@ruby-lang.org>
|
|
114
|
+
CommitDate: 2024-03-01 01:24:05 +0900
|
|
115
|
+
|
|
116
|
+
Invoke pager for `--help`
|
|
117
|
+
|
|
118
|
+
commit 59b9fd7ddca3e795c235aa397655b51de2e4c949
|
|
119
|
+
Author: Nobuyoshi Nakada <nobu@ruby-lang.org>
|
|
120
|
+
AuthorDate: 2024-02-23 21:49:57 +0900
|
|
121
|
+
Commit: Nobuyoshi Nakada <nobu@ruby-lang.org>
|
|
122
|
+
CommitDate: 2024-02-23 21:49:57 +0900
|
|
104
123
|
|
|
105
|
-
|
|
124
|
+
[DOC] About return value of OptionParser#new
|
|
106
125
|
|
|
107
|
-
commit
|
|
108
|
-
Author:
|
|
109
|
-
AuthorDate:
|
|
126
|
+
commit 07e83673a8e99b5b7985608a69f713abde3344f6
|
|
127
|
+
Author: Nobuyoshi Nakada <nobu@ruby-lang.org>
|
|
128
|
+
AuthorDate: 2024-02-21 13:42:11 +0900
|
|
129
|
+
Commit: Nobuyoshi Nakada <nobu@ruby-lang.org>
|
|
130
|
+
CommitDate: 2024-02-23 21:13:51 +0900
|
|
131
|
+
|
|
132
|
+
Add `exact:` keyword argument
|
|
133
|
+
|
|
134
|
+
commit bbec64d0c7f198429b62468b64b27692efa18dc2
|
|
135
|
+
Author: Yusuke Endoh <mame@ruby-lang.org>
|
|
136
|
+
AuthorDate: 2024-01-19 16:03:38 +0900
|
|
110
137
|
Commit: Hiroshi SHIBATA <hsbt@ruby-lang.org>
|
|
111
|
-
CommitDate:
|
|
138
|
+
CommitDate: 2024-02-16 10:47:36 +0900
|
|
139
|
+
|
|
140
|
+
Do not include a backtick in error messages and backtraces
|
|
112
141
|
|
|
113
|
-
|
|
142
|
+
[Feature #16495]
|
|
114
143
|
|
|
115
|
-
commit
|
|
116
|
-
Author:
|
|
117
|
-
AuthorDate:
|
|
118
|
-
Commit:
|
|
119
|
-
CommitDate:
|
|
144
|
+
commit 451dea51a0e5d062fb4cb75b1073a2c2b8609bef
|
|
145
|
+
Author: Nobuyoshi Nakada <nobu@ruby-lang.org>
|
|
146
|
+
AuthorDate: 2024-02-12 01:30:58 +0900
|
|
147
|
+
Commit: Nobuyoshi Nakada <nobu@ruby-lang.org>
|
|
148
|
+
CommitDate: 2024-02-12 01:30:58 +0900
|
|
149
|
+
|
|
150
|
+
[DOC] Add description of OptionParser#define_by_keywords
|
|
120
151
|
|
|
121
|
-
|
|
152
|
+
commit 33956ce93f56320978cedfcebb8b6cf18bf96c53
|
|
153
|
+
Author: Nobuyoshi Nakada <nobu@ruby-lang.org>
|
|
154
|
+
AuthorDate: 2024-02-12 01:07:05 +0900
|
|
155
|
+
Commit: Nobuyoshi Nakada <nobu@ruby-lang.org>
|
|
156
|
+
CommitDate: 2024-02-12 01:07:05 +0900
|
|
122
157
|
|
|
123
|
-
|
|
158
|
+
[DOC] Add missing documents
|
|
124
159
|
|
|
125
|
-
commit
|
|
126
|
-
Author:
|
|
127
|
-
AuthorDate:
|
|
160
|
+
commit 78afdab30751e1b7cf80bb57d6696b10879f90fe
|
|
161
|
+
Author: Nobuyoshi Nakada <nobu@ruby-lang.org>
|
|
162
|
+
AuthorDate: 2024-02-10 22:56:32 +0900
|
|
128
163
|
Commit: Nobuyoshi Nakada <nobu@ruby-lang.org>
|
|
129
|
-
CommitDate:
|
|
164
|
+
CommitDate: 2024-02-10 22:56:32 +0900
|
|
130
165
|
|
|
131
|
-
|
|
166
|
+
Search exactly when `require_exact`
|
|
132
167
|
|
|
133
|
-
|
|
168
|
+
To work with options defined as `--[no]-something`.
|
|
169
|
+
|
|
170
|
+
Fix https://bugs.ruby-lang.org/issues/20252
|
|
171
|
+
Fix #60
|
|
172
|
+
|
|
173
|
+
commit 213cb03b5978ddacfbcc8f71ec837d9a6fd4c56d
|
|
134
174
|
Author: Nobuyoshi Nakada <nobu@ruby-lang.org>
|
|
135
|
-
AuthorDate:
|
|
175
|
+
AuthorDate: 2024-02-09 19:03:20 +0900
|
|
136
176
|
Commit: Nobuyoshi Nakada <nobu@ruby-lang.org>
|
|
137
|
-
CommitDate:
|
|
177
|
+
CommitDate: 2024-02-09 19:03:20 +0900
|
|
178
|
+
|
|
179
|
+
Adjust arguments for lambda-callbacks
|
|
138
180
|
|
|
139
|
-
|
|
181
|
+
Rake uses [lambda] as callbacks.
|
|
182
|
+
Calling it without omitted argument raises an `ArgumentError`.
|
|
140
183
|
|
|
141
|
-
|
|
184
|
+
lambda: https://github.com/ruby/rake/blob/master/lib/rake/application.rb#L543
|
|
185
|
+
|
|
186
|
+
commit 9d53e74aa4421e0c4e2a805a0074ece5aae3773f
|
|
142
187
|
Author: Nobuyoshi Nakada <nobu@ruby-lang.org>
|
|
143
|
-
AuthorDate:
|
|
188
|
+
AuthorDate: 2024-02-09 12:59:43 +0900
|
|
144
189
|
Commit: Nobuyoshi Nakada <nobu@ruby-lang.org>
|
|
145
|
-
CommitDate:
|
|
190
|
+
CommitDate: 2024-02-09 12:59:43 +0900
|
|
191
|
+
|
|
192
|
+
Respect default values in block parameters
|
|
146
193
|
|
|
147
|
-
|
|
194
|
+
Fix #55
|
|
148
195
|
|
|
149
|
-
commit
|
|
196
|
+
commit 4e346ad337f400dbff855798e859f17455698c2a
|
|
197
|
+
Author: fatkodima <fatkodima123@gmail.com>
|
|
198
|
+
AuthorDate: 2023-10-14 21:52:01 +0300
|
|
199
|
+
Commit: Nobuyoshi Nakada <nobu@ruby-lang.org>
|
|
200
|
+
CommitDate: 2024-02-09 12:31:08 +0900
|
|
201
|
+
|
|
202
|
+
Fix `require_exact` to work with options defined as `--[no]-something`
|
|
203
|
+
|
|
204
|
+
commit b14c2c644d18cce226e49ccde8a23b5b991ea8cf
|
|
150
205
|
Author: Nobuyoshi Nakada <nobu@ruby-lang.org>
|
|
151
|
-
AuthorDate:
|
|
206
|
+
AuthorDate: 2024-02-09 12:17:31 +0900
|
|
207
|
+
Commit: Nobuyoshi Nakada <nobu@ruby-lang.org>
|
|
208
|
+
CommitDate: 2024-02-09 12:17:31 +0900
|
|
209
|
+
|
|
210
|
+
Escape backslashes
|
|
211
|
+
|
|
212
|
+
commit 434e92fc62ff9571124335a2eedff56df83dae48
|
|
213
|
+
Author: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
|
|
214
|
+
AuthorDate: 2023-12-18 03:43:27 +0000
|
|
152
215
|
Commit: Nobuyoshi Nakada <nobu@ruby-lang.org>
|
|
153
|
-
CommitDate:
|
|
216
|
+
CommitDate: 2024-02-09 12:14:30 +0900
|
|
154
217
|
|
|
155
|
-
|
|
218
|
+
Bump actions/upload-artifact from 3 to 4
|
|
156
219
|
|
|
157
|
-
|
|
220
|
+
Bumps [actions/upload-artifact](https://github.com/actions/upload-artifact) from 3 to 4.
|
|
221
|
+
- [Release notes](https://github.com/actions/upload-artifact/releases)
|
|
222
|
+
- [Commits](https://github.com/actions/upload-artifact/compare/v3...v4)
|
|
223
|
+
|
|
224
|
+
---
|
|
225
|
+
updated-dependencies:
|
|
226
|
+
- dependency-name: actions/upload-artifact
|
|
227
|
+
dependency-type: direct:production
|
|
228
|
+
update-type: version-update:semver-major
|
|
229
|
+
...
|
|
230
|
+
|
|
231
|
+
Signed-off-by: dependabot[bot] <support@github.com>
|
|
232
|
+
|
|
233
|
+
commit 48385d3eaf37cd10140274453eeadc4496581fc2
|
|
234
|
+
Author: Nobuyoshi Nakada <nobu@ruby-lang.org>
|
|
235
|
+
AuthorDate: 2024-02-09 12:01:44 +0900
|
|
236
|
+
Commit: Nobuyoshi Nakada <nobu@ruby-lang.org>
|
|
237
|
+
CommitDate: 2024-02-09 12:06:40 +0900
|
|
238
|
+
|
|
239
|
+
Create codeql.yml
|
|
240
|
+
|
|
241
|
+
commit 294c6e1ed4b170a8a34ab95c84453829c170223c
|
|
242
|
+
Author: Nobuyoshi Nakada <nobu@ruby-lang.org>
|
|
243
|
+
AuthorDate: 2023-12-25 15:08:05 +0900
|
|
244
|
+
Commit: Nobuyoshi Nakada <nobu@ruby-lang.org>
|
|
245
|
+
CommitDate: 2023-12-25 15:08:05 +0900
|
|
246
|
+
|
|
247
|
+
Build packages only on the latest release
|
|
248
|
+
|
|
249
|
+
commit 324ff21f042769444cde41949fc0321f6c6ccf63
|
|
250
|
+
Author: Nobuyoshi Nakada <nobu@ruby-lang.org>
|
|
251
|
+
AuthorDate: 2023-12-18 12:45:44 +0900
|
|
252
|
+
Commit: Nobuyoshi Nakada <nobu@ruby-lang.org>
|
|
253
|
+
CommitDate: 2023-12-18 12:45:44 +0900
|
|
254
|
+
|
|
255
|
+
[DOC] Add missing documents
|
|
256
|
+
|
|
257
|
+
commit 667ab35f593f81b7850009385453d20ca8023bba
|
|
158
258
|
Author: Nobuyoshi Nakada <nobu@ruby-lang.org>
|
|
159
|
-
AuthorDate:
|
|
259
|
+
AuthorDate: 2023-12-18 12:24:46 +0900
|
|
160
260
|
Commit: Nobuyoshi Nakada <nobu@ruby-lang.org>
|
|
161
|
-
CommitDate:
|
|
261
|
+
CommitDate: 2023-12-18 12:24:46 +0900
|
|
262
|
+
|
|
263
|
+
[DOC] Add missing secition
|
|
264
|
+
|
|
265
|
+
Fixes #51
|
|
266
|
+
|
|
267
|
+
commit 1c895efc39ed2290c185dcb80523fee381dfe74e
|
|
268
|
+
Author: Nobuyoshi Nakada <nobu@ruby-lang.org>
|
|
269
|
+
AuthorDate: 2023-12-18 12:15:31 +0900
|
|
270
|
+
Commit: Nobuyoshi Nakada <nobu@ruby-lang.org>
|
|
271
|
+
CommitDate: 2023-12-18 12:15:31 +0900
|
|
272
|
+
|
|
273
|
+
[DOC] Fix tutorial link
|
|
162
274
|
|
|
163
|
-
|
|
275
|
+
Fixes #51
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
*.rdoc
|
|
@@ -31,7 +31,7 @@ Contents:
|
|
|
31
31
|
- {Long Names with Optional Arguments}[#label-Long+Names+with+Optional+Arguments]
|
|
32
32
|
- {Long Names with Negation}[#label-Long+Names+with+Negation]
|
|
33
33
|
- {Mixed Names}[#label-Mixed+Names]
|
|
34
|
-
- {Argument
|
|
34
|
+
- {Argument Strings}[#label-Argument+Strings]
|
|
35
35
|
- {Argument Values}[#label-Argument+Values]
|
|
36
36
|
- {Explicit Argument Values}[#label-Explicit+Argument+Values]
|
|
37
37
|
- {Explicit Values in Array}[#label-Explicit+Values+in+Array]
|
|
@@ -0,0 +1,9 @@
|
|
|
1
|
+
require 'optparse'
|
|
2
|
+
parser = OptionParser.new
|
|
3
|
+
parser.on('-x', '--xxx=VALUE', %w[ABC def], 'Argument abbreviations') do |value|
|
|
4
|
+
p ['--xxx', value]
|
|
5
|
+
end
|
|
6
|
+
parser.on('-y', '--yyy=VALUE', {"abc"=>"XYZ", def: "FOO"}, 'Argument abbreviations') do |value|
|
|
7
|
+
p ['--yyy', value]
|
|
8
|
+
end
|
|
9
|
+
parser.parse!
|
data/doc/optparse/tutorial.rdoc
CHANGED
|
@@ -351,6 +351,29 @@ Executions:
|
|
|
351
351
|
|
|
352
352
|
Omitting an optional argument does not raise an error.
|
|
353
353
|
|
|
354
|
+
==== Argument Abbreviations
|
|
355
|
+
|
|
356
|
+
Specify an argument list as an Array or a Hash.
|
|
357
|
+
|
|
358
|
+
:include: ruby/argument_abbreviation.rb
|
|
359
|
+
|
|
360
|
+
When an argument is abbreviated, the expanded argument yielded.
|
|
361
|
+
|
|
362
|
+
Executions:
|
|
363
|
+
|
|
364
|
+
$ ruby argument_abbreviation.rb --help
|
|
365
|
+
Usage: argument_abbreviation [options]
|
|
366
|
+
Usage: argument_abbreviation [options]
|
|
367
|
+
-x, --xxx=VALUE Argument abbreviations
|
|
368
|
+
-y, --yyy=VALUE Argument abbreviations
|
|
369
|
+
$ ruby argument_abbreviation.rb --xxx A
|
|
370
|
+
["--xxx", "ABC"]
|
|
371
|
+
$ ruby argument_abbreviation.rb --xxx c
|
|
372
|
+
argument_abbreviation.rb:9:in `<main>': invalid argument: --xxx c (OptionParser::InvalidArgument)
|
|
373
|
+
$ ruby argument_abbreviation.rb --yyy a --yyy d
|
|
374
|
+
["--yyy", "XYZ"]
|
|
375
|
+
["--yyy", "FOO"]
|
|
376
|
+
|
|
354
377
|
=== Argument Values
|
|
355
378
|
|
|
356
379
|
Permissible argument values may be restricted
|
data/lib/optparse/ac.rb
CHANGED
|
@@ -1,7 +1,11 @@
|
|
|
1
1
|
# frozen_string_literal: false
|
|
2
2
|
require_relative '../optparse'
|
|
3
3
|
|
|
4
|
+
#
|
|
5
|
+
# autoconf-like options.
|
|
6
|
+
#
|
|
4
7
|
class OptionParser::AC < OptionParser
|
|
8
|
+
# :stopdoc:
|
|
5
9
|
private
|
|
6
10
|
|
|
7
11
|
def _check_ac_args(name, block)
|
|
@@ -14,6 +18,7 @@ class OptionParser::AC < OptionParser
|
|
|
14
18
|
end
|
|
15
19
|
|
|
16
20
|
ARG_CONV = proc {|val| val.nil? ? true : val}
|
|
21
|
+
private_constant :ARG_CONV
|
|
17
22
|
|
|
18
23
|
def _ac_arg_enable(prefix, name, help_string, block)
|
|
19
24
|
_check_ac_args(name, block)
|
|
@@ -29,16 +34,27 @@ class OptionParser::AC < OptionParser
|
|
|
29
34
|
enable
|
|
30
35
|
end
|
|
31
36
|
|
|
37
|
+
# :startdoc:
|
|
38
|
+
|
|
32
39
|
public
|
|
33
40
|
|
|
41
|
+
# Define <tt>--enable</tt> / <tt>--disable</tt> style option
|
|
42
|
+
#
|
|
43
|
+
# Appears as <tt>--enable-<i>name</i></tt> in help message.
|
|
34
44
|
def ac_arg_enable(name, help_string, &block)
|
|
35
45
|
_ac_arg_enable("enable", name, help_string, block)
|
|
36
46
|
end
|
|
37
47
|
|
|
48
|
+
# Define <tt>--enable</tt> / <tt>--disable</tt> style option
|
|
49
|
+
#
|
|
50
|
+
# Appears as <tt>--disable-<i>name</i></tt> in help message.
|
|
38
51
|
def ac_arg_disable(name, help_string, &block)
|
|
39
52
|
_ac_arg_enable("disable", name, help_string, block)
|
|
40
53
|
end
|
|
41
54
|
|
|
55
|
+
# Define <tt>--with</tt> / <tt>--without</tt> style option
|
|
56
|
+
#
|
|
57
|
+
# Appears as <tt>--with-<i>name</i></tt> in help message.
|
|
42
58
|
def ac_arg_with(name, help_string, &block)
|
|
43
59
|
_check_ac_args(name, block)
|
|
44
60
|
|
data/lib/optparse/kwargs.rb
CHANGED
|
@@ -7,12 +7,17 @@ class OptionParser
|
|
|
7
7
|
#
|
|
8
8
|
# :include: ../../doc/optparse/creates_option.rdoc
|
|
9
9
|
#
|
|
10
|
-
|
|
11
|
-
|
|
10
|
+
# Defines options which set in to _options_ for keyword parameters
|
|
11
|
+
# of _method_.
|
|
12
|
+
#
|
|
13
|
+
# Parameters for each keywords are given as elements of _params_.
|
|
14
|
+
#
|
|
15
|
+
def define_by_keywords(options, method, **params)
|
|
16
|
+
method.parameters.each do |type, name|
|
|
12
17
|
case type
|
|
13
18
|
when :key, :keyreq
|
|
14
19
|
op, cl = *(type == :key ? %w"[ ]" : ["", ""])
|
|
15
|
-
define("--#{name}=#{op}#{name.upcase}#{cl}", *
|
|
20
|
+
define("--#{name}=#{op}#{name.upcase}#{cl}", *params[name]) do |o|
|
|
16
21
|
options[name] = o
|
|
17
22
|
end
|
|
18
23
|
end
|
data/lib/optparse/version.rb
CHANGED
|
@@ -2,6 +2,11 @@
|
|
|
2
2
|
# OptionParser internal utility
|
|
3
3
|
|
|
4
4
|
class << OptionParser
|
|
5
|
+
#
|
|
6
|
+
# Shows version string in packages if Version is defined.
|
|
7
|
+
#
|
|
8
|
+
# +pkgs+:: package list
|
|
9
|
+
#
|
|
5
10
|
def show_version(*pkgs)
|
|
6
11
|
progname = ARGV.options.program_name
|
|
7
12
|
result = false
|
|
@@ -47,6 +52,8 @@ class << OptionParser
|
|
|
47
52
|
result
|
|
48
53
|
end
|
|
49
54
|
|
|
55
|
+
# :stopdoc:
|
|
56
|
+
|
|
50
57
|
def each_const(path, base = ::Object)
|
|
51
58
|
path.split(/::|\//).inject(base) do |klass, name|
|
|
52
59
|
raise NameError, path unless Module === klass
|
|
@@ -68,4 +75,6 @@ class << OptionParser
|
|
|
68
75
|
end
|
|
69
76
|
end
|
|
70
77
|
end
|
|
78
|
+
|
|
79
|
+
# :startdoc:
|
|
71
80
|
end
|
data/lib/optparse.rb
CHANGED
|
@@ -8,7 +8,6 @@
|
|
|
8
8
|
# See OptionParser for documentation.
|
|
9
9
|
#
|
|
10
10
|
|
|
11
|
-
|
|
12
11
|
#--
|
|
13
12
|
# == Developer Documentation (not for RDoc output)
|
|
14
13
|
#
|
|
@@ -425,7 +424,8 @@
|
|
|
425
424
|
# If you have any questions, file a ticket at http://bugs.ruby-lang.org.
|
|
426
425
|
#
|
|
427
426
|
class OptionParser
|
|
428
|
-
|
|
427
|
+
# The version string
|
|
428
|
+
OptionParser::Version = "0.5.0"
|
|
429
429
|
|
|
430
430
|
# :stopdoc:
|
|
431
431
|
NoArgument = [NO_ARGUMENT = :NONE, nil].freeze
|
|
@@ -438,6 +438,8 @@ class OptionParser
|
|
|
438
438
|
# and resolved against a list of acceptable values.
|
|
439
439
|
#
|
|
440
440
|
module Completion
|
|
441
|
+
# :nodoc:
|
|
442
|
+
|
|
441
443
|
def self.regexp(key, icase)
|
|
442
444
|
Regexp.new('\A' + Regexp.quote(key).gsub(/\w+\b/, '\&\w*'), icase)
|
|
443
445
|
end
|
|
@@ -459,7 +461,7 @@ class OptionParser
|
|
|
459
461
|
candidates
|
|
460
462
|
end
|
|
461
463
|
|
|
462
|
-
def candidate(key, icase = false, pat = nil)
|
|
464
|
+
def candidate(key, icase = false, pat = nil, &_)
|
|
463
465
|
Completion.candidate(key, icase, pat, &method(:each))
|
|
464
466
|
end
|
|
465
467
|
|
|
@@ -510,6 +512,8 @@ class OptionParser
|
|
|
510
512
|
# RequiredArgument, etc.
|
|
511
513
|
#
|
|
512
514
|
class Switch
|
|
515
|
+
# :nodoc:
|
|
516
|
+
|
|
513
517
|
attr_reader :pattern, :conv, :short, :long, :arg, :desc, :block
|
|
514
518
|
|
|
515
519
|
#
|
|
@@ -697,6 +701,11 @@ class OptionParser
|
|
|
697
701
|
q.object_group(self) {pretty_print_contents(q)}
|
|
698
702
|
end
|
|
699
703
|
|
|
704
|
+
def omitted_argument(val) # :nodoc:
|
|
705
|
+
val.pop if val.size == 3 and val.last.nil?
|
|
706
|
+
val
|
|
707
|
+
end
|
|
708
|
+
|
|
700
709
|
#
|
|
701
710
|
# Switch that takes no arguments.
|
|
702
711
|
#
|
|
@@ -710,10 +719,10 @@ class OptionParser
|
|
|
710
719
|
conv_arg(arg)
|
|
711
720
|
end
|
|
712
721
|
|
|
713
|
-
def self.incompatible_argument_styles(*)
|
|
722
|
+
def self.incompatible_argument_styles(*) # :nodoc:
|
|
714
723
|
end
|
|
715
724
|
|
|
716
|
-
def self.pattern
|
|
725
|
+
def self.pattern # :nodoc:
|
|
717
726
|
Object
|
|
718
727
|
end
|
|
719
728
|
|
|
@@ -730,7 +739,7 @@ class OptionParser
|
|
|
730
739
|
#
|
|
731
740
|
# Raises an exception if argument is not present.
|
|
732
741
|
#
|
|
733
|
-
def parse(arg, argv)
|
|
742
|
+
def parse(arg, argv, &_)
|
|
734
743
|
unless arg
|
|
735
744
|
raise MissingArgument if argv.empty?
|
|
736
745
|
arg = argv.shift
|
|
@@ -755,7 +764,7 @@ class OptionParser
|
|
|
755
764
|
if arg
|
|
756
765
|
conv_arg(*parse_arg(arg, &error))
|
|
757
766
|
else
|
|
758
|
-
conv_arg(arg)
|
|
767
|
+
omitted_argument conv_arg(arg)
|
|
759
768
|
end
|
|
760
769
|
end
|
|
761
770
|
|
|
@@ -774,13 +783,14 @@ class OptionParser
|
|
|
774
783
|
#
|
|
775
784
|
def parse(arg, argv, &error)
|
|
776
785
|
if !(val = arg) and (argv.empty? or /\A-./ =~ (val = argv[0]))
|
|
777
|
-
return nil, block
|
|
786
|
+
return nil, block
|
|
778
787
|
end
|
|
779
788
|
opt = (val = parse_arg(val, &error))[1]
|
|
780
789
|
val = conv_arg(*val)
|
|
781
790
|
if opt and !arg
|
|
782
791
|
argv.shift
|
|
783
792
|
else
|
|
793
|
+
omitted_argument val
|
|
784
794
|
val[0] = nil
|
|
785
795
|
end
|
|
786
796
|
val
|
|
@@ -798,6 +808,8 @@ class OptionParser
|
|
|
798
808
|
# matching pattern and converter pair. Also provides summary feature.
|
|
799
809
|
#
|
|
800
810
|
class List
|
|
811
|
+
# :nodoc:
|
|
812
|
+
|
|
801
813
|
# Map from acceptable argument types to pattern and converter pairs.
|
|
802
814
|
attr_reader :atype
|
|
803
815
|
|
|
@@ -837,7 +849,7 @@ class OptionParser
|
|
|
837
849
|
def accept(t, pat = /.*/m, &block)
|
|
838
850
|
if pat
|
|
839
851
|
pat.respond_to?(:match) or
|
|
840
|
-
raise TypeError, "has no
|
|
852
|
+
raise TypeError, "has no 'match'", ParseError.filter_backtrace(caller(2))
|
|
841
853
|
else
|
|
842
854
|
pat = t if t.respond_to?(:match)
|
|
843
855
|
end
|
|
@@ -1033,11 +1045,31 @@ XXX
|
|
|
1033
1045
|
to << "#compdef #{name}\n"
|
|
1034
1046
|
to << COMPSYS_HEADER
|
|
1035
1047
|
visit(:compsys, {}, {}) {|o, d|
|
|
1036
|
-
to << %Q[ "#{o}[#{d.gsub(/[
|
|
1048
|
+
to << %Q[ "#{o}[#{d.gsub(/[\\\"\[\]]/, '\\\\\&')}]" \\\n]
|
|
1037
1049
|
}
|
|
1038
1050
|
to << " '*:file:_files' && return 0\n"
|
|
1039
1051
|
end
|
|
1040
1052
|
|
|
1053
|
+
def help_exit
|
|
1054
|
+
if STDOUT.tty? && (pager = ENV.values_at(*%w[RUBY_PAGER PAGER]).find {|e| e && !e.empty?})
|
|
1055
|
+
less = ENV["LESS"]
|
|
1056
|
+
args = [{"LESS" => "#{!less || less.empty? ? '-' : less}Fe"}, pager, "w"]
|
|
1057
|
+
print = proc do |f|
|
|
1058
|
+
f.puts help
|
|
1059
|
+
rescue Errno::EPIPE
|
|
1060
|
+
# pager terminated
|
|
1061
|
+
end
|
|
1062
|
+
if Process.respond_to?(:fork) and false
|
|
1063
|
+
IO.popen("-") {|f| f ? Process.exec(*args, in: f) : print.call(STDOUT)}
|
|
1064
|
+
# unreachable
|
|
1065
|
+
end
|
|
1066
|
+
IO.popen(*args, &print)
|
|
1067
|
+
else
|
|
1068
|
+
puts help
|
|
1069
|
+
end
|
|
1070
|
+
exit
|
|
1071
|
+
end
|
|
1072
|
+
|
|
1041
1073
|
#
|
|
1042
1074
|
# Default options for ARGV, which never appear in option summary.
|
|
1043
1075
|
#
|
|
@@ -1049,8 +1081,7 @@ XXX
|
|
|
1049
1081
|
#
|
|
1050
1082
|
Officious['help'] = proc do |parser|
|
|
1051
1083
|
Switch::NoArgument.new do |arg|
|
|
1052
|
-
|
|
1053
|
-
exit
|
|
1084
|
+
parser.help_exit
|
|
1054
1085
|
end
|
|
1055
1086
|
end
|
|
1056
1087
|
|
|
@@ -1129,6 +1160,10 @@ XXX
|
|
|
1129
1160
|
default.to_i + 1
|
|
1130
1161
|
end
|
|
1131
1162
|
end
|
|
1163
|
+
|
|
1164
|
+
#
|
|
1165
|
+
# See self.inc
|
|
1166
|
+
#
|
|
1132
1167
|
def inc(*args)
|
|
1133
1168
|
self.class.inc(*args)
|
|
1134
1169
|
end
|
|
@@ -1167,11 +1202,19 @@ XXX
|
|
|
1167
1202
|
def terminate(arg = nil)
|
|
1168
1203
|
self.class.terminate(arg)
|
|
1169
1204
|
end
|
|
1205
|
+
#
|
|
1206
|
+
# See #terminate.
|
|
1207
|
+
#
|
|
1170
1208
|
def self.terminate(arg = nil)
|
|
1171
1209
|
throw :terminate, arg
|
|
1172
1210
|
end
|
|
1173
1211
|
|
|
1174
1212
|
@stack = [DefaultList]
|
|
1213
|
+
#
|
|
1214
|
+
# Returns the global top option list.
|
|
1215
|
+
#
|
|
1216
|
+
# Do not use directly.
|
|
1217
|
+
#
|
|
1175
1218
|
def self.top() DefaultList end
|
|
1176
1219
|
|
|
1177
1220
|
#
|
|
@@ -1192,9 +1235,9 @@ XXX
|
|
|
1192
1235
|
#
|
|
1193
1236
|
# Directs to reject specified class argument.
|
|
1194
1237
|
#
|
|
1195
|
-
# +
|
|
1238
|
+
# +type+:: Argument class specifier, any object including Class.
|
|
1196
1239
|
#
|
|
1197
|
-
# reject(
|
|
1240
|
+
# reject(type)
|
|
1198
1241
|
#
|
|
1199
1242
|
def reject(*args, &blk) top.reject(*args, &blk) end
|
|
1200
1243
|
#
|
|
@@ -1284,10 +1327,24 @@ XXX
|
|
|
1284
1327
|
end
|
|
1285
1328
|
end
|
|
1286
1329
|
|
|
1330
|
+
#
|
|
1331
|
+
# Shows warning message with the program name
|
|
1332
|
+
#
|
|
1333
|
+
# +mesg+:: Message, defaulted to +$!+.
|
|
1334
|
+
#
|
|
1335
|
+
# See Kernel#warn.
|
|
1336
|
+
#
|
|
1287
1337
|
def warn(mesg = $!)
|
|
1288
1338
|
super("#{program_name}: #{mesg}")
|
|
1289
1339
|
end
|
|
1290
1340
|
|
|
1341
|
+
#
|
|
1342
|
+
# Shows message with the program name then aborts.
|
|
1343
|
+
#
|
|
1344
|
+
# +mesg+:: Message, defaulted to +$!+.
|
|
1345
|
+
#
|
|
1346
|
+
# See Kernel#abort.
|
|
1347
|
+
#
|
|
1291
1348
|
def abort(mesg = $!)
|
|
1292
1349
|
super("#{program_name}: #{mesg}")
|
|
1293
1350
|
end
|
|
@@ -1309,6 +1366,9 @@ XXX
|
|
|
1309
1366
|
#
|
|
1310
1367
|
# Pushes a new List.
|
|
1311
1368
|
#
|
|
1369
|
+
# If a block is given, yields +self+ and returns the result of the
|
|
1370
|
+
# block, otherwise returns +self+.
|
|
1371
|
+
#
|
|
1312
1372
|
def new
|
|
1313
1373
|
@stack.push(List.new)
|
|
1314
1374
|
if block_given?
|
|
@@ -1532,6 +1592,12 @@ XXX
|
|
|
1532
1592
|
nolong
|
|
1533
1593
|
end
|
|
1534
1594
|
|
|
1595
|
+
# ----
|
|
1596
|
+
# Option definition phase methods
|
|
1597
|
+
#
|
|
1598
|
+
# These methods are used to define options, or to construct an
|
|
1599
|
+
# OptionParser instance in other words.
|
|
1600
|
+
|
|
1535
1601
|
# :call-seq:
|
|
1536
1602
|
# define(*params, &block)
|
|
1537
1603
|
#
|
|
@@ -1607,6 +1673,13 @@ XXX
|
|
|
1607
1673
|
top.append(string, nil, nil)
|
|
1608
1674
|
end
|
|
1609
1675
|
|
|
1676
|
+
# ----
|
|
1677
|
+
# Arguments parse phase methods
|
|
1678
|
+
#
|
|
1679
|
+
# These methods parse +argv+, convert, and store the results by
|
|
1680
|
+
# calling handlers. As these methods do not modify +self+, +self+
|
|
1681
|
+
# can be frozen.
|
|
1682
|
+
|
|
1610
1683
|
#
|
|
1611
1684
|
# Parses command line arguments +argv+ in order. When a block is given,
|
|
1612
1685
|
# each non-option argument is yielded. When optional +into+ keyword
|
|
@@ -1616,21 +1689,21 @@ XXX
|
|
|
1616
1689
|
#
|
|
1617
1690
|
# Returns the rest of +argv+ left unparsed.
|
|
1618
1691
|
#
|
|
1619
|
-
def order(*argv,
|
|
1692
|
+
def order(*argv, **keywords, &nonopt)
|
|
1620
1693
|
argv = argv[0].dup if argv.size == 1 and Array === argv[0]
|
|
1621
|
-
order!(argv,
|
|
1694
|
+
order!(argv, **keywords, &nonopt)
|
|
1622
1695
|
end
|
|
1623
1696
|
|
|
1624
1697
|
#
|
|
1625
1698
|
# Same as #order, but removes switches destructively.
|
|
1626
1699
|
# Non-option arguments remain in +argv+.
|
|
1627
1700
|
#
|
|
1628
|
-
def order!(argv = default_argv, into: nil, &nonopt)
|
|
1701
|
+
def order!(argv = default_argv, into: nil, **keywords, &nonopt)
|
|
1629
1702
|
setter = ->(name, val) {into[name.to_sym] = val} if into
|
|
1630
|
-
parse_in_order(argv, setter, &nonopt)
|
|
1703
|
+
parse_in_order(argv, setter, **keywords, &nonopt)
|
|
1631
1704
|
end
|
|
1632
1705
|
|
|
1633
|
-
def parse_in_order(argv = default_argv, setter = nil, &nonopt) # :nodoc:
|
|
1706
|
+
def parse_in_order(argv = default_argv, setter = nil, exact: require_exact, **, &nonopt) # :nodoc:
|
|
1634
1707
|
opt, arg, val, rest = nil
|
|
1635
1708
|
nonopt ||= proc {|a| throw :terminate, a}
|
|
1636
1709
|
argv.unshift(arg) if arg = catch(:terminate) {
|
|
@@ -1641,19 +1714,24 @@ XXX
|
|
|
1641
1714
|
opt, rest = $1, $2
|
|
1642
1715
|
opt.tr!('_', '-')
|
|
1643
1716
|
begin
|
|
1644
|
-
|
|
1645
|
-
|
|
1646
|
-
|
|
1647
|
-
|
|
1717
|
+
if exact
|
|
1718
|
+
sw, = search(:long, opt)
|
|
1719
|
+
else
|
|
1720
|
+
sw, = complete(:long, opt, true)
|
|
1648
1721
|
end
|
|
1649
1722
|
rescue ParseError
|
|
1650
1723
|
throw :terminate, arg unless raise_unknown
|
|
1651
1724
|
raise $!.set_option(arg, true)
|
|
1725
|
+
else
|
|
1726
|
+
unless sw
|
|
1727
|
+
throw :terminate, arg unless raise_unknown
|
|
1728
|
+
raise InvalidOption, arg
|
|
1729
|
+
end
|
|
1652
1730
|
end
|
|
1653
1731
|
begin
|
|
1654
|
-
opt, cb, val = sw.parse(rest, argv) {|*exc| raise(*exc)}
|
|
1655
|
-
val = cb
|
|
1656
|
-
setter
|
|
1732
|
+
opt, cb, *val = sw.parse(rest, argv) {|*exc| raise(*exc)}
|
|
1733
|
+
val = callback!(cb, 1, *val) if cb
|
|
1734
|
+
callback!(setter, 2, sw.switch_name, *val) if setter
|
|
1657
1735
|
rescue ParseError
|
|
1658
1736
|
raise $!.set_option(arg, rest)
|
|
1659
1737
|
end
|
|
@@ -1671,7 +1749,7 @@ XXX
|
|
|
1671
1749
|
val = arg.delete_prefix('-')
|
|
1672
1750
|
has_arg = true
|
|
1673
1751
|
rescue InvalidOption
|
|
1674
|
-
raise if
|
|
1752
|
+
raise if exact
|
|
1675
1753
|
# if no short options match, try completion with long
|
|
1676
1754
|
# options.
|
|
1677
1755
|
sw, = complete(:long, opt)
|
|
@@ -1683,7 +1761,7 @@ XXX
|
|
|
1683
1761
|
raise $!.set_option(arg, true)
|
|
1684
1762
|
end
|
|
1685
1763
|
begin
|
|
1686
|
-
opt, cb, val = sw.parse(val, argv) {|*exc| raise(*exc) if eq}
|
|
1764
|
+
opt, cb, *val = sw.parse(val, argv) {|*exc| raise(*exc) if eq}
|
|
1687
1765
|
rescue ParseError
|
|
1688
1766
|
raise $!.set_option(arg, arg.length > 2)
|
|
1689
1767
|
else
|
|
@@ -1691,8 +1769,8 @@ XXX
|
|
|
1691
1769
|
end
|
|
1692
1770
|
begin
|
|
1693
1771
|
argv.unshift(opt) if opt and (!rest or (opt = opt.sub(/\A-*/, '-')) != '-')
|
|
1694
|
-
val = cb
|
|
1695
|
-
setter
|
|
1772
|
+
val = callback!(cb, 1, *val) if cb
|
|
1773
|
+
callback!(setter, 2, sw.switch_name, *val) if setter
|
|
1696
1774
|
rescue ParseError
|
|
1697
1775
|
raise $!.set_option(arg, arg.length > 2)
|
|
1698
1776
|
end
|
|
@@ -1718,6 +1796,17 @@ XXX
|
|
|
1718
1796
|
end
|
|
1719
1797
|
private :parse_in_order
|
|
1720
1798
|
|
|
1799
|
+
# Calls callback with _val_.
|
|
1800
|
+
def callback!(cb, max_arity, *args) # :nodoc:
|
|
1801
|
+
if (size = args.size) < max_arity and cb.to_proc.lambda?
|
|
1802
|
+
(arity = cb.arity) < 0 and arity = (1-arity)
|
|
1803
|
+
arity = max_arity if arity > max_arity
|
|
1804
|
+
args[arity - 1] = nil if arity > size
|
|
1805
|
+
end
|
|
1806
|
+
cb.call(*args)
|
|
1807
|
+
end
|
|
1808
|
+
private :callback!
|
|
1809
|
+
|
|
1721
1810
|
#
|
|
1722
1811
|
# Parses command line arguments +argv+ in permutation mode and returns
|
|
1723
1812
|
# list of non-option arguments. When optional +into+ keyword
|
|
@@ -1725,18 +1814,18 @@ XXX
|
|
|
1725
1814
|
# <code>[]=</code> method (so it can be Hash, or OpenStruct, or other
|
|
1726
1815
|
# similar object).
|
|
1727
1816
|
#
|
|
1728
|
-
def permute(*argv,
|
|
1817
|
+
def permute(*argv, **keywords)
|
|
1729
1818
|
argv = argv[0].dup if argv.size == 1 and Array === argv[0]
|
|
1730
|
-
permute!(argv,
|
|
1819
|
+
permute!(argv, **keywords)
|
|
1731
1820
|
end
|
|
1732
1821
|
|
|
1733
1822
|
#
|
|
1734
1823
|
# Same as #permute, but removes switches destructively.
|
|
1735
1824
|
# Non-option arguments remain in +argv+.
|
|
1736
1825
|
#
|
|
1737
|
-
def permute!(argv = default_argv,
|
|
1826
|
+
def permute!(argv = default_argv, **keywords)
|
|
1738
1827
|
nonopts = []
|
|
1739
|
-
order!(argv,
|
|
1828
|
+
order!(argv, **keywords, &nonopts.method(:<<))
|
|
1740
1829
|
argv[0, 0] = nonopts
|
|
1741
1830
|
argv
|
|
1742
1831
|
end
|
|
@@ -1748,20 +1837,20 @@ XXX
|
|
|
1748
1837
|
# values are stored there via <code>[]=</code> method (so it can be Hash,
|
|
1749
1838
|
# or OpenStruct, or other similar object).
|
|
1750
1839
|
#
|
|
1751
|
-
def parse(*argv,
|
|
1840
|
+
def parse(*argv, **keywords)
|
|
1752
1841
|
argv = argv[0].dup if argv.size == 1 and Array === argv[0]
|
|
1753
|
-
parse!(argv,
|
|
1842
|
+
parse!(argv, **keywords)
|
|
1754
1843
|
end
|
|
1755
1844
|
|
|
1756
1845
|
#
|
|
1757
1846
|
# Same as #parse, but removes switches destructively.
|
|
1758
1847
|
# Non-option arguments remain in +argv+.
|
|
1759
1848
|
#
|
|
1760
|
-
def parse!(argv = default_argv,
|
|
1849
|
+
def parse!(argv = default_argv, **keywords)
|
|
1761
1850
|
if ENV.include?('POSIXLY_CORRECT')
|
|
1762
|
-
order!(argv,
|
|
1851
|
+
order!(argv, **keywords)
|
|
1763
1852
|
else
|
|
1764
|
-
permute!(argv,
|
|
1853
|
+
permute!(argv, **keywords)
|
|
1765
1854
|
end
|
|
1766
1855
|
end
|
|
1767
1856
|
|
|
@@ -1784,7 +1873,7 @@ XXX
|
|
|
1784
1873
|
# # params[:bar] = "x" # --bar x
|
|
1785
1874
|
# # params[:zot] = "z" # --zot Z
|
|
1786
1875
|
#
|
|
1787
|
-
def getopts(*args, symbolize_names: false)
|
|
1876
|
+
def getopts(*args, symbolize_names: false, **keywords)
|
|
1788
1877
|
argv = Array === args.first ? args.shift : default_argv
|
|
1789
1878
|
single_options, *long_options = *args
|
|
1790
1879
|
|
|
@@ -1812,7 +1901,7 @@ XXX
|
|
|
1812
1901
|
end
|
|
1813
1902
|
end
|
|
1814
1903
|
|
|
1815
|
-
parse_in_order(argv, result.method(:[]=))
|
|
1904
|
+
parse_in_order(argv, result.method(:[]=), **keywords)
|
|
1816
1905
|
symbolize_names ? result.transform_keys(&:to_sym) : result
|
|
1817
1906
|
end
|
|
1818
1907
|
|
|
@@ -1881,6 +1970,9 @@ XXX
|
|
|
1881
1970
|
DidYouMean.formatter.message_for(all_candidates & checker.correct(opt))
|
|
1882
1971
|
end
|
|
1883
1972
|
|
|
1973
|
+
#
|
|
1974
|
+
# Return candidates for +word+.
|
|
1975
|
+
#
|
|
1884
1976
|
def candidate(word)
|
|
1885
1977
|
list = []
|
|
1886
1978
|
case word
|
|
@@ -1922,10 +2014,10 @@ XXX
|
|
|
1922
2014
|
# The optional +into+ keyword argument works exactly like that accepted in
|
|
1923
2015
|
# method #parse.
|
|
1924
2016
|
#
|
|
1925
|
-
def load(filename = nil,
|
|
2017
|
+
def load(filename = nil, **keywords)
|
|
1926
2018
|
unless filename
|
|
1927
2019
|
basename = File.basename($0, '.*')
|
|
1928
|
-
return true if load(File.expand_path(basename, '~/.options'),
|
|
2020
|
+
return true if load(File.expand_path(basename, '~/.options'), **keywords) rescue nil
|
|
1929
2021
|
basename << ".options"
|
|
1930
2022
|
return [
|
|
1931
2023
|
# XDG
|
|
@@ -1937,11 +2029,11 @@ XXX
|
|
|
1937
2029
|
'~/config/settings',
|
|
1938
2030
|
].any? {|dir|
|
|
1939
2031
|
next if !dir or dir.empty?
|
|
1940
|
-
load(File.expand_path(basename, dir),
|
|
2032
|
+
load(File.expand_path(basename, dir), **keywords) rescue nil
|
|
1941
2033
|
}
|
|
1942
2034
|
end
|
|
1943
2035
|
begin
|
|
1944
|
-
parse(*File.readlines(filename, chomp: true),
|
|
2036
|
+
parse(*File.readlines(filename, chomp: true), **keywords)
|
|
1945
2037
|
true
|
|
1946
2038
|
rescue Errno::ENOENT, Errno::ENOTDIR
|
|
1947
2039
|
false
|
|
@@ -1954,10 +2046,10 @@ XXX
|
|
|
1954
2046
|
#
|
|
1955
2047
|
# +env+ defaults to the basename of the program.
|
|
1956
2048
|
#
|
|
1957
|
-
def environment(env = File.basename($0, '.*'))
|
|
2049
|
+
def environment(env = File.basename($0, '.*'), **keywords)
|
|
1958
2050
|
env = ENV[env] || ENV[env.upcase] or return
|
|
1959
2051
|
require 'shellwords'
|
|
1960
|
-
parse(*Shellwords.shellwords(env))
|
|
2052
|
+
parse(*Shellwords.shellwords(env), **keywords)
|
|
1961
2053
|
end
|
|
1962
2054
|
|
|
1963
2055
|
#
|
|
@@ -2123,6 +2215,7 @@ XXX
|
|
|
2123
2215
|
# Reason which caused the error.
|
|
2124
2216
|
Reason = 'parse error'
|
|
2125
2217
|
|
|
2218
|
+
# :nodoc:
|
|
2126
2219
|
def initialize(*args, additional: nil)
|
|
2127
2220
|
@additional = additional
|
|
2128
2221
|
@arg0, = args
|
|
@@ -2273,19 +2366,19 @@ XXX
|
|
|
2273
2366
|
# Parses +self+ destructively in order and returns +self+ containing the
|
|
2274
2367
|
# rest arguments left unparsed.
|
|
2275
2368
|
#
|
|
2276
|
-
def order!(&blk) options.order!(self, &blk) end
|
|
2369
|
+
def order!(**keywords, &blk) options.order!(self, **keywords, &blk) end
|
|
2277
2370
|
|
|
2278
2371
|
#
|
|
2279
2372
|
# Parses +self+ destructively in permutation mode and returns +self+
|
|
2280
2373
|
# containing the rest arguments left unparsed.
|
|
2281
2374
|
#
|
|
2282
|
-
def permute!() options.permute!(self) end
|
|
2375
|
+
def permute!(**keywords) options.permute!(self, **keywords) end
|
|
2283
2376
|
|
|
2284
2377
|
#
|
|
2285
2378
|
# Parses +self+ destructively and returns +self+ containing the
|
|
2286
2379
|
# rest arguments left unparsed.
|
|
2287
2380
|
#
|
|
2288
|
-
def parse!() options.parse!(self) end
|
|
2381
|
+
def parse!(**keywords) options.parse!(self, **keywords) end
|
|
2289
2382
|
|
|
2290
2383
|
#
|
|
2291
2384
|
# Substitution of getopts is possible as follows. Also see
|
|
@@ -2298,8 +2391,8 @@ XXX
|
|
|
2298
2391
|
# rescue OptionParser::ParseError
|
|
2299
2392
|
# end
|
|
2300
2393
|
#
|
|
2301
|
-
def getopts(*args, symbolize_names: false)
|
|
2302
|
-
options.getopts(self, *args, symbolize_names: symbolize_names)
|
|
2394
|
+
def getopts(*args, symbolize_names: false, **keywords)
|
|
2395
|
+
options.getopts(self, *args, symbolize_names: symbolize_names, **keywords)
|
|
2303
2396
|
end
|
|
2304
2397
|
|
|
2305
2398
|
#
|
|
@@ -2309,7 +2402,8 @@ XXX
|
|
|
2309
2402
|
super
|
|
2310
2403
|
obj.instance_eval {@optparse = nil}
|
|
2311
2404
|
end
|
|
2312
|
-
|
|
2405
|
+
|
|
2406
|
+
def initialize(*args) # :nodoc:
|
|
2313
2407
|
super
|
|
2314
2408
|
@optparse = nil
|
|
2315
2409
|
end
|
metadata
CHANGED
|
@@ -1,14 +1,14 @@
|
|
|
1
1
|
--- !ruby/object:Gem::Specification
|
|
2
2
|
name: optparse
|
|
3
3
|
version: !ruby/object:Gem::Version
|
|
4
|
-
version: 0.
|
|
4
|
+
version: 0.5.0
|
|
5
5
|
platform: ruby
|
|
6
6
|
authors:
|
|
7
7
|
- Nobu Nakada
|
|
8
8
|
autorequire:
|
|
9
9
|
bindir: exe
|
|
10
10
|
cert_chain: []
|
|
11
|
-
date:
|
|
11
|
+
date: 2024-04-15 00:00:00.000000000 Z
|
|
12
12
|
dependencies: []
|
|
13
13
|
description: OptionParser is a class for command-line option analysis.
|
|
14
14
|
email:
|
|
@@ -17,12 +17,16 @@ executables: []
|
|
|
17
17
|
extensions: []
|
|
18
18
|
extra_rdoc_files: []
|
|
19
19
|
files:
|
|
20
|
+
- ".document"
|
|
21
|
+
- ".rdoc_options"
|
|
20
22
|
- COPYING
|
|
21
23
|
- ChangeLog
|
|
22
24
|
- README.md
|
|
25
|
+
- doc/optparse/.document
|
|
23
26
|
- doc/optparse/argument_converters.rdoc
|
|
24
27
|
- doc/optparse/creates_option.rdoc
|
|
25
28
|
- doc/optparse/option_params.rdoc
|
|
29
|
+
- doc/optparse/ruby/argument_abbreviation.rb
|
|
26
30
|
- doc/optparse/ruby/argument_keywords.rb
|
|
27
31
|
- doc/optparse/ruby/argument_strings.rb
|
|
28
32
|
- doc/optparse/ruby/argv.rb
|
|
@@ -115,7 +119,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
|
|
|
115
119
|
- !ruby/object:Gem::Version
|
|
116
120
|
version: '0'
|
|
117
121
|
requirements: []
|
|
118
|
-
rubygems_version: 3.5.
|
|
122
|
+
rubygems_version: 3.5.3
|
|
119
123
|
signing_key:
|
|
120
124
|
specification_version: 4
|
|
121
125
|
summary: OptionParser is a class for command-line option analysis.
|