Padrino

Guides

Introduction
Getting Started
Features
Generators
Controllers
Application Helpers
Adding Components
Advanced Usage

Introduction

Why Learn Padrino?

This guide will give an overview of the various other guides, resources and steps towards becoming a Sinatra + Padrino aficionado.

Advantages

Let's take a second to briefly enumerate three major advantages of learning Padrino:

Easy to Learn

The most interesting aspect of the Padrino stack (Rack, Sinatra, et. al.) in comparison to other web development tools is how modular and standalone each individual piece of the stack is. This makes learning each part much easier, and allows people to be productive right away, organically building up their knowledge of different aspects as they become necessary within a system. This concept of genuine graduated complexity within a web development stack is relatively unique to Sinatra and Padrino in the Ruby web world.

Fast

Sinatra and Padrino are very fast relative to other full stack frameworks. The Padrino stack is lightweight and slim which can be demonstrated in our performance benchmarks. While all benchmarks should be taken with a grain of salt, over the course of developing hundreds of applications, we have found that the memory usage, stability and requests per second speak for themselves.

Extensible

The other benefit of Sinatra and Padrino is the rich ecosystem of extensions that can be applied at any level of the stack. For Rack, there is a wealth of middlewares that can help do almost anything. For Sinatra, there is also a large base of extensions to add most any functionality you might need. Best of all, these are all 100% compatible with Padrino, and using our Recipe Box and our use of Bundler, you can enable nearly any library or functionality you will need with a single command.

Getting to Know Ruby

A detailed overview of Ruby is beyond the scope of our documentation, but this guide is intended to point you in the right direction and get you familiarized with the important terms. The Padrino web framework is written in the Ruby programming language. The Padrino codebase is a set of modular libraries for Ruby which are packaged using RubyGems.

In order to use Ruby and Padrino, you need to install the Ruby interpreter onto your local machine and setup RubyGems so you can install ruby packages.

You should now be able to execute the following commands in the terminal:

$ ruby -v
$ gem -v

These should return with version numbers and no errors if everything is installed correctly. Once you have Ruby and RubyGems installed locally, you should become familiar with the Ruby syntax. We recommend a few resources below to get yourself familiar with Ruby:

  • TryRuby – This is an interactive tutorial that takes you step by step through learning Ruby. This is highly recommended. Visit the site and type "help" to get started.
  • Learn to Program by Chris Pines – Excellent first Ruby tutorial, straightforward and excellent overview of the language.
  • Learn Ruby the Hard Way – Newest addition to the group, based off of Zed's excellent Python tutorial. Set of exercises that teaches Ruby to you in a rigorous but simple approach.
  • Why's Poignant Guide - Definitely the most unorthodox way to learn Ruby, but must be mentioned.

Through these guides, learning Ruby the language should be fairly painless and hopefully you will come to appreciate the elegance and simplicity of the syntax. If you enjoy Ruby and want to continue, the next step is to get familiar with Sinatra, the Ruby DSL for the web.

Learning to Love Sinatra

Padrino is a framework which builds on the existing functionality of the Sinatra Ruby web DSL and provides a variety of additional tools and helpers to extend this foundation. To use Padrino, one should be familiar with the basic usage of Sinatra itself.

First, let's install Sinatra through RubyGems:

$ gem install sinatra

Thankfully, Sinatra is probably the easiest to learn tool for making web apps you have yet encountered. Here is an example of a Sinatra application:

# app.rb
require 'sinatra'
get '/hi' do
  "Hello World!"
end

and then you can start the application with this in your terminal:

$ ruby -rubygems app.rb
== Sinatra has taken the stage ...
>> Listening on 0.0.0.0:4567

and then visit http://localhost:4567/hi in your web browser. It really is that easy, but there's a lot more to learn!

Resources for Sinatra are listed below:

There are several good Sinatra tutorials as well:

Read through these tutorials to understand routes, helpers, and the request/response cycle that is exposed through Sinatra. The most comprehensive resource is probably the Sinatra Book so make sure to skim through that and familiarize yourself with the concepts before continuing to Padrino.

Scalable Sinatra using Padrino

Once you have a solid understanding of Sinatra then you can also already understand the simplest functionality of Padrino. This is because Padrino acts as a super-set of Sinatra.

First, check out the Installation guide to get Padrino setup on your computer through RubyGems.

Padrino itself is a set of modular extensions for Sinatra. These extensions are actually fairly standalone and you can use many Padrino modules in your existing Sinatra apps through the Standalone Usage guide. This usage is intended for applications that have already been built that would benefit from a particular aspect of Padrino such as a mailer or view helpers. Check out our API docs for more information about the individual modules.

If you are able to convert your project to Padrino or start a new application from scratch, we recommend using the full Padrino stack which makes starting a new project much easier. The best way to become familiar with Padrino is to first check out the Blog Tutorial which takes you step by step through creating a blog in Padrino with an accompanying screencast. You may also want to checkout the Why Padrino (broken) guide to understand the benefits of using Padrino.

You should also take time to familiarize yourself with the various "components" Padrino allows you to use for your application. To make things simple, if you are new to the Ruby community and want to create a Padrino application with a good default set of components, generate your project with this command:

$ padrino g project my_project -d datamapper -t shoulda -s jquery -e haml -m mocha

And then read up on these components:

  • DataMapper – Great Object Relational Mapper for interacting with data
  • Haml – Solid templating choice for views
  • jQuery – Excellent javascript framework for frontend development
  • Mocha – Popular mocking and stubbing for tests

There are also a few important guides that cover the vast majority of Padrino's functionality. These are definitely recommended reading:

These guides should shed light on the various aspects that make Padrino helpful while developing Sinatra-based applications.

last updated: 2022-02-22

comments powered by Disqus