senfgurke

센프구르케

Senfgurke는 VBA용 예제 기반 테스트 프레임워크입니다. 이것은 무엇을 의미합니까? Senfgurke를 사용하면 자연어로 제공된 예제를 VBA(Visual Basic for Application)에서 실행되는 자동화된 테스트로 바꿀 수 있습니다.

• 소개
• 설정
• 기능적인 디자인
• 건축학

조심하세요! 이 작업이 진행 중입니다. 향후 버전에서는 이전 버전의 테스트 자동화 코드가 손상될 수 있습니다!

소개

누군가가 다음 예를 통해 결과에 1의 값을 추가하는 Excel용 새로운 "특수" 합계 함수를 작성해 달라고 요청한다고 상상해 보세요.

 Example: add +1 to sum
  Given a is 2
    And b is 3
   When sum+1 is applied to a and b
   Then the result is 6

이제 이 예제를 기능에 추가하고 'sum_plus_one.feature'라는 파일의 모든 내용을 'features'라는 디렉터리에 저장할 수 있습니다. 디렉토리는 VBA 코드가 포함된 사무실 파일과 동일한 위치에 있어야 합니다.

Senfgurke를 처음 실행하는 경우 다음과 같은 새 기능을 추가하라는 제안이 표시됩니다.

 Public Sub Given_a_is_INT_C722764574FB(step_parameters As Collection)
    'Given a is 2

End Sub

함수 이름의 C722764574FB 부분과 혼동하지 마세요. 이 해시 값은 Senfgurke가 예제의 원래 단계와 함수를 일치시키는 데 도움이 됩니다. 이제 새 함수를 테스트하여 sum+1이 올바른 결과를 반환하는지 확인할 수 있도록 함수를 코드로 채우는 것은 사용자의 몫입니다.

예제의 모든 단계에서 이를 반복하고 Senfgurke를 실행하면 콘솔에 다음과 같은 내용이 표시될 수 있습니다.

 Feature: sum plus one


  Rule: add one to sum results

    Example: add +1 to sum
     OK       Given a is 2
     OK       And b is 3
     OK       When sum+1 is applied to a and b
     OK       Then the result is 6

이런 방식으로 Senfgurke는 코드가 성공했는지 또는 오류가 발생했는지 알려줍니다.

설정

Senfgurke는 애플리케이션별 추가 기능으로 제공됩니다. 이렇게 하면 테스트 중인 애플리케이션과 Senfgurke 테스트 프레임워크를 쉽게 분리할 수 있습니다. 새 VBA 응용 프로그램을 시작하려면 다음 단계를 따르십시오.

1. 애플리케이션에 대해 Senfgurke 추가 기능 활성화
2. 코드에 대한 새 문서를 만듭니다(예: Excel용 새 xlm 파일)
3. step_definitions/TRun.bas에서 TRun 모듈을 애플리케이션으로 가져옵니다.
4. VBA IDE에서 응용 프로그램에 대한 Senfgurke 추가 기능에 대한 참조를 추가합니다.
5. 응용 프로그램(VBA 코드가 포함된 문서)과 동일한 디렉터리에 "features"라는 새 디렉터리를 만듭니다.
6. 기능 아래에 첫 번째 Gherkin 기능 파일을 만듭니다(예제를 1개 이상 추가).
7. VBA IDE의 직접 실행 창에서 TRun.test를 실행합니다.
8. 애플리케이션에 새 클래스 "Step_"를 추가합니다.
9. 직접 실행 창에서 단계 함수에 대한 제안 코드를 Step 클래스에 복사합니다.
10. TRun 모듈에서 StepImplementations 속성을 확장하여 Step 클래스를 등록하세요.

기능적인 디자인

다음 이벤트 맵은 Senfgurke에게 기능 실행을 요청할 때 어떤 일이 발생하는지 설명합니다.

테스트 실행

테스트는 일반적으로 VBA 콘솔 창에서 시작됩니다. 이렇게 하면 태그나 필터(파일 이름용)를 추가하여 테스트 실행을 특정 태그나 기능 파일로 제한할 수 있습니다.

기능 파일 로드

Senfgurke가 가장 먼저 할 일은 기능 파일을 찾고 나중에 처리하기 위해 메모리에 로드하는 것입니다.

구문 분석 기능

모든 기능을 메모리에 저장하면 Senfgurke가 나중에 실행하기 위해 Gherkin 언어를 자세한 지침으로 변환(파싱)하는 것이 더 쉬워집니다. 예를 들어 테스트 시작 시 일치하는 태그가 설정되지 않은 예는 나중에 실행될 때 무시될 수 있으며 기능의 백그라운드 단계는 이 기능의 모든 예(일명 시나리오)에 추가됩니다.

기능 실행

다음 단계는 분명히 이전 단계의 모든 세부 실행 명령을 실행하는 것입니다. 여기에는 실행의 모든 ​​결과 반환도 포함됩니다.

결과보고

위에 언급된 기능의 실행과 동시에 결과는 다양한 형식으로 보고됩니다. 기본값은 예제의 각 단계에 실행 결과를 추가하여 VBA 콘솔 창에 Gherkin 기능을 기록하는 자세한 형식입니다.

보고서 통계

모든 테스트 실행이 끝나면 Senfgurke는 실행된 예제 단계의 기간 및 수와 같은 일부 통계를 추가합니다.

한 가지 더

더 자세한 문서를 보려면 Feature Indexer에서 생성된 색인으로 시작하는 Senfgurke의 기능 파일을 참조하세요.

건축학

FMC 블록 다이어그램은 일반적인 설정이 세 가지 레이어로 구성되어 있음을 보여줍니다.

1. OS는 기능 파일에 대한 저장소를 제공합니다.
2. Senfgurke 추가 기능에는 기능 파일의 예제(일명 시나리오) 단계를 일치하는 단계 기능과 일치시키는 모든 기능이 포함되어 있습니다.
3. 최상위 계층은 테스트 중인 응용 프로그램(일반적으로 VBA 코드가 포함된 사무실 문서)으로 표시됩니다.

일반적인 결정

몇 가지 일반적인 결정은 아키텍처 결정 로그를 참조하세요.

목표

우려의 분리

계층화된 아키텍처는 Senfgurke에서 제공하는 기능이 애플리케이션 로직과 분리되도록 보장해야 합니다.

티비씨