E-grāmata: Practical Ruby Gems

About the Author		xiii
Acknowledgments		xv
PART 1 Using RubyGems
What Is RubyGems?		3	(4)
Why Use RubyGems?		3	(3)
How Does RubyGems Compare to Other Packaging Systems?		6	(1)
Installing RubyGems		7	(6)
Installing Ruby		7	(3)
Installing RubyGems Under Linux and Mac OS X		10	(1)
Updating Your RubyGems System After You've Installed It		11	(2)
Using RubyGems in Your Code		13	(12)
Getting Started with a Ruby Gem		13	(7)
Working with Source Gems		20	(3)
Debugging RubyGems		23	(2)
Managing Installed Gem Versions		25	(10)
What Is Gem Versioning?		25	(1)
Installing an Older Gem Version		26	(1)
Updating Gems		27	(1)
Uninstalling Gems		28	(1)
Specifying Gem Versions		29	(6)
PART 2 Using Particular Gems
Data Access with the ActiveRecord Gem		35	(10)
How Does It Work?		36	(3)
Archiving RSS News with ActiveRecord		39	(5)
Conclusion		44	(1)
Easy Text Markup with the BlueCloth Gem		45	(8)
How Does It Work?		45	(1)
BlueCloth-to-HTML Converter		46	(2)
bluecloth2pdf BlueCloth-to-PDF Converter		48	(3)
Conclusion		51	(2)
Creating Web Applications with Camping		53	(16)
How Does It Work?		53	(3)
Tracking Time with Camping		56	(12)
Conclusion		68	(1)
Creating Command-Line Utilities with cmdparse		69	(12)
How Does It Work?		69	(2)
A Job-Search Tool Built with cmdparse		71	(8)
Conclusion		79	(2)
HTML Templating with erubis		81	(8)
How Does It Work?		81	(2)
HTML MySQL Table Viewer with erubis		83	(5)
Conclusion		88	(1)
Parsing Feeds with feedtools		89	(6)
How Does It Work?		89	(2)
A News Search Tool Built with feedtools		91	(2)
Conclusion		93	(2)
Creating Graphical User Interfaces with fxruby		95	(8)
How Does It Work?		95	(1)
Dynamic MySQL Data Form with fxruby		96	(6)
Conclusion		102	(1)
Retrieving Stock Quotes with YahooFinance		103	(6)
How Does It Work?		103	(1)
Displaying a Stock-Market Ticker with YahooFinance		104	(3)
Conclusion		107	(2)
Parsing HTML with hpricot		109	(6)
How Does It Work?		109	(2)
Screen-Scraping a Catalog with hpricot		111	(3)
Conclusion		114	(1)
Writing HTML as Ruby with Markaby		115	(6)
How Does It Work?		115	(1)
Graphical HTML Stock Charts with Markaby		116	(4)
Conclusion		120	(1)
Parsing CSV with fastercsv		121	(6)
How Does It Work?		121	(2)
Processing Census Data with fastercsv		123	(2)
Conclusion		125	(2)
Multiple Dispatch with multi		127	(10)
How Does It Work?		127	(2)
Formatting SQL for Legibility Using multi		129	(6)
Conclusion		135	(2)
Serving Web Applications with mongrel		137	(8)
How Does It Work?		137	(1)
Using mongrel as a Rails Development Server		138	(1)
mongrel Running Rails as a Service on Win32		139	(1)
mongrel Running Camping		140	(1)
mongrel as a Small Web Server		140	(1)
mongrel Serving a Rails App via Apache 2.2		141	(2)
Conclusion		143	(2)
Transferring Files Securely with net-sftp		145	(4)
How Does It Work?		145	(1)
Sending Files via SFTP Using net-sftp		146	(2)
Conclusion		148	(1)
Executing Commands on Remote Servers with net-ssh		149	(6)
How Does It Work?		149	(2)
Editing Remote Files with net-ssh and Vim		151	(3)
Conclusion		154	(1)
Validating Credit Cards with creditcard		155	(4)
How Does It Work?		155	(1)
Verifying Credit-Card Numbers in Batch with creditcard		156	(2)
Conclusion		158	(1)
Writing PDFs with pdf-writer		159	(8)
How Does It Work?		159	(1)
Creating Reports with pdf-writer and Net/SFTP		160	(5)
Conclusion		165	(2)
Handling Recurring Events with runt		167	(8)
How Does It Work?		167	(2)
Planning User-Group Meetings with runt		169	(3)
Executing Commands on a Recurring Schedule		172	(1)
Conclusion		173	(2)
Building Websites with Rails		175	(8)
How Does It Work?		175	(1)
A Simple Database Application with Rails		176	(6)
Conclusion		182	(1)
Automating Development Tasks with rake		183	(8)
How Does It Work?		183	(1)
Easy Documentation with BlueCloth and rake		184	(5)
Conclusion		189	(2)
Manipulating Images with RMagick		191	(8)
How Does It Work?		191	(1)
Creating Thumbnails with RMagick		192	(6)
Conclusion		198	(1)
Speeding Up Web Applications with memcache-client		199	(10)
How Does It Work?		199	(1)
Speeding Up the Ruby on Rails Session Cache with memcached		200	(5)
Accessing memcached Servers with a Graphical Client		205	(2)
Conclusion		207	(2)
Managing Zip Archives with rubyzip		209	(6)
How Does It Work?		209	(1)
Reading Text from a Zip File		210	(3)
Conclusion		213	(2)
Speeding Up Function Calls with memoize		215	(6)
How Does It Work?		215	(2)
Organizing a List of MP3s		217	(3)
Conclusion		220	(1)
Tagging MP3 Files with id3lib-ruby		221	(6)
How Does It Work?		221	(1)
Changing MP3 Tags with ID3 Mass Tagger		222	(3)
Conclusion		225	(2)
Shortening URLs with shorturl		227	(4)
How Does It Work?		227	(1)
Shortening RSS Feeds with shorturl		228	(2)
Conclusion		230	(1)
Creating Standalone Ruby Applications with rubyscript2exe		231	(6)
How Does It Work?		231	(1)
Packaging the id3tool Script with rubyscript2exe		232	(4)
Conclusion		236	(1)
Cleaning Dirty HTML with tidy		237	(8)
How Does It Work?		237	(3)
Tidying Up HTML on the Web with tidy		240	(3)
Conclusion		243	(2)
Parsing XML with xml-simple		245	(10)
How Does It Work?		245	(3)
Tracking OpenSSL Vulnerabilities with xml-simple		248	(3)
Conclusion		251	(4)
PART 3 Creating Gems
Creating Our Own Gems		255	(6)
What Is Inside a Gem?		255	(1)
What's a Gemspec?		255	(1)
Building a Gem Package from a Gemspec		256	(4)
Conclusion		260	(1)
Distributing Gems		261	(6)
Distribution Methods		261	(5)
Conclusion		266	(1)
Index		267

David Berube is a Ruby developer, trainer, author, and speaker. He's used both Ruby and Ruby on Rails for several years, starting in 2003 when he became a Ruby advocate after he wrote about the language for Dr Dobb's Journal. Prior to this, he worked professionally with PHP, Perl, C++, and Visual Basic. His professional accomplishments include creating the Ruby on Rails engine for CoolRuby.com, a site that tracks the latest Ruby developments, and working with ThoughtBot.com on the Rails engine that powers Sermo America's Top Doctor contest. Additionally, he has worked on several other Ruby projects, including the engine powering CyberKnowHow's BirdFluBreakingNews search engine, and he also created the Slueshi text adventure game system, a multiplayer text game engine written in Ruby. David's journalism has been in print in over 65 countries, in magazines such as Linux Magazine, Dr Dobb's Journal, and PHP International Magazine. He's also taught college courses and spoken publicly on topics such as "MySQL and You" and "Making Money with Open Source Software." He lives in New Hampshire and his hobbies include basketball, yo-yos, and sleep.