Mixing code and data in Ruby with DATA and __END__

Did you know that Ruby provides a way for your script to use its own source file as a source of data? It's a neat trick that can save you some time when writing one-off scripts and proofs of concept. Let's check it out!

Did you know that Ruby provides a way for your script to use its own source file as a source of data? It's a neat trick that can save you some time when writing one-off scripts and proofs of concept.  Let's check it out!


In the example below, I'm using a funny keyword called __END__. Everything below __END__ will be ignored by the Ruby interpreter. But more interestingly, ruby provides you with an IO object called DATA, which lets you read everything below __END__ just like you can read from any other file.

In the following example, we iterate over each line and print it.

DATA.each_line do |line|
  puts line


My favorite practical example of this technique uses DATA to contain an ERB template. It also works with YAML, CSV and so on. M

require 'erb'

time = Time.now
renderer = ERB.new(DATA.read)
puts renderer.result()

The current time is <%= time %>.

You can actually use DATA to read content above the __END__ keyword. That's because DATA is actually a pointer to the entire source file, fast-forwarded to the __END__ keyword. You can see this if you rewind the IO object before printing it. The example below prints out the entire source file.

puts DATA.read # prints the entire source file


The multiple-file delimma

One of the big downsides to this technique is that it only really works if your script fits into a single source file, and you're running that file directly, rather than including it.

In the example below, I've got two files, each with their own __END__ section. However there can be only one DATA global. So the __END__ section of the second file is inaccessible.

# first.rb
require "./second"

puts "First file\n----------------------"
puts DATA.read


First end clause

# second.rb

def print_second_data
  puts "Second file\n----------------------"
  puts DATA.read # Won't output anything, since first.rb read the entire file


Second end clause

snhorne ~/tmp $ ruby first.rb
First file
First end clause

Second file

A work-around for multiple files

Sinatra has a pretty cool feature that allows you to add multiple inline templates to your apps by putting them after an __END__ statement. It looks like this:

# This code is from the Sinatra docs at http://www.sinatrarb.com/intro.html
require 'sinatra'

get '/' do
  haml :index


@@ layout
  = yield

@@ index
%div.title Hello world.

But how exactly can sinatra do this? After all, your app is probably going to be loaded by rack. You're not going to run ruby myapp.rb in production! They must have figured out a way to use DATA with multiple files.

Though, if you dig into the Sinatra source a little, you'll see that they're kind of cheating. They're not using DATA at all. Instead they're doing something similar to the code below.

# I'm paraphrasing. See the original at https://github.com/sinatra/sinatra/blob/master/lib/sinatra/base.rb#L1284
app, data = File.read(__FILE__).split(/^__END__$/, 2)

It's actually a little more complicated, because they don't want to read __FILE__. That would just be the sinatra/base.rb file. Instead they want to get the content of the file which invoked a function. They get this by parsing the result of caller.

The caller function will tell you where the currently running function was invoked. Here's a quick example:

def some_method
  puts caller

some_method # => caller.rb:5:in `<main>'

Now it's a pretty simple matter to pull the filename out of there, and extract something equivalent to DATA for that file.

def get_caller_data
  puts File.read(caller.first.split(":").first).split("__END__", 2).last

Use it for good, not evil

Hopefully it's obvious that tricks like these aren't something that you'll want to use every day. They don't exactly make for clean, maintainable large code bases.

However occasionally you need something quick and dirty, either for a one-off utility script or for a proof of concept. In that case, DATA and __END__ can be pretty useful.

What to do next:
  1. Try Honeybadger for FREE
    Honeybadger helps you find and fix errors before your users can even report them. Get set up in minutes and check monitoring off your to-do list.
    Start free trial
    Easy 5-minute setup — No credit card required
  2. Get the Honeybadger newsletter
    Each month we share news, best practices, and stories from the DevOps & monitoring community—exclusively for developers like you.
    author photo

    Starr Horne

    Starr Horne is a Rubyist and Chief JavaScripter at Honeybadger.io. When she's not neck-deep in other people's bugs, she enjoys making furniture with traditional hand-tools, reading history and brewing beer in her garage in Seattle.

    More articles by Starr Horne
    Stop wasting time manually checking logs for errors!

    Try the only application health monitoring tool that allows you to track application errors, uptime, and cron jobs in one simple platform.

    • Know when critical errors occur, and which customers are affected.
    • Respond instantly when your systems go down.
    • Improve the health of your systems over time.
    • Fix problems before your customers can report them!

    As developers ourselves, we hated wasting time tracking down errors—so we built the system we always wanted.

    Honeybadger tracks everything you need and nothing you don't, creating one simple solution to keep your application running and error free so you can do what you do best—release new code. Try it free and see for yourself.

    Start free trial
    Simple 5-minute setup — No credit card required

    Learn more

    "We've looked at a lot of error management systems. Honeybadger is head and shoulders above the rest and somehow gets better with every new release."
    — Michael Smith, Cofounder & CTO of YvesBlue

    Honeybadger is trusted by top companies like:

    “Everyone is in love with Honeybadger ... the UI is spot on.”
    Molly Struve, Sr. Site Reliability Engineer, Netflix
    Start free trial