cabbott / Tatami-dotnet

Tatami is a C# library for web application testing.

# Tatami.NET Tatami is a C# library for web application testing.

• Manages test cases in CSV file like this.
  • HTTP request conditions to get test documents (Uri, Method, UseAgent, QueryString, PathInfos, Header, Cookie)
  • Test cases and Assert conditions
• Verifies HTTP response information.
  • HTTP response header, cookies, status code, URL
  • Document structure (HTML, XML, JSON and Other text format)
• Can be integrated in major C# test frameworks and CI.
  • NUnit, MS Test, Jenkins, TeamCity, etc.

Tatami enables you to reduce test codes and help review for test cases.

Contents

• Scope
• Functions
• Showcase
• Implementation
  • How to create a test case CSV
  • How to create BaseUriMapping.xml
  • How to create UserAgentMapping.xml
• nuget package
• Setup steps
• Dependencies
• Copyright

Scope

This library covers the following test types.

• Integration Test
• Acceptance Test
• Smoke Test
• (not for Unit Test)

Functions

Tatami provides the following test functions.

• Manage HTTP request information, test cases and assert conditions in CSV.
• Get expected and actual documents (such as HTML, XML, JSON and Other formats).
• Test HTTP response information (Uri, Status Code, Header, Cookie, Format using XSD).
• Test response documents using expected values, XPath and regular expression.
• Provide failed information.

Showcase

1. HTML page test (Wikipedia)

Test a HTML structure of "United States" page using static expected values.

• This scenario covers to test between html values and static values in CSV.
• See Wikipedia page test for details.

2. HTML page test using Web API (Yahoo Weather)

Test a HTML structure of "New York" page using values from Web API (Yahoo Weather RSS).

• Recent Web applications consume data created by Web API instead of database. This scenario will cover to test values between HTML and XML from Web API.
• See Yahoo Weather page test for details.

3. Web API test (XML/JSON)

• Test Web API which returns XML/JSON using static values.
• See Yahoo API test for details.

Implementation

How to create a test case CSV

See CSV implementation for details.

How to create BaseUriMapping.xml

See BaseUriMapping.xml settings for details.

How to create UserAgentMapping.xml

See UserAgentMapping.xml settings for details.

nuget package

https://www.nuget.org/packages/Tatami.NET/

Setup steps

1. Create a C# test project.
2. Install Tatami library from nuget.org then sets this into the project.
   • https://www.nuget.org/packages/Tatami.NET/
3. Create a BaseUriMapping.xml
   • See more details : BaseUriMapping.xml settings
4. Create a UserAgentMapping.xml
   • See more details : UserAgentMapping.xml settings
5. Create a CSV file including test cases.
   • Csv file : https://docs.google.com/spreadsheets/d/1Gvnq2NlBXyrnsjBH0Xr-R8U0f9RLeCR9RH5eAdTL_XE/edit?usp=sharing
6. Create a test method.
   • samples/SampleTest/Wikipedia/WikipediaTests.cs
7. Run test.

Dependencies

• CsvParser.NET
• HtmlAgilityPack
• Newtonsoft.Json

Copyright

Copyright (c) 2014 kenyamat. Licensed under MIT.