this is a quick guide in building directory, files, password protection, sessions and validation in sinatra application
**what is sinatra **
Sinatra is a free and open source software web application library and domain-specific language written in Ruby. It is an alternative to other Ruby web application frameworks such as Ruby on Rails, Merb, Nitro, and Camping. It is dependent on the Rack web server interface. It is named after musician Frank Sinatra.
what is (DSL)
A domain-specific language (DSL) is a computer language specialized to a particular application domain.
First, make sure Sinatra is installed by running gem install sinatra in your terminal.
** File and Directories**
Using Corneal gem to generate my application
Corneal is gem created by a former Flatiron student named Brian Emory. that build a Sinatra skeleton similar to running
rails new APP-NAME in rails.
To generate your app:
Install the gem
corneal new APP-NAME
After Corneal is done generating your app, run bundle install from your app’s directory:
$ cd APP-NAME
$ bundle install
You can then start your server with shotgun: after running check localhost 9393 in your browser.
$ shotgun
corneal click to learn more about corneal gem.
Database
run $ rake db:create_migration NAME=create_bullitins to create table
after creating the table run rake db:migrate this will create .schema the in db: directory(database)
using corneal to generate migration.
You can generate a model and migration file:
corneal model NAME
You can also generate an entire MVC structure complete with a migration file:
`corneal scaffold NAME`
Controllers < Sinatra: :Base
application_controller < Sinatra: :Base
models_controller < application_controller
Models < ActiveRecord: :Base
class Bullitin belongs_to :user (association)
class User has_many: bullitins (association)
`validates :title, :content, presence: true (validation)
### Config.ru file
this is important to remember; Mount your application to the server everytime you add Controller.
use Rack::MethodOverride #this allows us to use HTTP methods like puts/patch
use BullitinsController
use UsersController
run ApplicationController
password security
install gem ‘bcrypt’
set table attribute as password_digest:
t.string :password_digest
in User_model set macro: has_secure_password
We validate password match (user password from the form input == password in database(password_digest) by using .authenticate method (method come from has_secure_password macro)
example:
post "/login" do
@user = User.find_by(username: params[:username])
if @user && @user.authenticate(params[:password])
session[:user_id] = @user.id
redirect "/bulletins"
sessions
enable session in app/application_controller
configure do
enable :sessions
set :session_secret, ENV['SESSION_SECRET'] #some random string are stored in this variable
end
click the [sinatra]( http://sinatrarb.com/intro) for more understanding on how to set up session_secret,
validation
class User < ActiveRecord::Base
has_many :posts
validates :username, :email, :password, :presence: true #making sure models have data.
end
or.
```ruby post ‘/signup’ do
if params[:username].empty? || params[:email].empty? || params[:password].empty?
erb :'users/signup'
else
user = User.create(params)
session[:user_id] = user.id
redirect '/posts'
end
end
```
for more understanding about validation and to see more validation methods guides
Now we can start building Restful routes