Syringe is a .NET automated HTTP testing tool for headless, Javascript-ignorant tests.

Syringe is a HTTP runner - if you can reach a server endpoint via HTTP, Syringe will be able to test it. It's purpose is:

1. To check canary pages (HTML, XML, JSON, TXT etc.)
2. To perform advanced smoke testing - get a HTML page (or other text-based resource) and assert that it contains some text.
3. Basic end-to-end HTTP tests. For example logging into a website and checking a page.

Our help files are hosted at ReadTheDocs.

Make sure you have IIS enabled.

• Install chocolatey
• Install nuget command line : choco install nuget.commandline
• Powershell 4+: choco install powershell4

    # Work around for bug in the mongodb Chocolately package
    $env:systemdrive = "C:\ProgramData\chocolatey\lib\mongodata"
    choco install mongodb

Syringe uses OAuth2 for its security. It currently supports Github, Google and Microsoft OAuth2 providers.

• Register an Syringe OAuth2 app in Github. The callback url should be http://localhost:1980
• Edit the configuration.json file in the service directory to use the OAuth2 client id/secret.

Once you have extracted the release, in Powershell run .\iis.ps1

The Syringe REST API runs as Windows service, which can also be run as a command line app. This API is used to run all tests and is the data repository, it runs its own embedded HTTP server.

• Run .\Syringe.Service.exe
• Browse to http://localhost:1980 and login.

Once you've cloned the repository, run setup.ps, this will:

• Build the solution, restoring the nuget packages
• Create an IIS site
• Create C:\syringe folder with an example file.

Follow the "Configure OAuth" and "Start the service" steps above