निष्पादन योग्य विनिर्देश: SpecFlow A to Z

यह लेख पहले भाग की एक निरंतरता है और SpecFlow का उपयोग करके "निष्पादन योग्य विनिर्देश" के साथ काम करने के तकनीकी विवरणों का खुलासा करता है।

आरंभ करने के लिए, आपको विज़ुअल स्टूडियो (आधिकारिक साइट से डाउनलोड किया गया) और SpecFlow पैकेज ( नग से स्थापित) के लिए प्लग-इन की आवश्यकता है।

तो, हमारे उत्पाद मालिक ने टीम को एक कैलकुलेटर विकसित करने के लिए कहा ...

@calculator Feature: Sum As a math idiot I want to be told the sum of two numbers So that I can avoid silly mistakes @positive @sprint1 Scenario: Add two numbers Given I have entered 50 into the calculator And I have entered 70 into the calculator When I press add Then the result should be 120 on the screen 

यह @ विशेषताओं पर ध्यान देने योग्य है। उनके पास कई महत्वपूर्ण गुण हैं। सबसे पहले, यदि आप NUnit का उपयोग करते हैं, तो SpecFlow विशेषता जोड़ें [NUnit.Framework.CategoryAttribute ("कैलकुलेटर")] । यह परीक्षण योजना बनाने के लिए बहुत सुविधाजनक है। वर्गीकरण R # द्वारा समर्थित है, मूल NUnit धावक और टीम सिटी।

आइए इस परिदृश्य को स्वचालित करें। इस समय तक, डेवलपर्स ने पहले ही कैलकुलेटर इंटरफ़ेस तैयार कर लिया है:

 public interface ICalculator { decimal Sum(params decimal[] values); decimal Minus(decimal a, decimal b); decimal Sin(decimal a); decimal Multiply(params decimal[] values); decimal Divide(decimal a, decimal b); } 

एक सेवा परीक्षण संदर्भ जोड़ें:

 public class CalculationContext { private readonly List<decimal> _values = new List<decimal>(); public ICalculator Calculator { get; private set; } public decimal Result { get; set; } public Exception Exception { get; set; } public List<decimal> Values { get { return _values; } } public CalculationContext() { Calculator = new Calculator(); } } 

SpecFlow चरणों को स्वचालित करने के लिए विशेष विशेषताओं का उपयोग करता है:

 [Binding] public class Sum : CalcStepsBase { public CalculationContext Context {get;set;} public Sum(CalculationContext context) { Context = CalculationContext(); } [Given("I have entered (.*) into the calculator")] public void Enter(int digit) { Context.Values.Add(digit); } [When("I press (.*)")] public void Press(string action) { switch (action.ToLower()) { case "add": case "plus": Context.Result = Context.Calculator.Sum(Context.Values.ToArray()); break; default: throw new InconclusiveException(string.Format("Action \"{0}\" is not implemented", action)); } } [Then("the result should be (.*) on the screen")] public void Result(decimal expected) { Assert.AreEqual(expected, Context.Result); } } 

इस दृष्टिकोण के कई फायदे हैं:

1. प्रत्येक चरण को केवल एक बार स्वचालित करने की आवश्यकता है।
2. आप जटिल वंशानुक्रम श्रृंखला के साथ समस्याओं से बचते हैं, कोड बहुत स्पष्ट दिखता है
3. गुण नियमित अभिव्यक्ति का उपयोग करते हैं, इसलिए एक विशेषता कई चरणों को "पकड़" सकती है। जब इस मामले में, गुण, "जोड़" और "जोड़" वाक्यांशों के लिए काम करेंगे

सब कुछ, सभी चरणों को लागू किया जाता है, परीक्षण सीधे .feature फ़ाइल से चलाया जा सकता है।

वैकल्पिक रिकॉर्ड

 @positive Scenario: Paste numbers Given I have entered two numbers | a | b | | 1 | 2 | When I press add Then the result should be 3 on the screen [Given("I have entered two numbers")] public void Paste(Table values) { var calcRow = values.CreateInstance<CalcTable>(); Context.Values.Add(calcRow.A); Context.Values.Add(calcRow.B); } public class CalcTable { public decimal A { get; set; } public decimal B { get; set; } } 

इस प्रकार की रिकॉर्डिंग सुविधाजनक हो सकती है जब आपको किसी बड़ी वस्तु को भरने की आवश्यकता होती है। उदाहरण के लिए, उपयोगकर्ता खाते की जानकारी।

क्या हम केवल एक डेटा सेट का परीक्षण करने जा रहे हैं?

बेशक, एक परीक्षण पर्याप्त नहीं है, इसलिए विभिन्न संख्याओं के लिए दर्जनों स्क्रिप्ट लिखना एक संदिग्ध खुशी है। परिदृश्य की रूपरेखा बचाव के लिए आती है

 @calculator Feature: Calculations As a math idiot I want to be told the calculation result of two numbers So that I can avoid silly mistakes @positive @b12 @tc34 Scenario Outline: Add two numbers Given I have entered <firstValue> into the calculator And I have entered <secondValue> into the calculator When I press <action> Then the <result> should be on the screen Examples: | firstValue | secondValue | action | result | | 1 | 2 | plus | 3 | | 2 | 3 | minus | -1 | | 2 | 2 | multiply | 4 | 

SpecFlow तालिका से प्लेसहोल्डर में मूल्यों को प्रतिस्थापित करेगा। पहले से ही खराब नहीं है, लेकिन स्वचालन को जोड़ा जाना चाहिए:

 [When("I press (.*)")] public void Press(string action) { switch (action.ToLower()) { case "add": case "plus": Context.Result = Context.Calculator.Sum(Context.Values.ToArray()); break; case "minus": Context.Result = Context.Calculator.Minus(Context.Values[0], Context.Values[1]); break; case "multiply": Context.Result = Context.Calculator.Multiply(Context.Values.ToArray()); break; case "sin": Context.Result = Context.Calculator.Sin(Context.Values[0]); break; default: throw new InconclusiveException(string.Format("Action \"{0}\" is not implemented", action)); } } [Then("the result should be (.*) on the screen")] [Then("the (.*) should be on the screen")] public void Result(decimal expected) { Assert.AreEqual(expected, Context.Result); } 

हमने बेहतर पठनीयता के लिए दूसरी पंक्ति बदल दी। इसलिए, दूसरी विशेषता को परिणाम विधि पर लटका दिया जाना चाहिए। बाहर निकलने पर आपको प्रपत्र की रिपोर्ट के साथ 3 परीक्षण प्राप्त होंगे:

 Given I have entered 1 into the calculator -> done: Sum.Enter(1) (0,0s) And I have entered 2 into the calculator -> done: Sum.Enter(2) (0,0s) When I press plus -> done: Sum.Press("plus") (0,0s) Then the result should be 3 on the screen -> done: Sum.Result(3) (0,0s) 

नकारात्मक परीक्षणों के बारे में क्या?

0 से एक विभाजन जांच जोड़ें:

 @calculator Feature: Devision As a math idiot I want to be told the devision of two numbers So that I can avoid silly mistakes @negative @exception Scenario: Zero division Given I have entered 10 into the calculator And I have entered 0 into the calculator When I press divide Then exception must occur 

इस मामले में, मैं कटलेट के साथ मक्खियों के साथ हस्तक्षेप नहीं करना चाहता हूं और विभाजन के लिए मैं एक अलग फाइल रखना पसंद करूंगा। सवाल है। संदर्भ के साथ क्या करना है? वह सम क्लास में रहे। SpecFlow कंस्ट्रक्टर में इंजेक्शन का समर्थन करता है। आधार वर्ग का चयन करें:

 public class CalcStepsBase { protected CalculationContext Context; public CalcStepsBase(CalculationContext context) { Context = context; } } 

नई कक्षा को उसमें से विभाजित करने के चरणों के साथ सम्मिलित करें:

 [Binding] public class Division : CalcStepsBase { public Division(CalculationContext context) : base(context) { } [When("I press divide"), Scope(Scenario = "Zero division")] public void ZeroDivision() { try { Context.Calculator.Divide(Context.Values[0], Context.Values[1]); } catch (DivideByZeroException ex) { Context.Exception = ex; } } [Then("exception must occur")] public void Exception() { Assert.That(Context.Exception, Is.TypeOf<DivideByZeroException>()); } } 

आदेश में कि बैड संघर्ष नहीं करते हैं, हम उन्हें सकारात्मक और नकारात्मक में विभाजित करेंगे

 [When("I press (.*)"), Scope(Tag = "positive")] [When("I press divide"), Scope(Scenario = "Zero division")] 

हम स्क्रिप्ट और टैग दोनों के दायरे को फ़िल्टर कर सकते हैं।

डेटा चालित परीक्षण

जोड़, घटाव और गुणा के चार उदाहरण स्पष्ट रूप से पर्याप्त नहीं हैं। इनपुट और आउटपुट वैल्यू के प्रभावशाली वॉल्यूम के साथ कई सिस्टम हैं। इस मामले में, डीएसएल में शीट बहुत स्पष्ट नहीं दिखेगी। एक तरफ परीक्षण लिखने के लिए, और दूसरी तरफ, GWT प्रारूप को बचाने के लिए, आप दो तरीकों से जा सकते हैं:

1. BDDfy का प्रयोग करें
2. अपनी आवश्यकताओं के लिए SpecFlow समाप्त करें

मैं दूसरे विकल्प पर बस गया, ताकि दो प्रारूपों का समर्थन न करूं:

 [TestFixture] [Feature( "Sum Excel", As = "Math idiot", IWant = "to be told sum of two numbers", SoThat = "I can avoid silly mistakes")] public class ExcelSumTests : GherkinGenerationTestsBase { [TestCaseSource("Excel")] [Scenario("Sum Excel", "excel", "positive", "calculator")] public void AddTwoNumbers_TheResultShouldBeOnTheScreen(string firstValue, string secondValue, string action, string result) { Given(string.Format("I have entered {0} into the calculator", firstValue)); Given(string.Format("I have entered {0} into the calculator", secondValue), "And "); When(string.Format("I press {0}", action)); Then(string.Format("the result should be {0} on the screen", result)); } public static IEnumerable<object[]> Excel() { return ExcelTestCaseDataReader.FromFile("Sum.xlsx").GetArguments(); } } 

पृष्ठभूमि और पूर्व शर्त

कभी-कभी परिदृश्यों के एक पूरे समूह के लिए आपको पूर्व शर्त का एक सेट निर्दिष्ट करने की आवश्यकता होती है। उन्हें प्रत्येक परिदृश्य में कॉपी करना स्पष्ट रूप से सुविधाजनक नहीं है। दो दृष्टिकोण बचाव के लिए आते हैं।

पृष्ठभूमि

 Background: Given Calculator is initialized @positive Scenario: Add two numbers Given I have entered 1 into the calculator When I press sin Then the result should be 0.841470984807896 on the screen 

पृष्ठभूमि अनुभाग में, आप स्क्रिप्ट के लिए अधिक से अधिक पूर्व शर्त बना सकते हैं।

टैग का उपयोग करना

टैग का उपयोग करके पूर्व-शर्तें भी लागू की जा सकती हैं:

 [Binding] public class Sum : CalcStepsBase { public Sum(CalculationContext context) : base(context) { } [BeforeScenario("calculator")] [Given("Calculator is initialized")] public void InitCalculator() { Context.Init(); } } 

लिपि के चलने से पहले, फर्स्टसेंसरियो विशेषता के साथ चिह्नित विधि निष्पादित की जाएगी। गुंजाइश को सीमित करने के लिए निर्माणकर्ता को विशेषताएँ दी जाती हैं। हमने कैलकुलेटर टैग के साथ स्क्रिप्ट को टैग किया। अब, ऐसी स्क्रिप्ट के प्रत्येक रन से पहले, InitCalculator पद्धति निष्पादित की जाएगी।

रिपोर्ट

एक रिपोर्ट बनाने के लिए, आपको उपयोगिता specflow.exe और nunit की आवश्यकता होगी। नीचे एक msbuild स्क्रिप्ट है जो पहले ननिट चलती है और फिर एक स्पेकफ्लो रिपोर्ट बनाती है।

 <?xml version="1.0" encoding="utf-8" ?> <Project ToolsVersion="4.0" DefaultTarget="Compile" xmlns="http://schemas.microsoft.com/developer/msbuild/2003"> <ItemGroup> <NUnitAddinFiles Include="$(teamcity_dotnet_nunitaddin)-2.6.2.*" /> </ItemGroup> <PropertyGroup> <teamcity_build_checkoutDir Condition=" '$(teamcity_build_checkoutDir)' == '' ">.</teamcity_build_checkoutDir> <NUnitHome>C:/Program Files (x86)/NUnit 2.6.2</NUnitHome> <NUnitConsole>"$(NUnitHome)\bin\nunit-console.exe"</NUnitConsole> <testResultsTxt>"$(teamcity_build_checkoutDir)\TestResult.txt"</testResultsTxt> <testResultsXml>"$(teamcity_build_checkoutDir)\TestResult.xml"</testResultsXml> <projectFile>"$(teamcity_build_checkoutDir)\Etna.QA.SpecFlow.Examples\Etna.QA.SpecFlow.Examples.csproj"</projectFile> <SpecflowExe>"C:\Program Files (x86)\TechTalk\SpecFlow\specflow.exe"</SpecflowExe> </PropertyGroup> <Target Name="RunTests"> <MakeDir Directories="$(NUnitHome)/bin/addins" /> <Copy SourceFiles="@(NUnitAddinFiles)" DestinationFolder="$(NUnitHome)/bin/addins" /> <Exec Command="$(NUnitConsole) /domain:multiple /labels /out=$(testResultsTxt) /xml=$(testResultsXml) $(projectFile)" ContinueOnError="true"/> </Target> <Target Name="SpecflowReports"> <Exec Command="$(SpecflowExe) nunitexecutionreport $(projectFile) /xmlTestResult:$(testResultsXml) /testOutput:$(testResultsTxt) /out:"$(teamcity_build_checkoutDir)/SpecFlowExecutionReport.html""/> <Exec Command="$(SpecflowExe) stepdefinitionreport $(projectFile) /out:"$(teamcity_build_checkoutDir)/SpecFlowStepDefinitionReport.html""/> </Target> </Project> 

यह / डोमेन पर ध्यान देने योग्य है : एकाधिक ध्वज। यह NUnit को उस फ़ोल्डर से असेंबली चलाने के लिए कहता है जिसमें यह स्थित है। अन्यथा, कॉन्फ़िगरेशन के साथ समस्याएं हो सकती हैं।

नतीजतन, हमें ऐसी रिपोर्ट मिलती है

टीम सिटी में निर्धारित लॉन्च

बिल्ड सेटअप में, आपको नई कलाकृति निर्दिष्ट करने की आवश्यकता है: हमारी प्रगति रिपोर्ट:


NUnit शुरू करने के साथ कदम के बजाय, हम msbuild स्क्रिप्ट का उपयोग करेंगे जो हमने पहले लिखा था:

टीम सिटी में एक नया रिपोर्ट टैब दिखाई देगा। यहाँ यह इस तरह दिखता है:

गैर-स्वचालित स्क्रिप्ट वायलेट में दिखाए जाते हैं, सफल परीक्षण हरे रंग में पूरे होते हैं, परीक्षण लाल वाले के साथ विफल होते हैं।
एक शेड्यूल पर परीक्षणों को चलाने के लिए सभी को एक ट्रिगर रखना है।

टास्क ट्रैकर सिंक

TechTalk आवश्यकताओं को प्रबंधित करने और कार्य ट्रैकर्स के साथ संवाद करने के लिए अपने वाणिज्यिक SpecLog उत्पाद प्रदान करता है। उन्होंने कई कारणों से हमें सूट नहीं किया। मैं वर्तमान में TFS परीक्षण मामलों के साथ SpecFlow परीक्षण मामलों को पारदर्शी रूप से जोड़ने पर काम कर रहा हूं। अपडेट 2 के साथ, टैग TFS में दिखाई दिए। कार्य ट्रैकर के साथ संवाद करने के लिए एनोटेशन में समझौतों का उपयोग करने का विचार दिलचस्प लगता है, उदाहरण के लिए: @ b8924 , tc345 । जैसे ही एक कार्य समाधान दिखाई देता है, मैं इसके बारे में लिखूंगा।

सेलेनियम वेबड्राइवर और स्पेकफ्लो के साथ काम करने के तकनीकी पहलू

इस लेख में वर्णित है।