google_apps 0.5 → 0.9

data/spec/credentials.example.yaml

@@ -0,0 +1,2 @@
+username: you@example.com
+password: myF4ncyP4assword

data/spec/fixture_xml/mes_attr.xml

@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<atom:entry xmlns:atom="http://www.w3.org/2005/Atom" xmlns:apps="http://schemas.google.com/apps/2006">
+  <category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/apps/2006#mailItem"/>
+  <atom:content xmlns:atom="http://www.w3.org/2005/Atom" type="message/rfc822"/>
+  <apps:label labelName="test"/>
+  <apps:label labelName="label"/>
+  <apps:mailItemProperty value="Inbox"/>
+</atom:entry>

data/spec/fixture_xml/test_doc.xml

@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<atom:entry xmlns:atom="http://www.w3.org/2005/Atom" xmlns:apps="http://schemas.google.com/apps/2006" xmlns:gd="http://schemas.google.com/g/2005">
+  <title type="text">Users</title>
+  <apps:property name="memberId" value="lholcomb2@cnm.edu"/>
+</atom:entry>

data/spec/fixture_xml/user.xml

@@ -0,0 +1,5 @@
+<atom:entry xmlns:atom="http://www.w3.org/2005/Atom" xmlns:apps="http://schemas.google.com/apps/2006">
+  <atom:category scheme="http://schemas.google.com/g/2005#kind" term="http://schemas.google.com/apps/2006#user"/>
+  <apps:login userName="lholcomb2" suspended="false"/>
+  <apps:name familyName="Holcomb" givenName="Lawrence"/>
+</atom:entry>

data/spec/fixture_xml/users_feed.xml

@@ -0,0 +1,49 @@
+<?xml version='1.0' encoding='UTF-8'?>
+<feed xmlns='http://www.w3.org/2005/Atom' xmlns:openSearch='http://a9.com/-/spec/opensearchrss/1.0/'
+      xmlns:apps='http://schemas.google.com/apps/2006' xmlns:gd='http://schemas.google.com/g/2005'>
+  <id>https://apps-apis.google.com/a/feeds/loopb.ac/user/2.0</id>
+  <updated>1970-01-01T00:00:00.000Z</updated>
+  <category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/>
+  <title type='text'>Users</title>
+  <link rel='http://schemas.google.com/g/2005#feed' type='application/atom+xml'
+        href='https://apps-apis.google.com/a/feeds/loopb.ac/user/2.0'/>
+  <link rel='http://schemas.google.com/g/2005#post' type='application/atom+xml'
+        href='https://apps-apis.google.com/a/feeds/loopb.ac/user/2.0'/>
+  <link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/loopb.ac/user/2.0'/>
+  <link rel='next' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/cnm.edu/user/2.0?startUsername=aadams37'/>
+  <openSearch:startIndex>1</openSearch:startIndex>
+  <entry>
+    <id>https://apps-apis.google.com/a/feeds/loopb.ac/user/2.0/misterunfriendly</id>
+    <updated>1970-01-01T00:00:00.000Z</updated>
+    <category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/>
+    <title type='text'>misterunfriendly</title>
+    <link rel='self' type='application/atom+xml'
+          href='https://apps-apis.google.com/a/feeds/loopb.ac/user/2.0/misterunfriendly'/>
+    <link rel='edit' type='application/atom+xml'
+          href='https://apps-apis.google.com/a/feeds/loopb.ac/user/2.0/misterunfriendly'/>
+    <apps:login userName='misterunfriendly' suspended='false' ipWhitelisted='false' admin='false'
+                changePasswordAtNextLogin='true' agreedToTerms='true'/>
+    <apps:quota limit='25600'/>
+    <apps:name familyName='Unfriendly' givenName='Mister'/>
+    <gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames'
+                 href='https://apps-apis.google.com/a/feeds/loopb.ac/nickname/2.0?username=misterunfriendly'/>
+    <gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists'
+                 href='https://apps-apis.google.com/a/feeds/loopb.ac/emailList/2.0?recipient=misterunfriendly%40loopb.ac'/>
+  </entry>
+  <entry>
+    <id>https://apps-apis.google.com/a/feeds/loopb.ac/user/2.0/will</id>
+    <updated>1970-01-01T00:00:00.000Z</updated>
+    <category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/apps/2006#user'/>
+    <title type='text'>will</title>
+    <link rel='self' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/loopb.ac/user/2.0/will'/>
+    <link rel='edit' type='application/atom+xml' href='https://apps-apis.google.com/a/feeds/loopb.ac/user/2.0/will'/>
+    <apps:login userName='will' suspended='false' ipWhitelisted='false' admin='true' changePasswordAtNextLogin='false'
+                agreedToTerms='true'/>
+    <apps:quota limit='25600'/>
+    <apps:name familyName='Read' givenName='Will'/>
+    <gd:feedLink rel='http://schemas.google.com/apps/2006#user.nicknames'
+                 href='https://apps-apis.google.com/a/feeds/loopb.ac/nickname/2.0?username=will'/>
+    <gd:feedLink rel='http://schemas.google.com/apps/2006#user.emailLists'
+                 href='https://apps-apis.google.com/a/feeds/loopb.ac/emailList/2.0?recipient=will%40loopb.ac'/>
+  </entry>
+</feed>

data/spec/google_apps/apps_request_spec.rb

@@ -0,0 +1,81 @@
+require 'spec_helper'
+
+describe GoogleApps::AppsRequest do
+  let (:request) { GoogleApps::AppsRequest.new :get, 'http://www.google.com', [['test', 'bob']] }
+
+  describe "#send_request" do
+    it "Sends the request as configured" do
+      stub_request(:get, "http://www.google.com/").
+          with(:headers => {'Test' => 'bob'}).
+          to_return(:status => 200)
+      request.send_request.should be_a Net::HTTPResponse
+    end
+
+    context "when the token is expired" do
+      xit "gets a new token and re-issues the request" do
+        stub_request(:get, "http://www.google.com/").
+            to_return(:status => 401)
+        transporter.get_user
+        body = <<-TEXT.strip!
+        client_id=#{transporter.client_id}&
+        client_secret=#{transporter.client_secret}&
+        refresh_token=#{transporter.refresh_token}&
+        grant_type=refresh_token
+        TEXT
+        a_request(:post, "https://accounts.google.com/o/oauth2/token").
+            with(body: body).should have_been_made
+      end
+    end
+  end
+
+  describe "#add_body" do
+    it "Adds the specified content to the request body" do
+      request.add_body 'test'
+
+      request.instance_eval { @http_request.body }.should == 'test'
+    end
+  end
+
+  describe "#initialize_http" do
+    before(:all) do
+      @get = build_request :get
+      @put = build_request :put
+      @post = build_request :post
+      @delete = build_request :delete
+    end
+
+    it "Creates a Net::HTTP::Get object when passed 'get'" do
+      @get.instance_eval { @http_request }.should be_a Net::HTTP::Get
+    end
+
+    it "Creates a Net::HTTP::Put object when passed 'put'" do
+      @put.instance_eval { @http_request }.should be_a Net::HTTP::Put
+    end
+
+    it "Creates a Net::HTTP::Post object when passed 'post'" do
+      @post.instance_eval { @http_request }.should be_a Net::HTTP::Post
+    end
+
+    it "Creates a Net::HTTP::Delete object when passed 'delete'" do
+      @delete.instance_eval { @http_request }.should be_a Net::HTTP::Delete
+    end
+
+    it "Sets the uri according to the given argument" do
+      request.instance_eval { @uri.host }.should == 'www.google.com'
+    end
+  end
+
+  describe "#build_constant" do
+    it "Takes the given verb and returns the namespaced constant for that type of HTTP class" do
+      request.send(:build_constant, :put).to_s.should == 'Net::HTTP::Put'
+    end
+  end
+
+  describe "#set_headers" do
+    it "Sets the headers on @http_request" do
+      request.send(:set_headers, [['content-type', 'application/x-www-form-urlencoded']])
+
+      request.instance_eval { @http_request['content-type'] }.should == 'application/x-www-form-urlencoded'
+    end
+  end
+end

data/spec/google_apps/atom/document_spec.rb

@@ -0,0 +1,74 @@
+require 'spec_helper'
+
+describe "GoogleApps::Atom::Document" do
+  let (:document) { GoogleApps::Atom::Document.new File.read('spec/fixture_xml/user.xml') }
+  let (:doc_string) { File.read('spec/fixture_xml/test_doc.xml') }
+
+  describe "#parse" do
+    it "parses the given XML document" do
+      document.parse(doc_string).should be_a LibXML::XML::Document
+    end
+  end
+
+  describe "#make_document" do
+    it "turns the input into an LibXML::XML::Document" do
+      document.make_document(doc_string).should be_a LibXML::XML::Document
+    end
+  end
+
+  describe "#new_empty_doc" do
+    it "Returns a new empty LibXML::XML::Document" do
+      new_doc = document.new_empty_doc
+
+      new_doc.should be_a LibXML::XML::Document
+      new_doc.to_s.strip.should == '<?xml version="1.0" encoding="UTF-8"?>'
+    end
+  end
+
+  describe "#find_and_update" do
+    it "Finds the specified node and updates the specified attributes" do
+      document.find_and_update('//apps:login', userName: ['lholcomb2', 'new'], suspended: ['false', 'senior'])
+
+      document.instance_eval { @doc }.find('//apps:login').first.attributes['userName'].should == 'new'
+      document.instance_eval { @doc }.find('//apps:login').first.attributes['suspended'].should == 'senior'
+    end
+  end
+
+  describe "#build_root" do
+    before(:all) do
+      @root = document.build_root :user
+    end
+
+    it "Builds an atom:entry XML Node with the appropriate namespaces" do
+      @root.to_s.should include 'xmlns:atom'
+      @root.to_s.should include 'xmlns:apps'
+    end
+
+    it "Builds an atom:entry XML Node containing a category element" do
+      @root.to_s.should include 'apps:category'
+    end
+
+    it "Builds an atom:entry XML Node containing a category element of the right kind" do
+      @root.to_s.should include '2006#user'
+    end
+  end
+
+  describe "#determine_namespaces" do
+    it "Builds a hash of the appropriate namespaces" do
+      ns = document.determine_namespaces(:user)
+
+      ns[:atom].should == GoogleApps::Atom::NAMESPACES[:atom]
+      ns[:apps].should == GoogleApps::Atom::NAMESPACES[:apps]
+    end
+  end
+
+  describe "#delete_node" do
+    it "Deletes the specified node from the document"
+  end
+
+  describe "#to_s" do
+    it "Outputs @doc as a string" do
+      document.to_s.should be_a String
+    end
+  end
+end

data/spec/google_apps/atom/export_spec.rb

@@ -0,0 +1,70 @@
+require 'spec_helper'
+
+describe "GoogleApps::Atom::Export" do
+  let (:export) { GoogleApps::Atom::Export.new }
+  let (:start) { '2012-2-20 00:00' }
+  let (:finish) { '2012-2-22 00:00' }
+  let (:query) { 'from:webmaster' }
+  let (:content) { 'HEADER_ONLY' }
+
+  describe "#new" do
+    it "should initialize @doc to an XML::Document" do
+      export.instance_eval { @doc }.should be_a LibXML::XML::Document
+    end
+  end
+
+  describe "#to_s" do
+    it "should return @doc as a String" do
+      export.to_s.should be_a String
+    end
+  end
+
+  describe "#add_prop" do
+    it "should add a property with the given name and value to the document" do
+      export.send :add_prop, 'food', 'bacon'
+
+      export.to_s.should include 'name="food"'
+      export.to_s.should include 'value="bacon"'
+    end
+  end
+
+  describe "#start_date" do
+    it "should add a beginDate property to the export document" do
+      export.start_date start
+
+      export.to_s.should include 'name="beginDate"'
+    end
+  end
+
+  describe "#end_date" do
+    it "should add an endDate property to the export document" do
+      export.end_date finish
+
+      export.to_s.should include 'name="endDate"'
+    end
+  end
+
+  describe "#include_deleted" do
+    it "should add an includeDeleted property to the document" do
+      export.include_deleted
+
+      export.to_s.should include 'name="includeDeleted"'
+    end
+  end
+
+  describe "#query" do
+    it "should add a searchQuery property to the document" do
+      export.query query
+
+      export.to_s.should include 'name="searchQuery"'
+    end
+  end
+
+  describe "#content" do
+    it "should add a packageContent property to the document" do
+      export.content content
+
+      export.to_s.should include 'name="packageContent"'
+    end
+  end
+end

data/spec/google_apps/atom/feed_spec.rb

@@ -0,0 +1,93 @@
+require 'spec_helper'
+
+describe "GoogleApps::Atom::Feed" do
+  let (:xml) { File.read('spec/fixture_xml/users_feed.xml') }
+  let (:next_page) { 'https://apps-apis.google.com/a/feeds/cnm.edu/user/2.0?startUsername=aadams37' }
+  let (:feed) { GoogleApps::Atom::Feed.new(xml) }
+  let (:content_array) { ['<apps:login userId="Mom"/>', '<apps:quota value="80"/>', '<id/>', '<atom:category/>'] }
+
+  describe "#new" do
+    it "Parses the given xml" do
+      feed.doc.should be_a LibXML::XML::Document
+    end
+
+    it "Populates @items with Atom objects of the proper type" do
+      feed.items.first.should be_a GoogleApps::Atom::User
+    end
+  end
+
+  describe "#next_page" do
+    it "Sets the url for the next page in the feed" do
+      feed.next_page.should == next_page
+    end
+  end
+
+  describe "#entries_from" do
+    it "Builds an array of Atom objects" do # We have a bad regex somewhere, User doesn't work as an argument
+      results = feed.entries_from document: feed.doc, type: 'user', entry_tag: 'entry'
+
+      results.first.should be_a GoogleApps::Atom::User
+    end
+  end
+
+  describe "#new_doc" do
+    it "Returns a new Atom Document with the desired elements" do
+      doc = feed.new_doc 'user', content_array, ['apps:']
+
+      doc.to_s.should include '<apps:login'
+      doc.to_s.should include '<apps:quota'
+      doc.to_s.should_not include '<gd:category'
+    end
+
+    it "Returns a new Atom Document with the desired elements when given multiple filters" do
+      doc = feed.new_doc 'user', content_array, ['apps:', 'atom:']
+
+      doc.to_s.should include '<apps:login'
+      doc.to_s.should include '<atom:category'
+      doc.to_s.should_not include '<id'
+    end
+  end
+
+  describe "#add_category" do
+    it "Adds an atom:category node to the front of the content_array" do
+      content = feed.add_category(content_array, 'user').join("\n")
+
+      content.should include '<atom:category'
+      content.should include '#user'
+    end
+  end
+
+  describe "#entry_wrap" do
+    it "Wraps the given content in an apps:entry element" do
+      entry = feed.entry_wrap(["bob"]).join("\n")
+
+      entry.should include "<atom:entry xmlns:atom"
+      entry.should include "bob"
+      entry.should include "</atom:entry>"
+    end
+  end
+
+  describe "#node_to_ary" do
+    it "Returns the content of a node as an array" do
+      content = feed.node_to_ary(entry_node)
+
+      content.should be_an Array
+    end
+  end
+
+  describe "#grab_elements" do
+    it "Grabs all elements from the content array matching the filter" do
+      matches = feed.grab_elements(content_array, 'apps:')
+
+      matches.each do |match|
+        match.should include 'apps:'
+      end
+    end
+  end
+
+  describe "#determine_type" do
+    it "Returns snake cased document type from feed id" do
+      feed.determine_type(xml).should == 'user'
+    end
+  end
+end

data/spec/google_apps/atom/group_member_spec.rb

@@ -0,0 +1,49 @@
+require 'spec_helper'
+
+describe "GoogleApps::Atom::GroupMember" do
+  let (:member) { GoogleApps::Atom::GroupMember.new }
+
+  describe "#new" do
+    it "initializes document as an empty Atom XML Document" do
+      member.instance_eval { @doc }.should be_a LibXML::XML::Document
+    end
+
+    it "sets the header for @doc" do
+      member.instance_eval { @doc.root.to_s.strip }.should == basic_header
+    end
+  end
+
+  describe "#member=" do
+    it "sets the value for the member being added" do
+      member.member = 'Bob'
+
+      member.member.should == 'Bob'
+    end
+
+    it "changes the value for @member if @member is already set" do
+      member.member = 'Tom'
+      member.member = 'Bill'
+
+      member.member.should == 'Bill'
+      member.to_s.should include 'Bill'
+      member.to_s.should_not include 'Tom'
+    end
+  end
+
+  describe "#change_member" do
+    it "changes the XML Node for the memberId" do
+      member.member = 'Tom'
+      member.member = 'Bill'
+
+      member.instance_eval { @doc.root.child.attributes['value'] }.should == 'Bill'
+    end
+  end
+
+  describe "#to_s" do
+    it "returns @document as a string" do
+      member.member = 'Tom'
+
+      member.to_s.should == member.instance_eval { @doc.to_s }
+    end
+  end
+end