$ sudo gem install mysql
Building native extensions.  This could take a while...
ERROR:  Error installing mysql:
        ERROR: Failed to build gem native extension.
 
/usr/bin/ruby1.8 extconf.rb install mysql
checking for mysql_query() in -lmysqlclient... no
checking for main() in -lm... yes
checking for mysql_query() in -lmysqlclient... no
checking for main() in -lz... no
checking for mysql_query() in -lmysqlclient... no
checking for main() in -lsocket... no
checking for mysql_query() in -lmysqlclient... no
checking for main() in -lnsl... yes
checking for mysql_query() in -lmysqlclient... no
*** extconf.rb failed ***
Could not create Makefile due to some reason, probably lack of
necessary libraries and/or headers.  Check the mkmf.log file
for more details. You may need configuration options.
[...]

Die Fehlermeldung weist darauf hin, dass die Client-Sourcen von MySQL finden; bei der Erstellung der nativen Anteile der Ruby-MySQL-Bindings wird versucht, gegen die Bibliothek mit den entsprechenden Routinen zu binden (-lmysqlclient).

Die notwendige Entwickler-Bibliothek des MySQL-Clients kann folgendermaßen installiert werden:

$ sudo apt-get install libmysqlclient15-dev

Danach kann dann das mysql-Gem installiert werden:

$ sudo gem install mysql

Fertig.

$ sudo gem install sqlite3-ruby
Building native extensions.  This could take a while...
ERROR:  Error installing sqlite3-ruby:
        ERROR: Failed to build gem native extension.
 
/usr/bin/ruby1.8 extconf.rb install sqlite3-ruby
checking for sqlite3.h... no
 
make
make: *** No rule to make target 'ruby.h', 
      needed by `sqlite3_api_wrap.o'.  Stop.

Die Lösung für dieses Problem: Man muss zunächst das Ubuntu-Package libsqlite3-dev installieren:

$ sudo apt-get install libsqlite3-dev
$ sudo gem install sqlite3-ruby

Ein kurzer Test in irb:

$ irb
irb(main):001:0> require 'rubygems'
=> true
irb(main):002:0> require 'sqlite3'
=> true
irb(main):004:0> db.execute(
         "CREATE TABLE test(id INTEGER, content TEXT)" )
=> []
irb(main):005:0> rows = db.execute( "SELECT * FROM test" )
=> []
irb(main):006:0> rows.length
=> 0

Case closed.

Insbesondere von Rails unterscheiden sich Merb und Ramaze durch die Rückkehr zum »micro framework«, einer bewussten Beschränkung auf das Wesentliche und bleiben dadurch klein, performant und flexibel; Ruby on Rails hingegen versucht durch »convention over configuration« dem Anwender ein recht festes Grundgerüst vorzugeben, dass bis hin zu Konventionen (böswillig: »Vorschriften«) bei der Benennung von Entwicklungsobjekten (Klassen, Methoden, Templates, Layouts, ...) reicht. Der Entwickler/Anwender muss sich also zwischen zwei grundsätzlich unterschiedlichen Philosophien unterscheiden: zwischen maximaler Selbständigkeit (Merb, Ramaze, ...) und einem recht strikten Vorgehensmodell (Ruby on Rails).

Falls man sich nun für Merb entscheidet, besteht die erste Hürde unter Umständen schon in der Installation. Diese ist z.B. unter Ubuntu gar nicht so ohne, da Ubuntu und andere Debian-basierte Linux-Distributionen momentan einen kleinen, aber folgenreichen Fehler bei der Installation der rubygems machen. Nach einem

$ sudo apt-get install rubygems

sind die Rubygems (ein Paketmanager für Ruby-Erweiterungen) zwar installiert, neu hinzugefügte Gems mit eigenen Binaries wie etwa Rails, Merb, Ramaze, Mongrel und andere können allerdings nicht von der Kommandozeile aus aufgerufen werden. Die Lösung dazu habe ich in einem separaten Post beschrieben.

Merb selbst kann zwar auch als RubyGem bezogen werden, es bietet sich allerdings dringend an, die neueste Version aus dem trunk des Subversion-Repositories zu installieren. Damit das glatt über die Bühne geht, sollte man zunächst die Abhängigkeiten von Merb installieren:

$ sudo gem install mongrel json_pure erubis mime-types \
  rspec rubigen ruby2ruby rake

Nun können wir uns an die Installation von Merb selbst machen:

# eventuell muss Subversion noch installiert werden
$ sudo apt-get install subversion
$ cd /tmp
$ svn checkout http://svn.devjavu.com/merb/trunk merb
$ cd merb
$ rake gem
$ sudo gem install pkg/merb-0.5.0.gem

Fertig. Kurz ausprobieren, ob alles klappt:

$ cd /tmp
$ merb myapp
$ cd myapp
$ merb

Im Browser kann man nun auf http://localhost:4000 die generierte (und noch völlig nutzlose …) Webanwendung aufrufen. Man darf sich nur nicht wundern, dass man eine hübsch aufgemachte Fehlermeldung zu sehen bekommt – da noch nichts implemeniert ist, kann Merb auch noch keinen Content serven; insbesondere fehlt ein Controller.

Zeit, sich ans implementieren der nächsten Web 2.0 Killer Application zu machen …

Die Sprache selbst kann auf Ubuntu, Kubuntu und anderen auf Debian basierenden Linux-Distributionen komfortable über den Paketmanager installiert werden:

$ sudo apt-get install ruby

Erweiterungen für Ruby werden typischerweise als so genannte »gems« verbreitet und installiert. Dazu wird zunächst der Paketmanager für diese Gems installiert:

$ sudo apt-get install rubygems

Danach können dann – ähnlich wie bei apt – Ruby-Erweiterungen als Ruby-Gems installiert werden:

$ sudo gem install mechanize

installiert z.B. das Ruby-Gem Mechanize, mit dem man automatisiert per HTTP mit Web-Servern kommunizieren kann.

So weit, so gut. Problematisch wird das Ganze, wenn ein solches Gem auch ein direkt ausführbares Kommando mitbringt. Debian, Ubuntu und Kubuntu haben nämlich einen kleinen Fehler in den bereitgestellten deb-Archiven für rubygems, der leider immer noch nicht gefixt ist.

Ein gutes Beispiel ist Ruby on Rails, ein sehr populäres Model-View-Controller-Framework zur Entwicklung von datenbankbasierten Webanwendungen. Die Installation mit

$ sudo gem install rails --include-dependencies
Bulk updating Gem source index for: http://gems.rubyforge.org
Successfully installed rails-2.0.2
Successfully installed activesupport-2.0.2
Successfully installed activerecord-2.0.2
Successfully installed actionpack-2.0.2
Successfully installed actionmailer-2.0.2
Successfully installed activeresource-2.0.2
Installing ri documentation for activesupport-2.0.2...
Installing ri documentation for activerecord-2.0.2...
Installing ri documentation for actionpack-2.0.2...
Installing ri documentation for actionmailer-2.0.2...
Installing ri documentation for activeresource-2.0.2...
Installing RDoc documentation for activesupport-2.0.2...
Installing RDoc documentation for activerecord-2.0.2...
Installing RDoc documentation for actionpack-2.0.2...
Installing RDoc documentation for actionmailer-2.0.2...
Installing RDoc documentation for activeresource-2.0.2...

sollte problemlos funktionieren. Das Rails-Gem bringt nun aber auch ein neues Kommando mit: rails, mit dem das Grundgerüst für eine neue Web-Anwendung automatisch erzeugt wird.

Ein Aufruf

$ rails myapp
The program 'rails' is currently not installed.  
        You can install it by typing:
sudo apt-get install rails
bash: rails: command not found

schlägt aber fehl, da das Binary in /var/lib/gems/1.8/bin/ liegt; dieses Verzeichnis ist allerdings nicht im $PATH des Anwenders. Die ersten beiden Zeilen der Fehlermeldung weisen übrigens darauf hin, dass man Rails auch über apt installieren kann; das ist allerdings nur mäßig ratsam, da man über apt eine schon etwas angestaubte Version bekommt und gerade die Ruby-Packages unter Debian/Ubuntu/Kubuntu nicht immer über jeden Zweifel erhaben sind …

Was hilft? Ein kleiner, ein bisschen unschöner Hack der bashrc. Man fügt an die ~/.bashrc folgende Zeile an:

export PATH=$PATH:/var/lib/gems/1.8/bin/

Wer das gleich für alle Nutzer des Systems und nicht nur für sich selbst fixen möchte, kann diese Zeile auch an /etc/bash.bashrc anfügen.

Ein kurzer Test zeigt, dass das Problem nun behoben ist:

$ rails myapp
      create
      create  app/controllers
      create  app/helpers
      create  app/models
      create  app/views/layouts
      create  config/environments
[...]
      create  public/javascripts/application.js
      create  doc/README_FOR_APP
      create  log/server.log
      create  log/production.log
      create  log/development.log
      create  log/test.log

Case closed.

Denn wie immer, wenn der Paket-Manager (in diesem Falle also apt) die Pakete nicht im Repository finden kann, steht man ein bisschen im Regen. Natürlich lässt sich RMagick (wie bei Ruby-Paketen üblich) auch über die gem-Repositories installieren. Probiert man das dann, passiert aber folgendes:

$ sudo gem install rmagick
Building native extensions.  This could take a while...
ERROR:  While executing gem ...
  (Gem::Installer::ExtensionBuildError)
    ERROR: Failed to build gem native extension.
 
ruby gem_extconf.rb install rmagick
 
sh configure
 
Configuring RMagick 1.15.11
checking for gcc... gcc
checking for C compiler default output file name... a.out
checking whether the C compiler works... yes
checking whether we are cross compiling... no
checking for suffix of executables...
checking for suffix of object files... o
checking whether we are using the GNU C compiler... yes
checking whether gcc accepts -g... yes
checking for gcc option to accept ISO C89... none needed
checking for gcc option to accept ISO C99... -std=gnu99
checking for gcc -std=gnu99 option to accept ISO Standard C...
  (cached) -std=gnu99
checking for ruby... /usr/bin/ruby
checking for Magick-config... no
checking for GraphicsMagick-config... no
configure: error: Can't install RMagick.
  Can't find Magick-config or GraphicsMagick-config program.
RMagick configuration failed with status 1.
 
 
Gem files will remain installed in
  /var/lib/gems/1.8/gems/rmagick-1.15.11 for inspection.
Results logged to
  /var/lib/gems/1.8/gems/rmagick-1.15.11/gem_make.out

Wie so oft besteht die Lösung darin, zunächst ein paar andere Pakete zu installieren. In unserem Fall sind das zunächst einmal die build-essentials:

$ sudo apt-get install build-essential

Damit sind wir aber noch nicht fertig. Was fehlt noch? Ein Blick in Google und Co. bringt folgende Lösung:

$ sudo apt-get install libmagick9-dev ruby1.8-dev

Danach sollte ein neuerlicher Aufruf

$ sudo gem install rmagick

zum gewünschten Ergebnis führen.

Angeblich wäre ich – zumindest laut des Tests bei BBSpot – LISP, wenn ich eine Programmiersprache wäre. Dabei kann ich LISP nur … sagen wir mal: rudimentär. Und gemocht werde ich auch kaum.

Was soll man da machen? Einfach den Test noch einmal durchgehen und ein paar Fragen anders beantworten …

Ergebnis dieses Mal:

Schon wieder eine Sprache, die ich nur ansatzweise beherrsche – und die auch noch mit LISP verwandt ist.

OK, ein letzter Versuch:

Na also. Geht doch.

[via F!XMBR]

Das erste Problem: Die entsprechenden RFC 822, 1652, 2821, etc. sind nämlich ein bisschen haarig zu lesen, außerdem gibt es so viele davon; nach meiner Zählung muss man sich bei der standard-konformen Implementierung von eMail-Funktionalität (sprich: SMTP) um mindestens 24 RFCs kümmern; wir sind ja nicht Microsoft und definieren unsere eigenen Standards …

Gut, worin liegt nun das eigentliche Problem? Kurz gefasst: eMail-Subjects sollen ausschließlich Zeichen des 7bit-ASCII enthalten. Für den englisch-sprachigen Raum mag das angehen, für Europa, Südamerika und Asien hingegen reicht das bei weitem nicht.

Also muss das Subjekt z.B. in einen UTF-8-Wrapper kodiert werden. Die Zeile

Subject: Vielen Dank für die Blumen!

sieht korrekt kodiert dann so aus:

Subject: =?utf-8?b?VmllbGVuIERhbmsgZsO8ciBkaWUgQmx1bWVuIQ==?=

Kann man gut lesen, oder?!

Wer das ganze als bequeme Ruby-Methode haben möchte, darf sich an folgendem Code bedienen:

def encodeSubject(subject)
    "=?utf-8?b?#{[subject].pack("m").delete("\n")}?="
end

Solchen Code sollte man typischerweise großflächig mit Warnhinweisen kommentieren, dass nur derjenige, der ihn auch wirklich versteht, zu Änderungen befugt ist …

Das Buch fällt durch seinen lockeren Stil auf und bietet eine fundierte Einführung in die Sprache Ruby mitsamt einiger häufig gebrauchter Idiome in dieser mehr und mehr an Bedeutung gewinnenden Skriptsprache.

Empfehlung: Lesen!