Awesome Open Source
Awesome Open Source

Go on Rails

Use Rails to generate Golang code or manage Go app development

Gem Version Build Status Maintainability MIT License


用 Rails 开发 Go 应用:中文文档

go-on-rails is a Rails generator aims to:

  1. Help to develop and integrate some APIs written in Golang to existing Rails app for high performance
  2. Use your familiar Rails tools to develop and manage a Golang app project
  3. Convert a not very complicated Rails app to Golang equivalent

Here's some examples:

Prerequisites

  • Rails 4.2+ (Rails 6 not supported and need your help)
  • Golang 1.10.x(mainly be compatible with github.com/go-sql-driver/mysql)

Installation

Add this line to your application's Gemfile:

gem 'go-on-rails', '~> 0.4.0'

And then execute:

$ bundle

Or install it yourself as:

$ gem install go-on-rails

Usage

You must have an existing Rails app or to create a new one before you try go-on-rails to generate Golang codes.

After that you can run the command just as other Rails generators:

rails g gor [dev(elopment) | pro(duction) | test | ...] [-m model_a model_b model_c ...]

# OR (on rails version < 5.0)
rake g gor ...

here we take generating all models for the development environment for example:

rails g gor dev

Then a folder named go_app that includes Golang codes will be generated under your Rails app root path.

Install the dependent Golang packages for this Go project:

rails gor:deps

Then change to the go_app directory and run:

go run main.go

You can visit the page in http://localhost:4000 by default.

More command details about go-on-rails generator:

rails g gor --help

What will be generated?

  • Go project directory layout (all under the go_app directory, like views, controllers, public)
  • A Go data struct corresponding to each activerecord model
  • And each struct related CRUD functions/methods like FindModel, UpdateModel, DestroyModel etc. All these models related program files under the go_app/models directory
  • And godoc files for all the functions under go_app/models/doc
  • We use Gin as the default web framework, but you can change it to anyone that you favor in main.go and controllers programs

View the godoc of all functions

You can view the godoc page of all functions in http://localhost:7979/doc/models.html after run:

rails gor:doc

Besides, there's a sample project generated by go-on-rails, you can view its godoc at godoc.org just now to get a picture of what functions are generated.

Known issues and TODOs

The gem is still under development, so there're some known issues. You're welcomed to contribute. 👏

  • databases specific functions between MySQL and Postgres or other databases are not covered completely
  • sql.NullType not supported yet, so you'd better in the migrations set those columns "not null" with a default value that's consistent with Golang's zero value specification, such as "" default for string and text typed column, and 0 default for int, etc. And now we have an alternative approach for manipulating the database nullable fields, see the wiki Working with database nullable fields
  • [x] Associations
    • [x] has_many
    • [x] has_one
    • [x] belongs_to
    • [x] dependent
  • [x] Validations
    • [x] length
    • [x] presence
    • [x] format(string only)
    • [x] numericality(partially)
    • [ ] other validations
  • [x] Pagination(details see wiki)
  • [ ] Callbacks
  • [ ] Transactions

Supported databases

  • SQLite
  • MySQL
  • Postgres

Wiki

Golang dependencies by default

Acknowledgement

When I had the idea to convert Rails app or build Golang app with Rails tools, I searched github and found the project: https://github.com/t-k/ar2gostruct. And from ar2gostruct I copied some codes on handling data structure conversion and models association, it made my idea come true faster than I imagined.

Contributing

There're two branches at present: master and dev.

The dev branch has a whole Rails environment for development: models, seeds for testing, and under go_app directory there's a file named models_test.go used to test generated Golang codes.

  • Fork the project switch to branch dev.
  • Make your feature addition or bug fix.
  • Add tests for it. This is important so I don't break it in a future version unintentionally.
  • Commit, do not mess with Rakefile or version (if you want to have your own version, that is fine but bump version in a commit by itself I can ignore when I pull)
  • Send me a pull request. Bonus points for topic branches.

Testing

We create four models for testing:

  • Physician
  • Patient
  • Appointment
  • Picture

Run rails db:seed to use the data defined in db/seeds.rb. And change to go_app/models directory to run go test to test generated models-related functions. The test covers a small part of the functions currently. More will be added later on.

License

See the LICENSE file.


Get A Weekly Email With Trending Projects For These Topics
No Spam. Unsubscribe easily at any time.
ruby (12,336) 
html (10,725) 
golang (3,683) 
rails (647) 
generator (331) 
crud (127) 
code-generator (105) 
transpiler (53) 

Find Open Source By Browsing 7,000 Topics Across 59 Categories

Advertising 📦 10
All Projects
Application Programming Interfaces 📦 124
Applications 📦 192
Artificial Intelligence 📦 78
Blockchain 📦 73
Build Tools 📦 113
Cloud Computing 📦 80
Code Quality 📦 28
Collaboration 📦 32
Command Line Interface 📦 49
Community 📦 83
Companies 📦 60
Compilers 📦 63
Computer Science 📦 80
Configuration Management 📦 42
Content Management 📦 175
Control Flow 📦 213
Data Formats 📦 78
Data Processing 📦 276
Data Storage 📦 135
Economics 📦 64
Frameworks 📦 215
Games 📦 129
Graphics 📦 110
Hardware 📦 152
Integrated Development Environments 📦 49
Learning Resources 📦 166
Legal 📦 29
Libraries 📦 129
Lists Of Projects 📦 22
Machine Learning 📦 347
Mapping 📦 64
Marketing 📦 15
Mathematics 📦 55
Media 📦 239
Messaging 📦 98
Networking 📦 315
Operating Systems 📦 89
Operations 📦 121
Package Managers 📦 55
Programming Languages 📦 245
Runtime Environments 📦 100
Science 📦 42
Security 📦 396
Social Media 📦 27
Software Architecture 📦 72
Software Development 📦 72
Software Performance 📦 58
Software Quality 📦 133
Text Editors 📦 49
Text Processing 📦 136
User Interface 📦 330
User Interface Components 📦 514
Version Control 📦 30
Virtualization 📦 71
Web Browsers 📦 42
Web Servers 📦 26
Web User Interface 📦 210