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
|
tree-sitter-ini
==================
This grammar implements the [INI format](https://en.wikipedia.org/wiki/INI_file).
Overview
--------
Example INI file:
```ini
[section 1]
some_key = some_value
another-key = another value
[another section]
# Keys may contain whitespace.
key 1 = value 1
# Value may be empty.
key_2 =
```
See [test/corpus/](./test/corpus/) for more examples.
Notes
-----
- Section name must appear on a line by itself.
- Equals sign (=) and semicolon (;) are [reserved characters](https://en.wikipedia.org/wiki/INI_file#Key-value_pairs)
and cannot appear in the key. Any whitespace surrounding the key is stripped.
- Comments (`;` or `#`) must start at column 1. Trailing comments are not supported yet. [#13](https://github.com/justinmk/tree-sitter-ini/issues/13)
- Duplicate names are not checked.
- Line continuations (`\`) are not supported.
- `setting_value` includes whitespace. [#3](https://github.com/justinmk/tree-sitter-ini/issues/3).
Should values exclude surrounding whitespace?
- [Quoted keys/values](https://en.wikipedia.org/wiki/INI_file#Quoted_values) are not supported yet.
- Escape sequences are not supported.
Reference
---------
- https://en.wikipedia.org/wiki/INI_file
- https://github.com/textmate/ini.tmbundle
Release
-------
Steps to perform a release:
1. Bump and tag the version (choose `patch`/`minor`/`major` as appropriate).
```
npm version patch -m "release %s"
```
2. Bump to prerelease, without creating a tag .
```
npm version --no-git-tag-version prerelease --preid dev && git add package*.json && git commit -m bump
```
3. Push.
```
git push --follow-tags
```
4. Release the tagged commit: https://github.com/justinmk/tree-sitter-ini/releases/new
|
