using System;
using System.Reflection;

namespace Chernobyl.Attribution
{
    /// <summary>
    /// An <see cref="Attribute"/> that is applied to an <see cref="Assembly"/>.
    /// When executed, instances of this type will execute any the
    /// <see cref="IProcessAttribute{TCustomAttributeProvider}"/> types found on 
    /// any types of the assembly attributed.
    /// </summary>
    [AttributeUsage(AttributeTargets.Assembly)]
    public class ProcessTypesAttribute : Attribute, IProcessAttribute<Assembly>
    {
        /// <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(Assembly attributeProvider)
        {
            attributeProvider.GetTypes().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; }
    }
}