nosql-tutorial 0.1.0 → 0.1.1

data/lib/public/doc/datamapper/010-postgres.rb

@@ -0,0 +1,95 @@
+# -*- coding: utf-8 -*-
+#
+# 1. zakładamy bazę:
+#     createdb test
+# 2. uruchamiamy ten skrypt:
+#     ruby 010-postgres.rb
+# 3. przyłączamy się do bazy:
+#     psql test
+#     \d
+#     \encoding  # powinno być UTF8
+#     \q
+
+require 'rubygems'
+require 'dm-core'
+
+# http://cheat.errtheblog.com/s/datamapper/
+# DataMapper.setup(:default, "adapter://user:password@hostname/dbname")
+
+# sudo gem install dm-imap-adapter
+# sudo gem install dm-yaml-adapter
+
+# http://datamapper.rubyforge.org/dm-core/DataMapper.html
+#
+# DataMapper.setup(:default, {
+#   :adapter  => 'adapter_name_here',
+#   :database => "path/to/repo",
+#   :username => 'username',
+#   :password => 'password',
+#   :host     => 'hostname'
+# })
+
+# :fatal, :error, :warn, :info, :debug 
+
+log = DataMapper::Logger.new(STDOUT, :debug)
+
+log.push "==== hello datamapper"
+
+DataMapper.setup(:default,'postgres:test')
+
+class Post
+  include DataMapper::Resource
+
+  property :id,         Serial
+  property :title,      String
+  property :body,       Text
+  property :created_at, DateTime
+
+  has n, :comments
+end
+
+class Comment
+  include DataMapper::Resource
+
+  property :id,         Serial
+  property :posted_by,  String
+  property :email,      String
+  property :url,        String
+  property :body,       Text
+
+  belongs_to :post
+end
+
+class Category
+  include DataMapper::Resource
+
+  property :id,         Serial
+  property :name,       String
+end
+
+class Categorization
+  include DataMapper::Resource
+
+  property :id,         Serial
+  property :created_at, DateTime
+
+  belongs_to :category
+  belongs_to :post
+end
+
+class Post
+  has n, :categorizations
+  has n, :categories, :through => :categorizations
+end
+
+class Category
+  has n, :categorizations
+  has n, :posts, :through => :categorizations
+end
+
+# Post.auto_migrate!
+# Category.auto_migrate!
+# Comment.auto_migrate!
+# Categorization.auto_migrate!
+
+DataMapper.auto_migrate!

data/lib/public/doc/datamapper/bug.rb

@@ -0,0 +1,25 @@
+require 'rubygems'
+require 'dm-core'
+require 'extlib'
+
+DataMapper.setup :default, 'sqlite3:test.sqlite3'
+
+Extlib::Inflection.plural_word 'xs', 'xse'
+
+class Xs
+#class Comment
+  include DataMapper::Resource
+  property :id,    Serial
+  property :name,  String
+  belongs_to :film
+end
+
+class Film
+  include DataMapper::Resource
+  property :id,    Serial
+  property :name,  String
+  has n, :xse
+  #has n, :comments
+end
+
+DataMapper.auto_migrate!

data/lib/public/doc/mail/mail-20.rb

@@ -0,0 +1,40 @@
+# -*- coding: utf-8 -*-
+
+require 'rubygems'
+require 'action_mailer'
+require 'yaml'
+
+# wczytujemy login + hasło z pliku private.yaml
+#
+# ---
+# sigma: 
+#   :login: wbzyl
+#   :password: 'alamakota'
+# julia:
+#   :login: matwb
+#   :password: 'razdwatrzy'
+
+private = YAML.load(IO.read('../../../../../private.yaml'))
+
+ActionMailer::Base.smtp_settings = {
+  :address => 'inf.ug.edu.pl',
+  :port => 25,
+  :domain => 'ug.edu.pl',
+  :user_name => private['sigma'][:login],
+  :password => private['sigma'][:password],
+  :authentication => :login
+}
+
+class Notification < ActionMailer::Base
+  def signup_message(recipient)
+    from 'wbzyl@inf.ug.edu.pl'
+    content_type 'text/plain; charset=utf-8'
+    recipients recipient
+    subject 'action mailer test: 4'
+    body 'Treść emaila #4.'
+  end
+end
+
+puts Notification.create_signup_message('matwb@ug.edu.pl')
+
+Notification.deliver_signup_message('matwb@ug.edu.pl')

data/lib/public/doc/mail/mail-21.rb

@@ -0,0 +1,62 @@
+# -*- coding: utf-8 -*-
+
+require 'rubygems'
+require 'action_mailer'
+require 'mime/types'
+require 'yaml'
+
+# wczytujemy login + hasło z pliku private.yaml
+#
+# ---
+# sigma: 
+#   :login: wbzyl
+#   :password: 'alamakota'
+# julia:
+#   :login: matwb
+#   :password: 'razdwatrzy'
+
+private = YAML.load(IO.read('../../../../../private.yaml'))
+
+ActionMailer::Base.smtp_settings = {
+  :address => 'inf.ug.edu.pl',
+  :port => 25,
+  :domain => 'ug.edu.pl',
+  :user_name => private['sigma'][:login],
+  :password => private['sigma'][:password],
+  :authentication => :login
+}
+
+class Notification < ActionMailer::Base
+  def directory_dump(recipient, directory=Dir.pwd)
+    from 'wbzyl@inf.ug.edu.pl'
+    content_type 'text/plain; charset=utf-8'
+    recipients recipient
+    subject "zdjęcia z katalogu: #{directory}"
+    body %{Zdjęcia z katalogu: "#{directory}":}
+    Dir.glob('*.jpeg') do |f|
+      path = File.join(directory, f)
+      attachment('image/jpeg') do |a|
+        a.body = File.read(path)
+        a.filename = f
+        a.transfer_encoding = 'base64'
+      end
+    end
+  end
+end
+
+#puts Notification.create_directory_dump('matwb@ug.edu.pl', Dir.pwd)
+
+Notification.deliver_directory_dump('matwb@ug.edu.pl')
+
+__END__
+
+removing file from repo:
+  
+git filter-branch --index-filter \
+  'git rm --cached --ignore-unmatch private.yaml' merge-point..HEAD
+
+# remove the temporary history git-filter-branch otherwise leaves behind for a long time
+rm -rf .git/refs/original/ && git reflog expire --all &&  git gc --aggressive --prune
+
+git push
+#git push -f

data/lib/public/doc/mail/mail-gmail.rb

@@ -0,0 +1,34 @@
+# -*- coding: utf-8 -*-
+
+# sudo gem install ambethia-smtp-tls -v '1.1.2' --source http://gems.github.com
+
+require 'rubygems'
+require 'action_mailer'
+require 'smtp-tls'
+
+require 'yaml'
+
+private = YAML.load(IO.read('../../../../../private.yaml'))['gmail']
+
+ActionMailer::Base.delivery_method = :smtp
+
+class SimpleMailer <  ActionMailer::Base
+  def simple_message(recipient)
+    from 'wlodek.bzyl@gmail.com'
+    recipients recipient
+    subject 'Tę wiadomość wysłano z Gmail'
+    body 'To naprawdę działa!'
+  end
+end
+
+ActionMailer::Base.smtp_settings = {
+  :address => 'smtp.gmail.com',
+  :domain => 'gmail.com',
+  :port => 587,
+  :user_name => private['login'],
+  :password => private['password'],
+  :authentication => 'plain',
+  :enable_starttls_auto => true
+}
+
+SimpleMailer.deliver_simple_message('matwb@ug.edu.pl')

data/lib/public/doc/mail/private.yaml

@@ -0,0 +1,7 @@
+---
+sigma: 
+  :login: wbzyl
+  :password: 'alamakota'
+julia:
+  :login: matwb
+  :password: 'razdwatrzy'

data/lib/public/stylesheets/nosql.css

@@ -110,6 +110,14 @@ blockquote p.author {
   text-align: right;
 }
 
+blockquote h2 {
+  font-size: 100%;
+  font-family: Cyklop, sans-serif;
+  padding-bottom: 0px;
+  border-bottom: none;
+  color: #A00;
+}
+
 h2 {
   font-size: 130%;
   padding-bottom: 6px;

data/lib/views/blogi.rdiscount

@@ -0,0 +1,5 @@
+#### {% title "Blogi" %}
+
+# Lista obecności
+
+Lista blogów.

data/lib/views/couchdb-couchapp.rdiscount

@@ -0,0 +1,83 @@
+#### {% title "CouchDB — CouchApp" %}
+
+# CouchDB — CouchApp
+
+Czym jest [CouchApp]():
+„CouchApp—a set of scripts that allow complete, stand-alone CouchDB
+applications to be built using just HTML and JavaScript. These
+applications are housed in the CouchDB database, meaning that when the
+database is replicated, any applications stored in that database are
+also replicated.”
+
+## Instalacja
+
+CouchApp jest modułem do Pythona. Moduły można instalować
+korzystając z programu *easy_install*. 
+Program ten znajdziemy w paczce o nazwie *setuptool*
+(albo o podobnej nazwie).
+
+    sudo yum install setuptool
+    sudo easy_install couchdb
+    sudo easy_install simplejson
+    sudo easy_install couchapp
+
+## Hello World
+
+    mkdir ~/couchapps
+    cd ~/couchapps
+    couchapp hello_world
+
+Teraz
+
+    tree hello_world
+    hello_world/
+    |-- _attachments
+    |   |-- index.html
+    |   `-- style
+    |       `-- main.css
+    |-- _id
+    |-- couchapp.json
+    |-- lists
+    |-- shows
+    |-- updates
+    |-- vendor
+    |   `-- couchapp
+    |       |-- README.md
+    |       |-- _attachments
+    |       |   `-- jquery.couchapp.js
+    |       |-- couchapp.js
+    |       |-- date.js
+    |       |-- metadata.json
+    |       |-- path.js
+    |       `-- template.js
+    `-- views
+
+Następnie:
+
+    couchapp push hello_world http://127.0.0.1:5984/hello_world
+    [INFO] Visit your CouchApp here:
+    http://127.0.0.1:5984/hello_world/_design/hello_world/index.html
+
+Wchodzimy na powyżej wypisany URI.
+
+Wymieniamy zawartość pliku *index.html*:
+
+    <!DOCTYPE html>
+    <html>
+      <head>
+        <meta charset="utf-8">
+        <title>Witaj CouchApp</title>
+        <link rel="stylesheet" href="style/main.css" type="text/css">
+      </head>
+      <body>
+        <h1>Witaj CouchApp</h1>
+        <p>Jest fajnie!</p>
+      </body>
+      <script src="/_utils/script/json2.js"></script>
+      <script src="/_utils/script/jquery.js?1.3.2"></script>
+      <script src="/_utils/script/jquery.couch.js?0.11.0b"></script>
+    </html>
+
+Uaktualniamy aplikację, wykonując z katalogu *hello_world* polecenie:
+
+    couchapp push . http://127.0.0.1:5984/hello_world

data/lib/views/couchdb-crud.rdiscount

@@ -0,0 +1,205 @@
+#### {% title "CouchDB – CRUD" %}
+
+# CouchDB – Dokumenty
+
+W przykładach poniżej będziemy korzystać z:
+
+* [HTTP Document API](http://wiki.apache.org/couchdb/HTTP_Document_API)
+
+
+## Wykonywanie CRUD na dokumentach
+
+Zaczynamy od utworzenia bazy o nazwie *owoce*:
+
+    curl -X PUT http://127.0.0.1:5984/owoce/
+
+### Create
+
+Dodajemy kilka rekordów do bazy korzystając z programu *curl*:
+
+     curl -X PUT http://127.0.0.1:5984/owoce/1001 \
+       -d '{"item":"jabłko","price":{"biedronka":3.44,"tesco":2.12,"real":4.10}}'
+     curl -X PUT http://127.0.0.1:5984/owoce/1002 \
+       -d '{"item":"banan","price":{"biedronka":6.44,"tesco":1.12,"real":4.50}}'
+     curl -X PUT http://127.0.0.1:5984/owoce/1003 \
+       -d '{"item":"kiwi","price":{"biedronka":1.44,"tesco":1.12,"real":1.10}}'
+     curl -X PUT http://127.0.0.1:5984/owoce/1004 \
+       -d '{"item":"kumkwat"}'
+
+Dodawanie rekordów do bazy w ten sposób jest trochę męczące.
+[HTTP Bulk Document API](http://wiki.apache.org/couchdb/HTTP_Bulk_Document_API)
+ułatwia wprowadzanie (usuwanie, uaktualnianie – też) wielu rekordów do bazy:
+
+    curl -X POST -d @owoce.json http://127.0.0.1:5984/owoce/_bulk_docs
+
+gdzie plik *owoce.json* zawiera:
+
+    :::json
+    {
+      "docs": [
+         {"_id":"2001", "item":"gruszka", "price":{"tesco":5.00, "real":4.10}},
+         {"_id":"2002", "item":"wiśnia",  "price":{"tesco":3.14, "real":2.71}},
+         {"_id":"2003", "item":"morela",  "price":{"tesco":4.28, "real":4.10}}
+       ]
+     }
+
+Jaką funkcję spełniają liczby 1001, …, 1004, 2001, 2002, 2003.
+Czy można by było zamiast tych liczb użyć napisów: apple, banana, itd.?
+
+     curl -X PUT http://127.0.0.1:5984/owoce/orange -d '{"item":"pomarańcze"}'
+       => {"ok":true,"id":"orange","rev":"1-512c"}
+
+Pole **rev**. Do czego ono służy?
+
+
+### Delete
+
+Usuwamy ten dokument z bazy:
+
+    curl -X DELETE http://127.0.0.1:5984/owoce/orange?rev=1-2618
+      => {"ok":true,"id":"orange","rev":"1-123d"}
+
+
+### Get
+
+Pobieramy dokument z bazy *owoce*:
+
+    curl -X GET http://127.0.0.1:5984/owoce/1001
+      => { "_id":"1001",
+           "_rev":"1-627c94",
+           "item":"jab\u0142ko","price":{"biedronka":3.44,"tesco":2.12,"real":4.1}
+         }
+
+
+### Copy (tego nie ma w CRUD)
+
+Kopiujemy dokument z *_id = 1004*:
+
+    curl -X COPY http://127.0.0.1:5984/owoce/1004 -H "Destination: orange"
+      => {"id":"orange","rev":"1-46050e"}
+
+Do czego służy opcja `-H`? Wskazówka: skorzystać z opcji `-v` (ang. *verbose*).
+
+*Uwaga:* klucz **rev** wypisany powyżej jest przykładowy.
+
+
+### Update
+
+Uaktualniamy dokument *orange*:
+
+    curl -X PUT http://127.0.0.1:5984/owoce/orange \
+      -d '{"_rev":"1-46050e3","item":"orange"}'
+
+*Uwaga:* powyżej należy wpisać klucz **rev** wypisany przez polecenie *COPY*.
+
+
+## Wbudowane widoki
+
+Jaki widok? Tak naprawdę, to zadajemy zapytanie.
+
+Do pobrania wszystkich dokumentów z bazy *owoce* skorzystamy
+z wbudowanego widoku *_all_docs*:
+
+    curl -X GET http://127.0.0.1:5984/owoce/_all_docs
+      => {"total_rows":6,"offset":0,"rows":[
+         {"id":"1001","key":"1001","value":{"rev":"1-627c"}},
+         ...
+         {"id":"orange","key":"orange","value":{"rev":"2-9014"}},
+        ]}
+
+Można też zmienić kolejność pobieranych dokumentów:
+
+    curl -X GET http://127.0.0.1:5984/owoce/_all_docs?descending=true
+
+Można też pobrać kilka dokumentów, np. tylko jeden dokument:
+
+    curl -X GET http://127.0.0.1:5984/owoce/_all_docs?descending=true\&limit=1
+
+Można pobrać dokumenty z zawartością:
+
+    curl -X GET http://127.0.0.1:5984/owoce/_all_docs?include_docs=true
+
+I jeszcze kilka przykładów (bazę *collator* tworzymy za pomocą
+skryptu  {%= link_to "collseq.rb", "/doc/couchdb/collseq.rb" %}):
+
+    curl -X GET http://localhost:5984/collator/_all_docs?startkey=\"64\"\&limit=4
+    curl -X GET http://localhost:5984/collator/_all_docs?startkey=\"64\"\&limit=2\&descending=true
+    curl -X GET http://localhost:5984/collator/_all_docs?startkey=\"64\"\&endkey=\"68\"
+
+Skorzystamy jeszcze z jednego wbudowanego widoku:
+
+    curl -X GET http://127.0.0.1:5984/collator/_all_docs_by_seq
+
+(Został usunięty w ostatniej wersji CouchDB?)
+
+
+## Załączniki
+
+Dodajemy obrazek *kumkwat.jpg* do pierwszego rekordu z *_id=2001*:
+
+    curl -vX PUT http://127.0.0.1:5984/owoce/2001/kumkwat.jpg?rev=1-3854 \
+      -H "Content-Type: image/jpg" --data-binary @kumkwat.jpg
+
+Obrazek pobieramy tak:
+
+    curl -X GET http://127.0.0.1:5984/owoce/2001/kumkwat.jpg > k.jpg
+
+
+## Przykłady
+
+Pobieramy obrazek z bazy i wyświetlamy go na stronie:
+
+    :::html
+    <!DOCTYPE html>
+    <meta charset="utf-8" />
+    <title>Kumkwaty</title>
+    <p>
+      Kumkwaty są smaczne:
+      <img src="http://localhost:5984/owoce/2001/kumkwat.jpg">
+    </p>
+
+Zaczynamy od omówienia przykładu
+[jQuery.getJSON() – jQuery API](http://api.jquery.com/jQuery.getJSON/)
+
+Teraz drugi przykład korzystający z 
+CouchDB + jQuery + JSONP oraz owocowa baza danych:
+
+    :::html
+    <!DOCTYPE html>
+    <html>
+    <head>
+    <meta charset="utf-8">
+    <title>JSONP</title>
+    </head>
+    <body>
+
+      <h4 id="item"></h4>
+      <p id="price"></p>
+
+    <script src="http://ajax.googleapis.com/ajax/libs/jquery/1.4.1/jquery.min.js"></script>
+    <script>
+      $.getJSON('http://localhost:5984/owoce/2002', "callback=?", function(data){
+         $("#item").html(data.item);
+         $("#price").html("tesco: " + data.price["tesco"] + " real: " + data.price["real"]);
+         //console.log(data);
+      });
+    </script>
+
+    </body>
+    </html>
+
+Powyższy kod umieszczamy w pliku *owoce.html* a sam plik w katalogu
+*public_html* i sprawdzamy czy wszystko działa wchodząc na stronę:
+
+    http://localhost/~wbzyl/owoce.html
+
+Czy zadziała, jeśli plik *owoce.html* umieścimy na *Sigmie* 
+i wejdziemy na stronę:
+
+    http://sigma.ug.edu.pl/~wbzyl/owoce.html
+
+Dlaczego? A jeśli zmienimy URI przy `$.getJSON`?
+
+
+[couchdb]: http://books.couchdb.org/relax/ "CouchDB: The Definitive Guide"
+[couchdb wiki]: http://wiki.apache.org/couchdb/ "Couchdb Wiki"