Initial commit

Author: Paul C Roberts

.gitignore

@@ -0,0 +1,36 @@
+## Visual studio stuff
+*.suo
+*.user
+
+#ignore build contents
+[dD]ebug/
+[rR]elease/
+[bB]in/
+[oO]bj/
+[Ll]ast[Bb]uild.log
+
+# test stuff
+[Tt]est[Rr]esult*/
+[Bb]uild[Ll]og.*
+
+
+## vim files
+*.un~
+*~
+
+## nuget packages
+*/[pP]ackages/*/
+*.nupkg
+
+## nuget tools
+*/.nuget/
+
+##pyc
+*.pyc
+
+## files containing keys
+*.[Dd]o[Nn]ot[Ss]ync.*
+*.pfx
+
+## Stylecop cache
+[Ss]tyle[Cc]op.[Cc]ache

Dropbox.Api/ApiException.cs

@@ -0,0 +1,97 @@
+//-----------------------------------------------------------------------------
+// <copyright file="ApiException.cs" company="Dropbox Inc">
+//  Copyright (c) Dropbox Inc. All rights reserved.
+// </copyright>
+//-----------------------------------------------------------------------------
+
+namespace Dropbox.Api
+{
+    using System;
+
+    using Dropbox.Api.Babel;
+
+    /// <summary>
+    /// The exception type that will be raised by an <see cref="ITransport" />
+    /// implementation if there is an error processing the request.
+    /// </summary>
+    /// <typeparam name="TError">The type of the error.</typeparam>
+    public sealed class ApiException<TError> : Exception, IEncodable<ApiException<TError>>
+        where TError : IEncodable<TError>, new()
+    {
+        /// <summary>
+        /// Initializes a new instance of the <see cref="ApiException{TError}"/> class.
+        /// </summary>
+        /// <remarks>This constructor is only used when deserializing from JSON.</remarks>
+        public ApiException()
+            : this(default(TError))
+        {
+        }
+
+        /// <summary>
+        /// Initializes a new instance of the <see cref="ApiException{TError}"/> class.
+        /// </summary>
+        /// <param name="errorResponse">The error response.</param>
+        public ApiException(TError errorResponse)
+            : this(errorResponse, null, null)
+        {
+        }
+
+        /// <summary>
+        /// Initializes a new instance of the <see cref="ApiException{TError}"/> class.
+        /// </summary>
+        /// <param name="errorResponse">The error response.</param>
+        /// <param name="message">The message.</param>
+        public ApiException(TError errorResponse, string message)
+            : this(errorResponse, message, null)
+        {
+        }
+
+        /// <summary>
+        /// Initializes a new instance of the <see cref="ApiException{TError}"/> class.
+        /// </summary>
+        /// <param name="errorResponse">The error response.</param>
+        /// <param name="message">The message.</param>
+        /// <param name="inner">The inner.</param>
+        public ApiException(TError errorResponse, string message, Exception inner)
+            : base(message, inner)
+        {
+            this.ErrorResponse = errorResponse;
+        }
+
+        /// <summary>
+        /// Gets the error response.
+        /// </summary>
+        /// <value>
+        /// The error response.
+        /// </value>
+        public TError ErrorResponse { get; private set; }
+
+        /// <summary>
+        /// Encodes the object using the supplied encoder.
+        /// </summary>
+        /// <param name="encoder">The encoder being used to serialize the object.</param>
+        /// <exception cref="System.NotImplementedException"></exception>
+        void IEncodable<ApiException<TError>>.Encode(IEncoder encoder)
+        {
+            throw new NotSupportedException("Exceptions cannot be encoded");
+        }
+
+        /// <summary>
+        /// Decodes on object using the supplied decoder.
+        /// </summary>
+        /// <param name="decoder">The decoder used to deserialize the object.</param>
+        /// <returns>
+        /// The deserialized object. Note: this is not necessarily the current instance.
+        /// </returns>
+        /// <exception cref="System.NotImplementedException"></exception>
+        ApiException<TError> IEncodable<ApiException<TError>>.Decode(IDecoder decoder)
+        {
+            using (var obj = decoder.GetObject())
+            {
+                this.ErrorResponse = obj.GetFieldObject<TError>("reason");
+            }
+
+            return this;
+        }
+    }
+}

Dropbox.Api/Babel/Empty.cs

@@ -0,0 +1,40 @@
+//-----------------------------------------------------------------------------
+// <copyright file="Empty.cs" company="Dropbox Inc">
+//  Copyright (c) Dropbox Inc. All rights reserved.
+// </copyright>
+//-----------------------------------------------------------------------------
+
+namespace Dropbox.Api.Babel
+{
+    /// <summary>
+    /// An empty object used when a route doesn't have one or more of the
+    /// request, response, or error types specified.
+    /// </summary>
+    public sealed class Empty : IEncodable<Empty>
+    {
+        /// <summary>
+        /// A static instance of the <see cref="Empty"/> class.
+        /// </summary>
+        public static readonly Empty Instance = new Empty();
+
+        /// <summary>
+        /// Encodes the object using the supplied encoder.
+        /// </summary>
+        /// <param name="encoder">The encoder being used to serialize the object.</param>
+        public void Encode(IEncoder encoder)
+        {
+        }
+
+        /// <summary>
+        /// Decodes on object using the supplied decoder.
+        /// </summary>
+        /// <param name="decoder">The decoder used to deserialize the object.</param>
+        /// <returns>
+        /// The deserialized object. Note: this is not necessarily the current instance.
+        /// </returns>
+        public Empty Decode(IDecoder decoder)
+        {
+            return this;
+        }
+    }
+}

Dropbox.Api/Babel/IDecoder.cs

@@ -0,0 +1,90 @@
+//-----------------------------------------------------------------------------
+// <copyright file="IDecoder.cs" company="Dropbox Inc">
+//  Copyright (c) Dropbox Inc. All rights reserved.
+// </copyright>
+//-----------------------------------------------------------------------------
+
+namespace Dropbox.Api.Babel
+{
+    using System;
+    using System.Collections.Generic;
+
+    /// <summary>
+    /// Interface that is used to decode objects that implement the
+    /// <see cref="T:Dropbox.Api.Babel.IEncodable`1"/> interface.
+    /// </summary>
+    public interface IDecoder
+    {
+        /// <summary>
+        /// Used to get the name of the current union.
+        /// </summary>
+        /// <returns>The union name</returns>
+        string GetUnionName();
+
+        /// <summary>
+        /// Gets a context for the current object, the context object is used to access
+        /// individual fields.
+        /// </summary>
+        /// <returns>The decoder context for the current object.</returns>
+        IDecoderContext GetObject();
+
+        /// <summary>
+        /// Sets the current source for this instance.
+        /// </summary>
+        /// <param name="source">The source as a string.</param>
+        void SetSource(string source);
+
+        /// <summary>
+        /// Sets the current source for this instance.
+        /// </summary>
+        /// <param name="source">The source as a byte array.</param>
+        void SetSource(byte[] source);
+    }
+
+    /// <summary>
+    /// A context used to get decoded field values from an encoded object.
+    /// </summary>
+    public interface IDecoderContext : IDisposable
+    {
+        /// <summary>
+        /// Indicates whether the specified field is present in the object.
+        /// </summary>
+        /// <param name="name">The name of the field to check.</param>
+        /// <returns><c>true</c> if the field is present; <c>false</c> otherwise.</returns>
+        bool HasField(string name);
+
+        /// <summary>
+        /// Gets the value of a field.
+        /// </summary>
+        /// <typeparam name="T">The expected type of the field.</typeparam>
+        /// <param name="name">The name of the field to get.</param>
+        /// <returns>The decoded value of the field.</returns>
+        T GetField<T>(string name);
+
+        /// <summary>
+        /// Gets the value of a field which is an object.
+        /// </summary>
+        /// <typeparam name="T">The expected type of the object. This must implement the
+        /// <see cref="T:Dropbox.Api.Babel.IEncodable`1"/> interface.</typeparam>
+        /// <param name="name">The name of the field to get.</param>
+        /// <returns>The decoded value of the field.</returns>
+        T GetFieldObject<T>(string name) where T : IEncodable<T>, new();
+
+        /// <summary>
+        /// Gets the value of a field which is a list.
+        /// </summary>
+        /// <typeparam name="T">The expected type of the list elements.</typeparam>
+        /// <param name="name">The name of the field.</param>
+        /// <returns>The decoded list of items.</returns>
+        IEnumerable<T> GetFieldList<T>(string name);
+
+        /// <summary>
+        /// Gets the value of a field which is a list of objects that implement
+        /// <see cref="T:Dropbox.Api.Babel.IEncodable`1"/>.
+        /// </summary>
+        /// <typeparam name="T">The expected type of the list elements.</typeparam>
+        /// <param name="name">The name of the fields.</param>
+        /// <returns>The decoded list of items.</returns>
+        IEnumerable<T> GetFieldObjectList<T>(string name) where T : IEncodable<T>, new();
+    }
+}

Dropbox.Api/Babel/IEncodable.cs

@@ -0,0 +1,29 @@
+//-----------------------------------------------------------------------------
+// <copyright file="IEncodable.cs" company="Dropbox Inc">
+//  Copyright (c) Dropbox Inc. All rights reserved.
+// </copyright>
+//-----------------------------------------------------------------------------
+
+namespace Dropbox.Api.Babel
+{
+    /// <summary>
+    /// Interface implemented by all objects generated by the babel API generator.
+    /// This is used to support transport serialization of objects.
+    /// </summary>
+    /// <typeparam name="T">The type of the object to encode.</typeparam>
+    public interface IEncodable<T>
+    {
+        /// <summary>
+        /// Encodes the object using the supplied encoder.
+        /// </summary>
+        /// <param name="encoder">The encoder being used to serialize the object.</param>
+        void Encode(IEncoder encoder);
+
+        /// <summary>
+        /// Decodes on object using the supplied decoder.
+        /// </summary>
+        /// <param name="decoder">The decoder used to deserialize the object.</param>
+        /// <returns>The deserialized object. Note: this is not necessarily the current instance.</returns>
+        T Decode(IDecoder decoder);
+    }
+}

Dropbox.Api/Babel/IEncoder.cs

@@ -0,0 +1,80 @@
+//-----------------------------------------------------------------------------
+// <copyright file="IEncoder.cs" company="Dropbox Inc">
+//  Copyright (c) Dropbox Inc. All rights reserved.
+// </copyright>
+//-----------------------------------------------------------------------------
+
+namespace Dropbox.Api.Babel
+{
+    using System;
+    using System.Collections.Generic;
+
+    /// <summary>
+    /// Interface that is used to encode objects that implement the
+    /// <see cref="T:Dropbox.Api.Babel.IEncodable`1"/> interface.
+    /// </summary>
+    public interface IEncoder
+    {
+        /// <summary>
+        /// Adds an object, returning an encoder context that can be used to
+        /// add fields to the object.
+        /// </summary>
+        /// <returns>The encoder context.</returns>
+        IEncoderContext AddObject();
+
+        /// <summary>
+        /// Gets the encoded object as a string.
+        /// </summary>
+        /// <returns>The string encoding of the object.</returns>
+        string GetEncodedString();
+
+        /// <summary>
+        /// Gets the encoded object as a byte array.
+        /// </summary>
+        /// <returns>The byte array encoding of the object.</returns>
+        byte[] GetEncodedBytes();
+    }
+
+    /// <summary>
+    /// A context used to set field values for an encoded object.
+    /// </summary>
+    public interface IEncoderContext : IDisposable
+    {
+        /// <summary>
+        /// Adds a field to the current encoding context.
+        /// </summary>
+        /// <typeparam name="T">The type of the field that is being added.</typeparam>
+        /// <param name="name">The field name.</param>
+        /// <param name="value">The value of the field.</param>
+        void AddField<T>(string name, T value);
+
+        /// <summary>
+        /// Adds a field that implements the
+        /// <see cref="T:Dropbox.Api.Babel.IEncodable`1"/> interface to the current
+        /// encoding context.
+        /// </summary>
+        /// <typeparam name="T">The type of the field that is being added.</typeparam>
+        /// <param name="name">The field name.</param>
+        /// <param name="value">The value of the field.</param>
+        void AddFieldObject<T>(string name, T value)
+            where T : IEncodable<T>, new();
+
+        /// <summary>
+        /// Adds a field that is a list of items.
+        /// </summary>
+        /// <typeparam name="T">The element type of each list item.</typeparam>
+        /// <param name="name">The field name.</param>
+        /// <param name="value">The value of the field.</param>
+        void AddFieldList<T>(string name, IEnumerable<T> value);
+
+        /// <summary>
+        /// Adds a field that is a list of objects that implement the
+        /// <see cref="T:Dropbox.Api.Babel.IEncodable`1"/> interface.
+        /// </summary>
+        /// <typeparam name="T">The element type of each list item.</typeparam>
+        /// <param name="name">The field name.</param>
+        /// <param name="value">The value of the field.</param>
+        void AddFieldObjectList<T>(string name, IEnumerable<T> value)
+            where T : IEncodable<T>, new();
+    }
+}