Musique language interpreter
Go to file
2022-11-16 21:17:30 +01:00
doc Poprawki literówek i nomenklatury muzycznej 2022-11-16 21:17:30 +01:00
editor VSCode extension 2022-10-21 13:14:12 +02:00
examples switched index operation from 'a.n' to 'a[n]' 2022-10-31 00:31:47 +01:00
lib Moved from custom ALSA adapter to RtMidi 2022-10-08 12:48:42 +02:00
musique By default connect to existing MIDI port in repl 2022-11-13 23:26:06 +01:00
regression-tests regression test updates 2022-10-31 00:39:56 +01:00
scripts Release build system partially moved to Docker 2022-10-31 22:28:18 +01:00
.gitignore Basic polish tutorial 2022-11-12 01:25:16 +01:00
build_instructions.md First iteration of build instructions 2022-10-20 14:37:50 +02:00
CHANGELOG.md Basic polish tutorial 2022-11-12 01:25:16 +01:00
config.mk Build system supports both MacOS and Linux now 2022-10-14 15:56:36 +02:00
Dockerfile Release build system partially moved to Docker 2022-10-31 22:28:18 +01:00
Doxyfile Created better hierarchy of source files 2022-09-23 18:55:25 +02:00
instruments.mq instruments.mq using new definition syntax; fixed windows builds 2022-10-21 17:50:25 +02:00
LICENSE License 2022-05-24 12:11:50 +00:00
Makefile Basic polish tutorial 2022-11-12 01:25:16 +01:00
README.md VSCode extension 2022-10-21 13:14:12 +02:00

Musique interpreter

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.

Wymagane pakiety systemowe

Do poprawnego skompilowania i uruchomienia interpretera języka Musique należy posiadać zainstalowane następujące pakiety (lub ich odpowiedniki) dla systemu GNU/Linux Ubuntu Desktop 22.04 są to:

  • build-essential pakiet zawierający podstawowe narzędzia do pracy z kodem źródłowym, takie jak m.in. kompilator;
  • libasound2-dev pakiet zawierający biblioteki programistyczne pakietu libasound2.

Można je zainstalować korzystając z polecenia:

$ sudo apt update
$ sudo apt install -y build-essential libasound2-dev

Budowanie interpretera

  • Aby wybudować wersję Linux+ALSA: make
  • Aby wybudować wersję Windows: make os=windows

Żeby zainstalować interpreter języka Musique w systemie, należy dodatkowo wykonać polecenie:

# make install

Uwaga: powyższe polecenie instalacyjne musi zostać wykonane jako uprzywilejowany użytkownik (np. wykorzystując polecenie sudo).

Dostępne komendy

  • make - Buduje interpreter bin/musique (tryb release)
  • make debug - Buduje interpreter bin/debug/musique (tryb debug)
  • make clean - Usuwa reprodukowalne elementy projektu (automatycznie stworzone pliki binarne czy raporty)

Dokumentacja

  • make doc - Tworzy doc/build/html/ zawierający dokumentację projektu

Testowanie

  • make test - Uruchom wszystkie dostępne testy automatyczne

Kolorowanie składni

Vim / Neovim

Skopiuj plik etc/editor/musique.vim do folderu syntax wewnątrz twojej konfiguracji Vima (Neovima). Np:

$ cp editor/musique.vim ~/.config/nvim/syntax/

Następnie musisz dodać ustawienie typu pliku na podstawie rozszerzenia wewnątrz twojej konfiguracji:

au BufRead,BufNewFile *.mq set filetype=musique

Visual Studio Code

Skopiuj katalog editor/vscode-musique do folderu <user home>/.vscode/extensions i uruchom ponownie program VSCode.

Thanks to

and all contributors that created libraries above.