nylas 1.2.1 → 1.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 58db1f5a454d2d5e46fd1d98a38a5445fbc4fedf
-  data.tar.gz: d956107466fb9ff8900b3fa725904ae7cd48207a
+  metadata.gz: ce94f4eb8a8cbdc721ceea8db3c208c77f948ea3
+  data.tar.gz: 2c582674b75b99e96bfd94ecf8aae0d1ed749202
 SHA512:
-  metadata.gz: 9679436918c2dc6318096723605a59806102de7b9d87c365249782d6832e048e7831e710d818457cbaddd64e9d3b4542590d5a638e1f2646ce009dfac2cfc3db
-  data.tar.gz: ead866ffe64c3a2a2d9d8e656cbce576782573f16d2a0ac2fad2482b0126004b15ba34ed698e4035e03c5f8b7288dc5d92648d3c959fc98d18270a57edccfe03
+  metadata.gz: 1823490cc7c1b0e16b0dfe001d7f94490196fd5b213b93b3dc233278ac19cd6e3a48498a9e2b04532aa28897fd29c56013e8af997b889af61e1816af6ae01605
+  data.tar.gz: 0b3ad38237c4cf3e50f2f9d2c1943023baa9ae92ef7844544d0b0817d7f3cc874c2e90865752bc1e3e2c18cea2a86015935fbc7eba018716356d7d4c33d56a72

data/README.md

@@ -142,14 +142,14 @@ thread = nylas.threads.first
 # Fetch a specific thread
 thread = nylas.threads.find('ac123acd123ef123')
 
-# List all threads tagged `inbox`
+# List all threads in the inbox
 # (paginating 50 at a time until no more are returned.)
-nylas.threads.where(:tag => 'inbox').each do |thread|
+nylas.threads.where(:in => 'inbox').each do |thread|
   puts thread.subject
 end
 
 # List the 5 most recent unread threads
-nylas.threads.where(:tag => 'unread').range(0,4).each do |thread|
+nylas.threads.where(:unread => true).range(0,4).each do |thread|
   puts thread.subject
 end
 
@@ -180,23 +180,35 @@ end
 # Mark as read
 thread.mark_as_read!
 
-# Archive
-thread.archive!
+# Mark as unread
+thread.mark_as_unread!
 
-# Add or remove arbitrary tags (DEPRECATED --- you should use the new labels and folders API)
-tagsToAdd = ['inbox', 'cfa1233ef123acd12']
-tagsToRemove = []
-thread.update_tags!(tagsToAdd, tagsToRemove)
+# Star
+thread.star!
 
-# Add a new label to a message
+# Remove star
+thread.unstar!
 
+# Adding a new label to a thread
+
+# First, find the id of the important label.
+#
+# A note here: all labels have a display_name
+# property, which contains a label's name.
+# Some very specific labels (e.g: Inbox, Trash, etc.)
+# also have a name property, which is a canonical name
+# for the label. This is important because folder names
+# can change depending the user's locale (e.g: "Boîte de réception"
+# means "Inbox" in french). See https://nylas.com/docs/platform#labels
+# for more details.
 important = nil
 nylas.labels.each do |label|
-  if label.display_name == 'Important'
+  if label.name == 'important'
     important = label
   end
 end
 
+# Then, add it to the thread.
 thread = nylas.threads.where(:from => "helena@nylas.com").first
 thread.labels.push(important)
 thread.save!
@@ -257,7 +269,26 @@ fld.display_name = 'Renamed folder'
 fld.save!
 ```
 
-### Working with Messages, Contacts, etc.
+### Working with Messages
+
+```ruby
+puts msg.subject
+puts msg.from
+
+# Mark as read
+msg.mark_as_read!
+
+# Mark as unread
+msg.mark_as_unread!
+
+# Star
+msg.star!
+
+# Remove star
+msg.unstar!
+```
+
+### Working with API Objects
 
 #### Filtering
 
@@ -284,7 +315,7 @@ The `#where` method accepts a hash of filters, as documented in the [Filters Doc
 #### Enumerator methods
 
 Every object API object has an `each` method which returns an `Enumerator` if you don't pass it a block.
-This allows you to do leverage all that Ruby's `Enumerable` has to offer.
+This allows you to leverage all that Ruby's `Enumerable` has to offer.
 For example, this is the previous example rewritten to use an `Enumerator`:
 
 ```ruby

data/lib/api_thread.rb

@@ -1,5 +1,6 @@
 require 'restful_model'
 require 'time_attr_accessor'
+require 'mixins'
 
 module Inbox
   class Thread < RestfulModel
@@ -8,14 +9,18 @@ module Inbox
     parameter :subject
     parameter :participants
     parameter :snippet
-    parameter :tags
     parameter :message_ids
     parameter :draft_ids
     parameter :labels
     parameter :folder
+    parameter :starred
+    parameter :unread
+    parameter :has_attachments
     time_attr_accessor :last_message_timestamp
     time_attr_accessor :first_message_timestamp
 
+    include ReadUnreadMethods
+
     def inflate(json)
       super
       @labels ||= []
@@ -44,37 +49,6 @@ module Inbox
       @drafts ||= RestfulModelCollection.new(Draft, @_api, {:thread_id=>@id})
     end
 
-    def update_tags!(tags_to_add = [], tags_to_remove = [])
-      update('PUT', '', {
-        :add_tags => tags_to_add,
-        :remove_tags => tags_to_remove
-      })
-    end
-
-    def mark_as_read!
-      update_tags!([], ['unread'])
-    end
-
-    def mark_as_seen!
-      update_tags!([], ['unseen'])
-    end
-
-    def archive!
-      update_tags!(['archive'], ['inbox'])
-    end
-
-    def unarchive!
-      update_tags!(['inbox'], ['archive'])
-    end
-
-    def star!
-      update_tags!(['starred'], [''])
-    end
-
-    def unstar!
-      update_tags!([], ['starred'])
-    end
-
     def as_json(options = {})
       hash = {}
 

data/lib/inbox.rb

@@ -9,7 +9,6 @@ require 'api_account'
 require 'api_thread'
 require 'calendar'
 require 'account'
-require 'tag'
 require 'message'
 require 'draft'
 require 'contact'
@@ -149,10 +148,6 @@ module Inbox
       @threads ||= RestfulModelCollection.new(Thread, self)
     end
 
-    def tags
-      @tags ||= RestfulModelCollection.new(Tag, self)
-    end
-
     def messages
       @messages ||= RestfulModelCollection.new(Message, self)
     end
@@ -248,7 +243,6 @@ module Inbox
       "event" => Inbox::Event,
       "file" => Inbox::File,
       "message" => Inbox::Message,
-      "tag" => Inbox::Tag,
       "folder" => Inbox::Folder,
       "label" => Inbox::Label,
     }

data/lib/message.rb

@@ -1,5 +1,6 @@
 require 'restful_model'
 require 'file'
+require 'mixins'
 
 module Inbox
   class Message < RestfulModel
@@ -18,6 +19,8 @@ module Inbox
     parameter :folder
     parameter :labels
 
+    include Inbox::ReadUnreadMethods
+
     def inflate(json)
       super
       @to ||= []

data/lib/mixins.rb

@@ -0,0 +1,26 @@
+module Inbox
+  module ReadUnreadMethods
+    def update_param!(param, value)
+      update('PUT', '', {
+        param => value,
+      })
+    end
+
+    def mark_as_read!
+      update_param!(:unread, false)
+    end
+
+    def mark_as_unread!
+      update_param!(:unread, true)
+    end
+
+    def star!
+      update_param!(:starred, true)
+    end
+
+    def unstar!
+      update_param!(:starred, false)
+    end
+  end
+end
+

data/lib/nylas.rb

@@ -9,7 +9,6 @@ require 'api_account'
 require 'api_thread'
 require 'calendar'
 require 'account'
-require 'tag'
 require 'message'
 require 'draft'
 require 'contact'
@@ -149,10 +148,6 @@ module Inbox
       @threads ||= RestfulModelCollection.new(Thread, self)
     end
 
-    def tags
-      @tags ||= RestfulModelCollection.new(Tag, self)
-    end
-
     def messages
       @messages ||= RestfulModelCollection.new(Message, self)
     end
@@ -248,7 +243,6 @@ module Inbox
       "event" => Inbox::Event,
       "file" => Inbox::File,
       "message" => Inbox::Message,
-      "tag" => Inbox::Tag,
       "folder" => Inbox::Folder,
       "label" => Inbox::Label,
     }

data/lib/version.rb

@@ -1,3 +1,3 @@
 module Inbox
-  VERSION = "1.2.1"
+  VERSION = "1.3.0"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: nylas
 version: !ruby/object:Gem::Version
-  version: 1.2.1
+  version: 1.3.0
 platform: ruby
 authors:
 - Ben Gotow
@@ -10,7 +10,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2015-11-30 00:00:00.000000000 Z
+date: 2015-12-07 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rest-client
@@ -214,11 +214,11 @@ files:
 - lib/inbox.rb
 - lib/label.rb
 - lib/message.rb
+- lib/mixins.rb
 - lib/nylas.rb
 - lib/parameters.rb
 - lib/restful_model.rb
 - lib/restful_model_collection.rb
-- lib/tag.rb
 - lib/time_attr_accessor.rb
 - lib/version.rb
 - LICENSE.txt

data/lib/tag.rb

@@ -1,9 +0,0 @@
-require 'restful_model'
-
-module Inbox
-  class Tag < RestfulModel
-
-    parameter :name
-
-  end
-end