Initial restoration of csharp generator (alpha1)

Bring RC2 code up to draft standard. Support initial nuget package sbe-tool containing sbe-tool and example. Rename namespaces/assemblies Org.SbeTool.* Rename MessageHeader.Schema_Version -> SchemaVersion for consistency. Convert the tests to mstest and add more testing. Add csharp doc to top-level README Make the csharp generator dynamically load (but not yet in distinct jar). Add copyright on changed files. Csharp keywords validation, aligning tests to match new cases. Add generated code to a distinct project Code indentation fixes. Port bugfix from AdaptiveConsulting@ba3a9af Bring Engine example to current state. Add Extension->Car example for testing Check decode with different schema values. Drop unneeded header. Add SinceDeprecated test. The Schema version is now in ir.version(). '-' is not a valid namespace character so CamelCase around them. Fix and test Issue435. SinceVersion additions Fix csharp codec chain rule Freshen the version of FixBinary.xml in use to the one used by other backends gradle'ification of csharp code generation Add the packageName to the created directory Make the message header blocklength be 16 bits and standard, Add IR generation for the example Treat the MessageHeader like any otehr composite. It's not really standardized.

Author: billsegall

.gitattributes

@@ -0,0 +1,63 @@
+###############################################################################
+# Set default behavior to automatically normalize line endings.
+###############################################################################
+* text=auto
+
+###############################################################################
+# Set default behavior for command prompt diff.
+#
+# This is need for earlier builds of msysgit that does not have it on by
+# default for csharp files.
+# Note: This is only used by command line
+###############################################################################
+#*.cs diff=csharp
+
+###############################################################################
+# Set the merge driver for project and solution files
+#
+# Merging from the command prompt will add diff markers to the files if there
+# are conflicts (Merging from VS is not affected by the settings below, in VS
+# the diff markers are never inserted). Diff markers may cause the following 
+# file extensions to fail to load in VS. An alternative would be to treat
+# these files as binary and thus will always conflict and require user
+# intervention with every merge. To do so, just uncomment the entries below
+###############################################################################
+#*.sln merge=binary
+#*.csproj merge=binary
+#*.vbproj merge=binary
+#*.vcxproj merge=binary
+#*.vcproj merge=binary
+#*.dbproj merge=binary
+#*.fsproj merge=binary
+#*.lsproj merge=binary
+#*.wixproj merge=binary
+#*.modelproj merge=binary
+#*.sqlproj merge=binary
+#*.wwaproj merge=binary
+
+###############################################################################
+# behavior for image files
+#
+# image files are treated as binary by default.
+###############################################################################
+#*.jpg binary
+#*.png binary
+#*.gif binary
+
+###############################################################################
+# diff behavior for common document formats
+# 
+# Convert binary document formats to text before diffing them. This feature
+# is only available from the command line. Turn it on by uncommenting the 
+# entries below.
+###############################################################################
+#*.doc diff=astextplain
+#*.DOC diff=astextplain
+#*.docx diff=astextplain
+#*.DOCX diff=astextplain
+#*.dot diff=astextplain
+#*.DOT diff=astextplain
+#*.pdf diff=astextplain
+#*.PDF diff=astextplain
+#*.rtf diff=astextplain
+#*.RTF diff=astextplain

.gitignore

@@ -91,5 +91,25 @@ gocode/src/example-schema/cpu.out
 gocode/src/extension
 gocode/src/extension2
 
+# csharp
+csharp/*/bin
+csharp/*/obj
+csharp/.nuget/sbe-tool*.nupkg
+csharp/.nuget/sbe-tool-all.jar
+csharp/.nuget/examples/bin
+csharp/.nuget/examples/obj
+csharp/.nuget/examples/packages
+csharp/.nuget/examples/.vs
+csharp/.vs
+csharp/TestResults
+csharp/packages
+csharp/sbe-generated/baseline
+csharp/sbe-generated/baseline-bigendian
+csharp/sbe-generated/extension
+csharp/sbe-generated/issue435
+csharp/sbe-generated/since-deprecated
+csharp/sbe-generated/mktdata/*.cs
+csharp/sbe-generated/uk_co_real_logic_sbe_benchmarks_fix
+
 # Mac
 .DS_Store

README.md

@@ -3,7 +3,7 @@ Simple Binary Encoding (SBE)
 
 [SBE](https://github.com/FIXTradingCommunity/fix-simple-binary-encoding) is an OSI layer 6 presentation for 
 encoding and decoding binary application messages for low-latency financial applications. This repository contains 
-the reference implementations in Java, C++, and Golang.
+the reference implementations in Java, C++, Golang, and Csharp.
 
 Further details on the background and usage of SBE can be found on the
 [Wiki](https://github.com/real-logic/simple-binary-encoding/wiki).
@@ -13,13 +13,15 @@ An XSD for SBE specs can be found
 
 For the latest version information and changes see the [Change Log](https://github.com/real-logic/simple-binary-encoding/wiki/Change-Log) with **downloads** at [Maven Central](http://search.maven.org/#search%7Cga%7C1%7Csbe). 
 
-This SBE implementation is designed with work very efficiently with the [Aeron](https://github.com/real-logic/Aeron) 
-messaging system for low-latency and high-throughput communications. SBE has a dependency on [Agrona](https://github.com/real-logic/Agrona) 
-for its buffer implementations.
+The Java and C++ SBE implementations are designed with work very efficiently with the
+[Aeron](https://github.com/real-logic/Aeron) messaging system for low-latency and
+high-throughput communications. The Java SBE implementation has a dependency on
+[Agrona](https://github.com/real-logic/Agrona) for its buffer implementations.
 
 License (See LICENSE file for full license)
 -------------------------------------------
 Copyright 2014 - 2017 Real Logic Limited
+Copyright 2017 MarketFactory Inc
 
 Licensed under the Apache License, Version 2.0 (the "License");
 you may not use this file except in compliance with the License.
@@ -85,7 +87,6 @@ Jars for the executable, source, and javadoc for the various modules can be foun
 
  <module>/build/libs
 
-
 C++ Build using CMake
 ---------------------
 NOTE: Linux, Mac OS, and Windows only for the moment. See
@@ -124,7 +125,25 @@ tests and containes some examples
  # make # test, examples, bench
 
 Users of golang generated code should see the [user
-documentation](https://github.com/real-logic/simple-binary-encoding/wiki/Golang-User-Guide). Developers
-wishing to enhance the golang generator should see the [developer
+documentation](https://github.com/real-logic/simple-binary-encoding/wiki/Golang-User-Guide).
+
+Developers wishing to enhance the golang generator should see the [developer
 documentation](https://github.com/real-logic/simple-binary-encoding/blob/master/gocode/README.md)
 
+C# Build
+--------
+As of April 2017, the csharp build is considered a preview release. API stability is not yet guaranteed. User and Developer guides are not yet released or are incomplete.
+
+First build using Gradle to generate the SBE jar and then use it to
+generate the C# code used for testing and the examples.
+
+ $ ./gradlew
+ $ ./gradlew generateCsharpCodecs
+
+You can then use the [Visual Studio 2017 Community solution](https://github.com/real-logic/simple-binary-encoding/blob/master/csharp/csharp.sln) to build and explore the
+example. This solution also builds some tests which can be run via the provided
+[runtests.sh](https://github.com/real-logic/simple-binary-encoding/blob/master/csharp/runtests.sh) script.
+
+Users of csharp generated code should see the [user documentation (coming)](https://github.com/real-logic/simple-binary-encoding/wiki/Csharp-User-Guide).
+
+Developers wishing to enhance the csharp generator should see the [developer documentation (coming)](https://github.com/real-logic/simple-binary-encoding/blob/master/csharp/README.md)

build.gradle

@@ -82,6 +82,12 @@ def projectPom = {
  email = 'richard.warburton@gmail.com'
  url = 'https://github.com/RichardWarburton'
  }
+ developer {
+ id = 'BillSegall'
+ name = 'Bill Segall'
+ email = 'bill.segall@gmail.com'
+ url = 'https://github.com/BillSegall'
+ }
  }
 }
 
@@ -500,7 +506,7 @@ task(generateGolangCodecsWithXSD, type:JavaExec) {
  'sbe-tool/src/test/resources/FixBinary.xml',
  'sbe-tool/src/test/resources/issue435.xml',
  'sbe-tool/src/test/resources/since-deprecated-test-schema.xml',
- 'gocode/resources/example-bigendian.xml',
+ 'sbe-tool/src/test/resources/example-bigendian-test-schema.xml',
  'gocode/resources/example-composite.xml',
  'gocode/resources/example-extension-2-schema.xml',
  'gocode/resources/group-with-data-extension-schema.xml',
@@ -518,6 +524,24 @@ task generateGolangCodecs {
  'generateGolangCodecsWithXSD'
 }
 
+task(generateCsharpCodecs, type:JavaExec) {
+ main = 'uk.co.real_logic.sbe.SbeTool'
+ classpath = project(':sbe-all').sourceSets.main.runtimeClasspath
+ systemProperties(
+ 'sbe.output.dir': 'csharp/sbe-generated',
+ 'sbe.target.language': 'uk.co.real_logic.sbe.generation.csharp.Csharp',
+ 'sbe.validation.xsd': validationXsdPath)
+ args = [ 
+ 'sbe-tool/src/test/resources/FixBinary.xml',
+ 'sbe-tool/src/test/resources/issue435.xml',
+ 'sbe-tool/src/test/resources/since-deprecated-test-schema.xml',
+ 'sbe-tool/src/test/resources/example-bigendian-test-schema.xml',
+ 'sbe-samples/src/main/resources/example-schema.xml',
+ 'sbe-samples/src/main/resources/example-extension-schema.xml',
+ 'sbe-benchmarks/src/main/resources/fix-message-samples.xml'
+ ]
+}
+
 task(generateJavaIrCodecs, type: JavaExec) {
  main = 'uk.co.real_logic.sbe.SbeTool'
  classpath = project(':sbe-all').sourceSets.main.runtimeClasspath