Alain

Simple CLI command, generating PROST! / tonic service skeleton & server primitive from protobuf.
Alain is named after a great F1 driver.

Add this line to your application's Gemfile:

gem 'alain'

And then execute:

$ bundle install

Or install it yourself as:

$ gem install alain

Before starting, protect your code with git. This generator modifies existing code, and requires a clean branch.

Specify proto file to alain command. You may need to prefix bundle exec with bundle install.

# alain requires git commited rust project
$ cargo new some-project
$ cd some-project
$ git init .
$ cp somewhere/some.proto .
# If the working branch has diffs yet commited, alain will abort later.
$ git commit -am "initial commit"

# This command also overwrites main.rs / lib.rs
$ alain some.proto
No service definition yet...
Generate service definition
Overwrite main.rs
Overwrite lib.rs
Generate build.rs
Generate tests/common/mod.rs
Generate tests/integration_test.rs
Update Cargo.toml
Done

# Resulting files
$ ls
Cargo.toml  build.rs  src  tests
$ ls src/
lib.rs  main.rs  some_service.rs
$ ls tests/
common  integration_test.rs

After checking out the repo, run bin/setup to install dependencies. Then, run rake test to run the tests. You can also run bin/console for an interactive prompt that will allow you to experiment.

To install this gem onto your local machine, run bundle exec rake install. To release a new version, update the version number in version.rb, and then run bundle exec rake release, which will create a git tag for the version, push git commits and the created tag, and push the .gem file to rubygems.org.

Bug reports and pull requests are welcome on GitHub at https://github.com/chumaltd/alain.