Позволяет тестировать в разных режимах обычное приложение, тонкий и толстый клиент управляемого приложения. Поддерживаются любые платформы 1С — от 8.2.17 до 8.3.5 и выше.
Любые наборы тестов могут прогоняться в полностью автоматическом режиме. Автозапуск используется в различных build-серверах в системах Continuous Integration.
Также возможно очень простое создание тестовых данных на основании табличных макетов. Эти макеты можно генерировать из реальных боевых данных. Полученные данные в тестах загружаются одной строкой кода.
В статье я кратко описал историю продукта + вставил небольшое описание различных возможностей нашего фреймворка + список полезных статей/примеров/видео, обучающих/рассказывающих о практическом применении инструмента
Для быстрого входа рекомендую почитать статьи или посмотреть видео или Посмотрите Wiki
xUnitFor1C работает с любыми конфигурациями, полностью независима, но может быть встроена в конфигурацию. Работает как в Windows, так и в Linux.
Любые наборы тестов могут прогоняться в полностью автоматическом режиме через специальную командную строку запуска. Автозапуск используется в различных build-серверах в системах Continuous Integration.
Также возможно очень простое создание тестовых данных на основании табличных макетов. Эти макеты можно генерировать из реальных боевых данных. Полученные данные в тестах загружаются одной строкой кода.
Почитайте короткую инструкцию по установке фреймворка xUnitFor1C
В случае возникновения каких-то проблем при тестировании рекомендуем заглянуть на страницу Известные проблемы при тестировании
Оглавление:
История тестирования в 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 году, после первой конференции Инфостарт и моего выступления по методикам разработки/тестирования (если я не путаю), Александр Кунташов неожиданно, без объявление войны взял и доработал продукт до универсального состояния, перенеся весь функционал во внешнюю обработку. Продукт стало возможным использовать в любых конфигурациях 1С, в т.ч. и на полной поддержке.
Так фактически и началась работа над продуктом xUnitFor1C.
Далее в проекте очень важные и активные роли сыграли Алексей Лустин и Евгений Сосна.
Сейчас это полноценный боевой продукт, использующийся в более 30 командах (информация от 2014 года) по России, Украине, Белоруссии.
За 3 года существования открытого проекта xUnitFor1C в него вносили правки аж 18 разработчиков
Сейчас на билд-сервере прогоняется более 4500 тестов проекта в различном окружении, как Windows, так и в Linux.
Статьи
- Механизмы разработки/тестирования в 1С. Использование методики TDD (разработка через тестирование) в 1С
- — 10 минут на прочтение.
- * автор Артур Аюханов aka artbear
- Написание простой обработки через TDD (тестирование) в xUnitFor1C
- — 5 минут на прочтение
- Создание файлов тестов в xUnitFor1C (из Вики)
- — 3 минуты на прочтение
- * Пример теста СКД и отчета, сделанного на компоновке (из Вики)
- — 3 минуты на прочтение
- Эволюция автоматического тестирования в среде 1С: Предприятия
- — 6 минут на прочтение
- * автор Евгений Павлюк aka wizi4d
- * Юнит-тесты, BDD и сила текучих утверждений (fluent assertions) в 1С
- — 5 минут на прочтение
- * автор Евгений Павлюк aka wizi4d
Видео
- Механизмы разработки/тестирования в 1С. Использование методики TDD (разработка через тестирование) в 1С
- * Выступление на конференции Infostart Event 2012
- * Автор Артур Аюханов aka artbear
- — 30 минут
- Разработка на 1С по промышленным стандартам (#ALM #SDLC #TFS)
- * Выступление на конференции Infostart Revolution 2013
- * Автор Артур Аюханов aka artbear
- — 28 минут
- Разработка на 1С по промышленным стандартам (как это было)
- * Прямая ссылка на YouTube
- — 8 часов просмотра 🙂
- — Авторы Алексей Лустин aka allustin и Евгений Павлюк aka wizi4d
Использование 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
Яростно 1++
Специальный релиз — в пЯтницу 13 🙂
Еще интересный факт о нашем проекте:
на днях на HeadHunter появилась вакансия, в требованиях к кандидату значится знание xUnitFor1C 🙂
У вакансии отличная формулировка, отличающаяся от стандартных формулировок.
— юнит тестирования
— git
— xUnitFor1C
— TDD
— генерации документации по коду
Вообще хорошо, если 1С это не первый рабочий язык, а есть опыт работы в промышленной разработке.
(0) Мою фамилию и видео уберите пожалуйста. 😉
Если уж так старательно меня НЕ упоминал, то тогда убери вообще.
(0)
Ну если нужны какие-то более-менее точные вехи, то вот как-то так это было:
🙂
В тот же день я тебе что-то отослал, ты как всегда наткнулся на кучу багов, какое-то время я это исправлял, а потом 29 ноября 2012 года, если верить githab’у, создал репозиторий (тогда еще 1CUnit),
А потом пошло-поехало: буквально через несколько дней присоединился к проекту Григорий Пташко (ему про нас рассказал Женя Сосна) и начал адаптацию под УФ, потом присоединился ты и пошло-поехало: с Лешей создали отдельную организацию на гитхабе (xDD —https://github.com/xDrivenDevelopment) , я все, что сделали, передал туда, потом нас (кажется, Аристархов через Лешу) попросили не использовать приставку 1С (как раз 1С опубликовала правила), Леха согласовал «наверху», что вместо нее можно дописать «For1C» и мы переименовали проект в xUnitFor1C.
И вот теперь мы здесь 🙂
(5) Еще Палыч веселился на 1С++ тоже
(4) Алексей, историю проекта я специально описал очень крупными вехами, чтобы не слишком большая статья получилась.
Конечно, упомянул не всех 🙁 в первую очередь, тебя и Женю Сосну (pumbaE). Извиняйте.
Буду рад, если ты и Женя дополните эту историю.
ИМХО будет интересно составить общий рассказ-историю.
(5) Саша, прикольно, оказывается, ты мне на мой день рождения подарок сделал 🙂
Насчет названия xUnitFor1C — Андрей Аристархов написал мне по названию 1CUnit, я уточнил, какой вариант устроит, был предложен суффикс for1C, я вышел на всех участников проекта (тебя, Алексея, Женю, Григория). Далее совместно мы решили поменять название на xUnitFor1C
(7) Да это уже и не важно теперь.
Странно что ты «случайно» забыл ссылку на мой github аккаунт. Выглядит некрасиво — поэтому прошу убери фамилию из статьи.
(9) Конечно, я его не забыл, а специально не указал, т.к. ты человек в среде 1С известный и ИМХО тебе не требуется специальных ссылок 🙂
Не думал, что это тебя так заденет 🙁
(9) Извини, оказывается, я указал твою фамилию без имени, некрасиво получилось 🙁
Добавил имя + ссылку.
PS копипаст = зло 🙁
недавно ткнули носом в ваш продукт (за что благодарен). всю жизнь тестировали вручную.
попробуем…
(9)(10) Вы еще по-деритесь 🙂
тестирую тестировщик
*стандартная УПП (свежий релиз). Тест на открытие форм. Ошибок масса 🙂
интересно, в общем.
Народ, подскажите 4-ю верcию уже можно использовать(в частности интересует сценарное тестирование(ui))?
(15) Adept, может про сценарное тестирование лучше вот сюда:https://github.com/silverbulleters/vanessa-behavior ?
(15) 4ю версию, конечно, можно использовать.
сценарное тестирование в ней также работает.
Спасибо за хороший продукт, ребята! 🙂
Он мотивировал меня перейти к разработке через тесты.
(17) Артур, а почему 4-я версия до сих пор в отдельной ветке и даже не в drvelop?
Или же решили 4-ю версию отдельным продуктом сделать?
Добрый день.
Испытываю уверенность, спокойствие и мощное эстетическое удовольствие, когда все тесты горят зеленым, хотя до этого сделал серьезный рефакторинг метаданных.
Прям ощущается магия какая то=)
Большое спасибо за разработку.
(20) Да, зеленая полоса очень мотивирует и вдохновляет — это известный факт.
Спасибо за отзыв.
PS помни, что никакое тестирование никогда не найдет все ошибки !
(21)
«PS помни, что никакое тестирование никогда не найдет все ошибки !»
да это помню и понимаю, но как минимум то, что проверял бы руками можно зашить в тесты.
Ну и на каждый баг, тоже делать тесты, тогда таких не найденных ошибок будет меньше.
(22) BlizD, да, конечно, ты описываешь правильный путь.
(23) Артур, приветствую! Я так понимаю избавляться от модальности xUnitFor1C не хочет? Когда ориентировочно планируется поддержка асинхронности и отказ от модальности?
(24) Привет, Виталий.
Планируется, но по срокам сложно сказать. open-source 🙂
Если кто-нибудь доработает этот функционал, буду очень рад.
Тем более, что сейчас при использовании плагинов, переделка уже не так трудоемка.
Несколько вопросов в контексте сценарных тестов.
Не совсем до конца понимаю как все-таки делать правильно.
Задача.
Создаю из макетов цепочку тестовых документов. Скажем, поступление, две последовательных корректировки, формирование записей книги покупок (для БП).
Провожу, заполняю, провожу, сравниваю с эталонными значениями.
Правильно ли делать так или есть более верная методика?
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.
(26) 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
Про битые ссылки, бегло вот:
ссылка с Пример кода тестов генерации данных (из репозитария)
как буду еще читать вики, перечень тогда составлю.
Вопрос еще был:
(28) kraynev-navi,
Спасибо. Исправил обе ссылки.
Для xUnitFor1C 4.X это правильная методика.
Подскажите как Вы запускаете 1С из командной строки linux (у которой не установлено графического окружения)?
(30) А как без графического интерфейса запускать 1С, которая является графической системой 🙂 ??
или речь только о регламентных заданиях ?
Нет. Речь идет о запуске 1С (в частности конфигуратора) из командной строки в пакетном режиме. Передал параметры командной строке типа «Выгрузить *.dt» или «Обновить конфигурацию из хранилища». 1С выполнил и закрылся.
Всем привет, инструмент действительно крутой!
Спасибо всем разработчикам и участвующим.
У меня вызывает стопор один момент.
Делаю так: создаю обработку с перечнем тестов, переменными в процедурах из модуля формы и открываю её в xddTestRunner.
Вопрос: как протестировать код из модуля формы, а точнее передать значение переменных?
Это пока главный стопор в начинаниях по переходу на написания кода через TDD.
Возможно, я не понял принцип тестирования/инструмента.
Буду благодарен за помощь.
(33) Читаем офиц.доку, открывая сайтhttps://github.com/xDrivenDevelopment/xUnitFor1C
и находя строку «Для быстрого входа рекомендуем», далее в этом предложении есть ссылка для быстрого входа 🙂
(34) Артур, спасибо за отклик. Ещё раз перечитаю.
Активно читаю последнее время.
Накапливаются вопросы когда переносишь теорию на практику.
Добрый день!
А подскажите, можно как-то протестить отдельную внешнюю обработку? Или обработка должна быть встроена в конфу и тогда уже тестировать всю конфигурацию?
(36) Пропустил Ваше сообщение.
Конечно, можно протестировать отдельную внешнюю обработку.
Это несложно.
(33) (34) Для тестирования кода модуля упр формы — быстрый вход как-то неявно описан:) С третьего-четвертого захода нашел, как это делается.
ссылка ). Причем, и в модуле самой обработки — тоже можно свой список и тесты писать. И тогда будут видны два списка тестов.
Смысл в том, что список тестов и сами тесты можно писать и в коде упр. формы обработки (
(38) Да, в этой статье я этот момент пропустил.
Но на официальном сайте есть дока с примерами.
(38) Добавил ссылку на примеры тестов для управляемой формы в статью.
(40) Добрый день! Подскажите пожалуйста по такому вопросу: если у меня есть юнит-тест написанный в модуле управляемой формы но для него мне необходимы данные из макета.
Загрузка данных производится из макета на клиенте.
Есть
Есть
Но после выполнения шагов транзакция уже не активна и соответственно не откатывается.
Судя по всему для отката транзакции весь код должен выполняться не сервере. А как тогда быть в таком случае?
(41) При работе в Упр.форме * транзакции не возможен, т.к. работа идет на клиенте, а транзакция возможна только при вызове внутри серверного кода.
Вывод:
+ либо удаляем созданные данные вручную
+ либо вообще их не удаляем 🙂
(42) Ну вообщем то так и пришлось сделать — удалять созданные данные. Спасибо!
(37)
Цитата из публикации:
Есть ли где-то информация, как использовать xUnitFor1C как встроенную в конфигурацию подсистему?
Интересует не только использование самой обработки xddTestRunner.epf но и плагинов, например плагина «Настройки.epf».
Столкнулся с тем, что файл, содержащий исключения для тестов, не загружается. Ошибок нет, но тесты не отмечаются как исключаемые. Хотел произвести отладку, но система работы через плагины-внешние обработки приводит к тому, что в тонком клиенте нельзя выполнить пошаговую отладку методов этих плагинов. Например вызова ПлагинНастроек.Обновить(). Отладка по F11 в этом случае не работает должным образом.
Изучению инструмента могло бы помочь встраивание обработок в конфигурацию. В документации к xUnitFor1C сказано что такая возможность есть.
Нашел в коде, что если обработки встроены в конфигурацию, то плагины будут искаться как встроенные обработки, входящие в состав подсистемы конфигурации <ИспользуемыйПрефиксПодсистемы>xUnitFor1C.Plugins. Но создавать эти подсистемы вручную было бы сложно. В то же время в репозитории никаких cf-файлов для объединения с конфигурацией не обнаружил.
Сохранилась ли до сих пор возможность встроить подсистему в тестируемую конфигурацию?
(44) 1 Встраивание как подсистемы — сложный процесс и у него сейчас очень мало сторонников 🙁
Я, например, не использую этот механизм вообще.
2 развитие xUnitFor1C ушло в сторону «сводного» продукта ADD (vanessa-add)https://github.com/silverbulleters/add
сам xUnitFor1C пока никто не развивает, все силы мы будем отдавать на ADD
в новом релизе ADD, который будет выпущен на днях, как раз реализован обычный=привычный способ отладки как плагинов, так и самих тестов.
PS кстати, для ADD у нас есть планы сделать расширение в дополнение к варианту на внешних обработках, но эти планы пока довольно отдаленные.