Padrino is a full-stack ruby framework built upon Sinatra.
Ruby HTML Other
Latest commit e2b31fe Feb 13, 2017 @phallstrom phallstrom committed with ujifgc Handle nil database passwords for create_db and drop_db.
Commit ce7ab0a introduced a bug where
if the database configuration didn't specify a password attempts to
create/drop the database would fail. The underlying cause was that prior
to the above the code used `blank?` to which would catch both nil values
and empty values. The new code uses `empty?` which fails if used on a
nil value.

This patch fixes that by checking for nil in addition to an empty string.

This can be reproduced by creating a brand new app, using postgresql or
mysql, and setting the database configuration to this:

  postgres://localhost/nilpassword_development

And then running `rake sq:create` which will result in this:

  $ rake sq:create
  => Creating database 'nilpassword_development'
  rake aborted!
  NoMethodError: undefined method `empty?' for nil:NilClass
  .../gems/padrino-gen-0.13.3.3/lib/padrino-gen/padrino-tasks/sql-helpers.rb:10:in `create_db'
  .../gems/padrino-gen-0.13.3.3/lib/padrino-gen/padrino-tasks/sequel.rb:52:in `block (2 levels) in <top (required)>'
  .../gems/rake-12.0.0/exe/rake:27:in `<top (required)>'
  .../bin/ruby_executable_hooks:15:in `eval'
  .../bin/ruby_executable_hooks:15:in `<main>'
  Tasks: TOP => sq:create
  (See full trace by running task with --trace)

README.rdoc

Padrino

Padrino is the godfather of Sinatra. Follow us on www.padrinorb.com and on twitter @padrinorb. Join us on gitter

Build
Status Dependency
Status

Preface

Padrino is a ruby framework built upon the excellent Sinatra Web Library. Sinatra is a DSL for creating simple web applications in Ruby quickly and with minimal effort. This framework tries to make it as fun and easy as possible to code more advanced web applications by building upon the Sinatra philosophies and foundations.

Introduction

Many people love that Sinatra is simple and lightweight but soon begin to miss the great deal of functionality provided by other web frameworks such as Django or Rails when building non-trivial applications.

Our goal with this framework is to adhere to the essence of Sinatra and at the same time create a standard library of tools, helpers and components that will make Sinatra suitable for increasingly complex applications.

Here is a brief overview of functionality provided by the Padrino framework:

Agnostic

Full support for many popular testing, templating, mocking, and data storage choices.

Generators

Create Padrino applications, models, controllers i.e: padrino-gen project.

Mountable

Unlike other ruby frameworks, principally designed for mounting multiple apps.

Routing

Full url named routes, named params, before/after filter support.

Tag Helpers

View helpers such as: tag, content_tag, input_tag.

Asset Helpers

View helpers such as: link_to, image_tag, javascript_include_tag.

Form Helpers

Builder support such as: form_tag, form_for, field_set_tag, text_field.

Text Helpers

Useful formatting like: time_ago_in_words, js_escape_html, sanitize_html.

Mailer

Fast and simple delivery support for sending emails (akin to ActionMailer).

Caching

Simple route and fragment caching to easily speed up your web requests.

Admin

Built-in Admin interface (like Django)

Logging

Provide a unified logger that can interact with your ORM or any library.

Reloading

Automatically reloads server code during development.

Localization

Full support of I18n language localization and can auto-set user's locale.

Keep in mind, developers are able to individually pull in these modular components into existing Sinatra applications or use them altogether for a full-stack Padrino application.

Installation

To install the padrino framework, simply grab the latest version from RubyGems:

$ gem install padrino

This will install the necessary padrino gems to get you started. Now you are ready to use this gem to enhance your Sinatra projects or to create new Padrino applications.

For a more detailed look at installing Padrino, check out the Installation Guide.

Usage

Padrino is a framework which builds on the existing functionality of Sinatra and provides a variety of additional tools and helpers to build upon that foundation. This README and Padrino documentation in general will focus on the enhancements to the core Sinatra functionality. To use Padrino, one should be familiar with the basic usage of Sinatra itself.

You can also check out the Why Learn Padrino? introduction to learn more about how Sinatra and Padrino work together.

For information on how to use a specific gem in isolation within an existing Sinatra project, checkout the guide for Using Padrino within Sinatra.

Getting Started

Once a developer understands Sinatra, Padrino is quite easy to get comfortable with since Padrino is simply a superset of existing Sinatra functionality!

First, be sure to read over the Getting Started guide to learn more about how Sinatra and Padrino work together.

Best way to learn more about building Padrino applications is to read following resources:

  • Padrino Guides - Guides outlining the major functionality within Padrino.

  • Blog Tutorial - Step-by-step guide to building a blog application with Padrino.

  • Padrino API - YARD documentation for the Padrino framework.

  • Quick Overview - Outlines basic generation commands.

The individual Padrino sub-gems also contain README's which outlines their functionality.

Further Questions

Can't find an answer in the resources above?

Bug reporting

Log it onto Github by creating a new issue.

Be sure to include all relevant information, like the versions of Padrino, Rack, Sinatra, Ruby and operating system you are using.

A minimal project showing the issue published on Github with Gemfile.lock is also extremely helpful.

Copyright

Copyright © 2010-2016 Padrino. See LICENSE for details.