Skip to content

Commit

Permalink
Merge branch 'release/0.9.1'
Browse files Browse the repository at this point in the history
  • Loading branch information
artbear committed Apr 17, 2017
2 parents ace1626 + 698a0a5 commit ea20b0b
Show file tree
Hide file tree
Showing 12 changed files with 338 additions and 70 deletions.
28 changes: 15 additions & 13 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@
Описание
===

Библиотека `oscript.io` для автоматизации различных операции для работы с `cf/cfe/epf` файлами и простой запуск `vanessa-behavior` и `xunitfor1c` тестов.
Библиотека `oscript.io` для автоматизации различных операции для работы с `cf/cfe/epf` файлами и простой запуск `vanessa-behavior` и `xunitfor1c` тестов.

Предназначена для организации разработки 1С в режиме когда работа в git идет напрямую с исходниками.

Expand All @@ -19,7 +19,7 @@

используйте пакетный менеджер `opm` из стандартной поставки дистрибутива `ocript.io`

```
```cmd
opm install vanessa-runner
```

Expand All @@ -29,26 +29,28 @@ opm install vanessa-runner
Использование
===

Основной код сосредоточен в `tools/runner.os` , ключ `--help` покажет справку по параметрам.
Основной код сосредоточен в `src/main.os` , ключ `help` покажет справку по параметрам.

```cmd
runner help
```
runner --help
```

В папке tools так же расположенны примеры bat файлов для легкого запуска определенных действий.
В папке tools так же расположены примеры bat файлов для легкого запуска определенных действий.
Основной принцип - запустили bat файл с настроенными командами и получили результат.

К папке epf несколько обработок позволяющих упростить деплой для конфигураций основанных на БСП.
К папке epf несколько обработок позволяющих упростить деплой для конфигураций основанных на БСП.

Основной пример это передача через параметры /C комманды "ЗапуститьОбновлениеИнформационнойБазы;ЗавершитьРаботуСистемы" и одновременно выполняем через /Execute"ЗакрытьПредприятие.epf", т.е. при запуске с такими ключами подключается обработчик ожидания проверят наличие формы с заголовком обновление и при окончании обновления завершает предприятие. Данное действие необходимо, для полного обновления предприятия, пока действует блокировка на фоновые задачи и запуск пользователей.
Основной пример это передача через параметры /C команды "ЗапуститьОбновлениеИнформационнойБазы;ЗавершитьРаботуСистемы" и одновременно выполняем через /Execute"ЗакрытьПредприятие.epf", т.е. при запуске с такими ключами подключается обработчик ожидания проверят наличие формы с заголовком обновление и при окончании обновления завершает предприятие. Данное действие необходимо, для полного обновления предприятия, пока действует блокировка на фоновые задачи и запуск пользователей.

**ЗагрузитьРасширение** позволяет подключать разрешение в режиме предприятия и получать результат ошибки. Предназначенно для подключения в конфигурациях основаных на БСП. В параметрах /C передается путь к расширению и путь к файлу лога подключения.
**ЗагрузитьВнешниеОбработки** позволяет загрузить все внешние обработки и подключить в справочник "Дополнительные отчеты и обработки", т.к. их очень много то первым параметром идет каталог, вторым параметром путь к файлу лога. Все обработки обновляются согласно версиям.
+ **ЗагрузитьРасширение** позволяет подключать разрешение в режиме предприятия и получать результат ошибки. Предназначено для подключения в конфигурациях, основанных на БСП. В параметрах /C передается путь к расширению и путь к файлу лога подключения.
+ **ЗагрузитьВнешниеОбработки** позволяет загрузить все внешние обработки и подключить в справочник "Дополнительные отчеты и обработки", т.к. их очень много то первым параметром идет каталог, вторым параметром путь к файлу лога. Все обработки обновляются согласно версиям.

Сборка
===

Для сборки обработок необходимо иметь установленный oscript в переменной PATH и платформу выше 8.3.8 , в коммандной строке перейти в каталог с проектом и выполнить ```tools\compile_epf.bat``` по окончанию в каталоге build\epf должны появиться обработки.
Вся разработка в конфигураторе делается в каталоге build, по окончанию доработок запускаем ```tools\decompile_epf.bat```
Для сборки обработок необходимо иметь установленный oscript в переменной PATH и платформу выше 8.3.8

В командной строке нужно перейти в каталог с проектом и выполнить ```tools\compile_epf.bat```, по окончанию в каталоге build\epf должны появиться обработки.
Вся разработка в конфигураторе делается в каталоге build, по окончанию доработок запускаем ```tools\decompile_epf.bat```

Обязательно наличине установленного v8unpack версии не ниже 3.0.38 в переменной PATH. Установку можно взять https://github.com/dmpas/v8unpack#build
Обязательно наличие установленного v8unpack версии не ниже 3.0.38 в переменной PATH. Установку можно взять https://github.com/dmpas/v8unpack#build
44 changes: 44 additions & 0 deletions features/ПроверкаСинтаксиса.feature
Original file line number Diff line number Diff line change
@@ -0,0 +1,44 @@
# language: ru

Функционал: Проверка синтаксиса
Как Разработчик/Инженер по тестированию
Я Хочу иметь возможность автоматической проверки синтаксиса конфигурации
Чтобы удостовериться в качестве подготовленной конфигурации

Контекст:
Допустим я подготовил репозиторий и рабочий каталог проекта
И я подготовил рабочую базу проекта "./build/ib" по умолчанию

Сценарий: Синтаксическая проверка временной файловой базы
# Допустим я включаю отладку лога с именем "oscript.app.vanessa-runner"
Допустим Я очищаю параметры команды "oscript" в контексте

Когда Я добавляю параметр "<КаталогПроекта>/src/main.os syntax-check" для команды "oscript"
И Я добавляю параметр "--ibname /Fbuild/ib" для команды "oscript"
И Я добавляю параметр "--mode -ThinClient -WebClient -Server -ExternalConnection -ThickClientOrdinaryApplication" для команды "oscript"
Когда Я выполняю команду "oscript"
# И Я сообщаю вывод команды "oscript"
Тогда Вывод команды "oscript" содержит
# | /CheckConfig -ThinClient -WebClient -Server -ExternalConnection -ThickClientOrdinaryApplication |
| Результат синтакс-контроля: Ошибок не обнаружено |

И Код возврата команды "oscript" равен 0
# Тогда в лог-файле запуска продукта есть строка 'testsuite name="Синтаксическая проверка конфигурации"'

Сценарий: Синтаксическая проверка временной файловой базы c результатами в формате JUnit
# Допустим я включаю отладку лога с именем "oscript.app.vanessa-runner"
Допустим Я очищаю параметры команды "oscript" в контексте

Когда Я добавляю параметр "<КаталогПроекта>/src/main.os syntax-check" для команды "oscript"
И Я добавляю параметр "--junitpath junit.xml" для команды "oscript"
И Я добавляю параметр "--ibname /Fbuild/ib" для команды "oscript"
И Я добавляю параметр "--mode -ThinClient -WebClient -Server -ExternalConnection -ThickClientOrdinaryApplication" для команды "oscript"
Когда Я выполняю команду "oscript"
# И Я сообщаю вывод команды "oscript"
Тогда Вывод команды "oscript" содержит
# | /CheckConfig -ThinClient -WebClient -Server -ExternalConnection -ThickClientOrdinaryApplication |
| Результат синтакс-контроля: Ошибок не обнаружено |
| Сформированы результаты проверки в формате JUnit.xml - junit.xml |

И Код возврата команды "oscript" равен 0
# Тогда в лог-файле запуска продукта есть строка 'testsuite name="Синтаксическая проверка конфигурации"'
27 changes: 17 additions & 10 deletions features/ПростыеКоманды.feature
Original file line number Diff line number Diff line change
Expand Up @@ -17,22 +17,29 @@
И Код возврата команды "oscript" равен 0

Сценарий: Получение помощи продукта
Когда Я выполняю команду "oscript" c параметрами "src/main.os --help"
Когда Я выполняю команду "oscript" c параметрами "src/main.os help"
И Вывод команды "oscript" содержит "vanessa-runner v"
И Вывод команды "oscript" содержит
# | Возможные команды: |
# | --help - Вывод справки по параметрам |
# | version - Выводить версию приложения|
# | общие для всех параметры |
# | --v8version Маска версии платформы (8.3, 8.3.5, 8.3.6.2299 и т.п.) |
# | --ibname [env RUNNER_IBNAME] строка подключения к базе данных |
# | --db-user [env RUNNER_DBUSER] имя пользователя для подключения к базе |
# Возможные команды:
"""
Возможные команды:
help - Вывод справки по параметрам
--help - Вывод справки по параметрам
version - Выводить версию приложения
"""
И Вывод команды "oscript" содержит
"""
общие для всех параметры
--v8version Маска версии платформы (8.3, 8.3.5, 8.3.6.2299 и т.п.)
общие для xunit, vaness, tests, compilecurrent, decompilecurrent, run, dbupdate
--ibname строка подключения к базе данных
--db-user имя пользователя для подключения к базе
--db-pwd пароль пользователя
--ibname [env RUNNER_IBNAME] строка подключения к базе данных
--db-user [env RUNNER_DBUSER] имя пользователя для подключения к базе
--db-pwd [env RUNNER_DBPWD] пароль пользователя
"""
И Код возврата команды "oscript" равен 0

Expand All @@ -44,17 +51,17 @@
"""
ОШИБКА - Некорректные аргументы командной строки
Возможные команды:
help - Вывод справки по параметрам
--help - Вывод справки по параметрам
version - Выводить версию приложения
"""
И Вывод команды "oscript" содержит
"""
общие для всех параметры
--v8version Маска версии платформы (8.3, 8.3.5, 8.3.6.2299 и т.п.)
общие для xunit, vaness, tests, compilecurrent, decompilecurrent, run, dbupdate
--ibname строка подключения к базе данных
--db-user имя пользователя для подключения к базе
--db-pwd пароль пользователя
--ibname [env RUNNER_IBNAME] строка подключения к базе данных
--db-user [env RUNNER_DBUSER] имя пользователя для подключения к базе
--db-pwd [env RUNNER_DBPWD] пароль пользователя
"""
И Код возврата команды "oscript" равен 1

Expand Down
2 changes: 2 additions & 0 deletions features/РазборкаОбработок.feature
Original file line number Diff line number Diff line change
Expand Up @@ -11,10 +11,12 @@
И Я копирую файл "fixture.epf" из каталога "tests/fixtures" проекта в подкаталог "build/out" рабочего каталога

Допустим каталог "epf" не существует
И Я очищаю параметры команды "oscript" в контексте

Сценарий: Разборка одной внешней обработки с временной базой

Когда Я выполняю команду "oscript" c параметрами "<КаталогПроекта>/src/main.os decompileepf build/out/fixture.epf epf"
# И Я сообщаю вывод команды "oscript"
Тогда Код возврата команды "oscript" равен 0
И Вывод команды "oscript" содержит "Разбираю внешнюю обработку build\out\fixture.epf на исходники в каталог epf"
И файл "epf/fixture/Тест1.xml" существует
Expand Down
2 changes: 1 addition & 1 deletion packagedef
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@
.ЗависитОт("json", "0.2.1")
.ЗависитОт("1commands", "1.1.1")
.ЗависитОт("1bdd", "1.4")
.ЗависитОт("fs", "0.3")
.ЗависитОт("fs", "0.4")
.ВключитьФайл("tools")
.ВключитьФайл("src")
.ВключитьФайл("features")
Expand Down
Loading

0 comments on commit ea20b0b

Please sign in to comment.