1 // ***********************************************************************
2 // Copyright (c) 2014 Charlie Poole
4 // Permission is hereby granted, free of charge, to any person obtaining
5 // a copy of this software and associated documentation files (the
6 // "Software"), to deal in the Software without restriction, including
7 // without limitation the rights to use, copy, modify, merge, publish,
8 // distribute, sublicense, and/or sell copies of the Software, and to
9 // permit persons to whom the Software is furnished to do so, subject to
10 // the following conditions:
12 // The above copyright notice and this permission notice shall be
13 // included in all copies or substantial portions of the Software.
15 // THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
16 // EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
17 // MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
18 // NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
19 // LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
20 // OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
21 // WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
22 // ***********************************************************************
25 #define NUNIT_FRAMEWORK
30 using System.Collections.Generic;
32 namespace NUnit.Framework.Interfaces
37 /// The IFixtureBuilder interface is exposed by a class that knows how to
38 /// build a TestFixture from one or more Types. In general, it is exposed
39 /// by an attribute, but may be implemented in a helper class used by the
40 /// attribute in some cases.
42 public interface IFixtureBuilder
45 /// Build one or more TestFixtures from type provided. At least one
46 /// non-null TestSuite must always be returned, since the method is
47 /// generally called because the user has marked the target class as
48 /// a fixture. If something prevents the fixture from being used, it
49 /// will be returned nonetheless, labelled as non-runnable.
51 /// <param name="typeInfo">The type info of the fixture to be used.</param>
52 /// <returns>A TestSuite object or one derived from TestSuite.</returns>
53 // TODO: This should really return a TestFixture, but that requires changes to the Test hierarchy.
54 IEnumerable<TestSuite> BuildFrom(ITypeInfo typeInfo);