https://github.com/otymko/jones

Engine OneScript on Java 😜
https://github.com/otymko/jones

hacktoberfest

Last synced: 7 months ago
JSON representation

Engine OneScript on Java 😜

• Host: GitHub
• URL: https://github.com/otymko/jones
• Owner: otymko
• License: mpl-2.0
• Created: 2021-06-07T14:13:26.000Z (over 4 years ago)
• Default Branch: develop
• Last Pushed: 2023-09-25T21:35:24.000Z (over 2 years ago)
• Last Synced: 2025-04-06T00:01:41.816Z (9 months ago)
• Topics: hacktoberfest
• Language: Java
• Homepage:
• Size: 908 KB
• Stars: 29
• Watchers: 7
• Forks: 4
• Open Issues: 55
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# Java OneScript (Jones)

Jones - реализация [OneScript](https://github.com/EvilBeaver/OneScript) на Java.

## Зачем?

Расширение программ на Java-подобных языках через скрипты OneScript.

## Как использовать?

### Запуск скрипта из консоли

```sh

java -jar /path/to/jonec-exec.jar /path/to/script.os

```

где:

* `/path/to/jonec-exec.jar` - путь к исполняемому файлу. Где найти? Самому собрать из исходников или посмотреть 

в релизах (если они есть).

* `/path/to/script.os` - путь к скрипту OneScript.

Например:

```sh

java -jar jonec-exec.jar my-script.os

```

### Подключение к приложению

#### Начальный пример

Скрипт `my-script.os`:

```bsl

Перем ЧислоИзМодуля

Процедура ВывестиЧисло()

    Сообщить(ЧислоИзМодуля);

КонецПроцедуры

ЧислоИзМодуля = 42;

```

Подключаем зависимость (собирается на JitPack)

`develop-SNAPSHOT` - тег, по которому берется версия с [JitPack](https://jitpack.io/#otymko/JOneS/). Тег может быть как

номер версии (если есть релизы), так и хеш коммита на GitHub.

Gradle:

```groovy

implementation group: 'com.github.otymko', name: 'JOneS', version: 'develop-SNAPSHOT'

```

Gradle (Kotlin):

```kotlin

implementation("com.github.otymko", "JOneS", "develop-SNAPSHOT")

```

```xml

    com.github.otymko

    JOneS

    develop-SNAPSHOT

```

Добавляем в приложение на Java:

```java

// Путь к скрипту на Jones

Path pathToScript = Path.of("/path/to/my-script.os");

// Инициализация движка

ScriptEngine engine = new ScriptEngine();

// Инициализация компилятора

ScriptCompiler compiler = new ScriptCompiler(engine);

// Компиляция скрипта с базовым типом "Сценарий"(UserScriptContext)

ModuleImage moduleImage = compiler.compile(pathToScript, UserScriptContext.class);

// Создаём экземпляр объекта Сценарий из скомпилированного скрипта

ScriptDrivenObject sdo = engine.newObject(moduleImage);

// Получаем индекс метода по его ммени

int methodId = sdo.getScriptMethod("ВывестиЧисло");

// Вызываем метод

sdo.callScriptMethod(engine, methodId, new IValue[0]);

```

После выполнения кода, будет выведено сообщение:

```

42

```

## Дорожная карта

Для начала, реализовать задачи на [Доска MVP](https://github.com/otymko/JOneS/projects/1) и выпустить релиз.

## Лицензия

Используется лицензия [Mozilla Public License Version 2.0](LICENSE)