resolve conflicts; make GetAccessCode obsolete

Merge branch 'master' of github.com:ScottIsAFool/PocketSharp into ScottIsAFool-master
Added new method to return username too
2013-10-26 13:16:35 +02:00 · 2013-10-26 13:05:14 +02:00 · 2013-10-25 15:49:47 +01:00 · 2013-10-25 15:22:13 +02:00 · 2013-10-25 15:21:26 +02:00 · 2013-10-25 15:19:42 +02:00
44 changed files with 552 additions and 458 deletions
@@ -1,21 +1,15 @@
 ; This file is for unifying the coding style for different editors and IDEs
 ; editorconfig.org

-; defaults by Tobias Klika
-; 2013
-
 root = true

-
-; default settings for all files
 [*]
-end_of_line = crlf ; this is git standard, so it won't convert it anymore
+end_of_line = crlf
 charset = utf-8
 trim_trailing_whitespace = true
 insert_final_newline = true
 indent_style = space
 indent_size = 2

-
 [*.md]
-trim_trailing_whitespace = false
+trim_trailing_whitespace = false
@@ -0,0 +1,82 @@
+### 2.2.0 (2013-10-26)
+
+- Made `GetAccessCode` obsolete
+- Return username after authentication with `GetUser` (thanks to [ScottIsAFool](https://github.com/ScottIsAFool))
+
+### 2.1.0 (2013-10-25)
+
+- Rename `Statistics()` to `GetUserStatistics()`
+- Made `CallbackUri` public (thanks to [ScottIsAFool](https://github.com/ScottIsAFool))
+- Added Fody/PropertyChanged (thanks to [ScottIsAFool](https://github.com/ScottIsAFool))
+- Method `GetUsageLimits()` to retrieve API usage limits
+- Add PORTABLE constant to SgmlReader 
+
+### 2.0.1 (2013-10-19)
+
+- Catch HttpRequestExceptions and provide as InnerException for PocketException
+- Read Article from URI (method overload)
+
+### 2.0.0 (2013-10-17)
+
+- Add Reader API _(does not use the official Article View API, which is private. The PocketReader is based on a custom PCL port of NReadability and SgmlReader)_
+
+### 1.5.1 (2013-09-30) 
+
+- `RetrieveFilter.All` didn't work
+- improve search speed
+
+### 1.5.0 (2013-09-28) 
+
+- add statistics API
+- add registration API
+
+### 1.4.0 (2013-09-21) 
+
+- rename `Retrieve` to `Get`
+- update IntelliSense documentation
+- add `GetTags` method
+
+### 1.3.0 (2013-09-19) 
+
+- get Item by ID 
+- tag modification bugfixes
+
+### 1.2.1 (2013-09-18) 
+
+- correct parameter conversion for DateTime and Boolean
+
+### 1.2.0 (2013-09-17) 
+
+- simplified retrieve methods
+
+### 1.1.0 (2013-09-17) 
+
+- fix modification requests
+
+### 1.0.0 (2013-09-15) 
+
+- convert to PCL 
+- implement async
+
+### 0.3.2 (2013-08-16) 
+
+- tag modification fixed
+- full retrieval of items for Retrieve method
+
+### 0.3.1 (2013-07-07) 
+
+- authentication fixes
+
+### 0.3.0 (2013-07-02) 
+
+- update authentication process 
+
+### 0.2.0 (2013-06-27) 
+
+- add, modify item
+- modify tags
+
+### 0.1.0 (2013-06-26) 
+
+- authentication 
+- retrieve functionality
@@ -151,5 +151,14 @@ namespace PocketSharp.Tests

      Assert.True(statistics.CountAll > 0);
    }
+
+
+    [Fact]
+    public async Task AreLimitsRetrieved()
+    {
+      PocketLimits limits = await client.GetUsageLimits();
+
+      Assert.True(limits.RateLimitForConsumerKey > 9999);
+    }
  }
 }
@@ -33,7 +33,7 @@
      <p class="app-description">
        PocketSharp is a C#.NET class library, that integrates the Pocket API v3
        <br><br>
-        Current version: <b>1.5.1</b><br>
+        Current version: <b>2.0.1</b><br>
        <a href="https://www.nuget.org/packages/PocketSharp/">@ nuget</a>
      </p>
      <div class="app-nuget">
@@ -48,10 +48,11 @@
    <div class="app-main">
      <nav class="app-nav">
        <a href="#" data-id="gettingstarted" class="is-active">Getting Started</a>
-        <a href="#" data-id="account">Account</a>
        <a href="#" data-id="get">Get</a>
        <a href="#" data-id="add">Add</a>
+        <a href="#" data-id="reader">Reader</a>
        <a href="#" data-id="modify">Modify</a>
+        <a href="#" data-id="account">Account</a>
      </nav>
      <article class="article">

@@ -125,6 +126,8 @@ using PocketSharp.Models;</code></pre>

          <h2>Release History</h2>
        <ul>
+          <li><b>2.0.1</b> (2013-10-19) Catch HttpRequestExceptions and provide as InnerException for PocketException + Read Article from URI (method overload)</li>
+          <li><b>2.0.0</b> (2013-10-17) Add Reader API</li>
          <li><b>1.5.1</b> (2013-09-30) <code>RetrieveFilter.All</code> didn't work; improve search speed</li>
          <li><b>1.5.0</b> (2013-09-28) add statistics and registration API</li>
          <li><b>1.4.0</b> (2013-09-21) rename <code>Retrieve</code> to <code>Get</code> + update IntelliSense documentation + add <code>GetTags</code> method</li>
@@ -314,6 +317,40 @@ Accepts four parameters, with <code>uri</code> being required.

     </div>

+     <div data-part="reader">
+      <h2>Article Reader API</h2>
+      <p>PocketSharp 2.0 implements a new <strong>Reader API</strong>.</p>
+<p>This API does _not _use the official (and private) Article View API by Pocket. It is based on a custom PCL port of NReadability and SgmlReader, which are included in the solution.</p>
+<h3>What's it all about?</h3>
+<p>The Reader API extracts the main content of a website and returns the extracted content as HTML and it's associated title (which should already be available in the <code>PocketItem</code>).</p>
+<p>This content can be encapsulated in a <code>&lt;body&gt;</code>-Tag and displayed as a readable website with a custom CSS (it's up to you!).</p>
+<h3>Implementation</h3>
+<p>As with all PocketSharp implementations you have to require the main namespace and it's model namespace:</p>
+<p><pre class="language-clike"><code>using PocketSharp;
+using PocketSharp.Models;</code></pre></p>
+<p>The <code>PocketReader</code> is a seperated class with it's own <code>HttpClient</code>. Create an instance of it:</p>
+<p><pre class="language-clike"><code>PocketReader reader = new PocketReader();</code></pre></p>
+<p><code>PocketReader</code> needs a <code>PocketItem</code> as a parameter to correctly identify its <code>ID</code> and <code>Uri</code>. With this requirement you can successfully query for an articles content.<br>
+Don't forget exception handling in case a website is down or not accessible.</p>
+<p><pre class="language-clike"><code>PocketArticle article;
+try
+{
+  article = await reader.Read(myPocketItem);
+  // PocketArticle: {
+  //   int PocketItemID
+  //   string Content
+  //   string Title
+  //   string NextPageUrl
+  // }
+}
+catch (PocketException exc)
+{
+  // handle exception
+}
+</code></pre></p>
+
+    </di>
+
      </article>
    </div>

@@ -48,6 +48,7 @@ Global
 		{817200C3-A327-4E35-9B5F-63A51C088577}.Release|x86.ActiveCfg = Release|Any CPU
 		{775569C2-987F-4AC4-8BA5-A315A21ED1B7}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
 		{775569C2-987F-4AC4-8BA5-A315A21ED1B7}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{775569C2-987F-4AC4-8BA5-A315A21ED1B7}.Debug|Any CPU.Deploy.0 = Debug|Any CPU
 		{775569C2-987F-4AC4-8BA5-A315A21ED1B7}.Debug|ARM.ActiveCfg = Debug|Any CPU
 		{775569C2-987F-4AC4-8BA5-A315A21ED1B7}.Debug|x86.ActiveCfg = Debug|Any CPU
 		{775569C2-987F-4AC4-8BA5-A315A21ED1B7}.Release|Any CPU.ActiveCfg = Release|Any CPU
@@ -65,36 +65,51 @@ namespace PocketSharp

    /// <summary>
    /// Requests the access code after authentication
-    /// The access code has to permanently be stored within the users session, and should be added as a parameter for all future PocketClient initializations. 
+    /// The access code has to permanently be stored within the users session, and should be passed in the constructor for all future PocketClient initializations. 
    /// </summary>
    /// <param name="requestCode">The requestCode. If no requestCode is supplied, the property from the PocketClient intialization is used.</param>
    /// <returns>The permanent access code, which is used to authenticate the user with the application</returns>
    /// <exception cref="System.NullReferenceException">Call GetRequestCode() first to receive a request_code</exception>
    /// <exception cref="PocketException"></exception>
+    [Obsolete("Please use GetUser instead")]
    public async Task<string> GetAccessCode(string requestCode = null)
+    {
+      await GetUser(requestCode);
+      return AccessCode;
+    }
+
+
+    /// <summary>
+    /// Requests the access code and username after authentication
+    /// The access code has to permanently be stored within the users session, and should be passed in the constructor for all future PocketClient initializations. 
+    /// </summary>
+    /// <param name="requestCode">The request code.</param>
+    /// <returns>The authenticated user</returns>
+    /// <exception cref="System.NullReferenceException">Call GetRequestCode() first to receive a request_code</exception>
+    public async Task<PocketUser> GetUser(string requestCode = null)
    {
      // check if request code is available
-      if(RequestCode == null && requestCode == null)
+      if (RequestCode == null && requestCode == null)
      {
        throw new NullReferenceException("Call GetRequestCode() first to receive a request_code");
      }

      // override property with given param if available
-      if(requestCode != null)
+      if (requestCode != null)
      {
        RequestCode = requestCode;
      }

      // do request
-      AccessCode response = await Request<AccessCode>("oauth/authorize", new Dictionary<string, string>()
-      { 
-        { "code", RequestCode } 
+      PocketUser response = await Request<PocketUser>("oauth/authorize", new Dictionary<string, string>()
+      {
+        {"code", RequestCode}
      }, false);

      // save code to client
      AccessCode = response.Code;

-      return AccessCode;
+      return response;
    }


@@ -11,13 +11,22 @@ namespace PocketSharp
  /// </summary>
  public partial class PocketClient
  {
-    /// <summary>
-    /// Retrieves items from pocket
-    /// with the given filters
-    /// </summary>
-    /// <param name="parameters">parameters, which are mapped to the officials from http://getpocket.com/developer/docs/v3/retrieve </param>
-    /// <returns></returns>
-    /// <exception cref="PocketException"></exception>
+      /// <summary>
+      /// Retrieves items from pocket
+      /// with the given filters
+      /// </summary>
+      /// <param name="state">The state.</param>
+      /// <param name="favorite">The favorite.</param>
+      /// <param name="tag">The tag.</param>
+      /// <param name="contentType">Type of the content.</param>
+      /// <param name="sort">The sort.</param>
+      /// <param name="search">The search.</param>
+      /// <param name="domain">The domain.</param>
+      /// <param name="since">The since.</param>
+      /// <param name="count">The count.</param>
+      /// <param name="offset">The offset.</param>
+      /// <returns></returns>
+      /// <exception cref="PocketException"></exception>
    public async Task<List<PocketItem>> Get(
      State? state = null,
      bool? favorite = null,
@@ -1,5 +1,4 @@
 using PocketSharp.Models;
-using System.Collections.Generic;
 using System.Threading.Tasks;

 namespace PocketSharp
@@ -1,7 +1,5 @@
 using PocketSharp.Models;
-using System.Collections.Generic;
 using System.Threading.Tasks;
-using System.Linq;

 namespace PocketSharp
 {
@@ -14,9 +14,50 @@ namespace PocketSharp
    /// </summary>
    /// <returns></returns>
    /// <exception cref="PocketException"></exception>
-    public async Task<PocketStatistics> Statistics()
+    public async Task<PocketStatistics> GetUserStatistics()
    {
      return await Request<PocketStatistics>("stats");
    }
+
+
+    /// <summary>
+    /// Statistics from the user account.
+    /// </summary>
+    /// <returns></returns>
+    /// <exception cref="PocketException"></exception>
+    [Obsolete("Please use GetUserStatistics instead")]
+    public async Task<PocketStatistics> Statistics()
+    {
+      return await GetUserStatistics();
+    }
+
+
+    /// <summary>
+    /// Returns API usage statistics.
+    /// If a request was made before, the data is returned synchronously from the cache.
+    /// Note: This method only works for authenticated users with a given AccessCode.
+    /// </summary>
+    /// <returns></returns>
+    /// <exception cref="PocketException"></exception>
+    public async Task<PocketLimits> GetUsageLimits()
+    {
+      string rateLimitForConsumerKey = TryGetHeaderValue(lastHeaders, "X-Limit-Key-Limit");
+
+      if (rateLimitForConsumerKey == null)
+      {
+        // this is the fastest way to do a non-failing request to receive the correct headers
+        await Get(count: 1);
+      }
+
+      return new PocketLimits()
+      {
+        RateLimitForConsumerKey = Convert.ToInt32(TryGetHeaderValue(lastHeaders, "X-Limit-Key-Limit")),
+        RemainingCallsForConsumerKey = Convert.ToInt32(TryGetHeaderValue(lastHeaders, "X-Limit-Key-Remaining")),
+        SecondsUntilLimitResetsForConsumerKey = Convert.ToInt32(TryGetHeaderValue(lastHeaders, "X-Limit-Key-Reset")),
+        RateLimitForUser = Convert.ToInt32(TryGetHeaderValue(lastHeaders, "X-Limit-User-Limit")),
+        RemainingCallsForUser = Convert.ToInt32(TryGetHeaderValue(lastHeaders, "X-Limit-User-Remaining")),
+        SecondsUntilLimitResetsForUser = Convert.ToInt32(TryGetHeaderValue(lastHeaders, "X-Limit-User-Reset"))
+      };
+    }
  }
 }
@@ -0,0 +1,89 @@
+<?xml version="1.0" encoding="utf-8"?>
+<Project ToolsVersion="4.0" xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
+  <Choose>
+    <When Condition="$(NCrunchOriginalSolutionDir) != '' And $(NCrunchOriginalSolutionDir) != '*Undefined*'">
+      <PropertyGroup>
+        <FodySolutionDir>$(NCrunchOriginalSolutionDir)</FodySolutionDir>
+      </PropertyGroup>
+    </When>
+    <When Condition="$(SolutionDir) != '' And $(SolutionDir) != '*Undefined*'">
+      <PropertyGroup>
+        <FodySolutionDir>$(SolutionDir)</FodySolutionDir>
+      </PropertyGroup>
+    </When>
+    <When Condition="$(SolutionDir) == '' Or $(SolutionDir) == '*Undefined*'">
+      <PropertyGroup>
+        <FodySolutionDir>$(MSBuildProjectDirectory)\..\</FodySolutionDir>
+      </PropertyGroup>
+    </When>
+  </Choose>
+  <Choose>
+    <When Condition="$(KeyOriginatorFile) != '' And $(KeyOriginatorFile) != '*Undefined*'">
+      <PropertyGroup>
+        <FodyKeyFilePath>$(KeyOriginatorFile)</FodyKeyFilePath>
+      </PropertyGroup>
+    </When>
+    <When Condition="$(AssemblyOriginatorKeyFile) != '' And $(AssemblyOriginatorKeyFile) != '*Undefined*'">
+      <PropertyGroup>
+        <FodyKeyFilePath>$(AssemblyOriginatorKeyFile)</FodyKeyFilePath>
+      </PropertyGroup>
+    </When>
+    <Otherwise >
+      <PropertyGroup>
+        <FodyKeyFilePath></FodyKeyFilePath>
+      </PropertyGroup>
+    </Otherwise>
+  </Choose>
+  <PropertyGroup>
+    <IntermediateDir>$(ProjectDir)$(IntermediateOutputPath)</IntermediateDir>
+    <FodyMessageImportance Condition="$(FodyMessageImportance) == '' Or $(FodyMessageImportance) == '*Undefined*'">Low</FodyMessageImportance>
+    <FodySignAssembly Condition="$(FodySignAssembly) == '' Or $(FodySignAssembly) == '*Undefined*'">$(SignAssembly)</FodySignAssembly>
+    <FodyPath Condition="$(FodyPath) == '' Or $(FodyPath) == '*Undefined*'">$(MSBuildThisFileDirectory)</FodyPath>
+  </PropertyGroup>
+  <UsingTask
+      TaskName="Fody.WeavingTask"
+      AssemblyFile="$(FodyPath)\Fody.dll" />
+  <Target
+      AfterTargets="AfterCompile"
+      Name="WinFodyTarget"
+      Condition=" '$(OS)' == 'Windows_NT'">
+
+    <Fody.WeavingTask
+          AssemblyPath="@(IntermediateAssembly)"
+          IntermediateDir="$(IntermediateDir)"
+          KeyFilePath="$(FodyKeyFilePath)"
+          MessageImportance="$(FodyMessageImportance)"
+          ProjectDirectory="$(ProjectDir)"
+          SolutionDir="$(FodySolutionDir)"
+          References="@(ReferencePath)"
+          SignAssembly="$(FodySignAssembly)"
+          ReferenceCopyLocalPaths="@(ReferenceCopyLocalPaths)"
+          DefineConstants="$(DefineConstants)"
+      />
+  </Target>
+
+  <Target
+      AfterTargets="AfterBuild"
+      Name="NonWinFodyTarget"
+      Condition=" '$(OS)' != 'Windows_NT'">
+    <Fody.WeavingTask
+          AssemblyPath="$(TargetPath)"
+          IntermediateDir="$(IntermediateDir)"
+          KeyFilePath="$(FodyKeyFilePath)"
+          MessageImportance="$(FodyMessageImportance)"
+          ProjectDirectory="$(ProjectDir)"
+          SolutionDir="$(FodySolutionDir)"
+          References="@(ReferencePath)"
+          SignAssembly="$(FodySignAssembly)"
+          ReferenceCopyLocalPaths="$(ReferenceCopyLocalPaths)"
+          DefineConstants="$(DefineConstants)"
+      />
+  </Target>
+
+
+  <!--Support for ncrunch-->
+  <ItemGroup>
+    <None Include="$(FodyPath)\*.*" />
+  </ItemGroup>
+
+</Project>
@@ -0,0 +1,4 @@
+<?xml version="1.0" encoding="utf-8"?>
+<Weavers>
+  <PropertyChanged />
+</Weavers>
@@ -1,5 +1,4 @@
-using Newtonsoft.Json;
-using System;
+using System;
 using System.Collections.Generic;
 using System.Runtime.Serialization;

@@ -1,8 +1,5 @@
 using System;
-using System.Collections.Generic;
-using System.Reflection;
 using System.Runtime.Serialization;
-using System.Linq;

 namespace PocketSharp.Models
 {
@@ -4,7 +4,6 @@ using System.Reflection;
 using System.Runtime.Serialization;
 using System.Linq;
 using System.Collections;
-using Newtonsoft.Json;

 namespace PocketSharp.Models
 {
@@ -1,8 +1,4 @@
-using System;
-using System.Collections.Generic;
-using System.Reflection;
-using System.Runtime.Serialization;
-using System.Linq;
+using System.Runtime.Serialization;

 namespace PocketSharp.Models
 {
@@ -1,6 +1,4 @@
 using System;
-using System.Collections.Generic;
-using System.Reflection;
 using System.Runtime.Serialization;

 namespace PocketSharp.Models
@@ -1,13 +1,12 @@
 using System;
-using System.Collections.Generic;
-using System.Linq;
-using System.Text;
+using PropertyChanged;

 namespace PocketSharp.Models
 {
  /// <summary>
  /// Readable article
  /// </summary>
+  [ImplementPropertyChanged]
  public class PocketArticle
  {
    /// <summary>
@@ -40,6 +39,6 @@ namespace PocketSharp.Models
    /// <value>
    /// The next page URL.
    /// </value>
-    public string NextPageUrl { get; set; }
+    public Uri NextPage { get; set; }
  }
 }
@@ -1,6 +1,6 @@
 using Newtonsoft.Json;
 using System;
-using System.Runtime.Serialization;
+using PropertyChanged;

 namespace PocketSharp.Models
 {
@@ -8,6 +8,7 @@ namespace PocketSharp.Models
  /// Author
  /// </summary>
  [JsonObject]
+  [ImplementPropertyChanged]
  public class PocketAuthor
  {
    /// <summary>
@@ -1,6 +1,6 @@
 using Newtonsoft.Json;
 using System;
-using System.Runtime.Serialization;
+using PropertyChanged;

 namespace PocketSharp.Models
 {
@@ -8,6 +8,7 @@ namespace PocketSharp.Models
  /// Image
  /// </summary>
  [JsonObject]
+  [ImplementPropertyChanged]
  public class PocketImage
  {
    /// <summary>
@@ -1,7 +1,7 @@
 using Newtonsoft.Json;
 using System;
 using System.Collections.Generic;
-using System.Runtime.Serialization;
+using PropertyChanged;

 namespace PocketSharp.Models
 {
@@ -10,6 +10,7 @@ namespace PocketSharp.Models
  /// see: http://getpocket.com/developer/docs/v3/retrieve
  /// </summary>
  [JsonObject]
+  [ImplementPropertyChanged]
  public class PocketItem
  {
    /// <summary>
@@ -0,0 +1,67 @@
+using Newtonsoft.Json;
+using PropertyChanged;
+
+namespace PocketSharp.Models
+{
+  /// <summary>
+  /// API Limitation Statistics
+  /// </summary>
+  [JsonObject]
+  [ImplementPropertyChanged]
+  public class PocketLimits
+  {
+    /// <summary>
+    /// Gets or sets the rate limit.
+    /// </summary>
+    /// <value>
+    /// Rate limit for current consumer key.
+    /// </value>
+    [JsonProperty("X-Limit-Key-Limit")]
+    public int RateLimitForConsumerKey { get; set; }
+
+    /// <summary>
+    /// Gets or sets the remaining calls.
+    /// </summary>
+    /// <value>
+    /// Remaining calls for current consumer key.
+    /// </value>
+    [JsonProperty("X-Limit-Key-Remaining")]
+    public int RemainingCallsForConsumerKey { get; set; }
+
+    /// <summary>
+    /// Gets or sets the reset seconds.
+    /// </summary>
+    /// <value>
+    /// Seconds until limit resets for current consumer key.
+    /// </value>
+    [JsonProperty("X-Limit-Key-Reset")]
+    public int SecondsUntilLimitResetsForConsumerKey { get; set; }
+
+    /// <summary>
+    /// Gets or sets the rate limit.
+    /// </summary>
+    /// <value>
+    /// Rate limit for current user.
+    /// </value>
+    [JsonProperty("X-Limit-User-Limit")]
+    public int RateLimitForUser { get; set; }
+
+    /// <summary>
+    /// Gets or sets the remaining calls.
+    /// </summary>
+    /// <value>
+    /// Remaining calls for current user.
+    /// </value>
+    [JsonProperty("X-Limit-User-Remaining")]
+    public int RemainingCallsForUser { get; set; }
+
+    /// <summary>
+    /// Gets or sets the reset seconds.
+    /// </summary>
+    /// <value>
+    /// Seconds until limit resets for current user.
+    /// </value>
+    [JsonProperty("X-Limit-User-Reset")]
+    public int SecondsUntilLimitResetsForUser { get; set; }
+  }
+}
@@ -1,5 +1,5 @@
 using Newtonsoft.Json;
-using System.Runtime.Serialization;
+using PropertyChanged;

 namespace PocketSharp.Models
 {
@@ -7,6 +7,7 @@ namespace PocketSharp.Models
  /// Statistics
  /// </summary>
  [JsonObject]
+  [ImplementPropertyChanged]
  public class PocketStatistics
  {
    /// <summary>
@@ -1,21 +1,22 @@
 using Newtonsoft.Json;
-using System.Runtime.Serialization;
+using PropertyChanged;

 namespace PocketSharp.Models
 {
-  /// <summary>
-  /// Tag
-  /// </summary>
-  [JsonObject]
-  public class PocketTag
-  {
    /// <summary>
-    /// Gets or sets the name.
+    /// Tag
    /// </summary>
-    /// <value>
-    /// The name.
-    /// </value>
-    [JsonProperty("tag")]
-    public string Name { get; set; }
-  }
+    [JsonObject]
+    [ImplementPropertyChanged]
+    public class PocketTag
+    {
+        /// <summary>
+        /// Gets or sets the name.
+        /// </summary>
+        /// <value>
+        /// The name.
+        /// </value>
+        [JsonProperty("tag")]
+        public string Name { get; set; }
+    }
 }
@@ -1,5 +1,5 @@
 using Newtonsoft.Json;
-using System.Runtime.Serialization;
+using PropertyChanged;

 namespace PocketSharp.Models
 {
@@ -7,7 +7,8 @@ namespace PocketSharp.Models
  /// Access Code
  /// </summary>
  [JsonObject]
-  internal class AccessCode
+  [ImplementPropertyChanged]
+  public class PocketUser
  {
    /// <summary>
    /// Gets or sets the code.
@@ -24,7 +25,7 @@ namespace PocketSharp.Models
    /// <value>
    /// The username.
    /// </value>
-    [JsonProperty]
+    [JsonProperty("username")]
    public string Username { get; set; }
  }
 }
@@ -1,40 +1,41 @@
 using Newtonsoft.Json;
 using System;
-using System.Runtime.Serialization;
+using PropertyChanged;

 namespace PocketSharp.Models
 {
-  /// <summary>
-  /// Video
-  /// </summary>
-  [JsonObject]
-  public class PocketVideo
-  {
    /// <summary>
-    /// Gets or sets the ID.
+    /// Video
    /// </summary>
-    /// <value>
-    /// The ID.
-    /// </value>
-    [JsonProperty("video_id")]
-    public string ID { get; set; }
+    [JsonObject]
+    [ImplementPropertyChanged]
+    public class PocketVideo
+    {
+        /// <summary>
+        /// Gets or sets the ID.
+        /// </summary>
+        /// <value>
+        /// The ID.
+        /// </value>
+        [JsonProperty("video_id")]
+        public string ID { get; set; }

-    /// <summary>
-    /// Gets or sets the external ID.
-    /// </summary>
-    /// <value>
-    /// The external ID.
-    /// </value>
-    [JsonProperty("vid")]
-    public string ExternalID { get; set; }
+        /// <summary>
+        /// Gets or sets the external ID.
+        /// </summary>
+        /// <value>
+        /// The external ID.
+        /// </value>
+        [JsonProperty("vid")]
+        public string ExternalID { get; set; }

-    /// <summary>
-    /// Gets or sets the URI.
-    /// </summary>
-    /// <value>
-    /// The URI.
-    /// </value>
-    [JsonProperty("src")]
-    public Uri Uri { get; set; }
-  }
+        /// <summary>
+        /// Gets or sets the URI.
+        /// </summary>
+        /// <value>
+        /// The URI.
+        /// </value>
+        [JsonProperty("src")]
+        public Uri Uri { get; set; }
+    }
 }
@@ -1,5 +1,4 @@
 using Newtonsoft.Json;
-using System.Runtime.Serialization;

 namespace PocketSharp.Models
 {
@@ -1,5 +1,4 @@
 using Newtonsoft.Json;
-using System.Runtime.Serialization;

 namespace PocketSharp.Models
 {
@@ -1,5 +1,4 @@
 using Newtonsoft.Json;
-using System.Runtime.Serialization;

 namespace PocketSharp.Models
 {
@@ -1,5 +1,4 @@
 using Newtonsoft.Json;
-using System.Runtime.Serialization;

 namespace PocketSharp.Models
 {
@@ -1,6 +1,5 @@
 using Newtonsoft.Json;
 using System.Collections.Generic;
-using System.Runtime.Serialization;

 namespace PocketSharp.Models
 {
@@ -5,9 +5,7 @@ using System.Net;
 using System.Net.Http;
 using System.Threading.Tasks;
 using Newtonsoft.Json;
-using Newtonsoft.Json.Linq;
 using Newtonsoft.Json.Serialization;
-using System.Diagnostics;
 using System.Net.Http.Headers;

 namespace PocketSharp
@@ -22,6 +20,11 @@ namespace PocketSharp
    /// </summary>
    protected readonly HttpClient _restClient;

+    /// <summary>
+    /// Caches HTTP headers from last response
+    /// </summary>
+    private HttpResponseHeaders lastHeaders;
+
    /// <summary>
    /// The base URL for the Pocket API
    /// </summary>
@@ -35,7 +38,7 @@ namespace PocketSharp
    /// <summary>
    /// callback URL for API calls
    /// </summary>
-    protected string CallbackUri { get; set; }
+    public string CallbackUri { get; set; }

    /// <summary>
    /// Accessor for the Pocket API key
@@ -54,6 +57,7 @@ namespace PocketSharp
    public string AccessCode { get; set; }


+
    /// <summary>
    /// Initializes a new instance of the <see cref="PocketClient"/> class.
    /// </summary>
@@ -112,6 +116,7 @@ namespace PocketSharp

      // every single Pocket API endpoint requires HTTP POST data
      HttpRequestMessage request = new HttpRequestMessage(HttpMethod.Post, method);
+      HttpResponseMessage response = null;

      if (parameters == null)
      {
@@ -131,11 +136,21 @@ namespace PocketSharp
      request.Content = new FormUrlEncodedContent(parameters);

      // make async request
-      HttpResponseMessage response = await _restClient.SendAsync(request);
+      try
+      {
+        response = await _restClient.SendAsync(request);
+      }
+      catch (HttpRequestException exc)
+      {
+        throw new PocketException(exc.Message, exc);
+      }

      // validate HTTP response
      ValidateResponse(response);

+      // cache headers
+      lastHeaders = response.Headers;
+
      // read response
      var responseString = await response.Content.ReadAsStringAsync();

@@ -259,6 +274,11 @@ namespace PocketSharp
    {
      string result = null;

+      if (headers == null || String.IsNullOrEmpty(key))
+      {
+        return null;
+      }
+
      foreach (var header in headers)
      {
        if (header.Key == key)
@@ -267,6 +287,7 @@ namespace PocketSharp
          headerEnumerator.MoveNext();

          result = headerEnumerator.Current;
+          break;
        }
      }

@@ -37,7 +37,26 @@ namespace PocketSharp
      _httpClient.DefaultRequestHeaders.TryAddWithoutValidation("Accept-Encoding", "gzip,deflate");

      // add user agent (default for Opera with PocketSharp identifier appended)
-      _httpClient.DefaultRequestHeaders.TryAddWithoutValidation("User-Agent", "Mozilla/5.0 (Windows NT 6.2; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/31.0.1650.4 Safari/537.36 OPR/18.0.1284.2 PocketSharp/2.0");
+      _httpClient.DefaultRequestHeaders.TryAddWithoutValidation("User-Agent", "Mozilla/5.0 (Windows NT 6.2; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/31.0.1650.4 Safari/537.36 OPR/18.0.1284.2 PocketSharp/2.2");
+    }
+
+
+
+    /// <summary>
+    /// Reads article content from the given URI.
+    /// This method does not use the official Article View API, which is private.
+    /// The PocketReader is based on a custom PCL port of NReadability and SgmlReader.
+    /// </summary>
+    /// <param name="uri">An URI.</param>
+    /// <returns>A Pocket article with extracted content and title.</returns>
+    /// <exception cref="PocketRequestException"></exception>
+    public async Task<PocketArticle> Read(Uri uri)
+    {
+      return await Read(new PocketItem()
+      {
+        ID = 0,
+        Uri = uri
+      });
    }


@@ -49,7 +68,7 @@ namespace PocketSharp
    /// </summary>
    /// <param name="item">The pocket item.</param>
    /// <returns>A Pocket article with extracted content and title.</returns>
-    /// <exception cref="PocketException"></exception>
+    /// <exception cref="PocketRequestException"></exception>
    public async Task<PocketArticle> Read(PocketItem item)
    {
      // initialize transcoder
@@ -87,7 +106,7 @@ namespace PocketSharp
      {
        Content = transcodingResult.ExtractedContent,
        Title = transcodingResult.ExtractedTitle,
-        NextPageUrl = transcodingResult.NextPageUrl,
+        NextPage = transcodingResult.NextPageUrl != null ? new Uri(transcodingResult.NextPageUrl, UriKind.Absolute) : null,
        PocketItemID = item.ID
      };
    }
@@ -102,9 +121,17 @@ namespace PocketSharp
    protected async Task<string> Request(Uri uri)
    {
      HttpRequestMessage request = new HttpRequestMessage(HttpMethod.Get, uri);
+      HttpResponseMessage response = null;

      // make async request
-      HttpResponseMessage response = await _httpClient.SendAsync(request);
+      try
+      {
+        response = await _httpClient.SendAsync(request);
+      }
+      catch (HttpRequestException exc)
+      {
+        throw new PocketException(exc.Message, exc);
+      }

      // validate HTTP response
      if (response.StatusCode != HttpStatusCode.OK)
@@ -115,9 +142,7 @@ namespace PocketSharp
      }

      // read response
-      var responseString = await response.Content.ReadAsStringAsync();
-
-      return responseString;
+      return await response.Content.ReadAsStringAsync();
    }
  }
 }
@@ -11,11 +11,12 @@
    <RootNamespace>PocketSharp</RootNamespace>
    <AssemblyName>PocketSharp</AssemblyName>
    <TargetFrameworkVersion>v4.0</TargetFrameworkVersion>
-    <TargetFrameworkProfile>Profile104</TargetFrameworkProfile>
+    <TargetFrameworkProfile>Profile96</TargetFrameworkProfile>
    <FileAlignment>512</FileAlignment>
    <ProjectTypeGuids>{786C830F-07A1-408B-BD7F-6EE04809D6DB};{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}</ProjectTypeGuids>
    <SolutionDir Condition="$(SolutionDir) == '' Or $(SolutionDir) == '*Undefined*'">..\</SolutionDir>
    <RestorePackages>true</RestorePackages>
+    <FodyPath>..\packages\Fody.1.17.4.0</FodyPath>
  </PropertyGroup>
  <PropertyGroup Condition=" '$(Configuration)|$(Platform)' == 'Debug|AnyCPU' ">
    <DebugSymbols>true</DebugSymbols>
@@ -36,20 +37,22 @@
  </PropertyGroup>
  <ItemGroup>
    <!-- A reference to the entire .NET Framework is automatically included -->
+    <None Include="Fody.targets" />
    <None Include="packages.config" />
  </ItemGroup>
  <ItemGroup>
    <Compile Include="Components\Statistics.cs" />
    <Compile Include="Models\Parameters\RegisterParameters.cs" />
    <Compile Include="Models\PocketArticle.cs" />
+    <Compile Include="Models\PocketLimits.cs" />
    <Compile Include="Models\PocketStatistics.cs" />
-    <Compile Include="PocketException.cs" />
+    <Compile Include="Utilities\PocketException.cs" />
    <Compile Include="Components\Add.cs" />
    <Compile Include="Components\Account.cs" />
    <Compile Include="Components\Modify.cs" />
    <Compile Include="Components\ModifyTags.cs" />
    <Compile Include="Components\Get.cs" />
-    <Compile Include="JsonExtensions.cs" />
+    <Compile Include="Utilities\JsonExtensions.cs" />
    <Compile Include="Models\Parameters\ActionParameter.cs" />
    <Compile Include="Models\Parameters\AddParameters.cs" />
    <Compile Include="Models\Parameters\ModifyParameters.cs" />
@@ -60,7 +63,7 @@
    <Compile Include="Models\PocketItem.cs" />
    <Compile Include="Models\PocketTag.cs" />
    <Compile Include="Models\PocketVideo.cs" />
-    <Compile Include="Models\Response\AccessCode.cs" />
+    <Compile Include="Models\PocketUser.cs" />
    <Compile Include="Models\Response\Add.cs" />
    <Compile Include="Models\Response\Modify.cs" />
    <Compile Include="Models\Response\RequestCode.cs" />
@@ -69,7 +72,7 @@
    <Compile Include="PocketClient.cs" />
    <Compile Include="PocketReader.cs" />
    <Compile Include="Properties\AssemblyInfo.cs" />
-    <Compile Include="Utilities.cs" />
+    <Compile Include="Utilities\Utilities.cs" />
  </ItemGroup>
  <ItemGroup>
    <Reference Include="Microsoft.Threading.Tasks">
@@ -81,6 +84,10 @@
    <Reference Include="Newtonsoft.Json">
      <HintPath>..\packages\Newtonsoft.Json.5.0.8\lib\portable-net40+sl4+wp7+win8\Newtonsoft.Json.dll</HintPath>
    </Reference>
+    <Reference Include="PropertyChanged">
+      <HintPath>..\packages\PropertyChanged.Fody.1.41.0.0\Lib\portable-net4+sl4+wp7+win8+MonoAndroid16+MonoTouch40\PropertyChanged.dll</HintPath>
+      <Private>False</Private>
+    </Reference>
    <Reference Include="System.IO">
      <HintPath>..\packages\Microsoft.Bcl.1.1.3\lib\portable-net40+sl4+win8+wp71\System.IO.dll</HintPath>
    </Reference>
@@ -106,6 +113,9 @@
      <Name>NReadability</Name>
    </ProjectReference>
  </ItemGroup>
+  <ItemGroup>
+    <Content Include="FodyWeavers.xml" />
+  </ItemGroup>
  <Import Project="$(MSBuildExtensionsPath32)\Microsoft\Portable\$(TargetFrameworkVersion)\Microsoft.Portable.CSharp.targets" />
  <Import Project="$(SolutionDir)\.nuget\NuGet.targets" Condition="Exists('$(SolutionDir)\.nuget\NuGet.targets')" />
  <Target Name="EnsureNuGetPackageBuildImports" BeforeTargets="PrepareForBuild">
@@ -119,6 +129,7 @@
    <Error Condition="!Exists('..\packages\Microsoft.Bcl.Build.1.0.10\tools\Microsoft.Bcl.Build.targets')" Text="This project references NuGet package(s) that are missing on this computer. Enable NuGet Package Restore to download them.  For more information, see http://go.microsoft.com/fwlink/?LinkID=317567." HelpKeyword="BCLBUILD2001" />
    <Error Condition="Exists('..\packages\Microsoft.Bcl.Build.1.0.10\tools\Microsoft.Bcl.Build.targets')" Text="The build restored NuGet packages. Build the project again to include these packages in the build. For more information, see http://go.microsoft.com/fwlink/?LinkID=317568." HelpKeyword="BCLBUILD2002" />
  </Target>
+  <Import Project="Fody.targets" />
  <!-- To modify your build process, add your task inside one of the targets below and uncomment it. 
       Other similar extension points exist, see Microsoft.Common.targets.
  <Target Name="BeforeBuild">
@@ -14,10 +14,10 @@
    <language>en-US</language>
    <releaseNotes>
      <![CDATA[
-           For full release notes see https://github.com/ceee/PocketSharp#release-history
+           For full release notes see https://github.com/ceee/PocketSharp/blob/master/CHANGELOG.md
         ]]>
    </releaseNotes>
    <copyright>Copyright by cee, 2013</copyright>
-    <tags>PocketAPI Pocket API PocketSharp Tobias Klika cee RestSharp</tags>
+    <tags>PocketAPI Pocket API PocketSharp Tobias Klika cee NReadability Reader Article SDK Pockem</tags>
  </metadata>
 </package>
@@ -7,11 +7,11 @@ using System.Runtime.InteropServices;
 // set of attributes. Change these attribute values to modify the information
 // associated with an assembly.
 [assembly: AssemblyTitle("PocketSharp")]
-[assembly: AssemblyDescription("PocketSharp is a .NET class library that integrates the Pocket API v3")]
+[assembly: AssemblyDescription("PocketSharp is a .NET class library that integrates the Pocket API v3 (support a custom Article View API)")]
 [assembly: AssemblyConfiguration("")]
 [assembly: AssemblyCompany("cee")]
 [assembly: AssemblyProduct("PocketSharp")]
-[assembly: AssemblyCopyright("Copyright ©  2013")]
+[assembly: AssemblyCopyright("Copyright © cee 2013")]
 [assembly: AssemblyTrademark("")]
 [assembly: AssemblyCulture("")]

@@ -25,5 +25,5 @@ using System.Runtime.InteropServices;
 // You can specify all the values or you can default the Build and Revision Numbers
 // by using the '*' as shown below:
 // [assembly: AssemblyVersion("1.0.*")]
-[assembly: AssemblyVersion("2.0.0")]
-[assembly: AssemblyFileVersion("2.0.0")]
+[assembly: AssemblyVersion("2.2.0")]
+[assembly: AssemblyFileVersion("2.2.0")]
@@ -1,9 +1,6 @@
 using Newtonsoft.Json;
 using Newtonsoft.Json.Converters;
 using System;
-using System.Collections.Generic;
-using System.Linq;
-using System.Text;

 namespace PocketSharp
 {
@@ -1,5 +1,4 @@
 using System;
-using System.Runtime.Serialization;

 namespace PocketSharp
 {
@@ -1,6 +1,5 @@
 using System;
 using System.Collections.Generic;
-using PocketSharp.Models;

 namespace PocketSharp
 {
@@ -1,8 +1,10 @@
 <?xml version="1.0" encoding="utf-8"?>
 <packages>
+  <package id="Fody" version="1.17.4.0" targetFramework="portable-net403+sl40+wp71+win" />
  <package id="Microsoft.Bcl" version="1.1.3" targetFramework="portable-net45+sl40+wp71+win" />
  <package id="Microsoft.Bcl.Async" version="1.0.16" targetFramework="portable-net45+sl40+wp71+win" />
  <package id="Microsoft.Bcl.Build" version="1.0.10" targetFramework="portable-net45+sl40+wp71+win" />
  <package id="Microsoft.Net.Http" version="2.2.15" targetFramework="portable-net403+sl40+wp71+win" />
  <package id="Newtonsoft.Json" version="5.0.8" targetFramework="portable-net45+sl40+wp71+win" />
+  <package id="PropertyChanged.Fody" version="1.41.0.0" targetFramework="portable-net403+sl40+wp71+win" />
 </packages>
@@ -11,7 +11,7 @@
    <RootNamespace>PocketSharp.Ports.NReadability</RootNamespace>
    <AssemblyName>PocketSharp.Ports.NReadability</AssemblyName>
    <TargetFrameworkVersion>v4.0</TargetFrameworkVersion>
-    <TargetFrameworkProfile>Profile104</TargetFrameworkProfile>
+    <TargetFrameworkProfile>Profile96</TargetFrameworkProfile>
    <FileAlignment>512</FileAlignment>
    <ProjectTypeGuids>{786C830F-07A1-408B-BD7F-6EE04809D6DB};{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}</ProjectTypeGuids>
  </PropertyGroup>
@@ -397,7 +397,6 @@ namespace PocketSharp.Ports.Sgml
        private string m_rootElementName;

        private string m_href;
-        private string m_errorLogFile;
        private Entity m_lastError;
        private string m_proxy;
        private TextReader m_inputStream;
@@ -11,7 +11,7 @@
    <RootNamespace>PocketSharp.Ports.SgmlReader</RootNamespace>
    <AssemblyName>PocketSharp.Ports.SgmlReader</AssemblyName>
    <TargetFrameworkVersion>v4.0</TargetFrameworkVersion>
-    <TargetFrameworkProfile>Profile104</TargetFrameworkProfile>
+    <TargetFrameworkProfile>Profile96</TargetFrameworkProfile>
    <FileAlignment>512</FileAlignment>
    <ProjectTypeGuids>{786C830F-07A1-408B-BD7F-6EE04809D6DB};{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}</ProjectTypeGuids>
  </PropertyGroup>
@@ -20,7 +20,7 @@
    <DebugType>full</DebugType>
    <Optimize>false</Optimize>
    <OutputPath>bin\Debug\</OutputPath>
-    <DefineConstants>DEBUG;TRACE</DefineConstants>
+    <DefineConstants>TRACE;DEBUG;PORTABLE</DefineConstants>
    <ErrorReport>prompt</ErrorReport>
    <WarningLevel>4</WarningLevel>
  </PropertyGroup>
@@ -1,69 +1,28 @@
 ![PocketSharp](https://raw.github.com/ceee/PocketSharp/master/PocketSharp.Website/Assets/Images/github-header.png)

-**PocketSharp** is a C#.NET class library, that integrates the [Pocket API v3](http://getpocket.com/developer).
+**PocketSharp** is a C#.NET portable class library that integrates the [Pocket API v3](http://getpocket.com/developer).

-**Website:** [pocketsharp.frontendplay.com](http://pocketsharp.frontendplay.com/)
-<br>
-**NuGet:** [nuget.org/packages/PocketSharp](https://www.nuget.org/packages/PocketSharp/)
-
-
-## Install using NuGet
+## Install using [NuGet](https://www.nuget.org/packages/PocketSharp/)

 ```
 Install-Package PocketSharp
 ```

-## Components
+## Documentation

- [Get](#get) - Retrieve and search for items
- [Modify](#modify) - Modify items and its tags
- [Add](#add) - Add new items
- [Authentication](#account-authentication) - Authenticate users
- [Registration](#account-registration) - Register new users
- [Statistics](#statistics) - Retrieve account statistics
+See [wiki](https://github.com/ceee/PocketSharp/wiki)

-## Supported platforms
+---

-PocketSharp is a **Portable Class Library** (since 1.0.0), therefore it's compatible with multiple platforms:
+## Usage Example:

- **.NET** >= 4.0.3 (including WPF)
- **Silverlight** >= 4
- **Windows Phone** >= 7.5
- **Windows Store**
-
-You can find examples for Silverlight 5, WP8 and WPF in the `PocketSharp.Examples` ([@github](https://github.com/ceee/PocketSharp/tree/master/PocketSharp.Examples)) folder.
-
-## Async Support
-
-All public methods, which communicate with the Pocket servers are asynchronous. So they should be called with the preceding `await` keyword, and the encapsulated method marked with `async`.
-
-_In PocketSharp versions < 1.0.0 all methods lacked async support and were blocking._
-
-## What's next
-
-Next is Reading API support (with NReadability implementation). Release: Mid October.
-
-## Usage Example
-
-Request a [Consumer Key on Pocket.](http://getpocket.com/developer/apps/)
-
-Include the PocketSharp namespace and it's associated models (you will need them later):
+A search for items containing `CSS`:

 ```csharp
-using PocketSharp;
-using PocketSharp.Models;
-```
+PocketClient client = new PocketClient("[YOUR_CONSUMER_KEY]", "[YOUR_ACCESS_CODE]");

-Initialize PocketClient with:
+List<PocketItem> items = await client.Search("css");

-```csharp
-PocketClient _client = new PocketClient("[YOUR_CONSUMER_KEY]", "[YOUR_ACCESS_CODE]");
-```
-
-Do a simple request - e.g. a search for `CSS`:
-
-```csharp
-var items = await _client.Search("css");
 items.ForEach(
 	item => Debug.WriteLine(item.ID + " | " + item.Title)
 );
@@ -77,293 +36,40 @@ Which will output:
    343693149 | CSS3 Transitions - Thank God We Have A Specification!
 	...

-## Create an instance
-
-Constructor:
-
-```csharp
-PocketClient(string consumerKey, string accessCode = null, Uri callbackUri = null)
-```
-
-`consumerKey`: The API key
-<br>
-`accessCode`: Provide an access code if the user is already authenticated
-<br>
-`callbackUri`: The callback URL is called by Pocket after authentication
-
-Example:
-
-```csharp
-PocketClient _client = new PocketClient(
-	consumerKey: "123498237423498723498723",
-	callbackUri: new Uri("http://ceecore.com"),
-	accessCode: "097809-oi987-izi8-jk98-oiuu89"
-);
-```
-
-You can change the _Access Code_ after initialization:
-
-```csharp
-_client.AccessCode = "[YOU_ACCESS_CODE]";
-```
-
-**Before authentication** you will need to provide the `callbackUri` for authentication requests.
-<br>
-**After authentication** you will need to provide the `accessCode`.
-
-## Account Authentication
-
-In order to communicate with a Pocket User, you will need a consumer key (which is generated by [creating a new application on Pocket](http://getpocket.com/developer/apps/)) and an **Access Code**.
-
-The authentication is a 3-step process:
-
-#### 1) Generate authentication URI
-
-Receive the **request code** and **authentication URI** from the library by calling `string GetRequestCode()`:
-
-```csharp
-string requestCode = await _client.GetRequestCode();
-// 0f453f2d-1605-8584-28fd-39af8e
-Uri authenticationUri = _client.GenerateAuthenticationUri();
-// https://getpocket.com/auth/authorize?request_token=0f453f2d-1605-8584-28fd-39af8e&redirect_uri=http%253a%252f%252fceecore.com
-```
-
-The _request code_ is stored internally, but you can also provide it as param in `GenerateAuthenticationUri(string requestCode = null)`.
-
-#### 2) Redirect to Pocket
-Next you need to redirect the user to the `authenticationUri`, which displays a prompt to grant permissions for the application (see image). After the user granted or denied, he/she is redirected to the `callbackUri`.
-
-![authentication screen](https://raw.github.com/ceee/PocketSharp/master/PocketSharp/authentication-screen.png)
-
-#### 3) Get Access Code
-Call `Task<string> GetAccessCode(string requestCode = null)`
-
-```csharp
-string accessCode = await _client.GetAccessCode();
-// fa8bfc16-69b3-4d22-7db7-84a58d
-```
-
-Again, the received _access code_ is stored internally.
-Note that `GetAccessCode` can only be called with an existing _request code_. If you need to re-authenticate a user, start again with Step 1).
-
-#### Important
-
-**Be sure to permanently store the _Access Code_ for your user.**
-<br>
-Without it you would always have to redo the authentication process.
-
-## Account Registration
-
-The `RegisterAccount` method exists in Pocket API v3, but is currently undocumented.
-<br>The user cannot authenticate directly after registration, as the account has to be activated via an opt-in link, which is sent to the e-mail address.
-
-```csharp
-bool isSuccess = await _client.RegisterAccount("myUsername", "me@mymail.com", "mypassword");
-```
-
-After registration you have to remind the user to check his/her mail account.
-
-## Get
-
-Get list of all items:
-
-```csharp
-List<PocketItem> items = await _client.Get();
-// equivalent to: await _client.Get(RetrieveFilter.All)
-```
-
-Get a list with specific parameters (explanation in the [Pocket Docs](http://getpocket.com/developer/docs/v3/retrieve)):
-
-```csharp
-List<PocketItem> items = await _client.Get(
-  State? state = null,
-  bool? favorite = null,
-  string tag = null,
-  ContentType? contentType = null,
-  Sort? sort = null,
-  string search = null,
-  string domain = null,
-  DateTime? since = null,
-  int? count = null,
-  int? offset = null 
-);
-```
-
-It's best to use parameters as _named parameters_, to avoid typing `null` values:
-
-```csharp
-List<PocketItem> items = await _client.Get(count: 10, offset: 20, sort: Sort.oldest);
-```
-
-Get item by ID:
-
-```csharp
-PocketItem item = await _client.Get(1298198);
-```
-
-Find items by a tag:
-
-```csharp
-List<PocketItem> items = await _client.SearchByTag("tutorial");
-```
-
-Find items by a search string.
-<br>PocketSharp uses an internal search, which is significantly faster than the Search API by Pocket.
-
-```csharp
-List<PocketItem> items = await _client.Search("css");
-```
-
-Find items by a search string by already available items:
-
-```csharp
-List<PocketItem> items = await _client.Search(myPocketItemList, "css");
-```
-
-Get all tags:
-
-```csharp
-List<PocketTag> items = await _client.GetTags();
-```
-
-Get a filtered list:
-
-```csharp
-List<PocketItem> items = await _client.Get(RetrieveFilter.Favorite);
-// returns favorites only
-```
-
-The RetrieveFilter Enum is specified as follows:
-
-```csharp
-enum RetrieveFilter { All, Unread, Archive, Favorite, Article, Video, Image }
-```
-
-## Add
-
-Adds a new item to your pocket list.
-Accepts four parameters, with `uri` being required.
-
-```csharp
-Task<PocketItem> Add(Uri uri, string[] tags = null, string title = null, string tweetID = null)
-```
-
-Example:
-
-```csharp
-PocketItem newItem = await _client.Add(
-	new Uri("http://www.neowin.net/news/full-build-2013-conference-sessions-listing-revealed"),
-	new string[] { "microsoft", "neowin", "build" }
-);
-```
-
-The title can be included for cases where an item does not have a title, which is typical for image or PDF URLs. If Pocket detects a title from the content of the page, this parameter will be ignored.
-
-If you are adding Pocket support to a Twitter client, please send along a reference to the tweet status id (with the tweetID). This allows Pocket to show the original tweet alongside the article.
-
-## Modify
-
-All Modify methods accept either the itemID (as int) or a `PocketItem` as parameter.
-
-Archive the specified item:
-
-```csharp
-bool isSuccess = await _client.Archive(myPocketItem);
-```
-
-Un-archive the specified item:
-
-```csharp
-bool isSuccess = await _client.Unarchive(myPocketItem);
-```
-
-Favorites the specified item:
-
-```csharp
-bool isSuccess = await _client.Favorite(myPocketItem);
-```
-
-Un-favorites the specified item:
-
-```csharp
-bool isSuccess = await _client.Unfavorite(myPocketItem);
-```
-
-Deletes the specified item:
-
-```csharp
-bool isSuccess = await _client.Delete(myPocketItem);
-```
-
-#### Modify tags
-
-Add tags to the specified item:
-
-```csharp
-bool isSuccess = await _client.AddTags(myPocketItem, new string[] { "css", "2013" });
-```
-
-Remove tags from the specified item:
-
-```csharp
-bool isSuccess = await _client.RemoveTags(myPocketItem, new string[] { "css", "2013" });
-```
-
-Remove all tags from the specified item:
-
-```csharp
-bool isSuccess = await _client.RemoveTags(myPocketItem);
-```
-
-Replaces all existing tags with new ones for the specified item:
-
-```csharp
-bool isSuccess = await _client.ReplaceTags(myPocketItem, new string[] { "css", "2013" });
-```
-
-Renames a tag for the specified item:
-
-```csharp
-bool isSuccess = await _client.RenameTag(myPocketItem, "oldTagName", "newTagName");
-```
-
-## Statistics
-
-The Pocket API supports retrieval of a simple statistics object.
-
-```csharp
-PocketStatistics statistics = await client.Statistics();
-// PocketStatistics: [CountAll], [CountRead], [CountUnread]
-```
-
 ---

-## Release History

- **1.5.1** (2013-09-30) `RetrieveFilter.All` didn't work; improve search speed
- **1.5.0** (2013-09-28) add statistics and registration API
- **1.4.0** (2013-09-21) rename `Retrieve` to `Get` + update IntelliSense documentation + add `GetTags` method
- **1.3.0** (2013-09-19) get Item by ID + tag modification bugfixes
- **1.2.1** (2013-09-18) correct parameter conversion for DateTime and Boolean
- **1.2.0** (2013-09-17) simplified retrieve methods
- **1.1.0** (2013-09-17) fix modification requests
- **1.0.0** (2013-09-15) convert to PCL & implement async
- **0.3.2** (2013-08-16) tag modification fixed and full retrieval of items for Retrieve method
- **0.3.1** (2013-07-07) authentication fixes
- **0.3.0** (2013-07-02) update authentication process 
- **0.2.0** (2013-06-27) add, modify item & modify tags
- **0.1.0** (2013-06-26) authentication & retrieve functionality
+## Supported platforms
+
+PocketSharp is a **Portable Class Library** (since 1.0.0), therefore it's compatible with multiple platforms:
+
+- **.NET** >= 4.5 (including WPF)
+- **Silverlight** >= 4
+- **Windows Phone** >= 7.5
+- **Windows Store**
+
+You can find examples for Silverlight 5, WP8 and WPF in the `PocketSharp.Examples` ([@github](https://github.com/ceee/PocketSharp/tree/master/PocketSharp.Examples)) folder.
+
+## What's next?
+
+- `cancellationToken` support for all methods

 ## Dependencies

 - [Microsoft.Bcl.Async](https://www.nuget.org/packages/Microsoft.Bcl.Async/)
 - [Microsoft.Net.Http](https://www.nuget.org/packages/Microsoft.Net.Http/)
 - [Newtonsoft.Json](https://www.nuget.org/packages/Newtonsoft.Json/)
+- [PropertyChanged.Fody](https://github.com/Fody/PropertyChanged)
+
+## Forked Dependencies
+
+- [NReadability](https://github.com/marek-stoj/NReadability) - converted to a PCL with minor adaptations
+- [SgmlReader](https://github.com/MindTouch/SGMLReader) - converted to a PCL

 ## Contributors
-| [![twitter/artistandsocial](http://gravatar.com/avatar/9c61b1f4307425f12f05d3adb930ba66?s=70)](http://twitter.com/artistandsocial "Follow @artistandsocial on Twitter") |
-|---|
-| [Tobias Klika @ceee](https://github.com/ceee) |
+| [![ceee](http://gravatar.com/avatar/9c61b1f4307425f12f05d3adb930ba66?s=70)](https://github.com/ceee "Tobias Klika") | [![ScottIsAFool](http://gravatar.com/avatar/6df656872a87b09a7470feb4867ed927?s=70)](https://github.com/ScottIsAFool "Scott Lovegrove") |
+|---|---|
+| [ceee](https://github.com/ceee) | [ScottIsAFool](https://github.com/ScottIsAFool) |

 ## License
Author	SHA1	Message	Date
swcs	da892067ad	resolve conflicts; make GetAccessCode obsolete	2013-10-26 13:16:35 +02:00
swcs	3992a988fc	Merge branch 'master' of github.com:ScottIsAFool/PocketSharp into ScottIsAFool-master	2013-10-26 13:05:14 +02:00
ScottIsAFool	2a98cfb0e4	Added new method to return username too	2013-10-25 15:49:47 +01:00
swcs	3057612872	update contributors	2013-10-25 15:22:13 +02:00
swcs	56180b5829	update contributors	2013-10-25 15:21:26 +02:00
swcs	2a08adef45	update version	2013-10-25 15:19:42 +02:00
swcs	abfb9f6d78	remove unused using	2013-10-25 15:05:47 +02:00
swcs	a1f6637e9d	retrieve API usage limits; rename Statistics() to GetUserStatistics();	2013-10-25 00:52:29 +02:00
swcs	8bce874504	Merge branch 'ScottIsAFool-master'	2013-10-25 00:05:46 +02:00
swcs	50ee8905c5	add PORTABLE constant to SgmlReader	2013-10-25 00:05:42 +02:00
swcs	4d2650072f	Merge branch 'master' of github.com:ScottIsAFool/PocketSharp into ScottIsAFool-master	2013-10-24 22:40:18 +02:00
ScottIsAFool	65e31ac2e2	Missed files for propertychanged	2013-10-24 21:37:52 +01:00
swcs	456c4f17f2	Merge branch 'master' of github.com:ScottIsAFool/PocketSharp into ScottIsAFool-master	2013-10-24 21:55:40 +02:00
ScottIsAFool	ee1e32b9ab	Added Fody/PropertyChanged	2013-10-24 18:44:22 +01:00
swcs	9d677eea5a	Merge pull request #7 from ScottIsAFool/master Made CallbackUri public	2013-10-24 00:44:11 -07:00
ScottIsAFool	64098518fa	Made CallbackUri public	2013-10-24 06:52:09 +01:00
swcs	cc6aab227d	Update README.md	2013-10-23 20:27:19 +02:00
swcs	543b3e8191	Update README.md	2013-10-23 20:26:40 +02:00
swcs	2186561fd8	update readme	2013-10-22 21:46:55 +02:00
swcs	8650883975	Merge branch 'master' of github.com:ceee/PocketSharp	2013-10-22 21:46:35 +02:00
swcs	6ede86c367	allow PocketSharp to be used in .NET 4.0	2013-10-22 21:46:24 +02:00
swcs	d373bdd9bf	Update README.md	2013-10-21 22:12:53 +02:00
swcs	b4ae55d8ab	update assembly information	2013-10-20 22:20:37 +02:00
swcs	aae43cf00d	bump version; update docs	2013-10-19 16:40:14 +02:00
swcs	a0e8022f1d	Merge branch 'master' of github.com:ceee/PocketSharp	2013-10-19 16:35:02 +02:00
swcs	4119dec95d	move utilites; catch HttpRequestException; Read Article from URI	2013-10-19 16:30:01 +02:00
swcs	cf2d929d3a	Update README.md	2013-10-18 19:28:32 +02:00
swcs	e772b8df9e	update some spelling mistakes	2013-10-17 15:43:23 +02:00
swcs	d9c4b4c51f	update documentation and website	2013-10-17 15:34:05 +02:00