The main goal is to simplify integrationtesting on the .NET platform, foremost on websites using an authentication mechanism like basic authentication. This includes to run them fast, without the hassle of having to start up a real browser or to install browser version xyz on your machine.
You could think of HttpGhost as a simple web browser (currently without javascript support) with capabilites to easily find html elements by css-selectors (or xpath), to follow links or post forms. But it does not stop with html, HttpGhost can also handle JSON and has built in support (by using JSON.NET) to easily convert a JSON-response to your desired type.
It can be installed using nuget: Install-Package HttpGhost
HttpGhost can be used with any unit test framework, which makes it easy to plugin with your existing CI-server. It could be used in a simple console application to try out some JSON api or what not.
- JSON.NET
- HtmlAgilityPack
If you want to make a contribution, that would be great! I would suggest you to first create a issue regarding the change you want to make, fork and create a pull request.
[Test]
public void Get_SomeUrl_ReturnsSomeData()
{
var session = new HttpSession();
var result = session.Get(URL);
Assert.That(result.Response.Body, Is.StringContaining("somedata"));
}
[Test]
public void Get_SomeUrl_IsPdf()
{
var session = new HttpSession();
var result = session.Get(URL);
Assert.That(result.Response.Headers[HttpResponseHeader.ContentType], Is.StringContaining("pdf"));
}
[Test]
public void Post_SomeUrl_IsPdf()
{
var session = new HttpSession();
var result = session.Post(URL);
Assert.That(result.Response.Headers[HttpResponseHeader.ContentType], Is.StringContaining("pdf"));
}
[Test]
public void Post_URL_ReturnCreated()
{
var session = new HttpSession();
var result = session.Post(URL, new { title = "jippi" });
Assert.That(result.Response.StatusCode, Is.EqualTo(HttpStatusCode.Created));
}
[Test]
public void Put_URL_ReturnHtml()
{
var session = new HttpSession();
var result = session.Put(URL, new { Title = "jippi" });
Assert.That(result.Response.Body, Is.StringContaining("Putting"));
}
[Test]
public void Delete_URL_ReturnHtml()
{
var session = new HttpSession();
var result = session.Delete(URL, new { id = 2 });
Assert.That(result.Response.Body, Is.StringContaining("Deleting"));
}[Test]
public void Get_URL_ReturnsTwoListItems()
{
var session = new HtmlSession();
var elements = session.Get(URL).Find("li.beer"); //GET-request on URL, then selects out all li-elements which has the cssclass beer
Assert.That(elements.Count(), Is.EqualTo(2));
}
[Test]
public void Get_URL_LinkWorks()
{
var session = new HtmlSession();
var result = session.Get(URL).Follow("#mylink"); //first GET-request on URL, then another GET-request using the href of a#mylink
Assert.That(result.Response.Body, Is.EqualTo("Followed"));
}
[Test]
public void OnURL_SubmitForm_ReturnsResult()
{
var session = new HtmlSession();
var form = session.Get(URL).FindForm("#form"); //GET-request and find form with Id="form"
form.SetValue("#input1", "monkey"); //find input with id="input1" and set its value="monkey"
var result = form.Submit(); //submit form (POST the form values using the forms action attribute)
Assert.That(result.Response.Body, Is.StringContaining("monkey"));
}[Test]
public void Get_URL_CanConvertResultToObject()
{
var session = new JsonSession();
var result = session.Get(URL);
var obj = result.To<TestClass>(); //converts to any class, or dynamic
Assert.That(obj.A, Is.EqualTo("b"));
}
[Test]
public void Get_URL_ReturnsTwoBeers()
{
var session = new HttpSession(USERNAME, PASSWORD);
...
}