Merge pull request #1 in SDK/evernote-sdk-csharp from ~AFAN/evernote-…

…sdk-csharp:master to master

* commit '7691321219f278cca0770d39d8f8be41c6170d49':
  Bump up the version number + auto-formatting
  Evernote Cloud SDK 1.29, built with Thrift 0.10.0

README.md

@@ -1,45 +1,43 @@
-Evernote SDK for C#
-========================================
+# Evernote SDK for C#
 
-Evernote API version 1.25
+Evernote API version 1.29
+
+## Overview
 
-Overview
---------
 This SDK contains wrapper code used to call the Evernote Cloud API from C# applications.
 
 The SDK also contains three sample solutions. The solution in sample/client demonstrates the basic use of the SDK in a .NET application like you might build for the Windows desktop. The solution in sample/wp7 demonstrates the basic use of the SDK in a Windows Phone 7 Silverlight application. The solution in sample/win8 demonstrates the basic use of the SDK in a Windows 8 XAML/C# Store App.
 
-Prerequisites
--------------
+## Prerequisites
+
 In order to use the code in this SDK, you need to obtain an API key from http://dev.evernote.com/documentation/cloud. You'll also find full API documentation on that page.
 
-In order to run the sample code, you need a user account on the sandbox service where you will do your development. Sign up for an account at https://sandbox.evernote.com/Registration.action 
+In order to run the sample code, you need a user account on the sandbox service where you will do your development. Sign up for an account at https://sandbox.evernote.com/Registration.action
 
 In order to run the client client sample code, you need a developer token. Get one at https://sandbox.evernote.com/api/DeveloperToken.action
 
-Getting Started - Windows
--------------------------
-The project in sample\client demonstrates the basics of using the Evernote API, using developer tokens to simplify the authentication process while you're learning. 
-
-1. Open sample\client\Evernote.sln
-2. In the Solution Explorer, open the SampleApp project and then the EDAMTest.cs file.
-3. Scroll down to the top of the EDAMTest class and fill in your Evernote developer token.
-4. Build the solution, which produces a command-line application.
-5. Run the sample app
-
-Getting Started - Windows Phone 7
----------------------------------
-1. Open sample\wp7\EvernoteSample.sln. 
-2. In the Solution Explorer, open the EvernoteSample project and then the Sample.cs file.
-3. Scroll down to the top of the EDAMTest class and fill in your Evernote developer token.
-4. Build the solution and run it in the Windows Phone Emulator.
-5. Click the "Start the connection process" button in the sample app.
-
-
-Getting Started - Windows 8
----------------------------------
-1. Open sample\win8\EvernoteSample.sln in Visual Studio 12 or 13.
-2. In the Solution Explorer, open the EvernoteSample project and then the Sample.cs file.
-3. Scroll down to the top of the EDAMTest class and fill in your Evernote developer token.
-4. Build the solution and run it.
-5. Click the "Start the connection process" button in the sample app.
+## Getting Started - Windows
+
+The project in sample\client demonstrates the basics of using the Evernote API, using developer tokens to simplify the authentication process while you're learning.
+
+1.  Open sample\client\Evernote.sln
+2.  In the Solution Explorer, open the SampleApp project and then the EDAMTest.cs file.
+3.  Scroll down to the top of the EDAMTest class and fill in your Evernote developer token.
+4.  Build the solution, which produces a command-line application.
+5.  Run the sample app
+
+## Getting Started - Windows Phone 7
+
+1.  Open sample\wp7\EvernoteSample.sln.
+2.  In the Solution Explorer, open the EvernoteSample project and then the Sample.cs file.
+3.  Scroll down to the top of the EDAMTest class and fill in your Evernote developer token.
+4.  Build the solution and run it in the Windows Phone Emulator.
+5.  Click the "Start the connection process" button in the sample app.
+
+## Getting Started - Windows 8
+
+1.  Open sample\win8\EvernoteSample.sln in Visual Studio 12 or 13.
+2.  In the Solution Explorer, open the EvernoteSample project and then the Sample.cs file.
+3.  Scroll down to the top of the EDAMTest class and fill in your Evernote developer token.
+4.  Build the solution and run it.
+5.  Click the "Start the connection process" button in the sample app.

src/Evernote/EDAM/Error/EDAMErrorCode.cs

@@ -1,11 +1,90 @@
 /**
- * Autogenerated by Thrift
+ * Autogenerated by Thrift Compiler (1.0.0-dev)
  *
  * DO NOT EDIT UNLESS YOU ARE SURE THAT YOU KNOW WHAT YOU ARE DOING
+ *  @generated
  */
 
 namespace Evernote.EDAM.Error
 {
+  /// <summary>
+  /// * Numeric codes indicating the type of error that occurred on the
+  /// * service.
+  /// * <dl>
+  /// *   <dt>UNKNOWN</dt>
+  /// *     <dd>No information available about the error</dd>
+  /// *   <dt>BAD_DATA_FORMAT</dt>
+  /// *     <dd>The format of the request data was incorrect</dd>
+  /// *   <dt>PERMISSION_DENIED</dt>
+  /// *     <dd>Not permitted to perform action</dd>
+  /// *   <dt>INTERNAL_ERROR</dt>
+  /// *     <dd>Unexpected problem with the service</dd>
+  /// *   <dt>DATA_REQUIRED</dt>
+  /// *     <dd>A required parameter/field was absent</dd>
+  /// *   <dt>LIMIT_REACHED</dt>
+  /// *     <dd>Operation denied due to data model limit</dd>
+  /// *   <dt>QUOTA_REACHED</dt>
+  /// *     <dd>Operation denied due to user storage limit</dd>
+  /// *   <dt>INVALID_AUTH</dt>
+  /// *     <dd>Username and/or password incorrect</dd>
+  /// *   <dt>AUTH_EXPIRED</dt>
+  /// *     <dd>Authentication token expired</dd>
+  /// *   <dt>DATA_CONFLICT</dt>
+  /// *     <dd>Change denied due to data model conflict</dd>
+  /// *   <dt>ENML_VALIDATION</dt>
+  /// *     <dd>Content of submitted note was malformed</dd>
+  /// *   <dt>SHARD_UNAVAILABLE</dt>
+  /// *     <dd>Service shard with account data is temporarily down</dd>
+  /// *   <dt>LEN_TOO_SHORT</dt>
+  /// *     <dd>Operation denied due to data model limit, where something such
+  /// *         as a string length was too short</dd>
+  /// *   <dt>LEN_TOO_LONG</dt>
+  /// *     <dd>Operation denied due to data model limit, where something such
+  /// *         as a string length was too long</dd>
+  /// *   <dt>TOO_FEW</dt>
+  /// *     <dd>Operation denied due to data model limit, where there were
+  /// *         too few of something.</dd>
+  /// *   <dt>TOO_MANY</dt>
+  /// *     <dd>Operation denied due to data model limit, where there were
+  /// *         too many of something.</dd>
+  /// *   <dt>UNSUPPORTED_OPERATION</dt>
+  /// *     <dd>Operation denied because it is currently unsupported.</dd>
+  /// *   <dt>TAKEN_DOWN</dt>
+  /// *     <dd>Operation denied because access to the corresponding object is
+  /// *         prohibited in response to a take-down notice.</dd>
+  /// *   <dt>RATE_LIMIT_REACHED</dt>
+  /// *     <dd>Operation denied because the calling application has reached
+  /// *         its hourly API call limit for this user.</dd>
+  /// *   <dt>BUSINESS_SECURITY_LOGIN_REQUIRED</dt>
+  /// *     <dd>Access to a business account has been denied because the user must complete
+  /// *        additional steps in order to comply with business security requirements.</dd>
+  /// *   <dt>DEVICE_LIMIT_REACHED</dt>
+  /// *     <dd>Operation denied because the user has exceeded their maximum allowed
+  /// *        number of devices.</dd>
+  /// *   <dt>OPENID_ALREADY_TAKEN</dt>
+  /// *     <dd>Operation failed because the Open ID is already associated with another user.</dd>
+  /// *   <dt>INVALID_OPENID_TOKEN</dt>
+  /// *     <dd>Operation denied because the Open ID token is invalid. Please re-issue a valid
+  /// *        token.</dd>
+  /// *	 <dt>USER_NOT_REGISTERED</dt>
+  /// *     <dd>There is no Evernote user associated with this OpenID account,
+  /// *     	   and no Evernote user with a matching email</dd>
+  /// *	 <dt>USER_NOT_ASSOCIATED</dt>
+  /// *     <dd>There is no Evernote user associated with this OpenID account,
+  /// *		   but Evernote user with matching email exists</dd>
+  /// *	 <dt>USER_ALREADY_ASSOCIATED</dt>
+  /// * 	   <dd>Evernote user is already associated with this provider
+  /// *		   using a different email address.</dd>
+  /// *	 <dt>ACCOUNT_CLEAR</dt>
+  /// *     <dd>The user's account has been disabled. Clients should deal with this errorCode
+  /// *       by logging the user out and purging all locally saved content, including local
+  /// *       edits not yet pushed to the server.</dd>
+  /// *	 <dt>SSO_AUTHENTICATION_REQUIRED</dt>
+  ///  *     <dd>SSO authentication is the only tyoe of authentication allowed for the user's
+  ///  *     account. This error is thrown when the user attempts to authenticate by another
+  ///   *     method (password, OpenId, etc).</dd>
+  ///  * </dl>
+  /// </summary>
   public enum EDAMErrorCode
   {
     UNKNOWN = 1,
@@ -27,5 +106,14 @@ public enum EDAMErrorCode
     UNSUPPORTED_OPERATION = 17,
     TAKEN_DOWN = 18,
     RATE_LIMIT_REACHED = 19,
+    BUSINESS_SECURITY_LOGIN_REQUIRED = 20,
+    DEVICE_LIMIT_REACHED = 21,
+    OPENID_ALREADY_TAKEN = 22,
+    INVALID_OPENID_TOKEN = 23,
+    USER_NOT_ASSOCIATED = 24,
+    USER_NOT_REGISTERED = 25,
+    USER_ALREADY_ASSOCIATED = 26,
+    ACCOUNT_CLEAR = 27,
+    SSO_AUTHENTICATION_REQUIRED = 28,
   }
 }

src/Evernote/EDAM/Error/EDAMInvalidContactReason.cs

@@ -0,0 +1,49 @@
+/**
+ * Autogenerated by Thrift Compiler (1.0.0-dev)
+ *
+ * DO NOT EDIT UNLESS YOU ARE SURE THAT YOU KNOW WHAT YOU ARE DOING
+ *  @generated
+ */
+
+namespace Evernote.EDAM.Error
+{
+  /// <summary>
+  /// An enumeration that provides a reason for why a given contact was invalid, for example,
+  /// as thrown via an EDAMInvalidContactsException.
+  /// 
+  /// <dl>
+  ///   <dt>BAD_ADDRESS</dt>
+  ///     <dd>The contact information does not represent a valid address for a recipient.
+  ///         Clients should be validating and normalizing contacts, so receiving this
+  ///         error code commonly represents a client error.
+  ///         </dd>
+  ///   <dt>DUPLICATE_CONTACT</dt>
+  ///     <dd>If the method throwing this exception accepts a list of contacts, this error
+  ///         code indicates that the given contact is a duplicate of another contact in
+  ///         the list.  Note that the server may clean up contacts, and that this cleanup
+  ///         occurs before checking for duplication.  Receiving this error is commonly
+  ///         an indication of a client issue, since client should be normalizing contacts
+  ///         and removing duplicates. All instances that are duplicates are returned.  For
+  ///         example, if a list of 5 contacts has the same e-mail address twice, the two
+  ///         conflicting e-mail address contacts will be returned.
+  ///         </dd>
+  ///   <dt>NO_CONNECTION</dt>
+  ///     <dd>Indicates that the given contact, an Evernote type contact, is not connected
+  ///         to the user for which the call is being made. It is possible that clients are
+  ///         out of sync with the server and should re-synchronize their identities and
+  ///         business user state. See Identity.userConnected for more information on user
+  ///         connections.
+  ///         </dd>
+  /// </dl>
+  /// 
+  /// Note that if multiple reasons may apply, only one is returned. The precedence order
+  /// is BAD_ADDRESS, DUPLICATE_CONTACT, NO_CONNECTION, meaning that if a contact has a bad
+  /// address and is also duplicated, it will be returned as a BAD_ADDRESS.
+  /// </summary>
+  public enum EDAMInvalidContactReason
+  {
+    BAD_ADDRESS = 0,
+    DUPLICATE_CONTACT = 1,
+    NO_CONNECTION = 2,
+  }
+}