vmail 1.6.9 → 1.7.0

data/README.markdown

@@ -124,16 +124,6 @@ You can also pass in search parameters after specifying the mailbox:
 
     vmail important from barackobama@whitehouse.gov
 
-On startup, Vmail loads 100 messages by default. You can increase or decrease
-this number by passing in a number after the mailbox name:
-
-    vmail inbox 700 subject unix
-
-Passing in 0 as the number of messages returns all messages that match
-the query:
-
-    vmail inbox 0 subject unix # => returns all matching messages
-
 ## Viewing messages
 
 The first screen Vmail shows you is a list of messages. You can view a message
@@ -161,13 +151,13 @@ You can use `<C-k>` or `,k` to show the previous message.
 
 Vmail loads a certain number messages at a time, starting with the most recent.
 If there are more messages that Vmail hasn't loaded, you'll see a line at the
-top of the list that looks something like this:
+bottom of the list that looks something like this:
 
     > Load 100 more messages. 156 remaining.
 
 Put the cursor on this line and press ENTER to load more of these messages.
 
-Tip: To go straight to the top line and load more messages, type `gg<ENTER>`.
+Tip: To go straight to the bottom line and load more messages, type `G<ENTER>`.
 
 Unread messages are marked with a `+` symbol.
 
@@ -307,7 +297,7 @@ The current version of Vmail can handle attachments to a certain extent.
 When you're viewing a message with attachments, you'll see something like this
 at the top of the message window:
 
-    INBOX 2113 4 kb
+    4 kb
     - image/png; name=canada.png
     - image/gif; name=arrow_right.gif
     ---------------------------------------
@@ -378,13 +368,12 @@ split window.
 
 Vmail can generate a message list by performing an IMAP search on the current mailbox.
 From the message list window, type `,s`. This will prompt you for a search query. 
-The search query is an optional number specifying the number of messages to return, 
-followed by a valid IMAP search query.
+The search query should be a valid IMAP search query.
 
 Here are some example search queries.
 
     # the default 
-    100 all  
+    all  
 
     # all messages from thematrix.com domain
     from thematrix.com  
@@ -428,7 +417,7 @@ automated scripts.
 If you redirect Vmail's output from STDOUT to a file or a program, Vmail will
 output the message list resulting from a search query to a file.
 
-    vmail inbox 100 from monit > message-list.txt 
+    vmail inbox from monit > message-list.txt 
 
 You can open this file in any text editor to make sure that the search
 query produced the expected result. Then you can perform the following

data/lib/vmail/helpers.rb

@@ -0,0 +1,37 @@
+module Vmail
+  DIVIDER_WIDTH = 46
+  UNITS = [:b, :kb, :mb, :gb].freeze
+
+  module Helpers
+
+    def retry_if_needed
+      res = nil
+      3.times do
+        res = yield
+        break if res
+      end
+      res
+    end
+
+    # borrowed from ActionView/Helpers
+    def number_to_human_size(number)
+      if number.to_i < 1024
+        "<1kb" # round up to 1kh
+      else
+        max_exp = UNITS.size - 1
+        exponent = (Math.log(number) / Math.log(1024)).to_i # Convert to base 1024
+        exponent = max_exp if exponent > max_exp # we need this to avoid overflow for the highest unit
+        number  /= 1024 ** exponent
+        unit = UNITS[exponent]
+        "#{number}#{unit}"
+      end
+    end
+    
+
+    def divider(str)
+      str * DIVIDER_WIDTH
+    end
+
+
+  end
+end

data/lib/vmail/version.rb

@@ -1,3 +1,3 @@
 module Vmail
-  VERSION = '1.6.9'
+  VERSION = '1.7.0'
 end

metadata

@@ -2,7 +2,7 @@
 name: vmail
 version: !ruby/object:Gem::Version 
   prerelease: 
-  version: 1.6.9
+  version: 1.7.0
 platform: ruby
 authors: 
 - Daniel Choi
@@ -85,6 +85,7 @@ files:
 - lib/vmail/contacts_extractor.rb
 - lib/vmail/database.rb
 - lib/vmail/flagging_and_moving.rb
+- lib/vmail/helpers.rb
 - lib/vmail/imap_client.rb
 - lib/vmail/message_formatter.rb
 - lib/vmail/options.rb