ActivateAnything 0.3.0
An `AnythingActivator` will make an extreme effort to find and instantiate a concrete class
which is assignable to a `Type`, whether or not the Type is concrete, whether or not the
Type has constructor dependencies, whether or not a suitable concrete subtype is found
in any currently loaded `Assembly`.
The attempt to find and instantiate suitable Types is rule-driven.
There are three kinds of `IActivateAnythingRule`.
- `IFindTypeRule` provides rules for where to look for candidate concrete subtypes of an abstract type
- `IActivateInstanceRule` simply returns an instance of a concrete type.
- `IChooseConstructorRule` rules for how to choose between constructors when a concrete `Type` has been chosen.
The <em>extremity</em> of the effort lies in its recursive attempt to find and construct the <em>dependencies</em>.
ActivateAnything
Activate.New<T>()
…will make an extreme effort to find and instantiate a concrete class which is assignable to a Type, whether or not the Type is concrete, whether or not the Type has constructor dependencies, whether or not a suitable concrete subtype is found in any currently loaded Assembly.
The attempt to find and instantiate suitable Types is driven by three kinds of IActivateAnythingRule.
IActivateInstanceRulesimply returns an instance of a concrete type.IFindTypeRuleprovides rules for where to look for candidate concrete subtypes of an abstract typeIChooseConstructorRulerules for how to choose between constructors when a concreteTypehas been chosen.
The extremity of the effort lies in its recursive attempt to find and construct the dependencies.
The default ruleset will
- Search first the currently executing assembly, then its references, then its base directory, then the current working directory
- Prefer constructors with more parameters over constructors with fewer.
Customise or replace the default ruleset with the provided rules or custom rules.
Example Usage
See FixtureBase : reduce the cost of Unit Testing by automating setup and the injection of fakes.
ActivateAnything
Activate.New<T>()
…will make an extreme effort to find and instantiate a concrete class which is assignable to a Type, whether or not the Type is concrete, whether or not the Type has constructor dependencies, whether or not a suitable concrete subtype is found in any currently loaded Assembly.
The attempt to find and instantiate suitable Types is driven by three kinds of IActivateAnythingRule.
IActivateInstanceRulesimply returns an instance of a concrete type.IFindTypeRuleprovides rules for where to look for candidate concrete subtypes of an abstract typeIChooseConstructorRulerules for how to choose between constructors when a concreteTypehas been chosen.
The extremity of the effort lies in its recursive attempt to find and construct the dependencies.
The default ruleset will
- Search first the currently executing assembly, then its references, then its base directory, then the current working directory
- Prefer constructors with more parameters over constructors with fewer.
Customise or replace the default ruleset with the provided rules or custom rules.
Example Usage
See FixtureBase : reduce the cost of Unit Testing by automating setup and the injection of fakes.
Release Notes
ChangeLog
---------
0.3.0 AnythingActivator.Instances as well as Rules. Breaking: refactored constructors & FixtureBase startup
0.2.2 FixtureBase
0.2.1.0 ActivateInstance Rule can activate a Func<Type> as well as a Type
0.2.0.0 Expose LastActivationTree and LastErrorList after a call to New()
0.1.0.2 fix non-public constructors. ChooseConstructorWith(Most|Fewest)ParametersAttribute.PreferPublic defaults to true.
0.1.0.1 ActivateAnything first release.
Dependencies
-
.NETFramework 4.5
- No dependencies.
-
.NETStandard 2.0
- No dependencies.