Lieutenant Governor

Objective: A rails gem to make it simple to define your endpoints once in your routes.rb file and have them automatically generated for use on the client.

Add this line to your application's Gemfile:

gem 'lieutenant_governor'

And then execute:

$ bundle

Or install it yourself as:

$ gem install lieutenant_governor

The lieutenant_governor gem uses your applications routes to construct a javascript module for making requests to the server. Hence, the routes need to be loaded before you invoke the generate method like so:

config.after_initialize do
    Rails.application.reload_routes!
    LieutenantGovernor::Generator.generate(path_to_js_helper) 
    # path_to_js_helper is a string 
    # to the desired location of the JS module that gets generated.
end

We recommend doing this in config/environments/development.rb

Creating a basic URL

// questions/:questions_id

import * as paths from 'paths';

// questions function is created and exported by lieutenant governor
const url = paths.questions({

  // params to be used in the url
  // number of params must match number in url
  params: [ 1 ],
  
});

console.log(url);
// questions/1

Creating a URL with query strings appended

// questions/:questions_id

import * as paths from 'paths';

const url = paths.questions({

  params: [ 1 ],
  
  // query strings to be appended to the url
  query: {
    firstName: 'Fred',
    lastName: 'Flintstone'
  }
});

console.log(url);
// questions/1?firstName=Fred&lastName=Flintstone

Creating a nested URL

// questions/:questions_id/answers/:answer_id/votes

import * as paths from 'paths';

const url = paths.questionAnswerVotes({

  params: [ 1, 'abc' ],
  
  query: {
    firstName: 'Fred',
    lastName: 'Flintstone'
  }
});

console.log(url);
// questions/1/answers/abc/votes?firstName=Fred&lastName=Flintstone

Lieutentant governor parses routes.rb and generates client side functions to create paths

When creating the path, the function takes an object so that the developer can specify params and query strings

paths#generatedFunction({ 
   params: [],
   query: {},
});

1. Build system must support transpiling ES6

If you choose to help us further develop and improve Lieutenant Governor, then you are awesome. To do this, first checkout the master branch. Then create a new branch off of master with the corresponding issue number:

    $ git checkout -b ISSUE-209

Perform the work you wish to do locally and then create a remote branch like so:

    $ git push origin ISSUE-209

Then go into github and open up a PR request. When you first open up your PR, the travis build will kick off. If the build passes, then you are required to get a review from an admin. If the admin approves, then your PR will be mergable.

After checking out the repo, run bin/setup to install dependencies. Then, run rake spec 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 tags, and push the .gem file to rubygems.org.

Bug reports and pull requests are welcome on GitHub at https://github.com/jordanlittell/lieutenant_governor. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the Contributor Covenant code of conduct.

The gem is available as open source under the terms of the MIT License.