sinatra

# Sinatra

[![Gem Version](https://badge.fury.io/rb/sinatra.svg)](https://badge.fury.io/rb/sinatra)
[![Testing](https://github.com/sinatra/sinatra/actions/workflows/test.yml/badge.svg)](https://github.com/sinatra/sinatra/actions/workflows/test.yml)

Sinatra is a [DSL](https://en.wikipedia.org/wiki/Domain-specific_language) for
quickly creating web applications in Ruby with minimal effort:

```ruby
# myapp.rb
require 'sinatra'

get '/' do
  'Hello world!'
end
```

Install the gems needed:

```shell
gem install sinatra rackup puma
```

And run with:

```shell
ruby myapp.rb
```

View at: [http://localhost:4567](http://localhost:4567)

The code you changed will not take effect until you restart the server.
Please restart the server every time you change or use a code reloader
like [rerun](https://github.com/alexch/rerun) or
[rack-unreloader](https://github.com/jeremyevans/rack-unreloader).

## Table of Contents

- [Sinatra](#sinatra)
  - [Table of Contents](#table-of-contents)
  - [Routes](#routes)
  - [Conditions](#conditions)
  - [Return Values](#return-values)
  - [Custom Route Matchers](#custom-route-matchers)
  - [Static Files](#static-files)
  - [Views / Templates](#views--templates)
    - [Literal Templates](#literal-templates)
    - [Available Template Languages](#available-template-languages)
      - [Haml Templates](#haml-templates)
      - [Erb Templates](#erb-templates)
      - [Builder Templates](#builder-templates)
      - [Nokogiri Templates](#nokogiri-templates)
      - [Sass Templates](#sass-templates)
      - [Scss Templates](#scss-templates)
      - [Liquid Templates](#liquid-templates)
      - [Markdown Templates](#markdown-templates)
      - [RDoc Templates](#rdoc-templates)
      - [AsciiDoc Templates](#asciidoc-templates)
      - [Markaby Templates](#markaby-templates)
      - [RABL Templates](#rabl-templates)
      - [Slim Templates](#slim-templates)
      - [Yajl Templates](#yajl-templates)
    - [Accessing Variables in Templates](#accessing-variables-in-templates)
    - [Templates with `yield` and nested layouts](#templates-with-yield-and-nested-layouts)
    - [Inline Templates](#inline-templates)
    - [Named Templates](#named-templates)
    - [Associating File Extensions](#associating-file-extensions)
    - [Adding Your Own Template Engine](#adding-your-own-template-engine)
    - [Using Custom Logic for Template Lookup](#using-custom-logic-for-template-lookup)
  - [Filters](#filters)
  - [Helpers](#helpers)
    - [Using Sessions](#using-sessions)
      - [Session Secret Security](#session-secret-security)
      - [Session Config](#session-config)
      - [Choosing Your Own Session Middleware](#choosing-your-own-session-middleware)
    - [Halting](#halting)
    - [Passing](#passing)
    - [Triggering Another Route](#triggering-another-route)
    - [Setting Body, Status Code, and Headers](#setting-body-status-code-and-headers)
    - [Streaming Responses](#streaming-responses)
    - [Logging](#logging)
    - [Mime Types](#mim