Lehekülje Ruby lähteteksti vaatamine

===Sissejuhatus===

Ruby http://www.ruby-lang.org/ on populaare programmeerimikeel, millele on iseloomulikud sellised asjaolud

* objekt-orienteeritud keel
* skriptimskeel

2010 aastal on levinud kaks Ruby versiooni

* 1.8 - ...
* 1.9 - ...

===Ruby paigaldamine===

Debian Lenny paketihalduses on olemas kaks Ruby versiooni

* 1.8.7 - vaikimisi
* 1.9.0 - võimalik lisaks paigaldada 

Ruby v. 1.8.7 paigaldmiseks sobib Debianis öelda (tegelik paketinimi on ruby1.8)

 # apt-get install ruby

või FreeBSD puhul

 # cd /usr/ports/lang/ruby18
 # make install clean

Lisaks paigaldatakse pakett libruby1.8, mis sisaldab Ruby kasutamiseks vajalikke teeke, teegid kopeeritakse kataloogi

 /usr/lib/ruby/1.8

Paigaldatud Ruby versiooni küsimiseks sobib öelda

 $ ruby -v
 ruby 1.8.7 (2008-08-11 patchlevel 72) [i486-linux]

===Ruby paigaldamine RVMi abil===

RVM on lühend mis tähendab Ruby Version Manager. RVM võimaldab käigupealt ja kergelt paigaldada, hallata ja vahetada Ruby versiooni olles seega asendamatu töömees arendajatele, kes testivad enda rakenduste tööd erinevate versioonidega. RVMi kasutamise üheks eelduseks on see, et süsteemi on paigaldatud curl.

RVMi paigalduseks tuleb anda käsk:

 # bash < <( curl http://rvm.beginrescueend.com/releases/rvm-install-head )

Misjärel tehakse kogu RVMi paigaldusprotsess automaatselt ära.
RVMi kasutamiseks, näiteks Ruby 1.8 paigaldamiseks tuleb trükkida käsk:

 # rvm install 1.8.7

Misjärel RVM paigaldab ja kompileerib Ruby koos kõikide sõltuvuste ja vajalike failidega, kaasaarvatud RubyGemsiga.

Peale versiooni paigaldust tuleb süsteemile öelda, et võtame uue versiooni kasutusele käsuga:

 # rvm use 1.8.7

Sedamoodi võib otse "lennult" vahetada Ruby versiooni näiteks 1.8 ja 1.9 vahel. Nüüd võime paigaldada süsteemi ka teise versiooni:

 # rvm install 1.9.2

Ning lülituda use võtme abil ümber hoopis sellele.

Rohkem infot leiab kodulehelt: http://beginrescueend.com/

===Ruby dokumentatsioon===

FreeBSDs paigaldatakse dokumentatsioon vaikimisi koos Rubyga. Debianis tuleb selle kasutamiseks paigaldada pakett ri

 # apt-get install ri

ning nt Resolv teegi kohta info küsimiseks öelda

 $ ri Resolv
 ---------------------------------------------------------- Class: Resolv
     Resolv is a thread-aware DNS resolver library written in Ruby.
     Resolv can handle multiple DNS requests concurrently without
     blocking. The ruby interpreter.
 
     See also resolv-replace.rb to replace the libc resolver with #
     Resolv.
 
     Resolv can look up various DNS resources using the DNS module
     directly.
 
     Examples:
 
       p Resolv.getaddress "www.ruby-lang.org"
       p Resolv.getname "210.251.121.214"

===RubyGems===

RubyGems on Ruby sisemine moodulite halduse süsteem. Gems süsteemi kasutamise kohta näeb näiteid öeldes

 # gem help examples

Paigaldatud tarkvara nimekirja näeb

 # gem list --local

Tarkvara paigaldamiseks sobib öelda nt

 # gem install paketinimi

Tarkvara saab otsida öeldes

 # gem search marksona --remote

Selle kasutamiseks on vajalik paigaldada pakett rubygems

http://docs.rubygems.org/read/chapter/2 lisalugemist

===Programmeerimine Rubys===

Ruby on

* dünaamilise tüübiskeemiga (ingl. k. dynamically typed) keel - programmi käivitamisel ajal (ingl. k. runtime) toimub tüüpide üle otsustamine; st praktiliselt, et nt muutujate väärtustamisel ei pea nende tüüpe kirjeldama
* nõrga tüübiskeemiga (ingl. k. weakly typed) keel - erinevat tüüpi muutujatega saab teha teatud operatsioone, nt liita arv ja sõne

Ruby on objekt-orienteeritud keel, st kõik Rubys on objektid, sh numbrid, nt avaldis esitab arvu viis meetodid

 puts 5.methods

ja avaldis esitab arvu viis klassi

 puts 5.class

Kiire interaktiivse ülevaate Rubys programeerimises leiab lingilt http://tryruby.org/

===Ruby interpretaator===

Ruby interpretaator (tõlgendaja) annab kasutajale võimaluse ruby koodi katsetada. Puuduseks on see, et funktsioonide defineerimisel tekkivad apsakad tulevad alles lõpus välja ning nende parandamine on aeganõudev.

Ruby interpretaatori paigaldamiseks tuleb Debian operatsiooni puhul öelda

 # apt-get install irb

Interpretaatorit saab kasutada nt kalkulaatorina

 $ irb
 irb(main):001:0> 20.0/8
 => 2.5

või ka 

 $ irb
 irb(main):001:0> require 'date'
 => true
 irb(main):002:0> t2na = Date.today
 => #<Date: 4910765/2,0,2299161>
 irb(main):003:0> sada_p2eva_hiljem = t2na + 100
 => #<Date: 4910965/2,0,2299161>
 irb(main):004:0> t2na.to_s
 => "2010-07-05"
 irb(main):005:0> sada_p2eva_hiljem.to_s
 => "2010-10-13"

===Ruby skript===

Ruby skript esineb tekstifaili kujul, nt selline skript kirjutab 'Hello, world'

 puts "Hello, world!"

Skripti käivitamiseks sobib öelda

  $ ruby skript.rb

Alternatiiviks on lisada faili algusse rida interpretaatori nimega

 #!/usr/bin/ruby
 puts "Hello, world!"

ning muuta fail käivitatavaks

 $ chmod 0755 skript.rb

või

 $ chmod +x skript.rb

ning käivitada

 $ ./skript.rb

===Andmestruktuurid===

TODO

====Sõne====

 muutuja = "Tere hommikust!"

Sõne osa 'hommikust' poole saab pöörduda selliselt

 muutuja[5..13]

====Arv====

 muutuja = 5

====Massiiv====

Massiiv või ka jada (ingl. k. list) on järjestatud hulk

 massiivinimi = ["yks", "kaks", "kolm"]

Massiivi elemendi poole pöördumine toimub selliselt

 puts massiivinimi[1]

Tänu Ruby objekt-orienteeritusele saab kasutades massiivi meetodit each öelda nii

 massiivinimi = ["yks", "kaks", "kolm"]
 
 massiivinimi.each do |massiivielement|
   puts massiivielement
 end

 ary = [1, 2, 3]
 puts ary[0]

Või keerukam näide

 cities  = %w[ London
               Oslo
               Paris
               Amsterdam
               Berlin ]
 visited = %w[Berlin Oslo]
 
 puts "I still need " +
      "to visit the " +
      "following cities:",
      cities - visited

Viimases näites defineeritakse jada kiirmeetodil, kasutades %w tähist, kusjuures jada elemente ei pea jutumärkidesse panema.

Suurima numbri leidmine jadast

 [12, 47, 35].max                                                     
 => 47  

Jada sorteerimiseks 

 jadanimi.sort!

====Sõnastik====

Sõnastik (ingl. k. hash) on key-value paaridest koosnev järjestamata hulk

  sonastik = { 'priit': 167, 'mart': 196 }

Sõnastiku elemendi väärtuse esitamine toimub nii

  print sonastik["print"]

===Meetodid===

Meetodid võimaldavad programmi teksti loogiliselt organiseerida, nt eraldada osa korduvaks kasutamiseks.

 def korrutamine(x, y)
   return x * y
 end
 
 puts korrutamine(15, 3)

Teatud mõttes võib öelda, et tänu Ruby objekt-orienteeritusele on need asjad mis nö tavaliselt on funktsioonid Rubys meetodid.

===Konsoolilt sisendi lugemine===

 print "Enter your name: "
 name = gets

===Stringitöötlus===

 herb = "parsley"
 puts herb[0,1]
 puts herb[0..3]

tulemuseks 

 p
 pars


Mitu märki on stringis ? 
 "Jimmy".length

Stringi kordus

 "Jimmy" * 5

'''Random funktsioon'''

 puts rand(10)

saame suvalise numbri 0-10

 for num in (0..100)
     print num,"\n"
 end

Lihtne tsükkel nullist sajani

topelt tsükkel mis väljastab number ühtedest koosneva tabeli

   1.upto(10) do |fg|
     1.upto(10) do |bg|
       print "1"
     end
   puts
   end

===Shelli värvid===

 puts " \e[32mROHELINE\e[0m"

värvitabel, asjalik-vajalik

 [0, 1, 4, 5, 7].each do |attr|
   puts '----------------------------------------------------------------'
   puts "ESC[#{attr};Foreground;Background"
   30.upto(37) do |fg|
     40.upto(47) do |bg|
       print "\033[#{attr};#{fg};#{bg}m #{fg};#{bg}  "
     end
   puts "\033[0m"
   end
 end

 #!/usr/bin/env ruby
 require 'pathname'
  Pathname.new($0).realpath()

'''Shellis parameetrina antavad argumendid'''

 ARGV.each do|a|
   puts "Argument: #{a}"
 end

Kasutamine

 '''./arg.sh ahaa'''
 Argument: ahaa

===failioperatsioonid===

Üldpõhimõte oleks

 File.open("file", "r") do |io|
     # do something with io
 end

Lihtne faili lugemine

 print File.read("/comics.txt")

Avame faili ja loeme sealt infot

 File.open("/location/of/my/file.txt", "r") do |f|
  while ! f.eof do
   line = f.gets
   puts line #Print the line to the screen
  end
 end

===Klassi kirjeldamine===

 class Arvutaja
   def meelespea
     puts "Monede tehete tulemus soltub jarjekorrast"
   end
 end
 
 class Liitja < Arvutaja
   def liitja
     puts "Liitmine ei soltu jarjekorrast"
   end
 end
 
 arvuta = Liitja.new
 arvuta.meelespea
 arvuta.liitja

kus

* kirjeldatakse kaks klassi, Arvutaja ja Liitja
* Liitja.new tekitab uue objekti 'arvuta'
* arvuti.meelespea ja arvuta.liitja kutsuvad täitmiseks välja klassi meetodid meelespea ning liitja
* klass Liitja pärib klassi Arvutaja meetodid, seetõttu on võimalik kasutada arvuta.meelespea'd mida otseselt ei ole kirjeldatud Liitja klassis
* klasside nimesid on oluline alustada suure algustähega

===SMTP===

 require 'net/smtp'
 
 msgstr = <<END_OF_MESSAGE
 From: Priit Kask <priit@loomaaed.tartu.ee>
 To: Mart Kask <mart@loomaaed.tartu.ee>
 Subject: kevad saabub, puurid puhtaks
 
 Kirja sisu
 END_OF_MESSAGE
 
 smtp = Net::SMTP.start('192.168.1.250', 25, 'loomaaed.tartu.ee')
 smtp.send_message msgstr, 'priit@loomaaed.tartu.ee', 'mart@loomaaed.tartu.ee'
 smtp.finish

===Mysql andmebaasi kasutamine===

Ühendumine ja query päring

 require 'mysql'
 
 mysql = Mysql.init()
 mysql.connect('localhost')
 
 results = mysql.query("SELECT now();")
 
 results.each{|row|; puts row;}
 
 mysql.close()

Tabeli kustutamine, tekitamine ja sinna info lisamine

 require 'mysql'
 
 mysql = Mysql.init()
 mysql.connect('localhost')
 mysql.select_db('test')
 
 mysql.query("DROP TABLE IF EXISTS rocks")
 
 mysql.query("CREATE TABLE rocks (id INT UNSIGNED NOT NULL AUTO_INCREMENT, PRIMARY KEY (id), rockname CHAR(20) NOT  NULL);")
 
 mysql.query("INSERT INTO rocks (rockname) values('Granite');")
 mysql.query("INSERT INTO rocks (rockname) values('Coal');")
 mysql.query("INSERT INTO rocks (rockname) values('Quartz');")
 
 mysql.close()

===PostgreSQL andmebaasi kasutamine===

PostgreSQL andmebaasi saab Ruby seest kasutada mooduli ruby-pg abil.

Gemist installiks tuleb öelda

 # gem install postgres

Debian Lenny keskkonnas sobib selleks paigaldada pakett

 # apt-get install libpgsql-ruby

Skript küsib andmebaasist public.kasutajad tabelist kahte väärtust 

 require 'pg'
 conn = PGconn.connect("192.168.1.247", 5432, '', '', "andmebaasinimi", "kasutajanimi", "parool")
 res = conn.exec("SELECT nimi, vanus FROM kasutajad where nimi = 'Priit Kask';")
 
 res.each do |rida|
   puts "Nimi: #{rida['nimi']}, vanus: #{rida['vanus']}"
 end
 
 res.clear
 conn.close

===Oracle andmebaasi kasutamine===

Oracle andmebaasi saab Ruby seest kasutada mooduli ruby-oci8 abil. Paigaldamise ettevalmistamiseks tuleb

* tekitada nö tavapärasel viisil [[:Oracle_Instant_Client]] /opt/instantclient kataloog ning moodustada seal link

 # ln -s libclntsh.so.11.1 libclntsh.so

* paigaldada kompileerimiseks vajalikud paketid

 # apt-get install build-essential python-dev libaio-dev

* seadistada keskkonnamuutujad

 # export LD_LIBRARY_PATH=/opt/instantclient
 # export ORACLE_HOME=/opt/instantclient
 # export TNS_ADMIN=/opt/instantclient

Gemist installiks tuleb öelda

 # LD_LIBRARY_PATH=/opt/instantclient gem install ruby-oci8
 Building native extensions.  This could take a while...
 Successfully installed ruby-oci8-2.1.5
 1 gem installed
 Installing ri documentation for ruby-oci8-2.1.5...
 
 Enclosing class/module 'cOCI8' for module Metadata not known
 Installing RDoc documentation for ruby-oci8-2.1.5...
 
 Enclosing class/module 'cOCI8' for module Metadata not known

Tulemuse küsimiseks sobib öelda

 # gem list --local
 
 *** LOCAL GEMS ***
 
 ruby-oci8 (2.1.5)

Nt selline skript kirjutab tabelist t1 välja nö tulpade A ja B väärtused arvestades UTF-8 kodeeringut

 $ cat skript.rb
 require 'rubygems'
 ENV['NLS_LANG'] = 'ESTONIAN_ESTONIA.AL32UTF8'
 require 'oci8'
 conn = OCI8.new('KASUTAJANIMI','PAROOL', 'SIDNIMI')
 cursor = conn.exec('select A, B from t1')
 while r = cursor.fetch()
 puts r.join(',')
 end
 cursor.close
 conn.logoff

Käivitamiseks öelda

 $ ruby skript.rb > /tmp/valjund.txt

Kasulikud lisamaterjalid

* http://www.it-wikipedia.com/web/how-to-install-ruby-oci8-on-ubuntu-server.html

===DNS===

Skript esitab domeeninimele vastavad ip aadressid

 require 'resolv'
 
 Resolv::DNS.new.each_address("www.loomaaed.tartu.ee") do |addr|
   puts "www.loomaaed.tartu.ee A kirje: " + addr.to_s
 end

===Soketi kasutamine===

====Server====

 require "socket"
 
 ajaserver = TCPServer.new('192.168.10.35', 20000)
 loop do
   Thread.start(ajaserver.accept) do |s|
     print(s, " on vastuvoetud\n")
     s.write(Time.now)
     print(s, " on teenindatud\n")
     s.close
    end
  end

kus

* kasutatakse socket teeki
* moodustatakse ajaserver nimeline objekt
* käivitatakse loop korduse see uue lõime alustamine sissetuleva ühenduse tekkimsiele

====Klient====

 require 'socket'
 streamSock = TCPSocket.new( "192.168.10.35", 20000 )
 str = streamSock.recv( 100 )
 print str + "\n"
 streamSock.close

===Kasulikud lisamaterjalid===

* http://www.ruby-doc.org/docs/ruby-doc-bundle/UsersGuide/rg/index.html
* http://www.elctech.com/articles/ruby-daemons-and-angels ruby ja deemonid
* http://www.phptoruby.com/ php ja ruby süntaksi teisendused
* Learning Ruby (Michael Fitzgerald)
* Ruby Cookbook (Lucas Carlson, Leonard Richardson)
* http://rubyonrails.org/
* http://wiki.rubyonrails.org/
* http://www.humblelittlerubybook.com/
* http://lipsiadmin.com/
* http://www.ioncannon.net/programming/941/using-daemon-kit-and-robustthread-to-build-ruby-daemons/?utm_source=feedburner&utm_medium=feed&utm_campaign=Feed%3A+ioncannon+%28IONCANNON%29
* http://blade.nagaokaut.ac.jp/cgi-bin/scat.rb/ruby/ruby-talk/93305 nano süntaks värviliseks
* http://totalrecall.wordpress.com/2008/09/12/charming-ruby-with-curses/ ncurses abil kursori liigutamine