view API/Objects/Requirement/Validation.cs @ 339:50cd43bf51b3

Re #27: Unit requirements * Add tri-state enum (passed, failed, not applicable) and helper class
author IBBoard <dev@ibboard.co.uk>
date Sun, 03 Apr 2011 19:40:42 +0000
parents
children 47acc63cf529
line wrap: on
line source

// This file (Validation.cs) is a part of the IBBoard.WarFoundry.API project and is copyright 2011 IBBoard
//
// The file and the library/program it is in are licensed and distributed, without warranty, under the GNU Affero GPL license, either version 3 of the License or (at your option) any later version. Please see COPYING for more information and the full license.
using System;

namespace IBBoard.WarFoundry.API.Objects.Requirement
{
	/// <summary>
	/// A custom enum for validation to distinguish between "validation wasn't necessary" and "validation passed".
	/// This should allow for easier handling of failed requirements later being satisfied.
	/// </summary>
	public enum Validation
	{
		Passed = 1,
		Failed = 2,
		NotApplicable = 3
	}

	/// <summary>
	/// A helper class to handle the enums and treat them as booleans where a pass/fail is all that is necessary.
	/// </summary>
	public class Validates
	{
		/// <summary>
		/// Checks if the validation was okay (pass or not applicable)
		/// </summary>
		/// <returns>
		/// <code>true</code> if the validation passed or was not applicable, else <code>false</code>
		/// </returns>
		/// <param name='passed'>
		/// The Validation enum value to check
		/// </param>
		public static bool AsOkay(Validation result)
		{
			return (result | Validation.Passed) == Validation.Passed;
		}

		/// <summary>
		/// Checks if the validation result was not okay (failed or not applicable). Note that this is different
		/// to <code>!Validates.AsOkay(result)</code> because this method treats not applicable as not being okay.
		/// </summary>
		/// <returns>
		/// <code>true</code> if the validation failed or was not applicable, else <code>false</code>
		/// </returns>
		/// <param name='result'>
		/// The Validation enum value to check
		/// </param>
		public static bool AsNotOkay (Validation result)
		{
			return (result | Validation.Failed) == Validation.Failed;
		}
	}
}