/myway-sinatra

The super suave Sinatra framework

Primary LanguageRubyMIT LicenseMIT

MyWay: The Sinatra framework with infinite possibilities

Build Status Maintainability Test Coverage contributions welcome

MyWay is a barebones Sinatra API framework with modular boilerplates... and it's super suave.

Its structure has been built out to be naturally quite opinionated. That being said however, the project's logic is easy enough to follow and can easily be modified to suit your needs.

Getting Started

If you want to use the MyWay CLI integration for MyWay, you can install it with:

$ gem install myway-cli

and run commands with using the myway prefix.

You can use the CLI to generate a new project from a template with:

$ myway generate project example-project

Then finally have bundle installed and run it in the project directory:

$ bundle

Make sure you have versions of PostgreSQL and Redis installed as the framework uses these for model persistence and authentication tokens respectively.

Running & Testing the Project

Using the MyWay CLI

To get the project running at localhost:3000 run:

$ myway run server

To test the project run:

$ myway run tests

For more information, tips, and ticks, see the MyWay CLI gem here

Using the Rakefile

If you're not using the CLI, you can run any of the standard commands using the included Rakefile as follows:

$ rake run_myway
$ rake test_myway

The Project Structure

[root]
     |
     |-[api]
     |     |-[auth]
     |     |-[v1]    <- API files suffixed with `_api.rb`
     |
     |-[config]      <- Configuration files for the application, models and webserver
     |
     |-[helpers]     <- Helper files suffixed with `_helper.rb`
     |
     |-[models]      <- Model files
     |
     |-[spec]
            |-[auth]
            |-[v1]   <- Test files suffixed with `_spec.rb`

Contributing

  1. Fork it
  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

License

This project is available as open source under the terms of the MIT License.

To Do

  • Base App With Modular Controllers
  • API Boilerplate Module
  • Use Puma for Server
  • Make Heroku-Ready
  • Automatic Code Reloading
  • Controller Tests
  • Set Up Travis
  • Set Up CodeClimate
  • Add ORM
  • Add User Model
  • Create CLI
  • Add Authentication with Tokens
  • Add Self-Documenting API