tsdl 1.1.0

A downloader/builder of many tree-sitter parsers
Documentation 
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

# TSDL

[![CI badge]][CI]
[![crates.io badge]][crates.io]

[CI]: https://github.com/stackmystack/tsdl/actions/workflows/ci.yml
[CI badge]: https://github.com/stackmystack/tsdl/actions/workflows/ci.yml/badge.svg
[crates.io]: https://crates.io/crates/tsdl
[crates.io badge]: https://img.shields.io/crates/v/tsdl.svg

A downloader/builder of many
[tree-sitter](https://github.com/tree-sitter/tree-sitter) parsers

## Why?

To build parsers (`.so`/`.dylib`) and use them with your favourite bindings.

I created it more specifically for the [ruby bindings](https://github.com/Faveod/ruby-tree-sitter).

## Installation

You can either grab the binary for your platform from
[`tsdl`'s releases](https://github.com/stackmystack/tsdl/releases/latest)
or install via cargo:

```sh
cargo install tsdl
```

## Usage

To build a parser:

```sh
tsdl build rust
```

To build many parsers:

```sh
tsdl build rust ruby json
```

If a configuration file (`parsers.toml`) is provided, then simply running:

```sh
tsdl build
```

will download all the pinned parsers.

## Configuration

If no configuration is provided for the language you're asking for in `parsers.toml`,
the latest parsers will be downloaded built.

If you wish to pin parser versions:

```toml
[parsers]
java = "v0.21.0"
json = "0.21.0" # The leading v is not necessary
python = "master"
typescript = { ref = "0.21.0", cmd = "make" }
cobol = { ref = "6a469068cacb5e3955bb16ad8dfff0dd792883c9", from = "https://github.com/yutaro-sakamoto/tree-sitter-cobol" }
```

Run:

```sh
tsdl config
```

for more info.