namespace Deltares.Standard.Specifications
{
    /// <summary>
    /// 
    /// </summary>
    public interface ISpecification
    {
        /// <summary>
        /// Gets or sets the name of the specification. (Short description)
        /// </summary>
        /// <value>
        /// The name string value should be a required property for each specification.
        /// </value>
        string Name { get; set; }

        /// <summary>
        /// Gets or sets the description of the specification. (Long description)
        /// </summary>
        /// <value>
        /// The description string value.
        /// </value>
        string Description { get; set; }

        /// <summary>
        /// Determines whether the candidate satisfies the specification.
        /// </summary>
        /// <param name="candidate">The candidate.</param>
        /// <returns>
        ///   <c>true</c> if the candidate satisfies the specification otherwise, <c>false</c>.
        /// </returns>
        bool IsSatisfiedBy(object candidate);
    }

    /// <summary>
    /// 
    /// </summary>
    /// <typeparam name="TCandidate">The type of the candidate.</typeparam>
    public interface ISpecification<in TCandidate> : ISpecification
    {
        /// <summary>
        /// Determines whether the candidate satisfies the specification.
        /// </summary>
        /// <param name="candidate">The candidate.</param>
        /// <returns>
        ///   <c>true</c> if the candidate satisfies the specification otherwise, <c>false</c>.
        /// </returns>
        bool IsSatisfiedBy(TCandidate candidate);
    }
}