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.

You can get the latest release of Syringe HERE

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