|
1 |
| -Example QuickFIX/Go Applications |
2 |
| -================================ |
| 1 | +# Example QuickFIX/Go Applications |
3 | 2 |
|
4 |
| -[](https://travis-ci.org/quickfixgo/examples) |
| 3 | +[](https://github.com/quickfixgo/examples/actions) [](https://godoc.org/github.com/quickfixgo/examples) [](https://goreportcard.com/report/github.com/quickfixgo/examples) |
5 | 4 |
|
6 |
| -* TradeClient is a simple console based trading client |
7 |
| -* Executor is a server that fills every limit order it receives |
8 |
| -* OrderMatch is a primitive matching engine |
| 5 | +* [TradeClient](cmd/tradeclient/README.md) is a simple console based trading client |
| 6 | +* [Executor](cmd/executor/README.md) is a server that fills every limit order it receives |
| 7 | +* [OrderMatch](cmd/ordermatch/README.md) is a primitive matching engine |
9 | 8 |
|
10 | 9 | All examples have been ported from [QuickFIX](http://quickfixengine.org)
|
11 | 10 |
|
12 |
| -Installation |
13 |
| ------------- |
| 11 | +## Installation |
14 | 12 |
|
15 |
| -To build and run the examples, you will first need [Go](http://www.golang.org) installed on your machine (version 1.6+ is *required*). |
| 13 | +### Build From Source |
| 14 | +To build and run the examples, you will first need [Go](https://www.golang.org) installed on your machine |
16 | 15 |
|
17 |
| -For local dev first make sure Go is properly installed, including setting up a [GOPATH](http://golang.org/doc/code.html#GOPATH). |
18 |
| - |
19 |
| -Next, using [Git](https://git-scm.com/), clone this repository into `$GOPATH/src/github.com/quickfixgo/examples`. All the necessary dependencies are either vendored, so you just need to type `make`. This will compile and install the examples into `$GOPATH/bin`. If this exits with exit status 0, then everything is working! |
| 16 | +Next, clone this repository with `git clone [email protected]:quickfixgo/examples.git`. This project uses go modules, so you just need to type `make build`. This will compile the examples executables in the `./bin` dir in your local copy of the repo. If this exits with exit status 0, then everything is working! You may need to pull the module deps with `go mod download`. |
20 | 17 |
|
21 | 18 | ```sh
|
22 |
| -$ make |
| 19 | +make build |
23 | 20 | ```
|
24 | 21 |
|
25 |
| -Running the Examples |
26 |
| --------------------- |
| 22 | +### Running the Examples |
27 | 23 |
|
28 |
| -Following installation, the examples can be found in `$GOPATH/bin`. The examples are meant to be run in pairs- the TradeClient as a client of either the Executor or OrderMatch. By default, the examples will load the default configurations named after the example apps provided in the `config/` root directory. Eg, running `$GOPATH/bin/tradeclient` will load the `config/tradeclient.cfg` configuration. Each example can be run with a custom configuration as a command line argument (`$GOPATH/bin/tradeclient my_trade_client.cfg`). |
| 24 | +Following installation, the examples can be found in `./bin`. The examples are meant to be run in pairs- the TradeClient as a client of either the Executor or OrderMatch. By default, the examples will load the default configurations named after the example apps provided in the `config/` root directory. <i>i.e.</i>, running `./bin/tradeclient` will load the `config/tradeclient.cfg` configuration. Each example can be run with a custom configuration as a command line argument (`./bin/tradeclient my_trade_client.cfg`). |
29 | 25 |
|
30 |
| -Licensing |
31 |
| ---------- |
| 26 | +### Licensing |
32 | 27 |
|
33 |
| -This software is available under the QuickFIX Software License. Please see the [LICENSE.txt](https://github.com/quickfixgo/examples/blob/master/LICENSE.txt) for the terms specified by the QuickFIX Software License. |
| 28 | +This software is available under the QuickFIX Software License. Please see the [LICENSE](LICENSE) for the terms specified by the QuickFIX Software License. |
0 commit comments