aweber 1.3.1 → 1.4.0

data/LICENSE

@@ -1,4 +1,4 @@
-Copyright (c) 2010-2011, AWeber Communications, Inc.
+Copyright (c) 2010-2012, AWeber Communications, Inc.
 All rights reserved.
 
 Redistribution and use in source and binary forms, with or without

data/README.textile

@@ -32,7 +32,11 @@ h4. Authorize an Account
 
 Open, what the following outputs, in a browser and use your AWeber account credentials. This will give your app permission to work with your account's data:
 
-bc. oauth.request_token.verification_url
+bc. oauth.request_token.authorize_url
+
+A callback url may also be passed by setting the :oauth_callback parameter:
+
+bc. oauth.request_token(:oauth_callback => 'http://www.example.com').authorize_url
 
 h4. Verification Code
 
@@ -44,7 +48,25 @@ h4. Grab an AWeber::Base
 
 bc. aweber = AWeber::Base.new(oauth)
 
-This object is how you access data from your account. @aweber.account@ is your account object which is the stem for all other resources. Take a look at the next section, "Usage", to find out how to work with different resources.
+This object is how you access data from your account. @aweber.account@ is your account object which is the stem for all other resources.
+
+h4. What if I don't want to verify every time?
+
+After verifying once, the @oauth@ object contains an @oauth.access_token.token@ and and @oauth.access_token.secret@ which may be used to authorize your application without having to verify via url:
+
+bc. ...
+oauth.authorize_with_verifier('verification_code')
+puts 'Access token: ' + oauth.access_token.token
+puts 'Access token secret: ' + oauth.access_token.secret
+
+The token and secret can then be saved, and authorization can be performed as follows:
+
+bc. require 'aweber'
+oauth = AWeber::OAuth.new('consumer_key', 'consumer_secret')
+#Rather than authorizing with the verification code, we use the token and secret
+oauth.authorize_with_access(YOUR_ACCESS_TOKEN, YOUR_ACCESS_TOKEN_SECRET)
+aweber = AWeber::Base.new(oauth)
+
 
 h2. Usage
 
@@ -53,7 +75,7 @@ h3. Resource Traversal
 Getting resource data is much like traversing associations in ActiveRecord. Everything starts with the @account@ object and goes from there:
 
 bc.. aweber.account.lists           #=> #<AWeber::Collection>
-aweber.account.lists[123]      #=> #<AWeber::Resource::List>
+aweber.account.lists[123]      #=> #<AWeber::Resource::List>     #123 represents the list id
 aweber.account.lists[123].name #=> "WhateverList"
 
 h3. Collections
@@ -72,6 +94,10 @@ Resources are elements of a Collection. A single list resource would be retrieve
 
 bc. aweber.account.lists[1234]
 
+h3. Why can't I access the subscriber data?
+
+If you are unable to access the data associated with your subscribers, it is likely that you have not enabled subscriber access permissions for your application. To do so, follow the directions at: https://labs.aweber.com/docs/permissions. These changes won't take effect until you renew your access tokens.
+
 h2. Updating Resources
 
 Currently, subscribers are the only resource you can update via the API. Everything else is read only for the time being.
@@ -97,6 +123,14 @@ bc. subscriber = account.lists[654321].subscribers[123456]
 subscriber.name = "New Name"
 subscriber.save
 
+h2. Adding Subscribers
+
+bc. new_subscriber = {}
+new_subscriber["email"] = "fake@example.com"
+new_subscriber["name"] = "My New Subscriber"
+aweber.account.lists.find_by_name("mylistname").subscribers.create(new_subscriber)]
+#Or alternatively: aweber.account.lists[list_id].subscribers.create(new_subscriber)]
+
 h2. Note on Patches/Pull Requests
  
 * Check out the latest master to make sure the feature hasn't been implemented or the bug hasn't been fixed yet
@@ -109,4 +143,4 @@ h2. Note on Patches/Pull Requests
 
 h2. Copyright
 
-Copyright (c) 2010-2011 AWeber Communications, Inc. See LICENSE for more detail.
+Copyright (c) 2010-2012 AWeber Communications, Inc. See LICENSE for more detail.

data/aweber.gemspec

@@ -1,7 +1,7 @@
 # -*- encoding: utf-8 -*-
 Gem::Specification.new do |s|
   s.name         = "aweber"
-  s.version      = "1.3.1"
+  s.version      = "1.4.0"
   s.platform     = Gem::Platform::RUBY
   s.summary      = "Ruby interface to AWeber's API"
   s.description  = "Ruby interface to AWeber's API"
@@ -17,10 +17,10 @@ Gem::Specification.new do |s|
   s.extra_rdoc_files = ["LICENSE", "README.textile"]
 
   s.add_dependency "oauth"
-  s.add_dependency "json_pure"
+  s.add_dependency "json"
   
   s.add_development_dependency "fakeweb"
-  s.add_development_dependency "rspec", "~> 2.1.0"
+  s.add_development_dependency "rspec", "~> 2.11.0"
   s.add_development_dependency "yard",  "~> 0.6.0"
 end
 

data/lib/aweber/collection.rb

@@ -62,13 +62,12 @@ module AWeber
     def create(attrs={})
       params   = attrs.merge("ws.op" => "create")
       response = client.post(path, params)
-      
+
       return false unless response.is_a? Net::HTTPCreated
-      
-      response = JSON.parse(response.body)
+
       resource = get(response["location"]).merge(:parent => self)
       resource = @klass.new(client, resource)
-      
+
       self[resource.id] = resource
     end
 
@@ -144,4 +143,4 @@ module AWeber
     end
 
   end
-end
+end

data/lib/aweber/oauth.rb

@@ -4,12 +4,9 @@ module AWeber
 
     def_delegators :access_token, :get, :post, :put, :delete
 
-    attr_accessor :callback_url
-
     def initialize(consumer_token, consumer_secret, options={})
       @consumer_token  = consumer_token
       @consumer_secret = consumer_secret
-      @callback_url    = options[:callback_url]
     end
 
     def consumer
@@ -66,4 +63,4 @@ module AWeber
       @access_token  = nil
     end
   end
-end
+end

data/spec/oauth_spec.rb

@@ -45,11 +45,6 @@ describe AWeber::OAuth do
     aweber.request_token.should == rtoken
   end
   
-  it "should set the callback url" do
-    oauth = AWeber::OAuth.new('token', 'secret', :callback_url => "http://example.com")
-    oauth.callback_url.should == "http://example.com"
-  end
-  
   it "should be able to authorize with a verifier code" do
     consumer = double('oauth consumer')
     rtoken   = double('request token')

data/spec/spec_helper.rb

@@ -55,5 +55,5 @@ route :get, %r[/accounts/\d+/lists/\d+/campaigns/[\d\w]+/messages\?], fixture("m
 route :get, %r[/accounts/\d+/lists/\d+/campaigns/[\d\w]+/messages/\d+/opens\?], fixture("opens.json")
 route :get, %r[/accounts/\d+/lists/\d+/campaigns/[\d\w]+/messages/\d+/tracked_events\?], fixture("tracked_events.json")
 
-route :post, %r[/accounts/\d+/lists\?], %[{"location":"https://api.aweber.com/1.0/accounts/1/lists/1550679"}], :status => ["201", "Created"]
-route :post, %r[/accounts/\d+/lists/\d+/subscribers/\d+], "201 Created", :status => ["201", "Created"]
+route :post, %r[/accounts/\d+/lists\?], '', :location => 'https://api.aweber.com/1.0/accounts/1/lists/1550679', :status => ["201", "Created"]
+route :post, %r[/accounts/\d+/lists/\d+/subscribers/\d+], "201 Created", :status => ["201", "Created"]

metadata

@@ -1,101 +1,104 @@
---- !ruby/object:Gem::Specification 
+--- !ruby/object:Gem::Specification
 name: aweber
-version: !ruby/object:Gem::Version 
-  prerelease: false
-  segments: 
-  - 1
-  - 3
-  - 1
-  version: 1.3.1
+version: !ruby/object:Gem::Version
+  version: 1.4.0
+  prerelease: 
 platform: ruby
-authors: 
+authors:
 - AWeber Communications, Inc.
 autorequire: 
 bindir: bin
 cert_chain: []
-
-date: 2011-04-16 00:00:00 -04:00
-default_executable: 
-dependencies: 
-- !ruby/object:Gem::Dependency 
+date: 2012-08-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
   name: oauth
-  prerelease: false
-  requirement: &id001 !ruby/object:Gem::Requirement 
+  requirement: !ruby/object:Gem::Requirement
     none: false
-    requirements: 
-    - - ">="
-      - !ruby/object:Gem::Version 
-        segments: 
-        - 0
-        version: "0"
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
   type: :runtime
-  version_requirements: *id001
-- !ruby/object:Gem::Dependency 
-  name: json_pure
   prerelease: false
-  requirement: &id002 !ruby/object:Gem::Requirement 
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: json
+  requirement: !ruby/object:Gem::Requirement
     none: false
-    requirements: 
-    - - ">="
-      - !ruby/object:Gem::Version 
-        segments: 
-        - 0
-        version: "0"
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
   type: :runtime
-  version_requirements: *id002
-- !ruby/object:Gem::Dependency 
-  name: fakeweb
   prerelease: false
-  requirement: &id003 !ruby/object:Gem::Requirement 
+  version_requirements: !ruby/object:Gem::Requirement
     none: false
-    requirements: 
-    - - ">="
-      - !ruby/object:Gem::Version 
-        segments: 
-        - 0
-        version: "0"
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: fakeweb
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
   type: :development
-  version_requirements: *id003
-- !ruby/object:Gem::Dependency 
-  name: rspec
   prerelease: false
-  requirement: &id004 !ruby/object:Gem::Requirement 
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
     none: false
-    requirements: 
+    requirements:
     - - ~>
-      - !ruby/object:Gem::Version 
-        segments: 
-        - 2
-        - 1
-        - 0
-        version: 2.1.0
+      - !ruby/object:Gem::Version
+        version: 2.11.0
   type: :development
-  version_requirements: *id004
-- !ruby/object:Gem::Dependency 
-  name: yard
   prerelease: false
-  requirement: &id005 !ruby/object:Gem::Requirement 
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 2.11.0
+- !ruby/object:Gem::Dependency
+  name: yard
+  requirement: !ruby/object:Gem::Requirement
     none: false
-    requirements: 
+    requirements:
     - - ~>
-      - !ruby/object:Gem::Version 
-        segments: 
-        - 0
-        - 6
-        - 0
+      - !ruby/object:Gem::Version
         version: 0.6.0
   type: :development
-  version_requirements: *id005
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.6.0
 description: Ruby interface to AWeber's API
 email: help@aweber.com
 executables: []
-
 extensions: []
-
-extra_rdoc_files: 
+extra_rdoc_files:
 - LICENSE
 - README.textile
-files: 
+files:
 - .document
 - .gitignore
 - Gemfile
@@ -175,39 +178,31 @@ files:
 - spec/resources/web_form_split_test_spec.rb
 - spec/spec_helper.rb
 - spec/support/fake_classes.rb
-has_rdoc: true
 homepage: http://github.com/aweber/AWeber-API-Ruby-Library
 licenses: []
-
 post_install_message: 
 rdoc_options: []
-
-require_paths: 
+require_paths:
 - lib
-required_ruby_version: !ruby/object:Gem::Requirement 
+required_ruby_version: !ruby/object:Gem::Requirement
   none: false
-  requirements: 
-  - - ">="
-    - !ruby/object:Gem::Version 
-      segments: 
-      - 0
-      version: "0"
-required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
-  requirements: 
-  - - ">="
-    - !ruby/object:Gem::Version 
-      segments: 
-      - 0
-      version: "0"
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
 requirements: []
-
 rubyforge_project: 
-rubygems_version: 1.3.7
+rubygems_version: 1.8.24
 signing_key: 
 specification_version: 3
 summary: Ruby interface to AWeber's API
-test_files: 
+test_files:
 - spec/base_spec.rb
 - spec/collection_spec.rb
 - spec/fixtures/account.json