nylas 0.17.4 → 0.18.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: d061cfce1862deebf40819ca03388c5b0cd3ea13
-  data.tar.gz: 753000eaca905c146cbfcd635096cf0c5116fe73
+  metadata.gz: f7c3e5a043311ee67a943f921c0589294fec6371
+  data.tar.gz: f1864ea6369f9f045fdcf56f545a4a8d7cea926a
 SHA512:
-  metadata.gz: 751f373175171a2d5e49edfcbdfbbf14edd251e5bb79c40e43a054c37b52c566b127a144b350328adf36f118d21943580ba0bb7e5442e5682a07a2478ba8d524
-  data.tar.gz: 00f5943bc9cf5b72a9d088a43e07b40523868ce5938e943bc873f80894ce2f17e3a7e4d7fc176e1a6e83b4c94ccb28db2df42301f724d97ed4d453097c299af4
+  metadata.gz: ad63f75f2368884bd1eb62b3fce3672c72629b41a7153f58c8b3d9c451ce37864c02472648ab30d463165584d07cd37d0d2d29c540c7bec16fdada80861c5fe9
+  data.tar.gz: d62061c5dbcf67094309f95cdb7568ec1649ef58fa4d6cac9266d35c24187878664b506d83b733a5d9b70a116cc299a123e29beac1fd78244329242e092eccdf

data/README.md

@@ -173,11 +173,24 @@ thread.mark_as_read!
 # Archive
 thread.archive!
 
-# Add or remove arbitrary tags
+# Add or remove arbitrary tags (DEPRECATED --- you should use the new labels and folders API)
 tagsToAdd = ['inbox', 'cfa1233ef123acd12']
 tagsToRemove = []
 thread.update_tags!(tagsToAdd, tagsToRemove)
 
+# Add a new label to a message
+
+important = nil
+ns.labels.each do |label|
+  if label.display_name == 'Important'
+    important = label
+  end
+end
+
+thread = ns.threads.where(:from => "helena@nylas.com").first
+thread.labels.push(important)
+thread.save!
+
 # List messages
 thread.messages.each do |message|
   puts message.subject
@@ -198,6 +211,37 @@ file = namespace.files.build(:file => File.new("./public/favicon.ico", 'rb'))
 file.save!
 ```
 
+### Working with Labels/Folder
+
+The new folders and labels API replaces the now deprecated Tags API. It allows you to apply Gmail labels to whole threads or individual messages and, for providers other than Gmail, to move threads and messages between folders.
+
+```ruby
+
+# List labels
+namespace.labels.each do |label|
+  puts label.display_name, label.id
+end
+
+# Create a label
+label = ns.folders.build(:display_name => 'Test label', :name => 'test name')
+label.save!
+
+# Create a folder
+#
+# Note that Folders and Labels are absolutely identical from the standpoint of the SDK.
+# The only difference is that a message can have many labels but only a single folder.
+fld = ns.folders.build(:display_name => 'Test folder', :name => 'test name')
+fld.save!
+
+# Rename a folder
+#
+# Note that you can not rename folders like INBOX, Trash, etc.
+fld = ns.folders.first
+fld.display_name = 'Renamed folder'
+fld.save!
+
+```
+
 ### Working with Messages, Contacts, etc.
 
 Each of the primary collections (contacts, messages, etc.) behave the same way as `threads`. For example, finding messages with a filter is similar to finding threads:
@@ -255,6 +299,13 @@ new_event.when = {:start_time => 1407542195, :end_time => 1407543195}
 
 # Persist the event --- it's automatically synced back to the Google or Exchange calendar
 new_event.save!
+
+# Send an invite/update message to the participants
+new_event.save!(:notify_participants => true)
+
+# RSVP to an invite (Note: this only works for the events in the 'Emailed events' calendar)
+# possible statuses are 'yes', 'no' and 'maybe'.
+emailed_invite.rsvp!(status='yes', comment='I will come')
 ```
 
 ## Using the Delta sync API

data/lib/api_thread.rb

@@ -11,9 +11,31 @@ module Inbox
     parameter :tags
     parameter :message_ids
     parameter :draft_ids
+    parameter :labels
+    parameter :folder
     time_attr_accessor :last_message_timestamp
     time_attr_accessor :first_message_timestamp
 
+    def inflate(json)
+      super
+      @labels ||= []
+      @folder ||= nil
+
+      # This is a special case --- we receive label data from the API
+      # as JSON but we want it to behave like an API object.
+      @labels.map! do |label_json|
+       label = Label.new(@_api)
+       label.inflate(label_json)
+       label
+      end
+
+      if not folder.nil?
+       folder = folder.new(@_api)
+       folder.inflate(@folder)
+       @folder = folder
+      end
+    end
+
     def messages
       @messages ||= RestfulModelCollection.new(Message, @_api, @namespace_id, {:thread_id=>@id})
     end
@@ -52,5 +74,22 @@ module Inbox
     def unstar!
       update_tags!([], ['starred'])
     end
+
+    def as_json(options = {})
+      hash = {}
+
+      if not @labels.nil? and @labels != []
+        hash["labels"] = @labels.map do |label|
+          label.id
+        end
+      end
+
+      if not @folder.nil?
+        hash["folder"] = @folder.id
+      end
+
+      hash
+    end
+
   end
-end
+end

data/lib/event.rb

@@ -30,5 +30,18 @@ module Inbox
       return hash
     end
 
+    def rsvp!(status, comment)
+      url = @_api.url_for_path("/n/#{@namespace_id}/send-rsvp")
+      data = {:event_id => @id, :status => status, :comment => comment}
+
+      ::RestClient.post(url, data.to_json, :content_type => :json) do |response, request, result|
+        json = Inbox.interpret_response(result, response, :expected_class => Object)
+        self.inflate(json)
+      end
+
+      self
+    end
+
+
   end
 end

data/lib/folder.rb

@@ -0,0 +1,12 @@
+require 'restful_model'
+
+module Inbox
+  class Folder < RestfulModel
+
+    parameter :display_name
+    parameter :name
+
+  end
+
+  Label = Folder.clone
+end

data/lib/inbox.rb

@@ -80,7 +80,7 @@ module Inbox
       if ::RestClient.before_execution_procs.empty?
         ::RestClient.add_before_execution_proc do |req, params|
           req.add_field('X-Inbox-API-Wrapper', 'ruby')
-          req['User-Agent'] = "Ruby SDK #{@version} - #{RUBY_VERSION}"
+          req['User-Agent'] = "Nylas Ruby SDK #{@version} - #{RUBY_VERSION}"
         end
       end
     end

data/lib/label.rb

@@ -0,0 +1,4 @@
+require 'folder'
+
+module Inbox
+end

data/lib/message.rb

@@ -15,12 +15,57 @@ module Inbox
     parameter :thread_id
     parameter :body
     parameter :unread
+    parameter :starred
+    parameter :folder
+    parameter :labels
 
     def inflate(json)
       super
       @to ||= []
       @cc ||= []
       @bcc ||= []
+      @labels ||= []
+      @folder ||= nil
+
+      # This is a special case --- we receive label data from the API
+      # as JSON but we want it to behave like an API object.
+      @labels.map! do |label_json|
+       label = Label.new(@_api)
+       label.inflate(label_json)
+       label
+      end
+
+      if not folder.nil?
+       folder = folder.new(@_api)
+       folder.inflate(@folder)
+       @folder = folder
+      end
+    end
+
+    def as_json(options = {})
+      hash = {}
+
+      # unread, starred and labels/folder are the only attribute
+      # you can modify.
+      if not @unread.nil?
+        hash["unread"] = @unread
+      end
+
+      if not @starred.nil?
+        hash["starred"] = @starred
+      end
+
+      if not @labels.nil? and @labels != []
+        hash["labels"] = @labels.map do |label|
+          label.id
+        end
+      end
+
+      if not @folder.nil?
+        hash["folder"] = @folder.id
+      end
+
+      hash
     end
 
     def files

data/lib/namespace.rb

@@ -7,6 +7,7 @@ require 'contact'
 require 'file'
 require 'calendar'
 require 'event'
+require 'folder'
 require 'yajl'
 require 'em-http'
 require 'ostruct'
@@ -62,6 +63,14 @@ module Inbox
       @events ||= RestfulModelCollection.new(Event, @_api, @id)
     end
 
+    def folders
+      @folders ||= RestfulModelCollection.new(Folder, @_api, @id)
+    end
+
+    def labels
+      @labels ||= RestfulModelCollection.new(Label, @_api, @id)
+    end
+
     def get_cursor(timestamp)
       # Get the cursor corresponding to a specific timestamp.
       path = @_api.url_for_path("/n/#{@namespace_id}/delta/generate_cursor")
@@ -88,6 +97,8 @@ module Inbox
       "message" => Inbox::Message,
       "namespace" => Inbox::Namespace,
       "tag" => Inbox::Tag,
+      "folder" => Inbox::Folder,
+      "label" => Inbox::Label,
     }
 
     def _build_exclude_types(exclude_types)

data/lib/nylas.rb

@@ -80,7 +80,7 @@ module Inbox
       if ::RestClient.before_execution_procs.empty?
         ::RestClient.add_before_execution_proc do |req, params|
           req.add_field('X-Inbox-API-Wrapper', 'ruby')
-          req['User-Agent'] = "Ruby SDK #{@version} - #{RUBY_VERSION}"
+          req['User-Agent'] = "Nylas Ruby SDK #{@version} - #{RUBY_VERSION}"
         end
       end
     end

data/lib/restful_model.rb

@@ -31,11 +31,11 @@ module Inbox
       end
     end
 
-    def save!
+    def save!(params={})
       if id
-        update('PUT', '', as_json())
+        update('PUT', '', as_json(), params)
       else
-        update('POST', '', as_json())
+        update('POST', '', as_json(), params)
       end
     end
 
@@ -58,10 +58,10 @@ module Inbox
       hash
     end
 
-    def update(http_method, action, data = {})
+    def update(http_method, action, data = {}, params = {})
       http_method = http_method.downcase
 
-      ::RestClient.send(http_method, self.url(action), data.to_json, :content_type => :json) do |response, request, result|
+      ::RestClient.send(http_method, self.url(action), data.to_json, :content_type => :json, :params => params) do |response, request, result|
         unless http_method == 'delete'
           json = Inbox.interpret_response(result, response, :expected_class => Object)
           inflate(json)

data/lib/version.rb

@@ -1,3 +1,3 @@
 module Inbox
-  VERSION = "0.17.4"
+  VERSION = "0.18.0"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: nylas
 version: !ruby/object:Gem::Version
-  version: 0.17.4
+  version: 0.18.0
 platform: ruby
 authors:
 - Ben Gotow
@@ -10,188 +10,188 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2015-07-23 00:00:00.000000000 Z
+date: 2015-07-25 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rest-client
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '1.7'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '1.7'
 - !ruby/object:Gem::Dependency
   name: yajl-ruby
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: '0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
   name: em-http-request
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: '0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
   name: rspec
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
   name: shoulda
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
   name: rdoc
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '3.12'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '3.12'
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: 1.3.5
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: 1.3.5
 - !ruby/object:Gem::Dependency
   name: jeweler
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: 1.8.4
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: 1.8.4
 - !ruby/object:Gem::Dependency
   name: pry
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
   name: pry-nav
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
   name: pry-stack_explorer
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
   name: webmock
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
   name: sinatra
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: '0'
 description: Gem for interacting with the Nylas API.
@@ -202,6 +202,8 @@ extra_rdoc_files:
 - LICENSE.txt
 - README.md
 files:
+- LICENSE.txt
+- README.md
 - lib/account.rb
 - lib/api_thread.rb
 - lib/calendar.rb
@@ -209,7 +211,9 @@ files:
 - lib/draft.rb
 - lib/event.rb
 - lib/file.rb
+- lib/folder.rb
 - lib/inbox.rb
+- lib/label.rb
 - lib/message.rb
 - lib/namespace.rb
 - lib/nylas.rb
@@ -220,8 +224,6 @@ files:
 - lib/tag.rb
 - lib/time_attr_accessor.rb
 - lib/version.rb
-- LICENSE.txt
-- README.md
 homepage: http://github.com/nylas/nylas-ruby
 licenses:
 - MIT
@@ -232,17 +234,17 @@ require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
-  - - '>='
+  - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
-  - - '>='
+  - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.0.14
+rubygems_version: 2.2.2
 signing_key: 
 specification_version: 4
 summary: Gem for interacting with the Nylas API