по стопам webkill'а » ruby & ruby on rails http://blog.lukmus.ru это наш химический дом для печальных жителей Земли Sat, 21 Oct 2023 19:10:13 +0000 ru-RU hourly 1 http://wordpress.org/?v=3.4.2 backup с PGP шифрованием http://blog.lukmus.ru/2021/03/23/gpg-backup/ http://blog.lukmus.ru/2021/03/23/gpg-backup/#comments Tue, 23 Mar 2021 18:12:03 +0000 lukmus http://blog.lukmus.ru/?p=2685 В продолжение постов про GPG и о геме Backup собираю все в одну статью и дополняю настройкой для автоматического шифрования резервных копий.

утилита GPG

Установка, естественно, от пользователя с root-правами.
На RedHat’ах:

yum install pgp

На Debian’ах:

apt-get install pgp

Для создания ключей все та же команда, выполнять которую можно от рядового пользователя.

gpg --gen-key

Далее понадобится экспорт ключей в текстовый файл. В командах ниже username@email, разумеется, надо заменить на почту указанную при генерации.

Экспорт публичного ключа:

gpg --output public.pgp --armor --export username@email

Экспорт закрытого (приватного) ключа:

gpg --output private.pgp --armor --export-secret-key username@email

Если требуется, после экспорта ключей их можно удалить. Сначала удаляется закрытый ключ:

gpg --delete-secret-keys username@email

Затем открытый:

gpg --delete-keys username@email

Вывести список всех импортированных ключей:

gpg --list-keys

gem backup и PGP-ключ

Установка гема:

gem install backup

Cоздание модели (в данном примере модель называется ekzample) для бекапа:

backup generate:model --trigger ekzample
Generated model file: '~/Backup/models/ekzample.rb'.

Далее, для настройки нужного бекапа, следует отредактировать ~/Backup/models/ekzample.rb.

В примере ниже показан конфиг для резервного копирования базы MySQL с последующим сжатием в tar и шифрованием архива PGP-ключом, после чего зашифрованный файл отправляется по SFTP на бекап-сервер.

# encoding: utf-8
 
##
# Backup Generated: ekzample
# Once configured, you can run the backup with the following command:
#
# $ backup perform -t ekzample [-c <path_to_configuration_file>]
#
# For more information about Backup's components, see the documentation at:
# http://backup.github.io/backup
#
Model.new(:ekzample, 'Description for ekzample') do
 
  split_into_chunks_of 500
 
  Encryptor::GPG.defaults do |encryption|
    encryption.keys = {}
    encryption.keys['username@email'] = <<-KEY
      -----BEGIN PGP PUBLIC KEY BLOCK-----
      ...it is place for PUBLIC KEY...
      -----END PGP PUBLIC KEY BLOCK----
    KEY
    encryption.recipients = 'username@email'
  end
 
  database MySQL do |db|
    db.name  = 'exampledb'
    db.username = 'exampleuser'
    db.password = 'examplepass'
  end
 
  compress_with Gzip
  encrypt_with GPG
 
  store_with SFTP do |server|
    server.username = 'backupuser'
    server.password = 'backuppass'
    server.ip       = '111.111.111.111'
    server.port     = 22
    server.path     = '~/'
    # Use a number or a Time object to specify how many backups to keep.
    server.keep     = 150
 
    # Additional options for the SSH connection.
    # server.ssh_options = {}
  end
 
end

Не стоит забывать вставить между <<-KEY и KEY созданный ранее ПУБЛИЧНЫЙ (открытый) ключ.

Для более тонкой настройки PGP-ключей, например, разные ключи для разных баз, следует воспользоваться официальной документацией.

Запускается создание бекапа командой:

backup perform -t ekzample

извлечение бекапа

Если в системе нет ключей, используемых данным бекапом, следует их импортировать:

gpg --import private.pgp
gpg --import public.gpg

Далее чтобы расшифровать резервную копию понадобится команда:

gpg -o ekzample.tar -d ekzample.tar.gpg

Для распаковки тарбола подойдет команда:

tar -xvf ekzample.tar

]]> http://blog.lukmus.ru/2021/03/23/gpg-backup/feed/ 0 Mechanize через SOCKS5 или парсим Tor http://blog.lukmus.ru/2016/03/05/mechanize-socks/ http://blog.lukmus.ru/2016/03/05/mechanize-socks/#comments Sat, 05 Mar 2016 17:54:48 +0000 lukmus http://blog.lukmus.ru/?p=2400 Незаменимый для парсинга гем Mechanize, эмулирующий браузер, по умолчанию поддерживает только обычные прокси. Широкой общественности известен факт, что для подключения к Tor-сайтам используется SOCKS5, который организуется через Privoxy. Этот пост повествует как заставить Mechanize подключиться к Tor-сайтам.

Обычный запрос Mechanize’а через прокси имеет вид что-то типа:

1
2
3

browser = Mechanize.new
browser.agent.set_proxy(host,port)
page=browser.get 'http://lukmus.ru'

Жизнь была бы проще если бы мы могли заменить метод set_proxy класса Mechanize::HTTP::Agent на аналогичный set_socks, но такого метода в этом классе нет. Однако его можно дописать самому, например вот так:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35

require "socksify"
require 'socksify/http'
 
class Faraday::Adapter::NetHttp
  def net_http_class(env)
    if proxy = env[:request][:proxy]
      if proxy[:uri].scheme == 'socks'
        Net::HTTP::SOCKSProxy(proxy[:uri].host, proxy[:uri].port)
      else
        Net::HTTP::Proxy(proxy[:uri].host, proxy[:uri].port, proxy[:user], proxy[:password])
      end
    else
      Net::HTTP
    end
  end
end
 
class Mechanize::HTTP::Agent
 
  public
 
  def set_socks addr, port
    set_http unless @http
    class << @http
      attr_accessor :socks_addr, :socks_port
 
      def http_class
        Net::HTTP.SOCKSProxy(socks_addr, socks_port)
      end
    end
    @http.socks_addr = addr
    @http.socks_port = port
  end
 
end

Как подключать файлы, с содержанием подобному выше, к Rails-приложению каждый знает и без меня.

]]> http://blog.lukmus.ru/2016/03/05/mechanize-socks/feed/ 0 собственный способ отправки сообщений в ActionMailer http://blog.lukmus.ru/2014/08/22/add_delivery_method/ http://blog.lukmus.ru/2014/08/22/add_delivery_method/#comments Fri, 22 Aug 2014 03:03:39 +0000 lukmus http://blog.lukmus.ru/?p=2195 Не типичная ситуация, но вполне реальная. Заголовок не очень доходчиво объясняет то, что я тут изложу. Предположим, вы используете Devise и хотите заместо E-mail, которая по умолчанию является обязательным полем для пользователя, а также с помощью протокола SMTP которой происходит восстановление пароля и прочие фенечки, воспользоваться жаббером.

Короче говоря, после уточнений в офисе, ситуация такова: необходимо подменить способ отправки всех писем в Rails-приложений. Если обычно используется SMTP и сообщения являются обычными e-mail письмами, то тут будет рассматриваться случай когда письма являются сообщениями другого рода, например жаббер-сообщениями, а за место SMTP будет, соответственно, XMPP. Подменяться будут не какие-то отдельные сообщения в отдельно взятом экшене отдельного контроллера, а во всем приложении и сразу.

По началу я, будучи наивным юнцом, не знал, что в Rails предусмотрена возможность введения своего протокола отправки, и подумывал сделать так: с помощью mini-smtp-server, который бы я встроил в rake-фаил и на который бы настроил приложение, поднять SMTP-сервер, в котором уже и устроить подмену SMTP на нужный мне способ. Но судьба сложилась иначе и звезды указали мне путь на ActionMailer::Base.add_delivery_method.

Основу для данной инструкции я украл отсюда, однако от приведенной в посте инструкции ваша радость была бы неполной без горького шоколада “Россия”, т.к. досконально выполнив все что там сказано, можно наблюдать:

$ rails c
Loading development environment (Rails 4.0.0)
2.0.0p247 :001 > User.first.send_reset_password_instructions
  User Load (29.6ms)  SELECT `users`.* FROM `users` ORDER BY `users`.`id` ASC LIMIT 1
  User Load (74.5ms)  SELECT `users`.* FROM `users` WHERE `users`.`reset_password_token` = '59c1c232f95e7a96c4ac735b8fd899b5d993b07f7261a9551c68280ceb443577' LIMIT 1
   (0.2ms)  BEGIN
  SQL (101.3ms)  UPDATE `users` SET `reset_password_token` = '59c1c232f95e7a96c4ac735b8fd899b5d993b07f7261a9551c68280ceb443577', `reset_password_sent_at` = '2014-08-22 02:18:36', `updated_at` = '2014-08-22 02:18:36' WHERE `users`.`id` = 1
   (297.8ms)  COMMIT
ArgumentError: wrong number of arguments (1 for 0)
        from /usr/local/rvm/gems/ruby-2.0.0-p247/gems/mail-2.5.4/lib/mail/message.rb:257:in `initialize'
        from /usr/local/rvm/gems/ruby-2.0.0-p247/gems/mail-2.5.4/lib/mail/message.rb:257:in `new'
        from /usr/local/rvm/gems/ruby-2.0.0-p247/gems/mail-2.5.4/lib/mail/message.rb:257:in `delivery_method'
        from /usr/local/rvm/gems/ruby-2.0.0-p247/gems/actionmailer-4.0.0/lib/action_mailer/delivery_methods.rb:66:in `wrap_delivery_behavior'
        from /usr/local/rvm/gems/ruby-2.0.0-p247/gems/actionmailer-4.0.0/lib/action_mailer/delivery_methods.rb:80:in `wrap_delivery_behavior!'
        from /usr/local/rvm/gems/ruby-2.0.0-p247/gems/actionmailer-4.0.0/lib/action_mailer/base.rb:684:in `mail'
        from /usr/local/rvm/gems/ruby-2.0.0-p247/gems/devise-3.1.1/lib/devise/mailers/helpers.rb:16:in `devise_mail'
        from /usr/local/rvm/gems/ruby-2.0.0-p247/gems/devise-3.1.1/app/mailers/devise/mailer.rb:11:in `reset_password_instructions'
        from /usr/local/rvm/gems/ruby-2.0.0-p247/gems/actionpack-4.0.0/lib/abstract_controller/base.rb:189:in `process_action'
        from /usr/local/rvm/gems/ruby-2.0.0-p247/gems/actionpack-4.0.0/lib/abstract_controller/callbacks.rb:18:in `block in process_action'
        from /usr/local/rvm/gems/ruby-2.0.0-p247/gems/activesupport-4.0.0/lib/active_support/callbacks.rb:373:in `_run__3933474617966347476__process_action__callbacks'
        from /usr/local/rvm/gems/ruby-2.0.0-p247/gems/activesupport-4.0.0/lib/active_support/callbacks.rb:80:in `run_callbacks'
        from /usr/local/rvm/gems/ruby-2.0.0-p247/gems/actionpack-4.0.0/lib/abstract_controller/callbacks.rb:17:in `process_action'
        from /usr/local/rvm/gems/ruby-2.0.0-p247/gems/actionpack-4.0.0/lib/abstract_controller/base.rb:136:in `process'
        from /usr/local/rvm/gems/ruby-2.0.0-p247/gems/actionpack-4.0.0/lib/abstract_controller/rendering.rb:44:in `process'
        from /usr/local/rvm/gems/ruby-2.0.0-p247/gems/actionmailer-4.0.0/lib/action_mailer/base.rb:503:in `process'
        from /usr/local/rvm/gems/ruby-2.0.0-p247/gems/actionmailer-4.0.0/lib/action_mailer/base.rb:497:in `initialize'
        from /usr/local/rvm/gems/ruby-2.0.0-p247/gems/actionmailer-4.0.0/lib/action_mailer/base.rb:480:in `new'
        from /usr/local/rvm/gems/ruby-2.0.0-p247/gems/actionmailer-4.0.0/lib/action_mailer/base.rb:480:in `method_missing'
        from /usr/local/rvm/gems/ruby-2.0.0-p247/gems/devise-3.1.1/lib/devise/models/authenticatable.rb:175:in `send_devise_notification'
        from /usr/local/rvm/gems/ruby-2.0.0-p247/gems/devise-3.1.1/lib/devise/models/recoverable.rb:54:in `send_reset_password_instructions'
        from (irb):1
        from /usr/local/rvm/gems/ruby-2.0.0-p247/gems/railties-4.0.0/lib/rails/commands/console.rb:90:in `start'
        from /usr/local/rvm/gems/ruby-2.0.0-p247/gems/railties-4.0.0/lib/rails/commands/console.rb:9:in `start'
        from /usr/local/rvm/gems/ruby-2.0.0-p247/gems/railties-4.0.0/lib/rails/commands.rb:64:in `<top (required)>'
        from bin/rails:4:in `require'
        from bin/rails:4:in `<main>'2.0.0p247 :002 >

Поэтому я перескажу все от начала и до конца с учетом поправки косяка, который не заметил Arun Kumar Singh (так зовут перца, который ведет этот codedecoder.wordpress.com), при этом мой новый способ отправки будет XMPP.

свой класс со способом отправки

Создаем файл lib/xmpp_delivery.rb с классом, который будет содержать новый способ доставки.

class XMPPDelivery
 
  def initialize(opts={})
    @settings=opts
  end
 
  def deliver!(message)
      #тут как бы горы кода по отправки сообщений в жабу
      if xmpp.deliver!(@settings)
        p message
        true
      else false end
  end
 
end

Ошибка Codedecoder’а исправляется уже на этом этапе – он забыл копипастнуть в листинг приведенного им модуля, метод initialize с одним обязательным параметром, который указывается в /usr/local/rvm/gems/ruby-2.0.0-p247/gems/mail-2.5.4/lib/mail/message.rb:257.

подключение нового класса

Далее в config/environment.rb необходимо подключить созданный файл:

# Load the Rails application.
require File.expand_path('../application', __FILE__)
 
require 'xmpp_delivery.rb'
 
# Initialize the Rails application.
PsakiSpeechCreator::Application.initialize!

объявление нового способа

Теперь надо добавить инициатор config/initializers/mailer.rb, в котором будет торжественно объявляться новый способ:

ActionMailer::Base.add_delivery_method :xmpp, XMPPDelivery

настройка на новый способ

И в конце, в настройках нужной среды (например в config/environments/development.rb), указать способ как основной:

...
  config.action_mailer.default_url_options = { :host => 'localhost'}
  config.action_mailer.delivery_method = :xmpp
...

А если кому-то серьезно надоел e-mail в Devise и он хочет сделать отправку в жабу, то вам пригодится гем xmpp4r-simple, ошибки которого были замечены тут и тут.

]]> http://blog.lukmus.ru/2014/08/22/add_delivery_method/feed/ 0 Backup на Яндекс.Диск http://blog.lukmus.ru/2014/01/10/backup-na-yandeks-disk/ http://blog.lukmus.ru/2014/01/10/backup-na-yandeks-disk/#comments Fri, 10 Jan 2014 01:54:06 +0000 lukmus http://blog.lukmus.ru/?p=2134 Для того чтобы сливать бэкапы на сторонний сервер или в локальную директорию уже давным давно можно не писать самопальные скрипты, а воспользоваться гемом Backup. И то, что это гем и написан он на Ruby, совершенно не означает, что организовывать бэкапы он может только для Ruby.

Backup много чего умеет делать, работает с двумя вагонами СУБД (MySQL, PostgreSQL, MongoDB итд), может закачивать сами бэкапы на триллионы различных площадок (Dropbox, CloudFiles, S3 итд) используя килотонны всевозможных протоколов (SFTP, FTP, SCP итд), подробнее об этом давно уже расписано на Хабре. Одна беда у гема: он не поддерживает протокол WebDAV и площадку Яндекс.Диск. Ну, а почему собственно необходим Яндекс.Диск и чем он лучше всех остальных можно узнать перейдя по моей партнерской ссылке (новый шедевр скрытой рекламы).

установка backup

Тут ничего нового, все тоже самое, что и в официальной инструкции.
Сама установка:

# gem install backup

Генерация конфига:

$ backup generate:model --trigger my_backup
Generated model file: '~/Backup/models/my_backup.rb'.

В результате этих манипуляций возникнет директория ~/Backup с какой-то лабудой в ~/Backup/config.rb и собственно с конфигом одной из задач в ~/Backup/models/my_backup.rb.

интерфейс для Яндекс.Диска

Управлять ЯДом можно как через API, так и напрямую через WebDAV. Для взаимодействия по WebDAV есть отдельные специальные гемы, но нормально закачать что-нибудь вряд ли удастся т.к. для авторизации по WebDAV придется использовать пару логин:пароль, в то время как ЯД позволяет загружать только при авторизации по ключу приложения, насколько я понял.

К счастью существует гем yandex-disk, через который и будут заливаться бэкапы.

После установки гема:

# gem install yandex-disk

чтобы иметь права не только на чтение, необходимо получить токен от Яндекса. Для этого надо:

  1. авторизоваться в Яндексе
  2. выбрать имеющееся приложение или создать новое
  3. получить токен пройдя по ссылке: https://oauth.yandex.ru/authorize?response_type=token&client_id=YOUR_APP_ID

настройка backup под Яндекс.Диск

Удивительно, но на странице гема yandex-disk в самом низу приведен конфиг модели под backup, лично для себя, я приведу указанную конфигурацию к mysql-евскому виду:

# encoding: utf-8
 
##
# Backup Generated: my_backup
# Once configured, you can run the backup with the following command:
#
# $ backup perform -t my_backup [-c ]
#
 
require 'yandex/disk/backup/storage'
 
Backup::Model.new(:my_backup, 'My backup DB to Yandex.Disk') do
  ##
  # Split [Splitter]
  #
  # Split the backup file in to chunks of 250 megabytes
  # if the backup file size exceeds 250 megabytes
  #
  split_into_chunks_of 500
 
  database MySQL do |db|
    db.name  = 'mydb'
    db.username = 'myuser'
    db.password = 'mypass'
  end
 
  compress_with Gzip
 
  store_with Yandex::Disk do |disk|
    disk.access_token = 'mysupersecretyandexapptoken'
    disk.path         = '/backups/'
    disk.keep = 5
  end
end

запуск

И вот казалось бы все готово, осталось только запустить backup:

$ backup perform -t my_backup
[2014/01/08 18:53:04][info] Performing Backup for 'My backup DB to Yandex.Disk (my_backup)'!
[2014/01/08 18:53:04][info] [ backup 3.4.0 : ruby 2.0.0p247 (2013-06-27 revision 41674) [x86_64-linux] ]
[2014/01/08 18:53:04][info] Database::MySQL Started...
[2014/01/08 18:53:04][info] Using Compressor::Gzip for compression.
[2014/01/08 18:53:04][info]   Command: '/bin/gzip'
[2014/01/08 18:53:04][info]   Ext: '.gz'
[2014/01/08 18:53:06][info] Database::MySQL Finished!
[2014/01/08 18:53:06][info] Packaging the backup files...
[2014/01/08 18:53:06][info] Splitter configured with a chunk size of 500MB.
[2014/01/08 18:53:06][info] Packaging Complete!
[2014/01/08 18:53:06][info] Cleaning up the temporary files...
[2014/01/08 18:53:06][info] Yandex::Disk Started...
[2014/01/08 18:53:06][error] ModelError: Backup for Backup OA DB to Yandex.Disk (oabackup) Failed!
[2014/01/08 18:53:06][error]   An Error occured which has caused this Backup to abort before completion.
[2014/01/08 18:53:06][error]   Reason: NoMethodError
[2014/01/08 18:53:06][error]   undefined method `present?' for "mysupersecretyandexapptoken":String
[2014/01/08 18:53:06][error] 
[2014/01/08 18:53:06][error] Backtrace:
[2014/01/08 18:53:06][error]   /usr/local/rvm/gems/ruby-2.0.0-p247/gems/yandex-disk-0.0.5/lib/yandex/disk/client.rb:17:in `block in initialize'
[2014/01/08 18:53:06][error]   /usr/local/rvm/gems/ruby-2.0.0-p247/gems/faraday-0.8.8/lib/faraday/connection.rb:65:in `initialize'
[2014/01/08 18:53:06][error]   /usr/local/rvm/gems/ruby-2.0.0-p247/gems/faraday-0.8.8/lib/faraday.rb:11:in `new'
[2014/01/08 18:53:06][error]   /usr/local/rvm/gems/ruby-2.0.0-p247/gems/faraday-0.8.8/lib/faraday.rb:11:in `new'
[2014/01/08 18:53:06][error]   /usr/local/rvm/gems/ruby-2.0.0-p247/gems/yandex-disk-0.0.5/lib/yandex/disk/client.rb:16:in `initialize'
[2014/01/08 18:53:06][error]   /usr/local/rvm/gems/ruby-2.0.0-p247/gems/yandex-disk-0.0.5/lib/yandex/disk/backup/storage.rb:18:in `new'
[2014/01/08 18:53:06][error]   /usr/local/rvm/gems/ruby-2.0.0-p247/gems/yandex-disk-0.0.5/lib/yandex/disk/backup/storage.rb:18:in `connection'
[2014/01/08 18:53:06][error]   /usr/local/rvm/gems/ruby-2.0.0-p247/gems/yandex-disk-0.0.5/lib/yandex/disk/backup/storage.rb:22:in `transfer!'
[2014/01/08 18:53:06][error]   /usr/local/rvm/gems/ruby-2.0.0-p247/gems/backup-3.4.0/lib/backup/storage/base.rb:34:in `perform!'
[2014/01/08 18:53:06][error]   /usr/local/rvm/gems/ruby-2.0.0-p247/gems/backup-3.4.0/lib/backup/model.rb:242:in `each'
[2014/01/08 18:53:06][error]   /usr/local/rvm/gems/ruby-2.0.0-p247/gems/backup-3.4.0/lib/backup/model.rb:242:in `block in perform!'
[2014/01/08 18:53:06][error]   /usr/local/rvm/gems/ruby-2.0.0-p247/gems/backup-3.4.0/lib/backup/model.rb:240:in `each'
[2014/01/08 18:53:06][error]   /usr/local/rvm/gems/ruby-2.0.0-p247/gems/backup-3.4.0/lib/backup/model.rb:240:in `perform!'
[2014/01/08 18:53:06][error]   /usr/local/rvm/gems/ruby-2.0.0-p247/gems/backup-3.4.0/lib/backup/cli.rb:163:in `block in perform'
[2014/01/08 18:53:06][error]   /usr/local/rvm/gems/ruby-2.0.0-p247/gems/backup-3.4.0/lib/backup/cli.rb:162:in `each'
[2014/01/08 18:53:06][error]   /usr/local/rvm/gems/ruby-2.0.0-p247/gems/backup-3.4.0/lib/backup/cli.rb:162:in `perform'
[2014/01/08 18:53:06][error]   /usr/local/rvm/gems/ruby-2.0.0-p247/gems/thor-0.18.1/lib/thor/command.rb:27:in `run'
[2014/01/08 18:53:06][error]   /usr/local/rvm/gems/ruby-2.0.0-p247/gems/thor-0.18.1/lib/thor/invocation.rb:120:in `invoke_command'
[2014/01/08 18:53:06][error]   /usr/local/rvm/gems/ruby-2.0.0-p247/gems/thor-0.18.1/lib/thor.rb:363:in `dispatch'
[2014/01/08 18:53:06][error]   /usr/local/rvm/gems/ruby-2.0.0-p247/gems/thor-0.18.1/lib/thor/base.rb:439:in `start'
[2014/01/08 18:53:06][error]   /usr/local/rvm/gems/ruby-2.0.0-p247/gems/backup-3.4.0/bin/backup:5:in `<top (required)>'
[2014/01/08 18:53:06][error]   /usr/local/rvm/gems/ruby-2.0.0-p247/bin/backup:23:in `load'
[2014/01/08 18:53:06][error]   /usr/local/rvm/gems/ruby-2.0.0-p247/bin/backup:23:in `<main>'
[2014/01/08 18:53:06][error]   /usr/local/rvm/gems/ruby-2.0.0-p247/bin/ruby_executable_hooks:15:in `eval'
[2014/01/08 18:53:06][error]   /usr/local/rvm/gems/ruby-2.0.0-p247/bin/ruby_executable_hooks:15:in `<main>'
[2014/01/08 18:53:06][warn] CleanerError: Cleanup Warning
[2014/01/08 18:53:06][warn]   The temporary backup folder '~/Backup/.tmp'
[2014/01/08 18:53:06][warn]   appears to contain the backup files which were to be stored:
[2014/01/08 18:53:06][warn]  ~/Backup/.tmp/my_backup.tar
[2014/01/08 18:53:06][warn]   
[2014/01/08 18:53:06][warn]   Make sure you check these files before the next scheduled backup for
[2014/01/08 18:53:06][warn]   'My backup DB to Yandex.Disk (my_backup)'
[2014/01/08 18:53:06][warn]   These files will be removed at that time!
[2014/01/08 18:53:06][info] ModelError: If you have other Backup jobs (triggers) configured to run,
[2014/01/08 18:53:06][info]   Backup will now attempt to continue...

И, как уже догадался проницательный читатель, бэкап не залился на ЯД, но не стоит расстраиваться. Пристально и с презрением посмотрите на строки:

[2014/01/08 18:53:06][error]   undefined method `present?' for "mysupersecretyandexapptoken":String
[2014/01/08 18:53:06][error] 
[2014/01/08 18:53:06][error] Backtrace:
[2014/01/08 18:53:06][error]   /usr/local/rvm/gems/ruby-2.0.0-p247/gems/yandex-disk-0.0.5/lib/yandex/disk/client.rb:17:in `block in initialize'

и откройте файл /usr/local/rvm/gems/ruby-2.0.0-p247/gems/yandex-disk-0.0.5/lib/yandex/disk/client.rb:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33

# coding: utf-8
 
require 'base64'
require 'faraday'
require 'faraday_middleware'
 
Faraday::Connection::METHODS << :propfind
 
module Yandex
  module Disk
    class Client
      autoload :Request, 'yandex/disk/client/request'
 
      def initialize options={}
        @timeout = options[:timeout] || 300
        @http = Faraday.new(:url => 'https://webdav.yandex.ru') do |builder|
          if options[:access_token].present?
            builder.request :authorization, "OAuth", options[:access_token]
          else
            basic_token = Base64.encode64("#{options[:login]}:#{options[:password]}")
            builder.request :authorization, "Basic", basic_token
          end
 
          builder.response :follow_redirects
 
          if faraday_configurator = options[:faraday_configurator]
            faraday_configurator.call(builder)
          else
            builder.adapter :excon
          end
        end
      end
...

По неизвестным науке обстоятельствам ошибка возникает при вызове метода present? для String-элемента в хэше. Наивный читатель может предложить заменить

if options[:access_token].present?

на

unless options[:access_token].blank?

но спешу заметить, что такая рокировка вызовет аналогичную ошибку, поэтому в данном случае я предлагаю строку №17 привести к виду:

16
17
18

        @http = Faraday.new(:url => 'https://webdav.yandex.ru') do |builder|
          if options[:access_token]
            builder.request :authorization, "OAuth", options[:access_token]

После такой магии у меня все запустилось:

$ backup perform -t my_backup
[2014/01/08 19:09:03][info] Performing Backup for 'My backup DB to Yandex.Disk (my_backup)'!
[2014/01/08 19:09:03][info] [ backup 3.4.0 : ruby 2.0.0p247 (2013-06-27 revision 41674) [x86_64-linux] ]
[2014/01/08 19:09:04][warn] CleanerError: Cleanup Warning
[2014/01/08 19:09:04][warn]   The temporary backup folder '~/Backup/.tmp'
[2014/01/08 19:09:04][warn]   appears to contain the package files from the previous backup!
[2014/01/08 19:09:04][warn]   ~/Backup/.tmp/my_backup.tar
[2014/01/08 19:09:04][warn]   These files will now be removed.
[2014/01/08 19:09:04][warn]   
[2014/01/08 19:09:04][warn]   Please check the log for messages and/or your notifications
[2014/01/08 19:09:04][warn]   concerning this backup: 'My backup DB to Yandex.Disk (my_backup)'
[2014/01/08 19:09:04][warn]   The temporary files which had to be removed should not have existed.
[2014/01/08 19:09:04][info] Database::MySQL Started...
[2014/01/08 19:09:04][info] Using Compressor::Gzip for compression.
[2014/01/08 19:09:04][info]   Command: '/bin/gzip'
[2014/01/08 19:09:04][info]   Ext: '.gz'
[2014/01/08 19:09:10][info] Database::MySQL Finished!
[2014/01/08 19:09:10][info] Packaging the backup files...
[2014/01/08 19:09:10][info] Splitter configured with a chunk size of 500MB.
[2014/01/08 19:09:10][info] Packaging Complete!
[2014/01/08 19:09:10][info] Cleaning up the temporary files...
[2014/01/08 19:09:10][info] Yandex::Disk Started...
[2014/01/08 19:09:12][info] Storing '/backups/my_backup/2014.01.08.19.09.03/my_backup.tar'...
[2014/01/08 19:10:13][info] Cycling Started...
[2014/01/08 19:10:13][info] Yandex::Disk Finished!
[2014/01/08 19:10:13][info] Cleaning up the package files...
[2014/01/08 19:10:13][warn] Backup for 'My backup DB to Yandex.Disk (my_backup)' Completed Successfully (with Warnings) in 00:01:10

]]> http://blog.lukmus.ru/2014/01/10/backup-na-yandeks-disk/feed/ 2 установка ruby 2.0, rails 4, nginx+passenger http://blog.lukmus.ru/2013/10/05/ustanovka-ruby-2-0-rails-4-nginxpassenger/ http://blog.lukmus.ru/2013/10/05/ustanovka-ruby-2-0-rails-4-nginxpassenger/#comments Sat, 05 Oct 2013 10:33:56 +0000 lukmus http://blog.lukmus.ru/?p=2105 Установка Ruby 2.0 через RVM и Rails4+Passenger+Nginx практически ни чем не отличается от аналогичной ситуацией с Rails 3, однако я опишу весь процесс просто для того, чтобы каждый раз не искать новый сайт RVM.

установка ruby 2.0

Тут будет все практически тоже самое, что и для Ruby 1.9 и Rails 3, измениться практически только команда установки самой RVM.

Итак, для начала надо установить Git.

# yum install git -y

Далее надо установить RVM, как написано на офсайте делаем:

# \curl -L https://get.rvm.io | bash -s stable

Теперь надо выйти из консоли и зайти обратно, после чего можно установить непосредственно сам Ruby 2.0:

# rvm -v
 
rvm 1.22.16 (stable) by Wayne E. Seguin <wayneeseguin@gmail.com>, Michal Papis <mpapis@gmail.com> [https://rvm.io/]
 
# rvm install 2.0

Когда Ruby 2.0 установлен, если необходимо можно поставить его используемым по умолчанию.

# rvm use 2.0 --default
Using /usr/local/rvm/gems/ruby-2.0.0-p247
# ruby -v
ruby 2.0.0p247 (2013-06-27 revision 41674) [i686-linux]

установка rails 4

Надо просто установить соответствующий gem.

# gem install rails
# rails -v
Rails 4.0.0

установка nginx+passenger

Установка Nginx+Passenger для Rails 4, точно такая же как и для Rails 3.

# gem install passenger
# passenger-install-nginx-module

Теперь осталось воспользоваться предоставленными Passenger’ом настройками и правильно сконфигурировать конфиг Nginx /opt/nginx/conf/nginx.conf.

p.s. честно говоря, этот пост написан по двум причинам: давно не писал и хотелось бы забить ключевик установка rails 4.

]]> http://blog.lukmus.ru/2013/10/05/ustanovka-ruby-2-0-rails-4-nginxpassenger/feed/ 5 страничное кэширование мультидоменного сайта на Rails 3+Nginx http://blog.lukmus.ru/2013/03/07/stranichnoe-keshirovanie-multidomenn/ http://blog.lukmus.ru/2013/03/07/stranichnoe-keshirovanie-multidomenn/#comments Thu, 07 Mar 2013 14:46:48 +0000 lukmus http://blog.lukmus.ru/?p=1902 «Наиболее эффективными считаются те запросы, которые никогда не выдаются», ― говорит Сэм Руби. Страничное кэширование с этой точки зрения не максимально эффективно, но близко к максимуму т.к. страница загруженная полностью из кэша не делает ни одного запроса к БД. Однако, в случае если сайт имеет поддомены, например, для определения локали (en.site.com, ru.site.com), кэш страницы в одной локале будет затираться кэшом в другой. В этой статье мой опыт борьбы с этой проблемой.

Если загуглить решение этой проблемы, то одно из первых, что выскакивает это статья Ryan Stout «Page Caching by Subdomain in Rails and Nginx». Собственно, по ней я и пытался кэшировать на поддоменах, но не все так гладко как там описано. Поэтому я кое-что добавил от себя, а кое-что изменил.

ApplicationController

Прежде всего, как и описано в статье надо добавить кое-что в ApplicationController, но тут помимо указанного у Ryan’а метода cache_page надо будет еще перегрузить expire_page иначе обновить кэш из под рельс можно будет только на велосипеде.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38

class ApplicationController < ActionController::Base
...
  def cache_page(content = nil, options = nil)
    path = "/#{request.host}/"
    path << case options
    when Hash
      url_for(options.merge(:only_path => true, :skip_relative_url_root => true, :format => params[:format]))
    when String
      options
    else
      if request.path.empty? || request.path == '/'
        '/index'
      else
        request.path
      end
    end
    super(content, path)
  end
 
  def expire_page(options = {})
    path = "/#{request.host}/"
    params[:format]=:html if options[:format]
    path << case options
    when Hash
      url_for(options.merge(:only_path => true, :format => params[:format]))
    when String
      options
    else
      if request.path.empty? || request.path == '/'
        '/index'
      else
        request.path
      end
    end
    self.class.expire_page(path)
  end
...
end

настройка самого rails-приложения

Согласно статье, кэш будет храниться в директории public/cache. Чтобы так и было нужно, во-первых, создать папку cache в public, а, во-вторых, сообщить о пути кэша самому приложению. Для этого можно, например, в config/environments/production.rb дописать:

MyApp::Application.configure do
...
  config.action_controller.page_cache_directory = Rails.root.join("public/cache")
end

nginx

В настройке сайта в nginx.conf нужно указать, что и в оригинальной статье:

# If the file exists in the public folder, send it
if (-f $request_filename) {
  break;	  
}
 
# Check / files with index.html
if (-f $document_root/cache/$host/$uri/index.html) {
  rewrite (.*) /cache/$host/$1/index.html break;
}
 
# Check the path + .html
if (-f $document_root/cache/$host/$uri.html) {
  rewrite (.*) /cache/$host/$1.html break;
}
 
# Check directly
if (-f $document_root/cache/$host/$uri) {
  rewrite (.*) /cache/$host/$1 break;
}

Добавление этих условников говорит Nginx’у куда записывать кэш если его нет и откуда его читать если для данного адреса есть кэш. Вот тут и возникает проблема, Nginx не будет различать это GET-запрос или POST. И если в случае с GET, все хорошо, то когда поступает PUT-запрос на обновление модели (экшены update и show имеют один и тот же URL по умолчанию) Nginx с радостью обнаружит закэшированную страницу и выдаст ошибку 505.
Язык конфигурации Nginx не поддерживает вложенные условники и не понимает конъюнкцию (&& или AND или еще как угодно), все, что остается это строить велосипед что-то типа:

if ( $request_method = GET ) {
  set $method_and_file "method";
}
 
if (-f $request_filename) {
  set $method_and_file $method_and_file+"&file";
}
 
if ($method_and_file = "method&file") {
  break;
}

Но эти костыли у меня не завелись с первого раза и я забил на эти грязные мысли.

как же тогда обновить кэш?

Для обновления кэша я предлагаю такой, на мой взгляд, не самый кровавый вариант. Надо делать форму модели AJAX-вую и в вызове expire_cache явно указывать формат кэша.

пример на модели Page

app/controllers/pages_controller.rb:

class PagesController < ApplicationController
...
  caches_page :show
  caches_page :index
...
  def update
    respond_to do |format|
      if @page.update_attributes(params[:page])
        expire_page({action: :show, id: @page.id, format: :html})
        expire_page({action: :index, format: :html})
        format.html { redirect_to @page, notice: 'Page was successfully updated.' }
        format.js
      else
        format.html { render action: "edit" }
        format.js
        #format.json { render json: @page.errors, status: :unprocessable_entity }
      end
    end
  end
...
end

/app/views/pages/update.js:

setTimeout( 'window.location.replace("<%=page_path(@page)%>")', 1500);

/app/views/pages/_form.html.erb:

<%= form_for(@page, remote: true, format: :js) do |f|%>
...
<%end%>

]]> http://blog.lukmus.ru/2013/03/07/stranichnoe-keshirovanie-multidomenn/feed/ 0 хлебные крошки на rails. breadcrumbs_on_rails http://blog.lukmus.ru/2013/02/05/hlebnyie-kroshki-na-rails-breadcrumbs_on_rails/ http://blog.lukmus.ru/2013/02/05/hlebnyie-kroshki-na-rails-breadcrumbs_on_rails/#comments Tue, 05 Feb 2013 22:41:19 +0000 lukmus http://blog.lukmus.ru/?p=1889 Хлебные крошки для RoR-приложения уже давно не нужно писать самому. Уже не менее 2-х лет существует как минимум один gem для быстрой реализации хлебных крошек ― breadcrumbs_on_rails. Ниже я только опишу свой опыт работы с этим гемом, который мало чем отличается от описанного на офстранице breadcrumbs_on_rails.

установка

В Gemfile добавляем:

gem "breadcrumbs_on_rails"

и бандлим:

$ su -c 'bundle install'

эксплуатация

Для отображения ‘хлебных крошек’ в нужное представление необходимо вставить хелпер:

<%= render_breadcrumbs %>

Хелпер может принимать параметр separator:

<body>
  <%= render_breadcrumbs :separator => ' / ' %>
</body>

В контроллере для определения текста и ссылки ‘хлебной крошки’ используется метод add_breadcrumb:

add_breadcrumb <анкор>, <путь>, [<необязательный хэш с параметрами ссылки>]

Путь может представлять из себя как чистый ‘путевой’ хелпер, так и символ ‘путевого’ хелпера.

class MyController
 
  add_breadcrumb "home", :root_path
  add_breadcrumb "my", :my_path
 
  def index
    add_breadcrumb "index", index_path, :title => "Back to the Index"
  end
 
end

]]> http://blog.lukmus.ru/2013/02/05/hlebnyie-kroshki-na-rails-breadcrumbs_on_rails/feed/ 0 нейронные сети на ruby http://blog.lukmus.ru/2013/01/21/neyronnyie-seti-na-ruby/ http://blog.lukmus.ru/2013/01/21/neyronnyie-seti-na-ruby/#comments Mon, 21 Jan 2013 22:31:28 +0000 lukmus http://blog.lukmus.ru/?p=1774 Недавно я узнал о том, что больше не надо заморачиваться и писать всю логику работы нейросетки. Собственно говоря, это уже давно можно было не делать благодаря существованию такой библиотеки на C как Fast Artificial Neural Network. А спустя считанные минуты я с удивлением обнаружил, что FANN уже давно портатированна на различные языки более высокого уровня, включая PHP, Python и, конечно, апогей человеческого гения – Ruby.
Касперский пиарится на Красном Октябре
Для Ruby интерфейс к FANN обеспечивает гем ruby-fann.

установка

Для установки его под рельсы надо закинуть в Gemfile

gem 'ruby-fann'

и забандлить

bundle install

установка graphviz

Еще для отображения графической схемы нейронной сети можно воспользоваться graphviz. Эта штука вроде как должна экспортировать графическую схему сетки в PNG или VRML.

yum install graphviz
gem install ruby-graphviz

эксплуатация

У гема есть подробная документация.
В качестве примера я не буду дублировать код на сайте гема, а приведу нейросеть для решения классической задачи с XOR, только с большим количеством нейронов.

Код упакован в rake-файл рельс.

namespace :test do
  desc 'test NN'
  task :nn => :environment do
 
    require 'ruby_fann/neural_network'
    require 'ruby_fann/neurotica' #только для graphviz
 
    #объявляется ИНС
    fann = RubyFann::Standard.new(
	:num_inputs=>2, #входы
	#кол-во нейронов на первом и 
        #втором уровнях соответственно
	:hidden_neurons=>[3, 2], 
	:num_outputs=>1 #выходы
    )
 
    #обучение
    pairs=[[0,0],[1,0],[0,1],[1,1]] #учебные данные
    training_data = RubyFann::TrainData.new(
  	:inputs=>pairs, 
  	#правильные результаты в соответствии с учебными данными
  	:desired_outputs=>[[0],[1],[1],[0]] 
    )
 
    #собственно само обучение
    fann.train_on_data(
	training_data, #данные для обучения
	1000, #макс. кол-во эпох
	1, #кол-во эпох спустя которые выводить рез-тат
	0.01 #допустимая погрешность
    )
 
    #проверка обученности сети
    pairs.each do |pair|
	puts "#{pair}: #{fann.run(pair)}"
    end
 
    #вывод полученных нейронов
    fann.get_neurons.each {|n| p n}
 
    #вывод графической схемы
    graph=RubyFann::Neurotica.new()
    graph.graph(fann, 'xor_nn.png')
  end
end
$ bundle exec rake test:nn
Max epochs     1000. Desired error: 0.0099999998.
Epochs            1. Current error: 0.2501267791. Bit fail 4.
Epochs            2. Current error: 0.2520069778. Bit fail 4.
Epochs            3. Current error: 0.2551138699. Bit fail 4.
Epochs            4. Current error: 0.2513942719. Bit fail 4.
Epochs            5. Current error: 0.2500072420. Bit fail 4.
...
Epochs          370. Current error: 0.0440760627. Bit fail 1.
Epochs          371. Current error: 0.0343447179. Bit fail 0.
Epochs          372. Current error: 0.0233961642. Bit fail 0.
Epochs          373. Current error: 0.0175627228. Bit fail 0.
Epochs          374. Current error: 0.0113563286. Bit fail 0.
Epochs          375. Current error: 0.0067548323. Bit fail 0.
[0, 0]: [0.045396712927026114]
[1, 0]: [0.9389753126711914]
[0, 1]: [0.9501094945639519]
[1, 1]: [0.061412697926247546]
{:activation_function=>:linear, :activation_steepness=>0.0, :layer=>0, :sum=>0.0, :value=>1.0, :connections=>[]}
{:activation_function=>:linear, :activation_steepness=>0.0, :layer=>0, :sum=>0.0, :value=>1.0, :connections=>[]}
{:activation_function=>:sigmoid_stepwise, :activation_steepness=>0.5, :layer=>1, :sum=>1.3608390766086655, :value=>0.9258633161869951, :connections=>[0, 1, 2]}
{:activation_function=>:sigmoid_stepwise, :activation_steepness=>0.5, :layer=>1, :sum=>5.5199047483640955, :value=>1.0, :connections=>[0, 1, 2]}
{:activation_function=>:sigmoid_stepwise, :activation_steepness=>0.5, :layer=>1, :sum=>1.7510475747029322, :value=>0.9606836699618748, :connections=>[0, 1, 2]}
{:activation_function=>:sigmoid_stepwise, :activation_steepness=>0.5, :layer=>2, :sum=>-2.005618142945213, :value=>0.029562103469001694, :connections=>[3, 4, 5, 6]}
{:activation_function=>:sigmoid_stepwise, :activation_steepness=>0.5, :layer=>2, :sum=>-2.3070915806646646, :value=>0.018010737799533, :connections=>[3, 4, 5, 6]}
{:activation_function=>:sigmoid_stepwise, :activation_steepness=>0.5, :layer=>3, :sum=>-1.4195548161431304, :value=>0.061412697926247546, :connections=>[7, 8, 9]}
rake aborted!
graph attribute 'output' invalid
/usr/local/rvm/gems/ruby-1.9.2-p290/gems/ruby-graphviz-1.0.8/lib/graphviz/attrs.rb:53:in `[]='
/usr/local/rvm/gems/ruby-1.9.2-p290/gems/ruby-graphviz-1.0.8/lib/graphviz.rb:378:in `[]='
/usr/local/rvm/gems/ruby-1.9.2-p290/gems/ruby-graphviz-1.0.8/lib/graphviz.rb:901:in `block in initialize'
/usr/local/rvm/gems/ruby-1.9.2-p290/gems/ruby-graphviz-1.0.8/lib/graphviz.rb:878:in `each'
/usr/local/rvm/gems/ruby-1.9.2-p290/gems/ruby-graphviz-1.0.8/lib/graphviz.rb:878:in `initialize'
/usr/local/rvm/gems/ruby-1.9.2-p290/gems/ruby-fann-1.1.3/lib/ruby_fann/neurotica.rb:37:in `new'
/usr/local/rvm/gems/ruby-1.9.2-p290/gems/ruby-fann-1.1.3/lib/ruby_fann/neurotica.rb:37:in `graph'
/home/username/ror/nn/lib/tasks/test.rake:42:in `block (2 levels) in <top (required)>'
Tasks: TOP => test:nn
(See full trace by running task with --trace)

Как видно по ошибке в конце вывода, удалось все кроме создания PNG-файла. Но т.к. graphviz далеко не самый важный и нужный элемент, то и Бог с ним.
Описываемое далее выходит за рамки темы объявленной в заголовке, однако, чтобы не забыть я напишу.

определение количества нейронов

Теоретически, именно теоретически, количество нейронов определяется по формуле из следствия теорем Арнольда – Колмогорова – Хехт-Нильсена:

Ny — количество выходов;
Q — количество обучающих примеров;
Nw — необходимое число синаптических связей;
Nx — количество входов.
Из этого неравенства следует, что количество нейронов для сети с одним скрытым слоем определяется:

Если нарисовать схему нейросети с более чем одним скрытым слоем, то становится очевидным равенство:

l — количество слоев;
Ni — количество нейронов в i-м слое.
Если же в каждом скрытом слое подразумевается одно и тоже количество нейронов, то тождество преобретает вид:

Решив квадратное уравнение относительно N и отбросив заведомо отрицательный корень, получаем, что количество нейронов в каждом скрытом слое определяется по формуле:

На этом с математикой пока все. Все что идет после следствия из теорем выводилось мной, поэтому возможна ошибка.

]]> http://blog.lukmus.ru/2013/01/21/neyronnyie-seti-na-ruby/feed/ 4 автоматическое подключение декоратора от Draper в rails 3 http://blog.lukmus.ru/2012/12/20/avtomaticheskoe-podklyuchenie-dekorato/ http://blog.lukmus.ru/2012/12/20/avtomaticheskoe-podklyuchenie-dekorato/#comments Thu, 20 Dec 2012 08:45:45 +0000 lukmus http://blog.lukmus.ru/?p=1725 Если использовать декоратор Draper, то для использования методов модели описанных в декораторе приходиться использовать явное подключение декоратора через YourModelDecorator.new() или YourModelDecorator.decorate(). Британскими учеными установлено, что явное подключение декоратора утомляет и вызывает сонливость.

Для отказа от постоянного декорирования можно задействовать метод класса, который вызывается в случае отсутствия метода с указанным именем method_missing().

1
2
3
4
5
6
7
8
9
10
11
12

class YourModel < ActiveRecord::Base
...
  def method_missing(name, *args, &block)
    puts "tried to handle unknown method %s" % name
    your_model=YourModelDecorator.new self
    return your_model.send(name.to_sym, *args,&block) if block_given? && !args.empty?
    return your_model.send(name.to_sym, *args) unless args.empty?
    return your_model.send(name.to_sym, &block) if block_given?
    your_model.send(name.to_sym)
  end
...
end

И пусть, в самом декораторе, например, следующее:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20

class YourModelDecorator < ApplicationDecorator
...
  def test
    puts "method without args & block"
  end
  def test_with_args(str)
    puts "method with args: #{str}"
  end
  def test_with_block
    puts "start block"
    yield if block_given?
    puts "end block"
  end
  def test_with_args_and_block(str,&block)
    puts "start block with #{str}"
    yield block
    puts "end block"
  end
...
end

Теперь можно увидеть в консоли примерно следующее:

> your_model=YourModel.first
> your_model.unknown_method
tried to handle unknown method unknown_method
NoMethodError: undefined method `unknown_method'
> your_model.test
tried to handle unknown method test
method without args & block
 => nil 
> your_model.test_with_args("i don't like the drugs")
tried to handle unknown method test_with_args
method with args: i don't like the drugs
 => nil 
> your_model.test_with_block{puts "but the drugs like me"}
tried to handle unknown method test_with_block
start block
but the drugs like me
end block
 => nil 
> your_model.test_with_args_and_block("there's a hole in our soul"){puts "that we fill with dope"}
tried to handle unknown method test_with_args_and_block
start block with there's a hole in our soul
that we fill with dope
end block
 => nil 
> your_model=YourModelDecorator.new
> your_model.test
method without args & block

Не претендую на оригинальность и простоту, зато таким образом методы декоратора подгружаются только по необходимости.

]]> http://blog.lukmus.ru/2012/12/20/avtomaticheskoe-podklyuchenie-dekorato/feed/ 0 rails 3 + декоратор Draper http://blog.lukmus.ru/2012/12/18/rails-3-dekorator-draper/ http://blog.lukmus.ru/2012/12/18/rails-3-dekorator-draper/#comments Tue, 18 Dec 2012 04:31:21 +0000 lukmus http://blog.lukmus.ru/?p=1702 Захламлять модели своими методами в Rails-приложении это говнокод, это наверное знает каждый, в отличие от меня, однако, наличие дополнительных методов может существенно облегчить представление. Решить эту дилемму помогают декораторы. Ниже описан мой опыт знакомства с декораторами на примере гема Draper.

Зачем нужен рефакторинг моделей и что это такое написано еще тут. А вот гем Draper.

установка

Тут все как обычно. Добавляем в Gemfile

gem 'draper'

и бандлим

bundle install

эксплуатация

генерация

Если модель генерируется после того как был установлен Draper, то декоратор создастся сам автоматически. Для ручной генерации декоратора есть команда:

rails g decorator YourModel

После выполнения генерации можно увидеть директорию app/decorators где будет лежать файл your_model_decorator.rb. В этом файле и нужно прописывать дополнительные методы модели.

ошибки

Тут я не буду следовать инструкции со страницы гема т.к. она не соответствует реальности, по крайней мере с Rails 3.1.
Итак, на данный момент существует файл декоратора модели YourModel app/decorators/your_model_decorator.rb:

1
2
3
4

class YourModelDecorator < ApplicationDecorator
  decorates :your_model
  #bla-bla-bla
end

И если сейчас запустить консоль, то вылетит ошибка:

$ rails c
/home/username/ror/myapp/app/decorators/your_model_decorator.rb:2:in `': uninitialized constant ApplicationDecorator (NameError)
...

Конечно, можно создать файл app/decorators/application_decorator.rb как советует страница на гитхабе:

1
2
3

class ApplicationDecorator < Draper::Decorator
  # your methods go here
end

но это вряд ли поможет, т.к. выскочит другая ошибка при запуске консоли:

$ rails c
/home/username/ror/myapp/app/decorators/your_model_decorator.rb:2:in `': uninitialized constant Draper::Decorator (NameError)
from /usr/local/rvm/gems/ruby-1.9.2-p290/gems/draper-0.12.0/lib/draper/system.rb:9:in `block in load_app_local_decorators'
from /usr/local/rvm/gems/ruby-1.9.2-p290/gems/draper-0.12.0/lib/draper/system.rb:9:in `each'
from /usr/local/rvm/gems/ruby-1.9.2-p290/gems/draper-0.12.0/lib/draper/system.rb:9:in `load_app_local_decorators'
...

Пошарясь немного по файлам в директории /usr/local/rvm/gems/ruby-1.9.2-p290/gems/draper-0.12.0/lib/draper/, а конкретнее в файле /usr/local/rvm/gems/ruby-1.9.2-p290/gems/draper-0.12.0/lib/draper/base.rb становится ясно, что app/decorators/application_decorator.rb надо привести к виду:

1
2
3

class ApplicationDecorator < Draper::Base
  # your methods go here
end

И тут все ошибки резко пропадают.

использование

Теперь в декоратор нужно перенести лишние методы из модели. Для того чтобы экземпляры модели пополнились методами из декоратора при их использовании в контроллере или еще где-либо нужно делать так:

> your_model_exemplar=YourModel.first
> your_model_exemplar.new_method_which_is_in_decorator
NoMethodError: undefined method `new_method_which_is_in_decorator' for #
> your_model_exemplar=YourModelDecorator.new YourModel.first
> your_model_exemplar.new_method_which_is_in_decorator
=> "it really works"
> your_model_exemplars=YourModelDecorator.decorate YourModel.first(10)
> your_model_exemplars.first.new_method_which_is_in_decorator
=> "it really works"

Для коллекции обязательно использовать метод decorate, для единичного экземпляра можно и new, и decorate. Сказка про decorate_collection для коллекции, которая написана на гитхабе это всего лишь сказка, ее рекомендации не работают в реальном мире.

хелперы в декораторе

Офстраница на гитхабе советует задействовать хелперы через helpers и сокращенную форму h или без дополнительных примочек просто подключив модуль include Draper::LazyHelpers (ниже дезинформация с https://github.com/drapergem/draper):

1
2
3
4
5
6
7

class ArticleDecorator < Draper::Decorator   
  def published_at     
    date = h.content_tag(:span, article.published_at.strftime("%A, %B %e").squeeze(" "), :class => 'date')
    time = h.content_tag(:span, article.published_at.strftime("%l:%M%p"), :class => 'time').delete(" ")
    h.content_tag :span, date + time, :class => 'created_at'
  end
end

У меня ничего из предложенного не прокатило, зато неожиданно прокатил способ с helper.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

class YourModelDecorator < ApplicationDecorator
  include Draper::LazyHelpers #по идее должен избавить от явного объявления helper, но нет
  decorates :your_model
  def test_helpers
    content_tag :div, "it really works"
  end
  def test_helpers_via_h
    h.content_tag :div, "it really works"
  end    
  def test_helpers_via_helpers
    helpers.content_tag :div, "it really works"
  end   
  def may_be_that_is_working?
    helper.content_tag :div, "Hallelujah!"
  end  
end
> your_model_exemplar=YourModelDecorator.new YourModel.first
> your_model_exemplar.test_helpers
NoMethodError: undefined method `content_tag' for #
> your_model_exemplar.test_helpers_via_h
NoMethodError: undefined method `content_tag' for nil:NilClass
> your_model_exemplar.test_helpers_via_helpers
NoMethodError: undefined method `content_tag' for nil:NilClass
> your_model_exemplar.may_be_that_is_working?
=> "<div>Hallelujah!</div>"

Собственно все. Быть может все эти ошибки из-за того, что у меня ruby 1.9.2, а гем писался для 1.9.3 или рельсы у меня старые, а может просто доки у гема что-то типа квеста.

]]> http://blog.lukmus.ru/2012/12/18/rails-3-dekorator-draper/feed/ 1