BizHawk/BizHawk.Emulation.Common/ServiceAttributes.cs

using System;
using System.Collections.Generic;
using System.Linq;

namespace BizHawk.Emulation.Common
{
	/// <summary>
	/// Should be added to any field of an IEmulatorService that is not implemented.
	/// By Convention it should also throw a NotImplementedException
	/// Any feature that does not have this attribute is assumed to be implemented
	/// </summary>
	public class FeatureNotImplementedAttribute : Attribute
	{
	}

	/// <summary>
	/// Should be added to any implementation of IEmulator to document any
	/// IEmulatorService (that is not an ISpecializedEmulatorService) that
	/// by design, will not be implemented by the core
	/// Any service that is unimplemented and not marked with this attribute is
	/// assumed to be a "TODO" that needs to be done but hasn't been done yet
	/// </summary>
	[AttributeUsage(AttributeTargets.Class)]
	public class ServiceNotApplicableAttribute : Attribute
	{
		public ServiceNotApplicableAttribute(params Type[] types)
		{
			NotApplicableTypes = types?.AsEnumerable() ?? Enumerable.Empty<Type>();
		}

		public IEnumerable<Type> NotApplicableTypes { get; }
	}
}