mailee 0.5.0 → 0.6.0

data/Gemfile

@@ -0,0 +1,12 @@
+source "http://rubygems.org"
+
+gem "actionmailer", "~> 3.0"
+gem "activeresource", "~> 3.0"
+gem "activerecord", "~> 3.0"
+
+group :development, :test do
+  gem "rspec", "~> 2.6.0"
+  gem "bundler", "~> 1.0.0"
+  gem "jeweler", "~> 1.6.4"
+  gem "sqlite3", "~> 1.3.4"
+end

data/Gemfile.lock

@@ -0,0 +1,79 @@
+GEM
+  remote: http://rubygems.org/
+  specs:
+    abstract (1.0.0)
+    actionmailer (3.0.10)
+      actionpack (= 3.0.10)
+      mail (~> 2.2.19)
+    actionpack (3.0.10)
+      activemodel (= 3.0.10)
+      activesupport (= 3.0.10)
+      builder (~> 2.1.2)
+      erubis (~> 2.6.6)
+      i18n (~> 0.5.0)
+      rack (~> 1.2.1)
+      rack-mount (~> 0.6.14)
+      rack-test (~> 0.5.7)
+      tzinfo (~> 0.3.23)
+    activemodel (3.0.10)
+      activesupport (= 3.0.10)
+      builder (~> 2.1.2)
+      i18n (~> 0.5.0)
+    activerecord (3.0.10)
+      activemodel (= 3.0.10)
+      activesupport (= 3.0.10)
+      arel (~> 2.0.10)
+      tzinfo (~> 0.3.23)
+    activeresource (3.0.10)
+      activemodel (= 3.0.10)
+      activesupport (= 3.0.10)
+    activesupport (3.0.10)
+    arel (2.0.10)
+    builder (2.1.2)
+    diff-lcs (1.1.3)
+    erubis (2.6.6)
+      abstract (>= 1.0.0)
+    git (1.2.5)
+    i18n (0.5.0)
+    jeweler (1.6.4)
+      bundler (~> 1.0)
+      git (>= 1.2.5)
+      rake
+    mail (2.2.19)
+      activesupport (>= 2.3.6)
+      i18n (>= 0.4.0)
+      mime-types (~> 1.16)
+      treetop (~> 1.4.8)
+    mime-types (1.16)
+    polyglot (0.3.2)
+    rack (1.2.4)
+    rack-mount (0.6.14)
+      rack (>= 1.0.0)
+    rack-test (0.5.7)
+      rack (>= 1.0)
+    rake (0.9.2)
+    rspec (2.6.0)
+      rspec-core (~> 2.6.0)
+      rspec-expectations (~> 2.6.0)
+      rspec-mocks (~> 2.6.0)
+    rspec-core (2.6.4)
+    rspec-expectations (2.6.0)
+      diff-lcs (~> 1.1.2)
+    rspec-mocks (2.6.0)
+    sqlite3 (1.3.4)
+    treetop (1.4.10)
+      polyglot
+      polyglot (>= 0.3.1)
+    tzinfo (0.3.30)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  actionmailer (~> 3.0)
+  activerecord (~> 3.0)
+  activeresource (~> 3.0)
+  bundler (~> 1.0.0)
+  jeweler (~> 1.6.4)
+  rspec (~> 2.6.0)
+  sqlite3 (~> 1.3.4)

data/README.markdown

@@ -1,172 +1,214 @@
-Mailee - Email marketing para quem entende de tecnologia.
-==============
+# Mailee - Email marketing para quem entende de tecnologia.
 
-O problema
-=
+## O problema
 
-  Você está desenvolvendo um sistema (e-commerce, cms, erp...) e o seu cliente solicita a possibilidade de enviar e-mails promocionais, ou notícias, para diversos contatos. Por experiência própria, você sabe que enviar e-mails não é coisa para _scriptkiddies_, e que, de fato, não vale a pena o esforço de desenvolver todo um sistema que faça o envio, garanta a entrega, analise os retornos e também apresente resultados de tudo isso. O problema é que os sistemas que você conhece não permitem uma integração fácil e rápida com seus sistemas em Rails...
+Você está desenvolvendo um sistema (e-commerce, cms, erp...) e o seu cliente solicita a possibilidade de enviar e-mails promocionais, ou notícias, para diversos contatos. 
 
-A solução
-=
+Por experiência própria, você sabe que enviar e-mails não é coisa para _scriptkiddies_, e que, de fato, não vale a pena o esforço de desenvolver todo um sistema que faça o envio, garanta a entrega, analise os retornos e também apresente resultados de tudo isso. O problema é que os sistemas que você conhece não permitem uma integração fácil e rápida com seus sistemas em Rails...
 
-  Esta gem tem como objetivo manter os contatos da sua aplicação sincronizados com os contatos do Mailee (www.mailee.me) sem muito esforço. De fato, basta executar o método "sync_with_mailee" no seu modelo (clientes, contatos, pessoas...) que este irá automaticamente realizar as tarefas de inserir, atualizar, excluir e descadastrar via REST. No Mailee, seu cliente poderá então montar as mensagens e enviar para os contatos.
+## A solução
 
-O que posso fazer com a gem?
-=
+Esta gem tem como objetivo manter os contatos da sua aplicação sincronizados com os contatos do Mailee (www.mailee.me) sem muito esforço. 
 
- * Simplesmente utilizar as classes do Mailee para:
-   * Criar, atualizar, buscar e excluir contatos.
-   * Importar contatos com nome e email.
-   * Criar, atualizar, buscar e excluir listas.
-   * Criar, atualizar, buscar e excluir templates.
-   * Criar rascunhos, enviar testes e enviar mensagens agora ou para uma data futura. O envio de mensagens permite enviar para uma lista, para um conjunto de emails, definindo o html na mão ou usando um template do Mailee.me e definindo áreas editáveis e de repetições.
-   * Buscar datos dos relatórios.
- * Integrar com ActiveRecord (com ou sem Rails) e fazer um modelo sincronizar automaticamente com o Mailee.me.
- * Integrar com ActionMailer (com ou sem Rails) e fazer os mailers enviarem as mensagens pelo Mailee.me.
+De fato, basta executar o método `sync_with_mailee` no seu modelo (clientes, contatos, pessoas...) que este irá automaticamente realizar as tarefas de inserir, atualizar, excluir e descadastrar via REST. No Mailee, seu cliente poderá então montar as mensagens e enviar para os contatos.
 
-Instalação
-=
+## O que posso fazer com a gem?
 
- * Adicione a seguinte linha ao seu Gemfile:
- > gem 'mailee'
- * E execute o bundle:
- > bundle install
- * Uma vez instalado, para configurar, execute:
- > rails g mailee_rails:setup
+* Simplesmente utilizar as classes do Mailee para:
+  * Criar, atualizar, buscar e excluir contatos.
+  * Importar contatos com nome e email.
+  * Criar, atualizar, buscar e excluir listas.
+  * Criar, atualizar, buscar e excluir templates.
+  * Criar rascunhos, enviar testes e enviar mensagens agora ou para uma data futura. O envio de mensagens permite enviar para uma lista, para um conjunto de emails, definindo o html na mão ou usando um template do Mailee.me e definindo áreas editáveis e de repetições.
+  * Buscar datos dos relatórios.
+* Integrar com ActiveRecord (com ou sem Rails) e fazer um modelo sincronizar automaticamente com o Mailee.me.
+* Integrar com ActionMailer (com ou sem Rails) e fazer os mailers enviarem as mensagens pelo Mailee.me.
 
-  Este comando irá solicitar sua URL da API e criar um initializer com toda a configuração necessária.
-  A URL da API você descobre entrando no Mailee e indo em Configurações > Integração > REST
+## Instalação
+
+Adicione a seguinte linha ao seu Gemfile:
+
+~~~.ruby
+gem 'mailee'
+~~~
+
+E execute o bundle:
+
+    bundle install
+
+Uma vez instalado, para configurar, execute:
+
+    rails g mailee_rails:setup
+
+Este comando irá solicitar sua URL da API e criar um initializer com toda a configuração necessária. A URL da API você descobre entrando no Mailee e indo em **Configurações > Integração > REST**
  
-  Pronto!
+Pronto!
+
+## Compatibilidade
 
-Compatibilidade
-=
+Rails 3. 'Nuff said. Se você precisa de suporte ao Rails 2, baixe a versão 0.1.0, mas ela possui muito menos funcionalidades do que a versão atual.
 
-  Rails 3. 'Nuff said. Se você precisa de suporte ao Rails 2, baixe a versão 0.1.0, mas ela possui muito menos funcionalidades do que a versão atual.
+## Uso
 
-Uso
-=
+### Na mão (console)
 
-  * Na mão (console)
+Você pode usar a api do maile "na mão". Basta abrir o console e usar:
 
-  Você pode usar a api do maile "na mão". Basta abrir o console e usar:
-  = code
     ruby script/console
+
     include Mailee
+
     Contact.find(:all)
     Contact.find(:first)
+
     Contact.search('russell')
+
     Contact.find_by_internal_id(789)
     Contact.find_by_email('russell@cambridge.edu.uk')
+
     Contact.create(:name => 'Bertrand Russell', :email => 'russell@cambridge.edu.uk')
     Contact.create(:email => 'ludwig@wittgenstein.edu.uk', :dynamic_attributes => {:influence => 'Frege'})
+
+    Contact.find_by_internal_id(789).put(:subscribe, :list => {:name => 'Analytic Philosophers'})
+    Contact.find_by_internal_id(789).put(:unsubscribe, :unsubscribe => {:reason => 'Email too long'})
+
     List.find(:all)
     List.find(:first)
     List.create(:name => 'My List')
+
     Template.find(:all)
     Template.find(:first)
     Template.create(:title => 'My Template', :html => File.read('mytemplate.html'))
+
     # Message with HTML and list
     message = Message.create :title => "Title", :subject => "Subject", :from_name => "Rorty", :from_email => "rorty@princeton.us", :html => File.read('myhtml.html'), :list_id => 987
+
     # Message with emails and template (with edits & repeats)
     message = Message.create :title => "Title", :subject => "Subject", :from_name => "Rorty", :from_email => "rorty@princeton.us", :template_id => 765, :edits => {:greeting => 'Hi Davidson!'}, :repeats => {:news => ['A good news', 'A bad news'], :emails => 'davidson@some.com davidson@another.com'}
     message.test([44,55,66])
     message.ready # send it now
     message.ready(10.days.from_now)
 
-  * Com modelos (ActiveRecord)
-
-  Esta gem é feita para manter um modelo AciveRecord sincronizado com os contatos do Mailee. Para fazer isto, basta colocar o método "sync_with_mailee" em seu modelo. Se o seu modelo se chama "Contact", por exemplo, o código seria este:
-  =code
-    class Contact < ActiveRecord::Base
-      sync_with_mailee
-    end
-  A priori, a gem espera que você tenha pelo menos os campos de email e optins, e pressupõe que estes campos se chamem "email" e "news". Se os campos da sua tabela não tem estes nomes, você pode fazer o seguinte:
-  =code
-    class Contact < ActiveRecord::Base
-      sync_with_mailee :email => :my_email_column, :news => :my_optin_column
-    end
-  Onde "my_email_column" é a coluna que guarda o e-mail na sua tabela e "my_optin_column" o booleano que guarda o optin.
-  A gem também pode manter o nome do seu contato sincronizado, bastando para isto ter um campo "name" que será mapeado por padrão, mas que também pode ser sobrescrito:
-  =code
-    class Contact < ActiveRecord::Base
-      sync_with_mailee :name => :my_name_column
-    end  
-  Se o valor do campo "news" (ou o que você utilizar para optin) for false, a gem não cadastrará o contato no Mailee. Se o contato já estiver cadastrado e o valor deste campo mudar para falso, o contato será descadastrado e _não_ poderá ser mais cadastrado no Mailee (normas de privacidade). Se ele estiver falso e mudar para verdadeiro, ele irá cadastrá-lo.
-  =code
-    class Contact < ActiveRecord::Base
-      sync_with_mailee :list => "Nome da sua lista"
-    end  
-  Você também pode (e a gente recomenda que você o faça) informar a lista na qual você quer que o contato seja inscrito quando ele for cadastrado no Mailee.me. Assim, quando você for criar uma campanha todos seus contatos cadastrados pelo seu sistema já estarão em uma lista. Aí é só enviar para esta lista e pronto.
-
-  * Com mailers (ActionMailer)
+### Com modelos (ActiveRecord)
+
+Esta gem é feita para manter um modelo AciveRecord sincronizado com os contatos do Mailee. 
+
+Para fazer isto, basta colocar o método `sync_with_mailee` em seu modelo. Se o seu modelo se chama `Contact`, por exemplo, o código seria este:
+
+~~~.ruby
+class Contact < ActiveRecord::Base
+  sync_with_mailee
+end
+~~~
+
+A priori, a gem espera que você tenha pelo menos os campos de email e optins, e pressupõe que estes campos se chamem `email` e `news`.  Se os campos da sua tabela não tem estes nomes, você pode fazer o seguinte:
+
+~~~.ruby
+class Contact < ActiveRecord::Base
+  sync_with_mailee :email => :my_email_column, :news => :my_optin_column
+end
+~~~
+
+Onde `my_email_column` é a coluna que guarda o e-mail na sua tabela e `my_optin_column` o booleano que guarda o optin.
+
+A gem também pode manter o nome do seu contato sincronizado, bastando para isto ter um campo `name` que será mapeado por padrão, mas que também pode ser sobrescrito:
+
+~~~.ruby
+class Contact < ActiveRecord::Base
+  sync_with_mailee :name => :my_name_column
+end
+~~~
+
+Se o valor do campo `news` (ou o que você utilizar para optin) for `false`, a gem não cadastrará o contato no Mailee. 
+Se o contato já estiver cadastrado e o valor deste campo mudar para `falso`, o contato será descadastrado e **não** poderá ser mais cadastrado no Mailee (normas de privacidade). 
+Se ele estiver `falso` e mudar para `verdadeiro`, ele irá cadastrá-lo.
+
+~~~.ruby
+class Contact < ActiveRecord::Base
+  sync_with_mailee :list => "Nome da sua lista"
+end
+~~~
+
+Você também pode (e a gente recomenda que você o faça) informar a lista na qual você quer que o contato seja inscrito quando ele for cadastrado no Mailee.me. Assim, quando você for criar uma campanha todos seus contatos cadastrados pelo seu sistema já estarão em uma lista. Aí é só enviar para esta lista e pronto.
+
+### Com mailers (ActionMailer)
   
-  Esta gem permite que você utilize o Mailee.me como meio de enviar suas mensagens sem precisar configurar um servidor smtp ou algo pareceido.
+Esta gem permite que você utilize o Mailee.me como meio de enviar suas mensagens sem precisar configurar um servidor smtp ou algo pareceido.
   
-  Você pode optar por enviar todas as mensagens por ele, ou só as mensagens de determinados mailers. Para a configuração global, adicione a seguinte linha ao seu arquivo de ambiente (config/environments/production.rb ou development.rb):
+Você pode optar por enviar todas as mensagens por ele, ou só as mensagens de determinados mailers. 
+
+Para a configuração global, adicione a seguinte linha ao seu arquivo de ambiente (`config/environments/production.rb` ou `development.rb`):
 
-  = code
-    config.action_mailer.delivery_method = Mailee::Mailer
+~~~.ruby
+config.action_mailer.delivery_method = Mailee::Mailer
+~~~
 
-  Agora, se você quer enviar apenas mensagens de um certo mailer pelo Mailee, basta adicionar o método "send_with_mailee" em cada um:
+Agora, se você quer enviar apenas mensagens de um certo mailer pelo Mailee, basta adicionar o método `send_with_mailee` em cada um:
 
-  = code
-    class Notifications < ActionMailer::Base
-      send_with_mailee
-      ...
-    end
+~~~.ruby
+class Notifications < ActionMailer::Base
+  send_with_mailee
+  ...
+end
+~~~
   
-  É importante definir o from com o formato completo:
-
-  = code
-    class Notifications < ActionMailer::Base
-      default :from => "Plato <plato@liceum.gr>
-      ...
-    end
-
-  Ao enviar uma mensagem, você pode também optar por enviá-la agora ou no futuro:
-
-  = code
-    class Notifications < ActionMailer::Base
-      def signup(client, date=Time.now)
-        mail :date => date, :to => client.email
-      end
-      def feedback(client, date=Time.now)
-        mail :date => date, :to => client.email
-      end
-    end
-    ...
+É importante definir o from com o formato completo:
+
+~~~.ruby
+class Notifications < ActionMailer::Base
+  default :from => "Plato <plato@liceum.gr>
+  ...
+end
+~~~
+
+Ao enviar uma mensagem, você pode também optar por enviá-la agora ou no futuro:
+
+~~~.ruby
+class Notifications < ActionMailer::Base
+  def signup(client, date=Time.now)
+    mail :date => date, :to => client.email
+  end
+  def feedback(client, date=Time.now)
+    mail :date => date, :to => client.email
+  end
+end
+~~~
+
     Notifications.signup(client).deliver
     Notifications.feedback(client, 3.days.from_now).deliver
 
-  Por fim, ao enviar uma mensagem, a gem adiciona um método que representa a mensagem no Mailee.me, veja:
+Por fim, ao enviar uma mensagem, a gem adiciona um método que representa a mensagem no Mailee.me, veja:
   
-  = code
     mail = Notifications.signup(client).deliver
-    mail.mailee_message.id # Retorna o id
-    mail.mailee_message.html # Retorna o html
+    mail.mailee_message.id    # Retorna o id
+    mail.mailee_message.html  # Retorna o html
     # e assim por diante...
   
-  Isto é útil, pois você já pode monitorar os resultados com este id:
+Isto é útil, pois você já pode monitorar os resultados com este id:
 
-  = code
     mail = Notifications.signup(client).deliver
     Mailee::Report.find(mail.mailee_message.id)
 
-  * Tarefas (rake)
+### Tarefas (rake)
+
+Caso você já tenha itens cadastrados, é necessário adicionar estes contatos ao Mailee antes de mais nada. Para isso execute a tarefa rake:
+
+    $ rake mailee:send CLASS=Contact
+
+Onde `Contact` é o nome do seu modelo. Se você quer apenas enviar os contatos a partir de uma determinada data, você pode fazê-lo desta forma:
+
+    $ rake mailee:send CLASS=Contact AFTER=5.days.ago
+
+Neste caso, ele vai apenas sincronizar os contatos que foram atualizados (baseado no campo `updated_at`) nos últimos 5 dias.  
+
+## Cuidado!
 
-  Caso você já tenha itens cadastrados, é necessário adicionar estes contatos ao Mailee antes de mais nada. Para isso execute a tarefa rake:
-  > rake mailee:send CLASS=Contact
-  Onde "Contact" é o nome do seu modelo. Se você quer apenas enviar os contatos a partir de uma determinada data, você pode fazê-lo desta forma:
-  > rake mailee:send CLASS=Contact AFTER=5.days.ago
-  Neste caso, ele vai apenas sincronizar os contatos que foram atualizados (baseado no campo "updated_at") nos últimos 5 dias.  
+A gem utiliza a API REST do Mailee para enviar dados, por isto cuide bem da sua URL - se alguém descobrir isso pode ser ruim. 
 
-Cuidado!
-=
+Para saber qual o contato na sua aplicação a gem utiliza um campo disponível no Mailee chamado `internal_id` o qual recebe o `id` da sua tabela na criação. 
 
-  A gem utiliza a API REST do Mailee para enviar dados, por isto cuide bem da sua URL - se alguém descobrir isso pode ser ruim. Para saber qual o contato na sua aplicação a gem utiliza um campo disponível no Mailee chamado "internal_id" o qual recebe o "id" da sua tabela na criação. Este id é usado nas atualizações, descadastros e exclusões, então tome (ou avise seu cliente para tomar!) cuidado ao editar este campo na interface do Mailee.
+Este id é usado nas atualizações, descadastros e exclusões, então tome (ou avise seu cliente para tomar!) cuidado ao editar este campo na interface do Mailee.
 
-Dúvidas?
-=
+## Dúvidas?
 
-  Qualquer dúvida, não hesite em falar conosco pelo e-mail suporte@mailee.me, pelo twitter @maileeme ou pelo IRC #maileeme. 
+Qualquer dúvida, não hesite em falar conosco pelo e-mail suporte@mailee.me, pelo twitter @maileeme ou pelo IRC #maileeme. 

data/Rakefile

@@ -1,17 +1,26 @@
+# coding: utf-8
+
 require 'rubygems'
+require 'bundler'
+begin
+  Bundler.setup(:default, :development)
+rescue Bundler::BundlerError => e
+  $stderr.puts e.message
+  $stderr.puts "Run `bundle install` to install missing gems"
+  exit e.status_code
+end
 require 'rake'
 
 begin
   require 'jeweler'
   Jeweler::Tasks.new do |gem|
     gem.name = "mailee"
-    gem.summary = %Q{Gem de integração do Mailee.me}
+    gem.summary = %Q{Gem para uso da API do Mailee.me}
     gem.description = %Q{Permite sincronizar automaticamente seus modelos com o Mailee.me, inclusive com gerenciamento de optin.}
     gem.email = "suporte@mailee.me"
     gem.homepage = "http://help.mailee.me/integration_rails.html"
     gem.authors = ["Juan Maiz"]
-    # gem.add_development_dependency "thoughtbot-shoulda", ">= 0"
-    # gem is a Gem::Specification... see http://www.rubygems.org/read/chapter/20 for additional settings
+    # dependencies defined in Gemfile
   end
   Jeweler::GemcutterTasks.new
 rescue LoadError

data/VERSION

@@ -1 +1 @@
-0.5.0
+0.6.0

data/app/Gemfile

@@ -1,7 +1,7 @@
 source 'http://rubygems.org'
 
 gem 'rails', '3.0.0'
-gem 'mailee', '0.4.3'
+gem 'mailee', '0.5.0'
 # Bundle edge Rails instead:
 # gem 'rails', :git => 'git://github.com/rails/rails.git'
 

data/app/Gemfile.lock

@@ -38,7 +38,7 @@ GEM
       activesupport (>= 2.3.6)
       mime-types
       treetop (>= 1.4.5)
-    mailee (0.4.3)
+    mailee (0.5.0)
     mime-types (1.16)
     polyglot (0.3.1)
     rack (1.2.1)
@@ -70,6 +70,6 @@ PLATFORMS
   ruby
 
 DEPENDENCIES
-  mailee (= 0.4.3)
+  mailee (= 0.5.0)
   rails (= 3.0.0)
   sqlite3-ruby

data/lib/mailee/active_record.rb

@@ -43,10 +43,6 @@ module Mailee
           unless self.column_names.include?(self.sync_options[:news].to_s)
             self.sync_options[:news] = nil
           end
-          if self.sync_options[:list]
-            lists = List.find(:all).map(&:name)
-            raise "A lista '#{self.sync_options[:list]}' não existe no Mailee.me." unless lists.include?(self.sync_options[:list])
-          end
         end
         include InstanceMethods
       end

data/lib/mailee/active_resource.rb

@@ -41,7 +41,14 @@ module Mailee
       put(:unsubscribe, :unsubscribe => {:reason => 'Motivo não especificado'}.merge(data))
     end
     def subscribe(list)
-      put(:subscribe, :list => {:name => list})
+      print "Warning: Mailee::Contact.subscribe will be deprecated. Use Mailee::Contact.list_subscribe instead."
+      put(:list_subscribe, :list => list)
+    end
+    def list_subscribe(list)
+      put(:list_subscribe, :list => list)
+    end
+    def list_unsubscribe(list)
+      put(:list_unsubscribe, :list => list)
     end
   end
 

data/lib/mailee/railties.rb

@@ -21,7 +21,7 @@ class MaileeRails < Rails::Railtie
           puts "Invalid URL. Please try again:"
           url = readline.gsub(/\n/,'').gsub(/\s+/, '')
         else
-          puts "I think need support. Please talk to us on IRC (#maileeme) or send an email to suporte@mailee.me"
+          puts "I think you need support. Please talk to us on IRC (#maileeme) or send an email to suporte@mailee.me"
           exit
         end
       end

data/mailee.gemspec

@@ -1,125 +1,137 @@
 # Generated by jeweler
 # DO NOT EDIT THIS FILE DIRECTLY
-# Instead, edit Jeweler::Tasks in Rakefile, and run the gemspec command
+# Instead, edit Jeweler::Tasks in Rakefile, and run 'rake gemspec'
 # -*- encoding: utf-8 -*-
 
 Gem::Specification.new do |s|
   s.name = %q{mailee}
-  s.version = "0.5.0"
+  s.version = "0.6.0"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["Juan Maiz"]
-  s.date = %q{2011-03-28}
+  s.date = %q{2011-10-21}
   s.description = %q{Permite sincronizar automaticamente seus modelos com o Mailee.me, inclusive com gerenciamento de optin.}
   s.email = %q{suporte@mailee.me}
   s.extra_rdoc_files = [
     "LICENSE",
-     "README.markdown",
-     "README.markdown.pt",
-     "README.rdoc"
+    "README.markdown",
+    "README.markdown.pt"
   ]
   s.files = [
-    ".gitignore",
-     ".rspec",
-     "LICENSE",
-     "MIT-LICENSE",
-     "README.markdown",
-     "README.rdoc",
-     "Rakefile",
-     "VERSION",
-     "app/.gitignore",
-     "app/Gemfile",
-     "app/Gemfile.lock",
-     "app/README",
-     "app/Rakefile",
-     "app/app/controllers/application_controller.rb",
-     "app/app/helpers/application_helper.rb",
-     "app/app/mailers/foo.rb",
-     "app/app/views/foo/bar.html.erb",
-     "app/app/views/foo/baz.text.erb",
-     "app/app/views/layouts/application.html.erb",
-     "app/config.ru",
-     "app/config/application.rb",
-     "app/config/boot.rb",
-     "app/config/database.yml",
-     "app/config/environment.rb",
-     "app/config/environments/development.rb",
-     "app/config/environments/production.rb",
-     "app/config/environments/test.rb",
-     "app/config/initializers/backtrace_silencers.rb",
-     "app/config/initializers/inflections.rb",
-     "app/config/initializers/mailee.rb",
-     "app/config/initializers/mime_types.rb",
-     "app/config/initializers/secret_token.rb",
-     "app/config/initializers/session_store.rb",
-     "app/config/locales/en.yml",
-     "app/config/routes.rb",
-     "app/db/schema.rb",
-     "app/db/seeds.rb",
-     "app/doc/README_FOR_APP",
-     "app/lib/tasks/.gitkeep",
-     "app/public/404.html",
-     "app/public/422.html",
-     "app/public/500.html",
-     "app/public/favicon.ico",
-     "app/public/images/rails.png",
-     "app/public/index.html",
-     "app/public/javascripts/application.js",
-     "app/public/javascripts/controls.js",
-     "app/public/javascripts/dragdrop.js",
-     "app/public/javascripts/effects.js",
-     "app/public/javascripts/prototype.js",
-     "app/public/javascripts/rails.js",
-     "app/public/robots.txt",
-     "app/public/stylesheets/.gitkeep",
-     "app/script/rails",
-     "app/test.rb",
-     "app/test/functional/foo_test.rb",
-     "app/test/performance/browsing_test.rb",
-     "app/test/test_helper.rb",
-     "app/vendor/plugins/.gitkeep",
-     "init.rb",
-     "install.rb",
-     "lib/mailee.rb",
-     "lib/mailee/action_mailer.rb",
-     "lib/mailee/active_record.rb",
-     "lib/mailee/active_resource.rb",
-     "lib/mailee/railties.rb",
-     "mailee.gemspec",
-     "pkg/mailee-0.1.0.gem",
-     "pkg/mailee-0.1.1.gem",
-     "pkg/mailee-0.1.2.gem",
-     "pkg/mailee-0.4.4.gem",
-     "spec/am_spec_helper.rb",
-     "spec/ar_spec_helper.rb",
-     "spec/mailee-api-am_spec.rb",
-     "spec/mailee-api-ar_spec.rb",
-     "spec/mailee-api_spec.rb",
-     "spec/spec_helper.rb",
-     "tasks/mailee_tasks.rake"
+    ".rspec",
+    "Gemfile",
+    "Gemfile.lock",
+    "LICENSE",
+    "MIT-LICENSE",
+    "README.markdown",
+    "Rakefile",
+    "VERSION",
+    "app/.gitignore",
+    "app/Gemfile",
+    "app/Gemfile.lock",
+    "app/README",
+    "app/Rakefile",
+    "app/app/controllers/application_controller.rb",
+    "app/app/helpers/application_helper.rb",
+    "app/app/mailers/foo.rb",
+    "app/app/views/foo/bar.html.erb",
+    "app/app/views/foo/baz.text.erb",
+    "app/app/views/layouts/application.html.erb",
+    "app/config.ru",
+    "app/config/application.rb",
+    "app/config/boot.rb",
+    "app/config/database.yml",
+    "app/config/environment.rb",
+    "app/config/environments/development.rb",
+    "app/config/environments/production.rb",
+    "app/config/environments/test.rb",
+    "app/config/initializers/backtrace_silencers.rb",
+    "app/config/initializers/inflections.rb",
+    "app/config/initializers/mailee.rb",
+    "app/config/initializers/mime_types.rb",
+    "app/config/initializers/secret_token.rb",
+    "app/config/initializers/session_store.rb",
+    "app/config/locales/en.yml",
+    "app/config/routes.rb",
+    "app/db/schema.rb",
+    "app/db/seeds.rb",
+    "app/doc/README_FOR_APP",
+    "app/lib/tasks/.gitkeep",
+    "app/public/404.html",
+    "app/public/422.html",
+    "app/public/500.html",
+    "app/public/favicon.ico",
+    "app/public/images/rails.png",
+    "app/public/index.html",
+    "app/public/javascripts/application.js",
+    "app/public/javascripts/controls.js",
+    "app/public/javascripts/dragdrop.js",
+    "app/public/javascripts/effects.js",
+    "app/public/javascripts/prototype.js",
+    "app/public/javascripts/rails.js",
+    "app/public/robots.txt",
+    "app/public/stylesheets/.gitkeep",
+    "app/script/rails",
+    "app/test.rb",
+    "app/test/functional/foo_test.rb",
+    "app/test/performance/browsing_test.rb",
+    "app/test/test_helper.rb",
+    "app/vendor/plugins/.gitkeep",
+    "init.rb",
+    "install.rb",
+    "lib/mailee.rb",
+    "lib/mailee/action_mailer.rb",
+    "lib/mailee/active_record.rb",
+    "lib/mailee/active_resource.rb",
+    "lib/mailee/railties.rb",
+    "mailee.gemspec",
+    "pkg/mailee-0.1.0.gem",
+    "pkg/mailee-0.1.1.gem",
+    "pkg/mailee-0.1.2.gem",
+    "pkg/mailee-0.4.4.gem",
+    "pkg/mailee-0.5.1.gem",
+    "spec/am_spec_helper.rb",
+    "spec/ar_spec_helper.rb",
+    "spec/mailee-api-am_spec.rb",
+    "spec/mailee-api-ar_spec.rb",
+    "spec/mailee-api_spec.rb",
+    "spec/spec_helper.rb",
+    "tasks/mailee_tasks.rake"
   ]
   s.homepage = %q{http://help.mailee.me/integration_rails.html}
-  s.rdoc_options = ["--charset=UTF-8"]
   s.require_paths = ["lib"]
   s.rubygems_version = %q{1.3.7}
-  s.summary = %q{Gem de integração do Mailee.me}
-  s.test_files = [
-    "spec/am_spec_helper.rb",
-     "spec/ar_spec_helper.rb",
-     "spec/mailee-api-am_spec.rb",
-     "spec/mailee-api-ar_spec.rb",
-     "spec/mailee-api_spec.rb",
-     "spec/spec_helper.rb"
-  ]
+  s.summary = %q{Gem para uso da API do Mailee.me}
 
   if s.respond_to? :specification_version then
     current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
     s.specification_version = 3
 
     if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
+      s.add_runtime_dependency(%q<actionmailer>, ["~> 3.0"])
+      s.add_runtime_dependency(%q<activeresource>, ["~> 3.0"])
+      s.add_runtime_dependency(%q<activerecord>, ["~> 3.0"])
+      s.add_development_dependency(%q<rspec>, ["~> 2.6.0"])
+      s.add_development_dependency(%q<bundler>, ["~> 1.0.0"])
+      s.add_development_dependency(%q<jeweler>, ["~> 1.6.4"])
+      s.add_development_dependency(%q<sqlite3>, ["~> 1.3.4"])
     else
+      s.add_dependency(%q<actionmailer>, ["~> 3.0"])
+      s.add_dependency(%q<activeresource>, ["~> 3.0"])
+      s.add_dependency(%q<activerecord>, ["~> 3.0"])
+      s.add_dependency(%q<rspec>, ["~> 2.6.0"])
+      s.add_dependency(%q<bundler>, ["~> 1.0.0"])
+      s.add_dependency(%q<jeweler>, ["~> 1.6.4"])
+      s.add_dependency(%q<sqlite3>, ["~> 1.3.4"])
     end
   else
+    s.add_dependency(%q<actionmailer>, ["~> 3.0"])
+    s.add_dependency(%q<activeresource>, ["~> 3.0"])
+    s.add_dependency(%q<activerecord>, ["~> 3.0"])
+    s.add_dependency(%q<rspec>, ["~> 2.6.0"])
+    s.add_dependency(%q<bundler>, ["~> 1.0.0"])
+    s.add_dependency(%q<jeweler>, ["~> 1.6.4"])
+    s.add_dependency(%q<sqlite3>, ["~> 1.3.4"])
   end
 end
 

data/spec/ar_spec_helper.rb

@@ -4,6 +4,7 @@ require 'rspec'
 require 'sqlite3'
 require 'active_record'
 require 'mailee'
+require 'mailee/active_record'
 
 RSpec.configure do |config|
   Mailee::Config.site = "http://api.869a72b17b05a.mailee-api.mailee.me"

data/spec/mailee-api_spec.rb

@@ -35,9 +35,9 @@ describe "Mailee" do
   it "should get all contacts" do
     Array.new(25){|i| Mailee::Contact.create :email => "rest_test_#{@moment}_#{i}@test.com"}
     contacts = Mailee::Contact.find(:all)
-    contacts.size.should be(15)
+    contacts.size.should == 15
     contacts = Mailee::Contact.find(:all, :params => {:page => 2, :by_keyword => "rest_test_#{@moment}" })
-    contacts.size.should be(10)
+    contacts.size.should == 10
   end
 
   it "should create contact - and find by id" do
@@ -108,6 +108,13 @@ describe "Mailee" do
     contact.unsubscribe.should_not be nil
   end
 
+  it "should create a contact, subscribe to a list and unsubscribe from a list" do
+    contact = Mailee::Contact.create :email => "rest_test_#{@moment}@test.com"
+    contact.list_subscribe("rest_test_#{@moment}").should_not be nil
+    Mailee::List.all.find{|l| l.name == "rest_test_#{@moment}"}.name.should == "rest_test_#{@moment}"
+    contact.list_unsubscribe("rest_test_#{@moment}").should_not be nil
+  end
+
   it "should search contacts" do
     Mailee::Contact.search("rest_test").should_not be nil
   end
@@ -142,7 +149,8 @@ describe "Mailee" do
     message.ready(10.days.from_now).should_not be nil
   end
 
-  it "should import (quick) - specific methods" do        Mailee::Quick.import("rest_test_#{@moment}@test.com\nrest_test_2_#{@moment}@test.com\nrest_test_3_#{@moment}@test.com").should_not be nil
+  it "should import (quick) - specific methods" do        
+    Mailee::Quick.import("rest_test_#{@moment}@test.com\nrest_test_2_#{@moment}@test.com\nrest_test_3_#{@moment}@test.com").should_not be nil
   end
 
 end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification 
 name: mailee
 version: !ruby/object:Gem::Version 
-  hash: 11
+  hash: 7
   prerelease: false
   segments: 
   - 0
-  - 5
+  - 6
   - 0
-  version: 0.5.0
+  version: 0.6.0
 platform: ruby
 authors: 
 - Juan Maiz
@@ -15,10 +15,118 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2011-03-28 00:00:00 -03:00
+date: 2011-10-21 00:00:00 -02:00
 default_executable: 
-dependencies: []
-
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 7
+        segments: 
+        - 3
+        - 0
+        version: "3.0"
+  type: :runtime
+  name: actionmailer
+  prerelease: false
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 7
+        segments: 
+        - 3
+        - 0
+        version: "3.0"
+  type: :runtime
+  name: activeresource
+  prerelease: false
+  version_requirements: *id002
+- !ruby/object:Gem::Dependency 
+  requirement: &id003 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 7
+        segments: 
+        - 3
+        - 0
+        version: "3.0"
+  type: :runtime
+  name: activerecord
+  prerelease: false
+  version_requirements: *id003
+- !ruby/object:Gem::Dependency 
+  requirement: &id004 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 23
+        segments: 
+        - 2
+        - 6
+        - 0
+        version: 2.6.0
+  type: :development
+  name: rspec
+  prerelease: false
+  version_requirements: *id004
+- !ruby/object:Gem::Dependency 
+  requirement: &id005 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 23
+        segments: 
+        - 1
+        - 0
+        - 0
+        version: 1.0.0
+  type: :development
+  name: bundler
+  prerelease: false
+  version_requirements: *id005
+- !ruby/object:Gem::Dependency 
+  requirement: &id006 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 7
+        segments: 
+        - 1
+        - 6
+        - 4
+        version: 1.6.4
+  type: :development
+  name: jeweler
+  prerelease: false
+  version_requirements: *id006
+- !ruby/object:Gem::Dependency 
+  requirement: &id007 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 19
+        segments: 
+        - 1
+        - 3
+        - 4
+        version: 1.3.4
+  type: :development
+  name: sqlite3
+  prerelease: false
+  version_requirements: *id007
 description: Permite sincronizar automaticamente seus modelos com o Mailee.me, inclusive com gerenciamento de optin.
 email: suporte@mailee.me
 executables: []
@@ -29,14 +137,13 @@ extra_rdoc_files:
 - LICENSE
 - README.markdown
 - README.markdown.pt
-- README.rdoc
 files: 
-- .gitignore
 - .rspec
+- Gemfile
+- Gemfile.lock
 - LICENSE
 - MIT-LICENSE
 - README.markdown
-- README.rdoc
 - Rakefile
 - VERSION
 - app/.gitignore
@@ -102,6 +209,7 @@ files:
 - pkg/mailee-0.1.1.gem
 - pkg/mailee-0.1.2.gem
 - pkg/mailee-0.4.4.gem
+- pkg/mailee-0.5.1.gem
 - spec/am_spec_helper.rb
 - spec/ar_spec_helper.rb
 - spec/mailee-api-am_spec.rb
@@ -115,8 +223,8 @@ homepage: http://help.mailee.me/integration_rails.html
 licenses: []
 
 post_install_message: 
-rdoc_options: 
-- --charset=UTF-8
+rdoc_options: []
+
 require_paths: 
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement 
@@ -143,11 +251,6 @@ rubyforge_project:
 rubygems_version: 1.3.7
 signing_key: 
 specification_version: 3
-summary: "Gem de integra\xC3\xA7\xC3\xA3o do Mailee.me"
-test_files: 
-- spec/am_spec_helper.rb
-- spec/ar_spec_helper.rb
-- spec/mailee-api-am_spec.rb
-- spec/mailee-api-ar_spec.rb
-- spec/mailee-api_spec.rb
-- spec/spec_helper.rb
+summary: Gem para uso da API do Mailee.me
+test_files: []
+

data/.gitignore

@@ -1 +0,0 @@
-mailee-api-test.db

data/README.rdoc

@@ -1,64 +0,0 @@
-= Mailee - Email marketing para quem entende de tecnologia.
-==============
-
-== O problema
-
-  Você está desenvolvendo um sistema (e-commerce, cms, erp...) e o seu cliente solicita a possibilidade de enviar e-mails promocionais, ou notícias, para diversos contatos. Por experiência própria, você sabe que enviar e-mails não é coisa para _scriptkiddies_, e que, de fato, não vale a pena o esforço de desenvolver todo um sistema que faça o envio, garanta a entrega, analise os retornos e também apresente resultados de tudo isso. O problema é que os sistemas que você conhece não permitem uma integração fácil e rápida com seus sistemas em Rails...
-
-== A solução
-
-  Este plugin tem como objetivo manter os contatos da sua aplicação sincronizados com os contatos do Mailee (www.mailee.me) sem muito esforço. De fato, basta executar o método "sync_with_mailee" no seu modelo (clientes, contatos, pessoas...) que este irá automaticamente realizar as tarefas de inserir, atualizar, excluir e descadastrar via REST. No Mailee, seu cliente poderá então montar as mensagens e enviar para os contatos.
-
-== Instalação
-
- * Execute o seguinte comando em sua aplicação Rails:
- > script/plugin install git@github.com:softa/mailee-api.git
- * Adicione a seguinte linha de configuração em sua aplicação:
- Mailee::Config.site = 'http://api.chave.subdominio.wizee.net'
- O site você descobre entrando no Mailee e indo em Configurações > Integração > REST
- 
- Pronto!
- 
-== Uso
-
-  * Na mão (console)
-  Você pode usar a api do maile "na mão". Basta abrir o console e usar:
-  > ruby script/console
-  >> Contact.find(:all)
-  >> Contact.find(:first)
-  >> Contact.create(:name => 'Bertrand Russell', :email => 'russell@cambridge.edu.uk')
-  Mais exemplos você encontra(rá) na (futura) documentação da API.
-  * Com modelos (ActiveRecord)
-  Este plugin é feito para manter um modelo AciveRecord sincronizado com os contatos do Mailee. Para fazer isto, basta colocar o método "sync_with_mailee" em seu modelo. Se o seu modelo se chama "Contact", por exemplo, o código seria este:
-  =code
-    class Contact < ActiveRecord::Base
-      sync_with_mailee
-    end
-  A priori, o plugin espera que você tenha pelo menos um campo de email e pressupõe que o nome deste campo é "email". Se o campo da sua tabela não tem este nome, você pode fazer o seguinte:
-  =code
-    class Contact < ActiveRecord::Base
-      sync_with_mailee :email => :my_email_column
-    end
-  Onde "my_email_column" é a coluna que guarda o e-mail na sua tabela.
-  O plugin também pode manter o nome do seu contato sincronizado, bastando para isto ter um campo "name" que será mapeado por padrão, mas que também pode ser sobrescrito:
-  =code
-    class Contact < ActiveRecord::Base
-      sync_with_mailee :email => :my_email_column, :name => :my_name_column
-    end  
-  Por fim, o plugin permite que o cadastro no Mailee seja condicionado a um campo booleano (o padrão é "news"), que corresponde ao "opt-in" (a escolha de receber ou não mensagens) do seu contato. Ou seja, se o valor do campo for false, o plugin não cadastrará o contato no Mailee, e se o contato já estiver cadastrado e o valor deste campo mudar para falso, o contato será descadastrado e _não_ poderá ser mais cadastrado no Mailee (normas de privacidade). Para mudar o campo, basta:
-  =code
-    class Contact < ActiveRecord::Base
-      sync_with_mailee :email => :my_email_column, :name => :my_name_column, :news => :do_you_really_accept_to_receive_our_newsletter
-    end  
-  * Tarefas (rake)
-  Caso você já tenha itens cadastrados, é necessário adicionar estes contatos ao Mailee antes de mais nada. Para isso execute a tarefa rake:
-  > rake mailee:send CLASS=Contact
-  Onde "Contact" é o nome do seu modelo. Se você quer apenas enviar os contatos a partir de uma determinada data, você pode fazê-lo desta forma:
-  > rake mailee:send CLASS=Contact AFTER=5.days.ago
-  Neste caso, ele vai apenas sincronizar os contatos que foram atualizados (baseado no campo "updated_at") nos últimos 5 dias.  
-  * Mas... como isso funciona, caso eu precise saber?
-  O plugin utiliza a API REST do Mailee para enviar dados, por isto cuide bem da sua URL - se alguém descobrir isso pode ser ruim. Para saber qual o contato na sua aplicação o plugin utiliza um campo disponível no Mailee chamado "internal_id" o qual recebe o "id" da sua tabela na criação. Este id é usado nas atualizações, descadastros e exclusões, então tome (ou avise seu cliente para tomar!) cuidado ao editar este campo na interface do Mailee.
-
-== Dúvidas?
-
-  Qualquer dúvida, não hesite em falar conosco pelo e-mail suporte@mailee.me.