OneScript
OneScript copied to clipboard
EvilBeaver
Снижение порога вхождения
Обеспечить более простое вхождение в разработку на 1Script для "типового" 1С-ника. Максимально автоматизировать развертывание среды разработки, нарастить библиотеку примеров, и др.
Из письма:
Если взять рядового программиста 1с, без команды, где все в теме, или где нет прошаренных идейных людей - то он посмотрит и подумает - "как-нибудь потом" (сам так делал). Т.е. тепличному разработчику сложно бывает преодолеть порог вхождения и понять, что все вообще просто на самом деле.
Мне, например, некий пример (который актуализируется периодически) разворачивания окружения очень помог бы на странице http://oscript.io/docs (нашел среди относительно свежих на инфостарте https://infostart.ru/public/687869/, но и там не учитывались TasksApi , по-моему факи устарели по bsl https://github.com/xDrivenDevelopment/vsc-language-1c-bsl/wiki/Запуск-скриптов-.os-.bsl-с-помощью-OneScript)
Что-то вроде раздела
С чего начать/Для чайников/Попробовать
Быстрый старт.
1. устанавливаем oscript ссылка (далее-далее-далее)
2. релогон (для применения переменных среды)
3. cmd -> opm install-all (можно очень кратко объяснить зачем)
4. vsc
5. bsl
6. пример кода
7. Задачи:Выполнить задачу
Пример отладки
1.
2...
Пример использования библиотек
1.
2..
Ну вообщем как-то так..
Предлагаю держать свой установочник VSCode с плагином из-коробки, который сам при первом запуске установит ОдноСкрипт и всю стандартную библиотеку. Так делают, например, C++ и C# расширения VSCode.
А кто писал про wiki c запуском скриптов? переезд на TasksApi произошел только вчера, а уже кто-то уловил устаревшие доки? :D
Документация сейчас написана через Одина. Нужно переписать для людей.
Мои претензии таковы:
-
в разных местах упомянуты разные требования к минимально необходимой версии mono. Мне-то пофиг, но вот сам факт...
-
по исходнику класса компилятора можно догадаться, что в синтаксисе есть конструкция try-catch-finally. Но как её записывать не ясно, потому что в документации это не описано (и формального описания грамматики нет). Если что, 1С я не видел никогда. (ок, нашел пример в юнит-тестах, но без finally, это вызывает чувство тревоги за рефкаунтинговые ресурсы, которых нет)
Если что, 1С я не видел никогда.
@ArsenShnurkov если честно, то те, кто никогда не видел 1С, у нас не целевая аудитория. Хотя приятно, что есть интерес со стороны.
а ты знаешь, как делать такой установочник?
@EvilBeaver есть zip-вариант VSCode. На его основе можно сделать что-то вроде OneScript-portable.zip - включить в коробку расширения и локальный движок с библиотеками.
