For tutorials on how to use QuickFIX/n, visit the website.
This README is about setting up your system to do QuickFIX/n development.
This project requires the following:
To build and run tests
- Ruby (2.5+ recommended) (used to generate message and field classes from the DataDictionary xml file)
- From the command-line: dotnet 2.0.0 or higher
- From Visual Studio: version 2017 or higher
To regenerate the message and field class source from the Data Dictionaries, you need Ruby and the Nokogiri gem:
gem install nokogiri ruby generator\generate.rb
To build the project, run:
You can also override the default configuration (Release) by giving a command line argument:
The build.bat script expects dotnet to be on your PATH.
Alternatively, simply use the dotnet tools.
To run the NUnit tests, run:
(This script expects
dotnet to be on your PATH.)
TRX reports of the test results (one each for NET Framework 4.5.2 and NET Standard 2.0) will then be available here:
Alternatively, simply use
dotnet test UnitTests
To run a Unit Test in the debugger:
- Open the TestExplorer from Test -> Windows -> Test Explorer
- Navigate to the test
- Right-click and select "Debug Selected Tests"
To run the full suite of acceptance tests:
An HTML report of the test results will then be available here:
To run one particular acceptance test, e.g. fix42\14e_IncorrectEnumValue.def:
cd AcceptanceTest pwsh runat.ps1 release 5003 definitions\server\fix42\14e_IncorrectEnumValue.def cfg\at_42.cfg netcoreapp2.1
The final param must be "net461" or "netcoreapp2.1".
(See acceptance_test.ps1 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,
- Open the solution file in Visual Studio
- Right click on "AcceptanceTest" project and choose "Properties" from the menu
- Click "Debug" on the left hand nav bar
- Set "Command line arguments" to the relevant "cfg\at_XX.cfg" for your test
- Set the working directory to "[yourpath]\quickfixn\AcceptanceTest"
- Save the properties
- Right click the "AcceptanceTest" project, go to Debug -> Start New Instance
- In command terminal, go into "AcceptanceTest" directory
ruby Runner.rb 127.0.0.1 5001 definitions\server\fix42\YourTestName.def
QuickFIXn is maintained and funded by Connamara Systems, LLC.
The names and logos for Connamara Systems are trademarks of Connamara Systems, LLC.
This software is available under the QuickFIX Software License. Please see the LICENSE for the terms specified by the QuickFIX Software License.