using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Reflection;

namespace Developpez.Dotnet.Reflection
{
    /// <summary>
    /// Fournit des méthodes d'extension pour faciliter l'utilisation de la réflexion
    /// </summary>
    public static class ReflectionExtensions
    {
        #region Type extensions

        /// <summary>
        /// Détermine si un type hérite d'un autre type, ou implémente une interface
        /// </summary>
        /// <param name="type">Le type à vérifier</param>
        /// <param name="superType">Le type de base dont <c>type</c> doit hériter</param>
        /// <returns>true si <c>type</c> est <c>superType</c>, hérite de <c>superType</c>, ou implémente <c>superType</c>. Sinon, false</returns>
        public static bool Is(this Type type, Type superType)
        {
            return superType.IsAssignableFrom(type);
        }

        /// <summary>
        /// Détermine si un type hérite d'un autre type, ou implémente une interface
        /// </summary>
        /// <typeparam name="T">Le type de base dont <c>type</c> doit hériter</typeparam>
        /// <param name="type">Le type à vérifier</param>
        /// <returns>true si <c>type</c> est <c>T</c>, hérite de <c>T</c>, ou implémente <c>T</c>. Sinon, false</returns>
        public static bool Is<T>(this Type type)
        {
            return type.Is(typeof(T));
        }

        /// <summary>
        /// Indique si un type est nullable.
        /// </summary>
        /// <param name="type">Type dont on veut vérifier s'il est nullable</param>
        /// <returns>true si <c>type</c> est un type référence ou un type générique Nullable&lt;T&gt;, false sinon</returns>
        public static bool IsNullable(this Type type)
        {
            if (type.IsValueType)
            {
                return type.IsGenericType
                    && type.GetGenericTypeDefinition() == typeof(Nullable<>);
            }
            return true;
        }

        /// <summary>
        /// Renvoie la valeur par défaut du type spécifié
        /// </summary>
        /// <param name="type">Le type dont on veut récupérer la valeur par défaut</param>
        /// <returns>La valeur par défaut du type</returns>
        public static object GetDefaultValue(this Type type)
        {
            if (type.IsValueType && type != typeof(void))
                return Activator.CreateInstance(type);
            return null;
        }

        #endregion

        #region ICustomAttributeProvider extensions

        /// <summary>
        /// Détermine si un attribut est appliqué à un objet de réflexion.
        /// </summary>
        /// <param name="reflectionObject">L'objet de réflexion à vérifier</param>
        /// <param name="attributeType">Le type de l'attribut à rechercher</param>
        /// <returns>true si l'attribut spécifié est appliqué à l'objet de réflexion, false sinon</returns>
        public static bool HasAttribute(this ICustomAttributeProvider reflectionObject, Type attributeType)
        {
            return reflectionObject.IsDefined(attributeType, true);
        }

        /// <summary>
        /// Détermine si un attribut est appliqué à un objet de réflexion.
        /// </summary>
        /// <param name="reflectionObject">L'objet de réflexion à vérifier</param>
        /// <param name="attributeType">Le type de l'attribut à rechercher</param>
        /// <param name="inherit">true pour rechercher aussi dans les ancêtres, false sinon</param>
        /// <returns>true si l'attribut spécifié est appliqué à l'objet de réflexion, false sinon</returns>
        public static bool HasAttribute(this ICustomAttributeProvider reflectionObject, Type attributeType, bool inherit)
        {
            return reflectionObject.IsDefined(attributeType, inherit);
        }

        /// <summary>
        /// Récupère les attributs appliqués à un objet de réflexion.
        /// </summary>
        /// <param name="reflectionObject">L'objet de réflexion dont on veut récupérer les attributs</param>
        /// <returns>Une liste des attributs appliqués à l'objet de réflexion</returns>
        public static IEnumerable<Attribute> GetAttributes(this ICustomAttributeProvider reflectionObject)
        {
            return reflectionObject.GetAttributes(true);
        }

        /// <summary>
        /// Récupère les attributs appliqués à un objet de réflexion.
        /// </summary>
        /// <param name="reflectionObject">L'objet de réflexion dont on veut récupérer les attributs</param>
        /// <param name="inherit">true pour rechercher aussi dans les ancêtres, false sinon</param>
        /// <returns>Une liste des attributs du type demandé appliqués à l'objet de réflexion</returns>
        public static IEnumerable<Attribute> GetAttributes(this ICustomAttributeProvider reflectionObject, bool inherit)
        {
            return reflectionObject.GetCustomAttributes(inherit).Cast<Attribute>();
        }

        /// <summary>
        /// Récupère les attributs appliqués à un objet de réflexion.
        /// </summary>
        /// <param name="reflectionObject">L'objet de réflexion dont on veut récupérer les attributs</param>
        /// <param name="attributeType">Le type de l'attribut recherché</param>
        /// <returns>Une liste des attributs du type demandé appliqués à l'objet de réflexion</returns>
        public static IEnumerable<Attribute> GetAttributes(this ICustomAttributeProvider reflectionObject, Type attributeType)
        {
            return reflectionObject.GetAttributes(attributeType, true);
        }

        /// <summary>
        /// Récupère les attributs appliqués à un objet de réflexion.
        /// </summary>
        /// <param name="reflectionObject">L'objet de réflexion dont on veut récupérer les attributs</param>
        /// <param name="attributeType">Le type de l'attribut recherché</param>
        /// <param name="inherit">true pour rechercher aussi dans les ancêtres, false sinon</param>
        /// <returns>Une liste des attributs du type demandé appliqués à l'objet de réflexion</returns>
        public static IEnumerable<Attribute> GetAttributes(this ICustomAttributeProvider reflectionObject, Type attributeType, bool inherit)
        {
            return reflectionObject.GetCustomAttributes(attributeType, inherit).Cast<Attribute>();
        }

        /// <summary>
        /// Récupère un attribut appliqué à un objet de réflexion.
        /// </summary>
        /// <param name="reflectionObject">L'objet de réflexion dont on veut récupérer un attribut</param>
        /// <param name="attributeType">Le type de l'attribut recherché</param>
        /// <returns>L'attribut recherché s'il existe, null sinon</returns>
        public static Attribute GetAttribute(this ICustomAttributeProvider reflectionObject, Type attributeType)
        {
            return reflectionObject.GetAttribute(attributeType, true);
        }

        /// <summary>
        /// Récupère un attribut appliqué à un objet de réflexion.
        /// </summary>
        /// <param name="reflectionObject">L'objet de réflexion dont on veut récupérer un attribut</param>
        /// <param name="attributeType">Le type de l'attribut recherché</param>
        /// <param name="inherit">true pour rechercher aussi dans les ancêtres, false sinon</param>
        /// <returns>L'attribut recherché s'il existe, null sinon</returns>
        public static Attribute GetAttribute(this ICustomAttributeProvider reflectionObject, Type attributeType, bool inherit)
        {
            return reflectionObject.GetCustomAttributes(attributeType, inherit).Cast<Attribute>().FirstOrDefault();
        }

        /// <summary>
        /// Détermine si un attribut est appliqué à un objet de réflexion.
        /// </summary>
        /// <typeparam name="T">Le type de l'attribut à rechercher</typeparam>
        /// <param name="reflectionObject">L'objet de réflexion à vérifier</param>
        /// <returns>true si l'attribut spécifié est appliqué à l'objet de réflexion, false sinon</returns>
        public static bool HasAttribute<T>(this ICustomAttributeProvider reflectionObject)
            where T : Attribute
        {
            return reflectionObject.HasAttribute(typeof(T));
        }

        /// <summary>
        /// Détermine si un attribut est appliqué à un objet de réflexion.
        /// </summary>
        /// <typeparam name="T">Le type de l'attribut à rechercher</typeparam>
        /// <param name="reflectionObject">L'objet de réflexion à vérifier</param>
        /// <param name="inherit">true pour rechercher aussi dans les ancêtres, false sinon</param>
        /// <returns>true si l'attribut spécifié est appliqué à l'objet de réflexion, false sinon</returns>
        public static bool HasAttribute<T>(this ICustomAttributeProvider reflectionObject, bool inherit)
            where T : Attribute
        {
            return reflectionObject.HasAttribute(typeof(T), inherit);
        }

        /// <summary>
        /// Récupère les attributs appliqués à un objet de réflexion.
        /// </summary>
        /// <typeparam name="T">Le type de l'attribut recherché</typeparam>
        /// <param name="reflectionObject">L'objet de réflexion dont on veut récupérer les attributs</param>
        /// <returns>Une liste des attributs du type demandé appliqués à l'objet de réflexion</returns>
        public static IEnumerable<T> GetAttributes<T>(this ICustomAttributeProvider reflectionObject)
            where T : Attribute
        {
            return reflectionObject.GetAttributes(typeof(T)).Cast<T>();
        }

        /// <summary>
        /// Récupère les attributs appliqués à un objet de réflexion.
        /// </summary>
        /// <typeparam name="T">Le type de l'attribut recherché</typeparam>
        /// <param name="reflectionObject">L'objet de réflexion dont on veut récupérer les attributs</param>
        /// <param name="inherit">true pour rechercher aussi dans les ancêtres, false sinon</param>
        /// <returns>Une liste des attributs du type demandé appliqués à l'objet de réflexion</returns>
        public static IEnumerable<T> GetAttributes<T>(this ICustomAttributeProvider reflectionObject, bool inherit)
            where T : Attribute
        {
            return reflectionObject.GetAttributes(typeof(T), inherit).Cast<T>();
        }

        /// <summary>
        /// Récupère un attribut appliqué à un objet de réflexion.
        /// </summary>
        /// <typeparam name="T">Le type de l'attribut recherché</typeparam>
        /// <param name="reflectionObject">L'objet de réflexion dont on veut récupérer un attribut</param>
        /// <returns>L'attribut recherché s'il existe, null sinon</returns>
        public static T GetAttribute<T>(this ICustomAttributeProvider reflectionObject)
            where T : Attribute
        {
            return reflectionObject.GetAttribute(typeof(T)) as T;
        }

        /// <summary>
        /// Récupère un attribut appliqué à un objet de réflexion.
        /// </summary>
        /// <typeparam name="T">Le type de l'attribut recherché</typeparam>
        /// <param name="reflectionObject">L'objet de réflexion dont on veut récupérer un attribut</param>
        /// <param name="inherit">true pour rechercher aussi dans les ancêtres, false sinon</param>
        /// <returns>L'attribut recherché s'il existe, null sinon</returns>
        public static T GetAttribute<T>(this ICustomAttributeProvider reflectionObject, bool inherit)
            where T : Attribute
        {
            return reflectionObject.GetAttribute(typeof(T), inherit) as T;
        }

        #endregion
    }
}