xUnitFor1C — набор инструментов для выполнения тестирования (модульного/юнит, приемочного, сценарного для 1С 8.3, интеграционного) в 1С:Предприятии 8

xUnitFor1C — простой и мощный фреймворк для тестирования в 1С.
Позволяет тестировать в разных режимах обычное приложение, тонкий и толстый клиент управляемого приложения. Поддерживаются любые платформы 1С — от 8.2.17 до 8.3.5 и выше.
Любые наборы тестов могут прогоняться в полностью автоматическом режиме. Автозапуск используется в различных build-серверах в системах Continuous Integration.
Также возможно очень простое создание тестовых данных на основании табличных макетов. Эти макеты можно генерировать из реальных боевых данных. Полученные данные в тестах загружаются одной строкой кода.
В статье я кратко описал историю продукта + вставил небольшое описание различных возможностей нашего фреймворка + список полезных статей/примеров/видео, обучающих/рассказывающих о практическом применении инструмента

Для быстрого входа рекомендую почитать статьи или посмотреть видео или Посмотрите Wiki

xUnitFor1C работает с любыми конфигурациями, полностью независима, но может быть встроена в конфигурацию. Работает как в Windows, так и в Linux.

Тесты могут быть как во внешних обработках, так и во встроенных обработках.

Любые наборы тестов могут прогоняться в полностью автоматическом режиме через специальную командную строку запуска. Автозапуск используется в различных build-серверах в системах Continuous Integration.

Также возможно очень простое создание тестовых данных на основании табличных макетов. Эти макеты можно генерировать из реальных боевых данных. Полученные данные в тестах загружаются одной строкой кода.

Почитайте короткую инструкцию по установке фреймворка xUnitFor1C

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

Оглавление:

  1. История тестирования в 1С-среде
  2. Статьи
  3. Видео
  4. Использование продукта
  5. Что к чему
  6. Как помочь проекту

История тестирования в 1С-среде 

 Работы по тестированию в 1С начались в сообществе 1С++ для 1С 7.7 еще в далеких 2003-2004 годах.

Я лично пришел в тестирование, когда меня сильно начали напрягать постоянные баги при выпуске новых релизов 1С ++ — одно чиним, другое ломаем. Сначала я начал выполнять работу тестировщика, далее перешел к автоматизации тестировании и непосредственной разработке на С++ для доработки 1С++.

Мной совместно с Федором Езеевым (он не так давно был руководителем отдела тестирования 1С в Яндексе) была создана специальная конфигурация для 1С 7.7 на базе 1С++ для приемочного и юнит-тестирования классов проекта внешней компоненты 1С++. Конфигурация оказалась очень удобной и сильно  помогала в разработке 1С++. За год участники проекта 1С++ написали более 1000 интеграционных тестов для классов/модулей 1С++.

В дальнейшем эта конфигурация не раз была использована в боевых системах. И даже пару лет назад мы ее применили для тестирования legacy-конфигурации розничных точек одного из крупнейших ритейлеров России, хотя и прошло более 8 лет с момента разработки в 77. Затем эта же конфигурации и полученные тесты были использованы для нагрузочного тестирования конфигурации.

Параллельно шла разработка проекта функционального/приемочного тестирования FuncTest (автор Федор Езеев). Основная схема работы — сравнение с образцом/ожиданиями. Мы совместно с Федором серьезно поработали над проектом для доведения до мощного юзабельного поведения.

Но время семерки уходило, приходила восьмерка. Нужно было реализовывать продукты тестирования и для восьмерки.

Я портировал проект FuncTest на 8.1 и 8.2. Так появилась Система тестирования функциональных тестов FuncTest для 1cv8.1 — версия 1.17

А Федор на форуме 1С++ параллельно инициировал работу над проектом модульного/юнит-тестирования, аналог xUnit от Кента Бека для 1С. Совместно мы создали специальную подсистему/конфигурацию для 1С 8.1 — тесты писались во внешних обработках. Этот проект — фактически "папа" нашего продукта. Все было очень удобно, но необходимость использования специальной конфигурации мешало в распространении проекта.

И вот в 2012 году, после первой конференции Инфостарт и моего выступления по методикам разработки/тестирования (если я не путаю), Александр Кунташов неожиданно, без объявление войны Smile взял и доработал продукт до универсального состояния, перенеся весь функционал во внешнюю обработку. Продукт стало возможным использовать в любых конфигурациях 1С, в т.ч. и на полной поддержке.

Так фактически и началась работа над продуктом xUnitFor1C.

Далее в проекте очень важные и активные роли сыграли Алексей Лустин и Евгений Сосна.

Сейчас это полноценный боевой продукт, использующийся в более 30 командах (информация от 2014 года) по России, Украине, Белоруссии.

За 3 года существования открытого проекта xUnitFor1C в него вносили правки аж 18 разработчиков Smile

Сейчас на билд-сервере прогоняется более 4500 тестов проекта в различном окружении, как Windows, так и в Linux.

Статьи

Видео

Использование xUnitFor1C

Запуск тестов из командной строки и получение файлов результатов

Генерация данных

Тесты открытия форм

Примеры тестов:

Скрипт для Snegopat "Добавить описание тестовых случаев текущего модуля в метод ПолучитьСписокТестов" (xUnitAddTestsDesc.js)"

Инструкция для контрибьюторов, т.е. для тех, кто жаждет доработать xUnitFor1C

Что к чему

  • xddTestRunner.epf — браузер и исполнитель тестов для обычного приложения и управляемого приложения 1С:Предприятия 8 (толстый и тонкий клиенты)
  • xddDataFixtureGen.epf — генерация макета данных для использования в тестах. Макет можно генерить из боевой базы на основе реальных данных.
    • Tests — каталог с примерами тестов и с тестами для самотестирования xddTestRunner.epf (подпапка selftests)
    • TestsCommonAppтесты_ОткрытиеФормКонфигурации.epf — тесты открытия всех форм справочников, документов, отчетов и обработок. Для справочников и документов в транзакции создаются новые или копируются или перезаписываются существующие элементы.
    • TestsCommonAppТест_ЗапускТестовВСеансеДругихПользователей.epf — примеры запуска тестов для пользователей с ограниченными правами. Пользователи создаются на лету из простых макетов.
    • TestsCommonAppТест_ПроверитьОтчетНаСоответствиеЭталону.epf — пример теста отчета путем сравнения с эталонным ожиданием из макета.

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

Мы рады любой помощи:

1. Если вы занимаетесь разработкой на 1С:Преприятии 8 пробуйте писать и выполнять тесты при помощи xUnitFor1C, сообщайте нам об обнаруженных ошибках, пишите пожелания. Для управления сообщениями об ошибках и пожеланиями мы используем баг-трекер GitHub’а.

2. Если у вас есть время разобраться в исходном коде, вы можете взять на себя реализацию одной из открытых задач.

3. Если вы уже используете xUnitFor1C на практике, напишите об этом статью, например, на Инфостарте.

Инструкция для контрибьюторов, т.е. для тех, кто жаждет доработать xUnitFor1C

45 Comments

  1. fishca

    Яростно 1++

    Reply
  2. artbear

    Специальный релиз — в пЯтницу 13 🙂

    Reply
  3. artbear

    Еще интересный факт о нашем проекте:

    на днях на HeadHunter появилась вакансия, в требованиях к кандидату значится знание xUnitFor1C 🙂

    У вакансии отличная формулировка, отличающаяся от стандартных формулировок.

    Приветствуются полезные знания:

    — юнит тестирования

    — git

    — xUnitFor1C

    — TDD

    — генерации документации по коду

    Вообще хорошо, если 1С это не первый рабочий язык, а есть опыт работы в промышленной разработке.
    Reply
  4. lustin

    (0) Мою фамилию и видео уберите пожалуйста. 😉

    Если уж так старательно меня НЕ упоминал, то тогда убери вообще.

    Reply
  5. kuntashov

    (0)

    И вот в 2012 году, после первой конференции Инфостарт и моего выступления по методикам разработки/тестирования (если я не путаю), Александр Кунташов неожиданно, без объявление войны Smile взял и доработал продукт до универсального состояния, перенеся весь функционал во внешнюю обработку.

    Ну если нужны какие-то более-менее точные вехи, то вот как-то так это было:

    🙂

    В тот же день я тебе что-то отослал, ты как всегда наткнулся на кучу багов, какое-то время я это исправлял, а потом 29 ноября 2012 года, если верить githab’у, создал репозиторий (тогда еще 1CUnit),

    А потом пошло-поехало: буквально через несколько дней присоединился к проекту Григорий Пташко (ему про нас рассказал Женя Сосна) и начал адаптацию под УФ, потом присоединился ты и пошло-поехало: с Лешей создали отдельную организацию на гитхабе (xDD — https://github.com/xDrivenDevelopment), я все, что сделали, передал туда, потом нас (кажется, Аристархов через Лешу) попросили не использовать приставку 1С (как раз 1С опубликовала правила), Леха согласовал «наверху», что вместо нее можно дописать «For1C» и мы переименовали проект в xUnitFor1C.

    И вот теперь мы здесь 🙂

    Reply
  6. lustin

    (5) Еще Палыч веселился на 1С++ тоже

    Reply
  7. artbear

    (4) Алексей, историю проекта я специально описал очень крупными вехами, чтобы не слишком большая статья получилась.

    Конечно, упомянул не всех 🙁 в первую очередь, тебя и Женю Сосну (pumbaE). Извиняйте.

    Буду рад, если ты и Женя дополните эту историю.

    ИМХО будет интересно составить общий рассказ-историю.

    Reply
  8. artbear

    (5) Саша, прикольно, оказывается, ты мне на мой день рождения подарок сделал 🙂

    Насчет названия xUnitFor1C — Андрей Аристархов написал мне по названию 1CUnit, я уточнил, какой вариант устроит, был предложен суффикс for1C, я вышел на всех участников проекта (тебя, Алексея, Женю, Григория). Далее совместно мы решили поменять название на xUnitFor1C

    Reply
  9. lustin

    (7) Да это уже и не важно теперь.

    Странно что ты «случайно» забыл ссылку на мой github аккаунт. Выглядит некрасиво — поэтому прошу убери фамилию из статьи.

    Reply
  10. artbear

    (9) Конечно, я его не забыл, а специально не указал, т.к. ты человек в среде 1С известный и ИМХО тебе не требуется специальных ссылок 🙂

    Не думал, что это тебя так заденет 🙁

    Reply
  11. artbear

    (9) Извини, оказывается, я указал твою фамилию без имени, некрасиво получилось 🙁

    Добавил имя + ссылку.

    PS копипаст = зло 🙁

    Reply
  12. Кузьмич

    недавно ткнули носом в ваш продукт (за что благодарен). всю жизнь тестировали вручную.

    попробуем…

    Reply
  13. zarucheisky

    (9)(10) Вы еще по-деритесь 🙂

    Reply
  14. Кузьмич

    тестирую тестировщик

    *стандартная УПП (свежий релиз). Тест на открытие форм. Ошибок масса 🙂

    интересно, в общем.

    Reply
  15. Adept

    Народ, подскажите 4-ю верcию уже можно использовать(в частности интересует сценарное тестирование(ui))?

    Reply
  16. JohnyDeath

    (15) Adept, может про сценарное тестирование лучше вот сюда: https://github.com/silverbulleters/vanessa-behavior ?

    Reply
  17. artbear

    (15) 4ю версию, конечно, можно использовать.

    сценарное тестирование в ней также работает.

    Reply
  18. tivanitsky

    Спасибо за хороший продукт, ребята! 🙂

    Он мотивировал меня перейти к разработке через тесты.

    Reply
  19. JohnyDeath

    (17) Артур, а почему 4-я версия до сих пор в отдельной ветке и даже не в drvelop?

    Или же решили 4-ю версию отдельным продуктом сделать?

    Reply
  20. BlizD

    Добрый день.

    Испытываю уверенность, спокойствие и мощное эстетическое удовольствие, когда все тесты горят зеленым, хотя до этого сделал серьезный рефакторинг метаданных.

    Прям ощущается магия какая то=)

    Большое спасибо за разработку.

    Reply
  21. artbear

    (20) Да, зеленая полоса очень мотивирует и вдохновляет — это известный факт.

    Спасибо за отзыв.

    PS помни, что никакое тестирование никогда не найдет все ошибки !

    Reply
  22. BlizD

    (21)

    «PS помни, что никакое тестирование никогда не найдет все ошибки !»

    да это помню и понимаю, но как минимум то, что проверял бы руками можно зашить в тесты.

    Ну и на каждый баг, тоже делать тесты, тогда таких не найденных ошибок будет меньше.

    Reply
  23. artbear

    (22) BlizD, да, конечно, ты описываешь правильный путь.

    Reply
  24. Diversus

    (23) Артур, приветствую! Я так понимаю избавляться от модальности xUnitFor1C не хочет? Когда ориентировочно планируется поддержка асинхронности и отказ от модальности?

    Reply
  25. artbear

    (24) Привет, Виталий.

    Планируется, но по срокам сложно сказать. open-source 🙂

    Если кто-нибудь доработает этот функционал, буду очень рад.

    Тем более, что сейчас при использовании плагинов, переделка уже не так трудоемка.

    Reply
  26. kraynev-navi

    Несколько вопросов в контексте сценарных тестов.

    Не совсем до конца понимаю как все-таки делать правильно.

    Задача.

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

    Провожу, заполняю, провожу, сравниваю с эталонными значениями.

    Правильно ли делать так или есть более верная методика?

    0. Удаляются ранее созданные документы (Подсмотрено у acsent из http://infostart.ru/public/517549/ )

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

    2. Провожу документ корректировки. Проверяю (тест)

    3. Провожу второй документ корректировки. Проверяю (тест)

    4. Делаю заполнение формирования. Проверяю (тест)

    5. Делаю проведение формирования. Проверяю сверкой с эталоном (тест)

    Если тест падает в начальных пунктах, скажем в 2, то смысла делать 3-5 нету.

    По факту сценарный тест идет до конца, что занимает время и идет в разрез с утверждением, что тесты должны идти быстро.

    Почему, кстати, он идет до конца? Ведь

    на странице https://github.com/xDrivenDevelopment/xUnitFor1C/wiki/%D0%A1%D1%86%D0%B5%D0­%BD%D0%B0%D1%80%D0%BD%D1%8B%D0%B5-%D1%82%D0%B5%D1%81%D1%82%D1%8B—%D1%81%D1%86%D0%B5%D0%BD%D0%B0%D1%80%D0%B8%D0%B8-%D0%B2-%D0%B2%D0%B8%D0%B4%D0%B5-%D1%81%D0%B2%D1%8F%D0%B7%D0%B0%D0%BD%D0%BD%D1%8B%D1%85-%D0%B8-%D0%BF%D0%BE%D1%81%D0%BB%D0%B5%D0%B4%D0%BE%D0%B2%D0%B0%D1%82­%D0%B5%D0%BB%D1%8C%D0%BD%D1%8B%D1%85-%D1%88%D0%B0%D0%B3%D0%BE%D0%B2

    например. если в одном из шагов теста будут ошибки, все остальные шаги/тесты будут выполнены и до последнего теста дело не дойдет. Следовательно, операция завершения выполнена не будет.

    Версия xUnit1C 4

    p.s. В статье ссылка на сценарное тестирование ведет на главную вики. Кстати, некоторые примеры в вики ведут на 404-ю. Вероятно, сказывается переход к 4.0.

    Reply
  27. artbear

    (26) kraynev-navi,

    В доке по указанной ссылке написано самое важное

    Процедура ЗаполнитьНаборТестов(НаборТестов) Экспорт
    
    НаборТестов.НачатьГруппу(«Тестовый сценарий», Истина); // ВОТ ЗДЕСЬ
    НаборТестов.Добавить(«ТестДолжен_СохранитьКонтекст»);
    НаборТестов.Добавить(«ТестДолжен_ПроверитьСохраненныйКонтекст»);
    
    КонецПроцедуры

    у тебя такой код используется для создания сценарных тестов?

    В статье ссылка на сценарное тестирование ведет на главную вики.

    Исправил.

    Кстати, некоторые примеры в вики ведут на 404-ю. Вероятно, сказывается переход к 4.0.

    Подскажи, какие ссылки неверные, поправлю.

    Спасибо, жду.

    Reply
  28. kraynev-navi

    (27) Истину-то я и не приметил, походу из третьей версии переносил. С истиной, работает, спасибо!

    Про битые ссылки, бегло вот:

    https://github.com/xDrivenDevelopment/xUnitFor1C/wiki/%D0%93%D0%B5%D0%BD%D0­%B5%D1%80%D0%B0%D1%86%D0%B8%D1%8F-%D0%B4%D0%B0%D0%BD%D0%BD%D1%8B%D1%85

    ссылка с Пример кода тестов генерации данных (из репозитария)

    как буду еще читать вики, перечень тогда составлю.

    Вопрос еще был:

    Правильно ли делать так или есть более верная методика?
    Reply
  29. artbear

    (28) kraynev-navi,

    ссылка с Пример кода тестов генерации данных (из репозитария)

    Спасибо. Исправил обе ссылки.

    Правильно ли делать так или есть более верная методика?

    Для xUnitFor1C 4.X это правильная методика.

    Reply
  30. vsbronnikov

    Подскажите как Вы запускаете 1С из командной строки linux (у которой не установлено графического окружения)?

    Reply
  31. artbear

    (30) А как без графического интерфейса запускать 1С, которая является графической системой 🙂 ??

    или речь только о регламентных заданиях ?

    Reply
  32. vsbronnikov

    Нет. Речь идет о запуске 1С (в частности конфигуратора) из командной строки в пакетном режиме. Передал параметры командной строке типа «Выгрузить *.dt» или «Обновить конфигурацию из хранилища». 1С выполнил и закрылся.

    Reply
  33. Alligator84

    Всем привет, инструмент действительно крутой!

    Спасибо всем разработчикам и участвующим.

    У меня вызывает стопор один момент.

    Делаю так: создаю обработку с перечнем тестов, переменными в процедурах из модуля формы и открываю её в xddTestRunner.

    Вопрос: как протестировать код из модуля формы, а точнее передать значение переменных?

    Это пока главный стопор в начинаниях по переходу на написания кода через TDD.

    Возможно, я не понял принцип тестирования/инструмента.

    Буду благодарен за помощь.

    Reply
  34. artbear

    (33) Читаем офиц.доку, открывая сайт https://github.com/xDrivenDevelopment/xUnitFor1C

    и находя строку «Для быстрого входа рекомендуем», далее в этом предложении есть ссылка для быстрого входа 🙂

    Reply
  35. Alligator84

    (34) Артур, спасибо за отклик. Ещё раз перечитаю.

    Активно читаю последнее время.

    Накапливаются вопросы когда переносишь теорию на практику.

    Reply
  36. VickWood

    Добрый день!

    А подскажите, можно как-то протестить отдельную внешнюю обработку? Или обработка должна быть встроена в конфу и тогда уже тестировать всю конфигурацию?

    Reply
  37. artbear

    (36) Пропустил Ваше сообщение.

    Конечно, можно протестировать отдельную внешнюю обработку.

    Это несложно.

    Reply
  38. ImHunter

    (33) (34) Для тестирования кода модуля упр формы — быстрый вход как-то неявно описан:) С третьего-четвертого захода нашел, как это делается.

    Смысл в том, что список тестов и сами тесты можно писать и в коде упр. формы обработки (ссылка). Причем, и в модуле самой обработки — тоже можно свой список и тесты писать. И тогда будут видны два списка тестов.

    Reply
  39. artbear

    (38) Да, в этой статье я этот момент пропустил.

    Но на официальном сайте есть дока с примерами.

    Создание файлов-тестов

    Примеры тестов

    Reply
  40. artbear

    (38) Добавил ссылку на примеры тестов для управляемой формы в статью.

    Reply
  41. akivvika

    (40) Добрый день! Подскажите пожалуйста по такому вопросу: если у меня есть юнит-тест написанный в модуле управляемой формы но для него мне необходимы данные из макета.

    Загрузка данных производится из макета на клиенте.

    Есть

    &НаСервереБезКонтекста
    Процедура ПередЗапускомТестаНаСервере()
    НачатьТранзакцию();
    КонецПроцедуры

    Есть

    &НаСервереБезКонтекста
    Процедура ПослеЗапускаТестаНаСервере()
    Если ТранзакцияАктивна() Тогда
    ОтменитьТранзакцию();
    КонецЕсли;
    КонецПроцедуры

    Но после выполнения шагов транзакция уже не активна и соответственно не откатывается.

    Судя по всему для отката транзакции весь код должен выполняться не сервере. А как тогда быть в таком случае?

    Reply
  42. artbear

    (41) При работе в Упр.форме * транзакции не возможен, т.к. работа идет на клиенте, а транзакция возможна только при вызове внутри серверного кода.

    Вывод:

    + либо удаляем созданные данные вручную

    + либо вообще их не удаляем 🙂

    Reply
  43. akivvika

    (42) Ну вообщем то так и пришлось сделать — удалять созданные данные. Спасибо!

    Reply
  44. Vladimir Litvinenko

    (37)

    Цитата из публикации:

    xUnitFor1C работает с любыми конфигурациями, полностью независима, но может быть встроена в конфигурацию

    Есть ли где-то информация, как использовать xUnitFor1C как встроенную в конфигурацию подсистему?

    Интересует не только использование самой обработки xddTestRunner.epf но и плагинов, например плагина «Настройки.epf».

    Столкнулся с тем, что файл, содержащий исключения для тестов, не загружается. Ошибок нет, но тесты не отмечаются как исключаемые. Хотел произвести отладку, но система работы через плагины-внешние обработки приводит к тому, что в тонком клиенте нельзя выполнить пошаговую отладку методов этих плагинов. Например вызова ПлагинНастроек.Обновить(). Отладка по F11 в этом случае не работает должным образом.

    Изучению инструмента могло бы помочь встраивание обработок в конфигурацию. В документации к xUnitFor1C сказано что такая возможность есть.

    Нашел в коде, что если обработки встроены в конфигурацию, то плагины будут искаться как встроенные обработки, входящие в состав подсистемы конфигурации <ИспользуемыйПрефиксПодсистемы>xUnitFor1C.Plugins. Но создавать эти подсистемы вручную было бы сложно. В то же время в репозитории никаких cf-файлов для объединения с конфигурацией не обнаружил.

    Сохранилась ли до сих пор возможность встроить подсистему в тестируемую конфигурацию?

    Reply
  45. artbear

    (44) 1 Встраивание как подсистемы — сложный процесс и у него сейчас очень мало сторонников 🙁

    Я, например, не использую этот механизм вообще.

    2 развитие xUnitFor1C ушло в сторону «сводного» продукта ADD (vanessa-add) https://github.com/silverbulleters/add

    сам xUnitFor1C пока никто не развивает, все силы мы будем отдавать на ADD

    в новом релизе ADD, который будет выпущен на днях, как раз реализован обычный=привычный способ отладки как плагинов, так и самих тестов.

    PS кстати, для ADD у нас есть планы сделать расширение в дополнение к варианту на внешних обработках, но эти планы пока довольно отдаленные.

    Reply

Leave a Comment

Ваш адрес email не будет опубликован. Обязательные поля помечены *