Vanessa Automation Driven Development

Сообщество продукта	Качество проекта	Статус сборки	Текущий релиз
		<Новый сервер CI>

• Vanessa-ADD ( ADD )
  • Введение
  • Справка и полезные ссылки
  • Установка
  • Обсуждения, задачи, сообщения об ошибках
  • Сравнение с другими инструментами
  • Помощь проекту
  • Лицензии

Введение

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Установка

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

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

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

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

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

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

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

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

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

1. 7z - unzip -o ./add.7z
2. tar.gz - tar xfv ./add.tar.gz

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

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

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

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

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

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

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

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

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

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

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

• за счет средств компании Серебряная Пуля при реализации трёх категорий услуг

  • реализация проектов Имплементация инженерных практик и Тестирование ИТ решений
  • услуги корпоративная поддержка OpenSource инструментария
  • продажи книг "Тестирование 1С решений - пособие разработчика" и "Пособие релиз инженера 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.