Karate 프레임워크 자습서: Karate를 사용한 자동화된 API 테스트

가라테 프레임워크란 무엇입니까
결론
- 가라테 프레임워크의 역사
Karate와 Rest-Assured 비교

이 튜토리얼은 Karate Framework를 사용한 API 테스팅에 대한 소개입니다. Karate Test Script의 구조와 첫 번째 테스트 스크립트를 작성하는 단계에 대해 알아보세요.

API는 Application Programming Interface의 약어입니다. 간단히 말해서 애플리케이션 간의 통신을 허용하는 소프트웨어 중개자로 정의할 수 있습니다.

다음과 같은 이유로 API 테스트가 필요합니다.

결과가 더 빨리 게시되고, 따라서 더 이상 API가 제대로 작동하는지 확인하기 위해 기다릴 필요가 없습니다.
더 빠른 응답으로 이러한 API의 배포도 더 빨라지므로 처리 시간이 빨라집니다.
조기 장애 감지, 앱의 UI가 생성되기 전에도 위험을 완화하고 결함을 수정할 수 있습니다.
단기간에 대량 납품이 가능합니다.

API 테스팅을 할 수 있도록 Postman, Mocha, Chai 등 시중에서 구할 수 있는 다양한 툴을 가지고 있습니다. 이것들은 API 테스트를 위한 좋은 결과와 효과적인 사용을 보여주었지만 코드의 영향을 많이 받았습니다. 이를 사용하려면 기술적으로 건전하고 프로그래밍 언어에 익숙해야 합니다.

Karate Framework는 이전 소프트웨어 도구의 이 문제를 훌륭하게 해결합니다.

가라테 프레임워크란 무엇입니까

가라테? 가라데에 대해 이야기합시다. 일본에서 온 건가요? 어떻게 생각하나요? 어쩌면 위대한 브루스이 Karate 기본 테스트 스크립트입니다.

시나리오:

이 URL로 API를 테스트할 것입니다.

경로: api/users/2

방법: GET

그리고 요청이 성공 코드( 200) 여부.

간단히 말해서 샘플 API를 테스트하여 성공적으로 실행되는지 여부를 확인하는 것입니다.

참고: 테스트에 사용할 수 있는 샘플 API를 사용하고 있습니다. 아무 경로나 선택하거나 API를 참조할 수 있습니다.

소스를 보려면 여기를 클릭하세요.

#5) 이제 다음 단계는 을 만드는 것입니다. .feature 파일.

소개 섹션에서 설명한 것처럼 .feature 파일 은 Cucumber에서 상속된 속성입니다. 이 파일에서 API 테스트를 수행하기 위해 실행해야 하는 테스트 시나리오를 작성합니다.

프로젝트의 src/test/java 폴더로 이동합니다.

오른쪽 클릭하고 userDetails.feature라는 새 파일을 만듭니다. 마침 버튼을 클릭합니다.

이제 src/test/java 폴더 아래에 다음 파일이 표시됩니다. 3>

녹색 아이콘 은 방금 만든 Cucumber의 .feature 파일 과 유사합니다.

파일이 생성되면 이제 다음 섹션에서 논의할 테스트 시나리오를 작성합니다.

#6) 빈 . feature 파일이 준비되었습니다. 이제 첫 번째 스크립트를 시작하겠습니다. 코딩을 시작하겠습니다.

5단계에서 생성한 userDetails.feature 파일 아래에 다음 코드 행을 작성합니다.

 Feature: fetching User Details Scenario: testing the get call for User Details Given url '//reqres.in/api/users/2' When method GET Then status 200

이해해 보겠습니다. 위 파일에 작성된 구성 요소:

기능: 키워드는 테스트 중인 기능의 이름을 설명합니다.
배경: 필수 섹션으로 취급되는 선택적 섹션입니다. 이것은 API를 테스트하는 데 필요한 모든 것을 정의하는 데 사용할 수 있습니다. HEADER, URL & PARAM 옵션.
시나리오: 표시되는 모든 기능 파일에는 최소한 하나의 기능이 있습니다( 여러 시나리오를 제공할 수 있음). . 테스트 사례에 대한 설명입니다.
지정: 다른 테스트 단계가 수행되기 전에 실행해야 하는 단계입니다. 수행해야 하는 필수 작업입니다.
시기: 다음 테스트 단계를 수행하기 위해 충족해야 하는 조건을 지정합니다.
방법: 에서 언급한 조건이 충족될 경우 어떻게 되는지 알려줍니다.

참고: 위에 언급된 모든 키워드는 Gherkins 언어에서. 다음은 Cucumber를 사용하여 테스트 스크립트를 작성하는 표준 방법입니다.

기능 파일에 사용된 단어는 다음과 같습니다.

200: 현재 상태/응답 코드입니다.expected (상태 코드 목록을 보려면 여기를 클릭하세요.)
GET: POST, PUT 등과 같은 API 방식입니다.

이 설명을 바랍니다. 이해하기 쉬웠습니다. 이제 위 파일에 정확히 쓰여진 내용과 연관 지을 수 있을 것입니다.

이제 TestRunner.java 파일을 생성해야 합니다.

위에서 설명한 대로 섹션에서 Cucumber는 테스트 시나리오가 포함된 .feature 파일을 실행하는 데 필요한 Runner 파일이 필요합니다.

폴더로 이동 src/test/java 프로젝트에서

오른쪽 클릭하고 새 Java 파일을 만듭니다. TestRunner.java
파일이 생성되면 다음 코드 줄을 그 아래에 배치합니다.

 import org.junit.runner.RunWith; import com.intuit.karate.junit4.Karate; @RunWith(Karate.class) public class TestRunner { }

Test Runner는 이제 테스트를 수행하기 위해 실행될 파일입니다. 5단계에서 작성한 원하는 시나리오.

#7) 이제 TestRunner.Java 및 파일이 준비되었습니다. userDeatils.feature. 우리에게 남은 유일한 작업은 스크립트를 실행 하는 것입니다.

TestRunner.java 파일로 이동하여 아래 이미지와 같이 파일을 마우스 오른쪽 버튼으로 클릭합니다.

다음으로 실행 선택 -> Junit Test
이제 선택하면 테스트 사례가 시작되었음을 관찰하기 시작합니다.
테스트 스크립트가 실행될 때까지 기다립니다. 완료되면 창에서 아래 이미지와 같은 것을 볼 수 있습니다.

마지막으로 말할 수 있습니다. Karate 프레임워크

#8) 를 사용하여 Test Script 첫 번째 기본 을 성공적으로 만들었습니다. 마지막으로 Karate 프레임워크는 수행된 실행에 대한 HTML 보고서 프레젠테이션도 제공합니다.

대상 폴더로 이동 -> 확실한 보고서-> 여기에서 열 수 있는 HTML 보고서가 표시됩니다.

** Chrome을 사용하여 동일한 보고서를 여는 것이 좋습니다. 더 나은 모양과 느낌을 위한 브라우저.

시나리오 & 언급된 시나리오에 대해 실행된 테스트 :

결론

이 자습서에서는 API 테스트, 다른 테스트에 대해 논의했습니다. 시장에서 사용할 수 있는 도구와 Karate 프레임워크가 다른 도구에 비해 더 나은 옵션인 이유를 설명합니다.

첫 번째 기본 테스트 스크립트를 만들기 위해 단계별 접근 방식을 따랐습니다. 우리는 기본 Eclipse IDE 에서 기본 Maven 프로젝트를 생성하여 모든 테스트 시나리오가 포함된 .feature 파일과 .feature 파일에 언급된 테스트 사례를 실행하기 위한 Runner 파일을 생성하는 것으로 시작했습니다.

여러 단계 끝에 테스트 결과의 실행 보고서를 볼 수 있었습니다.

이 튜토리얼이 Karate 프레임워크를 사용하여 첫 번째 테스트 스크립트를 작성하는 방법을 배우는 초보자에게 도움이 되었기를 바랍니다. API 테스트를 수행합니다. 이 상세한 단계별접근 방식은 API에서 다양한 테스트를 실행하고 실행할 수 있는 훌륭한 방법입니다.

NEXT>>>

Lee는 여가 시간에 이것을 개발했습니다.

가라테의 흥미로운 뿌리를 탐구하고 싶지만 지금은 개발된 가라테 도구 에 대해 이야기하겠습니다. Peter Thomas 작성, API 테스터를 구출하는 훌륭한 도구 중 하나.

Karate 프레임워크는 BDD 접근 방식을 따르는 프로그램 작성의 Cucumber 스타일을 따릅니다. 구문은 프로그래머가 아닌 사람이 이해하기 쉽습니다. 그리고 이 프레임워크는 API 자동화와 성능 테스트를 단일 독립 실행형 도구로 결합한 유일한 API 테스트 도구입니다.

사용자에게 병렬로 테스트 사례를 실행하고 JSON & XML 검사.

이 정보를 통해 Karate 도구를 자세히 이해하기 위한 특정 핵심 사항을 추론할 수 있습니다.

Karate는 대신 BDD 테스트 프레임워크입니다. TDD.
프로그래머가 아닌 사람도 쉽게 사용할 수 있도록 설계되었습니다. 이 기능은 기술적 배경이나 능력에 관계없이 많은 사람들이 더 많이 사용하고 액세스할 수 있도록 하므로 게임 체인저입니다.
Cucumber 기능 파일과 Gherkins 언어를 사용하여 테스트를 작성합니다. 매우 이해하기 쉽습니다.

이러한 모든 기능 덕분에 오늘날 사용할 수 있는 가장 유용한 자동화 도구 중 하나가 되었습니다.

가라테 프레임워크의 역사

작성자 ' Peter Thomas' 2017년에 이 소프트웨어는누구나 쉽게 사용할 수 있는 기능. Java로 작성되었고 대부분의 사람들은 파일도 동일한 언어로 작성될 것으로 예상했지만 다행히도 그렇지 않습니다.

오히려 Gherkins 파일을 사용합니다. 오이 프레임워크. 자동화 소프트웨어는 Cucumber의 확장이므로 작업에서 Gherkins 파일의 사용을 상속합니다. 이 둘의 가장 큰 차이점은 Karate는 테스트하는 동안 Java를 사용하지 않지만 Cucumber는 사용한다는 것입니다.

Gherkins 구문이 매우 읽기 쉽고 포괄적이기 때문에 이것이 프로그래머가 아닌 사용자에게 적합한 이유입니다. 이것이 Karate가 자동화된 API 테스트 세계에 진입하는 데 가장 적합하고 권장되는 이유입니다.

다음은 Karate 테스트 프레임워크의 일부 기능입니다.

이해하기 쉬운 Gherkins 언어를 사용합니다.
Java와 같은 기술 프로그래밍 지식이 필요하지 않습니다.
인기 있는 Cucumber 표준을 기반으로 합니다.
쉽게 프레임워크를 생성할 수 있습니다.
가라테 자체에서 제공하는 핵심 기능은 병렬 테스트이므로 Maven, Gradle 등에 의존할 필요가 없습니다.
테스트 디버깅을 위한 UI.
다른 파일에서 기능 파일 호출.
내부에서 구축된 데이터 드라이버 테스트를 지원하므로 외부 프레임워크에 의존할 필요가 없습니다.
내장 네이티브 레스트보고서. 또한 더 나은 UI 보고서와 더 명확성을 위해 Cucumber와 통합할 수 있습니다.
다양한 테스트 환경(QA, Stage, Prod, Pre-Prod)에서 구성을 전환하기 위한 사내 지원을 제공합니다.
유용할 수 있는 CI/CD 통합에 대한 원활한 지원.
다양한 HTTP 호출 처리 가능:
- 웹 소켓 지원
- SOAP 요청
- HTTP
- 브라우저 쿠키 처리
- HTTPS
- HTML 형식 데이터
- XML 요청

Karate와 Rest-Assured 비교

Rest Assured : REST 서비스를 테스트하기 위한 Java 기반 라이브러리입니다. 코드 라인을 작성하기 위해 Java 언어를 사용합니다. 다양한 요청 범주를 테스트하는 데 도움이 되며, 이를 통해 다양한 비즈니스 로직 조합을 검증할 수 있습니다.

Karate 프레임워크 : SOAP & REST 서비스.

다음 표에는 Rest-Assured와 가라테 프레임워크:

S.No	기준	가라테 프레임워크	REST-Assured
1	언어	오이와 오이의 조합을 사용합니다	Java 언어
2	코드 크기	를 사용합니다. 코드는 오이 같은 구조를 따르기 때문에 적습니다.	코드 라인은Java 언어 사용
3	기술 지식 필요	프로그래머가 아닌 사람도 쉽게 작성할 수 있음 Gherkins 코드	Java 코드를 작성하려면 기술 지식이 필요합니다.
4	Data-Driven Testing	동일한	데이터 테스트를 지원하기 위해 사내 태그를 사용할 수 있습니다
5	SOAP 호출 지원을 제공합니까?	예, 제공합니다	REST 요청에만 관련됩니다
6	병렬 테스트	예, 병렬 보고서 생성을 통해 병렬 테스트가 쉽게 지원됩니다. 너무	대부분은 아닙니다. 사람들이 시도했지만 성공률보다 실패율이 더 높습니다
7	보고	내부 보고 기능을 제공하므로 외부 플러그인에 의존할 필요가 없습니다. 더 나은 UI를 위해 Cucumber 보고 플러그인과 통합할 수도 있습니다.	Junit, TestNG
8 와 같은 외부 플러그인에 의존해야 합니다. 23>	외부 데이터에 대한 CSV 지원	예, Karate 0.9.0부터	아니요, Java 코드 또는 라이브러리를 사용해야 합니다
9	웹 UI 자동화	예, Karate 0.9.5부터 웹 UI 자동화가 가능합니다	아니요, 지원되지 않습니다
10	샘플 GET	`Given param val1 = ‘name1’ And param val2 = ‘name2’ And path ‘somelocation’ When method get Then match response contains ‘OKAY’`	`given(). param("val1", "name1"). param("val2", "name2"). when(). get("/some\location"). then(). body(containsString("OKAY"));`

따라서, 위의 차이점을 제외하면 가라테는 누구나 할 수 있는 가장 쉬운 일 중 하나라고 해도 무방합니다.

가라테 프레임워크 작업에 필요한 도구

이제 Karate 프레임워크를 중심으로 Karate 환경을 설정하는 데 필요한 프로세스와 도구를 살펴보겠습니다.

#1) Eclipse

Eclipse는 사용되는 통합 개발 환경입니다. 컴퓨터 프로그래밍 분야에서. 주로 Java 프로그래밍에 사용됩니다. 앞서 언급한 바와 같이 Karate는 Java로 작성되었으므로 Eclipse가 API 테스트 소프트웨어용 IDE인 이유가 더 합리적입니다. 또 다른 이유는 이것이 오픈 소스 도구이고 이것이 이 도구를 선택하는 꽤 강력한 이유입니다.

참고: IntelliJ, Visual Studio 및 기타 다른 도구를 사용할 수도 있습니다. 시장에서 사용할 수 있는 편집기입니다.

#2) Maven

이는 주로 Java 프로젝트 빌드에 사용되는 빌드 자동화 도구입니다. Karate 환경을 설정하고 코드를 작성하는 한 가지 방법입니다. Maven 요구 사항으로 Eclipse를 설정하려면 여기를 클릭하여 Maven을 설치할 수 있습니다.

Maven에서 작업하는 동안 Maven 종속성을 사용하면 Karate 프레임워크를 지원하는 데 도움이 됩니다.

다음 종속성은 pom.xml에서 Maven과 함께 사용됩니다.

   com.intuit.karate karate-apache 0.9.5 test   com.intuit.karate karate-junit4 0.9.5 test

참고: 최신 버전은Maven 저장소에서 사용할 수 있습니다.

#3) Gradle

Gradle은 Maven의 대안이며 동일한 용량으로 사용할 수 있습니다. 유사점과 차이점이 있지만 가라데 코드에 대한 환경을 설정하는 데 동일하게 사용할 수 있습니다.

사용하기 쉽고 유연하며 응용 프로그램에 모듈화 및 관리 요구 사항이 있을 때 사용하는 것이 좋습니다. 많은 플러그인. Gradle 설정 코드는 다음과 같습니다.

testCompile 'com.intuit.karate:karate-junit4:0.6.0' testCompile 'com.intuit.karate:karate-apache:0.6.0'

참고: MAVEN 또는 GRADLE.

0을 사용할 수 있습니다> #4) 시스템에 Java 환경 설정

Karate Framework 스크립트를 시작하려면 JDK 및 JRE 환경을 설정해야 합니다.

Karate 테스트 스크립트의 구조

Karate 테스트 스크립트는 ".feature" 확장자를 소유하는 것으로 알려져 있습니다. 이 속성은 오이에서 상속됩니다. Java 규칙의 파일 구성도 동일하게 허용됩니다. Java 패키지 규칙에 따라 파일을 자유롭게 구성할 수 있습니다.

그러나 Maven 지침에서는 비Java 파일의 저장을 별도로 수행하도록 지시합니다. src/test/resources 구조에서 수행됩니다. 그리고 Java 파일은 src/main/java 아래에 보관됩니다.

그러나 Karate Framework의 제작자에 따르면 그들은 우리가 Java 파일과 비Java 파일을 모두 함께 보관할 것이라고 굳게 믿고 있습니다. 옆. 그들에 따르면, 그것을 찾는 것이 훨씬 쉽습니다.*.java 및 *.feature 파일은 표준 Maven 구조를 따르지 않고 함께 보관됩니다.

이 작업은 다음과 같이 pom.xml을 조정하여 쉽게 수행할 수 있습니다(Maven용).

    src/test/java  **/*.java     ...

다음은 Karate Framework의 일반적인 구조에 대한 개요입니다.

이 Karate Framework는 기능 파일을 실행하기 위해 Cucumber에서도 필요한 Runner 파일이므로 대부분의 작성은 Cucumber 표준을 따릅니다.

그러나 Cucumber와 달리 단계는 Karate에서 명확한 정의를 필요로 하지 않으며 , 차례로 유연성과 작업 용이성을 향상시킵니다. 우리는 Cucumber 프레임워크를 따를 때 일반적으로 추가해야 하는 추가 접착제를 추가할 필요가 없습니다.

"Runner" 클래스는 대부분 TestRunner.java. 라는 이름입니다.

TestRunner.java 파일은 다음 형식을 취합니다.

 import com.intuit.karate.junit4.Karate; import org.junit.runner.RunWith; @RunWith(Karate.class) public class TestRunner { }

.feature 파일에는 모든 테스트가 포함되어 있습니다. API가 예상 요구 사항에 따라 작동하는지 확인하기 위해 테스트해야 하는 시나리오입니다.

일반적인 *.feature 파일은 다음과 같습니다.

 Feature: fetching User Details Scenario: testing the get call for User Details Given url '//reqres.in/api/users/2' When method GET Then status 200

첫 번째 기본 Karate 테스트 스크립트 만들기

이 섹션은 API를 Karate 프레임워크 형식으로 변환하는 데 도움이 되는 첫 번째 테스트 스크립트 만들기를 시작하는 데 도움이 됩니다.

기본 가라테 테스트 스크립트를 작성하기 전에컴퓨터에 다음 필수 구성 요소를 설치하십시오:

Eclipse IDE
Maven. 적절한 Maven 경로를 설정합니다.
JDK & JRE. 적절한 경로를 설정합니다.

단계별 접근 방식을 살펴보겠습니다.

#1) new MAVEN Eclipse 편집기의 프로젝트

Eclipse 열기
파일을 클릭합니다. 새 프로젝트를 선택합니다.

Maven 프로젝트 선택

선택 Workspace 위치.
Archetype을 선택합니다(일반적으로 간단한 Maven 프로젝트의 경우 " Maven-archetype-quickstart 1.1 " 선택).
제공 그룹 ID & Artifact ID(이 예제에서는 다음 값을 사용했습니다).
- 그룹 ID : Karate
- Artifact ID: KarateTestScriptsSample
완료를 클릭하여 setup.

#2) 생성이 완료되면 이제 프로젝트 탐색기 창에서 다음과 같은 구조를 볼 수 있습니다.

#3) 모든 종속 항목을 포함합니다.

첫 번째 단계인 설정 후 필요한 모든 종속 항목을 포함 합니다. 실행을 위해. POM.xml 아래에 모든 태그를 유지합니다(POM.xml 사용법을 이미 알고 있다고 가정).

POM.xml을 열고 종속성 태그 아래에 아래 코드를 복사하고 저장합니다. file.

  com.intuit.karate karate-apache 0.9.5 test   com.intuit.karate karate-junit4 0.9.5 test

소스를 보려면 여기를 클릭하세요.

#4) 시나리오를 브레인스토밍하고 무엇을 테스트할 것인지