Vanessa Automation Driven Development

• Vanessa Automation Driven Development
  • Введение
  • Справка и полезные ссылки
  • Установка
  • Ночная сборка ветки develop:
  • Запросы функциональности, задачи, сообщения об ошибках:
  • Сравнение с другими инструментами тестирования
  • Как помочь проекту
  • Лицензии и права

Введение

Продукт Vanessa-ADD (Vanessa Automation Driven Development) (далее Vanessa-ADD) представляет собой набор инструментов для проверки качества решений на платформе 1С:Предприятие.

Vanessa-ADD is a set of testing tools for 1C:Enterprise 8 platform - Tests/behavior (TDD & BDD) for 1С:Enterprise.

Миссия продукта - повышение качества разработки.

Продукт позволяет проверять поведение различных систем на базе платформы 1С (в режимах совместимости >= 8.3.8 и частично от 8.2.16 до 8.3.7) и проверяет/гарантирует качество функциональности системы и ее составных частей на всем протяжении жизненного цикла системы.

Основной сценарий использования - реализация концепций TDD/BDD/CI в проектах на базе 1С

Возможности:

• готовые универсальные "дымовые тесты" различных видов
• различные виды тестирования (модульного/юнит, приемочного, сценарного для 1С 8.3, интеграционного, TDD)
• проверка поведения (BDD/Gherkin)
• формирование автодокументации в формате Html или Markdown или в виде видео-инструкций.

Vanessa-ADD является наследником 2-х продуктов - xUnitFor1C и Vanessa-Behavior. Совместимость с VB 1.Х и xUnitFor1C 4.Х гарантирована (за исключением функциональности циклов и условий в Vanessa-ADD)

Справка и полезные ссылки

Обязательно ознакомьтесь с:

• Документацией по продукту doc/README.md

• часто задаваемыми вопросами FAQ.md

• руководством контрибьютора CONTRIBUTING.md

• известными проблемами KNOWN-PROBLEMS.md

Установка

Порядок установки Vanessa-ADD:

Автоматическая установка (через установщик пакетов OneScript ):

• Выполнить opm install add
• После выполнения пакет будет установлен в каталог <УстановленныйOneScript>/lib/add

Автоматическая установка (при установке пакета vanessa-runner через установщик пакетов OneScript ):

• Выполнить opm install vanessa-runner
• После выполнения пакет будет установлен в каталог <УстановленныйOneScript>/lib/vanessa-runner

Ручная установка:

• Перейти в раздел релизы
• Скачать архив add-x.x.x.zip с последним стабильным релизом - прямая ссылка Releases
• Распаковать указанный архив в нужную папку.

Ночная сборка ветки develop:

Продукт помимо основного стабильного релиза, выпускается "ночная сборка" продукта с новым, но еще не стабильным функционалом. Артефакты сборки доступны по запросу.

Запросы функциональности, задачи, сообщения об ошибках:

Пожелания к использованию можно фиксировать в виде Github Issues

Обсуждения категоризируются на 3 вида

• Сообщение об ошибке
• Запрос новой функциональности
• Запрос поддержки

Для удобства использования для каждой категории создан специальный шаблон, доступные для редактирования в каталоге Шаблоны обсуждений

Сравнение с другими инструментами тестирования

Продукт подразумевает следования трем ключевым принципам

• соответствение концепции BDD - "кодирование сценариев поведения до проектирования" в части приемочных тестов (приемо-сдаточных сценариев)
• соответствие концепции TDD - "тестирование до кода" в части модульных тестов (юнит-тестов)
• соответствие концепции "всё есть код" в части любых тестов и необходимых для этого данных

Остальные продукты в зоне "Качество 1С решений" исповедуют другие принципы, поэтому бессмысленно сравнивать функциональность разных продуктов, если они реализованы просто для разных целей.

Как помочь проекту

Продукт развивается при помощи независимых разработчиков, использующих продукт в собственных целях и в своих компаниях

• сообществом независимых разработчиков через концепцию краудсорсинга при помощи
  • руководства контрибьютора
  • технологию ответвления и отправки запросов на слияния

Поэтому:

• Если вы желаете поучаствовать в доработке и развитии, ознакомьтесь с руководством контрибьютора (участника проекта)

Лицензии и права

• основная лицензия исходного кода продукта - Mozilla Public Licence 2.0
• лицензии стороннего кода - BSDv3, Apache License, Freeware, etc - подробные разъяснения лицензий на исходный код продукта и его документации, в том числе содержатся внутри файлов исходного кода

Для НЕ знакомых с открытыми лицензиями информация о разрешениях и запретах каждой конкретной лицензии содержится на сайте https://choosealicense.com/licenses/ - в каждой конкретной лицензии имеются 3 секции: "Permissions (Права которые вы имеете)", "Conditions (Условия с которыми вы соглашаетсь)" и Limitations (Ограничения которые на вас накладываются). При использовании продукта, материалов исходного кода обработок 1С, скриптов или документации крайне желательно ознакомится с указанным сайтом для исключения противоречий.

---

Данная документация распространяется под открытой лицензией
Creative Commons Attribution-ShareAlike 4.0 International License.