1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
|
# CHANGELOG
## UNRELEASED
## Version 0.9.0:
### Changed
- BREAKING: Remove `magic` stuff.
When using docopt(): Now you must supply `docstring` explicitly,
and the `more_magic` option is removed.
The `magic()` and `magic_docopt()` functions are also removed.
I had several reasons for removing this:
1. It's not needed. In 99% of cases you can just supply __doc__.
2. It is implicit and too magical, encouraging code that is hard to
reason about.
3. It's brittle. See https://github.com/jazzband/docopt-ng/issues/49
4. It is different from the spec outlined on docopt.org. I want them
to be more aligned, because it isn't
obvious to users that these two might be out of sync.
(no one seems to have control of that documentation site)
5. It fills in args in the calling scope???! We just returned
the parsed result, just set it manually!
6. It should be easy to migrate to this new version, and I don't think
I've broken many people.
7. It is out of scope. This library does one thing really well, and that
is parsing the docstring. You can use the old code as an example if
you want to re-create the magic.
- Tweak a few things to restore compatibility with docopt (the original repo) 0.6.2
See PR https://github.com/jazzband/docopt-ng/pull/36 for more info
1. BREAKING: Restore what constitutes an "option":
Now the important rule to follow is
`any line starting with - or -- is treated as an option`.
This means that some things that did NOT used to be treated
as options, now ARE treated as options:
1. lines before `usage:`
2. non-indented --options
3. lines not inside the options: section
However, we also keep one part of the old behavior of this fork where in the line
`header that ends with the keyword options: --foo`, --foo is still treated as
an option because the start of a line up to `options:` is ignored.
2. BREAKING: Error messages are tweaked a little bit. Unlikely that you relied
on them, but just in case.
3. NONBREAKING: Now allow for blank lines between options.
As described in https://github.com/jazzband/docopt-ng/issues/33
4. NONBREAKING: Fix an unlikely edge case of how options are parsed:
Here, --foo was interpreted to take "Enable" as an argument
```
options:
--foo
Enable the foo behaviour. (One space before "Enable")
```
Whereas here, Enable was interpreted as part of the description.
```
options:
--foo
Enable the foo behaviour. (2 space before "Enable".)
```
Now, both of these examples are treated more intuitively, where Enable
is treated as the description
- (for devs) Switch to PDM as project manager
## Version 0.8.1:
- Fixup of auto release in Github Actions
## Version 0.8.0:
- Expose `DocoptExit` in `__all__`, let users to raise DocoptExit from their code
https://github.com/jazzband/docopt-ng/pull/8
- Fix magic with arguments that have a dash https://github.com/jazzband/docopt-ng/pull/6
- Add `py.typed` so now users can actuall use mypy with us!
https://github.com/jazzband/docopt-ng/commit/de7c861dafb86418da423d4829f389a62c82151a
- Migrate to being maintained by Jazzband!
- Migrate to GitHub actions from TravisCI
- Update and tweak many little things in build, testing, and docs
## Version 0.7.2:
- Complete MyPy typehints - ZERO errors.
Required refactoring class implementations, adding typing stubs, but not changing tests. :)
- 100% code coverage. Required the addition of a few tests.
Removed unused codepaths. Tagged typing stubs `pragma: no cover` as they are definitionally exercised.
## Version 0.7.1:
- Add `magic()` and `magic_docopt()` aliases for `docopt()` allowing easier use of new features.
## Version 0.7.0:
- "MORE MAGIC"
- First argument is now optional - `docopt()` will look for `__doc__` defined in parent scopes.
- Dot access is supported on resulting `arguments` object,
ignoring angle brackets and leading dashes.
- `more_magic` parameter added to `docopt()` defaults False.
- If `more_magic` enabled, `arguments` variable created and populated
in calling scope with results.
- If `more_magic` enabled, fuzzy (levenshtein) autocorrect enabled for long-args.
- Lots of typehints.
- README moved to Markdown.
## Version 0.6.3:
- Catch up on \~two years of pull requests.
- Fork [docopt](https://github.com/docopt/docopt) to
[docopt-ng](https://github.com/bazaar-projects/docopt-ng).
- Add levenshtein based autocorrect from
[string-dist](https://github.com/obulkin/string-dist).
- Add better debug / error messages.
- Linting (via [black](https://github.com/ambv/black) and
[flake8](https://gitlab.com/pycqa/flake8)).
## Version 0.6.2:
- Bugfixes
## Version 0.6.1:
- Fix issue [\#85](https://github.com/docopt/docopt/issues/85) which
caused improper handling of `[options]` shortcut if it was present
several times.
## Version 0.6.0:
- New argument `options_first`, disallows interspersing options and
arguments. If you supply `options_first=True` to `docopt`, it will
interpret all arguments as positional arguments after first
positional argument.
- If option with argument could be repeated, its default value will
be interpreted as space-separated list. E.g. with
`[default: ./here ./there]` will be interpreted as
`['./here', './there']`.
|
