Skip to content

Latest commit

 

History

History
77 lines (50 loc) · 1.94 KB

README.md

File metadata and controls

77 lines (50 loc) · 1.94 KB
Raw

Xdrgen

Build Status Code Climate

xdrgen is a code generator that takes XDR IDL files (.x files) as specfified in RFC 4506 and spits code out in various languages.

xdrgen requires ruby 2.1 or later to run.

Status

Xdrgen is a very early project. Aside from the test fixtures in spec/fixtures, the only .x files that have been thrown at it are the .x files used for the stellar-core project.

This fork of Xdrgen presently supports five output languages: ruby, javacript, golang, java, and C#:

  • ruby: complete support
  • javascript: complete support
  • java: seems complete, might be some things missing
  • golang: currently using a fork of go-xdr, but has complete support
  • C#: seems complete, testing might prove otherwise.

Testing is very sparse, but will improve over time.

Usage as a binary

Xdrgen is a rubygem, compatible with ruby 2.1 or higher

$ gem install xdrgen

The command line:

xdrgen [-o OUTPUT_DIR] [-l LANGUAGE] [-n NAMESPACE] [INPUT_FILES ...]

Usage as a library

Add this line to your application's Gemfile:

gem 'xdrgen'

And then execute:

$ bundle

Example usage:

require 'xdrgen'

# create a compilation object, specifying your options

c = Xdrgen::Compilation.new(
  ["MyProgram.x"],
  output_dir:"src/generated",
  language: :ruby,
  namespace: "MyProgram::XDR"
)

# then run compile

c.compile

Contributing

  1. Fork it ( https://github.com/[my-github-username]/xdrgen/fork )
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create a new Pull Request