using System;
using System.Reflection;

namespace Chernobyl.Attribution
{
    /// <summary>
    /// An <see cref="Attribute"/> that is applied to any class or struct.
    /// When executed, instances of this type will execute any the
    /// <see cref="IProcessAttribute{TCustomAttributeProvider}"/> types found on 
    /// any methods of the type attributed. 
    /// </summary>
    [AttributeUsage(AttributeTargets.Struct |
                    AttributeTargets.Class)]
    public class ProcessMethodsAttribute : Attribute, IProcessAttribute<Type>
    {
        /// <summary>
        /// Performs the task requested on the <see cref="ICustomAttributeProvider" />
        /// passed in.
        /// </summary>
        /// <param name="attributeProvider">The <see cref="ICustomAttributeProvider" />
        /// this <see cref="Attribute" /> was applied to and that is to be
        /// processed.</param>
        public void Process(Type attributeProvider)
        {
            attributeProvider.GetMethods().Process(Inherited);
        }

        /// <summary>
        /// True if this instance should look up the hierarchy chain of each
        /// <see cref="ICustomAttributeProvider"/> for 
        /// <see cref="IProcessAttribute{TCustomAttributeProvider}"/> attributes.
        /// </summary>
        public bool Inherited { get; set; }
    }
}