Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/evref-bl/pharo-tree-sitter
https://github.com/evref-bl/pharo-tree-sitter
Last synced: 28 days ago
JSON representation
- Host: GitHub
- URL: https://github.com/evref-bl/pharo-tree-sitter
- Owner: Evref-BL
- Created: 2024-08-17T14:14:33.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2024-11-21T16:06:59.000Z (about 1 month ago)
- Last Synced: 2024-11-21T16:26:26.380Z (about 1 month ago)
- Language: Smalltalk
- Size: 48.8 KB
- Stars: 6
- Watchers: 2
- Forks: 1
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Pharo tree-sitter
[](https://github.com/Evref-BL/Pharo-Tree-Sitter/actions/workflows/ci.yml)
[](https://coveralls.io/github/Evref-BL/Pharo-Tree-Sitter?branch=main)
This is a binding to tree-sitter from Pharo.
It allows one to perform analysis or highlight code using an existing tree sitter parser made by the community
## Installation
You have to install the binding in Pharo **as well as** the tree-sitter dependencies.
The dependencies are:
- The shared core library tree-sitters (e.g. _libtree-sitter.dylib_)
- The shared parser library of the language, built using tree-sitter CLI (e.g. _python.dylib_). [tree-sitter tutorial here](https://tree-sitter.github.io/tree-sitter/creating-parsers)
```st
Metacello new
baseline: 'TreeSitter';
repository: 'github://Evref-BL/Pharo-Tree-Sitter:main/src';
load.
```
### MacOS
We recommand you to download the tree-sitter core library using HomeBrew
```sh
brew install tree-sitter
```
Then, locate the `libtree-sitter.dylib` under the path `/opt/homebrew/Cellar/tree-sitter/0.x.x/lib/libtree-sitter.dylib`
Finally, check the possible lib location detected by Pharo using `FFIMacLibraryFinder new paths` in a playground. Both the core library and the parser library should be under any of these paths. Please move them their.
For instance, move your `python.dylib` under `/Pharo/vms/110-x64/Pharo.app/Contents/Resources/lib/`
### Windows
#### Tree-Sitter Shared library
To build the shared library for tree-sitter, you can follow the following script:
```sh
# assuming git, gcc, cmake, ninja installed via scoop
git clone https://github.com/tree-sitter/tree-sitter
git fetch origin v0.24.3
git checkout v0.24.3
cd tree-sitter
cd lib
mkdir build
cd build
cmake -G Ninja ..
ninja
```
Then move the `libtree-sitter.dll` file under the **VM** folder of Pharo.
### Archlinux
The tree-sitter libs are available in the extra repository.
So you only have to install tree-sitter and the grammar you wanna use with your package manager.
```sh
yay tree-sitter tree-sitter-grammars
```
## Quick Example
```st
parser := TSParser new.
pythonLanguage := TSLanguage python.
parser language: pythonLanguage.
string := 'print("Hello, I''m Python!") # comment'.
tree := parser parseString: string.
tree rootNode
```