Skip to content
QuickFIX/n implements the FIX protocol on .NET.
C# Ruby CSS Batchfile HTML XSLT
#383 Compare This branch is 979 commits ahead, 1 commit behind kennystone:master.
Latest commit a3439d1 Apr 14, 2016 @cbusbey cbusbey fixed broken link in header
Failed to load latest commit information.
AcceptanceTest Merge branch 'master' into i270 Jul 13, 2015
Examples Merge branch 'master' of github.com:Daniel-Svensson/quickfixn into 16… Oct 7, 2013
QuickFIXn Merge pull request #295 from staffanu/require-ipv4 Mar 17, 2016
UnitTests Merge pull request #342 from akamyshanov/fix-ThreadedSocketAcceptor-r… Feb 29, 2016
config WIP: release script Nov 9, 2011
generator (#175) correct some date fields to be generated/validated as DateOnly… Oct 3, 2013
resources/nunit updated solution to include nunit Jun 20, 2009
scripts correct script per new rubyzip gem interface Dec 11, 2013
spec corrections/updates to FIX44 spec based on diff with QF/j version May 20, 2013
tutorial doc note for ReconnectInterval; close #213 Aug 13, 2014
web Download page / version number for version v1.6.0 Feb 4, 2016
.gitattributes Update gitattributes to corrupt certificates Mar 31, 2013
.gitignore ignore a generated AT cfg Jun 9, 2015
.slugignore change all occurrences of "QuickFIX.net" to "QuickFIXn", including fi… Jun 27, 2012
CONTRIBUTING.md added section about before you contribute Feb 18, 2016
Gemfile so long albino :( Oct 2, 2011
Gemfile.lock lock file Oct 2, 2011
LICENSE License file Nov 16, 2011
NEXT_VERSION.md tweak 1.6.0 release notes Feb 4, 2016
QuickFIXn.sln converted to vs2010 Sep 7, 2012
README.md fixed broken link in header Apr 14, 2016
RELEASE_NOTES.md argh typo Feb 5, 2016
acceptance_test.bat (#80) AT: logon with reset after disconnect Jun 8, 2015
appveyor.yml appveyor yaml config file working Feb 4, 2016
build.bat change all occurrences of "QuickFIX.net" to "QuickFIXn", including fi… Jun 27, 2012
build.sh sh versions of bat scripts for mono (experimental) Jan 14, 2013
config.ru we are using sinatra for website, here is the basic code Oct 2, 2011
generate.bat buildbot has trouble running this command. It will call this script i… Oct 25, 2011
package_release.bat change all occurrences of "QuickFIX.net" to "QuickFIXn", including fi… Jun 27, 2012
unit_test.bat suppress error messages when files-to-be-deleted don't exist Sep 7, 2012
unit_test.sh sh versions of bat scripts for mono (experimental) Jan 14, 2013

README.md

QuickFIX/N

Build status

For tutorials on how to use QuickFIX/n, see the tutorial folder at the root of this project or visit the website.

This README is about setting up your system to do QuickFIX/n development.

System Setup

This project requires the following:

To build

  • Ruby (1.9.3 recommended) (used to generate message and field classes from the DataDictionary xml file)
  • Visual Studio 2010 or higher

To run tests

  • NUnit
  • xsltproc (can be gotten via cygwin, or by installing libxslt (which requires libxml2 and zlib)).
    • xsltproc is only used for pretty-formatting the test output. If you don't mind the error messages that appear because it's not found, you can ignore it. (We may get rid of this dependency.).

Code Generation

To regenerate the message and field class source from the Data Dictionaries, you need Ruby and the Nokogiri gem:

gem install nokogiri
generate.bat

Build

To build the project, run:

build.bat

You can also override the default target, configuration, and .NET framework version by giving command line arguments:

build.bat Rebuild Release v3.5

The build.bat script expects MSBuild.exe to be on your PATH. If you run it from a Visual Studio cmd shell, this should not be a problem. However, if you run it from some other shell (e.g. cygwin), you may need to append something like:

C:\WINDOWS\Microsoft.NET\Framework\v4.0.30319

to your PATH environment variable. (Note, this build tools dir does not mean that the project will build for .NET 4.0; these are merely the build tools that come with VS 2010.)

Unit Tests

To run the NUnit tests, run:

unit_test.bat

(This script expects nunit-console.exe to be on your PATH. You may have to append something like C:\Program Files\NUnit 2.6.1\bin to your PATH environment variable.)

An HTML report of the test results will then be available here:

UnitTests\bin\Release\UnitTests.html

To run a Unit Test in the debugger (not sure if it works in VS Express):

  1. Right-click UnitTests project, click 'Properties'
  2. Go to Debug tab
  3. Change Start Action to 'Start external program: C:\Program Files\NUnit 2.6.1\bin\nunit.exe' (change the path to what is appropriate for your system)
  4. Set your 'Command line arguments' to 'C:\dev\quickfixn\UnitTests\bin\Debug\UnitTests.dll' (change the path to what is appropriate for your system)
  5. Set your 'Working directory' to 'C:\dev\quickfixn\UnitTests\bin\Debug\' (change the path to what is appropriate for your system)
  6. Open NUnit in debugger as follows: Right-click UnitTests, choose Debug->Start New Instance
  7. NUnit GUI will open and VS will be in debugger mode. You can choose and run tests. If you recompile, you may need to close and relaunch NUnit.

Acceptance Tests

To run the full suite of acceptance tests:

acceptance_test.bat

An HTML report of the test results will then be available here:

AcceptanceTests\AcceptanceTests.html

To run one particular acceptance test, e.g. fix42\14e_IncorrectEnumValue.def:

cd AcceptanceTest
runat.bat release 5003 definitions\server\fix42\14e_IncorrectEnumValue.def cfg\at_42.cfg

(See acceptance_test.bat for the proper port numbers and config files to use in the above command.)

The test results will then be available in AcceptanceTests\TestResults.xml and debug information will be available in the AcceptanceTests\log directory.

To run a test with the debugger,

  1. Open the solution file in Visual Studio
  2. Right click on "AcceptanceTest" project and choose "Properties" from the menu
  3. Click "Debug" on the left hand nav bar
  4. Set "Command line arguments" to the relevant "cfg\at_XX.cfg" for your test
  5. Set the working directory to "[yourpath]\quickfixn\AcceptanceTest"
  6. Save the properties
  7. Right click the "AcceptanceTest" project, go to Debug -> Start New Instance
  8. In command terminal, go into "AcceptanceTest" directory
  9. Run: ruby Runner.rb 127.0.0.1 5001 definitions\server\fix42\YourTestName.def

Credits

Connamara Systems

QuickFIXn is maintained and funded by Connamara Systems, llc.

The names and logos for Connamara Systems are trademarks of Connamara Systems, llc.

Licensing

This software is available under the QuickFIX Software License. Please see the LICENSE for the terms specified by the QuickFIX Software License.

Something went wrong with that request. Please try again.