Nota

Plugin ruby byl pisany przez osobe ktora z rubym ma b. malo wspolnego. Dokumentacja tez. Ksztalt skryptow byl konsultowany z uzytkownikami ruby'ego; Jednakze jesli myslisz ze aktualne API nie jest ruby-like, i uwazasz ze powinno byc zrobione inaczej, pisz na ekg2-devel.

Plugin ruby jest under development, co znaczy ze calkiem mozliwe ze API jutro bedzie inaczej wygladac, niz wyglada dzis.

Najpierw sprawdzmy czy plugin ruby sie skompilowal - bez niego nic nie zrobimy!

$ ls `ekg2-config --plugin-dir`/ruby.so
/usr/local/lib/ekg2/plugins/ruby.so

Wiec jest ok :)

Ponizej najprostszy skrypt w ruby dla ekg2.

if $0 != "ekg2"
    print <<MSG
    warning: you are executing an embedded ruby file!
    this file is suppose to be run only from ekg2.
MSG
    exit
end

include Ekg2

class Ekg2::Script::HelloWorld < Ekg2::Script
    def initialize
        super

        print "Hello World!"
    end

    def finalize
        print "Zegnaj swiecie!"
    end
end

Nie, ogolnie to nie bedzie dokumentacja: "Jak programuje sie w ruby dla ekg2 - dla topornych"
Tylko chcialbym zakreslic pewne niuanse, jakich wymaga ekg2, do poprawnej obslugi skryptow.

Na poczatku jest kod, ktory uniemozliwia uruchamianie skryptu poza ekg2.
Potem mamy definicje klasy o nazwie Ekg2::Script::HelloWorld, dziedziczacej po Ekg2::Script

nazwa klasy musi sie zaczynac z duzej litery.
musi miec taka sama nazwe jak skrypt. (Czyli ten skrypt nalezy zapisac jako HelloWorld.rb)
musi dziedziczyc po Ekg2::Script
funkcja initialize musi miec na samym poczatku 'super'

Zapisujemy skrypt w ~/.ekg2/truby/scripts/HelloWorld.rb
$ ~/.ekg2/truby/scripts $ ruby HelloWorld.rb 
    warning: you are executing an embedded ruby file!
    this file is suppose to be run only from ekg2.

$ ekg2 -u truby
/plugin +ruby
/script +HelloWorld

xx:yy:aa ::: [script,HelloWorld] (ruby) Hello World!
xx:yy:aa ::: Skrypt HelloWorld (/home/darkjames/.ekg2/truby/scripts/HelloWorld.rb) zostal zaladowany (ruby)

/script -HelloWorld
xx:yy:zz ::: [script,HelloWorld] (ruby) Zegnaj swiecie!
xx:yy:zz ::: Skrypt HelloWorld (/home/darkjames/.ekg2/truby/scripts/HelloWorld.rb) zostal usuniety (ruby)

Hurray.

[XXX, tutaj juz konkretnie pisac o API]