CELEBRATE EARTH WEEK
Save 70% on video training and simulators now through April 27*—use code EARTH. Shop now.
Developers from around the world are using the Ruby language. Here’s what they’re saying about Programming Ruby...
“In their first landmark book, The Pragmatic Programmer, Dave and Andy urged us to learn at least one new programming language every year. It may follow the principle of least surprise that the authors would bring us this year’s candidate, accompanied with a pragmatic philosophy of how to learn your new OO scripting language of choice.”—Frank Westphal, independent consultant
“Ruby is an exciting new language, worth knowing about and well worth considering for an upcoming project. It's rare to see such a useful book this early in the life of a new language. But of course I would expect no less from the authors of The Pragmatic Programmer. Andy and Dave: Thanks!”—Ron Jeffries, author of Extreme Programming Installed
“I have used Perl and Python for my work... but Ruby just turns my work into fun!”—Clemens Hintze, programmer
“Ruby is a remarkably clean, simple, powerful, and practical dynamic OO programming language. Ruby fully deserves this correspondingly best-of-breed book. This book is a ‘must have’ wizard’s workshop for using Ruby to boost your programming power and productivity. This book will greatly amplify the worldwide use of Ruby, stimulate powerful Ruby extensions, and generate demand for second and third editions. I look forward to telling later legions of Ruby users that I was farsighted enough to master Ruby using the classic first edition of Programming Ruby.”—Conrad Schneiker
“A good book by a great pair of programmers about a language with a great future. This should be the first Ruby book anyone buys.”—Hal Fulton
“Dave and Andy are among the western pioneers who understand the value of this precious gem of a language. They cleaned and polished it well, dazzling us all with its depth and transparency. It's almost magical.”—Aleksi Niemelä
"I love it. Conceptually it is really clean, and sweet."
--Kent Beck, author of Extreme Programming Explained, on the Ruby language
Ruby is a true object-oriented programming language that makes the craft of programming easier. Ruby is a transparent language: It doesn't obscure your program behind unnecessary syntax or reams of extra support code. Guided by the Principle of Least Surprise, Ruby embodies the values of consistency and simplicity of expression. It's more than a programming language: It's a concise way of expressing ideas. Ruby supports natural intelligence--yours.
Programming Ruby: The Pragmatic Programmer's Guide is your complete Ruby resource. It provides a tutorial and overview of Ruby version 1.6; a detailed description of the language's structure, syntax, and operation; a guide to building applications with Ruby; and a comprehensive library reference.
Mining real rubies is hard work done with a pickaxe, but mining ruby the language is simple With this book, you'll find it remarkably easy to Learn Ruby basics. You'll find normal stuff like classes, objects, and exceptions, as well as more interesting features, such as infinite-precision integers, iterators, mixins, and threads.
Other gems you'll find in Programming Ruby include:
I. FACETS OF RUBY.2. Ruby New.
Ruby Is an Object-Oriented Language.
Some Basic Ruby.
Arrays and Hashes.
Blocks and Iterators.
Reading and ‘Riting.
Onward and Upward.3. Classes, Objects, and Variables.
Inheritance and Messages.
Objects and Attributes.
Class Variables and Class Methods.
Variables.4. Containers, Blocks, and Iterators.
Blocks and Iterators.5. Standard Types.
Regular Expressions.6. More about Methods.
Defining a Method.
Calling a Method.7. Expressions.
Variable Scope and Loops.8. Exceptions, Catch, and Throw.
The Exception Class.
Catch and Throw.9. Modules.
Iterators and the Enumerable Module.
Including Other Files.10. Basic Input and Output.
What Is an IO Object?
Opening and Closing Files.
Reading and Writing Files.
Talking to Networks.11. Threads and Processes.
Controlling the Thread Scheduler.
Running Multiple Processes.12. When Trouble Strikes.
But It Doesn't Work!
But It's Too Slow!
II. RUBY IN ITS SETTING.13. Ruby and Its World.
Where Ruby Finds Its Modules.
Build Environment.14. Ruby and the Web.
Writing CGI Scripts.
Embedding Ruby in HTML.
Improving Performance.15. Ruby Tk.
Simple Tk Application.
Translating from Perl/Tk Documentation.16. Ruby and Microsoft Windows.
Running Ruby Under Windows.
Windows Automation.17. Extending Ruby.
Ruby Objects in C.
Writing Ruby in C.
Sharing Data Between Ruby and C.
Creating an Extension.
Embedding a Ruby Interpreter.
Bridging Ruby to Other Languages.
Ruby C Language API.
III. RUBY CRYSTALLIZED.18. The Ruby Language.
The Basic Types.
Variables and Constants.
If and Unless Expressions.
Invoking a Method.
Blocks, Closures, and Proc Objects.
Catch and Throw.19. Classes and Objects.
How Classes and Objects Interact.
Class and Module Definitions.
Top-Level Execution Environment.
Inheritance and Visibility.
Freezing Objects.20. Locking Ruby in the Safe.
Tainted Objects.21. Reflection, ObjectSpace, and Distributed Ruby.
Looking at Objects.
Looking at Classes.
Calling Methods Dynamically.
Tracing Your Program's Execution.
Marshaling and Distributed Ruby.
Compile Time? Runtime? Anytime!
IV. RUBY LIBRARY REFERENCE.22. Built-In Classes.
TrueClass.23. Built-in Modules.
Process.24. Standard Library.
WeakRef.25. Object-Oriented Design Libraries.
Singleton.26. Network and Web Libraries.
CGI::Session.27. Microsoft Windows Support.
V. APPENDICES.A: Embedded Documentation.
Including Other Files.
Mandatory Disclaimer.B: Interactive Ruby Shell.
rtags, xmp, and the Frame Class.C: Support.
Bug Reporting.D: Bibliography.
This book is a tutorial and reference for the Ruby programming language. Use Ruby, and you'll write better code, be more productive, and enjoy programming more.
These are bold claims, but we think that after reading this book you'll agree with them. And we have the experience to back up this belief.
As Pragmatic Programmers we've tried many, many languages in our search for tools to make our lives easier, for tools to help us do our jobs better. Until now, though, we'd always been frustrated by the languages we were using.
Our job is to solve problems, not spoonfeed compilers, so we like dynamic languages that adapt to us, without arbitrary, rigid rules. We need clarity so we can communicate using our code. We value conciseness and the ability to express a requirement in code accurately and efficiently. The less code we write, the less that can go wrong. (And our wrists and fingers are thankful, too.)
We want to be as productive as possible, so we want our code to run the first time; time spent in the debugger is time stolen from the development clock. It also helps if we can try out code as we edit it; if you have to wait for a 2-hour make cycle, you may as well be using punch cards and submitting your work for batch compilation.
We want a language that works at a high level of abstraction. The higher level the language, the less time we spend translating our requirements into code.
When we discovered Ruby, we realized that we'd found what we'd been looking for. More than any other language with which we have worked, Ruby stays out of your way. You can concentrate on solving the problem at hand, instead of struggling with compiler and language issues. That's how it can help you become a better programmer: by giving you the chance to spend your time creating solutions for your users, not for the compiler.
You end up with Ruby.
OO aficionados will find much to like in Ruby: things such as pure object orientation (everything's an object), metaclasses, closures, iterators, and ubiquitous heterogeneous collections. Smalltalk users will feel right at home (and C++ and Java users will feel jealous).
At the same time, Perl and Python wizards will find many of their favorite features: full regular expression support, tight integration with the underlying operating system, convenient shortcuts, and dynamic evaluation.
Ruby is easy to learn. Everyday tasks are simple to code, and once you've done them, they are easy to maintain and grow. Apparently difficult things often turn out not to have been difficult after all. Ruby follows the Principle of Least Surprise---things work the way you would expect them to, with very few special cases or exceptions. And that really does make a difference when you're programming. We call Ruby a transparent language. By that we mean that Ruby doesn't obscure the solutions you write behind lots of syntax and the need to churn out reams of support code just to get simple things done. With Ruby you write programs close to the problem domain. Rather than constantly mapping your ideas and designs down to the pedestrian level of most languages, with Ruby you'll find you can express them directly and express them elegantly. This means you code faster. It also means your programs stay readable and maintainable.
Using Ruby, we are constantly amazed at how much code we can write in one sitting, code that works the first time. There are very few syntax errors, no type violations, and far fewer bugs than usual. This makes sense: there's less to get wrong. No bothersome semicolons to type mechanically at the end of each line. No troublesome type declarations to keep in sync (especially in separate files). No unnecessary words just to keep the compiler happy. No error-prone framework code.
So why learn Ruby? Because we think it will help you program better. It will help you to focus on the problem at hand, with fewer distractions. It will make your life easier.
Times change, and things aren't that simple anymore. Some language designers have taken to calling their creations ''scripting languages.'' By this, we guess they mean that their languages are interpreted and can be used to replace batch files and shell scripts, orchestrating the behavior of other programs and the underlying operating system. Perl, TCL, and Python have all been called scripting languages. What exactly is a scripting language? Frankly we don't know if it's a distinction worth making. In Ruby, you can access all the underlying operating system features. You can do the same stuff in Ruby that you can in Perl or Python, and you can do it more cleanly. But Ruby is fundamentally different. It is a true programming language, too, with strong theoretical roots and an elegant, lightweight syntax. You could hack together a mess of ''scripts'' with Ruby, but you probably won't. Instead, you'll be more inclined to engineer a solution, to produce a program than is easy to understand, simple to maintain, and a piece of cake to extend and reuse in the future. Although we have used Ruby for scripting jobs, most of the time we use it as a general-purpose programming language. We've used it to write GUI applications and middle-tier server processes, and we're using it to format large parts of this book. Others have used it for managing server machines and databases. Ruby is serving Web pages, interfacing to databases and generating dynamic content. People are writing artificial intelligence and machine learning programs in Ruby, and at least one person is using it to investigate natural evolution. Ruby's finding a home as a vehicle for exploratory mathematics. And people all over the world are using it as a way of gluing together all their different applications. It truly is a great language for producing solutions in a wide variety of problem domains.
However, Ruby is probably more applicable than you might think. It is easy to extend, both from within the language and by linking in third-party libraries. It is portable across a number of platforms. It's relatively lightweight and consumes only modest system resources. And it's easy to learn; we've known people who've put Ruby code into production systems within a day of picking up drafts of this book. We've used Ruby to implement parts of an X11 window manager, a task that's normally considered severe C coding. Ruby excelled, and helped us write code in hours that would otherwise have taken days.
Once you get comfortable with Ruby, we think you'll keep coming back to it as your language of choice.
Ruby was created by Yukihiro Matsumoto (Matz) in Japan. Since 1995, its popularity in Japan has grown at an astounding rate; there are rumors that Ruby is more popular than Python in Japan. But to date, much of the detailed Ruby documentation is in Japanese. It probably isn't a programming language you'd just stumble across.
We wanted to spread the word, to have more people outside Japan using Ruby and enjoying the benefits, so we decided to document Ruby in English. And what started out as a small project just sort of grew....
Ruby version numbering follows the same scheme used for many other open source projects. Releases with even subversion numbers (1.0, 1.2, 1.4, and so on) are stable, public releases. These are the releases that are prepackaged and made available on the various Ruby Web sites.
Development versions of the software have odd subversion numbers, such as 1.1 and 1.3. These you'll have to download and build for yourself.