2022-04-24 15:27:09 +02:00
|
|
|
# Musique interpreter
|
2022-04-24 16:13:02 +02:00
|
|
|
|
2022-05-08 18:20:44 +02:00
|
|
|
Interpreter języka Musique. Możliwy do wykorzystywania jako:
|
|
|
|
|
|
|
|
- biblioteka interpretera języka dołączana do innego projektu (podobnie jak Lua);
|
|
|
|
- REPL działający w systemie GNU/Linux + ALSA wykonujący język Musique.
|
|
|
|
|
2022-05-02 22:12:29 +02:00
|
|
|
## Dostępne komendy
|
|
|
|
|
2022-05-21 23:11:04 +02:00
|
|
|
- `make` - Buduje interpreter `bin/musique` (tryb release)
|
|
|
|
- `make debug` - Buduje interpreter `bin/debug/musique` (tryb debug)
|
2022-05-02 22:12:29 +02:00
|
|
|
- `make clean` - Usuwa reprodukowalne elementy projektu (automatycznie stworzone pliki binarne czy raporty)
|
2022-05-08 18:20:44 +02:00
|
|
|
|
|
|
|
### Dokumentacja
|
|
|
|
|
|
|
|
- `make doc` - Tworzy `doc/build/html/` zawierający dokumentację projektu
|
|
|
|
|
|
|
|
### Testowanie
|
|
|
|
|
2022-05-22 06:33:17 +02:00
|
|
|
- `make test` - Uruchom wszystkie dostępne testy automatyczne
|
2022-05-02 22:12:29 +02:00
|
|
|
- `make unit-tests` - Uruchamia testy jednostkowe interpretera
|
2022-05-08 18:20:44 +02:00
|
|
|
- `make unit-test-coverage` - Uruchamia raport pokrycia kodu przez testy jednostkowe
|
2022-05-22 06:07:24 +02:00
|
|
|
- `etc/tools/test.py test examples` - Uruchamia testy zachowań przykładów
|
|
|
|
- `etc/tools/test.py record examples` - Nagrywa testy zachowań przykładów
|
|
|
|
|
|
|
|
### Debugowanie
|
|
|
|
|
|
|
|
- `etc/tools/log-function-calls.sh` - Tworzy listę wywołań funkcji używając GDB
|
2022-05-02 22:12:29 +02:00
|
|
|
|
2022-04-24 16:13:02 +02:00
|
|
|
## Budowa projektu
|
|
|
|
|
|
|
|
```
|
|
|
|
.
|
|
|
|
├── bin Miejsce produkcji plików wykonywalnych
|
2022-05-08 18:20:44 +02:00
|
|
|
├── coverage
|
2022-04-24 16:13:02 +02:00
|
|
|
├── doc Dokumentacja języka, interpretera
|
2022-05-08 18:20:44 +02:00
|
|
|
│ ├── build Miejsce produkcji dokumentacji
|
|
|
|
│ └── source Źródła dokumentacji Sphinx
|
2022-05-22 06:07:24 +02:00
|
|
|
├── etc/tools Dodatkowe narzędzia
|
2022-04-24 16:13:02 +02:00
|
|
|
├── lib Zewnętrzne zależności projektu
|
|
|
|
│ ├── expected
|
|
|
|
│ └── ut
|
|
|
|
└── src Główny katalog z kodem źródłowym
|
|
|
|
└── tests Katalog z testami jednostkowymi
|
|
|
|
```
|
2022-05-22 15:53:39 +02:00
|
|
|
|
|
|
|
## Kolorowanie składni
|
|
|
|
|
|
|
|
### Vim / Neovim
|
|
|
|
|
|
|
|
Skopiuj plik [etc/editor/musique.vim](etc/editor/musique.vim) do folderu `syntax` wewnątrz twojej konfiguracji Vima (Neovima). Np:
|
|
|
|
|
|
|
|
```console
|
|
|
|
$ cp etc/editor/musique.vim ~/.config/nvim/syntax/
|
|
|
|
```
|
|
|
|
|
|
|
|
Następnie musisz dodać ustawienie typu pliku na podstawie rozszerzenia wewnątrz twojej konfiguracji:
|
|
|
|
|
|
|
|
```vim
|
|
|
|
au BufRead,BufNewFile *.mq set filetype=musique
|
|
|
|
```
|