RunRails-Blog

Herzlich Willkommen zum ersten Artikel in meiner neuen Kategorie “Gem Review”

Vor einen halben Jahr wurde von Google die Google Chart API veröffentlicht. Völlig unkompliziert, ohne Anmeldung, API-Keys oder weitere Einschränkungen können dort schicke Diagramme erzeugt werden. Alle notwendigen Parameter werden mit der Bild-URL übergeben.

Damit genug Datenpunkte zum Erstellen eines Diagramms in die URL passen, verwendet die API eine ungewöhnliche Kodierung der Zahlen aus Buchstaben und Sonderzeichen.

Um sich darüber nicht den Kopf zerbrechen zu müssen, gibt es zwei Gem-Lösungen für Ruby: gchartrb und googlecharts. Ich habe zwar zuerst den Blog-Beintrag über gchartrb gefunden, bin dann aber über den Kommentar dort zu einem Blog-Beitrag über googlecharts gekommen, welcher mich mehr angesprochen hat. U.a. deshalb weil mir dort direkt ein Beispielcode entgegensprang.

Im Moment gibt es wohl das bestreben, die beiden Projekte zu vereinen unter gchart, welches allerdings erst mit Version 0.5 angegeben wird. Ich verwende daher erstmal das googlecharts-Gem.

Installation

Installiert wird das gem durch Eingabe von
gem install googlecharts
Rails-Projekte, die dieses Gem verwenden, sollten in config/environment.rb noch die Zeile

gem 'googlecharts'

hinzufügen- damit wird erreicht, dass die Anwendung nicht startet, sollte das Gem nicht installiert sein.

In jedem Controller, dessen Views googlechart benutzen, sollte require ‘gchart’ eingefügt werden. Falls diese Charts sowieso von fast jedem View benutzt werden, kann man das require auch in application.rb (ApplicationController) einfügen, dann ist es überall geladen.

Heute möchte ich kurz einen hilfreichen Enumerator vorstellen, den ich bis vor kurzem noch nicht kannte: each_with_index.

Problem

Jeder kennt each, welches einen Block auf jedem Element aus einer Liste ausführt. Ähnlich wie foreach in PHP kann man sich so eine ausgewachsene for-Schleife mit Index-Variable, Endbedingung und Inkrementierung sparen. Manchmal möchte man aber trotzdem wissen, an welcher Stelle das aktuelle Element in der Liste steht.

each_with_index

Der Enumerator each_with_index verlangt einen Block mit zwei Parametern: Dem eigentlichen Listenelement, und einer Index-Variablen.

Beispiel:

liste = %w{eins zwei drei}
liste.each_with_index { |element, index| puts "#{index+1}ter Eintrag: #{element}" }

Ausgabe:

1ter Eintrag: eins
2ter Eintrag: zwei
3ter Eintrag: drei

Benötigt man nur den Index ohne Element, gibt es auch each_index, welche nur einen Block-Parameter (den Index) hat.