- The 1-based column number, or 0 if unspecified.
diff --git a/lib/Gallio_3.2.517.0/Gallio.Navigator.exe b/lib/Gallio_3.2.517.0/Gallio.Navigator.exe
new file mode 100644
index 00000000..f0cf06fb
Binary files /dev/null and b/lib/Gallio_3.2.517.0/Gallio.Navigator.exe differ
diff --git a/lib/Gallio_3.2.517.0/Gallio.Navigator.exe.config b/lib/Gallio_3.2.517.0/Gallio.Navigator.exe.config
new file mode 100644
index 00000000..87084015
--- /dev/null
+++ b/lib/Gallio_3.2.517.0/Gallio.Navigator.exe.config
@@ -0,0 +1,7 @@
+
+
+
+
+
diff --git a/lib/Gallio_3.2.517.0/Gallio.Navigator.plugin b/lib/Gallio_3.2.517.0/Gallio.Navigator.plugin
new file mode 100644
index 00000000..031e0a72
--- /dev/null
+++ b/lib/Gallio_3.2.517.0/Gallio.Navigator.plugin
@@ -0,0 +1,22 @@
+
+
+
+ Gallio Navigator
+ 3.2.0.0
+ .
+
+
+
+
+
+
+
+
\ No newline at end of file
diff --git a/lib/Gallio_3.2.517.0/Gallio.PowerShellCommands.dll b/lib/Gallio_3.2.517.0/Gallio.PowerShellCommands.dll
new file mode 100644
index 00000000..131a41aa
Binary files /dev/null and b/lib/Gallio_3.2.517.0/Gallio.PowerShellCommands.dll differ
diff --git a/lib/Gallio_3.2.517.0/Gallio.PowerShellCommands.dll-Help.xml b/lib/Gallio_3.2.517.0/Gallio.PowerShellCommands.dll-Help.xml
new file mode 100644
index 00000000..3181c3ab
--- /dev/null
+++ b/lib/Gallio_3.2.517.0/Gallio.PowerShellCommands.dll-Help.xml
@@ -0,0 +1,404 @@
+
+
+
+
+
+
+
+ Run-Gallio
+
+
+ Runs tests using Gallio.
+
+
+ Copyright © 2005-2009 Gallio Project - http://www.gallio.org/
+
+ Run
+ Gallio
+
+
+ The Run-Gallio cmdlet runs tests using Gallio.
+
+
+
+
+
+
+
+
+ ApplicationBaseDirectory
+
+ The relative or absolute path of the application base directory to use during test execution instead of the default.
+
+ String.Empty
+
+
+ Run-Gallio
+
+ Files
+
+ The list of comma-separated, relative or absolute paths of test files, projects and assemblies to execute. Wildcards may be used.
+
+
+
+
+ DoNotRun
+
+ Sets whether to load the tests but not run them. This option may be used to produce a report that contains test metadata for consumption by other tools.
+
+ false
+
+
+
+ Filter
+
+
+ Sets the filter set to apply, which consists of a sequence of one or more inclusion
+ or exclusion filter rules prefixed using 'include' (optional) or 'exclude'.
+ A filter rule consists of zero or more filter expressions
+ that may be combined using 'and', 'or', and 'not' and grouped with
+ parentheses. A filter expression consists of a filter key followed by one or
+ more comma-delimited matching values in the form 'key: value, "quoted value",
+ /regular expression/'.
+
+
+ *
+
+
+
+ HintDirectories
+
+ The list of directories used for loading referenced assemblies and other dependent resources.
+
+
+
+
+ NoEchoResults
+
+ Sets whether to echo results to the screen as tests finish. If this option is specified only the final summary statistics are displayed. Otherwise test results are echoed to the console in varying detail depending on the current verbosity level.
+
+ false
+
+
+
+ NoProgress
+
+ Sets whether progress information is shown during the execution. If this option is specified, the execution is silent and no progress information is displayed.
+
+ false
+
+
+
+ PluginDirectories
+
+ Additional Gallio plugin directories to search recursively.
+
+
+
+
+ ReportDirectory
+
+ Sets the name of the directory where the reports will be put.
+
+ "Reports"
+
+
+
+ ReportNameFormat
+
+ Sets the format string to use to generate the reports filenames.
+
+ test-report-{0}-{1}
+
+
+
+ ReportArchive
+
+ Indicates whether to enclose the resulting test report in a compressed archive file.
+
+ false
+
+
+
+ ReportTypes
+
+ A list of the types of reports to generate, separated by semicolons.
+
+ String.Empty
+
+
+
+ RunnerType
+
+ Sets the type of test runner to use (LocalAppDomain, IsolatedAppDomain or IsolatedProcess, but more could be available as plugins).
+
+ IsolatedProcess
+
+
+
+ ShadowCopy
+
+
+ Enables shadow copying when set to true. Shadow copying allows the original assemblies to be modified while the tests are running. However, shadow copying may occasionally cause some tests to fail if they depend on their original location.
+
+
+ false
+
+
+
+ DebugTests
+
+
+ Attaches the debugger to the test process.
+
+
+ false
+
+
+
+ ShowReports
+
+ Sets whether to open the generated reports once execution has finished.
+
+ false
+
+
+
+ WorkingDirectory
+
+
+ The relative or absolute path of the working directory to use during test execution instead of the default.
+
+
+ String.Empty
+
+
+
+ RuntimeVersion
+
+ The version of the .Net runtime to use for running tests. For the CLR, this must be the name of one of the framework directories in %SystemRoot%\Microsoft.Net\Framework. eg. 'v2.0.50727'. The default is null which uses the most recent installed and supported framework.
+
+
+
+
+
+
+
+
+
+
+ ApplicationBaseDirectory
+
+ The relative or absolute path of the application base directory.
+
+ String.Empty
+
+
+ Run-Gallio
+
+ Files
+
+ The list of comma-separated, relative or absolute paths of test files, projects and assemblies to execute. Wildcards may be used.
+
+
+
+
+ DoNotRun
+
+ Sets whether to load the tests but not run them. This option may be used to produce a report that contains test metadata for consumption by other tools.
+
+ false
+
+
+
+ Filter
+
+
+ Sets the filter set to apply, which consists of a sequence of one or more inclusion
+ or exclusion filter rules prefixed using 'include' (optional) or 'exclude'.
+ A filter rule consists of zero or more filter expressions
+ that may be combined using 'and', 'or', and 'not' and grouped with
+ parentheses. A filter expression consists of a filter key followed by one or
+ more comma-delimited matching values in the form 'key: value, "quoted value",
+ /regular expression/'.
+
+
+ *
+
+
+
+ HintDirectories
+
+ The list of directories used for loading referenced assemblies and other dependent resources.
+
+
+
+
+ NoEchoResults
+
+ Sets whether to echo results to the screen as tests finish. If this option is specified only the final summary statistics are displayed. Otherwise test results are echoed to the console in varying detail depending on the current verbosity level.
+
+ false
+
+
+
+ NoProgress
+
+ Sets whether progress information is shown during the execution. If this option is specified, the execution is silent and no progress information is displayed.
+
+ false
+
+
+
+ PluginDirectories
+
+ Additional Gallio plugin directories to search recursively.
+
+
+
+
+ ReportDirectory
+
+ Sets the name of the directory where the reports will be put.
+
+ "Reports"
+
+
+
+ ReportNameFormat
+
+ Sets the format string to use to generate the reports filenames.
+
+ test-report-{0}-{1}
+
+
+
+ ReportArchive
+
+ Indicates whether to enclose the resulting test report in a compressed archive file.
+
+ false
+
+
+
+ ReportTypes
+
+ A list of the types of reports to generate, separated by semicolons.
+
+ String.Empty
+
+
+
+ RunnerType
+
+ Sets the type of test runner to use: Local, IsolatedAppDomain, IsolatedProcess, or others that may be provided by plugins.
+
+ IsolatedProcess
+
+
+
+ RunnerExtensions
+
+ Specifies the type, assembly, and parameters of custom test runner extensions to use during the test run in the form: '[Namespace.]Type,Assembly[;Parameters]. eg. 'FancyLogger,MyExtensions.dll;ColorOutput,FancyIndenting'
+
+
+
+
+ ShadowCopy
+
+
+ Enables shadow copying when set to true. Shadow copying allows the original assemblies to be modified while the tests are running. However, shadow copying may occasionally cause some tests to fail if they depend on their original location.
+
+
+ false
+
+
+
+ DebugTests
+
+
+ Attaches the debugger to the test process.
+
+
+ false
+
+
+
+ ShowReports
+
+ Sets whether to open the generated reports once execution has finished.
+
+ false
+
+
+
+ WorkingDirectory
+
+
+ The relative or absolute path of the working directory. If relative, the path is based on the current working directory, so a value of "" (an empty string) causes the current working directory to be used.
+
+
+ String.Empty
+
+
+
+ RuntimeVersion
+
+ The version of the .Net runtime to use for running tests. For the CLR, this must be the name of one of the framework directories in %SystemRoot%\Microsoft.Net\Framework. eg. 'v2.0.50727'. The default is null which uses the most recent installed and supported framework.
+
+
+
+
+
+
+ # Makes the Gallio commands available
+ Add-PSSnapIn Gallio
+ # Runs TestAssembly1.dll
+ Run-Gallio "[Path-to-assembly1]\TestAssembly1.dll","[Path-to-assembly2]\TestAssembly2.dll","[Path-to-test-script1]/TestScript1_spec.rb","[Path-to-test-script2]/TestScript2.xml" -f Category:UnitTests -rd C:\build\reports -rf html -ra
+
+
+
+
+
+
diff --git a/lib/Gallio_3.2.517.0/Gallio.PowerShellCommands.plugin b/lib/Gallio_3.2.517.0/Gallio.PowerShellCommands.plugin
new file mode 100644
index 00000000..971300f2
--- /dev/null
+++ b/lib/Gallio_3.2.517.0/Gallio.PowerShellCommands.plugin
@@ -0,0 +1,21 @@
+
+
+
+ Gallio PowerShell Commands
+ 3.2.0.0
+ Provides PowerShell cmdlets for running tests with Gallio.
+
+
+
+
+
+
+
+
\ No newline at end of file
diff --git a/lib/Gallio_3.2.517.0/Gallio.PowerShellCommands.xml b/lib/Gallio_3.2.517.0/Gallio.PowerShellCommands.xml
new file mode 100644
index 00000000..f3fe517c
--- /dev/null
+++ b/lib/Gallio_3.2.517.0/Gallio.PowerShellCommands.xml
@@ -0,0 +1,660 @@
+
+
+
+ Gallio.PowerShellCommands
+
+
+
+
+ Abstract base class for PowerShell commands.
+ Provides some useful runtime support.
+
+
+
+
+ Posts an action to perform later within the message loop.
+
+
+
+
+ Starts a message pump running on the current thread and performs the
+ specified action in another thread. The action can asynchronously communicate back to the
+ cmdlet using
+
+
+
+ Aborts the processing of the command.
+
+
+
+
+ The event dispatches when the command is asynchronously being stopped
+ via
+
+
+
+ Gets the logger for the cmdlet.
+
+
+
+
+ Sets whether progress information is shown during the execution. If this option is specified,
+ the execution is silent and no progress information is displayed.
+
+
+
+ - This parameter takes the value true if present and false if not. No
+ value has to be specified.
+
+
+
+
+ # Shows progress information
+ Run-Gallio SomeAssembly.dll
+ # Hides progress information
+ Run-Gallio SomeAssembly.dll -np
+
+
+
+
+
+ Gets the progress monitor provider for the cmdlet.
+
+
+
+
+
+
+
+
+ The Gallio.PowerShellCommands namespace contains Powershell cmdlets for Gallio.
+
+
+
+
+ A PowerShell Cmdlet for running Gallio.
+
+
+ Only the
+
+ There are severals ways to run this cmdlet:
+
+
+
+
+ Default constructor.
+
+
+
+
+
+
+ Provided so that the unit tests can override test execution behavior.
+
+
+
+
+ The list of relative or absolute paths of test files, projects and assemblies to execute.
+ Wildcards may be used. This is required.
+
+
+ There are severals ways to pass the test files to the cmdlet:
+ Run-Gallio
+
+ cmdlet Run-Gallio at command pipeline position
+ Supply values for the following parameters:
+ Files[0]:
+ ]]>
+
+
+
+
+ The list of directories used for loading referenced assemblies and other dependent resources.
+
+
+ The following example shows how to specify the hint directories:
+ See the
+
+
+
+
+ Additional Gallio plugin directories to search recursively.
+
+
+ The following example shows how to specify the plugin directories:
+ See the
+
+
+
+
+ Gets or sets the relative or absolute path of the application base directory,
+ or null to use a default value selected by the consumer.
+
+
+
+ If relative, the path is based on the current working directory,
+ so a value of "" causes the current working directory to be used.
+
+
+ The default is null.
+
+
+
+
+
+ Gets or sets the relative or absolute path of the working directory
+ or null to use a default value selected by the consumer.
+
+
+
+ If relative, the path is based on the current working directory,
+ so a value of "" causes the current working directory to be used.
+
+
+ The default is null.
+
+
+
+
+
+ Enables shadow copying when set to true.
+
+
+
+ Shadow copying allows the original assemblies to be modified while the tests are running.
+ However, shadow copying may occasionally cause some tests to fail if they depend on their original location.
+
+
+ The default is false.
+
+
+
+
+
+ Attaches the debugger to the test process when set to true.
+
+
+
+ The default is false.
+
+
+
+
+
+ Gets or sets the version of the .Net runtime to use for running tests.
+
+
+
+ For the CLR, this must be the name of one of the framework directories in %SystemRoot%\Microsoft.Net\Framework. eg. 'v2.0.50727'.
+
+
+ The default is null which uses the most recent installed and supported framework.
+
+
+
+
+
+ A list of the types of reports to generate, separated by semicolons.
+
+
+
+ - The types supported "out of the box" are: Html, Html-Inline, Text, XHtml,
+ XHtml-Inline, Xml, and Xml-Inline, but more types could be available as plugins.
+ - The report types are not case sensitives.
+
+
+
+ In the following example reports will be generated in both HTML and XML format:
+ See the
+
+
+
+
+ Sets the format string to use to generate the reports filenames.
+
+
+
+ Any occurence of {0} will be replaced by the date, and any occurrence of {1} by the time.
+
+
+ The default format string is test-report-{0}-{1} .
+
+
+
+
+
+ Sets the name of the directory where the reports will be put.
+
+
+
+ The directory will be created if it doesn't exist. Existing files will be overwritten.
+ The default report directory is "Reports".
+
+
+
+
+
+ Specifies to enclose the resulting reports into a compressed archive file (zip).
+
+
+
+
+
+ Sets the filter set to apply, which consists of a sequence of one or more inclusion
+ or exclusion filter rules prefixed using 'include' (optional) or 'exclude'.
+
+
+
+
+ A filter rule consists of zero or more filter expressions
+ that may be combined using 'and', 'or', and 'not' and grouped with
+ parentheses. A filter expression consists of a filter key followed by one or
+ more comma-delimited matching values in the form 'key: value, "quoted value",
+ /regular expression/'.
+
+ The filter grammar is defined as follows:
+
+ ::= [^:,*()/\"']+
+
+ ::= '"' .* '"' # String delimited by double quotation marks
+ | "'" .* "'" # String delimited by single quotation marks
+
+ ::=
+ |
+
+ ::= "/" .* "/" # Regular expression
+ | "/" .* "/i" # Case-insensitive regular expression
+
+ ::=
+
+ ::= # Value specified by exact string
+ | # Value specified by regular expression
+
+ ::= (',' )* # One or more comma-separated values
+
+ ::= "*" # "Any"
+ | ":" matchSeq>
+ | OR filterExpr> # Combine filter expressions with OR
+ | AND filterExpr> # Combine filter expressions with AND
+ | NOT # Negate filter expression
+ | "(" ")" # Grouping filter expression
+
+ ::= # Inclusion rule (default case)
+ | INCLUDE # Inclusion rule
+ | EXCLUDE # Exclusion rule
+
+ ::= # Filter set consists of at least one filter rule.
+ | # But may be a sequence of rules.
+ ]]>
+
+ - By default this property takes the value "*", which means the "Any" filter will be applied.
+ -
+ The operator precedence is, from highest to lowest: NOT, AND, and OR. All these operators are
+ left-associative.
+
+ -
+ The commas used to separate the values are interpreted as OR operators, so "Type:Fixture1,Fixture2"
+ is equivalent to "Type:Fixture1 or Type:Fixture2".
+
+ -
+ White-space is ignored outside quoted strings, so "Type:Fixture1|Type:Fixture2" is equivalent
+ to "Type : Fixture1 | Type : Fixture2".
+
+ -
+ Commas, colons, slashes, backslashes and quotation marks can be escaped with a backslash. For
+ example, \' will be interpreted as '. Using a single backslash in front of any other character
+ is invalid.
+
+ -
+ Currently the following filter keys are recognized:
+
+ - Id: Filter by id.
+ - Name: Filter by name.
+ - Assembly: Filter by assembly name.
+ - Namespace: Filter by namespace name.
+ - Type: Filter by type name, including inherited types.
+ - ExactType: Filter by type name, excluding inherited types.
+ - Member: Filter by member name.
+ -
+ *: All other names are assumed to correspond to metadata keys. See
+
+
+
+
+
+
+ Assuming the following fixtures have been defined:
+ The following filters could be applied:
+ -
+
Type: Fixture1
+ All the tests within Fixture1 will be run.
+
+
+ -
+
Member: Test1
+ Only Fixture1.Test1 and Fixture2.Test1 will be run.
+
+
+ -
+
Type: Fixture1, Fixture2
+ All the tests within Fixture1 or Fixture2 will be run.
+
+
+ -
+
Type:Fixture1 or Type:Fixture2
+ All the tests within Fixture1 or Fixture2 will be run.
+
+
+ -
+
Type:Fixture1, Fixture2 and Member:Test2
+ Only Fixture1.Test2 and Fixture2.Test2 will be run.
+
+
+ -
+
Type:/Fixture*/ and Member:Test2
+ Only Fixture1.Test2 and Fixture2.Test2 will be run.
+
+
+ -
+
AuthorName:AlbertEinstein
+ All the tests within Fixture1 will be run because its author attribute is set to "AlbertEinstein".
+
+
+ -
+
Category: IntegrationTest
+ All the tests within Fixture2 will be run because its category attribute is set to "IntegrationTest".
+
+
+ -
+
("Type": 'Fixture1' and "Member":/Test*/) or (Type : Fixture2 and Member: /Test*/)
+ All the tests will be run. This example also shows that you can enclose key and
+ values with quotation marks, and group expressions with parentheses.
+
+
+ -
+
exclude AuthorName: AlbertEinstein
+ All the tests within Fixture2 will be run because its author attribute is not set to "AlbertEinstein".
+
+
+ -
+
exclude Type: Fixture2 include Member: Test2
+ Only Fixture1.Test2 will be run because Fixture2 was excluded from consideration before the inclusion rule was applied.
+
+
+
+
+
+
+ Sets whether to open the generated reports once execution has finished.
+
+
+
+ - This parameter takes the value true if present and false if not. No
+ value has to be specified.
+ -
+ The reports are opened in a window using the default system application
+ registered to the report file type.
+
+
+
+
+
+
+
+
+ Sets the type of test runner to use.
+
+
+
+ - The types supported "out of the box" are:
Local , IsolatedAppDomain
+ and IsolatedProcess (default), but more types could be available as plugins.
+ - The runner types are not case sensitive.
+
+
+
+
+
+ Specifies the type, assembly, and parameters of custom test runner
+ extensions to use during the test run.
+
+
+
+ The value must be in the form '[Namespace.]Type,Assembly[;Parameters]' .
+
+
+
+ The following example runs tests using a custom logger extension:
+
+
+
+
+ Specifies option property key/value pairs for the test runner.
+
+
+ The following example specifies some extra NCover arguments.
+
+
+
+
+ Specifies option property key/value pairs for the report formatter.
+
+
+ The following example changes the default attachment content disposition for the reports.
+
+
+
+
+ Sets whether to load the tests but not run them.
+
+
+
+ This option may be used to produce a report that contains test metadata for consumption by other tools.
+
+
+
+
+
+ Sets whether to ignore annotations when determining the result code.
+
+
+
+ If false (default), then error annotations, usually indicative of broken tests, will cause
+ a failure result to be generated.
+
+
+
+
+
+ Sets whether to echo results to the screen as tests finish.
+
+
+
+ If this option is specified only the final summary statistics are displayed. Otherwise test results are echoed to the
+ console in varying detail depending on the current verbosity level.
+
+
+
+
+
+ Sets the maximum amount of time (in seconds) the tests can run
+ before they are canceled. The default is an infinite time to run.
+
+
+
+
+ A PowerShell SnapIn that registers the Gallio Cmdlets.
+
+
+
+
+ Gets the description of the snap-in.
+
+
+
+
+ Gets the name of the snap-in.
+
+
+
+
+ Gets the vendor of the snap-in.
+
+
+
+
+ Logs messages using a
+
+
+
+ Initializes a new instance of the
+
+
+
+ Logs a message.
+
+
+
+
+ A strongly-typed resource class, for looking up localized strings, etc.
+
+
+
+
+ Returns the cached ResourceManager instance used by this class.
+
+
+
+
+ Overrides the current thread's CurrentUICulture property for all
+ resource lookups using this strongly typed resource class.
+
+
+
+
+ Looks up a localized string similar to Gallio PowerShell Cmdlet - Version {0}.{1} build {2}.
+
+
+
+
+ Looks up a localized string similar to test-report-{0}-{1}.
+
+
+
+
+ Looks up a localized string similar to An unexpected error occurred during execution of the Gallio task..
+
+
+
+
diff --git a/lib/Gallio_3.2.517.0/Gallio.Reports.dll b/lib/Gallio_3.2.517.0/Gallio.Reports.dll
new file mode 100644
index 00000000..5822544b
Binary files /dev/null and b/lib/Gallio_3.2.517.0/Gallio.Reports.dll differ
diff --git a/lib/Gallio_3.2.517.0/Gallio.Reports.plugin b/lib/Gallio_3.2.517.0/Gallio.Reports.plugin
new file mode 100644
index 00000000..aebe29b7
--- /dev/null
+++ b/lib/Gallio_3.2.517.0/Gallio.Reports.plugin
@@ -0,0 +1,241 @@
+
+
+
+ Gallio Reports Library
+ 3.2.0.0
+ Provides several common report formats including Xml, Html, XHtml, MHtml and Text.
+ plugin://Gallio/Resources/Gallio.ico
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Link
+
+
+ Xml
+
+ Generates XML reports with linked attachment files.
+
+ Supported report formatter properties:
+ - AttachmentContentDisposition: Specifies how attachments should be stored. "Absent", "Link" or "Inline". Default is "Link".
+
+
+
+
+
+
+ Inline
+
+
+ Xml-Inline
+ Generates XML reports with inline encoded attachments.
+
+
+
+
+
+ txt
+ text/plain
+ Absent
+ plugin://Gallio.Reports/Resources/
+ xsl/Gallio-Report.txt.xsl
+
+
+ Text
+ Generates plain text reports.
+
+
+
+
+
+ txt
+ text/plain
+ Absent
+ plugin://Gallio.Reports/Resources/
+ xsl/Gallio-Report.txt-condensed.xsl
+
+
+ Text-Condensed
+ Generates plain text reports without passing tests.
+
+
+
+
+
+ html
+ text/html
+ Link
+ plugin://Gallio.Reports/Resources/
+ xsl/Gallio-Report.html.xsl
+ css;js;img
+
+
+ Html
+
+ Generates HTML reports.
+
+ Supported report formatter properties:
+ - AttachmentContentDisposition: Specifies how attachments should be stored. "Absent", "Link" or "Inline". Default is "Link".
+
+
+
+
+
+
+ html
+ text/html
+ Link
+ plugin://Gallio.Reports/Resources/
+ xsl/Gallio-Report.html-condensed.xsl
+ css;js;img
+
+
+ Html-Condensed
+
+ Generates HTML reports that omit passing tests.
+
+ Supported report formatter properties:
+ - AttachmentContentDisposition: Specifies how attachments should be stored. "Absent", "Link" or "Inline". Default is "Link".
+
+
+
+
+
+
+ xhtml
+ text/xhtml+xml
+ Link
+ plugin://Gallio.Reports/Resources/
+ xsl/Gallio-Report.xhtml.xsl
+ css;js;img
+
+
+ XHtml
+
+ Generates XHTML reports.
+
+ Supported report formatter properties:
+ - AttachmentContentDisposition: Specifies how attachments should be stored. "Absent", "Link" or "Inline". Default is "Link".
+
+
+
+
+
+
+ xhtml
+ text/xhtml+xml
+ Link
+ plugin://Gallio.Reports/Resources/
+ xsl/Gallio-Report.xhtml-condensed.xsl
+ css;js;img
+
+
+ XHtml-Condensed
+
+ Generates XHTML reports that omit passing tests.
+
+ Supported report formatter properties:
+ - AttachmentContentDisposition: Specifies how attachments should be stored. "Absent", "Link" or "Inline". Default is "Link".
+
+
+
+
+
+
+ ${ReportFormatter.Html}
+
+
+ MHtml
+ Generates MHTML reports.
+
+
+
+
+
+ ${ReportFormatter.Html-Condensed}
+
+
+ MHtml-Condensed
+ Generates MHTML reports that omit passing tests.
+
+
+
+
+
+ plugin://Gallio.Reports/Resources/img/testkinds/
+ plugin://Gallio.Reports/Resources/css/Gallio-Report.Generated.css
+
+
+ true
+
+
+
+
diff --git a/lib/Gallio_3.2.517.0/Gallio.Reports.xml b/lib/Gallio_3.2.517.0/Gallio.Reports.xml
new file mode 100644
index 00000000..fef2cb6d
--- /dev/null
+++ b/lib/Gallio_3.2.517.0/Gallio.Reports.xml
@@ -0,0 +1,229 @@
+
+
+
+ Gallio.Reports
+
+
+
+
+ Abstract base class for report formatters.
+
+
+
+
+ Gets the name of the option that how attachments are saved.
+
+
+
+
+ Creates a report formatter.
+
+
+
+
+ Gets the attachment content disposition.
+
+ The attachment content disposition.
+
+
+
+
+
+ Gets or sets the default attachment content disposition.
+ Defaults to
+
+
+
+
+ Formats MIME HTML archive reports similar to the web archives generated by Internet Explorer.
+ The report can then be sent to recipients as a single file.
+
+
+ Unfortunately the format is non-standard and cannot be read by most other browsers.
+
+
+
+
+
+ Creates a report formatter.
+
+ Thrown if
+
+
+
+
+
+ A report container that saves a report as a multipart mime archive in a single file
+ within another container.
+
+
+ This is currently specialized for saving HTML reports.
+ It does not support loading reports.
+
+
+
+
+ Creates the multipart mime report container.
+
+ Thrown if
+
+
+
+ Opens the archive within the inner container.
+
+ Thrown if
+ Thrown if the archive has already been opened.
+
+
+
+ Finishes writing out the MIME archive and closes it.
+ Does nothing if the archive is not open.
+
+
+
+
+
+
+ The Gallio.Reports namespace provides report formatters for common Gallio test report types.
+
+
+
+
+ A strongly-typed resource class, for looking up localized strings, etc.
+
+
+
+
+ Returns the cached ResourceManager instance used by this class.
+
+
+
+
+ Overrides the current thread's CurrentUICulture property for all
+ resource lookups using this strongly typed resource class.
+
+
+
+
+ Installs derived resources for reports such as test framework icons.
+
+
+
+
+ Initializes the installer.
+
+
+
+
+
+
+ Formats reports as Xml.
+
+
+
+ Recognizes the following options:
+
+
+ Option
+ Description
+
+ -
+
AttachmentContentDisposition
+ Overrides the default attachment content disposition for the format.
+ The content disposition may be "Absent" to exclude attachments, "Link" to
+ include attachments by reference to external files, or "Inline" to include attachments as
+ inline content within the formatted document. Different formats use different
+ default content dispositions.
+
+
+
+
+
+
+
+ Creates an Xml report formatter.
+
+
+
+
+
+
+
+ Generic XSLT report formatter.
+
+
+ Recognizes the following options:
+
+
+ Option
+ Description
+
+ -
+
AttachmentContentDisposition
+ Overrides the default attachment content disposition for the format.
+ The content disposition may be "Absent" to exclude attachments, "Link" to
+ include attachments by reference to external files, or "Inline" to include attachments as
+ inline content within the formatted document. Different formats use different
+ default content dispositions.
+
+
+
+
+
+
+
+ Creates an XSLT report formatter.
+
+ Thrown if any arguments are null.
+
+
+
+
+
+ Applies the transform to produce a report.
+
+
+
+
+ Copies additional resources to the content path within the report.
+
+
+
+
+ Populates the arguments for the XSL template processing.
+
+
+
+
+ Loads the XSL transform.
+
+ The transform.
+
+
+
+ Gets the XSL transform.
+
+
+
+
diff --git a/lib/Gallio_3.2.517.0/Gallio.UI.dll b/lib/Gallio_3.2.517.0/Gallio.UI.dll
new file mode 100644
index 00000000..bde35caa
Binary files /dev/null and b/lib/Gallio_3.2.517.0/Gallio.UI.dll differ
diff --git a/lib/Gallio_3.2.517.0/Gallio.UI.plugin b/lib/Gallio_3.2.517.0/Gallio.UI.plugin
new file mode 100644
index 00000000..31ee4036
--- /dev/null
+++ b/lib/Gallio_3.2.517.0/Gallio.UI.plugin
@@ -0,0 +1,127 @@
+
+
+
+ Gallio UI Library
+ 3.2.0.0
+ Gallio UI components.
+ plugin://Gallio/Resources/Gallio.ico
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Preferences
+ 0
+
+
+
+
+
+ Plugins
+ 100
+
+
+
+
+
+ Gallio
+ -100
+ plugin://Gallio/Resources/Gallio.ico
+
+
+
+
+
+ Gallio/Runtime
+ plugin://Gallio/Resources/Gallio.ico
+ Machine
+
+
+
+
+
\ No newline at end of file
diff --git a/lib/Gallio_3.2.517.0/Gallio.UI.xml b/lib/Gallio_3.2.517.0/Gallio.UI.xml
new file mode 100644
index 00000000..413c35b7
--- /dev/null
+++ b/lib/Gallio_3.2.517.0/Gallio.UI.xml
@@ -0,0 +1,1356 @@
+
+
+
+ Gallio.UI
+
+
+
+
+ Wrapper for static UnhandledExceptionPolicy
+ class (to improve testability).
+
+
+
+
+ Reports an unhandled exception.
+
+ Thrown if
+
+
+
+
+
+
+
+ Holder for the current sync context (e.g. the winforms current).
+
+
+
+
+ Wrapper for Send on the shared sync context.
+
+
+
+
+ Wrapper for Post on the shared sync context.
+
+
+
+
+ Returns a shared SynchronizationContext instance.
+
+
+ Usually used to stash a reference to the win forms synchronization
+ context (WindowsFormsSynchronizationContext.Current), used for
+ cross-thread data binding.
+
+
+
+
+ Presents the control panel dialog.
+
+
+
+
+ Presents the control panel dialog.
+
+
+
+
+ Shows the control panel dialog.
+
+ The dialog result, either
+
+
+
+ Creates a control panel presenter.
+
+
+
+
+
+
+ Base class for components that present control panel tabs.
+
+
+
+
+ Base class for user controls for editing settings with deferred application.
+
+
+
+
+ Applies pending settings changes.
+
+
+ The default implementation simply sets
+
+
+
+ Raises the
+
+
+
+ Raises the
+
+
+
+ Event raised when the value of
+
+
+
+ Event raised when the value of
+
+
+
+ Gets or sets whether there are pending settings changes yet to be applied.
+
+
+
+
+ Gets or sets whether elevation will be required to apply pending modifications.
+
+
+
+
+ Creates a control panel tab.
+
+
+
+
+ Required designer variable.
+
+
+
+
+ Clean up any resources being used.
+
+
+
+
+ Required method for Designer support - do not modify
+ the contents of this method with the code editor.
+
+
+
+
+ Describes the traits of a
+
+
+
+ Creates a traits object for a control panel tab provider.
+
+ Thrown if
+ Thrown if
+
+
+
+ Gets the control panel tab name.
+
+
+
+
+ Gets or sets an integer index used to sort control panel tabs in ascending order.
+
+
+
+
+ Provides a preference pane to be incorporated into the Gallio control panel.
+
+
+
+
+ Creates a control panel tab to include in the control panel.
+
+ The control panel tab.
+
+
+
+ Presents a dialog with control panel options.
+
+
+
+
+ Creates a control panel dialog.
+
+
+
+
+ Adds a tab.
+
+
+
+
+ Required designer variable.
+
+
+
+
+ Clean up any resources being used.
+
+
+
+
+ Required method for Designer support - do not modify
+ the contents of this method with the code editor.
+
+
+
+
+ Gets or sets the elevation manager used to obtain an elevation context.
+
+
+
+
+ Gets or sets the progress monitor provider to use.
+
+
+
+
+ The Gallio.UI.ControlPanel.Plugins namespace contains types for a standard Control
+ Panel extension that displays installed plugins.
+
+
+
+
+ Required designer variable.
+
+
+
+
+ Clean up any resources being used.
+
+
+
+
+ Required method for Designer support - do not modify
+ the contents of this method with the code editor.
+
+
+
+
+ A control panel tab for managing installed plugins.
+
+
+
+
+ Creates a control panel tab for managing installed plugins.
+
+
+
+
+
+
+ The Gallio.UI.ControlPanel namespace contains types for using and extending the
+ Preference Tab of the Gallio Control Panel UI.
+
+
+
+
+ Contains a preference pane and decorates it with a title.
+
+
+
+
+ Required designer variable.
+
+
+
+
+ Clean up any resources being used.
+
+
+
+
+ Required method for Designer support - do not modify
+ the contents of this method with the code editor.
+
+
+
+
+ Gets or sets the preference pane, or null if none.
+
+
+
+
+ Gets or sets the preference pane title, or null if none.
+
+
+
+
+ Specifies the scope of the changes effected by a preference pane.
+
+
+
+
+ Changes affect the current user only.
+
+
+
+
+ Changes affect all users of the machine.
+
+
+
+
+ Applies changes made by the
+
+
+
+
+
+ Base class for components that present preference panels.
+
+
+
+
+ Creates a preference pane.
+
+
+
+
+ Required designer variable.
+
+
+
+
+ Clean up any resources being used.
+
+
+
+
+ Required method for Designer support - do not modify
+ the contents of this method with the code editor.
+
+
+
+
+ Required designer variable.
+
+
+
+
+ Clean up any resources being used.
+
+
+
+
+ Required method for Designer support - do not modify
+ the contents of this method with the code editor.
+
+
+
+
+ A preference pane provider that is used as an empty placeholder for a
+ non-leaf node in the preference pane tree.
+
+
+
+
+ Provides a preference pane to be incorporated into the Gallio control panel.
+
+
+
+
+ Creates a preference pane to include in the control panel.
+
+ The preference pane.
+
+
+
+
+
+ Required designer variable.
+
+
+
+
+ Clean up any resources being used.
+
+
+
+
+ Required method for Designer support - do not modify
+ the contents of this method with the code editor.
+
+
+
+
+ Provides the preference pane for the Gallio runtime paths.
+
+
+
+
+
+
+ Adds a preference pane.
+
+
+
+
+
+
+ Required designer variable.
+
+
+
+
+ Clean up any resources being used.
+
+
+
+
+ Required method for Designer support - do not modify
+ the contents of this method with the code editor.
+
+
+
+
+ Provides the preferences control panel tab.
+
+
+
+
+ Creates a control panel tab provider for preference panes.
+
+
+
+
+
+
+ Describes the traits of a
+
+
+
+ Creates a traits object for a preference pane provider.
+
+ Thrown if
+ Thrown if
+
+
+
+ Gets the preference pane path consisting of slash-delimited name segments
+ specifying tree nodes.
+
+
+
+
+ Gets or sets an icon (16x16) for the preference pane, or null if none.
+
+
+
+
+ Gets or sets an integer index used to sort control panel tabs in ascending order.
+
+
+
+
+ Gets or sets a value that describes the scope of the changes effected by a preference pane.
+
+ The scope.
+
+
+
+ The Gallio.UI.ControlPanel namespace contains types for using and extending the
+ Gallio Control Panel UI.
+
+
+
+
+ Extends the win forms ToolStripMenuItem to wrap a MenuCommand.
+
+
+
+
+ Constructor providing a menu command.
+
+
+ When clicked, the command will be run synchronously.
+
+
+
+
+ Constructor providing a command and task manager.
+
+
+ When clicked, the command will be queued with the
+ supplied task manager.
+
+
+
+
+ Constructor providing a command, task manager and keys parser.
+
+
+
+
+ A menu item that truncates the text, using ellipses (...), if necessary.
+
+
+
+
+ Sub-class of ToolStripMenuItem ,
+ making databinding easier.
+
+
+
+
+ Gets or sets the collection of currency managers for the IBindableComponent.
+
+
+
+
+ Gets the collection of data-binding objects for this IBindableComponent.
+
+
+
+
+ Ctor.
+
+
+
+
+ Parses a string representation of a
+
+
+
+ Parses a string representation of a
+ A
+
+ For example, "Ctrl + S" would parse as Keys.Control | Keys.S
+
+
+
+
+
+
+
+
+ Sub-class of ToolStripButton ,
+ making databinding easier.
+
+
+
+
+ Gets or sets the collection of currency managers for the IBindableComponent.
+
+
+
+
+ Gets the collection of data-binding objects for this IBindableComponent.
+
+
+
+
+ Wrapper for a field, that implements INotifyPropertyChanged.
+
+ The type to wrap.
+
+ All credit to Ayende:
+ http://ayende.com/Blog/archive/2009/08/08/an-easier-way-to-manage-inotifypropertychanged.aspx
+
+
+
+
+ Default constructor.
+
+
+
+
+ Constructor initializing field.
+
+
+
+
+ Implicit operator allowing use of value.
+
+
+
+
+ The value being wrapped.
+
+
+
+
+ Event fired when the value changes.
+
+
+
+
+ List that raises an event when the contents are modified.
+
+ Wraps a List<T>.
+ The type of elements in the list.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Copies the elements of the list to a new array.
+
+ An array containing copies of the elements of the list.
+
+
+
+ Adds the elements of the specified collection to the end of the list.
+
+
+
+
+
+
+
+
+
+
+
+
+ Presents an error dialog consisting of a title, a message and a detailed message.
+
+
+
+
+ Creates the dialog.
+
+
+
+
+ Shows the error dialog.
+
+ Thrown if
+
+
+
+ Required designer variable.
+
+
+
+
+ Clean up any resources being used.
+
+
+
+
+ Required method for Designer support - do not modify
+ the contents of this method with the code editor.
+
+
+
+
+ Gets or sets the error title.
+
+ Thrown if
+
+
+
+ Gets or sets the error message.
+
+ Thrown if
+
+
+
+ Gets or sets the error details.
+
+ Thrown if
+
+
+
+ Gets or sets whether the error details panel is visible.
+
+
+
+
+ The Gallio.UI.Controls namespace contains types for reusable Windows Forms custom controls.
+
+
+
+
+ An extension of the Button class that displays the "Shield" icon when
+ privilege elevation is required.
+
+
+
+
+ Creates a shield button.
+
+
+
+
+ Raises the
+
+
+
+ An event raised when the value of
+
+
+
+ Gets or sets whether the shield icon should be displayed.
+
+
+
+
+ Installs an unhandled exception handler that displays an error dialog.
+
+
+
+
+ Installs the handler.
+
+
+
+ The handler is automatically removed when the form is disposed.
+
+
+ Thrown if
+ Thrown if there is already a handler installed for a different owner.
+
+
+
+ Uninstalls the handler.
+
+
+
+
+ Runs an application
+
+
+
+
+ Marker class for Events.
+
+
+
+
+
+
+ An event aggregator.
+ http://martinfowler.com/eaaDev/EventAggregator.html
+
+
+
+
+ Send an event to all interested parties (synchronous).
+
+ The type of event.
+
+
+
+ Ctor.
+
+
+
+
+
+
+ Proxy event handler.
+
+ The type of event.
+
+
+
+ Marker interface used by the EventAggregator to
+ locate classes interested in an event.
+
+ The type of event.
+
+
+
+ Handle an
+
+
+
+ Ctor.
+
+
+
+
+
+
+ Wraps an ICommand and provides
+ hints for the UI.
+
+
+ Inspired by the WPF Command pattern.
+ http://msdn.microsoft.com/en-us/library/system.windows.input.icommand.aspx
+
+
+
+
+ Default constructor.
+
+
+
+
+ The command that will be executed.
+
+
+
+
+ Whether the command can currently be executed, or not.
+
+
+ Defaults to true.
+
+
+
+
+ The text description of the command.
+
+
+
+
+ The shortcut to use for the command.
+
+
+
+
+ The image to use for the command.
+
+
+
+
+ A task queue, for use by the
+
+
+
+ Adds a task to the specified queue.
+
+
+
+
+ Get the next task for the specified queue.
+
+ An
+
+
+
+ Removes all tasks from the specified queue.
+
+
+
+
+ Takes care of running queued tasks.
+
+
+
+
+ Run the next task for a named queue, if there is one.
+
+
+
+
+ Event fired when a task is cancelled.
+
+
+
+
+ Ctor.
+
+
+
+
+ The id of the queue.
+
+
+
+
+ Event fired when a task is completed.
+
+
+
+
+ Ctor.
+
+
+
+
+ The id of the queue.
+
+
+
+
+ Manages multiple queues of tasks.
+
+
+ Queue id is an arbitrary string, used as a key.
+
+
+
+
+ Ctor.
+
+
+
+
+ Adds a task to the specified queue.
+
+
+
+
+ Get the next task for the specified queue.
+
+ An
+
+
+
+ Removes all tasks from the specified queue.
+
+
+
+
+
+
+ Ctor.
+
+
+
+
+
+
+ Command pattern.
+
+
+
+
+ Run a task (with progress information).
+
+
+
+
+ A task manager for UI applications.
+
+
+
+
+ Run a task as a background action (uses ThreadPool).
+ No progress information will be displayed.
+
+
+
+
+ Empty the queue of tasks.
+
+
+
+
+
+
+ Add a task to the queue. If nothing is in the queue or
+ running, then the task will be executed.
+
+
+
+
+
+
+ Progress dialog.
+
+
+
+
+ Default constructor.
+
+
+
+
+
+
+
+
+ Required designer variable.
+
+
+
+
+ Clean up any resources being used.
+
+
+
+
+ Required method for Designer support - do not modify
+ the contents of this method with the code editor.
+
+
+
+
+
+
+ Default constructor.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Event fired when a task is started.
+
+
+
+
+ Ctor.
+
+
+
+
+ The id of the queue.
+
+
+
+
+ A progress monitor attached to the task.
+
+
+
+
+ Impl of a tool strip progress bar for Gallio progress monitoring.
+
+
+
+
+ Total work to do.
+
+
+
+
+ Total work to do.
+
+
+
+
+
+ An optimized HTML renderer for individual test step runs and their descendants.
+
+
+
+
+
+ Attempting to load flash content in a 64bit process on Windows is doomed to failure
+ because Adobe does not ship a 64bit version of the Flash plug-in at this time.
+ Unfortunately instead of failing gracefully, what happens is that Windows pops up a
+ warning dialog (when the browser is disposed) complaining about a missing flash.ocx.
+
+
+
+
+ A strongly-typed resource class, for looking up localized strings, etc.
+
+
+
+
+ Returns the cached ResourceManager instance used by this class.
+
+
+
+
+ Overrides the current thread's CurrentUICulture property for all
+ resource lookups using this strongly typed resource class.
+
+
+
+
+ The Gallio.UI.Reports namespace contains types for formatting reports for
+ display in a Windows Forms UI.
+
+
+
+
+
+ Displays a summary of a set of test step runs.
+
+
+ This control is optimized to display individual test run results to the user on
+ demand more quickly than could be done if we had to show the whole report at once.
+
+
+
+
+
+ Creates a test step run viewer.
+
+
+
+
+ Clears the contents of the report viewer and discards all cached content.
+
+
+
+
+ Displays information about a set of test step run.
+
+
+
+
+ Displays information about a set of test step runs, using additional
+ information from the test model when available.
+
+
+
+
+ Required designer variable.
+
+
+
+
+ Clean up any resources being used.
+
+
+
+
+ Required method for Designer support - do not modify
+ the contents of this method with the code editor.
+
+
+
+
+ Node check box.
+
+
+
+
+ Node check box.
+
+
+
+
+ Gets the value from the node.
+
+ The value.
+
+
+
+ Sets the check state of the node.
+
+
+
+
+ Gets the new check state.
+
+ The new check state.
+
+
+
+ A three-state node.
+
+
+
+
+ Default ctor.
+
+
+
+
+ Ctor.
+
+
+
+
+ Returns the 'combined' state for all siblings of a node.
+
+
+
+
+ Manages updating related child and parent nodes of this instance.
+
+
+
+
+ Recursively update child node's state based on the state of this node.
+
+
+
+
+ Allows inheriting classes to block cascading check state.
+
+ True if the check state can be cascaded, otherwise false.
+
+
+
+ Recursively update parent node state based on the current state of this node.
+
+
+
+
+ The check state of the node
+
+
+
+
diff --git a/lib/Gallio_3.2.517.0/Gallio.Utility.exe b/lib/Gallio_3.2.517.0/Gallio.Utility.exe
new file mode 100644
index 00000000..6bfe6b48
Binary files /dev/null and b/lib/Gallio_3.2.517.0/Gallio.Utility.exe differ
diff --git a/lib/Gallio_3.2.517.0/Gallio.Utility.exe.config b/lib/Gallio_3.2.517.0/Gallio.Utility.exe.config
new file mode 100644
index 00000000..8a56ceb1
--- /dev/null
+++ b/lib/Gallio_3.2.517.0/Gallio.Utility.exe.config
@@ -0,0 +1,26 @@
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/lib/Gallio_3.2.517.0/Gallio.Utility.plugin b/lib/Gallio_3.2.517.0/Gallio.Utility.plugin
new file mode 100644
index 00000000..f85e0c44
--- /dev/null
+++ b/lib/Gallio_3.2.517.0/Gallio.Utility.plugin
@@ -0,0 +1,18 @@
+
+
+
+ Gallio Utility
+ 3.2.0.0
+ A command-line utility for performing maintenance tasks related to the Gallio installation.
+ plugin://Gallio.Utility/Resources/Gallio.Utility.ico
+
+
+
+
+
\ No newline at end of file
diff --git a/lib/Gallio_3.2.517.0/Gallio.VisualStudio.Interop.dll b/lib/Gallio_3.2.517.0/Gallio.VisualStudio.Interop.dll
new file mode 100644
index 00000000..11c95753
Binary files /dev/null and b/lib/Gallio_3.2.517.0/Gallio.VisualStudio.Interop.dll differ
diff --git a/lib/Gallio_3.2.517.0/Gallio.VisualStudio.Interop.plugin b/lib/Gallio_3.2.517.0/Gallio.VisualStudio.Interop.plugin
new file mode 100644
index 00000000..3af8b371
--- /dev/null
+++ b/lib/Gallio_3.2.517.0/Gallio.VisualStudio.Interop.plugin
@@ -0,0 +1,28 @@
+
+
+
+ Visual Studio Interoperability Plugin
+ 3.2.0.0
+ Provides support for opening files in Visual Studio and launching the debugger.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
\ No newline at end of file
diff --git a/lib/Gallio_3.2.517.0/Gallio.XmlSerializers.dll b/lib/Gallio_3.2.517.0/Gallio.XmlSerializers.dll
new file mode 100644
index 00000000..e7c17aa4
Binary files /dev/null and b/lib/Gallio_3.2.517.0/Gallio.XmlSerializers.dll differ
diff --git a/lib/Gallio_3.2.517.0/Gallio.dll b/lib/Gallio_3.2.517.0/Gallio.dll
new file mode 100644
index 00000000..2e235578
Binary files /dev/null and b/lib/Gallio_3.2.517.0/Gallio.dll differ
diff --git a/lib/Gallio_3.2.517.0/Gallio.pdb b/lib/Gallio_3.2.517.0/Gallio.pdb
new file mode 100644
index 00000000..dc33a316
Binary files /dev/null and b/lib/Gallio_3.2.517.0/Gallio.pdb differ
diff --git a/lib/Gallio_3.2.517.0/Gallio.plugin b/lib/Gallio_3.2.517.0/Gallio.plugin
new file mode 100644
index 00000000..107ffe9c
--- /dev/null
+++ b/lib/Gallio_3.2.517.0/Gallio.plugin
@@ -0,0 +1,654 @@
+
+
+
+ Gallio
+ 3.2.0.0
+ The heart of Gallio.
+ plugin://Gallio/Resources/Gallio.ico
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Fallback
+ plugin://Gallio/Resources/Gallio.ico
+
+
+
+
+
+ ${Gallio.FallbackTestFramework}
+
+
+
+
+
+ ${Gallio.LocalTestIsolationProvider}
+
+
+ Local
+ Runs tests locally within the same process and AppDomain as the test runner application. Each test isolation context runs locally. This mode offers no isolation between tests and the test runner; it does not support loading test assembly configuration files or using a different runtime version or processor architecture.
+
+
+
+
+
+ ${Gallio.IsolatedAppDomainTestIsolationProvider}
+
+
+ IsolatedAppDomain
+ Runs tests within an isolated AppDomain of the same process as the test runner application. Each test isolation context runs in its own AppDomain. This mode provides lightweight but limited isolation between tests and the test runner; it does not support using different runtime version or processor architecture.
+
+
+
+
+
+ ${Gallio.IsolatedProcessTestIsolationProvider}
+
+
+ IsolatedProcess
+ Runs tests within an isolated process external to the test runner. Each test isolation context runs in its own process. This mode protects the test runner application from most faults that may occur during test execution; it supports all features.
+
+
+
+
+
+
+
+ ${Gallio.LocalHostFactory}
+
+
+
+
+
+ ${Gallio.IsolatedAppDomainHostFactory}
+
+
+
+
+
+ ${Gallio.IsolatedProcessHostFactory}
+
+
+
+
+
+ Project
+ A Gallio project file.
+ .*\.gallio
+
+
+
+
+
+ Executable
+ A library or program file.
+ .*\.(dll|exe)
+
+
+
+
+
+ Assembly
+ A .Net assembly.
+ Executable
+
+
+
+
+
+
+
+
+ ClearCurrentUserPluginCache
+ Clears the plugin cache of the current user.
+
+
+
+
+
+ FormatReport
+ Formats an existing XML test report. The command must be used with the following syntax:
+ "FormatReport {file} /ReportType:{type} [/ReportNameFormat:{format} /ReportOutput:{dir} /ReportArchive]"
+ - {file} is the relative or absolute path of the existing XML test report.
+ - ReportType (short form: /rt) specifies the type of the output report ('txt', 'txt-common', 'txt-condensed', 'html', 'html+xhtml', 'html-condensed', 'xhtml', 'xhtml-condensed', 'ccnet-details', or 'ccnet-details-condensed')
+ - ReportNameFormat (short form: /rnf) specifies the format of the output report (optional; if not specified, the same name is kept). The tags '{0}' and '{1}' are replaced respectively by the date and the time of the test run, or by the curent date/time if not applicable.
+ - ReportOutput (short form: /ro) specifies the output directory (optional; if not specified the current directory is used).
+ - ReportArchive (short form: /ra) compresses the output report in a file archive (zip).
+
+
+
+
+
+ VerifyInstallation
+ Checks for runtime installation errors.
+
+
+
+
+
+ Setup
+ Installs or uninstalls components.
+
+
+
+
+
+ ResetInstallationId
+ Resets the installation id. The plugin list will be refreshed the next time a Gallio application is started.
+
+
+
+
+
+ Root
+ The root node of the test tree.
+ plugin://Gallio/Resources/Assembly.ico
+
+
+
+
+
+ Assembly
+ A test assembly.
+ plugin://Gallio/Resources/Assembly.ico
+
+
+
+
+
+ File
+ A test file.
+ plugin://Gallio/Resources/Container.ico
+
+
+
+
+
+ Namespace
+ A test namespace.
+ plugin://Gallio/Resources/Container.ico
+
+
+
+
+
+ Group
+ A test group.
+ plugin://Gallio/Resources/Container.ico
+
+
+
+
+
+ Suite
+ A test suite.
+ plugin://Gallio/Resources/Container.ico
+
+
+
+
+
+ Fixture
+ A test fixture.
+ plugin://Gallio/Resources/Fixture.ico
+
+
+
+
+
+ Test
+ A test case.
+ plugin://Gallio/Resources/Test.ico
+
+
+
+
+
+ Unsupported
+ An unsupported test.
+ plugin://Gallio/Resources/Unsupported.ico
+
+
+
+
diff --git a/lib/Gallio_3.2.517.0/Gallio.xml b/lib/Gallio_3.2.517.0/Gallio.xml
new file mode 100644
index 00000000..a60f4129
--- /dev/null
+++ b/lib/Gallio_3.2.517.0/Gallio.xml
@@ -0,0 +1,44319 @@
+
+
+
+ Gallio
+
+
+
+
+ Represents a method that returns a value of a specified type from the instance of an object.
+
+
+
+ It is usually used to represent the invocation of a type property.
+
+
+ The type of the object to get the value from.
+ The type of the returned value.
+ The returned value.
+
+
+
+ An action with no arguments.
+
+
+
+
+ An action with two arguments.
+
+ The first argument type.
+ The second argument type.
+
+
+
+ An action with three arguments.
+
+ The first argument type.
+ The second argument type.
+ The third argument type.
+
+
+
+ An action with four arguments.
+
+ The first argument type.
+ The second argument type.
+ The third argument type.
+ The fourth argument type.
+
+
+
+ An action with five arguments.
+
+ The first argument type.
+ The second argument type.
+ The third argument type.
+ The fourth argument type.
+ The fifth argument type.
+
+
+
+ Encapsulates various strategies for counting the number of elements in a collection, an array, or
+ a simple enumerable type.
+
+
+
+
+ Constructor.
+
+ Thrown if
+
+
+
+ Counts the number of elements in a collection, an array, or any other enumerable type, by
+ using the most appropriate strategies.
+
+ An enumeration of counting strategies applicable to the specified enumerable values.
+
+
+
+ Represents a strategy for counting the number of elements in a collection, an array, or a simple enumerable type.
+
+
+
+
+ Gets the name of the counting strategy.
+
+
+
+
+ Gets a displayable description of the counting strategy.
+
+
+
+
+ Returns the number of elements found by applying the current counting strategy.
+
+ The number of elements found.
+
+
+
+ Name of the existing counting strategies.
+
+
+
+
+ Counts by getting the value returned by the
+
+
+
+ Counts by getting the value returned by the
+
+
+
+ Counts by enumerating the elements returned by
+
+
+
+ Counts by getting the value returned by an existing public "Count" property getter.
+
+
+
+
+ Represents the method that compares two objects of the same type.
+
+
+
+ This is a non-generic version of
+
+ a negative value if x is less than y, zero if x equals y, or a positive value if x is greater than y.
+
+
+
+ A function that returns the maximum number of threads that a work scheduler
+ may use to perform work. The value may change over time and cause the
+ scheduler to adapt to changing degrees of parallelism.
+
+ The degree of parallelism which must be at least 1.
+
+
+
+ Wrapper for
+
+
+
+ Checks whether a module with the specified file name is
+ loaded in the process.
+
+ true if the module is loaded; otherwise, false.
+
+
+
+ Immediately stops the associated process.
+
+
+
+
+ Discards any information about the associated process
+ that has been cached inside the process object.
+
+
+
+
+ Causes the
+ true if the associated process has reached an idle state.
+
+
+
+ Causes the
+
+ true if the associated process has reached an idle state; otherwise, false.
+
+
+
+
+ Gets a value indicating whether the associated process has been terminated.
+
+
+
+
+ Gets or sets the properties to passed to the
+
+
+
+ Gets the unique identifier for the associated process.
+
+
+
+
+ Wraps the static process creation methods on
+
+
+
+ Starts the process and associates it with a new
+ The new process.
+
+
+
+ Wraps the static process query methods on
+
+
+
+ Creates an array of
+ An array of
+
+
+
+ Default implementation of
+
+
+
+
+
+ Default implementation of
+
+
+
+
+
+ Default implementation of
+
+
+
+ Creates a new process wrapper.
+
+ If
+
+
+
+
+
+ Releases the resources used by the
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Schedules actions to be run in parallel up to a specified (variable)
+ maximum number of threads.
+
+
+
+ The implementation is designed to support re-entrance while still maintaining an
+ upper bound on active thread count. To avoid blowing the limit on thread count
+ due to re-entrance the caller's thread is also used to schedule work.
+
+
+ The work scheduler supports dynamically adjusting the degree of parallelism
+ as new work is added.
+
+
+
+
+
+ Creates a work scheduler.
+
+ Thrown if
+
+
+
+ Runs a set of actions in parallel up to the current degree of parallelism.
+
+
+
+ The implementation guarantees that the current thread will only be used to
+ run actions from the provided work set; it will not be used to run actions
+ from other concurrently executing work sets. Other threads will be used
+ to run actions from this work set and from other work sets in the order in
+ which they were enqueued. Thus this function will return as soon as all
+ of the specified actions have completed even if other work sets have
+ pending work.
+
+
+ Thrown if
+
+
+
+ Holds the value or exception produced by a task.
+
+
+
+
+
+
+ Returns true if the task ran to completion and returned a value,
+ or false if an exception was thrown.
+
+
+
+
+ Gets the value that was returned by the task.
+
+ Thrown if
+
+
+
+ Gets the exception that was thrown by the task.
+
+ Thrown if
+
+
+
+ Holds the value or exception produced by a task.
+
+
+
+
+ Creates a result object containing the value returned by the task.
+
+ The new task result.
+
+
+
+ Creates a result object containing the exception thrown by the task.
+
+ The new task result.
+ Thrown if
+
+
+
+ Gets the value that was returned by the task.
+
+ Thrown if
+
+
+
+ Redirects the console streams.
+
+
+
+
+ Redirect console output and error stream and disables the console input stream.
+
+ Thrown if
+
+
+
+ Resets the console streams as they were initially.
+
+
+
+
+ Resets the console streams as they were initially.
+
+
+
+
+ Abstract representation of a binary or text resource.
+
+
+
+ Different kind of resources are supported:
+
+ - Inline resources from a storage in memory.
+ - Embedded resources from an assembly manifest.
+ - File resources.
+
+
+
+
+
+
+ Opens the current resource as a
+ The stream.
+
+
+
+ Opens the current resource as a
+ The text reader.
+
+
+
+ Returns true if the contents are dynamic, or false if they are static.
+
+
+
+ Static contents can only change if the test assembly is recompiled.
+
+
+
+
+
+ Gets or sets a
+
+
+
+ Represents a resource embedded in an assembly file.
+
+
+
+
+ Constructs the representation of an embedded resource.
+
+
+
+
+
+
+
+
+
+
+ Representation of a file resource.
+
+
+
+
+ Constructs the representation of a file resource.
+
+
+
+
+ Constructs the representation of a file resource.
+
+
+
+
+
+
+
+
+
+
+ Represents an inline memory resource.
+
+
+
+
+ Constructs the representation of an inline memory resource.
+
+
+
+
+
+
+
+
+
+
+ Lazy computation type.
+
+ The encapsulated type.
+
+
+
+ Constructor.
+
+ Thrown if
+
+
+
+ Gets the value.
+
+
+
+
+ Specifies the type of the contents of an embedded attachment.
+
+
+
+
+ The attachment is encoded as a text string.
+
+
+
+
+ The attachment is a binary file either directly available as a file, or encoded as base 64 text string.
+
+
+
+
+ Utilities for normalizing markup contents.
+
+
+
+
+ Normalizes a content type.
+
+ The normalized content type, or null if none. May be the same instance if
+
+
+
+ Normalizes an attachment name.
+
+ The normalized attachment name, or null if none. May be the same instance if
+
+
+
+ Normalizes a stream name.
+
+ The normalized stream name, or null if none. May be the same instance if
+
+
+
+ Normalizes a section name.
+
+ The normalized section name, or null if none. May be the same instance if
+
+
+
+ Normalizes markup text.
+
+ The normalized text, or null if none. May be the same instance if
+
+
+
+ Implementation of a Chi-square test (http://en.wikipedia.org/wiki/Chi_square_test)
+ that calculates the "difference" between an expected and an actual statistical distribution.
+
+
+
+
+ Runs a Chi-square test.
+
+
+
+ Given the observed events (
+
+ A small value of the significance probability indicates a significant difference between the distributions.
+
+
+
+
+
+ Gets the resulting number of degrees of freedom.
+
+
+
+
+ Gets the resulting Chi-square value.
+
+
+
+
+ Gets the resulting significance probability.
+
+
+
+
+ Helper methods to calculate the Gamma function (http://en.wikipedia.org/wiki/Gamma_function).
+
+
+
+
+ Returns the incomplete Gamma function Q(a,x).
+
+
+
+
+ The Gallio.Common.Math namespace provides advanced mathematical
+ functions and helper classes not found in
+
+
+
+ An interface implemented by the server and registered on the server remoting channel
+ to allow message exchange with the client.
+
+
+
+ This is interim API to be used until the new message broker is ready.
+
+
+
+
+
+ Gets the next message.
+
+ The next message, or null if a timeout occurred.
+
+
+
+ Sends a message.
+
+
+
+
+ A message consumer provides a simple pattern for handling messages based on their type.
+
+
+
+ A message consumer consists of a series of typed handler clauses which are traversed in
+ order until a handler which matches the message type is found.
+
+
+
+
+ (message => DoSomethingWithFooMessage(message))
+ .Handle(message => DoSomethingWithBarMessage(message))
+ .Otherwise(message => throw new NotSupportedException());
+
+ consumer.Consume(new FooMessage());
+ consumer.Consume(new BarMessage());
+ ]]>
+
+
+
+
+
+ Publishes messages directly to a subscriber.
+
+
+
+
+ Publishes a message.
+
+ Thrown if
+ Thrown if
+
+
+
+ Creates a new message consumer with no handler clauses.
+
+
+
+
+ Consumes a message.
+
+ True if the message was consumed by a handler, false if no handler could consume it.
+ Thrown if
+ Thrown if
+
+
+
+ Adds a handler for a particular message type.
+
+ The message type.
+ The message consumer.
+ Thrown if
+
+
+
+ Adds a catch-all handler.
+
+ The message consumer.
+ Thrown if
+
+
+
+ The Gallio.Common.Messaging namespace provides an abstraction for
+ sending messages between components.
+
+
+
+
+ The type of exception thrown when an error occurs while manipulating the disk cache.
+
+
+
+
+ Creates an exception.
+
+
+
+
+ Creates an exception.
+
+
+
+
+ Creates an exception.
+
+
+
+
+ Creates an exception from serialization info.
+
+
+
+
+ A disk cache manages temporary files and directories stored on disk and
+ arranged into groups associated with arbitrary string keys.
+
+
+
+ The files and directories within each group are assumed to have the same lifetime.
+
+
+
+ Write a file to the cache:
+
+
+
+
+ Deletes all items in the cache.
+
+ Thrown if an error occurs.
+
+
+
+ Gets the collection of disk cache groups.
+
+
+
+
+ A disk cache group represents an indexed partition of the disk cache.
+
+
+
+ It is physically manifested as a directory on disk and may contain any
+ number of related files or directories with the same lifetime.
+
+
+
+
+
+ Creates the group if it does not exist.
+
+ Thrown if an error occurs.
+
+
+
+ Deletes the group and all of its contents if any.
+
+ Thrown if an error occurs.
+
+
+
+ Gets information about a file within the group.
+
+
+
+ This method will succeed even if the file or the group does not exist.
+
+
+ The file info.
+ Thrown if
+ Thrown if an error occurs.
+
+
+
+ Gets information about a directory within the group.
+
+
+
+ This method will succeed even if the directory or the group does not exist.
+
+
+ The directory info.
+ Thrown if
+ Thrown if an error occurs.
+
+
+
+ Opens a file within the group.
+
+
+
+ If a new file is being created, automatically create the group and the
+ containing directory for the file.
+
+
+ The file stream.
+ Thrown if
+ Thrown if an error occurs.
+
+
+
+ Creates a directory within the group.
+
+ Directory information for the directory that was created.
+ Thrown if
+ Thrown if an error occurs.
+
+
+
+ Gets the disk cache that contains the group.
+
+
+
+
+ Gets the key of the group.
+
+
+
+
+ Gets the
+
+
+
+ Returns true if the group exists on disk.
+
+ Thrown if an error occurs.
+
+
+
+ Represents a collection of groups in a disk cache indexed by an aritrary key string.
+
+
+
+
+ Gets the group with the specified key.
+
+ The group.
+ Thrown if
+
+
+
+ The Gallio.Common.Caching namespace contains types related to caching.
+
+
+
+
+ A simple disk cache that stores its contents in a particular directory using hashes
+ of the key values to ensure uniqueness.
+
+
+
+
+ Creates a simple disk cache.
+
+ Thrown if
+
+
+
+
+
+ Gets the group with the given key.
+
+ The cache group.
+
+
+
+ Gets the path of the cache directory.
+
+
+
+
+
+
+ Represents a disk cache group.
+
+
+
+
+ Creates a group.
+
+ Thrown if
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ A disk cache that stores its contents in the user's temporary directory.
+
+
+
+
+ The default cache directory name.
+
+
+
+
+ Creates a temporary disk cache within the specified subdirectory of the user's temporary directory.
+
+ Thrown if
+
+
+
+ Creates a temporary disk cache within the
+
+
+
+ Compares arrays for equality by element.
+
+
+
+
+ Gets a default instance of the array equality comparer.
+
+
+
+
+ Creates a default array equality comparer.
+
+
+
+
+ Creates an array equality comparer using the specified element comparer.
+
+
+
+
+
+
+
+
+ Utility functions for manipulating collections.
+
+
+
+
+ Converts all elements of the input collection and returns the collected results as an array
+ of the same size.
+
+ The input type.
+ The output type.
+ The output array.
+
+
+
+ Copies all of the elements of the input collection to an array.
+
+ The element type.
+ The output array.
+
+
+
+ Returns the first element of the input enumeration for which the specified
+ predicate returns true.
+
+ The element type.
+ The first matching value or the default for the type if not found.
+
+
+
+ Returns an array of the specified length, filled with the specifed constant value.
+
+ The type of the array.
+ The resulting array.
+
+
+
+ A covariant list converts a list of the input type to a
+ read-only list of the more generic output type. The wrapped
+ list can be used to mimic covariance in method return types.
+
+ The input list type.
+ The output list type.
+
+
+
+ Creates a wrapper for the specified list.
+
+ Thrown if
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Gets an item from the list with the specified index.
+
+ The item.
+ Thrown if
+
+
+
+
+
+ Provides a singleton empty array instance.
+
+ The type of array to provide.
+
+
+
+ An empty array of type
+
+
+
+ A read-only empty dictionary.
+
+ The dictionary key type.
+ The dictionary value type.
+
+
+
+ A read-only empty dictionary instance.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Utility functions for manipulating generic collections.
+
+
+
+
+ Converts each element of the input collection and stores the result in place.
+
+ The item type.
+
+
+
+ Converts each element of the input collection and stores the result in the
+ output list using the same index. The output list must be at least as
+ large as the input list.
+
+ The input type.
+ The output type.
+
+
+
+ Converts each element of the input collection and adds the result to the
+ output collection succession in the same order.
+
+ The input type.
+ The output type.
+
+
+
+ Converts each element of the input collection and returns the collected results as an array
+ of the same size.
+
+ The input type.
+ The output type.
+ The output array.
+
+
+
+ Copies all of the elements of the input enumerable to an array.
+
+ The element type.
+ The output array.
+
+
+
+ Copies all of the elements of the input collection to an array.
+
+ The element type.
+ The output array.
+
+
+
+ Returns the first element of the input enumeration for which the specified
+ predicate returns true.
+
+ The element type.
+ The first matching value or the default for the type if not found.
+
+
+
+ Returns true if the input enumeration contains an element for which the predicate returns true.
+
+ The element type.
+ True if a matching element exists.
+
+
+
+ Performs an action for each element in an enumeration.
+
+ The element type.
+
+
+
+ Adds all elements of the input enumeration to the output collection.
+
+ The element type.
+
+
+
+ Adds elements of the input enumeration to the output collection,
+ if not already present.
+
+ The element type.
+
+
+
+ Returns true if the elements of both lists are equal.
+
+ True if the elements are equal.
+
+
+
+ Returns true if the elements of both lists are equal.
+
+ True if the elements are equal.
+
+
+
+ Returns true if both dictionaries have equal key/value pairs.
+
+ True if the elements are equal.
+
+
+
+ Returns true if the elements of both lists are equal but possibly appear in a different order.
+ Handles elements that appear multiple times and ensures that they appear the same
+ number of times in each list.
+
+ True if the elements are equal.
+
+
+
+ Projects each element of a sequence into a new form.
+
+ The output sequence
+ Thrown if any argument is null.
+
+
+
+ A hashtable-based set implementation.
+
+
+
+ This will probably be replaced by the new HashSet{T} class in
+ the new System.Core of .Net 3.5.
+
+
+
+
+
+ Creates an empty set.
+
+
+
+
+ Creates an empty set using the specified comparer.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ A multi-map allows a list of values to be associated with a single key.
+
+
+
+ The value collections provided by the multi-map are always read-only.
+ They can only be modified by calling the appropriate methods of the multi-map
+ to add or remove items. This behavior helps multi-map implementations
+ better maintain their invariants.
+
+
+
+
+
+ Adds a value to the list of those associated with a key.
+
+
+
+
+ Adds all of the values from the specified map.
+
+ Thrown if
+
+
+
+ Adds all of the values from the specified enumeration of key-value pairs.
+
+ Thrown if
+
+
+
+ Returns true if the map contains an entry with the specified key and value.
+
+ True if the map contains an entry with the specified key and value.
+
+
+
+ Removes a value from the list of those associated with a key.
+
+ True if the value was removed.
+
+
+
+ Gets the contents of the multi-map as an enumeration of pairs of keys and lists of values.
+
+
+
+
+ A strongly-typed key to be used together with an associative array to help the
+ compiler perform better type checking of the value associated with the key.
+
+ The type of value associated with the key.
+
+
+
+ Creates a new key.
+
+ Thrown if
+
+
+
+
+
+ Gets the unique name of the key.
+
+
+
+
+ Lazily populates and caches values associated with a particular key.
+
+
+
+ Instances of this type are safe for use by multiple concurrent threads.
+ In the case of a race occurs between two threads that result in the population of the
+ same key, the populator function may be called concurrently with two requests for the same
+ key. The winner of the race gets to store its value in the cache for later use.
+ However, the loser of the race will discard its value and use the newly cached instead.
+
+
+
+
+
+ Creates a cache with the specified populator function.
+
+ Thrown if
+
+
+
+ Gets the value associated with the specified key.
+ Populates it on demand if not already cached.
+
+ The associated value.
+
+
+
+ A multi-map allows a list of values to be associated with a single key.
+
+
+
+
+ Creates an empty multi-map.
+
+
+
+
+ Adds a value to the list of those associated with a key.
+
+
+
+
+ Adds all values in the pair to the specified key.
+
+
+
+
+ Adds all values in the pair to the specified key.
+
+
+
+
+
+
+
+
+
+
+ Returns true if the map contains an entry with the specified key and value.
+
+ True if the map contains an entry with the specified key and value.
+
+
+
+
+
+ Returns true if the map contains at least one value associated with
+ the specified key.
+
+ True if there is at least one value associated with the key.
+
+
+
+
+
+ Removes all values associated with the specified key.
+
+ True if the key existed and was removed.
+
+
+
+ Removes a value from the list of those associated with a key.
+
+ True if the value was removed.
+
+
+
+ Removes all values in the pair from the specified key.
+
+ True if at least one value was removed.
+
+
+
+
+
+
+
+ Obtains a read-only view of another multi-map.
+
+ Thrown if
+
+
+
+ Gets the number of distinct keys in the map.
+
+
+
+
+
+
+ Gets the collection of keys in the multi-map.
+
+
+
+
+ Gets the collection of lists of values in the multi-map.
+
+
+
+
+
+
+ Gets or sets the list of values associated with the specified key.
+ Returns an empty list if there are none.
+
+ The list of values.
+
+
+
+ The Gallio.Common.Collections namespace contains specialized collection types and
+ collection utilities.
+
+
+
+
+ A property bag associates keys with values where each key may have one or more associated value.
+ All keys and values must be non-null strings.
+
+
+
+ This collection supports Xml-serialization and content-based equality comparison.
+
+
+
+
+
+ Creates an empty property bag.
+
+
+
+
+ Creates a copy of this property bag.
+
+ The copy.
+
+
+
+ Gets a read-only view of this property set.
+
+ A read-only view.
+
+
+
+ Gets the first value associated with a key.
+
+
+
+ If there are multiple values, returns only the first one.
+
+
+ The first associated value, or null if none.
+
+
+
+ Sets the value associated with a key.
+
+
+
+ Removes all values previously associated with that key.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Provides the Xml schema for this element.
+
+ The schema type of the element.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ A property set associates keys with values where each key may have exactly one associated value.
+ All keys and values must be non-null strings.
+
+
+
+ This collection supports Xml-serialization and content-based equality comparison.
+
+
+
+
+
+ Creates an empty property set.
+
+
+
+
+ Adds all elements of another collection to this dictionary.
+
+ Thrown if
+
+
+
+ Creates a full copy of this property set.
+
+ The copy.
+
+
+
+ Gets a read-only view of this property set.
+
+ A read-only view.
+
+
+
+ Gets the value associated with a key, or null if absent.
+
+ The associated value, or null if none.
+
+
+
+ Sets the value associated with a key, removes an existing value if null.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Provides the Xml schema for this element.
+
+ The schema type of the element.
+
+
+
+
+
+
+
+
+
+
+
+
+
+ A read-only dictionary wrapper.
+
+
+
+
+ Creates a read-only dictionary wrapper for another dictionary.
+
+ Thrown if
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Provides a read-only view of another multi-map.
+
+
+
+
+ Creates a read-only view of the specified multi-map.
+
+ Thrown if
+
+
+
+ An equality comparer that compares values by reference.
+
+ The type of values to compare, must be reference types.
+
+
+
+
+
+
+
+ Gets the singleton instance of the comparer.
+
+
+
+
+ Provides functions for manipulating ad-hoc trees.
+
+
+
+
+ Gets an enumeration of a tree data structure in pre-order traversal.
+
+ The type of node in the tree.
+ The pre-order traversal enumeration.
+
+
+
+ Enumerates child nodes in a tree.
+
+ The node's children.
+
+
+
+ A user data collection stores arbitrary key/value pairs that may be associated
+ with other objects in the system.
+
+
+
+ Accesses to the collection are synchronized during access. To safely manupulate
+ multiple keys at one time, simply lock the
+
+
+
+
+ Creates an empty collection.
+
+
+
+
+ Creates a copy of the collection.
+
+ The copy.
+
+
+
+ Tries to get a value from the collection.
+
+ default(T) if none present.
+ True if a value was obtained.
+ The value type.
+
+
+
+ Gets a value from the collection.
+
+ The associated value.
+ Thrown if
+ The value type.
+
+
+
+ Gets a value from the collection or a default value if none found.
+
+ The associated value, or the default value.
+ The value type.
+
+
+
+ Determines whether a key has an associated value in the collection.
+
+ True if the key has an associated value.
+ Thrown if
+ The value type.
+
+
+
+ Sets a value in the collection.
+
+ The value type.
+
+
+
+ Removes a value from the collection.
+
+ The value type.
+
+
+
+ An event dispatched by the
+
+
+
+ Creates event arguments.
+
+ Thrown if
+
+
+
+ Gets the process start info being configured.
+
+
+
+
+ A lock box object provides protected read / write access to a shared object
+ that may be accessed concurrently by multiple threads.
+
+
+
+ Clients are expected to use the
+
+ The type of object inside the lock box.
+
+
+
+ Creates a lock box for the specified object.
+
+
+
+
+ Acquires a read lock and invokes the action with the object inside the lock box.
+
+ Thrown if
+
+
+
+ Acquires a write lock and invokes the action with the object inside the lock box.
+
+ Thrown if
+
+
+
+ Acquires a read lock and invokes the function with the object inside the lock box.
+
+ The value returned by the function.
+ The function result type.
+ Thrown if
+
+
+
+ Acquires a write lock and invokes the function with the object inside the lock box.
+
+ The value returned by the function.
+ The function result type.
+ Thrown if
+
+
+
+ The Gallio.Common.Concurrency namespace contains types for synchronizing access
+ to resources and managing threads and processes.
+
+
+
+
+ A process task provides support for launching external processes
+ and collecting their output.
+
+
+
+ The process task provides a guarnatee that when you call
+
+
+
+
+ A task represents a concurrently executing operation.
+
+
+
+ A
+
+ A
+
+
+
+
+ This lock ensures that Start, Abort and NotifyTerminated are serialized.
+ Without it, we could end up sending a Terminated event before the client
+ received the Started event. Since events are dispatched synchronously,
+ serializing them in this manner helps clients to maintain correct internal state.
+
+
+
+
+ Creates a task.
+
+ Thrown if
+
+
+
+ Starts running the task.
+
+
+
+ Does nothing if the task has already been started or has been aborted.
+
+
+
+
+
+ Asynchronously aborts the task.
+
+
+
+ If the task has not been started, then the task will be forbidden from starting later
+ and its
+
+ A typical implementation of this method may cause a
+
+
+
+
+ Waits for the task to terminate.
+
+
+
+ Does nothing if the task has not been started or is not running.
+
+
+ True if the task is not running as of the time this method exits,
+ false if a timeout occurred while waiting.
+ Thrown if
+
+
+
+ Starts the task and waits for it to complete until the timeout expires.
+ If the timeout expires, aborts the task and returns false .
+
+ Thrown if
+ True if the task ran to completion within the specified time span,
+ false if the task was aborted.
+
+
+
+ Starts the task.
+
+
+
+
+ Aborts the task.
+
+
+
+
+ Waits for the task to terminate.
+
+ True if the task is not running as of the time this method exits,
+ false if a timeout occurred while waiting.
+
+
+
+ Dispatches notification that the task has terminated and provides its result.
+
+ Thrown if
+ Thrown if the task is not currently running.
+
+
+
+ Notifies the
+
+ This method may be overridden by a subclass to perform any necessary actions
+ just prior to calling the event handlers.
+
+
+
+
+ Notifies the
+
+ This method may be overridden by a subclass to perform any necessary actions
+ just prior to calling the event handlers.
+
+
+
+
+ Notifies the
+
+ This method may be overridden by a subclass to perform any necessary actions
+ just prior to calling the event handlers.
+
+
+
+
+ Gets the name of the task.
+
+
+
+
+ Returns true if the task has not been started or aborted yet.
+
+
+
+
+ Returns true if the task is running.
+
+
+
+
+ Returns true if the task ran and was terminated.
+
+
+
+
+ Returns true if the task has been aborted.
+
+
+
+
+ Gets the task result, or null if the task has not terminated or was aborted before starting.
+
+
+
+
+ Adds or removes an event handler that is signaled when the task is started.
+ If a handler is being added and the task has already started, it is immediately invoked.
+
+
+
+
+ Adds or removes an event handler that is signaled when the task is aborted.
+ If a handler is being added and the task has already aborted, it is immediately invoked.
+
+
+
+
+ Adds or removes an event handler that is signaled when the task is terminated.
+ If a handler is being added and the task has already terminated, it is immediately invoked.
+
+
+
+
+ Creates a process task.
+
+ Thrown if
+
+
+
+ Sets an environment variable to be passed to the process when started.
+
+ Thrown if the process has already been started.
+ Thrown if
+
+
+
+
+
+ Starts a
+
+
+ This method may be override to change how the process is created and
+ started.
+
+
+ The process.
+
+
+
+
+
+
+
+ Gets the executable path.
+
+
+
+
+ Gets the arguments.
+
+
+
+
+ Gets the working directory path.
+
+
+
+
+ Gets the
+
+ Please be aware that
+
+
+
+ Gets or sets whether console output stream of the process should be captured
+ and made available via the
+
+
+ The default value is false .
+
+
+
+
+
+ Gets or sets whether console error stream of the process should be captured
+ and made available via the
+
+
+ The default value is false .
+
+
+
+
+
+ Gets or sets whether to execute the command with the Windows shell.
+
+
+
+ The default value is false .
+
+
+
+
+
+ Gets or sets whether to create a window for the command prompt.
+
+
+
+ The default value is false .
+
+
+
+
+
+ Gets the captured contents of the console output stream written by the process.
+
+ Thrown if the process has not been started
+ or if null .
+
+
+
+ Gets the captured contents of the console error stream written by the process.
+
+ Thrown if the process has not been started
+ or if null .
+
+
+
+ Gets the exit code of the process, or -1 if the process did not run or has not exited.
+
+
+
+
+ Gets a description of the exit code, if available, or null otherwise.
+
+
+
+
+ The event fired to configure
+
+
+
+ The event fired when each line of new output is received on the console output stream.
+
+
+
+ This event should be wired up before starting the task to ensure that
+ no data is lost.
+
+
+ Please note that the
+
+
+
+
+ The event fired when each line of new output is received on the console error stream.
+
+
+
+ This event should be wired up before starting the task to ensure that
+ no data is lost.
+
+
+ Please note that the
+
+
+
+
+ An action that reads the contents of a protected object. It should not modify the object in any way.
+
+ The type of object.
+
+
+
+ A function that reads the contents of a protected object and produces some result. It should not modify the object in any way.
+
+ The type of object.
+ The result type.
+
+
+
+ A
+
+
+ For example, when a
+
+
+
+
+ Creates an empty task container.
+
+
+
+
+ Adds a new task for this container to watch.
+
+ Thrown if
+
+
+
+ Asynchronously aborts all of the tasks currently running within the container.
+
+
+
+
+ Waits for all of currently running tasks to terminate.
+
+ True if no tasks are running as of the time this method exits,
+ false if a timeout occurred while waiting.
+ Thrown if
+
+
+
+ Gets the list of all tasks that are currently running.
+
+ The list of running tasks.
+
+
+
+ Adds or removes an event handler that is signaled when any watched task is started.
+
+
+
+
+ Adds or removes an event handler that is signaled when any watched task is aborted.
+
+
+
+
+ Adds or removes an event handler that is signaled when any watched task is terminated.
+
+
+
+
+ A task-related event.
+
+
+
+
+ Creates event arguments for a task-related event.
+
+ Thrown if
+
+
+
+ Gets the task that the event is about.
+
+
+
+
+ A
+
+
+ This class may be used as a primitive for implementing higher-level protected
+ scopes for the purpose of asynchronous cancelation and time-limited execution.
+
+
+ The implementation distinguishes between
+
+
+
+
+ Maximum number of times to poll for a pending abort before giving up.
+
+
+
+
+ Indicates that the thread scope is not currently running abortable code.
+ It could either not be entered, or it could be entered and running a
+ protected block.
+
+
+
+
+ Indicates that the thread scope is running abortable code.
+
+
+
+
+ Indicates that
+
+
+
+ Indicates that the scope has been aborted and a
+
+
+
+ Runs an action inside of the scope.
+
+
+
+ At most one action may be in progress at any time. This method is not
+ reentrant and cannot be called concurrently from multiple threads.
+
+
+ The
+ Thrown if
+ Thrown if an action is already running in this scope.
+ Any other exception thrown by
+
+
+
+ Enters a protected context wherein it cannot receive a thread abort from this
+
+
+
+ This method enables critical system code to be protected from aborts that
+ may affect the scope. This call cannot be nested.
+
+
+ An object that when disposed ends the protected block, possibly null if there was no protection necessary.
+
+
+
+ Aborts the currently running action and prevents any further actions from running
+ inside of this scope.
+
+
+
+
+ Because a thread abort is delivered asynchronously, we need to synchronize with
+ it to ensure that it gets delivered. Otherwise the pending thread abort exception
+ could occur outside of our special region.
+
+
+
+
+ An implementation of
+
+
+
+ Creates a task that will execute code within a new locally running thread.
+ When the task terminates successfully, its result will contain the value
+ returned by
+ Thrown if
+
+
+
+ Creates a task that will execute code within a new locally running thread.
+ When the task terminates successfully, its result will contain the value null .
+
+ Thrown if
+
+
+
+ Performs an action within the thread before the task's main action runs.
+
+
+
+ The default implementation does nothing but may be overridden to introduce new behaviors.
+
+
+
+
+
+ Performs an action within the thread after the task's main action runs.
+
+
+
+ The default implementation does nothing but may be overridden to introduce new behaviors.
+
+
+
+
+
+
+
+
+
+
+
+ Gets or sets the desired
+
+ The default value is
+ Thrown if this method is called
+ after the thread has started.
+
+
+
+ Gets the thread on which the task is running, or null if the
+ task is not running.
+
+
+
+
+ An action that reads or writes the contents of a protected object.
+
+ The type of object.
+
+
+
+ A function that reads or writes the contents of a protected object and produces some result.
+
+ The type of object.
+ The result type.
+
+
+
+ Describes an exception in a serializable form.
+
+
+
+
+ Interface implemented by objects that can write themselves to
+ a
+
+
+
+ Writes the object to a markup stream.
+
+ Thrown if
+
+
+
+ Provides a method that may be called by client code to obtain a normalized
+ copy of an object.
+
+ The object type.
+
+
+
+ Obtains a normalized copy of the object or the original instance if it is already normalized.
+
+
+
+ Some object may be considered valid but have content which is not in a suitable
+ form for further processing. For example, a message object may have a field that contains
+ excessive whitespace or non-printable characters that can be trimmed. To handle
+ these cases, the message consumer may call the
+
+ This method may assume that the object has already been validated.
+
+
+ This method is not permitted to modify the original object or its contents. If the
+ contents must be changed during normalization then a copy should be created
+ and returned.
+
+
+ The original instance or a normalized copy.
+
+
+
+ Gets an empty read-only property set that can be used to indicate that
+ an exception data object does not contain any properties.
+
+
+
+
+ Creates an exception data object from an exception.
+
+
+
+ Captures the exception type, message, stack trace and properties from
+ the exception object. To filter out specific properties, mark them with
+
+
+ Thrown if
+
+
+
+ Creates an exception data object.
+
+ Thrown if
+
+
+
+ Creates an exception data object.
+
+ Thrown if
+
+
+
+
+
+ Formats the exception to a string similar to the one that the .Net framework
+ would ordinarily construct.
+
+
+
+ The exception will not be terminated by a new line.
+
+
+ The formatted exception.
+
+
+
+ Formats the exception to a string similar to the one that the .Net framework
+ would ordinarily construct.
+
+
+
+ The exception will not be terminated by a new line.
+
+
+ The formatted exception.
+
+
+
+ Writes the exception in a structured format with markers to distinguish its component elements.
+
+
+
+ The exception will not be terminated by a new line.
+
+
+ Thrown if
+
+
+
+ Writes the exception in a structured format with markers to distinguish its component elements.
+
+
+
+ The exception will not be terminated by a new line.
+
+
+ Thrown if
+
+
+
+ Gets the exception type full name.
+
+
+
+
+ Gets the exception message text.
+
+
+
+
+ Gets the exception stack trace.
+
+
+
+
+ Gets the inner exception data, or null if none.
+
+
+
+
+ Gets the read-only set of formatted exception properties.
+
+
+
+
+ The Gallio.Common.Diagnostics namespace contains types for reporting
+ failure diagnostics including a stack trace filtering mechanism.
+
+
+
+
+ Describes a stack trace in a serializable form.
+
+
+
+
+ Creates a stack trace data object from a string.
+
+ Thrown if
+
+
+
+ Creates a stack trace data object that points to the specified code element.
+
+ Thrown if
+
+
+
+
+
+ Formats the stack trace to a string similar to the one that the .Net framework
+ would ordinarily construct.
+
+
+
+ The exception will not be terminated by a new line.
+
+
+ The formatted stack trace.
+
+
+
+ Writes the stack trace in a structured format with markers to distinguish its component elements.
+
+
+
+ The stack trace will not be terminated by a new line.
+
+
+ Thrown if
+
+
+
+ Returns true if the stack trace data is empty.
+
+
+
+
+ Provides methods for filtering the stack trace for tests.
+
+
+
+ The objective of this filtering is to omit frames that are not relevant to the user
+ when reporting stack traces.
+
+
+ Stack trace filtering proceeds as follows:
+
+ - Stack frames that have an associated
+ - The stack trace is chopped just above the top-most stack frame with
+ an associated
+
+
+
+
+
+
+ Filters a stack trace.
+
+ The filtered stack trace.
+ Thrown if
+
+
+
+ Filters a stack trace.
+
+ The filtered stack trace string.
+ Thrown if
+
+
+
+ Filters the stack trace information in an exception.
+
+ The filtered exception data.
+ Thrown if
+
+
+
+ Filters the stack trace information about an exception.
+
+ The filtered exception data.
+ Thrown if
+
+
+
+ Captures a filtered stack trace from the currently executing thread.
+
+ The filtered stack trace.
+
+
+
+ This attribute is used to mark methods and types that are internal to the implementation
+ of the system.
+
+
+
+ The
+
+ Other attributes may also contribute to stack trace filtering. Refer to
+
+
+ The
+
+
+
+
+ This attribute is used to mark methods that call into user code.
+
+
+
+ The
+
+ If two entry points are nested within one another in the call stack, then the
+ effect is the same as if the outermost entry point did not appear. This enables
+ test frameworks to support recursion into themselves.
+
+
+ Other attributes may also contribute to stack trace filtering. Refer to
+
+
+
+
+
+ Represents a method that determines whether two objects of the same type are equal.
+
+ True if the object are equal; otherwise false.
+
+
+
+ Represents a strongly-typed method that determines whether two objects of the same type are equal.
+
+
+
+ This delegate is for
+
+ The type of the objects to compare.
+ True if the object are equal; otherwise false.
+
+
+
+ The Gallio.Common.IO namespace contains utilities and a test-friendly facade for
+ common input/output operations.
+
+
+
+
+ The Gallio.Common.Markup namespace provides a structured text format
+ consisting of documents which may have multiple streams of text each of
+ which may be subdivided into sections of text with optional style markers.
+
+
+
+
+ The Gallio.Common.Markup.Tags namespace defines the tags used by the
+ markup document format to encode structured documents in Xml.
+
+
+
+
+ A video frame that consists of a bitmap.
+
+
+
+
+ Represents a single frame of video content.
+
+
+
+
+ Copies pixels from the frame into a buffer.
+
+ Thrown if
+ Thrown if the
+ Thrown if the
+ Thrown if the combined
+
+
+
+ Copies pixels from the frame into a buffer.
+
+
+
+ The arguments have already been checked to ensure that all pixels in the requested
+ range will fit in the pixel buffer. The implementation can assume that it will be safe to
+ write all requested pixels into the buffer (so it may use unmanaged code to do so
+ if desired).
+
+
+
+
+
+ Gets the width of the video frame.
+
+
+
+
+ Gets the height of the video frame.
+
+
+
+
+ Creates a bitmap video frame.
+
+ Thrown if
+
+
+
+
+
+ Gets the bitmap.
+
+
+
+
+
+
+
+
+ Specifies the vertical alignment of a caption.
+
+
+
+
+ Specifies top alignment.
+
+
+
+
+ Specifies middle alignment.
+
+
+
+
+ Specifies bottom alignment.
+
+
+
+
+ Specifies the horizontal alignment of a caption.
+
+
+
+
+ Specifies left alignment.
+
+
+
+
+ Specifies horizontal alignment.
+
+
+
+
+ Specifies right alignment.
+
+
+
+
+ Displays a caption overlayed on top of an image.
+
+
+
+
+ Abstract base class for video overlays.
+
+
+
+
+ Paints the overlay.
+
+ Thrown if
+
+
+
+ Paints the overlay.
+
+
+
+
+ Creates a caption overlay.
+
+
+
+
+
+
+ Gets or sets the text of the caption.
+
+ The text of the caption or an empty string if none.
+ Thrown if
+
+
+
+ Gets or sets the font size.
+
+ The font size. Default is 16.
+ Thrown if
+
+
+
+ Gets or sets the horizontal alignment.
+
+ The horizontal alignment. Default is
+
+
+
+ Gets or sets the vertical alignment.
+
+ The vertical alignment. Default is
+
+
+
+ Specifies parameters for screenshot captures.
+
+
+
+
+ Creates a capture parameters object.
+
+
+
+
+ Gets or sets the zoom factor.
+
+
+
+ The zoom factor specifies the degree of magnification or reduction desired.
+ For example, a zoom factor of 1.0 (the default) is normal size, 0.25 reduces to one quarter the
+ original size and 2.0 magnifies to twice the original size.
+
+
+ Thrown if
+
+
+
+ The Gallio.Common.Media namespace provides types for capturing
+ screenshots and encoding video content.
+
+
+
+
+ Manages video source overlays.
+
+
+
+
+ Creates an overlay manager with no overlays.
+
+
+
+
+ Adds an overlay.
+
+ Thrown if
+
+
+
+ Removes an overlay.
+
+ Thrown if
+
+
+
+ Asks all overlays to paint themselves.
+
+ Thrown if
+
+
+
+ Asks all overlays to paint themselves over the specified image.
+
+ Thrown if
+
+
+
+ Returns a wrapper for the overlay manager as a composite overlay.
+
+ The composite overlay.
+
+
+
+ Gets the read-only list of registered overlays.
+
+
+
+
+ Describes a request to paint overlays.
+
+
+
+
+ Creates an overlay paint request.
+
+ Thrown if
+
+
+
+ Gets the graphics object to use for painting the overlay.
+
+
+
+
+ Gets the bounds of the frame that is being rendered into the graphics context.
+
+
+
+
+ Gets the zero-based monotonically increasing number of the frame that is being rendered.
+
+
+
+
+ Gets the frame rate expressed as the number of frames per second, or zero if the frame is static.
+
+
+
+
+ An exception that is thrown when screenshots cannot be captured.
+
+
+
+ This exception may indicate that the application is running as a service which has
+ not been granted the right to interact with the desktop.
+
+
+
+
+
+ An exception that expresses a problem performing a media operation.
+
+
+
+
+ Creates an exception.
+
+
+
+
+ Creates an exception.
+
+
+
+
+ Creates an exception.
+
+
+
+
+ Creates an exception from serialization info.
+
+
+
+
+ Creates an exception.
+
+
+
+
+ Creates an exception.
+
+
+
+
+ Creates an exception.
+
+
+
+
+ Creates an exception from serialization info.
+
+
+
+
+ Records screenshots as a video.
+
+
+
+
+ Creates a screen recorder.
+
+ Thrown if
+ Thrown if
+
+
+
+ Disposes the screen recorder.
+
+
+
+
+ Starts or resumes recording.
+
+ Thrown if the object has been disposed.
+
+
+
+ Stops recorded.
+
+ Thrown if the object has been disposed.
+
+
+
+ Paints overlays onto a bitmap.
+
+
+
+
+ Adds a captured screenshot to the video.
+
+
+
+
+ Disposes the screen recorder.
+
+
+
+
+ Throws
+
+
+
+ Gets the overlay manager.
+
+
+
+
+ Gets the current frame number.
+
+
+
+
+ Gets the number of frames per second.
+
+
+
+
+ Gets the screen grabber in use.
+
+ Thrown if the object has been disposed.
+
+
+
+ Gets the video being recorded.
+
+ Thrown if the object has been disposed.
+
+
+
+ Specifies the parameters for a video.
+
+
+
+
+ Creates a video parameters object.
+
+ Thrown if
+
+
+
+ Gets the width of the video.
+
+
+
+
+ Gets the height of the video.
+
+
+
+
+ Gets the number of frames per second of the video.
+
+
+
+
+ Specifies the parameters for a Flash screen video.
+
+
+
+
+ Creates a Flash video parameters object.
+
+ Thrown if
+
+
+
+ Gets or sets the width of each block to be compressed.
+
+
+
+ The block height must be a multiple of 16 between 16 and 256. The default is 64.
+
+
+ Thrown if
+
+
+
+ Gets or sets the height of each block to be compressed.
+
+
+
+ The block height must be a multiple of 16 between 16 and 256. The default is 64.
+
+
+ Thrown if
+
+
+
+ Gets or sets the ZLib compression level.
+
+
+
+ Range: 0 (fast / uncompressed), 1 (fast / worst compression), 6 (default), 9 (slow / best compression).
+
+
+ Thrown if
+
+
+
+ Gets the interval between successive key frames.
+
+
+
+ The default is 2 seconds. If you use a value of 0, then every frame will be a key frame.
+
+
+ Thrown if
+
+
+
+ Writes FLV streams.
+
+
+
+
+ Encodes video frames as FLV files using the Flash ScreenVideo lossless video codec.
+
+
+
+ This video format is useful for embedding video screen captures within web based test reports.
+ Frames are encoded as blocks of 16x16 pixel tiles compressed using ZLib. Unchanged tiles are retained
+ from the previous frame.
+
+
+ The maximum frame size for this video format is 4095x4095.
+
+
+
+
+
+ A video is an abstraction of an encoded video stream (possibly incorporating audio).
+
+
+
+ The primary use of this class is to author videos that can be embedded in test
+ reports. It is not intended to be used for playback.
+
+
+ Subclasses define specific encoding formats.
+
+
+ While a video is being created, its contents may be buffered in memory or on disk
+ in a temporary location.
+
+
+
+
+
+ Creates a new video.
+
+ Thrown if
+
+
+
+ Adds a frame to the video.
+
+
+
+ The implementation makes a copy of the frame or encodes it immediately so that
+ the caller can reuse the same frame buffers for subsequent frames.
+
+
+ Thrown if
+ Thrown if the
+
+
+
+ Saves the video to a stream.
+
+ Thrown if
+
+
+
+ Adds a frame to the video.
+
+
+
+ The implementation makes a copy of the frame or encodes it immediately so that
+ the caller can reuse the same frame buffers for subsequent frames.
+
+
+ The frame dimensions have already been checked by the caller.
+
+
+
+
+
+ Saves the video to a stream.
+
+
+
+
+ Gets the mime-type of the video format.
+
+
+
+
+ Gets the video parameters.
+
+
+
+
+ Gets the number of frames currently in the video.
+
+
+
+
+ Creates a new Flash screen video.
+
+ Thrown if
+
+
+
+
+
+
+
+
+
+ Gets the video parameters.
+
+
+
+
+
+
+ Grabs screenshots.
+
+
+
+
+ Creates a screen grabber.
+
+ Thrown if
+
+
+
+ Gets the size of the screen.
+
+ The screen size.
+
+
+
+ Returns true if screenshots can be captured.
+
+
+
+ This method may return false if the application is running as a service which has
+ not been granted the right to interact with the desktop.
+
+
+ True if the screen can be captured.
+
+
+
+ Throws an exception if a screenshot cannot be captured at this time.
+
+ Thrown if a screenshot cannot be captured at this time.
+
+
+
+ Disposes the screen grabber.
+
+
+
+
+ Captures a screenshot.
+
+
+
+ Captures a screenshot and returns the bitmap. The caller is responsible for disposing
+ the bitmap when no longer needed.
+
+
+ The screenshot.
+ Thrown if the provided
+ Thrown if the object has been disposed.
+ Thrown if a screenshot cannot be captured at this time.
+
+
+
+ Paints overlays onto a bitmap.
+
+
+
+
+ Disposes the screen grabber.
+
+
+
+
+ Throws
+
+
+
+ Gets the overlay manager.
+
+
+
+
+ Gets the capture parameters.
+
+ Thrown if the object has been disposed.
+
+
+
+ Gets the width of the screenshots that will be taken.
+
+ Thrown if the object has been disposed.
+
+
+
+ Gets the width of the screenshots that will be taken.
+
+ Thrown if the object has been disposed.
+
+
+
+ A message exchange mediates interactions between a server and a client.
+
+
+
+ This is interim API to be used until the new message broker is ready.
+
+
+
+
+
+ Base class for long-lived marshal by ref objects.
+
+
+
+ A
+
+ However, it is important to keep a reference to the marshalled object
+ to ensure it does not get garbage collected prematurely. A marshalled
+ object can also be explicitly disconnected via
+
+ This class overrides null which disables the automatic lease-management
+ performed by the default lifetime service.
+
+
+
+
+
+
+
+ Creates a message exchange.
+
+ Thrown if
+
+
+
+ Gets an interface that a client can use to asynchronously receive and
+ synchronously send messages.
+
+ The client link.
+
+
+
+ Sends a message to the client.
+
+ Thrown if
+ Thrown if
+
+
+
+ Waits for all published messages to be received by the client.
+
+ True if all messages were received, false if a timeout occurred.
+
+
+
+ Specifies a topic key routing published messages to their subscribers.
+
+
+
+ A topic consists of a sequence of dot ('.') delimited case-sensitive words. Each word
+ may contain the characters '0'-'9', 'a'-'z' and 'A'-'Z'. eg. "testrun.1234.progress".
+ Matching is performed using a
+
+
+
+
+ Creates a topic with a given key.
+
+ Thrown if
+ Thrown if
+
+
+
+ Returns the topic key.
+
+ The topic key.
+
+
+
+ Gets the complete topic key.
+
+
+
+
+ A topic pattern expresses a simple matching rule for topics.
+
+
+
+ Topic pattern matching proceeds word-wise where words within the topic are
+ separated by periods ('.'). There are two wildcards: '*' matches a single word and '#'
+ matches zero or more consecutive words. The topic must be matched in
+ full by the topic pattern; partial matches are of no significance.
+
+
+
+
+
+ Creates a topic pattern.
+
+ Thrown if
+
+
+
+ Returns true if this pattern matches the specified topic.
+
+ True if this pattern matches the specified topic.
+ Thrown if
+
+
+
+ Returns the topic pattern string.
+
+ The topic pattern string.
+
+
+
+ Gets the topic pattern string.
+
+
+
+
+ The Gallio.Common namespace contains common data types and utilities.
+
+
+
+
+ The Gallio.Common.Normalization namespace provides a simple abstraction
+ for normalizing objects.
+
+
+
+
+ The Gallio.Common.Platform namespace provides utilities for detecting
+ native platform parameters such as the .Net runtime and framework version
+ and the bitness of the currently executing process.
+
+
+
+
+ Specifies the integrity level of a Windows process.
+
+
+
+
+ Unknown integrity level.
+
+
+
+
+ Process is running with Untrusted integrity.
+
+
+
+
+ Process is running with Low integrity.
+
+
+
+
+ Process is running with Medium integrity.
+
+
+
+
+ Process is running with High integrity.
+
+
+
+
+ Process is running with System integrity.
+
+
+
+
+ Process is running with Protected Process integrity.
+
+
+
+
+ Provides additional utilities for manipulating the Windows registry, particularly
+ to take care of differences on 32bit and 64bit platforms.
+
+
+
+
+ Opens a registry subkey taking into account the bitness of the platform
+ and the requested processor architecture affinity.
+
+
+ If
+ True if the action succeeded.
+
+
+
+ Gets a registry value taking into account the bitness of the platform
+ and the requested processor architecture affinity.
+
+
+ If
+ The value, or null if the key does not exist.
+
+
+
+ The Gallio.Common.Policy namespace defines common procedures for reporting unhandled
+ exceptions, processing events safely, and accessing user and machine local application data.
+
+
+
+
+ Describes a policy for obtaining paths of special resources such as
+ temporary directories and user profile settings files.
+
+
+
+ The policy is broken down into partitions based on their common purpose. The idea
+ is that Gallio will try to keep related resources together within a directory
+ named after the partition. As an additional safeguard, all paths returned by this
+ policy will be grouped within a folder called "Gallio".
+
+
+
+
+
+ Gets the special path policy for a partition whose name is derived from the type's full name.
+
+ The type used to define the name of the partition.
+ The special path policy.
+
+
+
+ Gets the special path policy for a specified partition.
+
+ The special path policy.
+ Thrown if
+
+
+
+ Gets the temporary directory.
+
+ The temporary directory.
+
+
+
+ Creates a temporary directory with a unique name.
+
+ The temporary directory.
+
+
+
+ Creates a zero-byte temporary file with a unique name.
+
+ The temporary file.
+
+
+
+ Gets the application data directory for the roaming user.
+
+ The roaming user application data directory.
+
+
+
+ Gets the application data directory for the local non-roaming user.
+
+ The local non-roaming user application data directory.
+
+
+
+ Gets the application data directory shared by all users.
+
+ The common application data directory.
+
+
+
+ Gets the name of the partition this policy describes.
+
+
+
+
+ An attachment is an embedded object in a markup document. An attachment must specify a
+ content type (a MIME type), and some contents.
+
+
+
+
+ Creates an attachment.
+
+ Thrown if
+
+
+
+ Creates a plain text attachment.
+
+ The attachment.
+ Thrown if
+
+
+
+ Creates an HTML attachment.
+
+ The attachment.
+ Thrown if
+
+
+
+ Creates an XHTML attachment.
+
+ The attachment.
+ Thrown if
+
+
+
+ Creates an XML attachment.
+
+ The attachment.
+ Thrown if
+
+
+
+ Creates an image attachment with a mime-type compatible with its internal representation.
+
+ Thrown if
+
+
+
+ Creates an video attachment with a mime-type compatible with its internal representation.
+
+ Thrown if
+
+
+
+ Creates XML attachment with mime-type
+ Thrown if
+
+
+
+ Generates serializable attachment data from an attachment.
+
+ The attachment data.
+
+
+
+ Recovers the attachment information from serializable attachment data.
+
+ The attachment.
+ Thrown if
+
+
+
+
+
+ Gets the name of the attachment, not null.
+
+
+
+
+ Gets the content type of the attachment specified as a MIME type, not null.
+
+
+
+
+ Specifies how attachments are stored in Xml and as files.
+
+
+
+
+ The attachment content is not present.
+
+
+
+
+ The attachment content is saved to a linked file indicated by
+
+
+
+ The attachment content is included inline as
+
+
+
+
+ An Xml-serializable structure that describes the contents, encoding and disposition of an attachment.
+
+
+ The contents of the attachment are embedded in the execution log according to
+ their encoding. Text is directly embedded into the Xml whereas
+ binary attachments are base 64 encoded.
+
+
+
+
+
+ Creates an uninitialized instance for Xml deserialization.
+
+
+
+
+ Gets the text contents of a text attachment.
+
+ The text, or null if not available.
+ Thrown if the attachment is not textual.
+
+
+
+ Gets the binary contents of a binary attachment.
+
+ The bytes, or null if not available.
+ Thrown if the attachment is not binary.
+
+
+
+ Loads the attachment contents from a stream.
+
+ Thrown if
+ If the attachment could not be loaded.
+
+
+
+ Saves the attachment contents to a stream.
+
+ Thrown if
+ If the attachment could not be saved.
+ Thrown if the attachment contents are not available.
+
+
+
+ Gets or sets the name of the attachment, not null.
+
+ Thrown if
+
+
+
+ Gets or sets the content type of the attachment as a MIME type, not null.
+
+ Thrown if
+
+
+
+ Gets or sets the type of the attachment.
+ This value specifies how the attachment is represented in Xml.
+
+
+
+
+ Gets or sets the path of the attachment contents relative to
+ the directory that contains the Xml serialized report,
+ or null if the content is embedded.
+
+
+
+
+ Gets or sets the content disposition of the attachment which
+ indicates how the attachment has been stored.
+
+ The content disposition, initially
+
+
+
+ Gets or sets the attachment content serialized as text (including Base64 attachments), possibly null if none.
+
+
+
+
+ Returns true if the attachment is textual, false if it is binary.
+
+
+
+
+ Represents a binary-encoded attachment.
+
+
+
+
+ Creates an attachment.
+
+ Thrown if
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Gets the binary content of the attachment, not null.
+
+
+
+
+ A markup document writer that falls back to a different writer for certain
+ operations when its primary markup document writer is closed.
+
+
+
+ Not all operations are delegated to the fallback writer. Some, such as
+ embedding attachments and entering or exiting nested scopes, are excluded
+ due to potential errors that may occur because the fallback writer may not
+ have seen the previous operation to add the attachment or enter the scope.
+
+
+
+
+
+ A markup document writer records structured text as a hierarchically structured
+ document.
+
+
+
+ Markup documents are especially used to record the output of a test run including
+ text that was written to console output streams, exceptions that occurred, and
+ anything else the test writer might want to save.
+
+
+ A markup document consists of zero or more markup streams that are opened automatically
+ on demand to capture independent sequences of log output. Each stream can
+ further be broken down into possibly nested sections to classify output
+ during different phases of test execution (useful for drilling into complex tests).
+ In addition to text, a markup document can contain attachments that are either attached
+ at the top level of the markup document or embedded into markup streams. Attachments are
+ typed by mime-type and can contain Text, Xml, Images, Blobs, or any other content.
+ Certain test frameworks may automatically create attachments to gather all manner
+ of diagnostic information over the course of the test.
+
+
+ All operations on this interface are thread-safe.
+
+
+ Subclasses may assume that the following validation steps have been performed before
+ the implementation methods are called:
+
+ - Checking arguments for null and invalid values
+ - Ensuring that the writer has not been closed
+ - Ensuring that no attachment with the same name exists when adding an attachment
+ - Ensuring that there is an attachment with the specified name exists when embedding an attachment
+ - Ensuring that the nesting level of sections and markers is correct and balanced when End is called
+
+
+
+ The object extends
+
+
+
+
+ Closes the markup document writer.
+
+
+
+
+ Flushes the markup writer.
+
+
+
+
+ Attaches an attachment to the document.
+
+
+
+ An attachment instance can be embedded multiple times efficiently since each
+ embedded copy is typically represented as a link to the same common attachment instance.
+
+
+ The attachment.
+ Thrown if
+ Thrown if there is already an attachment
+ with the same name.
+
+
+
+ Attaches an HTML attachment with mime-type
+ The attachment.
+ Thrown if
+ Thrown if there is already an attachment
+ with the same name.
+
+
+
+ Attaches an image attachment with a mime-type compatible with its internal representation.
+
+ The attachment.
+ Thrown if
+ Thrown if there is already an attachment
+ with the same name.
+
+
+
+ Attaches a video attachment with a mime-type compatible with its internal representation.
+
+ The attachment.
+ Thrown if
+ Thrown if there is already an attachment
+ with the same name.
+
+
+
+ Attaches an XML-serialized object as an XML attachment with mime-type
+ The attachment.
+ Thrown if
+ Thrown if there is already an attachment
+ with the same name.
+
+
+
+ Attaches an XML-serialized object as an XML attachment with mime-type
+ The attachment.
+ Thrown if
+ Thrown if there is already an attachment
+ with the same name.
+
+
+
+ Attaches an plain text attachment with mime-type
+ The attachment.
+ Thrown if
+ Thrown if there is already an attachment
+ with the same name.
+
+
+
+ Attaches an XHTML attachment with mime-type
+ The attachment.
+ Thrown if
+ Thrown if there is already an attachment
+ with the same name.
+
+
+
+ Attaches an XML attachment with mime-type
+ The attachment.
+ Thrown if
+ Thrown if there is already an attachment
+ with the same name.
+
+
+
+ Gets a writer for the stream with the specified name.
+
+ The markup stream writer.
+
+
+
+ Closes the markup document writer.
+
+
+
+ The implementation may prevent the document writer from being closed by throwing an
+ exception. When this happens, the log's
+
+
+
+
+ Flushes the markup document writer.
+
+
+ The implementation should flush all of the individual document streams.
+
+
+
+
+ Adds an attachment to the markup document.
+
+
+
+ The implementation should allow the same attachment instance to be attached
+ multiple times and optimize this case by representing embedded attachments
+ as links.
+
+
+ Thrown if there is already an attachment
+ with the same name.
+
+
+
+ Writes a text string to a markup stream.
+
+
+
+ The implementation can assume that newlines are normalized to LFs ('\n') only
+ and that CRs ('\r') have been stripped.
+
+
+
+
+
+ Embeds an attachment into a markup stream.
+
+
+
+ The implementation should allow the same attachment instance to be attached
+ multiple times and optimize this case by representing embedded attachments
+ as links.
+
+
+ Thrown if no attachment with the specified
+ name has been previously attached.
+
+
+
+ Begins a section in a markup stream.
+
+
+
+
+ Begins a marked region in a markup stream.
+
+
+
+
+ Ends the current region started with one of the Begin* methods in a markup stream.
+
+ Thrown if there is no current nested region.
+
+
+
+ Flushes a markup stream.
+
+
+
+
+ Gets the stream writer for captured
+
+
+
+ Gets the stream writer for captured
+
+
+
+ Gets the stream writer for captured
+
+
+
+ Gets the stream writer for diagnostic
+
+
+
+ Gets the stream writer for generic log messages.
+
+
+
+
+ Gets the stream writer for reporting failure messages and exceptions.
+
+
+
+
+ Gets the stream writer for reporting warning messages.
+
+
+
+
+ Returns true if the markup document writer is closed.
+
+
+
+
+ Gets the markup stream with the specified name. If the stream
+ does not exist, it is created on demand.
+
+
+
+ This property may return different instances of
+
+ The log stream.
+ Thrown if
+
+
+
+ Creates a fallback markup document writer with the specified provider.
+
+ Thrown if
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ A marker is a hidden tag that labels markup contents with a semantic class.
+
+
+
+ A marker is roughly equivalent in operation to an HTML "div" tag whose "class"
+ attribute is used to annotate the contained block of tags and text. In HTML
+ CSS selectors are used to apply presentation artifacts to the block; likewise
+ tools may vary the presentation of markup based on associated marker classes.
+
+
+ This class provides several standard marker classes but you may also define your own
+ at will just by creating a marker instance with a custom class name.
+
+
+
+
+
+ Standard marker class for assertion failures.
+
+
+
+
+ Standard marker class for labels and headings.
+
+
+
+
+ Standard marker class for exceptions including their details.
+
+
+
+
+ Standard marker class for exception types reported as part of exception details.
+
+
+
+
+ Standard marker class for exception messages reported as part of exception details.
+
+
+
+
+ Standard marker class for exception property names reported as part of exception details.
+
+
+
+
+ Standard marker class for exception property values reported as part of exception details.
+
+
+
+
+ Standard marker class for stack traces.
+
+
+
+
+ Standard marker class for fixed width output such as that from a console or structured table.
+
+
+
+
+ Standard marker class for content that should be displayed with a highlight.
+
+
+
+
+ Standard marker class for content that represents added content in a diff.
+
+
+
+
+ Standard marker class for content that represents deleted content in a diff.
+
+
+
+
+ Standard marker class for content that represents changed content in a diff.
+
+
+
+
+ Standard marker class for content that has been elided and may be made available
+ instead as an attribute.
+
+
+
+
+ Standard marker class for code location references.
+
+
+
+
+ Path attribute for code location references.
+
+
+
+
+ Line attribute for code location references.
+
+
+
+
+ Column attribute for code location references.
+
+
+
+
+ Standard marker class for link to a url.
+
+
+
+
+ Url attribute for links.
+
+
+
+
+ Creates a standard marker for a code location.
+
+
+
+
+ Creates a standard marker for a link to a Url.
+
+
+
+
+ Creates a marker.
+
+ Thrown if
+ Thrown if the
+
+
+
+ Creates a marker with attributes.
+
+ Thrown if
+ Thrown if the
+
+
+
+ Creates a copy of the marker with the specified attribute added.
+
+ The marker copy with the attribute.
+ Thrown if
+ Thrown if the
+
+
+
+ Verifies that the parameter is a valid marker class or attribute identifier.
+
+ Thrown if
+ Thrown if
+
+
+
+
+
+
+
+
+
+
+
+ Returns true if two markers are equal.
+
+ True if the markers are equal.
+
+
+
+ Returns true if two markers are not equal.
+
+ True if the markers are not equal.
+
+
+
+ Standard marker for assertion failures.
+
+
+
+
+ Standard marker for labels and headings.
+
+
+
+
+ Standard marker for exceptions including their details.
+
+
+
+
+ Standard marker for exception types reported as part of exception details.
+
+
+
+
+ Standard marker for exception messages reported as part of exception details.
+
+
+
+
+ Standard marker for exception property names reported as part of exception details.
+
+
+
+
+ Standard marker for exception property values reported as part of exception details.
+
+
+
+
+ Standard marker for stack traces.
+
+
+
+
+ Standard marker for fixed width output such as that from a console or structured table.
+
+
+
+
+ Standard marker for content that should be displayed with a highlight.
+
+
+
+
+ Standard marker for content that represents added content in a diff.
+
+
+
+
+ Standard marker for content that represents deleted content in a diff.
+
+
+
+
+ Standard marker for content that represents changed content in a diff.
+
+
+
+
+ Standard marker for text that is elided and replaced by an ellipsis.
+
+
+
+
+ Gets the marker class.
+
+
+
+
+ Gets the marker's attributes which are optional name/value pairs associated
+ with a marker to carry additional semantic content.
+
+
+
+
+ Defines constants for commonly used mime types for attachment contents.
+
+
+
+
+ Binary data.
+
+
+
+
+ Plain text data.
+
+
+
+
+ Xml data.
+
+
+
+
+ HTML.
+
+
+
+
+ Well-formed XHTML.
+
+
+
+
+ Cascading Style Sheet.
+
+
+
+
+ JavaScript
+
+
+
+
+ PNG image.
+
+
+
+
+ JPEG image.
+
+
+
+
+ GIF image.
+
+
+
+
+ MHTML web archive.
+
+
+
+
+ Flash video.
+
+
+
+
+ Guesses the mime type given a well-known extension.
+
+ The mime type, or null if not known.
+ Thrown if
+
+
+
+ Guesses the extension given a well-known mime-type.
+
+ The extension, or null if not known.
+ Thrown if
+
+
+
+ Gets all the registered mime types.
+
+
+
+
+ A markup document writer that does nothing.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ An implementation of
+
+
+
+ An implementation of
+
+
+
+ Creates a textual markup document writer.
+
+ Thrown if
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Gets the underlying text writer.
+
+
+
+
+ Returns true if the verbose print mode is enabled.
+
+
+
+
+ Creates a log stream writer for the
+
+
+
+ Gets the formatted log contents as a string.
+
+ The contents as a string.
+
+
+
+ A structured document is an Xml-serializable in-memory representation of a markup
+ document written by a
+
+
+
+ Creates an empty document.
+
+
+
+
+ Gets an attachment by name.
+
+ The attachment or null if not found.
+ Thrown if
+
+
+
+ Gets a stream by name.
+
+ The stream or null if not found.
+ Thrown if
+
+
+
+ Writes the contents of the document to a markup document writer.
+
+ Thrown if
+
+
+
+ Formats the document to a string by concatenating all formatted streams and
+ displaying a "*** Stream Name ***" header for each stream name.
+
+ The formatted text.
+
+
+
+ Gets the list of streams, not null.
+ Used for Xml-serialization.
+
+
+
+
+ Gets the list of attachments, not null.
+
+
+
+
+ A structured stream object represents a recursively structured stream of rich text that
+ supports embedded attachments, nested sections and marked regions. Each part of the
+ text is captured by a tag, some of which are composable and may therefore contain other tags.
+
+
+
+ It is effectively an xml-serializable representation of a markup stream written by
+ a
+
+
+
+
+ Creates an uninitialized instance for Xml deserialization.
+
+
+
+
+ Creates an initialized stream.
+
+ Thrown if
+
+
+
+ Writes the contents of the stream to a markup stream writer.
+
+ Thrown if
+
+
+
+ Formats the stream using a
+ The formatted text.
+
+
+
+ Gets or sets the name of the stream, not null.
+
+ Thrown if
+
+
+
+ Gets or sets the body of the stream, not null.
+
+ Thrown if
+
+
+
+ Writes a
+
+
+
+ Creates a document writer that builds a new
+
+
+
+ Flushes the writer and formats it as a string.
+
+ The formatted document as a string.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Gets the document under construction.
+
+
+
+ The contents of the document will change as more text is written.
+ However, it may be necessary to
+
+
+
+
+ A structured text object contains attachments and formatted text with rich
+ presentation elements.
+
+
+
+ Structured text is emitted by a
+
+
+
+
+ Creates a simple structured text object over a plain text string.
+
+ Thrown if
+
+
+
+ Creates a structured text object that wraps the body tag of a structured markup document stream
+ and no attachments.
+
+ Thrown if
+
+
+
+ Creates a structured text object that wraps the body tag of a structured markup document stream
+ and a list of attachments.
+
+ Thrown if
+
+
+
+ Returns the total length of all
+ The total text length.
+
+
+
+ Writes the structured text to a markup stream writer.
+
+ Thrown if
+
+
+
+ Writes the structured text to a markup stream writer and truncates its text
+ to a particular maximum length, omitting all subsequent contents.
+
+ True if truncation occurred.
+ Thrown if
+ Thrown if
+
+
+
+ Formats the structured text to a string, discarding unrepresentable formatting details.
+
+ The structured text as a string.
+
+
+
+
+
+
+
+
+
+ Returns true if two structured text objects are equal.
+
+ True if the structured text objects are equal.
+
+
+
+ Returns true if two structured text objects are not equal.
+
+ True if the structured text objects are not equal.
+
+
+
+ Gets a copy of the body tag that describes the structured text.
+
+
+
+
+ Gets the immutable list of attachments belonging to the structured text.
+
+
+
+
+ An abstract base class for tag visitors that recursively traverses all tags
+ and does nothing else by default.
+
+
+
+
+ Visits a
+
+
+
+ Visits a body tag.
+
+
+
+
+ Visits a section tag.
+
+
+
+
+ Visits a marker tag.
+
+
+
+
+ Visits an embedded attachment tag.
+
+
+
+
+ Visits a text tag.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Writes information in a structured manner so as to produce a
+
+
+
+
+ A markup stream writer provides methods for writing rich structured text with embedded
+ attachments, nested sections and hidden semantic markers to a particular stream within
+ a markup document writer.
+
+
+
+ The operations on this interface are thread-safe.
+
+
+ The object extends
+
+ Newlines are always normalized to LFs ('\n') only. Any CRs ('\r') that are
+ written are automatically stripped.
+
+
+
+
+
+ Creates a markup stream writer.
+
+ Thrown if
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Writes a markup stream writable object to the stream.
+
+
+
+
+
+ Writes an exception.
+
+
+
+ The exception will not be terminated by a new line.
+
+
+ Thrown if
+
+
+
+ Writes an exception within its own section.
+
+
+
+ The exception will not be terminated by a new line.
+
+
+ Thrown if
+
+
+
+ Writes an exception.
+
+
+
+ The exception will not be terminated by a new line.
+
+
+ Thrown if
+
+
+
+ Writes an exception within its own section which provides additional cues for interpretation.
+
+
+
+ The exception will not be terminated by a new line.
+
+
+ Thrown if
+
+
+
+ Writes highlighted text. Highlights can be used to
+ emphasize important information such differences between similar expected
+ and actual values.
+
+
+
+ This is a convenience method that simply encapsulates the highlighted text within a
+ marked region of type
+
+
+
+
+ Writes an ellipsis to indicate where content has been elided for brevity.
+ An ellipsis may be used, for example, when printing assertion failures to clearly
+ identify sections where the user is not being presented all of the information
+ because it was too long and had to be truncated.
+
+
+
+ This is a convenience method that simply encapsulates "..." within a
+ marked region of type
+
+
+
+
+ Begins a section with the specified name. May be nested.
+
+
+
+ A section groups together related content in the markup stream to make it
+ easier to distinguish. The section name is used as a heading for presentation.
+
+
+
+
+ A Disposable object that calls
+ Thrown if
+
+
+
+ Begins a marked region. May be nested.
+
+
+
+ A marker is a hidden tag that labels its contents with a semantic class.
+ It is roughly equivalent in operation to an HTML "span" tag. Various tools
+ may inspect the markers and modify the presentation accordingly.
+
+
+
+
+ A Disposable object that calls
+
+
+
+ Ends the region most recently started with one of the Begin* methods.
+
+ Thrown if there is no current nested region.
+
+
+
+ Embeds an attachment.
+
+
+
+ An attachment instance can be embedded multiple times efficiently since each
+ embedded copy is typically represented as a link to the same common attachment instance.
+
+
+ The attachment.
+ Thrown if
+ Thrown if there is already an attachment
+ with the same name.
+
+
+
+ Embeds another copy of an existing attachment.
+
+
+
+ This method can be used to repeatedly embed an existing attachment at multiple
+ points in multiple streams without needing to keep the
+
+ An attachment instance can be embedded multiple times efficiently since each
+ embedded copy is typically represented as a link to the same common attachment instance.
+
+
+ Thrown if
+ Thrown if no attachment with the specified
+ name has been previously attached.
+
+
+
+ Embeds an plain text attachment with mime-type
+ The attachment.
+ Thrown if
+ Thrown if there is already an attachment
+ with the same name.
+
+
+
+ Embeds an HTML attachment with mime-type
+ The attachment.
+ Thrown if
+ Thrown if there is already an attachment
+ with the same name.
+
+
+
+ Embeds an XHTML attachment with mime-type
+ The attachment.
+ Thrown if
+ Thrown if there is already an attachment
+ with the same name.
+
+
+
+ Embeds an XML attachment with mime-type
+ The attachment.
+ Thrown if
+ Thrown if there is already an attachment
+ with the same name.
+
+
+
+ Embeds an image attachment with a mime-type compatible with its internal representation.
+
+ The attachment.
+ Thrown if
+ Thrown if there is already an attachment
+ with the same name.
+
+
+
+ Embeds a video attachment with a mime-type compatible with its internal representation.
+
+ The attachment.
+ Thrown if
+ Thrown if there is already an attachment
+ with the same name.
+
+
+
+ Embeds an XML-serialized object as an XML attachment with mime-type
+ The attachment.
+ Thrown if
+ Thrown if there is already an attachment
+ with the same name.
+
+
+
+ Embeds an XML-serialized object as an XML attachment with mime-type
+ The attachment.
+ Thrown if
+ Thrown if there is already an attachment
+ with the same name.
+
+
+
+ This method does not make sense for a markup stream writer because
+ a stream cannot be closed independently of its containing document.
+
+
+
+
+ This method does not make sense for a markup stream writer because
+ a stream cannot be closed independently of its containing document.
+
+
+
+
+ This method does not make sense for a markup stream writer because
+ a stream cannot be closed independently of its containing document.
+
+
+
+
+ Gets the containing markup document writer.
+
+
+
+
+ Gets the name of the markup stream being written.
+
+
+
+
+
+
+
+
+ Creates a structured text writer.
+
+
+
+
+ Gets the structured text produced so far.
+
+ The structured text.
+
+
+
+ Returns the structured text formatted as a string.
+
+ The structured text as a string.
+
+
+
+
+
+ The top-level container tag of markup.
+
+
+
+
+ An abstract container tag for representing tags that can contain other tags.
+
+
+
+
+ A tag is the fundamental unit of content within a markup stream.
+
+
+
+
+ Provides a typed clone operation.
+
+ The type produced when the object is cloned.
+
+
+
+ Clones the object.
+
+ The cloned object.
+
+
+
+ Invokes the appropriate visitor method for this tag type.
+
+ Thrown if
+
+
+
+
+
+ Formats the tag using a
+ The formatted text.
+
+
+
+ Writes the tag to a
+ Throw if
+
+
+
+
+
+ Creates an empty container tag.
+
+
+
+
+ Invokes the appropriate visitor method each element contained within this tag.
+
+ Thrown if
+
+
+
+
+
+
+
+ Gets the list of nested contents of this tag.
+
+
+
+
+
+
+
+
+
+
+
+
+ An embedded attachment tag.
+
+
+
+
+ Creates an uninitialized instance for Xml deserialization.
+
+
+
+
+ Creates an initialized tag.
+
+ Thrown if
+
+
+
+
+
+
+
+
+
+
+
+ Gets or sets the name of the referenced attachment to embed, not null.
+
+ Thrown if
+
+
+
+ A marker tag.
+
+
+
+
+ Creates an uninitialized instance for Xml deserialization.
+
+
+
+
+ Creates an initialized tag.
+
+
+
+
+
+
+
+
+
+
+
+
+ Gets or sets the marker class, not null.
+
+ Thrown if
+ Thrown if the
+
+
+
+ Gets the list of marker attributes.
+
+
+
+
+ Gets the marker.
+
+
+
+
+ Represents a marker attribute.
+
+
+
+
+ Creates an uninitialized instance for Xml deserialization.
+
+
+
+
+ Creates an initialized attribute.
+
+ Thrown if
+ Thrown if
+
+
+
+ Gets or sets the attribute name, not null.
+
+ Thrown if
+ Thrown if the
+
+
+
+ Gets or sets the attribute value, not null.
+
+ Thrown if
+
+
+
+ A section tag.
+
+
+
+
+ Creates an uninitialized instance for Xml deserialization.
+
+
+
+
+ Creates an initialized tag.
+
+ Thrown if
+
+
+
+
+
+
+
+
+
+
+
+ Gets or sets the section name, not null.
+
+ Thrown if
+
+
+
+
+ Formats
+
+ Text tags are written as-is. Sections introduce paragraph breaks with
+ the header written out as the first line. Embedded attachments are
+ described by name.
+
+
+
+
+
+ Gets the formatted text that has been built.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Ensures that the next chunk of text appended is separated by at least the specified
+ number of line breaks.
+
+
+
+
+ Appends text to the buffer including any requested spacing.
+
+
+
+
+ A text tag, containing text.
+
+
+
+
+ Creates an uninitialized instance for Xml deserialization.
+
+
+
+
+ Creates an initialized text tag.
+
+ Thrown if
+
+
+
+
+
+
+
+
+
+
+
+ Provides the Xml schema for this element.
+
+ The schema type of the element.
+
+
+
+ Gets or sets the text within the tag, not null.
+
+ Thrown if
+
+
+
+ Gets version information for Gallio components.
+
+
+
+
+ Generates a version label from a version number for display purposes.
+
+
+
+ A Gallio version label consists of a major version, minor version and build number and
+ is of the form "3.1 build 456". The revision number is not displayed.
+
+
+ Gallio component assemblies contain two different version numbers: an assembly version number
+ and a file version number. To preserve assembly compatibility across builds of the same version,
+ the assembly version number omits build number and revision information. Consequently
+
+
+ The version label.
+ Thrown if
+
+
+
+ Gets a version label of a Gallio component assembly for display purposes.
+
+
+
+ A Gallio version label consists of a major version, minor version and build number and
+ is of the form "3.1 build 456". The revision number is not displayed.
+
+
+ Gallio component assemblies contain two different version numbers: an assembly version number
+ and a file version number. To preserve assembly compatibility across builds of the same version,
+ the assembly version number omits build number and revision information. Consequently
+
+
+ The version label.
+ Thrown if
+
+
+
+ Gets the version number of an assembly for display purposes.
+
+
+
+ Returns the file version (
+
+ The version number.
+ Thrown if
+
+
+
+ Provides basic information about an Assembly derived from its metadata.
+
+
+
+
+ Gets the major version of the CLI runtime required for the assembly.
+
+
+
+ Typical runtime versions:
+
+ - 2.0: .Net 1.0 / .Net 1.1
+ - 2.5: .Net 2.0 / .Net 3.0 / .Net 3.5 / .Net 4.0
+
+
+
+
+
+
+ Gets the minor version of the CLI runtime required for the assembly.
+
+
+
+ Typical runtime versions:
+
+ - 2.0: .Net 1.0 / .Net 1.1
+ - 2.5: .Net 2.0 / .Net 3.0 / .Net 3.5 / .Net 4.0
+
+
+
+
+
+
+ Gets the processor architecture required for the assembly.
+
+
+
+
+ Gets the assembly references.
+
+
+
+ This field is only populated when the
+
+ Thrown if the assembly name was not populated.
+
+
+
+ Gets the assembly references.
+
+
+
+ This field is only populated when the
+
+ Thrown if the assembly references were not populated.
+
+
+
+ Gets the runtime version in the form "vX.Y.ZZZZ".
+
+
+
+ This field is only populated when the
+
+ Thrown if the runtime version were not populated.
+
+
+
+ Specifies the optional fields of the assembly metadata that are to be populated.
+
+
+
+
+ Populates the basic PE format information about the assembly.
+
+
+
+
+ Populates the assembly name.
+
+
+
+ Populating this field is expensive because it requires loading the entire assembly.
+
+
+
+
+
+ Populates the list of assembly references.
+
+
+
+ Populating this field is expensive because it requires loading the entire assembly.
+
+
+
+
+
+ Populates the runtime version.
+
+
+
+
+ Implementation of a debug symbol resolver based on the Microsoft Common Compiler Infrastructure Metadata Components (CCI Metadata Components)
+
+
+
+ see http://ccimetadata.codeplex.com/ for more information about the CCI Metadata Components.
+
+
+
+
+
+ Resolves debug symbols associated with members.
+
+
+
+
+ Gets the location of a source file that contains the declaration of a method, or
+ null if not available.
+
+ The source code location, or null if unknown.
+ Thrown if
+
+
+
+ Creates a Cci debug symbol resolver.
+
+
+
+
+
+
+
+
+ Data structure that maps every method in a CCI
+
+
+
+ Constructor.
+
+
+
+
+ Returns the code location of the method with the specified metadata token.
+
+ The resulting code location, or an unknown location if the method was not found.
+
+
+
+ Creates instances of unresolved reflection objects based on
+
+
+ All objects produced by this factory implement
+
+
+
+
+ Creates an instance of the factory.
+
+
+
+
+ Creates an
+ The unresolved assembly.
+ Thrown if
+
+
+
+ Creates a
+ The unresolved constructor.
+ Thrown if
+
+
+
+ Creates a
+ The unresolved event.
+ Thrown if
+
+
+
+ Creates a
+ The unresolved field.
+ Thrown if
+
+
+
+ Creates a
+ The unresolved method.
+ Thrown if
+
+
+
+ Creates a
+ The unresolved parameter.
+ Thrown if
+
+
+
+ Creates a
+ The unresolved property.
+ Thrown if
+
+
+
+ Creates a
+ The unresolved type.
+ Thrown if
+
+
+
+ Gets the singleton instance of the factory.
+
+
+
+
+ Represents a code element that could not be resolved to a native reflection type.
+
+
+
+ The
+
+
+
+
+ Gets the underlying reflection adapter.
+
+
+
+
+ Abstract base class for native wrappers.
+
+
+
+
+ A mirror describes a code element or attribute using a particular reflection policy.
+
+
+
+
+ Gets the reflection policy of the mirror.
+
+
+
+
+
+
+ The Gallio.Common.Reflection.Impl namespace provides internal reflection services
+ for reflection policy implementors and includes a framework for implementing
+ new reflection policies as subclasses of the
+
+
+
+ The Gallio.Common.Reflection namespace defines an abstract reflection Api
+ similar to System.Reflection but intended to enable reflection of .Net code
+ assets that are not loaded as executable assemblies. The reflection Api
+ provides several capabilities not present in System.Reflection including the
+ ability to obtain source file and line number information as well as Xml
+ documentation comments. This namespace includes a wrapper for standard .Net
+ reflection and for a file-based reflection policy based on Mono.Cecil.
+
+
+
+
+ Utilities for generating dynamic proxies and adapters using code generation techniques.
+
+
+
+
+ Coerces a source delegate to a target delegate type by casting the source delegate's
+ parameters individually to the target delegate type's parameter types.
+
+ The target delegate, or null if the source delegate was null.
+ Thrown if
+ Thrown if
+ Thrown if the source and target delegate types are
+ incompatible such as if they have different numbers of parameters or a different
+ composition of out/ref parameters.
+
+
+
+ Abstract base class for channels implemented using the .Net remoting infrastructure.
+
+
+
+
+ Creates a channel.
+
+ Thrown if
+
+
+
+
+
+ Disposes the channel.
+
+
+
+
+ Gets the Uri of a service with the given name that can be accessed using this channel.
+
+ The service uri.
+ Thrown if
+
+
+
+ Gets the associated .Net remoting channel.
+
+
+
+
+ Gets the root Uri associated with the channel.
+
+
+
+
+ Abstract base class for client channels implemented using the .Net
+ remoting infrastructure.
+
+
+
+
+ A client channel manages the client side of a remoting channel.
+
+
+
+
+ Gets a well-known remote service with the specified name.
+
+ The component or a proxy that provides the service.
+ Thrown if
+
+
+
+ Creates a channel.
+
+ Thrown if
+
+
+
+
+
+ Abstract base class for client channels implemented using the .Net
+ remoting infrastructure.
+
+
+
+
+ A server channel manages the server side of a remoting channel.
+
+
+
+
+ Registers a well-known service with the specified name.
+
+ Thrown if
+
+
+
+ Creates a channel.
+
+ Thrown if
+
+
+
+
+
+
+
+ A client channel based on an
+
+
+
+ Creates a channel.
+
+ Thrown if
+
+
+
+ A server channel based on an
+
+
+
+ Creates a channel.
+
+ Thrown if
+
+
+
+ A client channel based on an
+
+
+
+ Creates a channel.
+
+ Thrown if
+
+
+
+ A server channel based on an
+
+
+
+ Creates a channel.
+
+ Thrown if
+
+
+
+ The Gallio.Common.Remoting namespace contains types for managing .Net remoting channels.
+
+
+
+
+ Calculates a 32-bit hash code based on the FNV (Fowler-Noll-Vo) algorithm.
+ (http://en.wikipedia.org/wiki/Fowler_Noll_Vo_hash)
+
+
+
+
+ Returns the final hash code.
+
+ The resulting 32-bit hash code.
+
+
+
+ Default constructor.
+
+
+
+
+ Constructor.
+
+
+
+
+ Adds the hash code of the specified object and combines it with the previous values.
+
+ The builder itself for chaining syntax.
+
+
+
+ Adds the hash code of the specified objects and combines them with the previous values.
+
+ The builder itself for chaining syntax.
+
+
+
+ The Gallio.Common.Text namespace contains types for managing text ranges,
+ computing differences between strings, and regular expressions.
+
+
+
+
+ The Gallio.Common.Text.RegularExpression namespace contains a lightweight regular expression parser
+
+
+
+ Utility class for absolute and relative time management.
+
+
+
+
+ Utility class for absolute and relative time management.
+
+
+
+
+ Resets the time and starts the clock.
+
+
+
+
+ Stops the clock.
+
+
+
+
+ Blocks the current thread for a specified time.
+
+
+
+
+ Blocks the current thread for a specified time.
+
+
+
+
+ Gets the time elapsed.
+
+
+
+
+ Returns the local date and time.
+
+
+
+
+ Returns the current date and time, expressed as the Coordinated Universal Time (UTC).
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ The Gallio.Common.Time namespace contains various types to ease absolute and relative time management.
+
+
+
+
+ A value type that represents the result of evaluating an
+ expression of type
+
+
+
+ Gets the singular value of the
+
+
+
+
+
+ The Gallio.Common.Validation namespace provides a simple data validation framework
+ intended to be used to verify the integrity of data that has been deserialized
+ from Xml or other sources that lack strong built-in integrity constraints.
+
+
+
+
+ Normalization utilities.
+
+
+
+
+ Normalizes a collection of normalizable values.
+
+ The type of the collection.
+ The type of the values in the collection.
+ The normalized collection, or null if none. The result will
+ be the same instance as
+ Thrown if
+
+
+
+ Normalizes a string.
+
+
+
+ Preserves all valid characters in the string and replaces others as requested.
+
+
+ The normalized text, or null if
+ Thrown if
+
+
+
+ Normalizes a name by replacing characters that are not printable with a '?'.
+
+ The normalized name, or null if
+
+
+
+ Normalizes a name by replacing characters that are not printable ASCII with '?'.
+
+ The normalized string, or null if
+
+
+
+ Normalizes Xml text.
+
+
+
+ Preserves all characters in the following ranges: \t, \n, \r, \u0020 - \uD7FF,
+ \uE000 - \uFFFD, and \U00010000 - \U0010FFFF. All other characters are replaced
+ with '?' to indicate that they cannot be represented in Xml.
+
+
+ The normalized Xml text, or null if
+
+
+
+ Represents a type of XML diff.
+
+
+
+
+
+
+
+
+
+
+ Unexpected content.
+
+
+
+
+ Unexpected comment.
+
+
+
+
+ Unexpected element
+
+
+
+
+ Missing element
+
+
+
+
+ Mismatched content.
+
+
+
+
+ Mismatched comment.
+
+
+
+
+ Mismatched element.
+
+
+
+
+ Unexpected attribute.
+
+
+
+
+ Missing attribute.
+
+
+
+
+ Mismatched attribute.
+
+
+
+
+ Gets the description of the diff.
+
+
+
+
+ Represents a single attribute in an XML element.
+
+
+
+
+ Represents an XML node that can be compared to another
+ node of the same type, in order to get the differences.
+
+ The type of the diffable node.
+
+
+
+ Diffs the current node with an expected prototype, and returns
+ a set of differences found.
+
+ The resulting diff set describing the differences found.
+ Thrown if
+
+
+
+ The base node for the XML composite tree representing an XML fragment.
+
+
+
+
+ Represents an XML node with a name.
+
+
+
+
+ Determines whether the name of the current node is equal to the specified name,
+ by respecting the specified equality options.
+
+ True if the names are equal; false otherwise.
+
+
+
+ Gets the name of the node.
+
+
+
+
+ Returns the number of times the searched node was found at the specified path.
+
+ The number of matching items found; zero if not found.
+ Thrown if
+
+
+
+ Gets the type of the node.
+
+
+
+
+ Gets the index of the node.
+
+
+
+
+ Determines whether it is the first attribute in its parent.
+
+
+
+
+ Determines whether it is the last attribute in its parent.
+
+
+
+
+ Gets the children nodes.
+
+
+
+
+ Constructs an attribute.
+
+ Thrown if
+ Thrown if
+
+
+
+
+
+
+
+
+
+ Determines whether the value of the current attribute is equal to the specified value,
+ by respecting the specified equality options.
+
+ True if the values are equal; false otherwise.
+
+
+
+
+
+
+
+
+
+
+
+ Gets the value of the attribute.
+
+
+
+
+ Determines whether it is the first attribute in its parent.
+
+
+
+
+ Determines whether it is the last attribute in its parent.
+
+
+
+
+
+
+
+
+ An immutable collection of XML attributes.
+
+
+
+
+ Immutable collection of XML nodes.
+
+
+
+
+ Constructs a collection of XML nodes from the specified enumeration.
+
+
+
+
+
+
+
+
+ Determines whether the collection contains elements that match the conditions defined by the specified predicate.
+
+ True if the collection contains at least one element that match the conditions; otherwise, false.
+
+
+
+ Returns the number of times the searched node was found at the specified path.
+
+ The number of matching items found; zero if not found.
+ Thrown if
+
+
+
+
+
+
+
+ A collection of XML nodes that can be compared to another
+ collection of the same type, in order to get the differences.
+
+ The type of the collection.
+ The type of the items in the collection.
+
+
+
+ Returns the index of the first item which matches the specified predicates.
+
+ The index of the first item found; otherwise -1 if no item was found.
+
+
+
+ Gets the number of items in the collection.
+
+
+
+
+ Gets the item located at the specified index.
+
+ The item found at the searched index.
+
+
+
+ An empty collection singleton instance.
+
+
+
+
+ Constructs a collection of XML attributes from the specified enumeration.
+
+
+
+
+
+
+ Determines whether the collection contains an attribute with the specified name, and optionally the specified value.
+
+ True is such an attribute exists; otherwise false.
+ Thrown if
+
+
+
+ Represents the declaration element at the beginning of an XML document.
+
+
+
+
+ The abstract base node for the XML composite tree representing an XML fragment.
+
+
+
+
+ Constructs a node instance.
+
+ Thrown if
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Constructs the declaration element.
+
+
+
+
+
+
+
+
+ Gets the declaration attributes.
+
+
+
+
+ A diff item representing one single difference between two XML fragments.
+
+
+
+
+ Constructs a diff item.
+
+ Thrown if
+ Thrown if
+
+
+
+
+
+ Returns the diff as an assertion failure.
+
+ The resulting assertion failure.
+ Thrown if
+
+
+
+ Gets a type of the diff.
+
+
+
+
+ Gets the path of the difference.
+
+
+
+
+ Indicates which XML fragment is targeted by the diff.
+
+
+
+
+ Provides services for formatting objects for display.
+
+
+
+
+ Formats an object to a string for display.
+
+
+
+ The formatted string may incorporate a variety of presentation techniques
+ intended to clearly identify formatted values of different types.
+ For example, strings might appear quoted, objects might be described
+ using
+
+ The resulting string should not be expected to be machine-readable.
+
+
+ This method should never return an empty string or throw an exception.
+ If the value cannot be formatted property then a placeholder should
+ be used instead, such as the value's type.
+
+
+ Likewise this method should never throw an exception. If the object cannot be formatted
+ cleanly, then an error message should be produced instead.
+
+
+ These constraints are intended to ensure that the formatter provides
+ a robust service to all clients.
+
+
+ The formatted string, never null and never an empty string.
+
+
+
+ Diffing engine abstract factory.
+
+
+
+
+ Makes a diffing engine for collections of attributes.
+
+ The resulting diffing engine.
+
+
+
+ Makes a diffing engine for collections of elements.
+
+ The resulting diffing engine.
+
+
+
+ An immutable set of diff items representing the differences between two XML fragments.
+
+
+
+
+ A empty diff set singleton instance.
+
+
+
+
+ Constructs a sets from the specified enumeration of diff items.
+
+
+
+
+
+
+ Returns the diff items as an enumeration of assertion failures.
+
+ The resulting enumeration of assertion failures.
+ Thrown if
+
+
+
+ Gets a value indicating if the set is empty (i.e. no differences found)
+
+
+
+
+ Gets the number of diffs in the collection.
+
+
+
+
+ A simple builder for the
+
+
+
+ Adds the specified diff item to the set.
+
+ A reference to the builder itself.
+ Thrown if
+
+
+
+ Adds the diff items contained into the specified set to the current set.
+
+ A reference to the builder itself.
+ Thrown if
+
+
+
+ Returns a new
+ The resulting diff set object.
+
+
+
+ The target of a diff result.
+
+
+
+
+ The actual XML fragment.
+
+
+
+
+ The expected XML fragment.
+
+
+
+
+ The actual and the expected XML fragments.
+
+
+
+
+ Represents a diffable XML fragment.
+
+
+
+ fragments are the root objects for constructing, searching, diffing XML documents.
+
+
+
+
+
+ Constructs an XML document.
+
+ Thrown if
+
+
+
+
+
+ Diffs the current fragment with an expected prototype, and returns a set of differences found.
+
+ The resulting diff set describing the differences found.
+ Thrown if
+
+
+
+
+
+ Finds the node located at the specified path.
+
+ The node found.
+ Thrown if
+
+
+
+
+
+ Gets the declaration element of the document.
+
+
+
+
+ Diffing engine.
+
+ The type of the objects to diff.
+
+
+
+ Computes the differences between the expected and the actual object.
+
+ The resulting diff set.
+
+
+
+ Type of XML Node.
+
+
+
+
+ A valid XML fragment.
+
+
+
+
+ An XML element.
+
+
+
+
+ A comment element.
+
+
+
+
+ A textual content inside an element.
+
+
+
+
+ A declaration element at the beginning of an XML document.
+
+
+
+
+ An attribute.
+
+
+
+
+ Represents an immutable and loose path to a node in an XML fragment.
+
+
+
+ A loose path is built based on the name of the elements that lead to it.
+ Thus several nodes might be represented by the same loose path.
+
+
+
+
+
+ Represents an immutable path to a node in an XML fragment.
+
+
+
+
+ Formats the current path.
+
+ The resulting formatted path.
+
+
+
+ Determines whether the current node represents the empty root path.
+
+
+
+
+ Returns the entire path excluding the head node.
+
+ The output path
+
+
+
+ Returns the path nodes as an array.
+
+ The output array.
+
+
+
+
+
+
+
+
+ Represents a closed immutable and loose path to a node in an XML fragment.
+
+
+
+ A closed path points to a type of node that has no child, like an attribute.
+
+
+
+
+ A loose path is built based on the name of the elements that lead to it.
+ Thus several nodes might be represented by the same loose path.
+
+
+
+
+
+ Represents an immutable and loose path to a node in an XML fragment.
+
+
+
+ A loose path is built based on the name of the elements that lead to it.
+ Thus several nodes might be represented by the same loose path.
+
+
+
+
+
+ Extends the path to a child element.
+
+ A new immutable open path that encapsulates the current path.
+
+
+
+ Extends the path to a child attribute.
+
+ A new immutable closed path that encapsulates the current path.
+
+
+
+ Parses the textual representation of an XML path.
+
+
+
+
+ Parses the specified textual representation of a loose path.
+
+ The resulting path object.
+
+
+
+ Parses the specified textual representation of a strict path.
+
+ The resulting path object.
+
+
+
+ Formats a strict path into a human readable form, based on the contents of an existing XML fragment.
+
+
+
+
+ Formats a strict path into a human readable form, based on the contents of an existing XML fragment.
+
+ Thrown if
+
+
+
+ Rendering options for the XML path renderer.
+
+
+
+
+ No options.
+
+
+
+
+ Prints each element in its own indented line.
+
+
+
+
+ Concrete node representing an XML declaration node in a strict path, and which is closed to further extensions.
+
+
+
+
+ Abstract node that extends a strict XML path, and let it opened for further extensions.
+
+
+
+
+ Represents an open, immutable and strict path to a node in an XML fragment.
+
+
+
+ A strict path is built based on the index of the elements that lead to it.
+ Thus a strict path unambiguously designates one and only one node in an XML fragment.
+
+
+
+
+
+ Extends the path to a child element.
+
+ A new immutable strict path that encapsulates the current path.
+
+
+
+ Extends the path to a child attribute.
+
+ A new immutable strict path that encapsulates the current path.
+
+
+
+ Extends the path to the declaration node.
+
+ A new immutable strict path that encapsulates the current path.
+
+
+
+ Splits the current path into an array containing all the inner child nodes.
+
+ An array of path nodes.
+
+
+
+ Returns the node with the current index from the child collection of the specified parent node.
+
+ The node in the collection of the child node with the current index.
+
+
+
+ Gets the index of the node.
+
+
+
+
+ Gets the parent path node.
+
+
+
+
+ Constructs an empty node that represents the root path.
+
+
+
+
+ Constructs a node that extends the specified parent node with an additional level of depth.
+
+ Thrown if
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Gets the index of the attribute.
+
+
+
+
+ Constructs a node that extends the specified root node by targetting the declaration node.
+
+ Thrown if
+ Thrown if
+
+
+
+ Formats the current path.
+
+ The resulting formatted path.
+
+
+
+
+
+ Diffing engine for collections of ordered XML items.
+
+ The type of the collection.
+ The type of the items in the collection.
+
+
+
+ Constructs the diffing engine.
+
+
+
+
+
+
+ The target diffed items.
+
+
+
+
+ Diffing engine for collections of unordered attributes.
+
+
+
+
+ Constructs the diffing engine.
+
+
+
+
+
+
+ Diffing engine for collections of unordered elements.
+
+
+
+
+ Constructs the diffing engine.
+
+
+
+
+
+
+ Abstract node that extends and closes a loose XML path.
+
+
+
+
+ Constructs an empty node that represents the root path.
+
+
+
+
+ Constructs a node that extends the specified parent node with an additional level of depth.
+
+ Thrown if
+
+
+
+
+
+
+
+
+
+
+
+ Gets the parent node of the path.
+
+
+
+
+ Determines whether the current node represents the root path.
+
+
+
+
+ Concrete node representing an XML attribute node, and that closes a loose XML path.
+
+
+
+
+ Constructs a node that extends the specified parent node by targetting an inner attribute by its name.
+
+ Thrown if
+ Thrown if
+
+
+
+ Formats the current path.
+
+ The resulting formatted path.
+
+
+
+
+
+
+
+ Gets the name of the attribute.
+
+
+
+
+ Abstract node that extends a loose XML path, and let it opened for further extensions.
+
+
+
+
+
+
+
+
+
+
+
+
+ Concrete node representing an XML element markup in a loose path, and which is opened for further extensions.
+
+
+
+
+ Gets the instance representing an empty root path.
+
+
+
+
+ Constructs a node that extends the specified parent node by targetting an child element by its name.
+
+ Thrown if
+ Thrown if
+
+
+
+
+
+
+
+ Formats the current path.
+
+ The resulting formatted path.
+
+
+
+
+
+
+
+ Gets the name of the element.
+
+
+
+
+ Concrete node representing an XML attribute node, and that closes a strict XML path.
+
+
+
+
+ Constructs a node that extends the specified parent node by targetting an inner attribute by its index.
+
+ Thrown if
+ Thrown if
+
+
+
+ Formats the current path.
+
+ The resulting formatted path.
+
+
+
+
+
+ Concrete node representing an XML element node in a strict path, and which is opened for further extensions.
+
+
+
+
+ Gets the instance representing an empty root path.
+
+
+
+
+ Constructs a node that extends the specified parent node by targetting an child element by its index.
+
+ Thrown if
+ Thrown if
+
+
+
+
+
+
+
+
+
+ Formats the current path.
+
+ The resulting formatted path.
+
+
+
+ Immutable collection of XML nodes.
+
+
+
+
+ An empty collection singleton instance.
+
+
+
+
+ Constructs a collection of XML nodes from the specified enumeration.
+
+
+
+
+
+
+ Represents a comment tag in an XML fragment.
+
+
+
+
+ Constructs an XML comment tag.
+
+ Thrown if
+
+
+
+
+
+
+
+ Gets the textual content of the comment tag.
+
+
+
+
+ Represents a textual content inside an element
+
+
+
+
+ Constructs textual content inside an element.
+
+ Thrown if
+
+
+
+
+
+
+
+ Determines whether the text value is equal to the specified text value,
+ by respecting the specified equality options.
+
+ True if the values are equal; false otherwise.
+
+
+
+ Gets the textual content of the comment tag.
+
+
+
+
+ Represents an element in an XML fragment.
+
+
+
+
+ Constructs an XML element.
+
+ Thrown if
+ Thrown if
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Gets the attributes of the element.
+
+
+
+
+ The Gallio.Common.Xml2 namespace contains types for manipulating Xml.
+
+
+
+
+ Options for the XML-related equality assertions.
+
+
+
+
+ No equality options (the strictest).
+
+
+
+
+ Ignores the case of the name of the XML elements.
+
+ " is equal to "
+
+
+
+ Ignores the case of the value of the XML elements.
+
+ VALUE" is equal to "value ".
+ ]]>
+
+
+
+ Ignores the order of XML elements with the same parent.
+
+
+
+
+ Ignores the case of the name of the XML attributes.
+
+ " is equal to "
+
+
+
+ Ignores the case of the value of the XML attributes.
+
+ " is equal to "
+
+
+
+ Ignores the order of the attributes defined in the same element.
+
+ " is equal to "
+
+
+
+ Ignores the comment tags.
+
+ ".
+ ]]>
+
+
+
+ A parsing service that extracts a composite tree from an XML fragment.
+
+
+
+
+ Parses the specified XML fragment.
+
+ The resulting document representing the parsed XML fragment.
+ Thrown if
+
+
+
+ Entry-point class that serves as builder for an XML path.
+
+
+
+
+ Empty path instance.
+
+
+
+
+ Starts a new loose XML path by specifying the name of its root element.
+
+ A new open loose XML path.
+ Thrown if
+ Thrown if
+
+
+
+ Parses the specified textual representation of a path.
+
+
+
+ The specified path should start with a slash character ('/').
+ Elements are separated by a slash, and attributes denoted by a colon (':').
+
+
+ The resulting path object.
+
+
+
+ Separator for elements.
+
+
+
+
+ Separator for elements.
+
+
+
+
+ Entry-point for strict XML paths.
+
+
+
+
+ Empty path instance.
+
+
+
+
+ Starts a new strict XML path by specifying the index of its root element.
+
+ A new open loose XML path.
+ Thrown if
+
+
+
+ Parses the specified textual representation of a path.
+
+
+
+ The specified path should start with a slash character ('/').
+ Elements are separated by a slash, and attributes denoted by a colon (':').
+
+
+ The resulting path object.
+
+
+
+ A delegate for the
+ The composite assertion failure.
+
+
+
+ The Gallio.Framework.Assertions namespace provides a framework for reporting assertion failures.
+
+
+
+
+ Captures screenshot images and videos.
+
+
+
+ These functions are intended to provide a simple interface for capturing,
+ captioning, and embedding images and video. If you desire more control over the manner
+ in which the capture occurs, you may prefer to use the
+
+
+
+
+ Gets the size of the screen.
+
+ The screen size.
+
+
+
+ Returns true if screenshots can be captured.
+
+
+
+ This method may return false if the application is running as a service which has
+ not been granted the right to interact with the desktop.
+
+
+ True if the screen can be captured.
+
+
+
+ Captures an image of the entire desktop.
+
+ The screenshot.
+ Thrown if a screenshot cannot be captured at this time.
+
+
+
+ Captures an image of the entire desktop.
+
+ The screenshot.
+ Thrown if
+ Thrown if a screenshot cannot be captured at this time.
+
+
+
+ Starts recording a screen capture video of the entire desktop.
+
+
+
+ Recording a screen capture video can be very CPU and space intensive particularly
+ when running tests on a single-core CPU. We recommend calling
+
+
+ The recorder.
+ Thrown if a screenshot cannot be captured at this time.
+
+
+
+ Starts recording a screen capture video of the entire desktop.
+
+
+
+ Recording a screen capture video can be very CPU and space intensive particularly
+ when running tests on a single-core CPU. We recommend calling
+
+
+ The recorder.
+ Thrown if
+ Thrown if a screenshot cannot be captured at this time.
+
+
+
+ Automatically embeds a screenshot when a trigger event occurs.
+
+
+
+ If screenshots cannot be captured, the method will embed a warning message to that effect.
+
+
+
+
+
+ Automatically embeds a screenshot when a trigger event occurs.
+
+
+
+ If screenshots cannot be captured, the method will embed a warning message to that effect.
+
+
+ Thrown if
+
+
+
+ Automatically embeds a video of the test run from this point forward when a trigger event occurs.
+
+
+
+ Recording a screen capture video can be very CPU and space intensive particularly
+ when running tests on a single-core CPU. We recommend calling
+
+
+ If screenshots cannot be captured, the method will embed a warning message to that effect.
+
+
+
+
+
+ Automatically embeds a video of the test run from this point forward when a trigger event occurs.
+
+
+
+ Recording a screen capture video can be very CPU and space intensive particularly
+ when running tests on a single-core CPU. We recommend calling
+
+
+ If screenshots cannot be captured, the method will embed a warning message to that effect.
+
+
+ Thrown if
+
+
+
+ Gets the overlay manager for the current test context.
+
+ The overlay manager.
+
+
+
+ Gets the overlay manager for the specified test context.
+
+ The overlay manager.
+ Thrown if
+
+
+
+ Adds an overlay to display over screenshot images and videos.
+
+ Thrown if
+
+
+
+ Sets a caption to display over screenshots images and videos.
+
+ Thrown if
+
+
+
+ Sets the font size of the caption to display over screenshots images and videos.
+
+ Thrown if
+
+
+
+ Sets the alignment of the caption to display over screenshots images and videos.
+
+
+
+
+ Gets the caption overlay to display over of screenshots images and videos.
+
+ The caption overlay.
+
+
+
+ Describes the semantics of how objects should be compared.
+
+
+
+ This class encapsulates a default set of rules for comparing objects. These rules may be
+ used as the foundation of a suite of standard assertion functions for comparing identity,
+ equality and relations.
+
+
+ The comparison engine has extension points available:
+ Extend the object comparison by registring custom comparers through
+ Extend the object eqaulity by registring custom equality comparers through
+
+
+ Custom comparers defined through
+
+
+
+
+ Gets the default instance.
+
+
+
+
+ Generator of sequential
+
+
+
+ Generic abstract generator of sequential numeric values.
+
+ The type of the value to generate.
+
+
+
+ Generic abstract generator of values.
+
+ The type of the values returned by the generator.
+
+
+
+ Generator of values.
+
+
+
+
+ Generates the sequence of values.
+
+ An enumeration of generated values.
+
+
+
+ Filters the specified value.
+
+ True if the value is accepted; false otherwise.
+
+
+
+ Default constructor.
+
+
+
+
+
+
+ Checks for the specified value to be not one of the following:
+
+
+
+ The specified property value is invalid.
+
+
+
+ Checks for the specified value to be not one of the following:
+
+
+
+ The specified property value is invalid.
+
+
+
+ Checks for the specified value to be not one of the following:
+
+
+
+ The specified property value is invalid.
+
+
+
+ Gets or sets the filter function that can be used
+ to reject or accept generated values.
+
+
+
+
+ Default constructor.
+
+
+
+
+
+
+ Returns the linear sequence constructed by using the
+ The sequence of values.
+
+
+
+ Returns the linear sequence constructed by using the
+ The sequence of values.
+
+
+
+ Returns the linear sequence constructed by using the
+ The sequence of values.
+
+
+
+ Gets or sets the starting point of the sequence.
+
+
+
+
+ Gets or sets the ending point of the sequence.
+
+
+
+
+ Gets or sets the increment between each value of the sequence.
+
+
+
+
+ Gets or sets the length of the sequence of values
+ created by the generator.
+
+
+
+
+ Gets the default step.
+
+
+
+
+ Default constructor.
+
+
+
+
+
+
+
+
+
+
+ Gets the default step.
+
+
+
+
+ Generator of sequential
+
+
+
+ Default constructor.
+
+
+
+
+
+
+
+
+
+
+ Gets the default step.
+
+
+
+
+ Generator of random
+
+
+
+ Generic abstract generator of random values within a given range.
+
+ The type of the value to generate.
+
+
+
+ A general purpose pseudo-random number generator.
+
+
+
+
+ Default constructor.
+
+
+
+
+
+
+ Returns the sequence of random values.
+
+ The sequence of values.
+
+
+
+ Gets the lower bound of the range.
+
+
+
+
+ Gets the upper bound of the range.
+
+
+
+
+ Gets the length of the sequence of values
+ created by the generator.
+
+
+
+
+ Constructs a generator of random
+
+
+
+
+
+ Generator of random
+
+
+
+ Constructs a generator of random
+
+
+
+
+
+ Describes the semantics of how objects should be compared.
+
+
+
+ This class encapsulates a default set of rules for comparing objects. These rules may be
+ used as the foundation of a suite of standard assertion functions for comparing identity,
+ equality and relations.
+
+
+ The comparison engine has extension points available:
+ Extend the object comparison by registring custom comparers through
+ Extend the object eqaulity by registring custom equality comparers through
+
+
+ Custom comparers defined through
+
+
+
+
+ Returns true if two objects are the same.
+
+
+
+ Rules applied:
+
+ - Objects are the same if they are referentially
+ equal according to
+
+
+
+ True if both objects are the same.
+ The object type, which must be a reference type (class) since a value type
+ (struct) has no concept of referential identity.
+
+
+
+ Returns true if two objects are equal.
+
+ True if the objects are equal.
+
+
+
+ Returns true if two objects are equal.
+
+
+
+ Rules applied:
+
+ - If both objects are null, returns true.
+ - If one object is null but not the other, returns false.
+ - If both objects are referentially equal, returns true.
+ - If both objects are of a special type, applies special type equality semantics (see below)
+ - If the objects are both instances of the same simple enumerable type (
+ - Otherwise uses
+
+
+
+ Special type semantics:
+
+
+
+
+ True if the objects are equal.
+ The object type.
+
+
+
+ Compares two objects.
+
+
+
+ Rules applied:
+
+ - If both objects are null, returns 0.
+ - If both objects are referentially equal, returns true.
+ - If the objects are both instances of the same simple enumerable type (
+ - If the objects implement
+ - If the objects implement
+ - Otherwise no deterministic comparison is possible so throws an exception.
+
+
+
+ The ordering of nulls is determined by
+
+ A value less than zero if the left object if less than
+ the right object, zero if the left and right objects are equal, or greater than zero if
+ the left object is greater than the right object.
+ Thrown if the values cannot be ordered.
+ The object type.
+
+
+
+ Returns true if the specified type is a simple enumerable type.
+
+
+
+ A simple enumerable type is one that that does not override
+
+ The set of simple enumerable types includes arrays, lists, dictionaries and other
+ standard collection types in the .Net framework.
+
+
+ Thrown if
+
+
+
+ Returns true if two values are equal to within a specified delta.
+
+
+
+ The values are considered approximately equal if the absolute value of their difference
+ is less than or equal to the delta.
+
+
+ This method works with any comparable type that also supports a subtraction operator
+ including
+
+ The type of values to be compared.
+ The type of the difference produced when the values are
+ subtracted, for numeric types this is the same as
+ True if the values are approximately equal.
+
+
+
+ Extensibility point for object equality managed by
+
+
+ Use the methods
+
+ The Gallio inner comparison engine handles with the case of null objects comparison prior to
+ the custom comparers. Therefore, while defining a custom comparer, you can safely assume that the
+ objects to compare are never null.
+
+
+
+ ((x, y) => x.Value == y.Value);
+ ]]>
+
+
+
+
+ Registers a custom equality comparer for the specified type.
+
+
+
+ The Gallio inner comparison engine handles with the case of null objects comparison prior to
+ the custom comparers. Therefore, while defining a custom comparer, you can safely assume that the
+ objects to compare are never null.
+
+
+ Thrown if
+ Thrown if a custom comparer for the specified type was already registered.
+
+
+
+ Registers a strongly-typed custom equality comparer for the specified type.
+
+
+
+ The Gallio inner comparison engine handles with the case of null objects comparison prior to
+ the custom comparers. Therefore, while defining a custom comparer, you can safely assume that the
+ objects to compare are never null.
+
+
+ The type for which the custom comparer operates.
+ Thrown if
+ Thrown if a custom comparer for the specified type was already registered.
+
+
+
+ Unregisters the custom equality comparer for the specified type.
+
+
+
+ If no custom comparer exists for the specified type,
+ the method has no effect and no exception is thrown.
+
+
+ Thrown if
+
+
+
+ Unregisters the custom equality comparer for the specified type.
+
+
+
+ If no custom comparer exists for the specified type,
+ the method has no effect and no exception is thrown.
+
+
+ The searched type.
+
+
+
+ Extensibility point for object comparison managed by
+
+
+ Use the methods
+
+ The Gallio inner comparison engine handles with the case of null objects comparison prior to
+ the custom comparers. Therefore, while defining a custom comparer, you can safely assume that the
+ objects to compare are never null.
+
+
+
+ ((x, y) => x.Value.CompareTo(y.Value));
+ ]]>
+
+
+
+
+ Registers a custom comparer for the specified type.
+
+
+
+ The Gallio inner comparison engine handles with the case of null objects comparison prior to
+ the custom comparers. Therefore, while defining a custom comparer, you can safely assume that the
+ objects to compare are never null.
+
+
+ Thrown if
+ Thrown if a custom comparer for the specified type was already registered.
+
+
+
+ Registers a strongly-tped custom comparer for the specified type.
+
+
+
+ The Gallio inner comparison engine handles with the case of null objects comparison prior to
+ the custom comparers. Therefore, while defining a custom comparer, you can safely assume that the
+ objects to compare are never null.
+
+
+ The type for which the custom comparer operates.
+ Thrown if
+ Thrown if a custom comparer for the specified type was already registered.
+
+
+
+ Unregisters the custom comparer for the specified type.
+
+
+
+ If no custom comparer exists for the specified type,
+ the method has no effect and no exception is thrown.
+
+
+ Thrown if
+
+
+
+ Unregisters the custom comparer for the specified type.
+
+
+
+ If no custom comparer exists for the specified type,
+ the method has no effect and no exception is thrown.
+
+
+ The searched type.
+
+
+
+ Base class for all the patterns defining an extension point of the framework.
+
+
+
+ Extension point attributes act through a static method.
+
+
+
+
+
+ A decorator attribute applies contributions to a test component in scope
+ such as a test or test parameter generated by some other pattern attribute.
+
+
+
+ Occasionally the order in which decorators are applied is significant so this type provides a
+
+
+
+
+ The
+
+
+ Subclasses of
+
+
+
+
+ A
+
+
+ The general idea is that a pattern applies contributions to a
+
+ A pattern can also defer some of its processing by registering a decorator on the scope.
+ Once all of the decorators have been gathered, they can be applied in sorted order
+ as required.
+
+
+ Pattern processing is performed recursively. First the primary pattern for the assembly
+ is found. If none is registered then the default assembly pattern is used instead.
+ The assembly pattern then performs reflection over the types within the assembly and hands
+ off control (via
+
+ Typically a pattern is associated with a code element by means of a
+
+
+
+
+ Gets the test parts represented by a code element.
+
+
+
+ This method is only called for primary patterns.
+
+
+ The test parts, or an empty array if none.
+ May be thrown to halt processing of the pattern
+ and report an error message to the user as an annotation that describes how the
+ pattern was misapplied.
+
+
+
+ Consumes a code element and applies its contributions to the scope
+ provided by a containing pattern.
+
+
+
+ This method is used to declare new tests, test parameters and other components
+ and add them to a containing test that was defined in some other scope.
+
+
+ For example, when enumerating test fixtures, the assembly-level pattern will
+ call the
+
+ This method is only called for primary patterns.
+
+
+ May be thrown to halt processing of the pattern
+ and report an error message to the user as an annotation that describes how the
+ pattern was misapplied.
+
+
+
+ Processes a code element and applies its contributions to the scope of this pattern.
+ The scope will typically have been introduced by the
+
+
+ This method is used by patterns to decorate tests and test parameters that
+ have been declared by primary patterns.
+
+
+ For example, the
+
+ May be thrown to halt processing of the pattern
+ and report an error message to the user as an annotation that describes how the
+ pattern was misapplied.
+
+
+
+ Returns true if this is a primary pattern.
+
+
+
+ A primary pattern is a pattern that defines the ultimate purpose of a code
+ element and the nature of the tests or test parameters that are produced from it.
+ Consequently the primary pattern is the only one on which the
+
+ Each code element may have at most one primary pattern. It is an error
+ for a code element to have more than one associated primary pattern.
+
+
+ If a code element does not have an associated primary pattern, its containing
+ test may choose to apply default processing to it instead. For example, the
+ containing test may give an opportunity to patterns associated with the code element
+ to consume a test method parameter but will revert to default behavior if no
+ primary patterns explicitly claim it.
+
+
+ Non-primary patterns still play a very important part in the construction
+ of the test model. Non-primary patterns may implement the
+
+
+
+
+
+
+
+
+
+
+ Throws a
+ Always thrown.
+
+
+
+ Throws a
+ Always thrown.
+
+
+
+
+
+ Gets or sets the order in which the decorator should be applied.
+
+
+
+ Decorators with lower order indices values are applied before decorators with
+ higher ones. In the case of a tie, an arbitrary choice is
+ made among decorators with the same order index to determine the order in
+ which they will be processed.
+
+
+
+ The default order index is 0.
+
+
+
+
+
+
+
+
+ Verifies that the attribute is being used correctly.
+
+ Thrown if the attribute is being used incorrectly.
+
+
+
+ Applies decorations to the containing test.
+
+
+
+
+
+
+ Gets the current test environment instance which can be used to register custom actions.
+
+
+
+
+ Targeted member types for the fixture invoker.
+
+
+
+
+ Default value combining
+
+
+
+ Indicates to find the searched member among the fields.
+
+
+
+
+ Indicates to find the searched member among the properties.
+
+
+
+
+ Indicates to find the searched member among the methods.
+
+
+
+
+ Gets the list of test framework extensions associated with a given assembly.
+
+ The associated extensions.
+
+
+
+ Explores tests implemented using the pattern test framework.
+
+
+
+
+ A test explorer generates a
+
+
+ A test explorer may be stateful since it is only used to build one
+
+ Subclasses of this class provide the algorithm used to populate the test model.
+
+
+
+
+
+ Disposes the test explorer.
+
+
+
+
+ Disposes the test explorer.
+
+
+
+
+ Explores tests defined by the specified code element and populates the explorer's test model.
+
+ Thrown if
+
+
+
+ Finishes populating the model.
+
+
+
+ The default implementation does nothing. Subclasses should override this method
+ to apply any deferred changes to the test model once exploration is complete.
+
+
+
+
+
+ Explores tests defined by the specified code element and populates the explorer's test model.
+
+
+
+
+ Creates the
+
+
+ The default implementation returns a new
+
+ The test model.
+
+
+
+ Gets the test model.
+
+
+
+
+ The test model for the pattern test framework.
+
+
+
+
+ The test model provides access to the contents of the test tree
+ generated from a test package by the test enumeration process.
+
+
+
+
+ Creates a test model with a new empty root test.
+
+
+
+
+ Clears the list of annotations.
+
+
+
+
+ Adds an annotation.
+
+ Thrown if
+
+
+
+ Removes an annotation.
+
+ Thrown if
+
+
+
+ Finds a test by its id.
+
+ The test, or null if not found.
+ Thrown if
+
+
+
+ Gets or sets the root test in the model.
+
+ Thrown if
+
+
+
+ Recursively enumerates all tests including the root test.
+
+
+
+
+ Gets the read-only list of annotations.
+
+
+
+ An annotation is an informational, warning or error message associated with
+ a code element in the test model.
+
+
+ Test frameworks publish annotations on the test model that describe usage errors
+ or warnings about problems that may prevent tests from running, such as using a
+ custom attribute incorrectly. They may also emit informational annotations to
+ draw the user's attention, such as by flagging ignored or pending tests.
+
+
+ The presentation of annotations is undefined. A command-line test runner might
+ simply log them whereas an IDE plugin could generate new task items to incorporate
+ them into the UI.
+
+
+
+
+
+ Creates a pattern test model.
+
+
+
+
+ Gets or sets the root test.
+
+
+
+
+ Specifies a trigger condition for automatic execution of an action.
+
+
+
+
+ Never performs the action.
+
+
+
+
+ Perform the action when the test finishes.
+
+
+
+
+ Perform the action when the test passed.
+
+
+
+
+ Perform the action when the test passed or was inconclusive.
+
+
+
+
+ Perform the action when the test was inconclusive.
+
+
+
+
+ Perform the action when the test failed.
+
+
+
+
+ Perform the action when the test failed or was inconclusive.
+
+
+
+
+ Generator of random
+
+
+
+ Generator of random
+
+
+
+ Constructs a generator of random
+
+
+
+
+
+ Generates the next random string.
+
+ A random string.
+
+
+
+ Gets or sets the length of the sequence of strings
+ created by the generator.
+
+
+
+
+ Constructs a generator of random
+
+
+
+
+
+
+
+ Gets or sets the predefined string values.
+
+
+
+
+ Generator of random
+
+
+
+ Constructs a generator of random
+
+
+
+
+
+
+
+ Gets or sets regular expression pattern that serves as a filter mask.
+
+
+
+
+ The Gallio.Framework.Data.Generation namespace provides a framework for generating data
+ based on a specification.
+
+
+
+
+ Represents a arbitrary character among a set of possible values, in a regular expression tree.
+
+
+
+ It is usually the representation of an explicit set, noted as "[...]" in a regular expression.
+
+
+
+
+
+ Abstract base class for a regular expression composite tree leaf.
+
+
+
+
+ Interface for a regular expression composite tree leaf.
+
+
+
+
+ Returns a random string that matches the regular expression element.
+
+ A random string.
+
+
+
+ A shared built-in generator of random numbers.
+
+
+
+
+ Constructs an inner element of a regular expression composite tree.
+
+ Thrown if
+
+
+
+
+
+ Returns the random string that matches the regular expression element.
+
+ A random string.
+
+
+
+ Constructs an element representing a set of possible characters.
+
+ Thrown if
+
+
+
+ Constructs an element representing a set of possible characters.
+
+ Thrown if
+
+
+
+
+
+ Represents an empty element in a regular expression composite tree.
+
+
+
+
+ Represents an invariant literal text in a regular expression tree.
+
+
+
+
+ Constructs an invariant literal text.
+
+ Thrown if
+
+
+
+
+
+ Default constructor.
+
+
+
+
+ Represents an element of a regular expression tree that serves as logical container child elements.
+
+
+
+ It is usually the representation of a logical group, noted as "(...)" in a regular expression.
+
+
+
+
+
+ Constructs a group element that contains child elements.
+
+ Thrown if
+
+
+
+
+
+ This exception type is used to signal an error while parsing
+ a simplified regular expression with the RegexLite parser.
+
+
+
+
+ Creates a exception.
+
+
+
+
+ Creates a exception with the specified message..
+
+
+
+
+ Creates a exception with the specified message and the inner exception.
+
+
+
+
+ Creates a exception from serialization info.
+
+
+
+
+ Lightweight parser for simplified regular expressions.
+
+
+
+
+ RegexLite text parser.
+
+ A root element containing the resulting regular expression tree.
+
+
+
+ Provides information describing how to parse the current expression.
+
+
+
+
+ Primary mode for parsing root expressions.
+
+
+
+
+ Special mode for parsing logical groups "(...)".
+
+
+
+
+ Special mode for parsing explicit sets "[...]".
+
+
+
+
+ Determines whether the specified character is
+ the initiator character for the current parsing mode.
+
+ True if
+
+
+
+ Determines whether the specified character is
+ the terminator character for the current parsing mode.
+
+ True if
+
+
+
+ Parses the specified expression in the context of the actual parsing mode.
+
+ A resulting element representing the expression.
+
+
+
+ Returns the information container corresponding to the specified initiator character,
+ or the 'Root' parsing mode, if not found.
+
+ The resulting information container.
+
+
+
+ Gets the initiator character.
+
+
+
+ The initiator character is the character that starts of an inner expression.
+
+
+
+
+
+ Gets the terminator character.
+
+
+
+ The initiator character is the character that ends an inner expression.
+
+
+
+
+
+ Gets a value indicating if the actual parsing mode is the primary 'Root' mode.
+
+
+
+
+ Gets a value indicating if the actual parsing mode should process metacharacters,
+ or just to ignore them for a later processing.
+
+
+
+
+ A lightweight simplified regular expression pattern.
+
+
+
+ The following syntactic features are supported:
+
+ -
+
Logical Grouping : Group a part of the expression ((...) ).
+
+ -
+
Explicit Set : Define a set of possible characters ([...] ).
+ Ranges defined with a tiret are accepted.
+
+ -
+
Explicit Quantifier : Specify the number of times the previous expression must be repeated.
+ 'Constant' ({N} ) or 'Range' ({N,M} ) syntax are both accepted.
+
+ -
+
Zero Or One Quantifier Metacharacter : 0 or 1 of the previous expression (? ).
+ Same effect as {0,1} .
+
+ -
+
Escape Character : Makes the next character literal instead of a special character (\ ).
+
+
+
+
+
+
+
+ Constructs a simplified regular expression pattern.
+
+ Thrown if
+ Thrown if
+
+
+
+ Returns the random string that matches the regular expression pattern.
+
+ A random string that matches the regular expression pattern.
+
+
+
+ Gets the root element (for testing purpose.)
+
+
+
+
+ Quantifier for a regular expression element,
+ which specifies the number of times the element must be repeated.
+
+
+
+
+ Gets a special quantifier specifying a single occurence of an element (1 time).
+
+
+
+
+ Gets a special quantifier specifying the optional occurence of an element (0 or 1 time).
+
+
+
+
+ Constructs a quantifier with a constant value.
+
+
+
+
+ Constructs a quantifier specifying a variable number of times.
+
+
+
+
+ Returns a random number within the range of the quantifier.
+
+ A random number.
+
+
+
+ Gets the minimum number of times.
+
+
+
+
+ Gets the maximum number of times.
+
+
+
+
+ Generator of sequential
+
+
+
+ Default constructor.
+
+
+
+
+
+
+
+
+
+
+ Gets the default step.
+
+
+
+
+ Generator of random
+
+
+
+ Constructs a generator of random
+
+
+
+
+
+ A condition is a simple light-weight mechanism for evaluating conditional
+ expressions in a given context.
+
+
+
+ Conditions are most useful for defining declarative conditional activation
+ expressions in
+
+ The currently-supported conditional expression syntax is as follows:
+
+ - "${namespace:identifier}": Specifies a condition based on the existence
+ of a property with a particular identifier within the specified namespace.
+ eg. "${env:VariableName}" might evaluate to true if the "VariableName" environment
+ variable is defined.
+ - "ExprA or ExprB": Given two conditions ExprA and ExprB produces a combined
+ condition that evaluates to true when either on is true.
+ - An empty condition is invalid.
+
+
+
+ Note: This abstraction is a work in progress. If you need additional
+ conditional expression types, operators or combinators please post
+ a feature request to the Gallio issue tracker. Later we may open
+ this up similar to the test Filter mechanism.
+
+
+
+
+
+ Returns true if the condition is satisfied in the given context.
+
+ True if the condition is satisfied.
+ Thrown if
+
+
+
+ Parses a condition from an expression.
+
+ The expression.
+ Thrown if
+ Thrown if
+
+
+
+ Returns the conditional expression as a string.
+
+ The expression string.
+
+
+
+ A condition context provides information used to evaluate whether a condition holds true.
+
+
+
+
+ Returns true if the context contains a value for a given property.
+
+ True if the context has the specified property.
+ Thrown if
+
+
+
+ Returns true if the context contains a value for a given property.
+
+ True if the context has the specified property.
+
+
+
+ This exception type is used to signal an error while using a data generator.
+ The exception message, if present, should explain the reason that the test was generator has failed.
+
+
+
+
+ Creates a exception.
+
+
+
+
+ Creates a exception with the specified message..
+
+
+
+
+ Creates a exception with the specified message and the inner exception.
+
+
+
+
+ Creates a exception from serialization info.
+
+
+
+
+ The Gallio.Framework.Data namespace provides a framework for manipulating data
+ from multiple data sources and performing data binding.
+
+
+
+
+ The Gallio.Framework namespace provides data types and services for test writers
+ and framework implementors.
+
+
+
+
+ Finds and invokes a member of a test fixture, a nested type of the test fixture,
+ or an external type.
+
+
+
+ The member is searched among the fields, the properties, and the methods. It might be
+ a public or a non-public member. If the member belongs directly to the test fixture, it
+ might be an instance member. Otherwise, it must be a static member.
+
+
+ The type of the result returned by the member invoked.
+
+
+
+ Constructs a invoker for a member of a test fixture, a nested type of the test fixture,
+ or an external type.
+
+
+
+ The member is searched among the fields, the properties, and the methods of the test fixture
+ or the specified
+
+ Thrown if
+
+
+
+ Invokes the argument-less member and returns the resulting value.
+
+ The resulting value.
+
+
+
+ Invokes the member with the specified arguments and returns the resulting value.
+
+ The resulting value.
+
+
+
+ Invokes the member with the specified arguments and returns the resulting value.
+
+ The resulting value.
+
+
+
+ The Gallio.Framework.Pattern namespace provides the Pattern Test Framework which
+ can serve as the foundation for building new test frameworks.
+
+
+
+ The Pattern Test Framework is based on the idea of extensible and composable units
+ called patterns (
+
+ MbUnit is based on the Pattern Test Framework.
+
+
+ If you are implementing a new attribute-based test framework then you may find it
+ beneficial to extend the Pattern Test Framework. Alternately you may implement
+
+
+
+
+
+ The Gallio.Framework.Utilities namespace provides utilities for framework implementors.
+
+
+
+
+ Generates test commands from a tree of tests.
+
+
+
+
+ Recursively builds a tree of test commands.
+
+ The root test command or null if none of the tests in
+ the subtree including
+ Thrown if
+ Thrown if an invalid test dependency is found.
+
+
+
+ The Gallio.Model.Commands namespace provides an optional abstraction for
+ decomposing a
+
+
+ The types in this namespace are provided as an optional convenience for implementing
+ a
+
+
+
+
+ The Gallio.Model.Contexts namespace provides an optional abstraction for
+ associating a
+
+
+ The types in this namespace are provided as an optional convenience for implementing
+ a
+
+
+
+
+ Test environmnent hosting custom actions to be run on AppDomain/Thread set-up and teardown.
+
+
+
+
+ Base implementation of a test environment.
+
+
+
+
+ The test environment configures global behavior related to preparing
+ the test execution environment for running tests and tearing them down.
+
+
+
+
+ Sets up the current test AppDomain.
+
+ Returns an object that when disposed causes the test environment to be torn down, or null if none.
+
+
+
+ Sets up the current test Thread.
+
+ Returns an object that when disposed causes the test environment to be torn down, or null if none.
+
+
+
+
+
+
+
+ A chain of actions to be run on AppDomain set-up.
+
+
+
+
+ A chain of actions to be run on AppDomain teardown.
+
+
+
+
+ A chain of actions to be run on Thread set-up.
+
+
+
+
+ A chain of actions to be run on Thread teardown.
+
+
+
+
+
+
+
+
+ A test driver implementation used when no test framework supports a given test file.
+
+
+
+
+ A base test driver that does nothing.
+
+
+
+
+ Provides test framework services for exploring and running tests.
+
+
+
+
+ Gets the test parts represented by a code element.
+
+ The test parts, or an empty array if none.
+ Thrown if
+
+
+
+ Describes tests via reflection over code elements.
+
+ Thrown if
+
+
+
+ Explores tests in a test package.
+
+ The test report.
+ Thrown if
+
+
+
+ Runs tests from a test package.
+
+ The test report.
+ Thrown if
+
+
+
+
+
+
+
+
+
+
+
+ Gets the test parts represented by a code element.
+
+
+
+ The default implementation always returns an empty array. Subclasses may override
+ this method to provide information about code elements that represent tests.
+
+
+ The test parts, or an empty array if none.
+
+
+
+ Describes tests via reflection over code elements.
+
+
+
+ The default implementation does nothing. Subclasses may override to enable tests
+ to be described via reflection only. This is required for ReSharper integration.
+
+
+
+
+
+ Explores tests from a test package.
+
+
+
+ The default implementation does nothing. Subclasses may override to enable tests
+ to be explored. This is required for presenting lists of tests in test runners like Icarus.
+
+
+ The test report.
+
+
+
+ Runs tests from a test package.
+
+
+
+ The default implementation does nothing. Subclasses may override to enable tests
+ to be run. This is required for actually running tests.
+
+
+ The test report.
+
+
+
+ Creates the fallback test driver.
+
+ Thrown if
+
+
+
+
+
+
+
+
+
+ Gets the fallback explanation.
+
+
+
+
+ Describes the function of a code element in a test.
+
+
+
+
+ Gets whether the part represents a test case or test container.
+
+
+
+
+ Gets or sets whether the part represents a test case such as a test method.
+
+
+
+
+ Gets or sets whether the part represents a test container such as a test class.
+
+
+
+
+ Gets or sets whether the part represents some contribution to a test
+ such as a setup or teardown method, a test parameter, or a factory.
+
+
+
+
+ Specifies a test frameworks that has been selected by a
+
+
+
+ Creates a test framework selection.
+
+ Thrown if
+
+
+
+ Gets the selected test framework handle.
+
+
+
+
+ Gets the test framework options.
+
+
+
+
+ Returns true if the selected test framework is a fallback because no other
+ registered test framework supports the requested test resources.
+
+
+
+
+ Provides options that configure a test framework.
+
+
+
+
+ Creates a default set of test framework options.
+
+
+
+
+ Clears the collection of properties.
+
+
+
+
+ Adds a property key/value pair.
+
+ Thrown if
+ Thrown if
+
+
+
+ Removes a property key/value pair.
+
+ Thrown if
+
+
+
+ Creates a copy of the options.
+
+ The copy.
+
+
+
+ Gets a read-only collection of configuration properties for the test framework.
+
+
+
+
+ A test framework implementation used when no test framework supports a given test file.
+
+
+
+
+ Abstract base class for test framework implementations.
+
+
+
+
+ The test framework service provides support for enumerating and executing
+ tests that belong to some test framework.
+
+
+
+ A new third party test framework may be supported by defining and registering
+ a suitable implementation of this interface.
+
+
+
+
+
+ Gets the test driver factory for the framework.
+
+
+
+ When multiple test frameworks result the same test driver factory
+ then only one instance of the test driver will be created and it will
+ be shared by those frameworks. Factory identity is based on delegate
+ equality.
+
+
+ The test driver factory.
+
+
+
+
+
+ The test framework option key used to explain why the fallback test framework is being used.
+
+
+ The associated value should be a plain test message describing the problem with
+ the test file.
+
+
+
+
+
+
+ Specifies how Gallio responds to test files that do not match any frameworks.
+
+
+
+
+ Default match: always fallback to the fallback test framework when
+ a file does not satisfy the constraits of any other
+ test framework exactly.
+
+
+
+
+ Approximate match: fallback to the fallback test framework when
+ a file does not satisfy the constraints of any other
+ test framework exactly but appears to be an approximate match
+ for one of them (perhaps differing in version only). Otherwise
+ the file is not considered a test file.
+
+
+
+
+ Strict match: no fallback. If a file does not satisfy the
+ constraints of any framework exactly then it is not considered a test file.
+
+
+
+
+ Sets up console I/O streams.
+
+
+
+
+
+
+ A contextual log text writer messages to a named log stream in the log associated
+ with the test execution context that is active at the time each message is written.
+
+
+
+
+ Creates a text writer that writes to the specified execution log stream.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ A contextual log trace listener messages to a named log stream in the log associated
+ with the test execution context that is active at the time each message is written.
+
+
+
+
+ Creates a trace listener that writes to the specified execution log stream.
+
+
+
+
+
+
+
+
+
+
+ Default implementation of a test environment manager.
+
+
+
+
+ The test environment manager configures test AppDomains and threads.
+
+
+
+
+ Sets up the current test AppDomain.
+
+ Returns an object that when disposed causes the test environment to be torn down, or null if none.
+
+
+
+ Sets up the current test Thread.
+
+ Returns an object that when disposed causes the test environment to be torn down, or null if none.
+
+
+
+ Creates a test environment manager.
+
+
+
+
+
+
+
+
+ The Gallio.Model.Environments namespace provides an optional abstraction for
+ configuring the local test environment during test exploration and execution.
+
+
+
+ The types in this namespace are provided as an optional convenience for implementing
+ a
+
+
+
+
+ Specifies traits for
+
+
+
+ The base class for plugin, service or component traits.
+
+
+
+ Subclasses should include properties with getters and setters for binding
+ configuration values associated with services (aka. traits). They may also
+ include methods and other service-specific functionality based on the traits.
+
+
+ Traits objects are instantiated in the same way as other components. The container
+ injects required dependencies (on services or configuration values) in the constructor
+ and injects optional dependencies into settable properties.
+
+
+
+
+
+ A thread task that uses the
+
+
+
+ Creates a task that will execute code within a new locally running thread
+ test thread and a configured test environemnt.
+ When the task terminates successfully, its result will contain the value
+ returned by
+ Thrown if
+
+
+
+ Creates a task that will execute code within a new locally running thread
+ test thread and a configured test environemnt.
+ When the task terminates successfully, its result will contain the value null .
+
+ Thrown if
+
+
+
+
+
+
+
+ Sets up trace listeners.
+
+
+
+
+
+
+ Logs unhandled exceptions instead of killing the AppDomain.
+
+
+
+
+
+
+ Ensures Windows Forms applications can be tested safely.
+
+
+
+ This environment disables
+
+ Specifically this setting change resolves an obscure hangs that can occur. Creating
+ a
+
+ As a work-around, we disable auto-installation of the Windows Forms synchronization context.
+
+
+ For more information, see the following:
+ http://ikriv.com/en/prog/info/dotnet/MysteriousHang.html
+ http://www.aaronlerch.com/blog/2008/12/15/debugging-ui/
+
+
+
+
+
+
+
+ Gets a test controller for a subtree of tests.
+
+ The test controller or null if there is no specific controller
+ available for the test so the test should be executed using a default rule.
+
+
+
+ A test controller that recursively traverses a hierarchy of test commands and
+ delegates to another test controller based on a
+
+
+
+ A test controller executes tests defined by a tree of
+
+
+ A test controller may be stateful because it is used for only one test run then disposed.
+
+
+ Subclasses of this class provide the algorithm used to execute the commands.
+
+
+
+
+
+ Disposes the test controller.
+
+
+
+
+ Disposes the test controller.
+
+
+
+
+ Runs the tests.
+
+
+
+ This method can be called at most once during the lifetime of a test controller.
+
+
+ The combined result of the root test command.
+ Thrown if
+
+
+
+ Implementation of
+ The combined result of the root test command.
+
+
+
+ Recursively generates single test steps for each
+
+
+ This is useful for implementing fallback behavior when
+
+
+ The combined result of the test commands.
+
+
+
+ Creates a recursive test controller.
+
+ Thrown if
+
+
+
+
+
+ A test harness implementation based on
+
+
+
+ A test harness configures the test environment during test exploration and execution.
+
+
+
+ A test harness may be stateful because it is used for only one test run then disposed.
+
+
+
+
+
+ Creates the test harness.
+
+
+
+
+ Sets up the test AppDomain.
+
+
+
+ The default implementation returns null. Subclasses should override this method
+ to prepare the AppDomain for testing such as by redirecting the console streams
+ to a logging apparatus.
+
+
+ Returns an object that when disposed causes the changes to be torn down, or null if none.
+
+
+
+ Sets up the test Thread.
+
+
+
+ The default implementation returns null. Subclasses should override this method
+ to configure the Thread properties around the action such as setting the thread
+ synchronization context.
+
+
+ Returns an object that when disposed causes the changes to be torn down, or null if none.
+
+
+
+ Disposes the test harness.
+
+
+
+
+ Disposes the test harness.
+
+
+
+
+ Creates the test harness.
+
+ Thrown if
+
+
+
+
+
+
+
+ A simple test driver explores tests using a
+
+
+ The simple test driver class provides a good foundation for implementing
+ test drivers for most .Net frameworks. All you need to do is override the
+ required methods to provide a
+
+
+
+
+ A base test driver that is intended to support exploring and executing tests
+ inside .Net assemblies.
+
+
+
+ This test driver is a simple component for building a test driver for .Net based
+ test frameworks that do not require specialized hosting apparatus. It explores and
+ runs each test assembly within a separate isolated task that is configured based on the assembly
+ config file, runtime version and processor requirements. Depending on the isolation context,
+ the test may run in a different AppDomain or a different Process with a code coverage
+ tool, profiler or debugger attached. Regardless, subclasses do not need to concern themselves
+ with these details.
+
+
+ Both the
+
+
+
+
+ Explores tests in an assembly.
+
+
+
+ The default implementation does nothing. Subclasses may override to enable tests
+ to be explored. This is required for presenting lists of tests in test runners like Icarus.
+
+
+ This method executes within the test host which is most likely a different AppDomain
+ or Process from the test runner itself.
+
+
+
+
+
+ Runs tests in an assembly.
+
+
+
+ The default implementation does nothing. Subclasses may override to enable tests
+ to be run. This is required for actually running tests.
+
+
+ This method executes within the test host which is most likely a different AppDomain
+ or Process from the test runner itself.
+
+
+
+
+
+ Configures the host for a particular assembly.
+
+
+ The default implementation does nothing. Subclasses may override to customize
+ host the test host is configured for a particular assembly.
+
+
+
+
+ Gets arguments used to construct the a remote instance of the test driver.
+
+
+
+ If the test driver does not have a default constructor then it must implement the
+
+
+ All arguments must be serializable.
+
+
+ The default implementation returns an empty array.
+
+
+
+
+
+
+
+
+
+ Creates a host setup for a particular assembly within a test package.
+
+ The host setup setup.
+
+
+
+ Configures the host setup prior to the initialization of the script runtime.
+
+
+
+ The default implementation does nothing. Subclasses may override this method
+ to customize the host setup.
+
+
+
+
+
+ An isolated task runs in a
+
+
+ Subclasses must be implemented carefully since they may run in a remote environment
+ separate from the test runner.
+
+
+
+
+
+ Runs the task.
+
+
+
+ Wraps any exception thrown within a
+
+
+
+
+ Runs the task.
+
+
+
+
+
+
+
+
+
+
+ Creates a test explorer to describe and explore tests.
+
+ The test explorer.
+
+
+
+ Creates a test controller to run tests.
+
+ The test controller.
+
+
+
+ Creates a test harness to configure the test environment.
+
+
+
+ The default implementation returns a new
+
+ The test harness.
+
+
+
+ Creates a test command factory for generating
+
+
+ The default implementation returns a new
+
+ The test command factory.
+
+
+
+ Creates a test context manager for tracking test context and publishing
+ test messages to a message sink.
+
+
+
+ The default implementation returns a new
+
+ The test command factory.
+
+
+
+ Gets the name of the framework as it should appear in progress messages.
+
+
+
+
+ The Gallio.Model.Helpers namespace provides a suite of optional abstractions
+ to help implement test drivers.
+
+
+
+ The types in this namespace are provided as an optional convenience for implementing
+ a
+
+
+
+
+ An abstract base implementation of a test isolation context.
+
+
+
+
+ A test isolation context is responsible for running test code in an isolated
+ (possibly remote) environment.
+
+
+
+
+ Begins a batch of isolated tasks.
+
+
+
+ The isolation context may optimize the execution of subsequent isolated tasks
+ given that they are all part of the same batch.
+
+
+ Returns an object that when disposed causes the batch to be terminated, or null if none.
+ Thrown if
+
+
+
+ Runs an isolated task within the test isolation context.
+
+
+
+ Since the task may be executed remotely, make sure that all
+ arguments and results are serializable.
+
+
+ The isolated task subclass.
+ The task result, or null if none. Must be serializable.
+ Thrown if
+
+
+
+ Gets or sets whether the test isolation context requires test drivers to try to run test
+ code within the same thread on which the isolated task is executed.
+
+
+
+ A test isolation context may require single-threaded execution because it needs to
+ ensure that tests run within the UI loop of an application or due to other
+ synchornization concerns.
+
+
+
+
+
+ Disposes the test isolation context.
+
+
+
+
+
+
+
+
+ Runs an isolated task within the test isolation context.
+
+ The isolated task subclass.
+ The task result, or null if none. Must be serializable.
+
+
+
+ Begins a batch of isolated tasks.
+
+
+
+ The default implementation does nothing and returns null.
+
+
+ Returns an object that when disposed causes the batch to be terminated, or null if none.
+
+
+
+ Disposes the test isolation context.
+
+
+
+
+
+
+ An abstract base implementation of a test isolation provider.
+
+
+
+
+ A test isolation provider creates
+
+
+
+ Creates a test isolation context.
+
+ The test isolation context.
+ Thrown if
+
+
+
+
+
+ Creates a test isolation context.
+
+ The test isolation context.
+
+
+
+ Tells the server that the client has finished processing an isolated task.
+
+
+
+
+ Base class for all message objects.
+
+
+
+ Subclasses of this type should be declared to be both XML-serializable
+ (using
+
+ Message types do not need to be declared in advanced. Consequently plugins
+ may defined their own custom message types as long as they have a distinct name.
+
+
+
+
+ This is an example of a message type.
+
+ 10000)
+ throw new ValidationException("Quantity should be between 1 and 10000.");
+ }
+ }
+ ]]>
+
+
+
+
+ Provides a method that may be called by client code to validate that the content
+ of an object is well-formed.
+
+
+
+
+ Validates the object.
+
+ Thrown if the data is not well-formed.
+
+
+
+
+
+
+
+
+
+ Gets or sets the unique id of the isolated task.
+
+
+
+
+ Gets or sets the isolated task result.
+
+
+
+
+ Gets or sets the exception data.
+
+
+
+
+ Tells the server that the client is active.
+
+
+
+
+ Tells the client to run an isolated task.
+
+
+
+
+
+
+ Gets or sets the unique id of the isolated task.
+
+
+
+
+ Gets or sets the type of isolated task.
+
+
+
+
+ Gets or sets the isolated task arguments.
+
+
+
+
+ Tells the client to shut down.
+
+
+
+
+ The type of exception thrown when test isolation operations fail.
+
+
+
+
+ Creates an exception.
+
+
+
+
+ Creates an exception.
+
+
+
+
+ Creates an exception.
+
+
+
+
+ Creates an exception from serialization info.
+
+
+
+
+ Reports a status update.
+
+
+
+
+ A test isolation provider based on
+
+
+
+ Creates a hosted test isolation provider.
+
+ Thrown if
+
+
+
+
+
+ A hosted test isolation context created by
+
+
+
+ Creates a hosted test isolation context.
+
+ Thrown if
+
+
+
+
+
+ Runs an isolated task in a host.
+
+ The isolated task type.
+ The task result.
+
+
+
+ Gets the host factory.
+
+
+
+
+ Gets the test isolation options.
+
+
+
+
+ Gets the logger.
+
+
+
+
+ Manages the client end of a remote connection that runs isolated tasks provided by the server.
+
+
+
+
+ Creates a test isolation client.
+
+ Thrown if
+
+
+
+
+
+ Disposes the client.
+
+
+
+
+ Runs isolated tasks until the server shuts down.
+
+
+
+
+ Provides options that control test isolation.
+
+
+
+
+ Creates a default set of options.
+
+
+
+
+ Clears the collection of properties.
+
+
+
+
+ Adds a property key/value pair.
+
+ Thrown if
+ Thrown if
+
+
+
+ Removes a property key/value pair.
+
+ Thrown if
+
+
+
+ Creates a copy of the options.
+
+ The copy.
+
+
+
+ Gets a read-only collection of configuration properties for the test isolation context.
+
+
+
+
+ Manages the server end of a remote connection that dispatches isolated tasks to a client.
+
+
+
+
+ Creates a test isolation server.
+
+ Thrown if
+
+
+
+
+
+ Disposes the server.
+
+
+
+
+ Runs an isolated task on the client.
+
+ The isolated task result.
+ Thrown if
+
+
+
+ Instructs a client to shutdown nicely.
+
+
+
+ If this method is not called, the client will still eventually shut down when the
+ server is disposed but it may take longer and may result in an error being
+ logged on the client.
+
+
+
+
+
+ Utilities for normalizing test model contents.
+
+
+
+
+ Normalizes a test, step or parameter id.
+
+ The normalized id, or null if none. May be the same instance if
+
+
+
+ Normalizes a test, step or parameter name.
+
+ The normalized name, or null if none. May be the same instance if
+
+
+
+ Normalizes a lifecycle phase.
+
+ The normalized lifecycle phase, or null if none. May be the same instance if
+
+
+
+ Normalizes a metadata key.
+
+ The normalized metadata key, or null if none. May be the same instance if
+
+
+
+ Normalizes a metadata value.
+
+ The normalized metadata value, or null if none. May be the same instance if
+
+
+
+ Normalizes the message or details of an annotation.
+
+ The normalized text, or null if none. May be the same instance if
+
+
+
+ Normalizes a log message.
+
+ The normalized text, or null if none. May be the same instance if
+
+
+
+ Normalizes a metadata collection.
+
+ The normalized metadata collection, or null if none. May be the same instance if
+
+
+
+ Provides functions for converting a
+
+
+
+ Publishes the contents of the test model to a message sink as test
+ and annotation discovered messages.
+
+ Thrown if
+
+
+
+ Creates a message sink that populates the test model as test and annotation
+ discovered messages are published.
+
+ The message sink.
+ Thrown if
+
+
+
+ A factory for test drivers.
+
+
+
+
+ Describes characteristics of a test.
+
+
+
+
+ Gets the test id.
+
+
+
+
+ Gets the test name.
+
+
+
+
+ Gets the code element associated with the test, or null if none.
+
+
+
+
+ Gets the test metadata.
+
+
+
+
+ Default implementation of
+
+
+
+ Describes a test kind.
+
+
+
+ The test kind is ignored by the test runner but it allows tests to be classified
+ so that a user interface can provide appropriate decorations and other affordances
+ for any test kinds that it recognizes.
+
+
+ The test kind is associated with a test by setting the test's
+
+
+
+
+ Default implementation of a
+
+
+
+ Manages the list of test kinds.
+
+
+
+
+ Gets handles for all registered test kinds.
+
+
+
+
+ Creates a test kind manager.
+
+ Thrown if
+
+
+
+
+
+ The Gallio.Model.Filters namespace provides a syntax for filtering tests based
+ on their properties.
+
+
+
+
+ Notifies that an annotation has been discovered by the test exploration process.
+
+
+
+
+
+
+
+
+ Gets or sets the annotation, not null.
+
+
+
+
+ Notifies that a test has been discovered by the test exploration process.
+
+
+
+
+
+
+
+
+ Gets or sets the id of the parent test, or null if the test is the root.
+
+
+
+
+ Gets or sets information about the test that was discovered, not null.
+
+
+
+
+ Notifies that a block started with Begin* has finished within a test step log stream.
+
+
+
+
+
+
+
+
+ Gets or sets the id of the test step, not null.
+
+
+
+
+ Gets or sets the stream name, not null.
+
+
+
+
+ Notifies that a marker block has been started within a test step log stream.
+
+
+
+
+
+
+
+
+ Gets or sets the id of the test step, not null.
+
+
+
+
+ Gets or sets the stream name, not null.
+
+
+
+
+ Gets or sets the marker.
+
+
+
+
+ Notifies that a section block has been started within a test step log stream.
+
+
+
+
+
+
+
+
+ Gets or sets the id of the test step, not null.
+
+
+
+
+ Gets or sets the stream name, not null.
+
+
+
+
+ Gets or sets the section name, not null.
+
+
+
+
+ Notifies that an attachment has been embedded into a test step log stream.
+
+
+
+
+
+
+
+
+ Gets or sets the id of the test step, not null.
+
+
+
+
+ Gets or sets the stream name, not null.
+
+
+
+
+ Gets or sets the attachment name, not null.
+
+
+
+
+ Notifies that text has been written to a test step log stream.
+
+
+
+
+
+
+
+
+ Gets or sets the id of the test step, not null.
+
+
+
+
+ Gets or sets the stream name, not null.
+
+
+
+
+ Gets or sets the text, not null.
+
+
+
+
+ Notifies that an attachment has been added to a test step log.
+
+
+
+
+
+
+
+
+ Gets or sets the id of the test step, not null.
+
+
+
+
+ Gets or sets the attachment, not null.
+
+
+
+
+ Notifies that a test step has finished execution.
+
+
+
+
+
+
+
+
+ Gets or sets the id of the test step, not null.
+
+
+
+
+ Gets or sets the test result, not null.
+
+
+
+
+ Notifies that a test step has dynamically added metadata to itself.
+
+
+
+
+
+
+
+
+ Gets or sets the id of the test step, not null.
+
+
+
+
+ Gets or sets the metadata key, not null.
+
+
+
+
+ Gets or sets the metadata value, not null.
+
+
+
+
+ Notifies that a test step has changed lifecycle phase.
+
+
+
+
+
+
+
+
+ Gets or sets the id of the test step, not null.
+
+
+
+
+ Gets or sets the lifecycle phase name, not null.
+
+
+
+
+ Notifies that a test step has started execution and provides its definition.
+
+
+
+
+
+
+
+
+ Gets or sets information about the test step that is about to start, not null.
+
+
+
+
+ Gets or sets the code element associated with the test step, or null if none.
+
+
+
+
+ The Gallio.Model.Messages namespace contains the messaging infrastructure for
+ test exploration and execution.
+
+
+
+
+ The Gallio.Model namespace contains types that describe the test object model.
+
+
+
+
+ The Gallio.Model.Schema namespace contains serializable types that
+ are used to describe tests for communication and persistence.
+
+
+
+
+ Provides options for selecting test frameworks.
+
+
+
+
+ Creates a test framework filter initialized to defaults.
+
+
+
+
+ Gets or sets a filter predicate for selecting test frameworks to include, or null if all
+ frameworks should be considered.
+
+
+ The predicate. Default is null .
+
+
+
+
+ Gets or sets the fallback mode used to specify when the
+
+ The fallback mode. Default is
+
+
+
+ Gets or sets the test framework options.
+
+ Thrown if
+
+
+
+ Specifies traits for
+
+
+
+ Creates test kind traits.
+
+ Thrown if
+
+
+
+ Gets the name of the test kind.
+
+
+
+
+ Gets the description of the test kind.
+
+
+
+
+ Gets or sets the icon for the test kind, or null if none.
+
+
+
+ The icon should be available in a 16x16 size.
+
+
+
+
+
+ Describes a test package in a portable manner for serialization.
+
+
+
+
+ Creates an empty test package.
+
+
+
+
+ Copies the contents of a test package.
+
+ Thrown if
+
+
+
+ Initializes a test package with the contents of this structure.
+
+ Thrown if
+
+
+
+ Creates a test package with the contents of this structure.
+
+ The test package.
+
+
+
+ Makes the test package paths relative to the specified base path.
+
+ Thrown if
+
+
+
+ Makes the test package paths absolute given the specified base path.
+
+ Thrown if
+
+
+
+
+
+ Gets the list of relative or absolute paths of test files.
+
+
+
+
+ Gets the list of hint directories used to resolve test assemblies and other files.
+
+
+
+
+ Gets the list of test framework IDs that are to be excluded from the test
+ exploration process.
+
+
+
+
+ Gets or sets whether assembly shadow copying is enabled.
+
+
+
+
+ Gets or sets whether to attach the debugger to the host.
+
+
+
+
+ Gets or sets the application base directory, or null to use the directory
+ containing each group of test files or some other suitable default chosen by the test framework.
+
+
+
+
+ Gets or sets the working directory, or null to use the directory containing
+ each group of test files or some other suitable default chosen by the test framework.
+
+
+
+
+ Gets or sets the .Net runtime version, or null to auto-detect.
+
+
+
+
+ Gets or sets the properties for the test runner. (non-null)
+
+ Thrown if
+
+
+
+ The Gallio.Model.Isolation namespace provides a means for running test
+ code within an isolated environment.
+
+
+
+
+ Arguments for an event raised to indicate that test execution has started.
+
+
+
+
+ Base arguments for events raised to indicate the beginning of an operation.
+
+
+
+
+ Initializes the event arguments.
+
+
+
+
+ Initializes the event arguments.
+
+ Thrown if
+
+
+
+ Gets the test package.
+
+
+
+
+ Gets the test exploration options.
+
+
+
+
+ Gets the test execution options.
+
+
+
+
+ Gets the report lock-box which may be used to access the report asynchronously during execution.
+
+
+
+
+ The Gallio.Runner.Events namespace contains event types that are used by the test runner.
+
+
+
+
+ Abstract base class for report containers that are used to load or save the contents of a report.
+
+
+
+
+ A report container that is used to load or save the contents of a report.
+
+
+
+ A report container consists of zero or more logical report files distinguished by extension and
+ a content folder. The content folder holds attachment contents and format-specific resources.
+
+
+ The definition of a report container is necessarily somewhat abstract. It is intended
+ to allow the files associated with report rendered in multiple formats to coexist
+ side by side unambiguously and without duplication of common attachment contents.
+
+
+ Paths within reports are always specified relative to the root of the container
+ with each path segment delimited by backslashes. The first path segment must be
+ "Report" then "Report.xml" and
+ "Report/Contents.txt" are valid paths but "Bar" and
+ "Report-NotAnExtension" are not.
+
+
+ By convention report content such as attachments and images are
+ stored in a folder with the same name as
+
+
+
+ This example demonstrates the structure of report files with the report name of
+ "MyReport" .
+
+ "MyReport.html" : A report file."MyReport.txt" : Another report file in a different format."MyReport\" : The standard report content directory by convention."MyReport\Step123\AttachedLog.txt" : An execution log attachment."MyReport\img\TestIcon.png" : An image used in the report."MyReport\img\FixtureIcon.png" : Another image used in the report."MyReport\img\Screenshot.jpg" : An execution log attachment.
+
+
+
+
+
+ Deletes the entire contents of the report in all of its formats.
+
+ Thrown if an I/O error occurs.
+
+
+
+ Opens a report file for reading.
+
+ The stream.
+ Thrown if
+ Thrown if an I/O error occurs.
+
+
+
+ Opens a report file for writing, overwriting any previous file with the same name.
+
+
+
+ It is not necessary to create "directories" within the container. They are
+ automatically created when new files are opened for writing within them.
+
+
+ The stream.
+ Thrown if
+ Thrown if an I/O error occurs.
+
+
+
+ Replaces invalid characters in a file or directory name with underscores
+ and trims it if it is too long.
+
+ The encoded file or directory name.
+ Thrown if
+
+
+
+ Gets the base name of the report.
+
+
+
+ Logical files and folders associated with the report all begin with this
+ name and are disambiguated by extension.
+
+
+
+
+
+ Protected constructor.
+
+ Thrown if
+ Thrown if
+
+
+
+
+
+
+
+
+
+ Disposes the report container.
+
+
+
+
+
+
+ Lightly validates the path to catch common programming errors.
+ This isn't really strong enough for enforcing any real security constraints.
+
+ The resulting validated path.
+
+
+
+
+
+ Gets the full-path of the report directory.
+
+
+
+
+ An archive based representation of a report container that uses
+ a compressed file to store report contents.
+
+
+
+
+ Creates a filed archive based representation of a report container.
+
+ Thrown if
+ Thrown if
+
+
+
+
+
+
+
+
+
+
+
+ The type of file archive used to enclose a test report.
+
+
+
+
+ Parses the specified value and returns the corresponding
+ True if the parsing was successful; otherwise false.
+
+
+
+ Parses the specified value and returns the corresponding
+ The resulting report archive item.
+ Thrown if the specified value does not correspond
+ to an known report archive value,
+
+
+
+ Non-compressed file structure.
+
+
+
+
+ Compressed zip archive.
+
+
+
+
+ Gets the report container type.
+
+
+
+
+ Abstract factory that provides a
+
+
+
+ Constructs a factory.
+
+ Thrown if any argument is null.
+
+
+
+ Makes a report container for a saving operation.
+
+ A new instance of report container.
+ Thrown if any argument is null.
+
+
+
+ Makes a report container for a reading operation.
+
+ A new instance of report container.
+
+
+
+ Represents a method that converts an object into an object of another type.
+
+ The result of the conversion.
+
+
+
+ Represents a strongly-typed method that converts an object into an object of another type.
+
+ The type of the object to convert.
+ The type of the result of the conversion,
+ The result of the conversion.
+
+
+
+ Converts a text representation of a
+
+
+
+ A conversion rule encapsulates an algorithm for converting a value from a source
+ type to a target type.
+
+
+
+ This type is not intended to be used directly by clients. Instead refer to
+
+
+
+
+
+ Gets the cost of converting a value of type
+ The conversion cost.
+
+
+
+ Converts the value
+
+
+ This method must not be called if null or
+ if it is already an instance of
+
+ The converted value.
+
+
+
+
+
+
+
+ Conversion rule for custom user conversions.
+
+
+
+
+ Constructs a custom conversion rule.
+
+
+
+
+
+
+
+
+ Extensibility point for object conversion managed by
+
+
+ Use the methods
+
+
+ The following example registers a custom converter that converts an Foo object.
+ (x => new Foo(x));
+ ]]>
+
+
+
+
+ Registers a custom converter that transforms an object of the source type into an object of the target type.
+
+ Thrown if
+ Thrown if a custom converter for the specified types was already registered.
+
+
+
+ Registers a strongly-tped custom converter for the specified types.
+
+ The type of the object to convert.
+ The type of the result of the conversion.
+ Thrown if
+ Thrown if a custom converter for the specified types was already registered.
+
+
+
+ Unregisters the custom converter for the specified types.
+
+
+
+ If no custom converter exists for the specified types,
+ the method has no effect and no exception is thrown.
+
+
+ Thrown if
+
+
+
+ Unregisters the custom converter for the specified types.
+
+
+
+ If no custom converter exists for the specified types,
+ the method has no effect and no exception is thrown.
+
+
+ The searched source type.
+ The searched target type.
+
+
+
+ Entry point for the registration of custom actions that extends the framework.
+
+
+
+
+ Extensibility point for object conversion managed by
+
+
+
+ Extensibility point for object formatting managed by
+
+
+
+ Extensibility point for object equality managed by
+
+
+
+ Extensibility point for object comparison managed by
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Represents a method that displays an object in a readable textual form.
+
+ The readable textual representation.
+
+
+
+ Represents a strongly-typed method that displays an object in a readable textual form.
+
+ The type of the object to format.
+ The readable textual representation.
+
+
+
+ Formatting rule for custom user formatters.
+
+
+
+
+ A formatting rule encapsulates an algorithm for formatting values of particular
+ types to strings for presentation.
+
+
+
+ This type is not intended to be used directly by clients. Instead refer to
+
+
+
+
+
+ Gets the formatting rule's priority for object of the specified type.
+
+
+
+ Rules with higher priority values take precedence over rules with lower priority values.
+
+
+ The priority of this rule, or null if the rule does not support formatting the specified object type.
+
+
+
+ Formats the specified object.
+
+
+
+ Exceptions thrown by this method will not be reported to clients.
+ Instead the formatter will substitute an appropriate placeholder string instead.
+
+
+ The formatted string representation of the object or null if the object
+ could not be formatted to produce a non-empty string.
+
+
+
+ Constructs a custom conversion rule.
+
+
+
+
+
+
+
+
+ Extensibility point for object formatting managed by
+
+
+ Use the methods
+
+
+ The following example registers a custom formatter for a Foo object.
+ (x => String.Format("Foo = {0}", x.Value));
+ ]]>
+
+
+
+
+ Registers a custom formatter that represents an object in a readable text format.
+
+ Thrown if
+ Thrown if a custom formatter for the specified type was already registered.
+
+
+
+ Registers a strongly-tped custom formatter for the specified types.
+
+ The type of the object to format.
+ Thrown if
+ Thrown if a custom formatter for the specified type was already registered.
+
+
+
+ Unregisters the custom formatter for the specified type.
+
+
+
+ If no custom formatter exists for the specified type,
+ the method has no effect and no exception is thrown.
+
+
+ Thrown if
+
+
+
+ Unregisters the custom formatter for the specified type.
+
+
+
+ If no custom converter exists for the specified types,
+ the method has no effect and no exception is thrown.
+
+
+ The searched type.
+
+
+
+ A condition context that is used to enable or disable plugins,
+ components and services based on characteristics of the runtime environment.
+
+
+ This condition context recognizes the following property tokens:
+
+ - "${env:ENVIRONMENTVARIABLE}": Satisfied when the environment contains
+ a variable called "ENVIRONMENTVARIABLE".
+ - "${minFramework:NET20}", "${minFramework:NET30}", "${minFramework:NET35}", "${minFramework:NET40}":
+ Satisfied when the currently running .Net runtime version is at least the specified version.
+ - "${process:PROC.EXE}", "${process:PROC.EXE_V1}", "${process:PROC.EXE_V1.2}",
+ "${process:PROC.EXE_V1.2.3}", "${process:PROC.EXE_V1.2.3.4}": Satisfied when the currently
+ running process main module is "PROC.EXE" and exactly matches the specified file version
+ components (if any).
+
+
+
+
+
+
+
+ Creates instances of
+
+
+
+ Creates the extension.
+
+ The extension to create.
+
+
+
+ Manages the set of available test runner extensions.
+
+
+
+
+ Registers auto-activated extensions with the test runner.
+
+ Thrown if
+
+
+
+ The Gallio.Runner.Extensions namespace provides a lightweight test runner
+ extension mechanism whereby custom extension types can be registered with
+ the test runner to intercept events and generate diagnostic output.
+
+
+
+
+ Provides traits for
+
+
+
+ Gets or sets a condition (using the syntax of
+
+
+ The condition may contain references to properties of the form ${env:VariableName}
+ which test whether a given environment variable has been defined.
+
+
+
+
+
+ Default implementation of
+
+
+
+ Creates a test runner extension manager.
+
+
+
+
+
+
+ The Gallio.Runner namespace provides the test runner infrastructure.
+
+
+
+
+ Default implementation of a test project manager.
+
+
+
+
+ Provides services for loading and saving test projects.
+
+
+
+
+ Creates a new project.
+
+ The loaded test project.
+ Thrown if the project name is null or empty.
+
+
+
+ Loads a saved test project.
+
+ The loaded test project.
+ Thrown if
+ Thrown if the test project cannot be loaded.
+ Thrown if the test project is malformed.
+
+
+
+ Saves a test project.
+
+ Thrown if
+ Thrown if the test project cannot be saved.
+ Thrown if the test project is malformed.
+
+
+
+ Constructor.
+
+
+
+
+
+
+
+
+
+
+ The Gallio.Runner.Projects.Schema namespace contains the project Xml schema.
+
+
+
+
+ The Gallio.Runner.Projects namespace contains types for managing Gallio project files.
+
+
+
+
+ A test project consists of a test package with a list of test files, a list
+ of test extensions, and report options.
+
+
+
+
+ The default report name format.
+
+ "test-report-{0}-{1}"
+
+
+
+ The default report directory relative path.
+
+ "Reports"
+
+
+
+ The default test runner factory name.
+
+
+
+
+ The file extension for Gallio project files.
+
+ ".gallio"
+
+
+
+ Creates an empty test project.
+
+
+
+
+ Resets
+
+
+
+ Resets
+
+
+
+ Resets
+
+
+
+ Clears the list of test filters.
+
+
+
+
+ Adds a test filter if not already added.
+
+ Thrown if
+
+
+
+ Removes a test filter.
+
+ Thrown if
+
+
+
+ Clears the list of test runner extensions.
+
+
+
+
+ Adds a test runner extension if not already added.
+
+ Thrown if
+
+
+
+ Removes a test runner extension.
+
+ Thrown if
+
+
+
+ Clears the list of test runner extension specifications.
+
+
+
+
+ Adds a test runner extension specification if not already added.
+
+ Thrown if
+
+
+
+ Removes a test runner extension specification.
+
+ Thrown if
+
+
+
+ Creates a copy of the test project.
+
+ The new copy.
+
+
+
+ Applies the settings of another test project as an overlay on top of this one.
+
+
+
+ Overrides scalar settings (such as
+
+ Thrown if
+
+
+
+ Gets or sets the test package.
+
+ Thrown if
+
+
+
+ Gets a read-only list of test filters.
+
+
+
+
+ Gets a read-only list of test runner extensions.
+
+
+
+
+ Gets a read-only list of test runner extension specifications.
+
+
+
+
+ Gets or sets the name of a
+
+
+ The default value is
+
+ Thrown if
+
+
+
+ Returns true if
+
+
+
+ Gets or sets the folder to save generated reports to.
+
+
+
+ Relative to project location, if not absolute.
+
+
+ Thrown if
+
+
+
+ Returns true if
+
+
+
+ The format for the filename of generated reports.
+
+
+
+ Within the format string, {0} is replaced by the date and {1} by the time.
+
+
+ The default value is "test-report-{0}-{1}" .
+
+
+ Thrown if
+
+
+
+ Gets or sets a value indicating whether the resulting reports must be enclosed
+ in a compressed archive file (zip).
+
+
+
+
+ Returns true if
+
+
+
+ The Gallio.Runner.Reports namespace contains types for reading, writing and
+ formatting test reports.
+
+
+
+
+ The Gallio.Runner.Reports.Schema namespace contains the report Xml schema.
+
+
+
+
+ The Gallio.Runtime.ConsoleSupport namespace contains a command-line argument
+ parsing Api and a rich console abstraction.
+
+
+
+
+ The Gallio.Runtime.Conversions namespace contains types for converting
+ values from one type to another based on extensible conversion rules.
+
+
+
+
+ The Gallio.Runtime.Debugging namespace contains types for interacting with the debugger.
+
+
+
+
+ Describes characteristics used to match an assembly such as an assembly name and version range.
+
+
+
+
+ Creates an assembly signature.
+
+ Thrown if
+
+
+
+ Sets the assembly version to match.
+
+
+
+
+ Sets the assembly version range to match.
+
+
+
+
+
+ Thrown if
+
+
+
+ Returns true if the signature matches the specified assembly name.
+
+
+
+ When the assembly name is a partial name that omits version information, the version
+ criteria of the signature are ignored.
+
+
+ True if the signature matches the assembly name.
+ Thrown if
+
+
+
+ Parses the assembly signature from a string.
+
+
+
+ The string takes the form of following forms:
+
+ - "AssemblyName"
+ - "AssemblyName, Version=1.2.0.0"
+ - "AssemblyName, Version=1.2.0.0-1.3.65535.65535"
+
+
+
+ The parsed signature.
+ Thrown if
+ Thrown if
+
+
+
+ Converts the signature to a string.
+
+ The signature in a format that can be subsequently parsed by
+
+
+
+ Gets the simple name of the assembly.
+
+
+
+
+ Gets the minimum assembly version to match inclusively, or null if there is no lower bound.
+
+
+
+
+ Gets the maximum assembly version to match inclusively, or null if there is no upper bound.
+
+
+
+
+ Provides options that configure the debugger.
+
+
+
+
+ Creates a default set of debugger options.
+
+
+
+
+ Clears the collection of properties.
+
+
+
+
+ Adds a property key/value pair.
+
+ Thrown if
+ Thrown if
+
+
+
+ Removes a property key/value pair.
+
+ Thrown if
+
+
+
+ Creates a copy of the options.
+
+ The copy.
+
+
+
+ Gets a read-only collection of configuration properties for the debugger.
+
+
+
+
+ The Gallio.Runtime.Extensibility namespace contains types for managing a registry
+ of plugins, services and components. The registry functions as a lightweight
+ inversion of control container for Gallio extensions.
+
+
+
+
+ Details of a plugin that has just been loaded.
+
+
+
+
+ Constructor.
+
+
+
+
+ The loaded plugin.
+
+
+
+
+ The base directory for the plugin.
+
+
+
+
+ The file path of the plugin.
+
+
+
+
+ The Gallio.Runtime.FileTypes namespace contains types for automatically
+ determining the types of files based on extensible file type recognizer rules.
+
+
+
+
+ The Gallio.Runtime.Formatting namespace contains types for formatting
+ values as human-readable strings based on extensible formatting rules.
+
+
+
+
+ The Gallio.Runtime.Hosting namespace contains types for hosting application
+ code in isolated AppDomains and out of process.
+
+
+
+
+ Abstract base class for installers.
+
+
+
+ The base implementation does nothing.
+
+
+
+
+
+ Installs or uninstalls components on the local machine.
+
+
+
+ An installer enables plugins to register and unregister their components with
+ the operating system as needed. Typically the installers are invoked
+ by the Gallio installation package (ie. the originally downloaded MSI file)
+ but they can also be invoked by the user via the
+
+
+
+
+ Installs components.
+
+
+
+
+ Uninstalls components.
+
+
+
+
+
+
+
+
+ The default installer manager implementation.
+
+
+
+
+ Performs installation tasks and manages the set of registered
+
+
+
+ Installs components.
+
+ True on success, false if the user canceled the operation.
+ Thrown if
+
+
+
+ Uninstalls components.
+
+ True on success, false if the user canceled the operation.
+ Thrown if
+
+
+
+ Creates the installer manager.
+
+
+
+
+
+
+
+
+ An elevated command used for installation.
+
+
+
+
+ Abstract base class for implementing elevated commands.
+
+ The argument type for the command, must be serializable.
+ The result type for the command, must be serializable.
+
+
+
+ Represents a command to be executed in an elevated context.
+
+
+
+ The command parameters and results must be serializable because they may be
+ transmitted across processes.
+
+
+
+
+
+ Executes the command.
+
+ The command result, must be null or serializable.
+
+
+
+
+
+ Executes the command.
+
+ The command result, must be null or serializable.
+
+
+
+ The id of this elevated command.
+
+
+
+
+ Initializes the command.
+
+
+
+
+
+
+ Arguments for the command.
+
+
+
+
+ Creates the arguments.
+
+ Thrown if
+
+
+
+ Gets the installer id.
+
+
+
+
+ Gets the requested installer operation.
+
+
+
+
+ Specifies the installer operation.
+
+
+
+
+ Runs the install.
+
+
+
+
+ Runs the uninstall.
+
+
+
+
+ Traits for
+
+
+
+ Gets or sets whether an installer requires privilege elevation (admin access)
+ to run.
+
+
+
+ On Windows Vista and more recent operating systems, this will result in the
+ appearance of a UAC Shield icon.
+
+
+
+
+
+ The Gallio.Runtime.Installer namespace contains types for installing Gallio components.
+
+
+
+
+ Installs or uninstalls components using the
+
+
+
+ Abstract base class for a utility command.
+
+ The arguments type, may be
+
+
+
+ A utility command is a small command-line tool that can be invoked
+ via the Gallio.Utility.exe program.
+
+
+
+ An example utility command is the VerifyInstallation command which checks
+ that the plugin configuration appears to be consistent.
+
+
+ The utility program provides a minor safety net in case the command throws
+ an exception. Upon catching the exception the program will log it as a fatal
+ error and terminate with a failure exit code. Of course, when a command throws
+ an exception the problem should be interpreted as a programming error.
+
+
+
+
+
+ Executes the command.
+
+ The command exit code, zero for success, non-zero for errors.
+
+
+
+ Gets the type of a class used to provide arguments to the command.
+
+
+
+ The returns type should be decorated with attributes such as
+
+
+ The argument class.
+
+
+
+ Validates the command arguments.
+
+ True if the arguments are valid.
+
+
+
+ Executes the command.
+
+ The command exit code, zero for success, non-zero for errors.
+
+
+
+ Validates the command arguments.
+
+ True if the arguments are valid.
+
+
+
+ Creates the command.
+
+
+
+
+
+
+
+
+ The arguments for the command.
+
+
+
+
+ When set to true, installs components.
+
+
+
+
+ When set to true, uninstalls components.
+
+
+
+
+ The ids of installers to include.
+
+
+
+
+ Locates Gallio.Loader.dll.
+
+
+
+
+ Gets the path of the Gallio.Loader assembly (unless it is in the GAC) so that it
+ can be loaded by external code using
+ The path of Gallio.Loader.dll, or null if Gallio.Loader.dll is
+ installed in the GAC.
+ Thrown if the Gallio.Loader assembly is not available.
+
+
+
+ The Gallio.Runtime.Loader namespace contains types for loading the
+ Gallio runtime into applications.
+
+
+
+
+ A buffered log writer is an adapter for
+
+
+
+ Creates a buffered log writer that reports a
+ Thrown if
+
+
+
+ Creates a buffered log writer that reports a particular encoding.
+
+ Thrown if
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ A
+
+
+ This can be used to write log messages to a markup stream.
+
+
+
+
+
+ Base implementation of
+
+
+
+ Provides support for logging messages from system components.
+
+
+
+
+ Logs a message.
+
+ Thrown if
+
+
+
+ Logs a message with an associated exception.
+
+ Thrown if
+
+
+
+ Logs a message with an associated exception.
+
+ Thrown if
+
+
+
+
+
+
+
+
+
+ Logs a message with an associated exception.
+
+
+
+
+ Creates a logger for the markup stream writer.
+
+ Thrown if
+
+
+
+
+
+ Common markup stream names.
+
+
+
+
+ The name of the standard stream for captured
+
+
+
+ The name of the standard stream for captured
+
+
+
+ The name of the standard stream for captured
+
+
+
+ The name of the standard stream for diagnostic
+
+
+
+ The name of the standard stream for reporting warning messages.
+
+
+
+
+ The name of the standard stream for reporting failure messages and exceptions.
+
+
+
+
+ The name of the standard stream for generic log messages.
+
+
+
+ It is preferable to write log messages to this stream in place of the console
+ output and error streams.
+
+
+
+
+
+ Represents a text-encoded attachment.
+
+
+
+
+ Creates an attachment.
+
+ Thrown if
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Gets the text of the attachment, not null.
+
+
+
+
+ Provides helpers for working with assemblies.
+
+
+
+
+ Gets the location of the assembly, or null if it is dynamic.
+
+ The assembly location as returned by
+ Thrown if
+
+
+
+ Gets the local path of the assembly prior to shadow copying.
+ Returns null if the original location of the assembly is not local.
+
+ The original non-shadow copied local path of the assembly, or null if none.
+ Thrown if
+
+
+
+ Gets the original local path of the assembly prior to shadow
+ copying, if it is local. Otherwise, returns the shadow-copied
+ assembly location.
+
+ The local path of the assembly, preferably its original
+ non-shadow copied location, or null if the assembly is dynamic and does not
+ have a location.
+ Thrown if
+
+
+
+ If the assembly codebase is a local file, returns it as a local
+ path. Otherwise, returns the assembly codebase Uri.
+
+ The assembly's path.
+ Thrown if
+
+
+
+ Gets the culture component of an assembly name.
+
+ The culture name.
+ Thrown if
+
+
+
+ Returns true if the stream represents a CLI Assembly in Microsoft PE format.
+
+
+ This function does not close the stream.
+
+ True if the stream represents an assembly.
+ Thrown if
+
+
+
+ Returns true if the file represents a CLI Assembly in Microsoft PE format.
+
+ True if the file represents an assembly.
+ Thrown if
+
+
+
+ Gets metadata about CLI Assembly in Microsoft PE format.
+
+ The metadata or null if the stream does not represent a CLI assembly.
+ Thrown if
+
+
+
+ Gets the Major and Minor components of the CLI runtime version of a CLI Assembly in Microsoft PE format.
+
+ The version, of which only the major and minor components are populated,
+ or null if the stream does not represent a CLI assembly.
+ Thrown if
+
+
+
+ Manipulates attributes described by their metadata.
+
+
+
+
+ Gets the attribute of the specified type, or null if none.
+
+ The attribute type.
+ The attribute, or null if none.
+ Thrown if the code element
+ has multiple attributes of the specified type.
+
+
+
+ Gets the attributes of the specified type.
+
+ The attribute type.
+ The attributes.
+
+
+
+ Returns true if the code element has an attribute of the specified type.
+
+ The attribute type.
+ True if the code element has at least one attribute of the specified type.
+
+
+
+ Gets the attribute of the specified type, or null if none.
+
+ The attribute, or null if none.
+ Thrown if the code element
+ has multiple attributes of the specified type.
+
+
+
+ Gets the attributes of the specified type.
+
+ The attributes.
+
+
+
+ Returns true if the code element has an attribute of the specified type.
+
+ True if the code element has at least one attribute of the specified type.
+
+
+
+ Resolves all the attributes.
+
+
+
+ Omits attributes that cannot be resolved.
+
+
+ The resolved attribute instances.
+
+
+
+ Describes the kind of code element represented by a
+
+
+
+ The element is an
+
+
+
+ The element is an
+
+
+
+ The element is an
+
+
+
+ The element is an
+
+
+
+ The element is an
+
+
+
+ The element is an
+
+
+
+ The element is an
+
+
+
+ The element is an
+
+
+
+ The element is an
+
+
+
+ The element is an
+
+
+
+ Sorts code elements in various ways.
+
+
+
+
+ Sorts members such that those declared by supertypes appear before those
+ declared by subtypes.
+
+ The type of member.
+ The sorted members.
+
+
+
+ Specifies the location of a code element as a position within a file.
+
+
+
+ Lines and columns are numbered starting from 1.
+
+
+
+
+
+ Gets an empty code location with a null path and no line or column number information.
+
+
+
+
+ Creates a code location.
+
+ Thrown if
+ Thrown if
+
+
+
+ Converts the location to a string of the form "path(line,column)",
+ "path(line)" or "path" depending on which components are available.
+
+ The code location as a string or "(unknown)" if unknown.
+
+
+
+
+
+ Compares two code locations for equality.
+
+ True if the code locations are equal.
+
+
+
+ Compares two code locations for inequality.
+
+ True if the code references are not equal.
+
+
+
+
+
+
+
+
+
+ Provides the Xml schema for this element.
+
+ The schema type of the element.
+
+
+
+ Allows the code location structure to control
+ its own serialization and deserialization.
+
+
+
+
+ Gets the path or Uri of a resource that contains the code element, such as
+ a source file or assembly, or null if unknown.
+
+
+
+
+ Gets the line number, or 0 if unknown.
+
+
+
+
+ Gets the column number, or 0 if unknown.
+
+
+
+
+ A code reference is a pointer into the structure of a .Net program for use in
+ describing the location of a certain code construct to the user. It is
+ typically used to identify the point of definition of a test component.
+
+
+
+
+ Gets an empty code reference used to indicate that the actual
+ reference is unknown.
+
+
+
+
+ Creates a code reference from strings.
+
+
+
+
+ Produces a human-readable description of the code reference.
+
+ A description of the code reference.
+
+
+
+ Creates a code reference from a method parameter.
+
+ The code reference.
+ Thrown if
+
+
+
+ Creates a code reference from a member.
+
+ The code reference.
+ Thrown if
+
+
+
+ Creates a code reference from a type.
+
+ The code reference.
+ Thrown if
+
+
+
+ Creates a code reference from an namespace name.
+
+ The code reference.
+ Thrown if
+
+
+
+ Creates a code reference from an assembly.
+
+ The code reference.
+ Thrown if
+
+
+
+
+
+ Compares two code references for equality.
+
+ True if the code references are equal.
+
+
+
+ Compares two code references for inequality.
+
+ True if the code references are not equal.
+
+
+
+
+
+
+
+
+
+ Provides the Xml schema for this element.
+
+ The schema type of the element.
+
+
+
+ Gets the kind of code element specified by the code reference.
+
+
+
+
+ Gets the assembly name, or null if none.
+
+
+
+
+ Gets the namespace name, or null if none.
+
+
+
+
+ Gets the fully-qualified type name, or null if none.
+
+
+
+
+ Gets the member name, or null if none.
+
+
+
+
+ Gets the parameter name, or null if none.
+
+
+
+
+ Describes the kind of code element specified by a
+
+
+
+ The code reference is unknown.
+
+
+
+
+ The code reference specifies an assembly.
+
+
+
+
+ The code reference specifies a namespace.
+
+
+
+
+ The code reference specifies a type.
+
+
+
+
+ The code reference specifies a constructor, method, property, field or event.
+
+
+
+
+ The code reference specifies a parameter of a constructor or method.
+
+
+
+
+ Specifies a typed constant value.
+
+
+
+
+ Creates a constant value.
+
+ Thrown if
+
+
+
+ Creates a constant value that wraps an existing native value.
+
+ The constant.
+
+
+
+ Resolves the constant to a native value by replacing type references with actual
+ The native constant value.
+ Thrown if the target cannot be resolved.
+
+
+
+ Gets the type of the constant.
+
+
+
+ The type may be an array type, an enum type, a primitive type, or the
+
+
+
+
+ Gets the value of the constant.
+
+
+
+ If
+ - If the constant is a primitive value, then the value will be a primitive value such as an
+ integer, string, float or null.
+ - If the constant is an enum, then the value will be a primitive value of the underlying type of the enum.
+ - If the constant is an array, then the value will be an array of
+ - If the constant is a type, then the value will be a
+
+
+
+
+
+
+ Returns true if the contents of
+
+
+
+ Returns true if the value is an array.
+
+
+
+
+ Returns true if the value is an enum.
+
+
+
+
+ Returns true if the value is a type.
+
+
+
+
+ A placeholder enum type used to express enum values that cannot be resolved because
+ their actual enum type cannot be resolved.
+
+
+
+
+ Sorts an members that all belong to the same type
+ such that the members declared by supertypes appear before those
+ declared by subtypes.
+
+
+ If type A derives from types B and if type C derives from B then given methods
+ A.Foo, A.Bar, B.Foo, C.Quux one possible sorted order will be:
+ B.Foo, C.Quux, A.Bar, A.Foo. The members are not sorted by name or
+ by any other criterion except by relative specificity of the
+ declaring types.
+
+
+
+
+ Gets the singleton instance of the comparer.
+
+
+
+
+
+
+ A
+
+
+ This wrapper enables reflection-based algorithms to be used against
+ code that may or may not be loaded into the current AppDomain.
+ For example, the target of the wrapper could be an in-memory
+ code model representation.
+
+
+
+
+
+ Represents a structural element of some code base.
+
+
+
+ This interface is the base of a hierarchy of abstract reflection objects.
+ Different implementations of these objects may be used to perform
+ reflection over different sources.
+
+
+
+
+
+ Gets information about the code element's custom attributes of the specified type.
+
+ The code element's attributes.
+
+
+
+ Returns true if the code element has a custom attribute of the specified type.
+
+ True if the code element has at least one attribute of the specified type.
+
+
+
+ Gets the code element's custom attributes of the specified type.
+
+ The attributes.
+
+
+
+ Gets the XML documentation associated with the code element.
+
+ The XML documentation or null if none available.
+
+
+
+ Gets the location of a resource that contains the declaration of this code element, or
+
+ The code location.
+
+
+
+ Gets the name of the code element.
+
+
+
+
+ Gets the kind of code element represented by this instance.
+
+
+
+
+ Gets a
+ The code reference.
+
+
+
+ Gets the
+ The assembly name.
+
+
+
+ Gets the names of the assemblies referenced by this assembly.
+
+ The names of the references assemblies.
+
+
+
+ Gets the public types exported by the assembly.
+
+ The exported types.
+
+
+
+ Gets all of the types in an assembly.
+
+ The types.
+
+
+
+ Gets a public type by name, or null if not found.
+
+ The type.
+
+
+
+ Resolves the wrapper to its native reflection target.
+
+ The native reflection target.
+ Thrown if the target cannot be resolved.
+
+
+
+ Gets the codebase of the assembly as a local path if possible or as a Uri otherwise.
+
+
+
+
+ Gets the full name of the assembly.
+
+
+
+
+ Provides information about the contents of a custom attribute.
+
+
+
+
+ Gets an attribute field value.
+
+ The value, or a default value of the field's type if the field with the specified name
+ was not initialized by the attribute declaration.
+ Thrown if there is no writable instance field with the specified name.
+
+
+
+ Gets an attribute property value.
+
+ The value, or a default value of the propery's type if the property with the specified name was not
+ initialized by the attribute declaration.
+ Thrown if there is no writable instance property with the specified name.
+
+
+
+ Gets the attribute as an object.
+
+ The attribute.
+ Thrown if the attribute could not be resolved.
+
+
+
+ Gets the attribute type.
+
+
+
+
+ Gets the constructor used to create the attribute.
+
+ Thrown if not supported.
+
+
+
+ Gets the initialized attribute constructor argument values.
+
+ Thrown if not supported.
+
+
+
+ Gets the initialized attribute field values.
+
+
+
+
+ Gets the initialized attribute property values.
+
+
+
+
+ A
+
+
+ This wrapper enables reflection-based algorithms to be used against
+ code that may or may not be loaded into the current AppDomain.
+ For example, the target of the wrapper could be an in-memory
+ code model representation.
+
+
+
+
+
+ A
+
+
+ This wrapper enables reflection-based algorithms to be used against
+ code that may or may not be loaded into the current AppDomain.
+ For example, the target of the wrapper could be an in-memory
+ code model representation.
+
+
+
+
+
+ A
+
+
+ This wrapper enables reflection-based algorithms to be used against
+ code that may or may not be loaded into the current AppDomain.
+ For example, the target of the wrapper could be an in-memory
+ code model representation.
+
+
+
+
+
+ Gets the member to its underlying native reflection type.
+
+ The underlying native reflection type.
+ Thrown if the target cannot be resolved.
+
+
+
+ Gets the declaring type of the member.
+
+
+
+ If the member not a type or is a nested type,
+ returns its containing type. If it is a generic parameter, returns the type
+ to which it (or its declaring method) belongs. Otherwise returns null.
+
+
+
+
+
+ Gets the reflected type of the member. The reflected type is the type that was
+ used to locate the member. If the member was inherited from a base class, its
+ declaring type will be the base class but its reflected type will be the inherited
+ class from which the member was accessed.
+
+
+
+ If the member not a type or is a nested type, returns its reflected containing type.
+ If it is a generic parameter, returns the declaring type to which it (or its
+ declaring method) belongs. Otherwise returns null.
+
+
+
+
+
+ Resolves the wrapper to its native reflection target.
+
+ The native reflection target.
+ Thrown if the target cannot be resolved.
+
+
+
+ Gets the method attributes.
+
+
+
+
+ Gets the calling conventions for this method.
+
+
+
+
+ Returns true if the method is abstract.
+
+
+
+
+ Returns true if the method is final.
+
+
+
+
+ Returns true if the method is static.
+
+
+
+
+ Gets a value indicating whether the method is virtual.
+
+
+
+
+ Gets a value indicating whether this method can be called by other classes in the same assembly.
+
+
+
+
+ Gets a value indicating whether access to this method is restricted to members of the class and members of its derived classes.
+
+
+
+
+ Gets a value indicating whether this method can be called by derived classes if they are in the same assembly.
+
+
+
+
+ Gets a value indicating whether this method can be called by derived classes, wherever they are, and by all classes in the same assembly.
+
+
+
+
+ Gets a value indicating whether this member is private.
+
+
+
+
+ Gets a value indicating whether this is a public method.
+
+
+
+
+ Gets a value indicating whether only a member of the same kind with exactly the same signature is hidden in the derived class.
+
+
+
+
+ Gets the parameters of the function.
+
+ The parameters.
+
+
+
+ Resolves the wrapper to its native reflection target.
+
+ The native reflection target.
+ Thrown if the target cannot be resolved.
+
+
+
+ A
+
+
+ This wrapper enables reflection-based algorithms to be used against
+ code that may or may not be loaded into the current AppDomain.
+ For example, the target of the wrapper could be an in-memory
+ code model representation.
+
+
+
+
+
+ Resolves the wrapper to its native reflection target.
+
+ The native reflection target.
+ Thrown if the target cannot be resolved.
+
+
+
+ Gets the event attributes.
+
+
+
+
+ Gets the add method of the event, or null if none.
+
+ The add method, or null if none.
+
+
+
+ Gets the raise method of the event, or null if none.
+
+ The raise method, or null if none.
+
+
+
+ Gets the remove method of the event, or null if none.
+
+ The remove method, or null if none.
+
+
+
+ Gets the event handler type.
+
+
+
+
+ A
+
+
+ This wrapper enables reflection-based algorithms to be used against
+ code that may or may not be loaded into the current AppDomain.
+ For example, the target of the wrapper could be an in-memory
+ code model representation.
+
+
+
+
+
+ A slot represents a field, property or parameter. It is used to
+ simplify the handling of data binding since all three of these types
+ are similar in that they can hold values of some type.
+
+
+
+
+ Gets the type of value held in the slot.
+
+
+
+
+ Gets the positional index of a method parameter slot, -1 if the
+ slot is a method return parameter, or 0 if the slot is of some other kind.
+
+
+
+
+ Resolves the wrapper to its native reflection target.
+
+ The native reflection target.
+ Thrown if the target cannot be resolved.
+
+
+
+ Gets the field attributes.
+
+
+
+
+ Returns true if the field is a literal set at compile time.
+
+
+
+
+ Returns true if the field is read-only and can only be set from the constructor.
+
+
+
+
+ Returns true if the field is static.
+
+
+
+
+ Gets a value indicating whether this field has Assembly level visibility.
+
+
+
+
+ Gets a value indicating whether this field has Family level visibility.
+
+
+
+
+ Gets a value indicating whether this field has FamilyAndAssembly level visibility.
+
+
+
+
+ Gets a value indicating whether this field has FamilyOrAssembly level visibility.
+
+
+
+
+ Gets a value indicating whether the field is private.
+
+
+
+
+ Gets a value indicating whether the field is public.
+
+
+
+
+ A
+
+
+ This wrapper enables reflection-based algorithms to be used against
+ code that may or may not be loaded into the current AppDomain.
+ For example, the target of the wrapper could be an in-memory
+ code model representation.
+
+
+
+
+
+ A
+
+
+ This wrapper enables reflection-based algorithms to be used against
+ code that may or may not be loaded into the current AppDomain.
+ For example, the target of the wrapper could be an in-memory
+ code model representation.
+
+
+
+
+
+ Gets all constructors of the type that satisfy the binding flags.
+
+ The constructors.
+
+
+
+ Gets a method by name, or null if not found.
+
+ The method.
+
+
+
+ Gets all methods of the type that satisfy the binding flags.
+
+ The methods.
+
+
+
+ Gets a property by name, or null if not found.
+
+ The property.
+
+
+
+ Gets all properties of the type that satisfy the binding flags.
+
+ The properties.
+
+
+
+ Gets a field by name, or null if not found.
+
+ The property.
+
+
+
+ Gets all fields of the type that satisfy the binding flags.
+
+ The fields.
+
+
+
+ Gets a event by name, or null if not found.
+
+ The event.
+
+
+
+ Gets all events of the type that satisfy the binding flags.
+
+ The events.
+
+
+
+ Gets a nested type by name, or null if not found.
+
+ The nested type.
+
+
+
+ Gets all nested types of the type that satisfy the binding flags.
+
+ The nested types.
+
+
+
+ Returns true if variables of this type can be assigned with values of the specified type.
+
+ True if the other type is not null and this type is assignable from the other type.
+
+
+
+ Returns true if this type is a subclass of the specified type.
+
+ True if the other type is not null, this type is a subclass of the other type,
+ and this type not the same as the other type.
+
+
+
+ Makes an array type of the specified rank.
+
+ The array type.
+
+
+
+ Makes a pointer type.
+
+ The pointer type.
+
+
+
+ Makes a reference type.
+
+ The reference type.
+
+
+
+ Makes a generic type instantiation.
+
+ The generic type instantiation.
+
+
+
+ Resolves the wrapper to its native reflection target.
+
+ The native reflection target.
+ Thrown if the target cannot be resolved.
+
+
+
+ Gets the assembly in which the type is declared.
+
+
+
+
+ Gets the namespace in which the type is declared.
+
+
+
+ If the type does not have a namespace, returns an object whose name is an empty string.
+ This is different from the behavior of
+
+
+
+
+ Gets the name of the namespace in which the type is declared.
+
+
+
+ If the type does not have a namespace, returns an empty string.
+ This is different from the behavior of
+
+
+
+
+ Gets the base type of the type, or null if none.
+
+
+
+
+ Gets the assembly-qualified name of the type, or null if the type is a generic parameter.
+
+
+
+
+ Gets the full name of the type, or null if the type is a generic parameter.
+
+
+
+
+ Gets the type attributes.
+
+
+
+
+ Returns true if the type is abstract and must be overridden.
+
+
+
+
+ Returns true if the type is sealed.
+
+
+
+
+ Returns true if the type is a class.
+
+
+
+
+ Returns true if the type is an interface.
+
+
+
+
+ Returns true if the type represents an enumeration.
+
+
+
+
+ Returns true if the type is a value type.
+
+
+
+
+ Returns true if the type is nested.
+
+
+
+
+ Returns true if the type is nested and is visible only within its own assembly.
+
+
+
+
+ Returns true if the type is nested and visible only to classes that belong to both its own family and its own assembly.
+
+
+
+
+ Returns true if the type is nested and visible only within its own family.
+
+
+
+
+ Returns true if the type is nested and visible only to classes that belong to either its own family or to its own assembly.
+
+
+
+
+ Returns true if the type is nested and declared private.
+
+
+
+
+ Returns true if the type is nested and declared public.
+
+
+
+
+ Returns true if the type is declared public.
+
+
+
+
+ Returns true if the type is not declared public.
+
+
+
+
+ Returns true if the type represents an array.
+
+
+
+
+ Returns true if the type represents a pointer.
+
+
+
+
+ Returns true if the type represents a type that is passed by reference.
+
+
+
+
+ Returns true if the type represents a generic type parameter.
+
+
+
+
+ Returns true if the type is a generic type.
+ If so, the
+
+
+
+ Returns true if the type is a generic type definition.
+
+
+
+
+ Returns true if the type contains unbound generic parameters.
+ If so, the
+
+
+
+ Gets the generic arguments of the type.
+ The list may contain
+ The generic arguments, or an empty list if there are none.
+
+
+
+ Gets the generic type definition of this type, or null if the type is not generic.
+
+
+
+
+ Gets the rank of the array type.
+
+ Thrown if the type is not an array type.
+
+
+
+ Gets the type's
+
+
+
+ Gets all of the type's interfaces.
+
+ The type's interfaces.
+
+
+
+ Gets the element type of an array, pointer or byref type, or null if none.
+
+
+
+
+ Gets the generic parameter attributes.
+
+
+
+
+ Gets the declaring generic method of a generic method parameter
+ or null for a generic type parameter.
+
+
+
+
+ Gets the constraints of the generic parameter.
+
+
+
+
+ A
+
+
+ This wrapper enables reflection-based algorithms to be used against
+ code that may or may not be loaded into the current AppDomain.
+ For example, the target of the wrapper could be an in-memory
+ code model representation.
+
+
+
+
+
+ Makes a generic method instantiation.
+
+ The generic method instantiation.
+
+
+
+ Resolves the wrapper to its native reflection target.
+
+ The native reflection target.
+ Thrown if the target cannot be resolved.
+
+
+
+ Returns true if the method is a generic method.
+ If so, the
+
+
+
+ Returns true if the method is a generic method definition.
+
+
+
+
+ Returns true if the method contains unbound generic parameters.
+ If so, the
+
+
+
+ Gets the generic arguments of the method.
+ The list may contain
+ The generic arguments.
+
+
+
+ Gets the generic method definition of this method, or null if the method is not generic.
+
+
+
+
+ Gets the method return type.
+
+
+
+
+ Gets the method return parameter object that contains information
+ about the return value and its attributes.
+
+
+
+
+ A base reflection policy implementation that performs argument validation.
+
+
+
+
+ A reflection policy provides access to top-level reflection resources
+ such as assemblies.
+
+
+
+
+ Loads an assembly by name.
+
+ The loaded assembly.
+ Thrown if
+ Thrown if the assembly could not be loaded for any reason.
+
+
+
+ Loads an assembly from a file.
+
+ The loaded assembly.
+ Thrown if
+ Thrown if the assembly could not be loaded for any reason.
+
+
+
+
+
+
+
+ Loads an assembly.
+
+ The loaded assembly wrapper.
+ Any exception may be thrown if the loading fails.
+
+
+
+ Loads an assembly from a file.
+
+ The loaded assembly wrapper.
+ Any exception may be thrown if the loading fails.
+
+
+
+ The static reflection policy base class is intended to assist with the implementation
+ of custom reflection policies defined over static metadata.
+
+
+
+ It flattens out the code element hierarchy to ease implementation of new policies.
+ It provides a mechanism for handling generic type substitutions to ensure a consistent and
+ correct implementation of generic type and generic method instantiations.
+
+
+ Reflection policy subclasses should not perform generic type substitutions themselves.
+ The rest of the infrastructure will take care of these details automatically. However
+
+
+
+
+
+ Determines if two wrappers represent the same object.
+
+ True if both wrapper represent the same object.
+
+
+
+ Gets a hashcode for a wrapper.
+
+ The wrapper's hash code.
+
+
+
+ Gets the custom attributes of an assembly.
+
+ The attributes.
+
+
+
+ Gets the name of an assembly.
+
+ The assembly name.
+
+
+
+ Gets the path of an assembly.
+
+ The assembly path.
+
+
+
+ Gets the references of an assembly.
+
+ The assembly references.
+
+
+
+ Gets the public types exported by an assembly.
+
+ The types.
+
+
+
+ Gets all types contained in an assembly.
+
+ The types.
+
+
+
+ Gets the specified named type within an assembly.
+
+ The type, or null if none.
+
+
+
+ Gets the constructor of an attribute.
+
+ The constructor.
+
+
+
+ Gets the constructor arguments of an attribute.
+
+ The constructor argument values.
+
+
+
+ Gets the field arguments of an attribute.
+
+ The field argument values.
+
+
+
+ Gets the property arguments of an attribute.
+
+ The property argument values.
+
+
+
+ Gets the custom attributes of a member.
+
+ The custom attributes.
+
+
+
+ Gets the short name of a member.
+ In the case of a generic type, should exclude the generic parameter count
+ part of the name. eg. "`1"
+
+ The member's name.
+
+
+
+ Gets the source code location of a member.
+
+ The source code location, or
+
+
+
+ Gets the attributes of an event.
+
+ The event attributes.
+
+
+
+ Gets the add method of an event, or null if none.
+
+ The add method, or null if none.
+
+
+
+ Gets the raise method of an event, or null if none.
+
+ The raise method, or null if none.
+
+
+
+ Gets the remove method of an event, or null if none.
+
+ The remove method, or null if none.
+
+
+
+ Gets the event handler type of an event.
+
+ The event handler type.
+
+
+
+ Gets the attributes of a field.
+
+ The field attributes.
+
+
+
+ Gets the field type.
+
+ The field type.
+
+
+
+ Gets the attributes of a property.
+
+ The property attributes.
+
+
+
+ Gets the property type.
+
+ The property type.
+
+
+
+ Gets the get method of a property, or null if none.
+
+ The get method, or null if none.
+
+
+
+ Gets the set method of a property, or null if none.
+
+ The set method, or null if none.
+
+
+
+ Gets the attributes of a function.
+
+ The function attributes.
+
+
+
+ Gets the calling conventions of a function.
+
+ The function calling conventions.
+
+
+
+ Gets the parameters of a function.
+
+ The parameters.
+
+
+
+ Gets the generic parameters of a method.
+
+ The generic parameters.
+
+
+
+ Gets the return parameter of a method.
+
+ The return parameter.
+
+
+
+ Gets the attributes of a parameter.
+
+ The parameter attributes.
+
+
+
+ Gets the custom attributes of a parameter.
+
+ The custom attributes.
+
+
+
+ Gets the name of a parameter.
+
+ The parameter's name.
+
+
+
+ Gets the parameter's position, or -1 if the parameter is a return value.
+
+ The parameter's position.
+
+
+
+ Gets the parameter type.
+
+ The parameter type.
+
+
+
+ Gets the attributes of a type.
+
+ The type attributes.
+
+
+
+ Gets the assembly that contains a type.
+
+ The type's assembly.
+
+
+
+ Gets the namespace that contains a type.
+
+ The type's namespace, or an empty string if it has none.
+
+
+
+ Gets the base type of atype.
+
+ The base type.
+
+
+
+ Gets the interfaces directly implemented by a type.
+
+ The type's interfaces.
+
+
+
+ Gets the generic parameters of a type, including all generic parameters
+ of its declaring types if it is nested enumerated from outside in.
+
+ The type's generic parameters.
+
+
+
+ Gets the constructors of a type.
+ Only includes declared methods, not inherited ones.
+
+ The type's constructors.
+
+
+
+ Gets the methods of a type including accessor methods for properties and events.
+ Only includes declared methods, not inherited ones.
+
+ The type's methods.
+
+
+
+ Gets the properties of a type.
+ Only includes declared methods, not inherited ones.
+
+ The type's properties.
+
+
+
+ Gets the fields of a type.
+ Only includes declared methods, not inherited ones.
+
+ The type's fields.
+
+
+
+ Gets the events of a type.
+ Only includes declared methods, not inherited ones.
+
+ The type's events.
+
+
+
+ Gets the nested types of a type.
+ Only includes declared nested types, not inherited ones.
+
+ The type's nested types.
+
+
+
+ Gets the attributes of a generic parameter.
+
+ The generic parameter attributes.
+
+
+
+ Gets the generic parameter position.
+
+ The generic parameter position.
+
+
+
+ Gets the generic parameter constraints.
+
+ The generic parameter constraints.
+
+
+
+ Hack to provide access to the internal structure of Cecil attributes.
+ The standard interface makes it impossible to extract arrays and types.
+
+
+
+
+ Resolves debug symbols via the CorMetaDataDispenser COM class.
+
+
+
+ This code has been adapted from the
+
+ CLR Managed Debugger sample and from
+ Mike Stall's PDB2Xml program sample . Many thanks to you!
+
+
+ We do not use the ISymWrapper implementation of the symbol store interfaces because
+ they throw COMExceptions whenever method metadata is not available. This causes
+ confusion for users because the Visual Studio Debugger Exception Assistant window
+ may pop up dozens of times while loading symbol information.
+
+
+
+
+
+ Creates a COM debug symbol resolver.
+
+
+
+
+
+
+
+
+ Helpers for working with
+
+
+
+ Creates a new debug symbol resolver appropriate for this platform.
+
+ The debug symbol resolver.
+
+
+
+ Gets the location of a source file that contains the declaration of a type, or
+ unknown if not available.
+
+ The code location, or
+ Thrown if
+
+
+
+ Gets the location of a source file that contains the declaration of a method, or
+ unknown if not available.
+
+ The source location, or
+ Thrown if
+
+
+
+ Gets the singleton debug symbol resolver used by these utilities.
+
+
+ Because this resolver is a singleton, it's important to remember that it will
+ remain in memory for the lifetime of the process. If you only need to load
+ symbols for a short time and then discard them, use
+
+
+
+ The default XML documentation resolver reads XML documentation files on
+ demand when available and caches them in memory for subsequent accesses.
+ It takes care of mapping member names to XML documentation conventions
+ when asked to resolve the documentation for a member.
+
+
+
+ All operations are thread-safe.
+
+
+
+
+
+ Resolves members to XML documentation contents.
+
+
+
+
+ Gets the XML documentation for a member in an assembly.
+
+ The XML documentation for the member, or null if none available.
+ Thrown if
+
+
+
+ Creates an XML documentation loader.
+
+
+
+
+
+
+ The XML documentation gets pretty-printed with indentation by the compiler.
+ We try to recover the original formatting by stripping out the minimal leading
+ whitespace from each line.
+
+
+
+
+ This extension of
+
+
+
+ Resolves the wrapper to its native reflection target within the scope
+ of the specified method.
+
+ The native reflection target.
+ Thrown if the target cannot be resolved.
+
+
+
+ Implementation of a debug symbol resolver for Mono.
+
+
+
+
+ Creates a Mono debug symbol resolver.
+
+
+
+
+
+
+
+
+ Wrapper to represent a namespace.
+
+
+
+
+ A namespace reflection wrapper identified by its name.
+
+
+
+ This wrapper enables reflection-based algorithms to be used against
+ code that may or may not be loaded into the current AppDomain.
+ For example, the target of the wrapper could be an in-memory
+ code model representation.
+
+
+
+
+
+ Constructor.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ A
+
+
+ This wrapper enables reflection-based algorithms to be used against
+ code that may or may not be loaded into the current AppDomain.
+ For example, the target of the wrapper could be an in-memory
+ code model representation.
+
+
+
+
+
+ Resolves the wrapper to its native reflection target.
+
+ The native reflection target.
+ Thrown if the target cannot be resolved.
+
+
+
+ Gets the member to which the parameter belongs.
+
+
+
+
+ Gets the parameter attributes.
+
+
+
+
+ Gets a value indicating whether this is an input parameter.
+
+
+
+
+ Gets a value indicating whether this parameter is optional.
+
+
+
+
+ Gets a value indicating whether this is an output parameter.
+
+
+
+
+ A
+
+
+ This wrapper enables reflection-based algorithms to be used against
+ code that may or may not be loaded into the current AppDomain.
+ For example, the target of the wrapper could be an in-memory
+ code model representation.
+
+
+
+
+
+ Resolves the wrapper to its native reflection target.
+
+ The native reflection target.
+ Thrown if the target cannot be resolved.
+
+
+
+ Gets the property attributes.
+
+
+
+
+ Returns true if the property can be read.
+
+
+
+
+ Returns true if the property can be written.
+
+
+
+
+ Gets the get method of the property, or null if none.
+
+ The get method, or null if none.
+
+
+
+ Gets the set method of the property, or null if none.
+
+ The set method, or null if none.
+
+
+
+ Gets the list of index parameters for an indexer property, or
+ an empty array if none.
+
+
+
+
+ Provides helpers for enumerating attributes taking into account
+ the attribute inheritance structure.
+
+
+
+ This class is intended to assist with the implementation of new
+ reflection policies. It should not be used directly by clients of the
+ reflection API.
+
+
+
+
+
+ Creates an attribute instance from an
+
+
+ This method may be used by
+
+ The attribute instance.
+ Thrown if the attribute could not be resolved.
+
+
+
+ Returns true if the field is assignable as a named attribute parameter.
+
+ True if the field is assignable.
+
+
+
+ Returns true if the property is assignable as a named attribute parameter.
+
+ True if the property is assignable.
+
+
+
+ Provides helpers for manipulating reflection flags enumerations.
+
+
+
+ This class is intended to assist with the implementation of new
+ reflection policies. It should not be used directly by clients of the
+ reflection API.
+
+
+
+
+
+ Adds
+
+
+
+ Adds
+
+
+
+ Adds
+
+
+
+ Adds
+
+
+
+ Adds
+
+
+
+ Adds
+
+
+
+ Adds
+
+
+
+ Provides helpers for resolving abstract reflection objects to obtain
+ native ones based on the structural properties of the reflected
+ code elements.
+
+
+
+ This class is intended to assist with the implementation of new
+ reflection policies. It should not be used directly by clients of the
+ reflection API.
+
+
+
+
+
+ Resolves a reflected assembly to its native
+ The resolved
+ Thrown if
+ Thrown if
+
+
+
+ Resolves a reflected type to its native
+ The resolved
+ Thrown if
+ Thrown if
+
+
+
+ Resolves a reflected field to its native
+ The resolved
+ Thrown if
+ Thrown if
+
+
+
+ Resolves a reflected property to its native
+ The resolved
+ Thrown if
+ Thrown if
+
+
+
+ Resolves a reflected event to its native
+ The resolved
+ Thrown if
+ Thrown if
+
+
+
+ Resolves a reflected constructor to its native
+ The resolved
+ Thrown if
+ Thrown if
+
+
+
+ Resolves a reflected method to its native
+ The resolved
+ Thrown if
+ Thrown if
+
+
+
+ Resolves a reflected parameter to its native
+ The resolved
+ Thrown if
+ Thrown if
+
+
+
+ Provides helpers for working with types and type codes.
+
+
+
+ This class is intended to assist with the implementation of new
+ reflection policies. It should not be used directly by clients of the
+ reflection API.
+
+
+
+
+
+ Determines the type code of a reflected type based on the
+ type's name.
+
+ The type code of the type, or
+
+
+
+ Gets the default value for a reflected type.
+
+ The default value for the type, such as 0 if
+ the type represents an integer, or null if the type
+ is a reference type or if
+
+
+
+ A
+
+
+
+ A
+
+
+
+ A
+
+
+
+ A
+
+
+
+ A
+
+
+
+ A
+
+
+
+ A
+
+
+ A wrapper holds an underlying reflection object. Its behavior is
+ derived from by primitive operations on the
+
+
+
+
+ Creates a wrapper.
+
+ Thrown if
+
+
+
+
+
+
+
+ Compares the policy and handle of this wrapper with those of another
+ using
+
+
+
+
+
+ Gets the reflection policy.
+
+
+
+
+ Gets the underlying reflection object.
+
+
+
+
+ Creates a wrapper.
+
+ Thrown if
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Gets all attributes that appear on this code element, excluding inherited attributes.
+
+ The attribute wrappers.
+
+
+
+ Gets all pseudo custom attributes associated with a member.
+
+
+
+ These attributes do not really exist as custom attributes in the metadata. Rather, they are
+ realizations of other metadata features in attribute form. For example,
+
+
+ The pseudo custom attributes.
+
+
+
+ Gets an enumeration of elements from which this code element inherits.
+
+ The inherited code elements.
+
+
+
+ Appends a list of parameters to a signature.
+
+
+
+
+ Appends a list of generic parameters to a signature.
+
+
+
+
+ Gets the name of a type for use in a ToString signature of an event, field,
+ property, method, or constructor.
+
+
+
+
+ Determines whether a type should be represented by its short name
+ for the purposes of creating a signature.
+
+ True if the type is primitive.
+
+
+
+
+
+
+
+
+
+ Creates a wrapper.
+
+ Thrown if
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Implementation of
+
+
+
+ Gets the type substitution for generic parameters.
+
+
+
+
+
+
+
+
+ Gets the declaring type, or null if none.
+
+
+
+
+ Gets the reflected type, or null if none.
+
+
+
+
+ Creates a wrapper.
+
+ Thrown if
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Applies a type substitution and returns the resulting type.
+
+ The type after substitution has been performed.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Internal implementation of
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Gets the element type, or null if none.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Creates a wrapper.
+
+ Thrown if
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Creates a wrapper.
+
+ Thrown if
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Gets the suffix to append to the name of the constructed type.
+
+
+
+
+ Creates a wrapper.
+
+ Thrown if
+ Thrown if
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ A
+
+
+
+ Creates a wrapper.
+
+ Thrown if
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Returns true if the internal members of this assembly are visible to the specified assembly.
+
+ True if the other assembly can see internal members of this assembly.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ A
+
+
+
+ Creates a wrapper.
+
+ Thrown if
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ A
+
+
+
+ Creates a wrapper.
+
+ Thrown if
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ A
+
+
+
+ A
+
+
+
+ A
+
+
+
+ Creates a wrapper.
+
+ Thrown if
+
+
+
+
+
+ Creates a wrapper.
+
+ Thrown if
+
+
+
+
+
+ Implementation of
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Creates a wrapper.
+
+ Thrown if
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ A
+
+
+
+ Creates a wrapper.
+
+ Thrown if
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Gets an enumeration of all base types.
+
+ The enumeration of base types.
+
+
+
+ Composes the substitution of the type with the specified substitution and returns a new wrapper.
+
+ The new wrapper with the composed substitution.
+
+
+
+
+
+
+
+ The .Net framework handles several built-in types in a special way. Basically,
+ to inheritors, certain 'extern' private methods appear to vanish. We deal
+ with those cases uniformly here. There may yet be others!
+
+
+
+
+
+
+
+
+
+
+
+
+ Gets the base type, or null if none.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ A
+
+
+
+ Creates a wrapper.
+
+ Thrown if
+
+
+
+ Gets the events that this one overrides or hides.
+ Only includes overrides that appear on class types, not interfaces.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ A
+
+
+
+ Creates a wrapper.
+
+ Thrown if
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ A
+
+
+
+ Creates a wrapper for a generic type parameter.
+
+ Thrown if
+
+
+
+ Creates a wrapper for a generic method parameter.
+
+ Thrown if
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Gets the declaring method, or null if the generic parameter belongs to a type.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ A
+
+
+
+ Creates a wrapper.
+
+ Thrown if
+
+
+
+ Gets the methods that this one overrides or hides.
+ Only includes overrides that appear on class types, not interfaces.
+
+
+
+
+ Returns true if this method hides the specified method.
+
+
+
+ This method assumes that
+
+ True if this method hides the other method.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Returns true if this method overrides another.
+
+
+
+
+ A
+
+
+
+ Creates a wrapper.
+
+ Thrown if
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Gets the member to which the parameter belongs.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ A
+
+
+
+ Creates a wrapper.
+
+ Thrown if
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ A
+
+
+
+ Creates a wrapper.
+
+ Thrown if
+
+
+
+ Gets the properties that this one overrides or hides.
+ Only includes overrides that appear on class types, not interfaces.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ A type substitution specifies how generic parameters are replaced by other types.
+ It is used by implementors of
+
+
+
+ Gets the empty type substitution.
+
+
+
+
+ Applies a type substitution to the specified type.
+
+ The substituted type.
+ Thrown if
+
+
+
+ Applies a type substitution to the specified generic parameter.
+
+ The substituted type.
+ Thrown if
+
+
+
+ Applies a type substitution to the specified list of types.
+
+ The substituted types.
+ Thrown if
+
+
+
+ Returns a new substitution with the specified generic parameters replaced by their respective generic arguments.
+
+
+
+ The extended type substitution is normalized so that generic parameters that
+ are idempotently replaced with themselves are excluded from the substitution altogether.
+
+
+ The resulting substitution.
+ Thrown if
+ Thrown if
+
+
+
+ Returns a new substitution formed by composing this substitution with the specified one.
+ That is to say, each replacement type in this substitution is replaced as described
+ in the specified substitution.
+
+ The new substitution.
+
+
+
+ Returns true if this substitution does not contain any of the specified generic parameters.
+
+ True if none of the generic parameters are in the substitution.
+ Thrown if
+
+
+
+ Compares two static type substitutions for equality.
+
+ True if the substitutions are equal.
+
+
+
+ Compares two static type substitutions for inequality.
+
+ True if the substitutions are equal.
+
+
+
+
+
+
+
+
+
+ Returns true if the type substitution does not contain any replacements.
+
+
+
+
+ Helpers for working with
+
+
+
+ Gets the XML documentation for a member.
+
+ The XML documentation for the member, or null if none available.
+ Thrown if
+
+
+
+ Gets the XML documentation id of a member.
+
+ The XML documentation id of the member.
+ Thrown if
+
+
+
+ Gets the XML documentation resolver.
+
+
+
+
+ This assembly loader loads assemblies externally for reflection only.
+
+
+
+ This implementation ensures that the assembly files do not remain locked on disk and are not
+ cached in memory outside of the scope of the loader. Consequently the Garbage Collector will
+ automatically reclaim the loader and its contents when they become unreferenced.
+
+
+ In contrast, that of the standard .Net reflection-only load context
+ (
+
+ The loader considers all assemblies in the specified search path as well as any that
+ can be located using the current AppDomain's assembly resolvers.
+
+
+
+
+
+ Creates an assembly loader.
+
+
+
+
+ Adds a hint directory to search for loading assemblies.
+
+ Thrown if
+
+
+
+ Gets the reflection policy used to load and access the assemblies.
+
+
+
+
+ The type of exception thrown when a reflection info object or reference cannot
+ be resolved.
+
+
+
+
+ Creates an exception.
+
+
+
+
+ Creates an exception.
+
+
+
+
+ Creates an exception.
+
+
+
+
+ Creates an exception for a code element that could not be resolved.
+
+ Thrown if
+
+
+
+ Creates an exception for a code element that could not be resolved.
+
+ Thrown if
+
+
+
+ Creates an exception for an attribute that could not be resolved.
+
+ Thrown if
+
+
+
+ Creates an exception for an attribute that could not be resolved.
+
+ Thrown if
+
+
+
+ Creates an exception from serialization info.
+
+
+
+
+ Provides functions for working with reflection.
+
+
+
+
+ Gets the assembly that declares the code element, or the
+ code element itself if it is an
+ The assembly, or null if not found.
+
+
+
+ Gets the namespace that declares the code element, or the
+ code element itself if it is an
+ The namespace, or null if not found.
+
+
+
+ Gets the type that declares the code element, or the
+ code element itself if it is an
+ The type, or null if not found.
+
+
+
+ Gets the non-type member that declares the code element, or the
+ code element itself if it is an
+ The member, or null if not found.
+
+
+
+ Gets the parameter that declares the code element, or the
+ code element itself if it is an
+ The parameter, or null if not found.
+
+
+
+ Finds the assembly name of the directly referenced assembly with the specified display name.
+
+ The referenced assembly name or null if none.
+
+
+
+ Determines if the type can be instantiated using a public constructor.
+
+ True if the type can be instantiated.
+
+
+
+ Determines if the method is public, non-static and is non-abstract so it can be invoked.
+
+ True if the method can be invoked.
+
+
+
+ Determines if the property has public, non-static and non-abstract getter
+ and setter functions.
+
+ True if the property can be get and set.
+
+
+
+ Returns true if a type is derived from another type with the specified qualified name.
+
+ True if
+
+
+
+ Gets the default value for a type.
+
+ The default value for the type, such as 0 if
+ the type represents an integer, or null if the type
+ is a reference type or if
+
+
+
+ Gets the default value of a type with a given type code.
+
+ The default value of the type associated with the
+ specified type code.
+
+
+
+ Returns true if the named type is assignable from the specified type.
+
+ True if the search type is assignable from the candidate type.
+ Thrown if
+
+
+
+ Workaround for a bug in
+
+ https://connect.microsoft.com/VisualStudio/feedback/ViewFeedback.aspx?FeedbackID=522960
+
+
+
+
+ Determines whether the specified type represents a nullable value.
+
+ True if it is nullable; otherwise false.
+
+
+
+ Wraps reflection types using the reflection adapter interfaces.
+ Also resolves code references.
+
+
+
+
+ Resolves the specified
+ The associated code element, or null if the code reference
+ is of kind
+ Thrown if
+
+
+
+ Obtains a reflection wrapper for an assembly.
+
+ The reflection wrapper, or null if none.
+
+
+
+ Obtains a reflection wrapper for a namespace.
+
+ The reflection wrapper, or null if none.
+
+
+
+ Obtains a reflection wrapper for a type.
+
+ The reflection wrapper, or null if none.
+
+
+
+ Obtains a reflection wrapper for a list of types.
+
+ The reflection wrappers, or null original list was null.
+
+
+
+ Obtains a reflection wrapper for a member.
+
+ The reflection wrapper, or null if none.
+
+
+
+ Obtains a reflection wrapper for a function.
+
+ The reflection wrapper, or null if none.
+
+
+
+ Obtains a reflection wrapper for a constructor.
+
+ The reflection wrapper, or null if none.
+
+
+
+ Obtains a reflection wrapper for a method.
+
+ The reflection wrapper, or null if none.
+
+
+
+ Obtains a reflection wrapper for a property.
+
+ The reflection wrapper, or null if none.
+
+
+
+ Obtains a reflection wrapper for a field.
+
+ The reflection wrapper, or null if none.
+
+
+
+ Obtains a reflection wrapper for an event.
+
+ The reflection wrapper, or null if none.
+
+
+
+ Obtains a reflection wrapper for a parameter.
+
+ The reflection wrapper, or null if none.
+
+
+
+ Obtains a reflection wrapper for an attribute instance.
+
+ The reflection wrapper, or null if none.
+
+
+
+ Creates a code element from the executing function.
+
+
+
+ This information may be unreliable if the compiler has inlined
+ the executing method into its caller because the stack frame
+ information will be incomplete. This can can occur when compiler
+ optimizations are turned on and the method body is simple.
+
+
+ The inlining problem can be circumvented like this:
+
+
+ The code reference.
+
+
+
+ Creates a code element from the caller of the executing function.
+
+
+
+ This information may be unreliable if the compiler has inlined
+ the executing or calling method into its caller because the stack frame
+ information will be incomplete. This can can occur when compiler
+ optimizations are turned on and the method body is simple.
+
+
+ The inlining problem can be circumvented like this:
+
+
+ The code reference.
+
+
+
+ Creates a code element representing a function from a particular frame on the current stack.
+
+ The code reference.
+ Thrown if
+
+
+
+ Returns true if the target represents an unresolved assembly with
+ limited support for reflection.
+
+ True if the target is unresolved.
+
+
+
+ Returns true if the target represents an unresolved member with
+ limited support for reflection.
+
+ True if the target is unresolved.
+
+
+
+ Returns true if the target represents an unresolved parameter with
+ limited support for reflection.
+
+ True if the target is unresolved.
+
+
+
+ Gets the singleton instance of the native
+
+
+
+ Describes the name of a type and allows partial type names to be compared with one another.
+
+
+
+
+ Creates a type name from a type.
+
+ Thrown if
+ Thrown if
+
+
+
+ Creates a type name from type info.
+
+ Thrown if
+ Thrown if
+
+
+
+ Creates a type name from its assembly-qualified name.
+
+ Thrown if
+ Thrown if
+
+
+
+ Creates a type name from its full name and assembly name.
+
+ Thrown if
+
+
+
+
+
+
+
+
+
+
+
+ Resolves the type named by this instance.
+
+ The type.
+ Thrown if the type could not be resolved.
+
+
+
+ Returns a type name that has a partial assembly name instead of the full assembly name.
+
+ The type name.
+
+
+
+ Gets the assembly-qualified name of the type, including its namespace and assembly.
+
+
+
+
+ Gets the full name of the type, including its namespace.
+
+
+
+
+ Gets the full or partial name of the assembly that contains the type.
+
+
+
+
+ Returns true if the associated
+
+
+
+ Describes the difference between a range of the left document and a range of the right document.
+
+
+
+ Each diff is accompanied by a
+
+
+
+
+ Creates a diff.
+
+
+
+
+
+
+
+
+
+
+ Returns true if two diffs are equal.
+
+ True if the diffs are equal.
+
+
+
+ Returns true if two diffs are not equal.
+
+ True if the diffs are not equal.
+
+
+
+
+
+ Gets the diff kind which indicateds whether there is a change over the range covered by the diff.
+
+
+
+
+ Gets the range of the left document that is affected.
+
+
+
+
+ Gets the range of the right document that is affected.
+
+
+
+
+ Describes whether a difference represents a changed or unchanged region.
+
+
+
+
+ Indicates there is no change between the left and right documents over the ranges described by the diff.
+
+
+
+
+ Indicates there is a change between the left and right documents over the ranges described by the diff.
+ Text may have been added, removed, or edited.
+
+
+
+
+ A diff set consists of a sequence of differences between a left document and a right document
+ that indicate changed and unchanged regions.
+
+
+
+ If the changes are applied in order to the left document, the right document will be
+ reproduced. If the inverse changes are applied in order to the right document, the
+ left document will be reproduced.
+
+
+ This implementation is based on Myers' O((M + N) * D) time and O(M + N) space algorithm
+ for computing the longest common subsequence from his paper
+ "An O(ND) Difference Algorithm and Its Variations."
+ (http://citeseer.ist.psu.edu/myers86ond.html)
+
+
+ There were two other sources for inspiration although this implementation is not
+ a direct port of either of them.
+
+ - The org.eclipse.compare.internal.LCS class in Eclipse (http://www.eclipse.org) from
+ which we borrow the concept of limiting the number of differences to produce an approximate
+ result with a reduced time bound for large data sets. Since the Eclipse implementation
+ of the LCS follows Myers' algorithm pretty closely, it was also very useful as a point
+ of comparison for finding bugs.
+ - Neil Fraser's "Diff Match and Patch" algorithm (http://code.google.com/p/google-diff-match-patch/).
+ We borrow some ideas about semantic cleanup from here.
+
+
+
+
+
+
+ Constructs a diff set.
+
+ Thrown if
+ Thrown if
+
+
+
+ Gets the set of differences between a left document and a right document.
+
+ The set of differences.
+ Thrown if
+
+
+
+ Writes the diffs using the
+
+
+ For the purposes of determining additions and deletions, the left document
+ is considered the original and the right document is the considered to be the
+ one that was modified. Changes are annotated by markers:
+ by
+
+ Thrown if
+
+
+
+ Writes the diffs using the specified
+ presentation style and no limits on the context length.
+
+
+
+ Changes are annotated by markers:
+
+ If the style is
+
+ If the style is
+
+ Thrown if
+
+
+
+ Writes the diffs using the specified presentation style and max context length.
+
+
+
+ Changes are annotated by markers:
+
+ If the style is
+
+ If the style is
+
+ Thrown if
+ Thrown if
+
+
+
+ Simplifies the diff for presentation.
+
+
+
+ This method applies a series of heuristics to make the diff easier to read
+ but perhaps less optimal, including the following:
+
+ - Adjacent diffs of the same kind are combined.
+ - Small unchanged regions sandwiched between larger changed regions are
+ converted to larger changed regions. This improves the case when only
+ a few scattered characters coincidentally match between the two documents.
+
+
+
+ Returns a simplified diff.
+
+
+
+ Gets the list of differences that indicate the changed and
+ unchanged regions between the left and right documents.
+
+
+
+ The diffs span the entire range of the left and right documents and are listed in document order.
+
+
+
+
+
+ Gets the left document.
+
+
+
+
+ Gets the right document.
+
+
+
+
+ Returns true if the list of differences contains changed regions.
+
+
+
+
+ Returns true if the list of differences is empty which can only occur when
+ both document being compared are empty.
+
+
+
+
+ Specifies the presentation style for a
+
+
+
+ Display the left and right document contents and diffs fully interleaved.
+
+
+
+
+ Display only the left document contents.
+
+
+
+
+ Display only the right document contents.
+
+
+
+
+ A range denotes a segment of a string or other indexed data structure.
+
+
+
+
+ Creates a range of indices.
+
+ Thrown if
+
+
+
+ Creates a new range between the start index (inclusively) and end index (exclusively).
+
+ The new range.
+ Thrown if
+
+
+
+ Gets a substring of the specified text using this range.
+
+ The substring of the source text that represents this range.
+ Thrown if
+
+
+
+ Extends a range into an adjacent range and returns the combined range.
+
+ The extended range.
+ Thrown if
+
+
+
+
+
+
+
+
+
+ Returns true if two ranges are equal.
+
+ True if the ranges are equal.
+
+
+
+ Returns true if two ranges are not equal.
+
+ True if the ranges are not equal.
+
+
+
+
+
+ Gets the starting index of the range.
+
+
+
+
+ Gets the ending index of the range, which is the start index plus the length.
+ The ending index is one past the last character within the range.
+
+
+
+
+ Gets the length of the range.
+
+
+
+
+ A substring provides a convenient representation for a range within a larger string.
+
+
+
+
+ Creates a substring object defined over the entire range of a string.
+
+ Thrown if
+
+
+
+ Creates a substring object.
+
+ Thrown if
+ Thrown if
+
+
+
+ Returns a substring of the substring.
+
+ The substring.
+ Thrown if
+
+
+
+ Returns a substring of the substring.
+
+ The substring.
+ Thrown if
+
+
+
+ Finds the length of the common prefix of this substring and another one.
+
+ The common prefix length, or 0 if the substrings have no prefix in common.
+
+
+
+ Finds the length of the common suffix of this substring and another one.
+
+ The common suffix length, or 0 if the substrings have no suffix in common.
+
+
+
+
+
+
+
+
+
+
+
+ Returns true if two substrings are equal.
+
+ True if the substrings are equal.
+
+
+
+ Returns true if two substrings are not equal.
+
+ True if the substrings are not equal.
+
+
+
+ Returns the whole string.
+
+
+
+
+ Returns the range of the underlying string represented by the substring.
+
+
+
+
+ Gets the length of the substring.
+
+
+
+
+ Gets the character with a particular index.
+
+ The character.
+ Thrown if the index is out of range.
+
+
+
+ The diagnostic log provides services for writing diagnostic messages to the console
+ or runtime log during a test run.
+
+
+
+ Diagnostic messages will appear in the test report but they are not associated with
+ any particular tests. Unlike
+
+ If you use the diagnostic log to report progress messages, keep in mind that they
+ will all be preserved in the report, making the report larger.
+
+
+
+
+
+ Writes a message to the diagnostic log.
+
+
+
+
+ Writes a formatted message to the diagnostic log.
+
+
+
+
+ An implementation of a test model builder that is used for reflection only and
+ does not actually support building tests.
+
+
+
+
+ A test model builder applies contributions to a test model under construction.
+
+
+
+
+ Provides support for performing deferred build actions.
+
+
+
+
+ Registers a deferred action to be performed when
+
+
+ Typically used to enable decorations to be applied in a particular order.
+
+
+ Thrown if
+
+
+
+ Applies all pending deferred in order and clears the list.
+
+
+
+
+ Adds an annotation to the test model.
+
+ Thrown if
+
+
+
+ Adds an assembly resolver to the test model's assembly loading policy.
+
+ Thrown if
+
+
+
+ Publishes an exception as an annotation about a particular code element.
+
+
+
+
+ Gets the underlying test model.
+
+ The underlying test model.
+
+
+
+ Gets the reflection policy for the model.
+
+
+
+
+ Gets the builder of the root test.
+
+ The builder for the root test.
+
+
+
+ Creates a test model builder.
+
+ Thrown if
+
+
+
+
+
+
+
+ A test builder applies contributions to a test under construction.
+
+
+
+
+ A test component builder applies contributions to a test or test parameter under construction.
+
+
+
+
+ Adds a metadata key value pair.
+
+ Thrown if
+
+
+
+ Gets the underlying test component.
+
+ The underlying test component.
+
+
+
+ Gets the stable unique identifier of the component.
+
+
+
+ The identifier must be unique across all components
+ within a given test project. It should also be stable so that the
+ identifier remains valid across recompilations and code changes that
+ do not alter the underlying declarations (insofar as is possible).
+
+
+ The identifier does not refer to a specific instance of
+
+
+
+
+ Gets or sets the name of the component.
+
+ Thrown if
+
+
+
+ Gets a reference to the point of definition of this test
+ component in the code, or null if unknown.
+
+
+
+
+ Creates a child test and returns its builder.
+
+ The builder for the child test.
+ Thrown if
+
+
+
+ Creates a test parameter and returns its builder.
+
+ The builder for the test parameter.
+ Thrown if
+
+
+
+ Gets a test parameter builder by name.
+
+ The builder for the test parameter, or null if none.
+ Thrown if
+
+
+
+ Adds a test dependency.
+
+ Thrown if
+
+
+
+ Gets the underlying test.
+
+ The underlying test.
+
+
+
+ Gets or sets the value of the
+
+ One of the
+
+
+
+ Gets or sets the apartment state to be used to run the test.
+
+
+
+ If the apartment state is
+
+ The test runner guarantees that the root test runs with the
+
+
+ The default value of this property is
+
+
+
+ Gets or sets the maximum amount of time the whole test including
+ its setup, teardown and body should be permitted to run.
+
+
+
+ If the test runs any longer than this, it will be aborted by the framework.
+ The timeout may be null to indicate the absence of a timeout.
+
+
+ Thrown if
+ The timeout. Default value is null.
+
+
+
+ Gets whether this test represents an individual test case
+ as opposed to a test container such as a fixture or suite.
+
+
+
+ The value of this property can be used by the test harness to avoid processing containers
+ that have no test cases. It can also be used by the reporting infrastructure
+ to constrain output statistics to test cases only.
+
+
+ Not all test cases are leaf nodes in the test tree and vice-versa.
+
+
+ This value is defined as a property rather than as a metadata key because it
+ significantly changes the semantics of test execution.
+
+
+
+
+
+ Gets or sets whether the test is parallelizable.
+
+
+ True if the test is parallelizable. The default value of this property is false .
+
+
+
+
+ Gets or sets a number that defines an ordering for the test with respect to its siblings.
+
+
+
+ Unless compelled otherwise by test dependencies, tests with a lower order number than
+ their siblings will run before those siblings and tests with the same order number
+ as their siblings with run in an arbitrary sequence with respect to those siblings.
+
+
+ Some test frameworks may choose to ignore test order or may impose their own ordering schemes.
+
+
+ The test execution order with respect to siblings, initially zero.
+
+
+
+ Gets a locally unique identifier for this test that satisfies some specific conditions.
+
+
+ The local identifier must satisfy the following conditions:
+
+
+ - The identifier is unique among all siblings of this test belonging to the same parent.
+ - The identifier is likely to be stable across multiple sessions including
+ changes and recompilations of the test projects.
+ - The identifier is non-null.
+
+
+
+ The local identifier may be the same as the test's name. However since the name is
+ intended for display to end-users, it may contain irrelevant details (such as version
+ numbers) that would reduce its long-term stability. In that case, a different
+ local identifier should be selected such as one based on the test's
+
+
+ The locally unique
+
+ The locally unique identifier.
+
+
+
+ Gets or sets a suggested
+
+
+ The value returned by this method will be checked for uniqueness and amended as necessary
+ to produce a truly unique
+
+
+ The default value of this property is null which causes the
+ The local id hint.
+
+
+
+ Gets the set of actions that describe the behavior of the test.
+
+
+
+
+ Gets the set of actions that describe the behavior of the test's instances.
+
+
+
+
+ Provides information about a particular pattern test framework extension.
+
+
+
+
+ Creates an information object.
+
+ Thrown if
+
+
+
+ Gets the unique id of the extension.
+
+
+
+
+ Gets the display name of the extension.
+
+
+
+
+ Gets or sets the extension's test kind which is used to decorate the test
+ assembly test when a test assembly only contains tests that belong to one
+ particular framework. May be null if none.
+
+
+
+
+ This exception type is used to signal that a test has been terminated with
+ a particular outcome.
+
+
+
+ The exception message, if present, should explain the reason that the test was terminated.
+
+
+
+
+
+ This exception type is an abstract base class for exceptions that are used to
+ explicitly signal the outcome of a test.
+
+
+
+ The test framework uses the value of the
+
+
+
+
+ Creates an exception.
+
+
+
+
+ Creates an exception.
+
+
+
+
+ Creates an exception.
+
+
+
+
+ Creates an exception from serialization info.
+
+
+
+
+
+
+ Returns true if the test exception has a non-default message
+
+
+
+ The message parameter was not null in the constructor arguments.
+
+
+
+
+
+ Gets the outcome of the test.
+
+
+
+
+ Returns true if the outcome and message (if any) should be used but the exception
+ stack trace should not be logged.
+
+
+
+
+ Creates a silent test exception with the specified outcome.
+
+
+
+
+ Creates a silent test exception with the specified outcome.
+
+
+
+
+ Creates an exception.
+
+
+
+
+ Creates a exception from serialization info.
+
+
+
+
+
+
+
+
+ Abstract base class for typical builder implementations.
+
+
+
+
+
+
+
+
+ Gets the test model builder.
+
+ The test model builder.
+
+
+
+ Default implementation of a test model builder.
+
+
+
+
+ Abstract base class for test component builders.
+
+
+
+
+ Creates a test component builder.
+
+ Thrown if
+
+
+
+
+
+
+
+ Gets the underlying test component.
+
+ The test component.
+
+
+
+
+
+
+
+
+
+
+
+ Creates a test builder.
+
+ Thrown if
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Default implementation of a test data context builder.
+
+
+
+
+ A test data context builder applies contributions to a test data context under construction.
+
+
+
+
+ Defines a new data source within this data context if one does not exist.
+ Otherwise returns the existing one.
+
+ The defined data source.
+ Thrown if
+
+
+
+ Creates a child data context.
+
+ The builder for the child context.
+
+
+
+ Gets the underlying pattern test data context.
+
+ The underlying pattern test data context.
+
+
+
+ Gets or sets the offset to add to a test parameter's implicit data binding index to map it
+ into the containing data context.
+
+
+
+ This property is used to determine the data binding index of a test parameter that
+ has not been explicitly bound. The offsets are summed cumulatively to produce an implicit
+ data binding index while traversing the chain of containing data contexts while locating the
+ first anonymous data source.
+
+
+ For example, suppose Y is the second parameter of a test method. If Y does not
+ have an explicit data binding, we will apply implicit data binding rules as follows.
+
+ - If
Y 's data context contains an anonymous data source, then the implicit data binding index will be 0.
+ - Otherwise, if
Y 's containing data context contains an anonymous data source, then the implicit data
+ binding index will equal the offset specified in Y 's data context: 1 (since it is the second parameter).
+ - Otherwise, we continue searching containing data contexts and summing their offsets until we find an
+ anonymous data source. If none is found, then data binding will fail.
+
+
+
+
+
+
+ Creates a test data context builder.
+
+ Thrown if
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Default implementation of a test model builder.
+
+
+
+
+ Creates a test model builder.
+
+ Thrown if
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Default implementation of a test parameter builder.
+
+
+
+
+ A test builder applies contributions to a test under construction.
+
+
+
+
+ Gets the underlying test parameter.
+
+ The underlying test parameter.
+
+
+
+ Gets the test data context builder for the test parameter.
+
+
+
+
+ Gets the set of actions that describe the behavior of the test parameter.
+
+
+
+
+ Gets or sets the data binder for the parameter.
+
+
+
+ The default value is a
+
+ Thrown if
+
+
+
+ Creates a test parameter builder.
+
+ Thrown if
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Populates components lazily.
+
+
+
+ A populator function takes one parameter to specify a hint for the particular
+ code element whose patterns should be processed to generate components. If the hint
+ is null or unrecognized then the populator should proceed to generate all remaining
+ components.
+
+
+
+
+
+ A pattern test parameter handler provides the logic that implements the various
+ phases of the test parameter binding lifecycle.
+
+
+
+ Each method represents the behavior to be performed during a particular phase.
+ Different actions are permitted during each phase. Consult the
+ documentation the appropriate method of this interface for restrictions.
+
+
+ The phases generally run in the following order. Some phases may be skipped
+ due to exceptions or if there is no work to be done.
+
+ - -- for each test instance --
+ - -- end --
+
+
+
+
+
+
+ Binds a value to a test parameter.
+
+
+
+ The following actions are typically performed during this phase:
+
+ - Associated a value with a slot on the test fixture or test method.
+ - Storing the object for later use during the test run.
+
+
+
+ The following actions are forbidden during this phase because they would
+ either go unnoticed or have undesirable side-effects upon test execution:
+
+ - Modifying the
+ - Modifying the
+
+
+
+
+
+
+ Unbinds a test parameter.
+
+
+
+ The following actions are typically performed during this phase:
+
+ - Releasing any resources used by the test parameter.
+
+
+
+ The following actions are forbidden during this phase because they would
+ either go unnoticed or have undesirable side-effects upon test execution:
+
+ - Modifying the
+ - Modifying the
+
+
+
+
+
+
+ A pattern evaluator maintains state that is needed to interpret patterns.
+
+
+
+ It is used by the
+
+
+
+
+ Registers the scope so that it can be resolved later by
+ Thrown if
+
+
+
+ Finds scopes that are associated with the specified
+ The enumeration of scopes.
+ Thrown if
+
+
+
+ Finds tests that are declared by the specified
+ The enumeration of tests.
+ Thrown if
+
+
+
+ Gets the test parts represented by a code element.
+
+
+
+ If an exception occurs while enumerating the pattern attributes,
+ this method returns an empty array.
+
+
+ The test parts, or an empty array if none.
+
+
+
+ Consumes the specified code element.
+
+
+
+ Any exceptions thrown by a pattern are caught and manifested as annotations
+ associated with the code element.
+
+ Thrown if
+
+
+
+ Processes the specified code element.
+
+
+
+ Any exceptions thrown by a pattern are caught and manifested as annotations
+ associated with the code element.
+
+ Thrown if
+
+
+
+ Returns true if a code element has one or more associated patterns.
+
+ True if the code element has an associated pattern.
+ Thrown if
+
+
+
+ Gets all patterns associated with a code element.
+
+ The enumeration of patterns, or null if none.
+ Thrown if
+
+
+
+ Gets the primary pattern associated with a code element, or null if none.
+
+ The primary pattern, or null if none.
+ Thrown if
+ Thrown if there are multiple primary patterns associated with the code element.
+
+
+
+ Gets the builder for the test model under construction.
+
+
+
+
+ Gets the scope of the root test.
+
+ The root scope.
+
+
+
+ A pattern scope describes the environment in which the pattern is being evaluated.
+
+
+
+ A pattern is always evaluated in some scope which determines its ultimate effect
+ on declarations of tests, test parameters and test data contexts.
+
+
+
+
+
+ Creates and registers a scope for a test component.
+
+ The new scope.
+ Thrown if
+
+
+
+ Creates a child test with its own child data context derived from the
+ builders of this scope. Returns the scope of the newly created child test.
+
+ The scope of the newly created child test.
+ Thrown if
+ Thrown if
+
+
+
+ Creates a test parameter for the test in scope with its own
+ child data context derived from the builders of this scope. Returns
+ the scope of the newly created test parameter.
+
+ The scope of the newly created test parameter.
+ Thrown if
+ Thrown if
+
+
+
+ Creates a child test data context derived from the builders of this scope.
+ Returns the scope of the newly created child test data context.
+
+ The scope of the newly created child test data context.
+
+
+
+ Adds an action to the scope that enables a pattern to lazily populate the test model
+ with components generated in nested scopes. This is used when
+
+ Thrown if
+
+
+
+ Asks all registered deferred component populators to build components whose
+ construction had previously been deferred.
+
+
+
+
+ Consumes the specified code element using this scope as the containing scope.
+
+
+
+ This is a convenience method that calls
+
+ Thrown if
+
+
+
+ Processes the specified code element using this scope as the current scope.
+
+
+
+ This is a convenience method that calls
+
+ Thrown if
+
+
+
+ Gets the pattern evaluator.
+
+
+
+
+ Gets the code element associated with the scope, or null if none.
+
+
+
+
+ Returns true if the scope represents a test declaration.
+
+
+
+ An arbitrary scope nested within a test declaration scope is not itself considered a
+ test declaration scope unless it also represents a test declaration.
+
+
+
+
+
+ Returns true if the scope represents a test parameter declaration.
+
+
+
+ An arbitrary scope nested within a test parameter declaration scope is not itself considered a
+ test parameter declaration scope unless it also represents a test parameter declaration.
+
+
+
+
+
+ Returns true if a child test can be added to the test within scope.
+
+
+
+
+ Returns true if a test parameter can be added to the test within scope.
+
+
+
+
+ Gets a builder for applying contributions to the test currently being
+ constructed within this scope. Never null.
+
+
+
+
+ Gets a builder for applying contributions to the test parameter currently being
+ constructed within this scope, if there is one, or null if there is no
+ test parameter in scope.
+
+
+
+
+ Gets a builder for applying contributions to the test component currently being
+ constructed within this scope.
+
+
+
+ The component may be a test or a test parameter. It will never be null.
+
+
+
+
+
+ Gets a builder for applying contributions to the current test data context within the scope.
+
+
+
+ A test data context is essentially a lexically scoped environment for the declaration of
+ data sources used by parameterized tests.
+
+
+ Typically a new data context will be introduced at the point of declaration of a test
+ or test parameter, but it may also be introduced by other lexical scopes. For example,
+ a test fixture constructor may declare a new test data context which provides data sources
+ that can be used for data binding by the constructor's parameters (but are not visible
+ to any other part of the fixture).
+
+
+ Since there is always a test component in scope, the test data context builder can never be null.
+
+
+
+
+
+ Gets a builder for applying contributions to the test model.
+
+
+
+
+ Configures runtime parameters while executing tests within a test assembly.
+
+
+
+
+ Resets the globals to default values.
+
+
+
+
+ Specifies the maximum number of concurrent threads to use when tests are run in parallel.
+
+ The degree of parallelism. Defaults to
+ Thrown if
+
+
+
+ Specifies the default test case timeout or null if none.
+
+ The default timeout for test cases or null if none. Defaults to 10 minutes.
+
+
+
+
+ An implementation of
+
+
+
+
+ Creates a test parameter actions object initially configured with empty action chains
+ that do nothing.
+
+
+
+
+
+
+
+
+ Gets the chain of
+
+
+
+ Gets the chain of
+
+
+
+ A function chain captures a sequence of actions to be performed as
+ part of a complex multi-part process.
+
+ The function argument type.
+ The function result type.
+
+
+
+ Creates a function chain.
+
+ Thrown if
+
+
+
+ Registers a function decorator to perform around all other actions
+ currently in the chain. The contained part of the chain
+ is passed in as a function to the decorator that the decorator
+ can choose to run (or not) as needed.
+
+
+
+ The value of
+
+ Thrown if
+
+
+
+ Gets or sets a representation of the chain as a single function.
+
+
+
+ The function is progressively augmented as new contributions are
+ registered
+
+ Thrown if
+
+
+
+ Represents a delegate that decorates a function.
+
+ The type of object the function is performed upon.
+ The type of the function result.
+
+
+
+ Describes the context in which an assertion is being evaluated.
+
+
+
+
+ Submits an assertion failure.
+
+
+
+ The behavior of this method depends upon the current setting of
+
+
+ Thrown if
+
+
+
+ Performs an action and returns an array containing the assertion failures
+ that were observed within the block.
+
+
+
+ If the action throws an exception it is reported as an assertion failure
+ unless the exception is a
+
+ The set of failures captured will depend on the setting of
+ - If set to
+ - If set to
+ - If set to
+
+
+
+ The array of failures, may be empty if none.
+ Thrown if
+
+
+
+ Gets the pending failures within the current assertion scope.
+
+ The pending failures, or an empty array if none.
+
+
+
+ Gets the current assertion context, or null if there is no current context.
+
+
+
+
+ Gets the associated test context.
+
+
+
+
+ Gets the current assertion failure behavior.
+
+
+
+ The value of this property may change during invocations of
+
+
+
+
+ The exception type used by the Gallio assertion framework to signal assertion failures.
+
+
+
+
+ This exception type is used to signal that a test has failed to satisfy
+ some predetermined condition established by the test author.
+
+
+
+ For example, an assertion failure may be signaled using a
+
+
+
+
+ Creates an exception.
+
+
+
+
+ Creates an exception.
+
+
+
+
+ Creates an exception.
+
+
+
+
+ Creates an exception from serialization info.
+
+
+
+
+ Returns
+
+
+
+ Creates an exception.
+
+
+
+
+ Creates an exception.
+
+
+
+
+ Creates an exception.
+
+
+
+
+ Creates an exception from serialization info.
+
+
+
+
+ An assertion failure is an immutable description of a failed assertion and its
+ cause. It takes into account information about labeled values such as the expected
+ and actual value.
+
+
+
+ Use an
+
+
+
+
+ Gets the maximum length of label that can be presented before truncation occurs.
+
+ 100
+
+
+
+ Gets the maximum length of formatted value that can be presented before truncation occurs.
+
+ 2000
+
+
+
+ Creates an assertion failure object.
+
+
+
+
+ Writes the assertion failure to a test log stream.
+
+ Thrown if
+
+
+
+ Formats the failure as a string.
+
+ The formatted string.
+
+
+
+ Writes the details about the assertion failure to the structured text writer.
+
+
+
+
+ Gets the description of the assertion failure.
+
+
+
+
+ Gets the user-supplied message about the assertion failure,
+ or null if none.
+
+
+
+
+ Get the stack track of the failure, or null if none.
+
+
+
+
+ Gets formatted representations of labeled values as key/value pairs.
+
+
+
+
+ Gets information about the exceptions.
+
+
+
+
+ Gets the nested assertion failures that contributed to the composite assertion
+ failure described by this instance.
+
+
+
+
+ A labeled value describes a named assertion parameter.
+
+
+
+ The label indicates the purpose of the value, such as "Expected Value".
+ The value itself should be formatted to emphasize structural characteristics.
+
+
+ For additional emphasis, such as for comparison purposes (ie. diffs), the value may
+ be formatted as structured text to include highlights and other markup.
+
+
+
+
+
+ Creates a labeled value with plain text.
+
+ Thrown if
+ Thrown if
+
+
+
+ Creates a labeled value with structured text.
+
+ Thrown if
+ Thrown if
+
+
+
+
+
+ Gets the label.
+
+
+
+
+ Gets the formatted value as structured text.
+
+
+
+
+ Specifies the behavior that should take place when a
+
+
+ There are three orthogonal dimensions to the assertion failure behavior:
+
+
+
+
+
+
+
+ When an assertion failure is reported, capture it in a list, log it, and allow
+ the computation to continue.
+
+ 1
+
+
+
+ When an assertion failure is reported, capture it in a list, then throw an
+
+ 2
+
+
+
+ When an assertion failure is reported, capture it in a list, log it, then throw an
+
+
+
+ This is the default behavior for assertion contexts.
+
+
+ 3
+
+
+
+ When an assertion failure is reported, discard it (instead of capturing it in a list)
+ and allow the current computation to continue.
+
+ 4
+
+
+
+ When an assertion failure is reported, capture it in a list and allow the current
+ computation to continue.
+
+
+
+ This is the opposite of
+
+ 0
+
+
+
+ An assertion failure builder is used to construct a complete description
+ of an assertion failure that has occurred. It takes into account information about
+ the expected and actual value, as well as additional labeled values and exceptions.
+
+
+
+
+ Creates an assertion failure builder with the default formatter.
+
+ Thrown if
+
+
+
+ Creates an assertion failure builder with the specified formatter.
+
+ Thrown if
+
+
+
+ Sets the user-supplied assertion failure message.
+
+ The builder, to allow for fluent method chaining.
+
+
+
+ Sets the user-supplied assertion failure message to a formatted value.
+
+ The builder, to allow for fluent method chaining.
+
+
+
+ Sets the stack trace.
+
+ The builder, to allow for fluent method chaining.
+
+
+
+ Adds the raw expected value to be formatted using
+
+
+ The order in which this method is called determines the order in which this
+ value will appear relative to other labeled values.
+
+
+ This is a convenience method for setting a labeled value called "Expected Value".
+
+
+ The builder, to allow for fluent method chaining.
+
+
+
+ Adds the raw actual value to be formatted using
+
+
+ The order in which this method is called determines the order in which this
+ value will appear relative to other labeled values.
+
+
+ This is a convenience method for setting a labeled value called "Actual Value".
+
+
+ The builder, to allow for fluent method chaining.
+
+
+
+ Adds the raw expected and actual values to be formatted using
+
+
+ The order in which this method is called determines the order in which the
+ values will appear relative to other labeled values.
+
+
+ This is a convenience method for setting a pair of labeled values called "Expected Value"
+ and "Actual Value" with diffs.
+
+
+ The builder, to allow for fluent method chaining.
+
+
+
+ Adds two raw labeled values formatted using
+
+
+ The order in which this method is called determines the order in which the
+ values will appear relative to other labeled values.
+
+
+ The builder, to allow for fluent method chaining.
+ Thrown if
+
+
+
+ Adds a raw labeled value to be formatted using
+
+
+ The order in which this method is called determines the order in which this
+ labeled value will appear relative to other labeled values.
+
+
+ The builder, to allow for fluent method chaining.
+ Thrown if
+ Thrown if
+
+
+
+ Adds a labeled value as plain text.
+
+
+
+ The order in which this method is called determines the order in which this
+ labeled value will appear relative to other labeled values.
+
+
+ The builder, to allow for fluent method chaining.
+ Thrown if
+ Thrown if
+
+
+
+ Adds a labeled value as structured text.
+
+
+
+ The order in which this method is called determines the order in which this
+ labeled value will appear relative to other labeled values.
+
+
+ The builder, to allow for fluent method chaining.
+ Thrown if
+ Thrown if
+
+
+
+ Adds a labeled value.
+
+
+
+ The order in which this method is called determines the order in which this
+ value will appear relative to other labeled values.
+
+
+ The builder, to allow for fluent method chaining.
+
+
+
+ Adds an exception to the assertion failure.
+
+ The builder, to allow for fluent method chaining.
+ Thrown if
+
+
+
+ Adds an exception to the assertion failure.
+
+ The builder, to allow for fluent method chaining.
+ Thrown if
+
+
+
+ Adds a nested assertion failure that contributed to the composite assertion failure
+ described by this instance.
+
+ The builder, to allow for fluent method chaining.
+ Thrown if
+
+
+
+ Adds an enumeration of nested assertion failures that contributed to the composite
+ assertion failure described by this instance.
+
+ The builder, to allow for fluent method chaining.
+ Thrown if
+
+
+
+ Generates an immutable object that describes the failure.
+
+ The assertion failure.
+
+
+
+ Creates an assertion failure object.
+
+
+
+ Subclasses may override this method to define custom extended assertion
+ failure objects.
+
+
+
+
+
+ Gets the formatted used by the builder.
+
+
+
+
+ An exception type that wraps a
+
+
+ This exception is used in two ways:
+
+ - The exception may be "silent" when it is used to cause a test to terminate due to
+ an assertion failure that has already been logged or otherwise conveyed to the user.
+ - Otherwise the exception will be reported the user in the typical manner.
+
+
+
+
+
+
+ Creates an exception for a given assertion failure.
+
+ Thrown if
+
+
+
+ Creates an exception from serialization info.
+
+
+
+
+
+
+ Gets the associated assertion failure, never null.
+
+
+
+
+ Returns true if the assertion failure exception should not be logged because
+ the information it contains has already been conveyed to the user.
+
+
+
+
+
+
+
+
+ Provides utilities to assist with the implementation of new asserts.
+
+
+
+
+ Verifies that an assertion succeeded.
+
+
+
+ The assertion function should return null to indicate that the assertion has passed
+ or
+
+ If the assertion function throws an exception it is reported as an assertion failure
+ unless the exception is a
+
+ When an assertion failure is detected, it is submitted to
+
+ Using this method enables the system to track statistics about assertions
+ and to ensure that assertion failures are reported uniformly.
+
+
+ It is important to note that not all failures will result in a
+
+ Thrown if
+
+
+
+ Submits a failure if the assertion failure object is non-null.
+
+
+
+
+ Performs an action and returns an array containing the assertion failures
+ that were observed within the block. If the block throws an exception, it
+ is reified as an assertion failure.
+
+
+
+ If the action throws an exception it is reported as an assertion failure
+ unless the exception is a
+
+ The assertion failure behavior while the action runs is
+
+ This method is very useful for composing assertions because it enables assertions to be
+ evaluated, and, when they fail, the failure can be recorded as an inner assertion failure
+ of some larger composite assertion. For example, this makes it possible to create an assertion
+ over a collection of items by composing an assertion over a single item.
+
+
+ The array of failures, may be empty if none.
+ Thrown if
+
+
+
+ Performs an action and returns an array containing the assertion failures
+ that were observed within the block.
+
+
+
+ If the action throws an exception it is reported as an assertion failure
+ unless the exception is a
+
+ The array of failures, may be empty if none.
+ Thrown if
+ Thrown if there is no current assertion context.
+
+
+
+ Performs an action and combines the possible assertion failures
+ that were observed within the block, into a single outer failure with
+ a common explanation.
+
+ Thrown if
+ Thrown if
+
+
+
+ Abstract base class for
+
+
+
+ A data binder specifies how to produce values that are suitable for data binding
+ in some context.
+
+
+
+ The typical
+ - First, a
+ - Next the client calls
+ - Then the client calls
+ - For each item, the client calls
+ - When finished with an item, the client disposes it.
+
+
+
+ The lifecycle may also be explained in terms of three phases from the perspective
+ of a
+ -
+
Prebinding : The
+ -
+
Binding : The
+ -
+
Unbinding : The
+
+
+
+ Several data binders may be composed to generate complex values that
+ are produced using contributions from other data binders. For example,
+ a simple data binder might select a single value from a data source and
+ convert it to the right time. A composite data binder may then use the
+ values produced by several of these simple data binders to initialize
+ the fields of a composite object. Thus a composite data binder facilitates
+ the production of relatively complex object graphs that are generated from
+ primitive data binding units.
+
+
+
+
+
+ Registers the
+ The data binding accessor to use for obtaining bound values
+ from
+ Thrown if
+
+
+
+
+
+ Implementation of
+ The data binding accessor.
+
+
+
+ A base implementation of
+
+
+
+ A data accessor extracts a value from a
+
+
+
+ Gets a value derived from the
+ The value.
+ Thrown if the data binding fails.
+ Thrown if
+
+
+
+
+
+ Internal implementation of
+ The value.
+ Thrown if the data binding fails.
+
+
+
+ An implementation of
+
+
+
+ Creates a data accessor that returns a specified constant value.
+
+
+
+
+
+
+ A
+
+
+ In typical usage, a
+
+
+
+
+ Creates a data binding context.
+
+ Thrown if
+
+
+
+ Registers a data binding for a given data set and adds the data set
+ to the list of data sets to be enumerated during data binding.
+ Returns a
+
+
+ A
+
+ Thrown if
+
+
+
+ Gets an enumeration of
+
+
+ The contents of each item may be inspected using a
+
+ A client typically registers its
+
+ If no data bindings have been registered (
+
+ The enumeration of data items.
+
+
+
+ Gets the converter service.
+
+
+
+ The data binding context does not use the converter itself, but it may be
+ used by data binders to perform any required internal conversions.
+
+
+
+
+
+ Returns true if the data binding context contains registered data bindings.
+
+
+
+ If the context contains no data bindings then by definition it also contains
+ no data sets. In the absence of bindings,
+
+
+
+
+ Gets the immutable list of data sets to be enumerated during data binding.
+
+
+
+ These are the
+
+
+
+
+ Gets or sets the
+ Thrown if
+
+
+
+ A data row is a simple immutable value type that encpasulates an
+ array of values along with associated metadata for use in data binding expressions.
+ It presents a fluent interface that users may find more convenient than
+ other
+
+
+ The data in a
+
+
+
+
+ Abstract base class for data items.
+
+
+
+
+ A data item is an opaque representation of a collection of values
+ and metadata that may be retrieved using data bindings that encode
+ the appropriate lookup rules into the item.
+
+
+
+ Data items may have very different forms:
+
+ - Scalar-like items: Items that always yield a single value, possibly a constant
+ - Row-like items: Items that yield several values in response to index-based
+ data bindings or named column paths
+ - Structured items: Items that yield values by binding to paths within the item
+ or by resolving custom data binding expressions
+
+
+
+
+
+
+ Populates the specified metadata map with key/value pairs associated with
+ the data item, if any.
+
+
+
+ For example, the metadata may contain a description that serves
+ as documentation of the contents of the data item or of the test
+ scenario that is exercised by the contents of the data item.
+ This metadata may be injected into test instances created with
+ the contents of this data item.
+
+
+
+
+
+ Gets the value of the specified binding.
+
+ The value.
+ Thrown if the
+
+
+
+ Gets an enumeration of the data bindings that may be queried to informally describe
+ its contents. The enumeration of bindings may not be complete.
+
+ The enumeration of bindings.
+
+
+
+ Returns true if the item contains data that is obtained dynamically from sources
+ whose content may change over time or may be expensive to query ahead of time.
+
+
+
+ For example, data obtained from a database should be considered dynamic.
+ On the other hand, data obtained from declarative metadata defined as part
+ of the test should be considered static.
+
+
+
+
+
+
+
+
+
+
+
+ Implements
+ The associated value.
+
+
+
+ Implements
+
+
+
+
+
+ Creates a data row with the specified array of values.
+
+
+
+
+ Returns an augmented data row with added metadata.
+
+
+
+ The original data row is not modified.
+
+
+ The augmented data row.
+ Thrown if
+
+
+
+ Returns an augmented data row with added metadata from the
+ specified metadata map.
+
+
+
+ The original data row is not modified!
+
+
+ The augmented data row.
+ Thrown if
+
+
+
+
+
+
+
+
+
+
+
+ Utilities for
+
+
+
+ Gets the metadata associated with a data item.
+
+ The associated metadata.
+
+
+
+ A factory data set generates data items by invoking a factory delegate
+ and interpreting its output in accordance with the factory kind.
+
+
+
+ Multiple different interpretations are supported. Refer to the documentation
+ of the
+
+
+
+
+ Abstract base class for
+
+
+
+ A data set provides data items for data binding and describes whether
+ is supports particular bindings.
+
+
+
+
+ A data provider generates an enumeration of
+
+
+
+ Gets an enumeration of data items that can supply values for a given collection of bindings.
+ It should produce items even if some of the requested bindings cannot be fulfilled.
+
+ The enumeration of data items.
+ Thrown if
+
+
+
+ Returns true if the data set can provide a value for the specified binding.
+
+ True if the data set can provide a value for the binding.
+ Thrown if
+
+
+
+ Gets the number of columns in an indexed data set.
+
+
+
+
+
+
+
+
+ Determines whether a binding can be satisfied by the data set.
+
+ True if the binding can be satisfied.
+
+
+
+ Enumerates the data items in the data set.
+
+ The enumeration of data items in the combined data set.
+
+
+
+
+
+ Creates a factory data set.
+
+ Thrown if
+ Thrown if
+
+
+
+
+
+
+
+
+
+ Specifies the kind of factory member referenced by
+
+
+ Each kind of factory expresses its contents by returning enumerations of data sets,
+ data items, object arrays and single objects.
+
+
+ The kind of a factory may be automatically determined or it may be explicitly
+ specified in cases where it may be ambiguous.
+
+
+
+
+
+ Automatically determines the type of factory based on the type of element
+ returned by the enumeration.
+
+
+
+
+ - If the element is a
+ - If the element is a
+ - If the element is an array then it is processed in the same manner as
+
+ - Otherwise the element is process in the same manner as
+
+
+
+ Refer to the other factory kinds for usage examples.
+
+
+
+
+
+ Specifies that the factory returns an enumeration
+
+ MyFactory
+ {
+ get
+ {
+ yield return new MyCustomDataSet(1);
+ yield return new MyCustomDataSet(2);
+ }
+ }
+
+ [Test, Factory("MyFactory", Kind=FactoryKind.DataSet)]
+ public void MyTest(object value)
+ {
+ // test logic...
+ }
+ ]]>
+
+
+
+
+ Specifies that the factory returns an enumeration of
+
+ MyFactory
+ {
+ get
+ {
+ yield return new DataRow(1);
+ yield return new DataRow(42)
+ .WithMetadata(MetadataKeys.ExpectedException, typeof(CustomException).FullName);
+ }
+ }
+
+ [Test, Factory("MyFactory", Kind=FactoryKind.DataItem)]
+ public void MyTest(int value)
+ {
+ // test logic...
+ }
+ ]]>
+
+
+
+
+ Specifies that the factory returns an enumeration of object arrays
+ that describe successive items.
+
+
+ MyFactory
+ {
+ get
+ {
+ yield return new object[] { "abc", 123 };
+ yield return new object[] { "def", 456 };
+ }
+ }
+
+ [Test, Factory("MyFactory", Kind=FactoryKind.ObjectArray)]
+ public void MyTest(string value, int count)
+ {
+ // test logic...
+ }
+ ]]>
+
+
+
+
+ Specifies that the factory returns an enumeration of single object values.
+
+
+ MyFactory
+ {
+ get
+ {
+ yield return "abc";
+ yield return "def";
+ }
+ }
+
+ [Test, Factory("MyFactory", Kind=FactoryKind.Object)]
+ public void MyTest(string value)
+ {
+ // test logic...
+ }
+ ]]>
+
+
+
+
+ An object data binder creates objects and binds values to its slots such as
+ generic type parameters, constructor parameters, fields and properties.
+
+
+
+
+ Creates an object data binder initially without slot binders.
+
+ Thrown if
+
+
+
+ Sets the binder for a slot.
+
+ Thrown if
+
+
+
+
+
+ A
+
+
+
+ Creates a bound data accessor.
+
+ Thrown if
+
+
+
+
+
+ A scalar data binder queries a specified data source with a data binding
+ and converts the resulting value to the requested type.
+ It does nothing during unbinding.
+
+
+
+
+ Creates a scalar data binder.
+
+
+
+
+
+
+ An implementation of
+
+
+
+ Creates a data item.
+
+
+
+
+
+
+
+
+
+
+ Constructor.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Gets a function for subtracting values of a given type.
+
+ The type of values to be compared.
+ The type of the difference produced when the values are
+ subtracted, for numeric types this is the same as
+ The subtraction function.
+ Thrown if no subtraction function exists
+ or if the difference type is incorrect.
+
+
+
+ The process isolation object saves global process-level context
+ information when it is created and restores it when it is disposed.
+
+
+
+ The following context information is saved and restored:
+
+ - The current working directory
+
+
+
+
+
+
+ Saves global process state to be subsequently restored when disposed.
+
+
+
+
+ Restores the saved process state.
+
+
+
+
+ Performs one primitive action of a test and returns its outcome.
+
+ The outcome of the action.
+
+
+
+ Subtracts the right value from the left and returns the difference.
+
+ The type of values to be compared.
+ The type of the difference produced when the values are
+ subtracted, for numeric types this is the same as
+ The difference when the right value is subtracted from the left.
+
+
+
+ Default implementation of a test framework manager.
+
+
+
+
+ Provides services based on the installed set of test frameworks.
+
+
+
+
+ Gets an aggregate test driver for selected frameworks.
+
+ The test driver.
+ Thrown if
+
+
+
+
+ Selects the test frameworks to use for a collection of files.
+
+ The map of test framework selections to their associated test files.
+ Thrown if
+
+
+
+ Selects the test frameworks to use for a collection of code elements.
+
+ The map of test framework selections to their associated code elements.
+ Thrown if
+
+
+
+ Gets handles for all registered test frameworks.
+
+
+
+
+ Gets the handle of the fallback test framework used when no other
+ framework supports a given test file.
+
+
+
+
+ Creates a test framework manager.
+
+ Thrown if
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Specifies an inclusion or exclusion filter rule.
+
+
+
+
+ Creates a filter rule.
+
+ Thrown if
+
+
+
+ Gets the filter rule type: inclusion or exclusion.
+
+
+
+
+ Gets the filter.
+
+
+
+
+ Specifies whether a filter rule is an inclusion or exclusion rule.
+
+
+
+
+ The filter rule is an inclusion rule.
+
+
+
+
+ The filter rule is an exclusion rule.
+
+
+
+
+ A filterset combines zero or more filters as a sequence of inclusion and exclusion rules.
+
+
+
+
+ Creates a filter set consisting of a single inclusion filter.
+
+ Thrown if
+
+
+
+ Creates a filter set consisting of a collection of rules.
+
+ Thrown if
+
+
+
+ Evaluates the rules of this filter set and indicates whether the item is included, excluded
+ or not matched by the list of rules.
+
+ The result.
+
+
+
+ Formats the filter set to a string suitable for parsing by
+
+
+ The empty filter is represented by an empty string.
+
+
+ The formatted filter set expression.
+
+
+
+
+
+ Returns an empty filter set.
+
+
+
+ An empty filter set neither includes nor excludes any values on its own.
+ However when filtering tests, Gallio applies an implicit inclusion rule when
+ none is otherwise specified so the net effect if that all tests will be
+ included (although "explicit" tests will not be selected explicitly so they
+ will not run).
+
+
+
+
+
+ Gets the read-only list of filter rules.
+
+
+
+
+ Returns true if the filter set is empty.
+
+
+
+
+ Returns true if the filter set has at least one inclusion rule.
+
+
+
+
+ Specifies whether a filter set includes, excludes or does not match a particular item.
+
+
+
+
+ The filter set neither includes nor excludes the item.
+
+
+
+
+ The filter set includes the item.
+
+
+
+
+ The filter set excludes the item.
+
+
+
+
+ Defines the test ordering strategy.
+
+
+
+ This default strategy first compares test by explicit ordering (using
+
+ Why implicitly order tests by name instead of randomly?
+
+
+ It is my belief that ordering tests by name significantly eases test result interpretation
+ because the test results are produced in a meaningful and predictable order. If the implicit
+ order is known, then it's easier for a tester to guage test progress by inspecting the name
+ of the currently executing test (in addition to using cues provided by progress monitors, of course).
+ Related tests also tend to have similar names or share a common prefix so sorting by name
+ can effectively cluster these tests together thereby providing feedback about related topics
+ around the same time.
+
+
+ A tester may of course take advantage of this known ordering to produce tests that are
+ dependent upon one another without making that clear in the code by specifying explicit test
+ dependencies or ordering. When a test is renamed, the implicit ordering will change, possibly
+ causing other tests to fail. However, it is not Gallio's objective to police
+ testers, who may well adopt any number of inadvisable practices to meet their ends.
+
+
+ Nevertheless, any test framework is still free to produce a random ordering of independent tests.
+ It suffices for the framework to initialize the
+
+ Perhaps someday we can also offer the user a global choice among alternative test ordering strategies.
+
+
+
+
+
+
+
+ The type of exception thrown when a filter cannot be parsed.
+
+
+
+
+ Creates an exception.
+
+
+
+
+ Creates an exception.
+
+
+
+
+ Creates an exception.
+
+
+
+
+ Creates an exception from serialization info.
+
+
+
+
+ Describes traits of an
+
+
+
+ Creates test framework traits.
+
+ Thrown if
+
+
+
+ Returns true if at least one of the assembly references is in
+ True if the framework is compatible.
+ Thrown if
+
+
+
+ Returns true if the file type is the same or a subtype of one of those specified by
+ True if the framework is compatible.
+ Thrown if
+
+
+
+ Gets the framework's display name.
+
+
+
+
+ Gets or sets the framework's icon, or null if none.
+
+
+
+
+ The version of the test framework.
+
+
+
+
+ Gets or sets the list of framework assembly signatures that are recognized and supported
+ by this framework component.
+
+
+
+ The framework manager consults this list to determine whether the framework component
+ should participate in test exploration. If none of the named framework assemblies are found
+ among the test assembly references then the framework component will not be instantiated
+ during test exploration in order to improve performance.
+
+
+ Refer to
+
+ Thrown if
+
+
+
+ Gets or sets the list of file types ids recognized by the framework as test files.
+
+
+
+ The framework manager consults this list to determine whether the framework component
+ should participate in test exploration. If none of the file types match the files
+ specified by the test source then the framework component will not be instantiated
+ during test exploration in order to improve performance.
+
+
+ For .Net-based test frameworks, the list of file types should probably include "Assembly"
+ or one of its subtypes.
+
+
+ Thrown if
+
+
+
+ A test package specifies the test files, assemblies, and configuration options
+ that govern test execution.
+
+
+
+
+ Creates an empty test package.
+
+
+
+
+ Creates a copy of the test package.
+
+ The new copy.
+
+
+
+ Resets
+
+
+
+ Resets
+
+
+
+ Resets
+
+
+
+ Resets
+
+
+
+ Resets
+
+
+
+ Resets
+
+
+
+ Resets
+
+
+
+ Clears the list of test files.
+
+
+
+
+ Adds a test file if it is not already in the test package.
+
+ Thrown if
+
+
+
+ Removes a test file.
+
+ Thrown if
+
+
+
+ Clears the list of hint directories.
+
+
+
+
+ Adds a hint directory if it is not already in the test package.
+
+ Thrown if
+
+
+
+ Removes a hint directory.
+
+ Thrown if
+
+
+
+ Clears the list of excluded test framework ids.
+
+
+
+
+ Adds an excluded test framework id if it is not already in the test package.
+
+ Thrown if
+
+
+
+ Removes an excluded test framework id.
+
+ Thrown if
+
+
+
+ Clears the collection of properties.
+
+
+
+
+ Adds a property key/value pair.
+
+ Thrown if
+ Thrown if
+
+
+
+ Removes a property key/value pair.
+
+ Thrown if
+
+
+
+ Creates a host setup based on the package properties.
+
+ The host setup.
+
+
+
+ Creates a test framework selector based on the package properties.
+
+
+ Considers the
+ The test framework selector.
+
+
+
+ Applies the settings of another test package as an overlay on top of this one.
+
+
+
+ Overrides scalar settings (such as
+
+ Thrown if
+
+
+
+ Gets the read-only list of test files.
+
+
+
+
+ Gets the read-only list of hint directories used to resolve test assemblies and other files.
+
+
+
+
+ Gets the read-only list of test framework IDs that are to be excluded from the test
+ exploration process.
+
+
+
+
+ Gets a read-only collection of properties for the test runner.
+
+
+
+
+ Gets or sets the test framework options.
+
+ Thrown if
+
+
+
+ Returns true if
+
+
+
+ Gets or sets the test framework fallback mode.
+
+ The test framework fallback mode. Default is TestFrameworkFallbackMode.Default .
+
+
+
+ Returns true if
+
+
+
+ Gets or sets whether assembly shadow copying is enabled.
+
+ True if shadow copying is enabled. Default is false .
+
+
+
+ Returns true if
+
+
+
+ Gets or sets the debugger setup options, or null if not debugging.
+
+ The debugger setup options. Default is null .
+
+
+
+ Returns true if
+
+
+
+ Gets or sets the application base directory, or null to use the directory
+ containing each group of test files or some other suitable default chosen by the test framework.
+
+
+ The application base directory. Default is null .
+
+
+
+
+ Returns true if
+
+
+
+ Gets or sets the working directory, or null to use the directory containing
+ each group of test files or some other suitable default chosen by the test framework.
+
+
+ The working directory. Default is null .
+
+
+
+
+ Returns true if
+
+
+
+ Gets or sets the .Net runtime version, or null to auto-detect.
+
+ The runtime version, eg. "v2.0.50727". Default is null .
+
+
+
+ Returns true if
+
+
+
+ An immutable record that holds two values.
+
+ The type of the first value.
+ The type of the second value.
+
+
+
+ Creates a pair.
+
+
+
+
+ Gets the first value.
+
+
+
+
+ Gets the second value.
+
+
+
+
+ Provides support for working with different versions of the .Net framework.
+
+
+
+
+ Gets the .Net framework version installed and currently running.
+
+ The framework version.
+
+
+
+ Specifies the .Net runtime type.
+
+
+
+
+ Using the Microsoft CLR.
+
+
+
+
+ Using the Mono runtime.
+
+
+
+
+ Arguments for an event raised to signal that a test was discovered and added to the test model.
+
+
+
+
+ Initializes the event arguments.
+
+ Thrown if
+
+
+
+ Gets the report.
+
+
+
+
+ Gets the test at the top of the subtree that was merged.
+
+
+
+
+ Arguments for an event raised to signal that an annotation has been discovered and
+ added to the test model.
+
+
+
+
+ Initializes the event arguments.
+
+ Thrown if
+
+
+
+ Gets the report.
+
+
+
+
+ Gets the annotation that was added.
+
+
+
+
+ Arguments for an event raised to indicate that the test runner disposal has finished.
+
+
+
+
+ Base arguments for events raised to indicate the completion of an operation.
+
+
+
+
+ Initializes the event arguments.
+
+
+
+
+ Returns true if the operation completed successfully.
+
+
+
+
+ Initializes the event arguments.
+
+
+
+
+ Arguments for an event raised to indicate that the test runner disposal has started.
+
+
+
+
+ Initializes the event arguments.
+
+
+
+
+ Arguments for an event raised to indicate that test exploration has finished.
+
+
+
+
+ Initializes the event arguments.
+
+ Thrown if
+
+
+
+ Gets the report, including test model data on success.
+
+
+
+
+ Arguments for an event raised to indicate that test exploration has started.
+
+
+
+
+ Initializes the event arguments.
+
+ Thrown if
+
+
+
+ Gets the test package.
+
+
+
+
+ Gets the test exploration options.
+
+
+
+
+ Gets the report lock-box which may be used to access the report asynchronously during execution.
+
+
+
+
+ Arguments for an event raised to indicate that a marker block has been started within a test step log stream.
+
+
+
+
+ Base arguments for an event raised to indicate that a test step log stream has been modified in some way.
+
+
+
+
+ Base arguments for an event raised to provide information about a test step.
+
+
+
+
+ Initializes the event arguments.
+
+ Thrown if
+
+
+
+ Gets the kind of step described using the
+ The step kind.
+
+
+
+ Gets the report.
+
+
+
+
+ Gets the test data of the test that contains the test step.
+
+
+
+
+ Gets the test step run.
+
+
+
+
+ Initializes the event arguments.
+
+ Thrown if
+
+
+
+ Gets the log stream name.
+
+
+
+
+ Initializes the event arguments.
+
+ Thrown if
+
+
+
+ Gets the marker.
+
+
+
+
+ A test runner extension plugs augments the behavior of a
+
+
+ Typical extension use-cases:
+
+ - Custom logging by listening for events of interest and writing messages
+ to a file or to another location.
+ - Custom configuration of test package loading, test exploration
+ and test execution options by listening for the starting events of the phase
+ and modifying the options in place.
+
+
+
+ More complex extensions such as integration of new test frameworks are typically
+ performed by plugins because new runtime services must be registered to support them.
+
+
+
+
+
+ Installs the extension into a test runner.
+
+
+
+
+ Gets or sets configuration parameters for the extension.
+
+
+
+
+ Abstract implementation of a test runner extension.
+
+
+
+
+
+
+ Initializes the extension as part of extension installation.
+
+
+
+
+ Gets the test runner event extension point.
+
+
+
+
+ Gets the logger.
+
+
+
+
+
+
+ Provides utilities for manipulating test runner extensions.
+
+
+
+
+ Creates an extension from its specification.
+
+
+
+ An extension specification has the form "[Namespace.]Type,Assembly[;Parameters]".
+ The extension class must implement
+
+ Examples:
+
+ - "MyExtensions.MyExtension,MyExtensions.dll;Parameter1,Parameter2"
+ - "CustomLogger,MyExtensions"
+
+
+
+ The extension.
+ Thrown if the extension cannot be instantiated and configured.
+ Thrown if
+
+
+
+ A default implementation of
+
+
+
+ A test runner provides the basic functionality for loading, exploring and running tests.
+
+
+
+ It abstracts away most concerns having to do with the execution of tests
+ in isolated (possibly remote) domains.
+
+
+ The basic usage pattern of a test runner is as follows:
+
+ - As a precondition, ensure that the runtime environment has been initialized.
+ - Create the test runner.
+ - Add event handlers and register extensions.
+ - Initialize the runner.
+ - Explore and/or Run the tests.
+ - Dispose the test runner.
+ - Save or format the report contents as required using the reporting APIs.
+
+
+
+ Multiple test runs may be performed between initialization and disposal of the test runner.
+
+
+
+
+
+ Registers a test runner extension.
+
+
+
+ The extension should already have been configured before this method
+ is called. Its
+
+ Thrown if
+ Thrown if the test runner has already been initialized.
+
+
+
+ Initializes the test runner.
+
+ Thrown if
+ Thrown if the runner is already initialized.
+ Thrown if the runner has been disposed.
+
+
+
+ Explores tests in a test package.
+
+
+
+ Returns a report that contains test package and test model information only.
+
+
+ The test report.
+ Thrown if
+ Thrown if the operation failed.
+ Thrown if the runner has been disposed.
+
+
+
+ Explores and runs tests in a test package.
+
+
+
+ Returns a report that contains test package, test model and test run data.
+
+
+ The test report.
+ Thrown if
+ Thrown if the operation failed.
+ Thrown if the runner has been disposed.
+
+
+
+ Disposes the test runner. Does nothing if already disposed or if not initialized.
+
+ Thrown if
+
+
+
+ Gets the event dispatcher for the test runner.
+
+
+
+
+ Creates a test runner.
+
+ Thrown if
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Gets the logger, or null if the test runner has not been initialized.
+
+
+
+
+ Gets the test runner options, or null if the test runner has not been initialized.
+
+
+
+
+
+
+ In some situations, we may receive a report that a test step representing an
+ inner node of the test tree failed and therefore prevented other test cases
+ from running. When this happens, we automatically promote the test step to
+ behave as if it were a test case and report the failure.
+
+
+ This is really a hack to make up for the fact that most of the information
+ presented to users is about test cases rather than test suites and other inner
+ nodes of the test tree. Because test cases can be constructed dynamically,
+ we have a bit of a problem counting and presenting them when inner nodes fail.
+ I hope someday we come up with a better solution to this issue with our test model.
+ Perhaps we could introduce a "blocked" status.
+ -- Jeff.
+
+
+
+
+ Arguments for an event raised to indicate that the test runner initialization has finished.
+
+
+
+
+ Initializes the event arguments.
+
+
+
+
+ Arguments for an event raised to indicate that the test runner initialization has started.
+
+
+
+
+ Initializes the event arguments.
+
+ Thrown if
+
+
+
+ Gets the test runner options.
+
+
+
+
+ Declares all of the events that may be raised by a
+
+
+
+ The event raised to indicate that a log message was written by the test runner.
+
+
+
+ The runner automatically writes out these log messages to the logger with which it
+ is initialized. These events are raised to allow other subscribers to receive
+ log messages as well.
+
+
+
+
+
+ The event raised to indicate that a raw message was received by the test runner.
+
+
+
+
+ The event raised to indicate that the test runner initialization has started.
+
+
+
+
+ The event raised to indicate that the test runner initialization has finished.
+
+
+
+
+ The event raised to indicate that the test runner disposal has started.
+
+
+
+
+ The event raised to indicate that the test runner disposal has finished.
+
+
+
+
+ The event raised to indicate that test exploration has started.
+
+
+
+
+ The event raised to indicate that test exploration has finished.
+
+
+
+
+ The event raised to indicate that test execution has started.
+
+
+
+
+ The event raised to indicate that test execution has finished.
+
+
+
+
+ The event raised to indicate that a subtree of tests was merged into the test model.
+
+
+
+
+ The event raised to indicate that an annotation was added to the test model.
+
+
+
+
+ The event raised to indicate that a test step has started execution.
+
+
+
+
+ The event raised to indicate that a test step has finished execution.
+
+
+
+
+ The event raised to indicate that a test step has entered a new lifecycle phase.
+
+
+
+
+ The event raised to indicate that a test step dynamically added metadata to itself.
+
+
+
+
+ The event raised to indicate that an attachment has been added to a test step log.
+
+
+
+
+ The event raised to indicate that text has been written to a test step log stream.
+
+
+
+
+ The event raised to indicate that an attachment has been embedded into a test step log stream.
+
+
+
+
+ The event raised to indicate that a section has been started within a test step log stream.
+
+
+
+
+ The event raised to indicate that a marker has been started within a test step log stream.
+
+
+
+
+ The event raised to indicate that a block has finished within a test step log stream.
+
+
+
+
+ Arguments for an event raised to indicate that test execution has finished.
+
+
+
+
+ Initializes the event arguments.
+
+ Thrown if
+
+
+
+ Gets the report, including test package run data on success.
+
+
+
+
+ Arguments for an event raised when a raw message is received.
+
+
+
+
+ Initializes the event arguments.
+
+ Thrown if
+
+
+
+ Gets the message that was received.
+
+
+
+
+ Describes a log entry for reporting purposes.
+
+
+
+
+ Gets or sets the log message severity.
+
+
+
+
+ Gets or sets the log message.
+
+
+
+
+ Gets or sets the log message details, such as an exception.
+
+
+
+
+ Provides options to report formatters.
+
+
+
+
+ Creates a default set of options.
+
+
+
+
+ Clears the collection of properties.
+
+
+
+
+ Adds a property key/value pair.
+
+ Thrown if
+ Thrown if
+
+
+
+ Removes a property key/value pair.
+
+ Thrown if
+
+
+
+ Creates a copy of the options.
+
+ The copy.
+
+
+
+ Gets a read-only collection of configuration properties for the report formatter.
+
+
+
+
+ Describes traits of an
+
+
+
+ Creates report formatter traits.
+
+
+
+
+ Gets the unique name of the report format.
+
+
+
+
+ Gets the description of the report format.
+
+
+
+
+ Describes traits of an
+
+
+
+ Creates test runner factory traits.
+
+
+
+
+ Gets the unique name of the kind of test runner created by the factory.
+
+
+
+
+ Gets the description of test runner created by the factory.
+
+
+
+
+ Converts arrays from one-dimensional arrays of one element type to another.
+
+
+
+
+
+
+
+
+ An abstract base class implementation of
+
+
+
+ A converter converts a value from a source type to a target type.
+
+
+
+
+ Determines whether the converter can convert a value of type
+ True if the converter supports this conversion.
+ Thrown if
+
+
+
+ Gets the cost of converting a value of type
+ Thrown if
+ The conversion cost.
+
+
+
+ Converts the value
+ The converted value.
+ Thrown if
+ Thrown the requested conversion was not supported.
+
+
+
+
+
+
+
+
+
+ Implements
+
+
+ The default implementation returns true if
+
+ True if the conversion is supported.
+
+
+
+ Implements
+ The conversion cost.
+
+
+
+ Implements
+ The converted value.
+
+
+
+ Describes the relative cost of performing a conversion so that different
+ conversions can be ranked by cost.
+
+
+
+ A typical direct conversion should have
+ a cost of one. Lossy conversions should be more costly.
+
+
+
+
+
+ The conversion has zero cost because no work is required.
+
+ The associated cost value is 0.
+
+
+
+ The conversion is the best possible conversion available.
+
+
+
+ Built-in conversions should not use this value. It should be reserved for
+ user-created conversions that are intended to override the built-in conversions.
+
+
+ The associated cost value is 1.
+
+
+
+ The conversion costs a typical amount of work to perform.
+
+
+
+ It may yet be trumped by a conversion that costs less.
+
+
+ The associated cost value is 1000.
+
+
+
+ The conversion is a poor default choice. It costs a sufficient number of units
+ of work to perform to ensure that a non-default conversion will be chosen if possible.
+
+ The associated cost value is 1000000.
+
+
+
+ The conversion costs the maximum possible amount of work to perform.
+
+ The associated cost value is 1000000000.
+
+
+
+ The conversion is not supported.
+
+ The associated cost value is
+
+
+
+ Creates a conversion cost.
+
+ Thrown if
+
+
+
+
+
+ Adds this conversion cost with the other and returns the sum.
+
+ The summed conversion cost.
+
+
+
+
+
+ Gets the cost value.
+
+
+
+
+ Returns true if the conversion is not supported.
+
+
+
+
+ Converts values among
+
+
+
+
+
+
+
+ Service locator for
+
+
+
+ Gets the global converter singleton.
+
+
+
+
+ A null implementation of a converter that does not actually support
+ converting values.
+
+
+
+ Consequently
+
+
+
+
+ Gets a singleton instance of the null converter.
+
+
+
+
+
+
+
+
+ Converts an
+
+
+
+
+
+
+
+ A rule-based converter uses a set of
+
+
+ It caches the best path it determines for each conversion
+ so that it only needs to compute the conversion cost once.
+
+
+
+
+
+ Creates a rule-based converter.
+
+ Thrown if
+
+
+
+
+
+
+
+ Converts a
+
+
+
+
+
+
+
+ Converts
+
+
+
+
+
+
+
+ Converts an
+
+
+
+
+
+
+
+ Converts
+
+
+
+
+
+
+
+ Describes different possible outcomes from attaching a debugger to a process.
+
+
+
+
+ The debugger could not attach to the process.
+
+
+
+
+ The debugger was already attached to the process.
+
+
+
+
+ The debugger has just been attached to the process.
+
+
+
+
+ Default implementation of a debugger manager.
+
+
+
+
+ Obtains a reference to a debugger.
+
+
+
+
+ Gets a debugger.
+
+ The debugger.
+ Thrown if
+
+
+
+
+
+ Describes different possible outcomes from detaching a debugger from a process.
+
+
+
+
+ The debugger could not be detached from the process and remains attached.
+
+
+
+
+ The debugger was already detached from the process.
+
+
+
+
+ The debugger has just been detached from the process.
+
+
+
+
+ Provides control over a debugger.
+
+
+
+
+ Returns true if the debugger is attached to a process.
+
+ True if the debugger is already attached.
+ Thrown if
+
+
+
+ Attaches the debugger to a process.
+
+ A result code to indicate whether the debugger was attached.
+ Thrown if
+
+
+
+ Detaches the debugger from a process.
+
+
+
+ Does nothing if the process was not attached.
+
+
+ A result code to indicate whether the debugger was detached.
+ Thrown if
+
+
+
+ Launches a process and attaches the debugger.
+
+ The process that was started, or null if the process could not be launched with the debugger.
+ Thrown if
+
+
+
+ A null implementation of a debugger. All services return do nothing results.
+
+
+
+
+
+
+
+
+
+
+
+
+ An assembly binding specifies the name and location of an assembly as well
+ as some properties to control how the .Net assembly loader resolves
+ particular assembly versions.
+
+
+
+
+ Creates an assembly binding with the specified assembly name.
+
+ Thrown if
+
+
+
+ Creates an assembly binding using the name and codebase of the specified assembly.
+
+ Thrown if
+
+
+
+ Adds a binding redirect.
+
+ Thrown if
+
+
+
+ Gets the assembly name.
+
+
+
+
+ Gets or sets the assembly codebase, or null if unknown.
+
+ Thrown if
+
+
+
+ Gets or sets whether the assembly full name should be used to qualify all partial
+ name references to the assembly.
+
+
+
+
+ Gets or sets whether to apply the assembly publisher policy. Default is true .
+
+
+
+
+ Gets the mutable list of assembly binding redirects.
+
+
+
+
+ Specifies an old version range for an assembly binding redirect.
+
+
+
+
+ Creates an assembly binding redirect.
+
+
+
+ Accepts a version number like "1.2.3.4" or a range like "1.0.0.0-1.1.65535.65535".
+
+
+ Thrown if
+ Thrown if
+
+
+
+ Gets the old assembly version number or range.
+
+
+
+ Accepts a version number like "1.2.3.4" or a range like "1.0.0.0-1.1.65535.65535".
+
+
+ Thrown if
+
+
+
+ A caching plugin loader.
+
+
+
+ The cache alleviates the need to search, load and preprocess individual plugin files
+ by storing an aggregate summary of the plugin files into the per-user local
+ application data path based on a hash of the plugin paths and preprocessor constants.
+
+
+
+
+
+ Loads plugins by recursively scanning plugin paths in the file system
+ for *.plugin files that contain plugin metadata.
+
+
+
+
+ Populates a plugin catalog with plugin metadata.
+
+
+
+
+ Adds a plugin path.
+
+
+
+ If the plugin path refers to a specific plugin file, it will be loaded when
+ the catalog is populated. Otherwise if the plugin path refers to a directory,
+ then the directory will be scanned for *.plugin files when the catalog is
+ populated.
+
+
+ Thrown if
+
+
+
+ Adds a plugin definition as XML.
+
+ Thrown if
+
+
+
+ Defines a constant to be used by the preprocessor.
+
+ Thrown if
+
+
+
+ Populates a catalog with plugin metadata derived from the currently
+ registered plugin data sources.
+
+ Thrown if
+
+
+
+ Gets or sets the installation id.
+
+
+
+
+ Creates a file system plugin loader.
+
+
+
+
+
+
+
+
+
+
+
+
+ Loads plugins by recursively searching the plugin paths for *.plugin files.
+
+
+
+
+
+
+ Gets the list of plugin paths.
+
+
+
+
+ Gets the collection of initial preprocessor constants.
+
+
+
+
+ The plugin callback type used by
+
+
+
+ Creates a caching plugin loader.
+
+
+
+
+ Clears the plugin cache belonging to the current user.
+
+
+
+
+
+
+ Provides information used to register a component.
+
+
+
+
+ Creates a component registration.
+
+ Thrown if
+
+
+
+ Gets or sets the plugin to which the component will belong.
+
+ Thrown if
+
+
+
+ Gets or sets the service implemented by the component.
+
+ Thrown if
+
+
+
+ Gets or sets the component id.
+
+ Thrown if
+
+
+
+ Gets or sets the component type name, or null to use the default component type specified by the service.
+
+
+
+
+ Gets or sets the component properties.
+
+ Thrown if
+
+
+
+ Gets or sets the component handler factory.
+
+ Thrown if
+
+
+
+ Gets or sets the traits properties.
+
+ Thrown if
+
+
+
+ Resolves object dependencies that are discovered during dependency injection
+ with the help of a service locator, a resource locator, and a built in set of conversions.
+
+
+
+ To resolve dependencies, the object dependency resolver applies the following rules:
+
+ - If a configuration argument value was provided then it is converted to an instance
+ of the parameter type (see below).
+ - If the service locator can resolve a service of the parameter type, or if the parameter type
+ is an array and the service locator can resolve one or more services of the array's element type,
+ then those services will be resolved and injected.
+ - If the parameter type is
+
+
+
+ To convert string configuration arguments to the parameter type, the object factory applies the following rules:
+
+ - If the parameter type is an array type, then the configuration argument is split on semicolons
+ (';') and each part is independently converted to a value of the array's element type and then
+ packaged into an array.
+ - If the parameter type is a string, then no conversion is required so the value is used as-is.
+ - If the value looks like "${component.id}" and there is a component registered with the specified
+ component id that satisfies the service described by the parameter type then that component is injected.
+ Similarly if the parameter is of type
+ - If the parameter type is an enum then the value is parsed to a
+ value of that enum type, case-insensitively.
+ - If the parameter type is
+ - If the parameter type is
+ - If the parameter type is
+ - If the parameter type is
+ - If the parameter type is
+ - If the parameter type is
+ - If the parameter type is
+ - If the parameter type is
+ - If the parameter type is
+ - If the parameter type is
+ - Otherwise, the value is converted using
+
+
+
+ For information about how the Uri is resolved to a path, see
+
+
+
+
+ Resolves object dependencies and parameters.
+
+
+
+
+ Resolves a dependency.
+
+ An object that describes whether the dependency was satisfied and the value it was assigned.
+ Thrown if
+
+
+
+ Creates an object dependency resolver.
+
+ Thrown if
+
+
+
+
+
+ Default plugin implementation.
+
+
+
+
+ Represents an activated plugin.
+
+
+
+ The runtime provides a default implementation of this interface for plugins.
+ However, plugins authors may choose to provide a custom implementation
+ to control the plugin lifecycle and provide additional services to the
+ runtime. Initialization concerns should be performed by the constructor
+ and disposal should be performed by implementing
+
+
+
+
+
+
+
+
+ Specifies the result of an attempt to resolve a dependency.
+
+
+
+
+ Creates a result object that represents a satisfied dependency.
+
+ The result object.
+
+
+
+ Creates a result object that represents an unsatisfied dependency.
+
+ The result object.
+
+
+
+ Returns true if the dependency was satisfied.
+
+
+
+
+ Returns the value used to satisfy the dependency.
+
+ Thrown if the dependency was not satisfied.
+
+
+
+ A handle for a lazily instantiated component and its traits.
+
+
+
+
+ Creates an instance of a typed component handle for the specified descriptor.
+
+ The appropriately typed component handle.
+ Thrown if
+ Thrown if the described component's service type or traits type cannot be resolved.
+
+
+
+ Creates an instance of a typed component handle for the specified descriptor.
+
+ The appropriately typed component handle.
+ The service type.
+ The traits type.
+ Thrown if
+ Thrown if the described component's service or traits are not compatible with a handle of this type.
+ Thrown if the described component's service type or traits type cannot be resolved.
+
+
+
+ Creates an instance of a typed component handle for the specified component and traits instance.
+ The component handle will have a stub component descriptor for testing purposes.
+
+ The service type.
+ The traits type.
+ The appropriately typed component handle.
+ Thrown if
+ Thrown if the described component's service or traits are not compatible with a handle of this type.
+ Thrown if the described component's service type or traits type cannot be resolved.
+
+
+
+ Returns true if the specified type is a component handle type.
+
+ True if the type is a component handle type.
+ Thrown if
+
+
+
+ Gets the component instance.
+
+ The component instance.
+ Thrown if the component cannot be resolved.
+
+
+
+ Gets the component traits.
+
+ The component traits.
+ Thrown if the traits cannot be resolved.
+
+
+
+ Returns the component's id.
+
+ The component id.
+
+
+
+ Gets the component descriptor.
+
+
+
+
+ Gets the component id.
+
+
+
+
+ Gets the service type.
+
+ The service type.
+
+
+
+ Gets the traits type.
+
+ The traits type.
+
+
+
+ Describes a component.
+
+
+
+ The descriptor is used to query declarative information about the component
+ and to load associated code and resources.
+
+
+
+
+
+ Resolves the component type.
+
+
+
+ This method may cause plugin resources to be loaded. The caller
+ should therefore assume that the operation is potentially time-consuming
+ and may fail.
+
+
+ The component type.
+ Thrown if an error occurs during resolution.
+
+
+
+ Resolves the component handler.
+
+
+
+ This method may cause plugin resources to be loaded. The caller
+ should therefore assume that the operation is potentially time-consuming
+ and may fail.
+
+
+ The component handler.
+ Thrown if an error occurs during resolution.
+
+
+
+ Resolves the component instance.
+
+
+
+ This method may cause plugin resources to be loaded. The caller
+ should therefore assume that the operation is potentially time-consuming
+ and may fail.
+
+
+ The component instance.
+ Thrown if an error occurs during resolution.
+
+
+
+ Resolves the traits handler.
+
+
+
+ This method may cause plugin resources to be loaded. The caller
+ should therefore assume that the operation is potentially time-consuming
+ and may fail.
+
+
+ The traits handler.
+ Thrown if an error occurs during resolution.
+
+
+
+ Resolves the component traits.
+
+
+
+ This method may cause plugin resources to be loaded. The caller
+ should therefore assume that the operation is potentially time-consuming
+ and may fail.
+
+
+ The specific subclass of
+
+ The component traits.
+ Thrown if an error occurs during resolution.
+
+
+
+ Gets the descriptor of the plugin that provides the component.
+
+
+
+
+ Gets the descriptor of the service implemented by the component.
+
+
+
+
+ Gets the component's id.
+
+
+
+
+ Gets the component type name.
+
+
+
+
+ Gets the component handler factory.
+
+
+
+
+ Gets the parameter properties.
+
+
+
+
+ Gets the traits properties.
+
+
+
+
+ Returns true if the plugin that provides the component is disabled
+ or if the service implemented by the component is disabled.
+
+
+
+
+ Gets the reason the component was disabled.
+
+ Thrown if
+
+
+
+ A typed handle for a lazily instantiated component and its traits.
+
+ The type of service implemented by the component.
+ The type of traits provided by the component.
+
+
+
+ Gets the component instance.
+
+ The component instance.
+ Thrown if the component cannot be resolved.
+
+
+
+ Gets the component traits.
+
+ The component traits.
+ Thrown if the traits cannot be resolved.
+
+
+
+
+
+
+
+ A resource locator implementation based on a registry.
+
+
+
+
+ Locates resources owned by plugins and other components.
+
+
+
+
+ Resolves a resource Uri to a full path.
+
+
+
+ - file: Maps to the file's local path.
+ - plugin: Maps to a resource within the plugin's base directory, specified in the form: "plugin://Plugin.Id/RelativePath/To/Resource.txt".
+
+
+ The resolved full path of the resource.
+ Thrown if
+ Thrown if the uri cannot be resolved.
+
+
+
+ Creates a resource locator based on a registry.
+
+ Thrown if
+
+
+
+
+
+ Gets the registry.
+
+
+
+
+ A handler factory for pre-manufactured instances.
+
+
+
+
+ A handler factory creates handlers for activating plugin, component and traits instances.
+
+
+
+
+ Creates a handler.
+
+ The handler.
+
+
+
+ Creates an instance handler factory given a particular pre-manufactured instance.
+
+ Thrown if
+
+
+
+
+
+ A handler activates instances of a plugin, component or traits object.
+
+
+
+
+ Activates the instance.
+
+ The activated instance.
+
+
+
+ A plugin catalog describes the configuration of a collection of plugins that
+ are to be installed in a registry.
+
+
+
+
+ Adds a plugin to the catalog.
+
+ Thrown if
+
+
+
+ Registers the contents of the catalog into the specified registry.
+
+ Thrown if
+
+
+
+ Builds objects and performs dependency injection via a service locator.
+
+
+
+ The object factory examines the object type to discover required and optional
+ dependencies that are to be injected. Required dependencies are specified by
+ the parameters of the constructor with the most parmaeters. Optional dependencies
+ are specified by settable properties.
+
+
+ If an optional dependency cannot be resolved then that dependency is ignored.
+ If any required dependency cannot be satisifed then the object construction fails and a
+
+
+ To resolve each dependency, the factory consults an
+
+
+
+
+ Creates an object factory.
+
+ Thrown if
+
+
+
+ Creates an instance of the object described by this factory.
+
+ The instance, not null.
+
+
+
+ A plugin catalog implementation that verifies plugin dependencies and assembly references.
+
+
+
+
+ Creates an empty plugin catalog.
+
+
+
+
+
+
+
+
+ Preprocesses XML based on the presence of processing instructions.
+
+
+
+ Recognizes the following directives:
+
+
+ <?ifdef CONSTANT?>: Begins conditional block whose contents are output only if CONSTANT is defined.<?ifndef CONSTANT?>: Begins conditional block whose contents are output only if CONSTANT is not defined.<?else?>: Begins alternative conditional block whose contents are output only if the previous ifdef/ifndef condition was not met.<?endif?>: Ends conditional block.<?define CONSTANT?>: Defines a new constant.
+
+
+
+
+ Creates an Xml preprocessor.
+
+
+
+
+ Defines a preprocessor constant.
+
+ Thrown if
+
+
+
+ Returns true if the specified preprocessor constant is defined.
+
+ Thrown if
+ True if the constant is defined.
+
+
+
+ Preprocesses and copies an Xml document from a reader into a writer.
+
+ Thrown if
+ Thrown if the input Xml is malformed
+ such as if it contains unbalanced ifdef/endif pairs.
+
+
+
+ Provides information used to register a service.
+
+
+
+
+ Creates a service registration.
+
+ Thrown if
+
+
+
+ Gets or sets the plugin to which the service will belong.
+
+ Thrown if
+
+
+
+ Gets or sets the service id.
+
+ Thrown if
+
+
+
+ Gets or sets the service type name.
+
+ Thrown if
+
+
+
+ Gets or sets the default component type name, or null if none.
+
+
+
+
+ Gets or sets the traits handler factory.
+
+ Thrown if
+
+
+
+ Provides a view of registered components along with methods for resolving them.
+
+
+
+
+ Gets descriptors for all components that implement a service with a given id.
+
+ The list of component descriptors.
+ Thrown if
+
+
+
+ Gets descriptors for all components that implement a service of a given type.
+
+ The list of component descriptors.
+ Thrown if
+
+
+
+ Gets descriptors for all components that implement a service of a given type by name.
+
+ The list of component descriptors.
+ Thrown if
+
+
+
+ Gets a component descriptor by its id, or null if not found.
+
+ The component descriptor, or null if not found.
+ Thrown if
+
+
+
+ Provides information used to register a plugin.
+
+
+
+
+ Creates a plugin registration.
+
+ Thrown if
+
+
+
+ Gets or sets the plugin id.
+
+ Thrown if
+
+
+
+ Gets or sets the plugin type name.
+
+ Thrown if
+
+
+
+ Gets or sets the base directory.
+
+ Thrown if
+
+
+
+ Gets or sets a condition governing the activation of the plugin,
+ or null if there is no condition. The plugin will be disabled if a
+ condition is provided but is not satisfied.
+
+
+
+
+ Gets or sets the recommended installation path for the plugin files relative to
+ the runtime installation directory, or null if there is no preference.
+
+
+
+
+ Gets or sets the paths of files that belong to the plugin relative to the
+ plugin base directory.
+
+ Thrown if
+
+
+
+ Gets or sets the list of plugin assembly bindings.
+
+ Thrown if
+
+
+
+ Gets or sets the list of probing paths in which to
+ attempt to locate referenced assemblies.
+
+ Thrown if
+
+
+
+ Gets or sets the list of plugin dependencies.
+
+ Thrown if
+
+
+
+ Gets or sets the plugin properties.
+
+ Thrown if
+
+
+
+ Gets or sets the traits properties.
+
+ Thrown if
+
+
+
+ Gets or sets the plugin handler factory.
+
+ Thrown if
+
+
+
+ Provides a configurable registry of plugins, services and components.
+
+
+
+
+ A registry of plugins, services and components.
+
+
+
+ The registry is used to enumerate and resolve plugins, services and components
+ in the system. There is typically one registry singleton in any given process
+ which holds references to all other components as required.
+
+
+ At this time, the components managed by the runtime all have a singleton
+ lifecycle. This behavior may change in the future to permit the construction
+ of transient or context-dependent components.
+
+
+
+
+
+ Registers a plugin and returns its descriptor.
+
+ The new plugin descriptor.
+ Thrown if
+ Thrown if there is already a plugin registered with the same id
+ or if the registration contains errors.
+
+
+
+ Registers a service and returns its descriptor.
+
+ The new service descriptor.
+ Thrown if
+ Thrown if there is already a service registered with the same id or type name
+ or if the plugin does not belong to this registry.
+
+
+
+ Registers a component and returns its descriptor.
+
+ The new component descriptor.
+ Thrown if
+ Thrown if there is already a component registered with the same id
+ or if the plugin or service does not belong to this registry or if the component implements a service
+ provided by a plugin that was not listed as a plugin dependency of the component's plugin.
+
+
+
+ Gets a view of all registered plugins.
+
+
+
+
+ Gets a view of all registered components.
+
+
+
+
+ Gets a view of all registered services.
+
+
+
+
+ Gets a service locator based on the contents of the registry.
+
+
+
+
+ Gets a resource locator based on the contents of the registry.
+
+
+
+
+ Creates an empty registry.
+
+
+
+
+
+
+
+
+
+
+
+
+ Disposes the registry.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Provides a view of registered plugins along with methods for resolving them.
+
+
+
+
+ Gets a plugin descriptor by its id, or null if not found.
+
+ The plugin descriptor, or null if not found.
+ Thrown if
+
+
+
+ Stores the data managed by the registry so that it can be safely guarded by a reader/writer lock.
+
+
+
+
+ Provides a view of registered components along with methods for resolving them.
+
+
+
+
+ Gets a service descriptor by its type, or null if not found.
+
+ The service descriptor, or null if not found.
+ Thrown if
+
+
+
+ Gets a service descriptor by its type name, or null if not found.
+
+ The service descriptor, or null if not found.
+ Thrown if
+
+
+
+ Gets a service descriptor by its id, or null if not found.
+
+ The service descriptor, or null if not found.
+ Thrown if
+
+
+
+ Describes a service.
+
+
+
+ The descriptor is used to query declarative information about the service
+ and to load associated code and resources.
+
+
+
+
+
+ Resolves the service type.
+
+
+
+ The service type is usually an interface but it may also be an abstract class.
+
+
+ This method may cause plugin resources to be loaded. The caller
+ should therefore assume that the operation is potentially time-consuming
+ and may fail.
+
+
+ The service type.
+ Thrown if an error occurs during resolution.
+
+
+
+ Resolves the traits type.
+
+
+
+ The traits type is a subclass of
+
+ This method may cause plugin resources to be loaded. The caller
+ should therefore assume that the operation is potentially time-consuming
+ and may fail.
+
+
+ This method effectively performs two lookups. First it resolves the service
+ type then it searches for the associated
+
+ The traits type.
+ Thrown if an error occurs during resolution.
+
+
+
+ Gets the descriptor of the plugin that provides the service.
+
+
+
+
+ Gets the service's id.
+
+
+
+
+ Gets the service type name.
+
+
+
+ The service type is usually an interface but it may also be an abstract class.
+
+
+
+
+
+ Gets the default component type name for this service, or null if there is no default component type.
+
+
+
+ The default type must be a concrete class.
+
+
+
+
+
+ Gets the traits handler factory.
+
+
+
+
+ Returns true if the plugin that provides the service is disabled.
+
+
+
+
+ Gets the reason the service was disabled.
+
+ Thrown if
+
+
+
+ Describes a plugin.
+
+
+
+ The descriptor is used to query declarative information about the plugin
+ and to load associated code and resources.
+
+
+
+
+
+ Gets an enumeration of all absolute paths to be searched in order to find a given resource.
+
+
+
+ The enumeration consists of all combinations of the base directory and probing paths, including
+ the use of an optional "bin" directory. For example, if the base directory is "C:\Base", and the
+ probing paths list contains "Probing", and we are looking for "resource.dll" then this method will
+ return the following paths: "C:\Base\resource.dll", "C:\Base\bin\resource.dll", "C:\Base\Probing\resource.dll"
+ and "C:\Base\Probing\bin\resource.dll".
+
+
+ If the resource path is absolute then the returned search paths will consist of just that absolute path.
+
+
+ An enumeration of search paths.
+
+
+
+ Resolves the plugin type.
+
+
+
+ The plugin type should be a class that implements
+
+ This method may cause plugin resources to be loaded. The caller
+ should therefore assume that the operation is potentially time-consuming
+ and may fail.
+
+
+ The plugin type.
+ Thrown if an error occurs during resolution.
+
+
+
+ Resolves the plugin handler.
+
+
+
+ This method may cause plugin resources to be loaded. The caller
+ should therefore assume that the operation is potentially time-consuming
+ and may fail.
+
+
+ The plugin handler.
+ Thrown if an error occurs during resolution.
+
+
+
+ Resolves the plugin instance.
+
+
+
+ This method may cause plugin resources to be loaded. The caller
+ should therefore assume that the operation is potentially time-consuming
+ and may fail.
+
+
+ The plugin instance.
+ Thrown if an error occurs during resolution.
+
+
+
+ Resolves the traits handler.
+
+
+
+ This method may cause plugin resources to be loaded. The caller
+ should therefore assume that the operation is potentially time-consuming
+ and may fail.
+
+
+ The traits handler.
+ Thrown if an error occurs during resolution.
+
+
+
+ Resolves the plugin traits.
+
+
+
+ This method may cause plugin resources to be loaded. The caller
+ should therefore assume that the operation is potentially time-consuming
+ and may fail.
+
+
+ The plugin traits.
+ Thrown if an error occurs during resolution.
+
+
+
+ Disables the plugin.
+
+ Thrown if
+
+
+
+ Gets the plugin's id.
+
+
+
+
+ Gets the plugin type name.
+
+
+
+ The plugin type should be a class that implements
+
+
+
+
+ Gets the plugin handler factory.
+
+
+
+
+ Gets the base directory that contains the plugin's definition and associated resources.
+
+
+
+
+ Gets the list of plugin assembly bindings.
+
+
+
+
+ Gets the plugin properties.
+
+
+
+
+ Gets the traits properties.
+
+
+
+
+ Returns true if the plugin is disabled.
+
+
+
+
+ Gets the reason the plugin was disabled.
+
+ Thrown if
+
+
+
+ Gets the list of plugins upon which this plugin depends directly or indirectly.
+
+
+
+
+ Gets the list of additional relative or absolute probing paths in which to attempt to locate
+ referenced assemblies.
+
+
+
+
+ Gets a condition governing the activation of the plugin,
+ or null if there is no condition. The plugin will be disabled if a
+ condition is provided but is not satisfied.
+
+
+
+
+ Gets the recommended installation path for the plugin files relative to
+ the runtime installation directory, or null if there is no preference.
+
+
+
+
+ Gets the paths of files that belong to the plugin relative to the
+ plugin base directory.
+
+
+
+
+ Describes the traits of a
+
+
+
+ Creates a plugin traits object.
+
+
+
+
+ Gets the localized display name of the plugin.
+
+
+
+
+ Gets or sets the plugin version number, or null if none.
+
+
+
+
+ Gets or sets the plugin icon, or null if none.
+
+
+
+ The image should be 32x32 pixels in size.
+
+
+
+
+
+ Gets or sets the localized plugin description, or null if none.
+
+
+
+
+ A handler factory for singletons.
+
+
+
+
+
+
+ Specifies the traits class associated with a service contract.
+
+
+
+ This attribute enables the runtime to bind a service contract to its traits.
+ If no attribute is specified then it is presumed that the service has an empty
+ traits class (represented by
+
+
+
+
+ Binds a traits interface to a service contract.
+
+ Thrown if
+ Thrown if
+
+
+
+ Gets the traits type, a subclass of
+
+
+
+ Recognizes .Net assemblies by looking for the CLR header within the file.
+
+
+
+
+ Recognizes the type of a file.
+
+
+
+
+ Returns true if the recognizer recognizes the file described by the file inspector.
+
+
+
+ This method is guaranteed to be called only when the file already matches the
+ constraints described by the file type recognizer's traits. For example, if the
+ traits specify a file name regular expression then the recognizer will only be
+ called if the file in question actually has a matching name.
+
+
+ True if the file type was recognized.
+
+
+
+
+
+ Describes a file type.
+
+
+
+ File type objects are unique and can be compared for equality by reference.
+
+
+
+
+
+ Creates a file type object.
+
+ Thrown if
+ Thrown if
+
+
+
+ Returns true if this file type is equal to or is a subtype of some other type.
+
+ True if the condition is satisfied.
+ Thrown if
+
+
+
+ Returns true if this file type is equal to or is a subtype of any of the specified other types.
+
+ True if the condition is satisfied.
+ Thrown if
+
+
+
+
+
+ Gets the id of the file type.
+
+
+
+
+ Gets the file type description.
+
+
+
+
+ Gets the super type of this file type, or null if none.
+
+
+
+
+ A built-in file type manager that identified file types based on a
+ set of registered
+
+
+
+ Provides services related to determining the type of a file.
+
+
+
+
+ Gets information about a registered file type by its id.
+
+ The associated file type information, or null if not found.
+ Thrown if
+
+
+
+ Gets information about all registered file types.
+
+ The list of all registered file types.
+
+
+
+ Identifies the type of a file by consulting the set of all registered file types.
+
+ The file type of the file, or
+ Thrown if
+ Thrown if the file cannot be accessed.
+
+
+
+ Identifies the type of a file by consulting the set of all registered file types.
+
+ The file type of the file, or
+ Thrown if
+ Thrown if the file cannot be accessed.
+
+
+
+ Identifies the type of a file by consulting only the specified list of file type candidates.
+
+
+
+ This is more efficient when we are interested in only a few possible results.
+
+
+ The file type of the file, or
+ Thrown if
+ Thrown if the file cannot be accessed.
+
+
+
+ Identifies the type of a file by consulting only the specified list of file type candidates.
+
+
+
+ This is more efficient when we are interested in only a few possible results.
+
+
+ The file type of the file, or
+ Thrown if
+ Thrown if the file cannot be accessed.
+
+
+
+ Gets a file type used to identify a file of unknown type.
+
+
+
+
+ Creates a file type manager.
+
+ Thrown if
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Provides a mechanism for inspecting the metadata and contents of a particular file.
+
+
+
+
+ Tries to get the file info associated with the original path of the file.
+
+ True if the file info was available.
+
+
+
+ Tries to get the contents of the file as a string.
+
+ True if the file contents were available.
+
+
+
+ Tries to get the file stream opened for reading.
+
+
+
+ The caller does not need to close the stream; it will be automatically
+ released by the file inspector when finished.
+
+
+ True if the file stream was available.
+
+
+
+ Provides metadata about a
+
+
+
+ Creates traits for a file type recognizer.
+
+ Thrown if
+ Thrown if
+
+
+
+ Gets the file type id.
+
+
+
+
+ Gets the file type description.
+
+
+
+
+ Gets or sets the id of the file type, or null if none.
+
+
+
+
+ Specifies a regular expression used to identify the type of a file by its name,
+ or null if none. The matching is performed case-insensitively.
+
+
+
+
+ Specifies a regular expression used to identify the type of a file by its contents,
+ or null if none. The matching is performed case-insensitively.
+
+
+
+
+ A file inspector that opens a file only on demand as needed.
+
+
+
+
+ Creates a file inspector for the file describe the specified file info object.
+
+ Thrown if
+
+
+
+
+
+
+
+
+
+
+
+ Disposes the inspector.
+
+
+
+
+ A simple file type recognizer that does not perform any filtering
+ beyond that which is already specified by its associated traits.
+
+
+
+
+
+
+ A formatting rule for
+
+
+ Formats values as "true" or "false".
+
+
+
+
+
+
+
+
+
+ A formatting rule for
+
+
+ Formats values as two digit hex values like "0xa5".
+
+
+
+
+
+
+
+
+
+ A formatting rule for
+
+
+ Formats values as literals like: "'x'" or "'\n'".
+
+
+
+
+
+
+
+
+
+ A default formatting rule for objects based on using the
+
+
+ This rule has minimum priority so that
+ all other formatting rules should override it in principle.
+
+
+
+
+
+ Creates a conversion to string formatting rule.
+
+ Thrown if
+
+
+
+
+
+
+
+ A formatting rule for
+
+
+ Formats values in the invariant round-trip format like: "yyyy'-'MM'-'dd'T'HH':'mm':'ss'.'fffffffzz".
+
+
+
+
+
+
+
+
+
+ A formatting rule for
+
+
+ Formats values as "dbnull".
+
+
+
+
+
+
+
+
+
+ A formatting rule for
+
+
+ Formats values like: "5.6m".
+
+
+
+
+
+
+
+
+
+ A formatting rule for
+
+
+ Formats values as "\"key\": \"value\"".
+
+
+
+
+
+
+
+
+
+ A formatting rule for
+
+
+ Formats values like: "5.6".
+
+
+
+
+
+
+
+
+
+ A formatting rule for
+
+
+ Formats values as "[1, 2, 3]".
+
+
+
+
+
+
+
+
+
+ Service locator for
+
+
+ Handles the case where the runtime is not initialized by returning a
+
+
+
+
+
+ Gets the global formatter singleton.
+
+
+
+
+ Typical
+
+
+
+ The default formatting rule priority.
+
+
+
+ A rule with this priority will be overridden by all other matching rules.
+
+
+
+
+
+ Generic rule priority.
+
+
+
+ Represents a generic rule that can represent objects
+ of any type structurally.
+
+
+ -20
+
+
+
+ Fallback rule priority.
+
+
+
+ Represents a rule to be applied if the typical case fails.
+
+
+ -10
+
+
+
+ Typical rule priority.
+
+
+
+ This is a good starting point for rule priorities.
+
+
+ 0
+
+
+
+ A better than typical rule.
+
+
+
+ This value should be used for cases where the typical rule is not quite precise enough.
+
+
+ 10
+
+
+
+ The best possible formatting rule priority.
+
+
+
+ A rule with this priority will override all other matching rules.
+
+
+
+
+
+ A formatting rule for
+
+
+ Formats values like: "5", "123", "-12".
+
+
+
+
+
+
+
+
+
+ A formatting rule for
+
+
+ Formats values as "\"key\": \"value\"".
+
+
+
+
+
+
+
+
+
+ A rule-based formatter uses a set of
+
+
+
+ Creates a rule-based formatter.
+
+ Thrown if
+
+
+
+
+
+ A formatting rule for
+
+
+ Formats values as two digit signed hex values like "0x55" and "-0x55".
+
+
+
+
+
+
+
+
+
+ A formatting rule for
+
+
+ Formats values like: "5.6f".
+
+
+
+
+
+
+
+
+
+ A formatting rule for
+
+
+ Formats values as literals like: ""abc\ndef"".
+
+
+
+
+
+
+
+
+
+ A formatting rule that describes the structure of objects in terms of their constituent
+ properties and fields.
+
+
+
+ Describes the object using a format similar to a C# property initializer syntax.
+
+
+ {Foo.SomeType: Property = "Value", Field = "Other value"}
+
+
+
+
+
+
+
+
+
+ A formatter that is used when the runtime is not initialized.
+
+
+
+
+ Creates a stub formatter using only a few built-in formatting rules.
+
+
+
+
+ A formatting rule for
+
+
+ Formats values like: string, MyType.Nested, int[], byte*, similar to C#.
+
+
+
+
+
+
+
+
+
+ A formatting rule for
+
+
+ Formats values as "<root />".
+
+
+
+
+
+
+
+
+
+ Specifies where a
+
+
+
+ Do not create a configuration file.
+
+
+
+
+ Stores the configuration file in the user's temporary directory.
+
+
+
+
+ Stores the configuration file in the application base directory of the hosted components.
+
+
+
+
+ Resolves runtime services.
+
+
+
+
+ Resolves a single component instance that implements a given service type.
+
+ The service type.
+ The component instance that implements the service.
+ Thrown if no component was found
+ or if a component could not be resolved.
+
+
+
+ Resolves a single component instance that implements a given service type.
+
+ The component instance that implements the service.
+ Thrown if
+ Thrown if no component was found
+ or if a component could not be resolved.
+
+
+
+ Resolves all component instances that implement a given service type.
+
+ The service type.
+ The list of component instances that implement the service.
+ Thrown if a component could not be resolved.
+
+
+
+ Resolves all component instances that implement a given service type.
+
+ The list of component instances that implement the service.
+ Thrown if
+ Thrown if a component could not be resolved.
+
+
+
+ Resolves a single component instance with a given component id.
+
+ The component instance.
+ Thrown if no component was found
+ or if a component could not be resolved.
+ Thrown if
+
+
+
+ Resolves a handle for a single component that implements a given service type.
+
+ The service type.
+ The traits type.
+ The handle for the component that implements the service.
+ Thrown if no component was found
+ or if a component could not be resolved.
+
+
+
+ Resolves a handle for a single component that implements a given service type.
+
+ The handle for the component implements the service.
+ Thrown if
+ Thrown if no component was found
+ or if a component could not be resolved.
+
+
+
+ Resolves handles for all components that implement a given service type.
+
+ The service type.
+ The traits type.
+ The list of handles of components that implement the service.
+ Thrown if a component could not be resolved.
+
+
+
+ Resolves handles for all components that implement a given service type.
+
+ The list of handles of components that implement the service.
+ Thrown if
+ Thrown if a component could not be resolved.
+
+
+
+ Resolves a handle for a single component with a given component id.
+
+ The component handle.
+ Thrown if no component was found
+ or if a component could not be resolved.
+ Thrown if
+
+
+
+ Returns true if the there is a service registered with the specified type and it has not been disabled.
+
+
+
+ When this method returns true it does not guarantee that there are any non-disabled components
+ registered that implement the service neither does it guarantee that those components can actually
+ be resolved without error.
+
+
+ True if there is at least one component registered for the given service type.
+ Thrown if
+
+
+
+ Returns true if there is a component registered with the given component id and it has not been disabled.
+
+
+
+ When this method returns true it does not guarantee that the component can actually be resolved
+ without error.
+
+
+ True if there is a component registered with the given component id.
+ Thrown if
+
+
+
+ A logger that dispatches log messages via events and listeners.
+
+
+
+
+ Adds a log listener that will receive log messages dispatched to the runtime logger.
+
+ Thrown if
+
+
+
+ Removes a log listener so that it will no longer receive log messages dispatched to the runtime logger.
+
+ Thrown if
+
+
+
+
+
+ An event that is fired when a log message is received.
+
+
+
+
+ Event arguments for the
+
+
+
+ Creates a log event.
+
+ Thrown if
+
+
+
+ Gets the log severity.
+
+
+
+
+ Gets the log message.
+
+
+
+
+ Gets the exception, or null if none.
+
+
+
+
+ Provides options that control the operation of the test runner.
+
+
+
+
+ Creates a default set of options.
+
+
+
+
+ Clears the collection of properties.
+
+
+
+
+ Adds a property key/value pair.
+
+ Thrown if
+ Thrown if
+
+
+
+ Removes a property key/value pair.
+
+ Thrown if
+
+
+
+ Creates a copy of the options.
+
+ The copy.
+
+
+
+ Gets a read-only collection of configuration properties for the test runner.
+
+
+
+
+ Dispatches test runner events to listeners.
+
+
+
+ Each notification function ensures that the event is safely dispatched
+ via
+
+
+
+
+ Dispatches the
+
+
+
+ Dispatches the
+
+
+
+ Dispatches the
+
+
+
+ Dispatches the
+
+
+
+ Dispatches the
+
+
+
+ Dispatches the
+
+
+
+ Dispatches the
+
+
+
+ Dispatches the
+
+
+
+ Dispatches the
+
+
+
+ Dispatches the
+
+
+
+ Dispatches the
+
+
+
+ Dispatches the
+
+
+
+ Dispatches the
+
+
+
+ Dispatches the
+
+
+
+ Dispatches the
+
+
+
+ Dispatches the
+
+
+
+ Dispatches the
+
+
+
+ Dispatches the
+
+
+
+ Dispatches the
+
+
+
+ Dispatches the
+
+
+
+ Dispatches the
+
+
+
+ Dispatches the
+
+
+
+ Subscribes to another event object such that the events will be forwarded
+ to the handlers registered on this dispatcher.
+
+ Thrown if
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Arguments for an event raised to indicate that a test step has finished execution.
+
+
+
+
+ Initializes the event arguments.
+
+ Thrown if
+
+
+
+ Arguments for an event raised to indicate that a test step has entered a new lifecycle phase.
+
+
+
+
+ Initializes the event arguments.
+
+ Thrown if
+
+
+
+ Gets the lifecycle phase name.
+
+
+
+
+ Arguments for an event raised to indicate that an attachment has been embedded into a test step log stream.
+
+
+
+
+ Initializes the event arguments.
+
+ Thrown if
+
+
+
+ Gets the name of the attachment that was embedded.
+
+
+
+
+ Arguments for an event raised to indicate that a block has been finished within a test step log stream.
+
+
+
+
+ Initializes the event arguments.
+
+ Thrown if
+
+
+
+ Arguments for an event raised to indicate that a section has been started within a test step log stream.
+
+
+
+
+ Initializes the event arguments.
+
+ Thrown if
+
+
+
+ Gets the name of the section that was started.
+
+
+
+
+ Arguments for an event raised to indicate that text has been written to a test step log stream.
+
+
+
+
+ Initializes the event arguments.
+
+ Thrown if
+
+
+
+ Gets the text that was written.
+
+
+
+
+ Arguments for an event raised to indicate that an attachment has been added to a test step log.
+
+
+
+
+ Initializes the event arguments.
+
+ Thrown if
+
+
+
+ Gets the attachment.
+
+
+
+
+ Arguments for an event raised to indicate that a test step dynamically added metadata to itself.
+
+
+
+
+ Initializes the event arguments.
+
+ Thrown if
+
+
+
+ Gets the metadata key.
+
+
+
+
+ Gets the metadata value.
+
+
+
+
+ Arguments for an event raised to indicate that a test step has started execution.
+
+
+
+
+ Initializes the event arguments.
+
+ Thrown if
+
+
+
+ Allows control of command line parsing.
+
+
+
+ Attach this attribute to instance fields of types used
+ as the destination of command line argument parsing.
+
+
+ Command line parsing code from
+
+ Peter Halam .
+
+
+
+
+
+ Allows control of command line parsing.
+
+
+
+
+ The error checking to be done on the argument.
+
+
+
+
+ Returns true if the argument did not have an explicit short name specified.
+
+
+
+
+ The short name of the argument.
+
+
+
+
+ Returns true if the argument did not have an explicit long name specified.
+
+
+
+
+ The long name of the argument.
+
+
+
+
+ The description of the argument.
+
+
+
+
+ The description of the argument value.
+
+
+
+
+ Gets or sets an array of additional synonyms that are silently accepted.
+
+
+
+
+ Used to control parsing of command line arguments.
+
+
+
+ Command line parsing code from
+
+ Peter Halam ,
+
+
+
+
+
+ Indicates that this field is required. An error will be displayed
+ if it is not present when parsing arguments.
+
+
+
+
+ Only valid in conjunction with Multiple.
+ Duplicate values will result in an error.
+
+
+
+
+ Inidicates that the argument may be specified more than once.
+ Only valid if the argument is a collection
+
+
+
+
+ The default type for non-collection arguments.
+ The argument is not required, but an error will be reported if it is specified more than once.
+
+
+
+
+ For non-collection arguments, when the argument is specified more than
+ once no error is reported and the value of the argument is the last
+ value which occurs in the argument list.
+
+
+
+
+ The default type for collection arguments.
+ The argument is permitted to occur multiple times, but duplicate
+ values will cause an error to be reported.
+
+
+
+
+ Parser for command line arguments.
+
+
+
+ The parser specification is infered from the instance fields of the object
+ specified as the destination of the parse.
+ Valid argument types are: int, uint, string, bool, enums
+ Also argument types of Array of the above types are also valid.
+
+
+ Error checking options can be controlled by adding a CommandLineArgumentAttribute
+ to the instance fields of the destination object.
+
+
+ At most one field may be marked with the DefaultCommandLineArgumentAttribute
+ indicating that arguments without a '-' or '/' prefix will be parsed as that argument.
+
+
+ If not specified then the parser will infer default options for parsing each
+ instance field. The default long name of the argument is the field name. The
+ default short name is the first character of the long name. Long names and explicitly
+ specified short names must be unique. Default short names will be used provided that
+ the default short name does not conflict with a long name or an explicitly
+ specified short name.
+
+
+ Arguments which are array types are collection arguments. Collection
+ arguments can be specified multiple times.
+
+
+ Command line parsing code adapted from
+
+ Peter Halam .
+
+
+
+
+
+ Creates a new command line argument parser.
+
+ Thrown if
+
+
+
+ Creates a new command line argument parser.
+
+ Thrown if
+
+
+
+ Parses an argument list.
+
+ True if no parse errors were encountered.
+
+
+
+ Prints a user friendly usage string describing the command line argument syntax.
+
+
+
+
+ Prints a user friendly usage string describing the command line argument syntax in a message box.
+
+ Thrown if
+
+
+
+ A delegate used in error reporting.
+
+
+
+ Command line parsing code from
+
+ Peter Halam ,
+
+
+
+
+
+ Responsible for creating output.
+
+
+
+
+ Initializes new instance of CommandLineOutput.
+
+
+
+
+ Initializes new instance of CommandLineOutput that outputs to specified stream.
+
+
+
+
+ Initializes new instance of CommandLineOutput that outputs to specified stream.
+
+
+
+
+ Prints out a new line.
+
+
+
+
+ Outputs text with specified indentation.
+
+
+
+
+ Outputs text with specified indentation.
+
+
+
+
+ Prints help for a specified argument.
+
+
+
+
+ Output Stream
+
+
+
+
+ Maximum line length allowed before the text will be wraped.
+
+
+
+
+ A base class for implementing robust console applications.
+
+
+
+ The subclass should provide a Main method that creates an instance and
+ calls
+
+
+
+
+
+
+ Runs the program.
+
+ Thrown if
+ Thrown if the program has already started running.
+
+
+
+ Runs the program.
+
+ The program exit code.
+
+
+
+ Handles a fatal exception that escaped the
+ The exit code to return.
+
+
+
+ Parses the arguments.
+
+ True if the arguments were parsed successfully.
+
+
+
+ Displays an error message to the console.
+
+
+
+
+ Displays help text to the console.
+
+
+
+
+ Gets the console, or null if the program is not running.
+
+
+
+
+ Gets or sets the parsed command-line arguments.
+
+
+
+ These argument may be modified prior to calling
+
+ Thrown if
+
+
+
+ Gets the argument parser.
+
+
+
+
+ Gets the command-line output formatter, or null if the program is not running.
+
+
+
+
+ Gets or sets the application name.
+
+ The name, by default this is the program assembly's name
+ Thrown if
+
+
+
+ Gets or sets the application version.
+
+ The version, by default this is the program assembly's version derived
+ using
+ Thrown if
+
+
+
+ Get or sets the application title.
+
+ The title, by default this is constructed from the application's name and version
+ using
+ Thrown if
+
+
+
+ Indicates that this argument is the default argument.
+
+
+
+ '/' or '-' prefix only the argument value is specified.
+
+
+ Command line parsing code from
+
+ Peter Halam ,
+
+
+
+
+
+ Indicates that this argument is the default argument.
+
+
+
+
+ When set to true, the default argument will consume any unrecognized command switches.
+ Otherwise an error will be thrown if an unrecognized switch is used.
+
+
+
+
+ A rich console provides a number of services that enable a console to be
+ shared among several cooperating tasks that are independently updating
+ different portions of the display.
+
+
+
+ One task can be writing to the main body of text while another updates a footer.
+
+
+ The rich console also supports intelligent cancelation of tasks. When
+ the user presses control-C, a cancelation flag is set and an event handler
+ is invoked. Tasks can check for the presence of the cancelation flag even if
+ they started execution after the control-C itself occurred. This provides
+ protection against dropped cancelation requests due to race conditions.
+ If the user presses control-C 3 times within a short interval
+ the rich console assumes that the program has become non-responsive and
+ terminates it.
+
+
+ Finally, the rich console interface can be mocked for testing purposes
+ unlike the standard
+
+
+
+
+ Resets the console colors.
+
+
+
+
+ Sets a pair of delegates that together display a footer at the bottom
+ of the console.
+
+
+
+ The footer can be hidden so that new text can be written
+ from that point. Removes the previous footer and displays the new
+ one automatically if the footer is visible.
+
+
+
+
+
+ Writes a character.
+
+
+
+
+ Writes a string.
+
+
+
+
+ Writes a new line.
+
+
+
+
+ Writes a string followed by a new line.
+
+
+
+
+ Gets a synchronization object that a task can lock to ensure
+ that it is the only thread currently accessing the console.
+
+
+
+
+ Gets or sets whether the cancelation function is enabled.
+ If false, cancelation events will not be sent.
+
+
+
+
+ Gets or sets whether cancelation has occurred.
+
+
+
+ The
+
+
+
+
+ Returns true if the console is being redirected and therefore the
+ output should be as simple as possible.
+
+
+
+ In particular, it may not be possible to set the cursor position,
+ console color or other properties.
+
+
+ Trying to set the console color while output is redirected is tolerated
+ by the system and won't cause an error; but it is pointless. On the other
+ hand cursor positioning or attempting to listen to Ctrl-C will fail with an
+
+
+
+
+
+ Gets the error stream writer.
+
+
+
+
+ Gets the output stream writer.
+
+
+
+
+ Gets or sets the foreground color of the console.
+
+
+
+
+ Gets the zero-based column index the cursor is located at.
+
+ Thrown if
+
+
+
+ Gets the zero-based row index the cursor is located at.
+
+ Thrown if
+
+
+
+ Gets or sets the console's title.
+
+ Thrown if
+
+
+
+ Gets the width of the console.
+
+
+
+ Returns 80 if the console is being redirected.
+
+
+
+
+
+ Gets or sets whether the footer is visible.
+
+
+
+
+ The event raised when console cancelation occurs.
+
+
+
+ If the console cancelation signal is already set when
+ an event handler is added, the event handler will be
+ automatically invoked.
+
+
+
+
+
+ An implementation of
+
+
+ This implementation offers protection against redirection of the
+
+
+
+
+ The application will forcibly terminate if the cancel key is pressed
+
+
+
+
+ The application will forcibly terminate if the cancel key is pressed
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Gets the singleton instance of the native console.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Reads the contents of a response file.
+
+ The plain text contents of the file.
+
+
+
+ A logger that sends all output to the console and displays messages in color
+ according to their status.
+
+
+
+
+ Creates a logger.
+
+ Thrown if
+
+
+
+
+
+ A configuration section handler for Gallio used to register
+ Gallio components in applications and in plugins.
+
+
+
+
+ The name of the Gallio section: "gallio".
+
+
+
+
+
+
+ Utilities for working with AppDomains.
+
+
+
+
+ Creates an AppDomain.
+
+ The new AppDomain.
+
+
+
+ Creates a remote instance of a type within another AppDomain.
+
+
+ This method first uses
+ The remote instance.
+ Thrown if
+
+
+
+ Base implementation of
+
+
+
+ A host represents an environment that may be used to perform various
+ services in isolation.
+
+
+
+ For example, a host might provide the ability to run code in an isolated
+
+
+
+
+
+ Gets a host service that can be used to perform operations within the host's environment.
+
+ Thrown if the host has been disconnected.
+ Thrown if the host has been disposed.
+
+
+
+ Gets a deep copy of the host setup information.
+
+ Thrown if the host has been disposed.
+
+
+
+ Disconnects the host.
+
+ Thrown if the host has been disposed.
+
+
+
+ An event that is raised when the host is disconnected.
+ If the host has already been disconnected, the event is fired immediately.
+
+ Thrown if the host has been disposed.
+
+
+
+ Returns true if the host is local to the creating AppDomain, false if it
+ must be accessed across a remote channel.
+
+
+
+ A local host might not support all configuration options.
+
+
+
+
+
+ Returns true if the host is connected.
+
+
+
+ A host may become disconnected non-deterministically due to a failure in the
+ host's communication channel or some other remote eventuality.
+
+
+ Thrown if the host has been disposed.
+
+
+
+ Creates a host.
+
+ Thrown if
+
+
+
+
+
+
+
+ Initializes the host and connects to the host service.
+
+ Thrown if the host has already been initialized.
+ Thrown if the host has been disposed.
+ Thrown if an exception occurred while connecting to the host.
+
+
+
+
+
+
+
+ Gets the host service.
+
+ The host service, or null if the host service was not available.
+
+
+
+ Releases the host service.
+
+
+
+
+ Disposes the host.
+
+
+
+
+ Throws an exception if the host has been disposed.
+
+
+
+
+ Sets the state of the host to disconnected and notifies clients.
+
+
+
+
+ Attaches the debugger to a process if the host settings require it.
+
+
+
+
+ Detaches the debugger from a process if the host settings require it.
+
+
+
+
+
+
+
+
+
+
+ Gets an reference to the host service, or null if not connected.
+
+
+
+
+ Gets the internal host setup information without copying it.
+
+
+
+
+ Gets the logger.
+
+
+
+
+ Base implementation of
+
+
+
+ A host service enables a local client to interact with a remotely
+ executing hosting environment.
+
+
+
+ A host service implementation may choose to implement a keep-alive
+ mechanism to automatically shut itself down when the service is disposed or
+ when it has not received a ping within a set period of time.
+
+
+
+
+
+ Pings the host to verify and maintain connectivity.
+
+ Thrown if the remote host is unreachable.
+
+
+
+ Asks the host to perform the specified action remotely.
+
+
+
+ The action must be a serializable delegate so that it can be sent
+ to the host and executed. Generally speaking, this means it must either be
+ a delegate for a static method or its target object must be serializable.
+ The argument and result values must also be serializable (or null).
+
+
+ The result value, if any.
+ The argument type.
+ The result type.
+ Thrown if
+
+
+
+ Creates an instance of a remote object given an assembly name and type name.
+
+ The object handle of the instance.
+ Thrown if
+
+
+
+ Creates an instance of a remote object given an assembly path and type name.
+
+ The object handle of the instance.
+ Thrown if
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Internal implementation of
+ The result value, if any.
+ The argument type.
+ The result type.
+
+
+
+ Internal implementation of
+
+
+
+ Internal implementation of
+ The created object handle.
+
+
+
+ Internal implementation of
+ The created object handle.
+
+
+
+ Disposes the host service.
+
+
+
+
+ Throws an exception if the host service has been disposed.
+
+
+
+
+ Provides utilities for working with hosts.
+
+
+
+
+ Creates an instance of an object within a host.
+
+ The type of object to create.
+ The object instance.
+ Thrown if
+
+
+
+ Creates an instance of an object within a host.
+
+ The object instance.
+ Thrown if
+
+
+
+ A specialization of host service designed for hosts that are remotely managed.
+
+
+
+
+ Remotely shuts down the host service.
+
+
+
+
+ An implementation of
+
+
+
+ Creates a local host.
+
+ Thrown if
+
+
+
+
+
+
+
+
+
+
+
+ A factory for initialized
+
+
+
+ An abstract base class for host factories.
+
+
+
+
+ A host factory encapsulates a policy for creating new
+
+
+
+ Creates a host instance.
+
+ The newly created host.
+ Thrown if
+
+
+
+
+
+ Creates the host.
+
+ The host.
+
+
+
+ Gets the component Id of this factory.
+
+
+
+
+ Creates a host factory.
+
+ Thrown if
+
+
+
+
+
+ Initializes the Gallio assembly loading a runtime policies.
+
+
+
+ This type is used only by the standalone Gallio.Loader assembly using late-binding.
+ It should not be used by any other code.
+
+
+
+
+
+ Bootstraps a globally reachable assembly loader within the Gallio installation path.
+
+
+
+ May be used by clients to ensure that Gallio assemblies can be resolved assuming we
+ were able to load the main assembly and access the bootstrap.
+
+
+
+
+
+ Installs a global assembly resolver given the specified runtime path.
+
+ Thrown if
+
+
+
+ Gets the bootstrapped assembly loader.
+
+ Thrown if the bootstrap assembly loader has not been initialized.
+
+
+
+ Filters another logger to exclude messages below a given level of severity.
+
+
+
+
+ Creates a filtered logger.
+
+ Thrown if
+
+
+
+ Creates a filtered logger.
+
+ Thrown if
+
+
+
+
+
+ Gets the minimum severity of the messages that are included in the filtered log.
+
+
+
+
+ Describes the severity of a log message.
+
+
+
+
+ The severity used for debug messages.
+
+
+
+
+ The severity used for informational messages.
+
+
+
+
+ The severity used for important messages.
+
+
+
+
+ The severity used for warning messages.
+
+
+
+
+ The severity used for error messages.
+
+
+
+
+ The Gallio.Runtime.Logging namespace contains types for logging diagnostic output.
+
+
+
+
+ A null implementation of
+
+
+
+ Gets a singleton instance of the null logger.
+
+
+
+
+
+
+ The severity prefix logger wraps another loggers and encodes the severity of a
+ log entry into the log message itself in a standard form.
+
+
+
+ This wrapper is useful when the base logger may not be able to
+ report the severity via other means or when severity information must be
+ reconstructed from plain text.
+
+
+
+
+
+ Creates a prefix logger.
+
+ Thrown if
+
+
+
+
+
+ Parses severity information from log messages encoded by
+
+
+
+ Parses a line of log data.
+
+ True if the message included a severity, false otherwise.
+ Thrown if
+
+
+
+ A logger that writes output to a
+
+
+ To include severity information in the output, wrap this logger with a
+
+
+
+
+ Creates a text logger.
+
+
+
+
+
+
+ Specifies the verbosity of the output.
+
+
+
+
+ Will only display Error and Warning messages.
+
+
+
+
+ Will display Important, Warning and Error messages.
+
+
+
+
+ Will display all messages, except Debug.
+
+
+
+
+ Will display all messages.
+
+
+
+
+ Describes the kind of process that is executing.
+
+
+
+
+ The process is running in the console.
+
+
+
+
+ The process is running interactively.
+
+
+
+
+ The process is running as a Windows service.
+
+
+
+
+ A null message sink discards all messages sent to it.
+
+
+
+
+ Gets the singleton instance of the null message sink.
+
+
+
+
+
+
+ Wraps a
+
+
+
+ Creates a queued message sink.
+
+ Thrown if
+
+
+
+
+
+
+
+ Flushes the queue.
+
+
+
+
+ Wraps a
+
+
+
+ Creates a remote message sink.
+
+ Thrown if
+
+
+
+
+
+ An exception thrown during a messaging failure.
+
+
+
+
+ Creates an exception.
+
+
+
+
+ Creates an exception.
+
+
+
+
+ Creates an exception.
+
+
+
+
+ Creates an exception from serialization info.
+
+
+
+
+ Notifies that a diagnostic log message has been submitted.
+
+
+
+
+
+
+
+
+ Gets or sets the log severity.
+
+
+
+
+ Gets or sets the log message.
+
+
+
+
+ Gets or sets the exception, or null if none.
+
+
+
+
+ The Gallio.Runtime namespace contains types that define the component model, extensibility
+ mechanism and core services used throughout the Gallio infrastructure.
+
+
+
+
+ An implementation of
+
+
+
+ Stores and retrieves user and machine preferences.
+
+
+
+ For the API related to defining new preference panes and control panels
+ refer to the types in the Gallio.UI assembly.
+
+
+
+
+
+ Gets a preference store for the current local user.
+
+
+
+ These preferences are stored in the user's local application data directory.
+
+
+
+
+
+ Gets a preference store for the current roaming user.
+
+
+
+ These preferences are stored in the user's roaming application data directory.
+
+
+
+
+
+ Gets a preference store common to all users of this system.
+
+
+
+ These preferences are stored in the system's common application data directory.
+
+
+ All users can read common preferences but only administratators may
+ edit them. Moreover privilege elevation may be required on Vista and
+ more recent Windows OS's.
+
+
+
+
+
+ Initializes the preference manager.
+
+
+
+
+
+
+
+
+
+
+ A preference set implementation based on storing preference settings within a file.
+
+
+
+
+ Represents a set of related preference settings.
+
+
+
+
+ Obtains a reader for the preference set.
+
+ Thrown if
+
+
+
+ Obtains a reader for the preference set.
+
+ The result of the read function.
+ The read function result type.
+ Thrown if
+
+
+
+ Obtains a writer for the preference set.
+
+ Thrown if
+
+
+
+ Obtains a writer for the preference set.
+
+ The result of the write function.
+ The write function result type.
+ Thrown if
+
+
+
+ Creates a file preference set.
+
+ Thrown if
+
+
+
+
+
+
+
+
+
+
+
+ Gets the preference set file.
+
+
+
+
+ Provides operations for reading preference settings within preference sets.
+
+
+
+
+ Gets a preference setting.
+
+ The setting value or default(T) if none.
+ The setting value type.
+
+
+
+ Gets a preference setting.
+
+ The setting value or
+ The setting value type.
+
+
+
+ Returns true if the preference set contains a preference setting.
+
+ True setting exists.
+
+
+
+ Provides operations for writing preference settings.
+
+
+
+
+ Sets a preference setting.
+
+ The setting value type.
+
+
+
+ Removes a preference setting.
+
+
+
+
+ A preference store implementation based on storing preference sets as files within a directory.
+
+
+
+
+ Stores and retrieves the contents of preference sets.
+
+
+
+
+ Gets the preference set with the specified name.
+
+ The preference set.
+ Thrown if
+ Thrown if
+
+
+
+ Creates a file preference store.
+
+ Thrown if
+
+
+
+ Gets the preference store directory.
+
+
+
+
+
+
+ The Gallio.Runtime.Preferences namespace contains types for loading and
+ saving user preferences.
+
+
+
+
+ The Gallio.Runtime.Preferences.Schema namespace contains the preference store Xml schema.
+
+
+
+
+ Abstract base class for objects whose purpose is to present progress
+ information to the user.
+
+
+
+
+ A progress monitor presenter attaches a progress monitor to a view.
+
+
+
+
+ Presents an observable progress monitor.
+
+ Thrown if
+ Thrown if the presenter does not support being
+ reused to present multiple progress monitors.
+
+
+
+
+
+ Initializes the presenter after a progress monitor has been attached.
+
+
+
+
+ Gets the attached progress monitor.
+
+
+
+
+ An abstract base class to assist with the implementation of conformant
+
+
+
+
+ A progress monitor provider runs a task with progress monitoring
+ and provides clear notification of cancelation in the form of
+ an
+
+
+
+ Runs a task with a progress monitor.
+
+
+
+ The provider should automatically dispose of the progress monitor
+ in case the task forgets to do so. It is also responsible for calling
+
+
+ The provider can choose to execute the task in a different thread
+ but the method should still complete synchronously.
+
+
+ Thrown if the task is canceled.
+
+
+
+ Runs a task which returns a result with a progress monitor.
+
+
+
+ The provider should automatically dispose of the progress monitor
+ in case the task forgets to do so. It is also responsible for calling
+
+
+ The provider can choose to execute the task in a different thread
+ but the method should still complete synchronously.
+
+
+ Thrown if the task is canceled.
+ The type of the result returned by the task.
+
+
+
+
+
+
+
+ Gets a presenter for the progress monitor.
+
+ The presenter.
+
+
+
+ An abstract base class for progress monitors that implements the cancelation
+ semantics only.
+
+
+
+
+ A progress monitor provides facilities for core functionality to report
+ progress of a long running operation.
+
+
+
+ The interface is typically implemented by a UI component such as a progress dialog.
+
+
+ This interface is inspired from IProgressMonitor in the Eclipse API
+ and was derived from the Castle.FlexBridge client-side components.
+
+
+ This interface is mostly not safe for use by multiple concurrent
+ threads. Do not share a progress monitor instance across threads!
+
+
+ The
+
+
+
+
+
+
+ Notifies that the main task is starting.
+
+
+
+ Must be called at most once on the progress monitor.
+
+
+ Not safe for use by multiple concurrent threads.
+
+
+ An object that calls
+ Thrown if
+ Thrown if
+ Thrown if
+
+
+
+ Sets detailed status information for the current task or subtask.
+
+
+
+ A status message is an optional fine-grained description of the current
+ activity being performed. For instance, a status message might specify
+ the name of a file being copied as part of a task that copies many files.
+
+
+ Not safe for use by multiple concurrent threads.
+
+
+ Thrown if
+ Thrown if the task is not running.
+
+
+
+ Notifies that a given number of work units of the main task
+ have been completed.
+
+
+
+ Note that this amount represents an installment,
+ as opposed to a cumulative amount of work done to date. If the sum of this
+ value and the currently completed work units exceeds the total work units
+ to be performed, the excess portion is discarded.
+
+
+ Not safe for use by multiple concurrent threads.
+
+
+ Thrown if
+ Thrown if the task is not running.
+
+
+
+ Notifies that the operation is to be canceled.
+
+
+
+ The method always causes the
+
+ It is safe to call this method before
+
+ Not safe for use by multiple concurrent threads.
+
+
+
+
+
+ Notifies that the work is done, either the main task is completed
+ was cancelled by the user. If already done, the method has no effect.
+
+
+
+ This method automatically sets the amount of work remaining to zero.
+ It also sets the amount of work completed to the total unless it was
+ indeterminate or
+
+ It is safe to call this method without calling
+
+ If there are any currently active subtasks, they are automatically
+ ended by this method exactly as if each subtask's
+
+
+
+
+ Creates a sub-progress monitor that represents a given number of
+ work-units as a sub-task of this progress monitor.
+
+
+
+ Using sub-tasks allows multiple tasks to be composed into longer sequences
+ that each contribute a predetermined portion of the total work.
+
+
+ As the sub-task performs work its parent task is notified of progress
+ in proportion to the number of work units that it represents. Likewise the
+ parent is notified of cancelation if the child is canceled and vice-versa.
+
+
+ It it still necessary to call
+
+ Thrown if
+
+
+
+ Throws an
+ Thrown if
+
+
+
+ Adds or removes an event handler to be called when the operation is canceled.
+
+
+
+ If the operation has already been canceled, then the event handler will be
+ called immediately.
+
+
+ Because the event may be delivered on a different thread from
+ the one executing the main task, it is an error for the handler
+ of this event to call any methods of this
+
+ The event handler should not block or throw exceptions. If it
+ must perform any possibly long-running tasks of its own (such as
+ synchronizing with processing threads) it should queue up an
+ asynchronous task (possibly using the
+
+ Unlike the other members of this interface, adding and removing event
+ handlers is safe for use by multiple concurrent threads.
+
+
+
+
+
+ Returns true if the operation has been canceled.
+
+
+
+ Clients should poll this value periodically or listen for the
+
+
+ Not safe for use by multiple concurrent threads.
+
+
+
+
+
+
+
+
+
+ Disposes the progress monitor, including cleaning up an marking as
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Notifies that the task has actually been canceled.
+
+
+
+ If this is the first time
+
+ This is the ONLY method of the progress monitor that is allowed to
+ be called concurrently from multiple threads. It needs to be this
+ way so that cancelation can be initiated by either participant in the
+ progress monitoring dialog.
+
+
+ True if cancelation has just occurred, false if no
+ state change was performed.
+
+
+
+ Called when
+
+
+ This method is not called by
+
+
+
+
+ Disposes the progress monitor, including cleaning up an marking as
+
+
+
+
+
+
+
+ Displays progress by writing a series of messages to an
+
+
+
+ Create a logged progress monitor presenter.
+
+ Thrown if
+
+
+
+
+
+ Displays progress by writing a series of messages to an
+
+
+
+ Creates a log progress monitor provider.
+
+ Thrown if
+
+
+
+
+
+ The Gallio.Runtime.ProgressMonitoring namespace contains types for reporting
+ progress from long-running operations.
+
+
+
+
+ Creates instances of null progress monitors that do nothing.
+
+
+
+
+ Creates a null progress monitor.
+
+ The null progress monitor.
+
+
+
+ A null progress monitor presenter simply does nothing.
+
+
+
+
+ Gets the singleton instance of the presenter.
+
+
+
+
+
+
+ Runs tasks without reporting any progress.
+
+
+
+ Argument validation and state changes are still noted but they do not have any outward effect.
+
+
+
+
+
+
+
+ Gets the singleton instance of the provider.
+
+
+
+
+ An observable progress monitor tracks validates arguments and tracks the state
+ of the progress monitor but it does not implement any of its own behavior in response
+ to the notifications received.
+
+
+
+ Instead, it is intended to be observed by a presenter that
+ translates state change events into changes of the view.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Called after
+
+
+
+ Called when
+
+
+
+ Called when
+
+
+
+ Called when
+
+
+
+ Called when the active sub-task
+
+
+
+ Called when
+
+
+
+ Called when
+
+
+
+ Called when a state change occurs.
+
+
+
+
+ Called when a new progress monitor is created.
+
+
+
+
+
+
+ Begins a sub-task in a sub-progress monitor.
+
+
+
+
+ Ends a sub-task in a sub-progress monitor.
+
+
+
+
+ Called when a subtask changes in any way, including one of its own subtasks changing.
+
+
+
+
+ Adds or removes an event handler that is called whenever the state of the progress
+ monitor changes in any way.
+
+
+
+
+ Adds or removes an event handler that is called when the task is starting.
+
+
+
+
+ Adds or removes an event handler that is called when the task is finished.
+
+
+
+
+ Adds or removes an event handler that is called whenever a new sub-progress monitor
+ is created so that the observer can attach its event handlers.
+
+
+
+
+ Returns true if
+
+
+ This property is not affected by cancelation.
+
+
+
+
+
+ Returns true if
+
+
+ This property is not affected by cancellation.
+
+
+
+
+
+ Gets the total number of work units to perform, or
+ NaN to indicate that an indeterminate amount of work is
+ to be performed.
+
+
+
+ Returns
+
+
+
+
+ Gets the number of work units completed so far.
+
+
+
+ It is the sum of all values passed to the
+
+ Returns 0 if
+
+
+
+
+ Gets the number of remaining work units to perform, or
+
+
+
+
+ Returns
+
+
+
+
+ Gets the name of the task or an empty string if
+
+
+
+ Gets the current status message set by
+
+
+
+ Gets the active child sub-progress monitor, or null if none.
+
+
+
+
+ Gets the currently active leaf sub-progress monitor, or this one if there are
+ no sub-progress monitors.
+
+
+
+
+ Gets the name of the most deeply nested sub-task, or an empty string if
+ there are no sub-progress monitors.
+
+
+
+
+ Gets the status of the most deeply nested sub-task, or the status of this
+ task if there are no sub-progress monitors.
+
+
+
+
+ A standard sub-progress monitor implementation that notifies its parent as work is performed.
+
+
+
+
+ Creates a sub-progress monitor.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ A remote progress monitor is a serializable wrapper for another progress monitor.
+
+
+
+ The wrapper can be passed to another AppDomain and communication occurs over
+ .Net remoting.
+
+
+ The implementation is defined so as to guard against latency and failures
+ in the remoting channel.
+
+
+
+
+
+ Creates a wrapper for the specified progress monitor.
+
+ Thrown if
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Forwards messages to the host's progress monitor.
+
+
+
+
+ Dispatches events to the remote progress monitor.
+
+
+
+
+ A console progress monitor presenter displays a simple tally of the amount of work
+ to be done on the main task as a bar chart.
+
+
+
+ The progress monitor responds to cancelation events at the console.
+
+
+
+
+
+ Creates a console presenter for a progress monitor.
+
+ Thrown if
+
+
+
+
+
+ It can happen that we'll receive all kinds of weird input because
+ task names and status messages can be derived from user-data.
+
+
+
+ Make sure it doesn't corrupt the display integrity.
+
+
+
+
+
+ A console progress monitor displays a simple tally of the amount of work
+ to be done on the main task as a bar chart.
+
+
+
+ The progress monitor responds to cancelation events at the console.
+
+
+
+
+
+ Creates a rich console progress monitor provider.
+
+ Thrown if
+
+
+
+
+
+ Provides a reference to the newly created sub-progress monitor.
+
+
+
+
+ Creates an event object.
+
+ Thrown if
+
+
+
+ Gets the newly created sub-progress monitor.
+
+
+
+
+ Represents a task to be executed with a progress monitor.
+
+
+
+
+ Represents a task to be executed with a progress monitor.
+
+ The type of the result returned by the task.
+
+
+
+ A progress monitor task cookie represents a task in progress.
+
+
+
+ When it is disposed, the corresponding
+
+
+
+
+ Creates an object representing a task in progress.
+
+ Thrown if
+
+
+
+ Marks the task as finished.
+
+
+
+ Equivalent to calling
+
+
+
+
+ A service locator implementation based on a registry.
+
+
+
+
+ Creates a service locator based on a registry.
+
+ Thrown if
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Gets the registry.
+
+
+
+
+ Abstract base class for an aggregate data set that combines a list of data
+ sets according to some algorithm.
+
+
+
+
+ Adds a data set to the aggregate.
+
+ Thrown if
+ Thrown if
+
+
+
+ Gets the immutable list of combined data sets.
+
+
+
+
+ A data set constructed from an enumerated sequence of values.
+
+
+
+
+ Creates a column sequence data set with optional metadata.
+
+ Thrown if
+
+
+
+
+
+
+
+
+
+ The combinatorial join strategy combines items by constructing the cartesian
+ product of the items of each provider.
+
+
+
+
+ A join strategy combines items from multiple providers into products
+ according to some algorithm.
+
+
+
+ A join strategy performs much the same purpose as a "JOIN" in
+ query languages. It specifies how items from multiple providers are to
+ be correlated to create a sequence of aggregate items.
+
+
+
+
+
+ Joins the items from each provider into a sequence of aggregate items.
+
+
+
+ The number of elements in each item-list must equal the number
+ of providers in the
+
+ An enumeration of item-lists consisting of exactly one item from
+ each provider and indexed in the same order as the
+
+
+
+ Gets the singleton instance of the strategy.
+
+
+
+
+
+
+ The concatenation merge strategy combines the items from multiple providers
+ by simply concatenating the items in the order in which they
+ appear and proceeding from one provider to the next until all providers
+ have been fully processed.
+
+
+
+
+ A merge strategy combines items from multiple providers into a sequence
+ according to some algorithm.
+
+
+
+ A merge strategy performs much the same purpose as a "UNION" or other
+ combinator in query languages. It specifies how to select items among
+ multiple providers to create an aggregate sequence of items.
+
+
+
+
+
+ Merges the items from each provider into a new sequence.
+
+ The merged sequence of items.
+
+
+
+ Gets the singleton instance of the strategy.
+
+
+
+
+
+
+ A CSV data set retrieves fields from a CSV document as strings.
+
+
+
+ If the CSV document has a header, then it is interpreted as the names of the
+ columns. Columns with names in brackets, such as "[ExpectedException]",
+ are interpreted as containing metadata values associated with the named key.
+
+
+
+
+
+ Creates a CSV data set.
+
+ Thrown if
+
+
+
+
+
+
+
+ Gets the name of the location that is providing the data, or null if none.
+
+
+
+ The data location name and line number are exposed as
+
+
+
+ The default value is null.
+
+
+
+
+ Gets or sets the field delimiter character.
+
+
+ The default value is ',' (comma).
+
+
+
+
+ Gets or sets a character that indicates that a line in the source represents a comment.
+ May be set to '\0' (null) to disable comment handling.
+
+
+
+ Comment lines are excluded from the record set.
+
+
+
+ The default value is '#' (pound).
+
+
+
+
+ Gets or sets whether the CSV document has a header that should be used to provide
+ aliases for indexed columns.
+
+
+ The default value is 'false' which indicates that the file does not have a header.
+
+
+
+
+
+
+ Reads data from a Comma Separated Values document.
+
+
+
+ The document format simply consists of sequential lines of delimited field values.
+
+ - The standard delimiter is ',' (comma) but it may be overridden using
+ - Empty lines are considered to be records with one empty field.
+ - Lines that begin with a special
+ - Field values may be quoted using '"' (quote) characters. The quotes will be omitted from the record set.
+ Quotes may be escaped by doubling them within a quoted field.
+ - Unbalanced quotes are tolerated but may produce unexpected results.
+ - Excess whitespace is trimmed unless quoted.
+ - The document may contain a header consiting of field names but the reader does not interpret it in any
+ special way. It will simply be returned to the client as an ordinary record.
+
+
+
+
+
+
+ Creates a CSV reader.
+
+ Thrown if
+
+
+
+ Closes the reader.
+
+
+
+
+ Reads the list of fields that belong to the next record in the document.
+ Returns null at the end of the document.
+
+ The record contents as an array of field values, or null if at the end of the document.
+ Thrown if an I/O error occurs.
+
+
+
+ Gets or sets the field delimiter character.
+
+
+ The default value is ',' (comma).
+
+
+
+
+ Gets or sets a character that indicates that a line in the source represents a comment.
+ May be set to '\0' (null) to disable comment handling.
+
+
+
+ Comment lines are excluded from the record set.
+
+
+
+ The default value is '#' (pound).
+
+
+
+
+ Gets the 1-based line number of the previously returned record,
+ or 0 if no lines have been read yet.
+
+
+
+
+ A data binding object describes how a data binding is to take place.
+
+
+
+ This class provides support for optional path-based and index-based lookup. Subclasses
+ may provide additional properties that are recognized by special kinds of data sets
+ to modify how a bound value is resolved.
+
+
+
+
+
+ Creates a new data binding with an optional index and path.
+
+
+
+
+ Creates a clone of the data binding with a different index.
+
+ The cloned binding.
+
+
+
+
+
+
+
+
+
+ Returns a debug representation of the binding as a string.
+
+ The string representation.
+
+
+
+ Gets an optional binding index that describes how to locate the bound value
+ in a data set that is structured as an ordered tuple, such as the ordinal index
+ of a cell in an array. Null if none.
+
+
+
+ The default binding index for a test parameter may be its ordinal index
+ in the parameter array. A data set can take advantage of this convention by
+ treating the binding index.
+
+
+
+
+
+ Gets an optional binding path that describes how to locate the bound value
+ in the data set, such as a column name or an XPath expression. Null if none.
+
+
+
+ The default binding path for a test parameter may be the name of the test parameter.
+ A data set can take advantage of this convention by treating the binding path as a
+ case-insensitive name where appropriate.
+
+
+
+
+
+ The type of exception thrown when data binding operations fail.
+
+
+
+
+ Creates an exception.
+
+
+
+
+ Creates an exception.
+
+
+
+
+ Creates an exception with an associated data binding.
+
+
+
+
+ Creates an exception.
+
+
+
+
+ Creates an exception with an associated data binding.
+
+
+
+
+ Creates an exception from serialization info.
+
+
+
+
+ An data source object provides a simple way of aggregating data sets
+ together. It also provides a simple translation mechanism for mapping
+ binding paths to binding indexes which is useful for providing named
+ aliases for columns in indexed data sets.
+
+
+
+
+ A merged data set is an aggregate data set that selects items from each of zero or more
+ other data sets according to a
+
+
+
+
+
+
+
+
+
+ Gets or sets the
+
+
+ By default the strategy is
+
+ Thrown if
+
+
+
+
+
+ Creates a data source with a given name.
+
+ Thrown if
+
+
+
+ Adds an alias for a binding path to map it to the specified index.
+
+ Thrown if
+
+
+
+
+
+
+
+ Gets the name of the data source, or an empty string if it is anonymous.
+
+
+
+
+ A data source table manages a collection of named data sources.
+
+
+
+
+ Resolves data sources by name.
+
+
+
+
+ Resolves the data source with the specified name.
+
+ The resolved data source, or null if none found.
+ Thrown if
+
+
+
+
+
+
+
+ A data binding specification describes how values are bound to slots (
+
+
+ A specification automatically converts values to the correct types
+ for data binding using a
+
+
+
+
+ Creates a data binding spec.
+
+ Thrown if
+
+
+
+ Formats the specification to a string for presentation.
+
+
+
+ The values are listed sequentially as follows:
+
+ - The
+ - The
+ - The
+ - All other slot values, if any, are sorted by name and formatted as name-value
+ pair assignments following a colon and delimited by a comma
+
+ Example: 'SomeType<int, string>(42, "deep thought"): Author="Douglas Adams", Book="HGTTG"'.
+
+
+ If there are no slots of a given kind, then the enclosing angle brackets or
+ parentheses are ignored. Therefore if
+
+ This method assumes that the slots all belong to the same declaring type or method
+ which is always the case for
+
+ The formatted specification.
+ Thrown if
+
+
+
+ Internal implementation of
+ The formatted specification.
+
+
+
+ Appends formatted generic arguments within angle brackets, if any.
+
+
+
+
+ Appends formatted generic arguments within parentheses, if any.
+
+
+
+
+ Appends formatted values keyed and sorted by name, if any.
+ This method is used with fields and properties.
+
+
+
+
+ Resolves a member that may be declared by a generic type using the
+ resolved type or one of its subtypes.
+
+
+
+ For example, if
+
+ The type of member.
+ The resolved member.
+
+
+
+ Gets the slot values.
+
+
+
+
+ Gets the converter.
+
+
+
+
+ The intersection merge strategy combines the items from multiple providers
+ by discarding items whose values do not appear in the items of all other
+ providers.
+
+
+
+ If the same item appears more than once within any given provider,
+ when it will be enumerated only as often as the least number of repetitions
+ of that item that appear in other providers.
+
+
+ Uniqueness is determined by the natural equality of each bound value in the item.
+
+
+
+
+
+ Gets the singleton instance of the strategy.
+
+
+
+
+
+
+ A joined data set is an aggregate data set that joins items from each of zero or more
+ other data sets according to a
+
+
+ A joined data set supports queries with two kinds of
+ - A translated binding produced by
+ - Any other binding is treated as if it referred to the joined
true
+ from its
+
+
+
+
+
+
+
+
+ Translates a binding into one that expresses a query that is scoped over
+ a particular data set that is associated with this interface.
+
+
+
+ If the binding contains an index parameter, the translated binding will contain
+ an index that is offset based on the position of the contents of the data set
+ within the items of the joined aggregate.
+
+
+ The translated binding.
+ Thrown if
+ Thrown if
+
+
+
+
+
+
+
+ Gets or sets the
+
+
+ By default the strategy is
+
+ Thrown if
+
+
+
+
+
+ A list data item contains a list of static data values combined with
+ optional metadata for the item. Data binding occurs based on the binding
+ index alone.
+
+ The value type.
+
+
+
+ Creates a list data item with optional metadata.
+
+ Thrown if
+
+
+
+
+
+
+
+ Encapsulates a specification for invoking a method given values for
+ its generic parameters and formal parameters.
+
+
+
+
+ Creates a new method specification.
+
+ Thrown if
+ Thrown if
+
+
+
+ Invokes the method.
+
+ The method result value.
+ Thrown if
+ Any exception thrown by the invoked method.
+
+
+
+
+
+ Gets the method or generic method definition to be invoked.
+
+
+
+
+ Gets the resolved type that declares the method.
+
+
+
+
+ Gets the resolved method given any generic method arguments that may have
+ been provided as slot values.
+
+
+
+
+ Gets the resolved method arguments.
+
+
+
+ The values have already been converted to appropriate types for invoking the method.
+
+
+
+
+
+ A null data item simply returns a null value on each request.
+ It has no metadata.
+
+
+
+
+ Gets the singleton null data item instance.
+
+
+
+
+
+
+
+
+
+
+
+
+ Encapsulates a specification for creating objects given values for
+ a type's generic parameters, constructor parameters, fields and properties.
+
+
+
+
+ Creates a new object specification.
+
+ Thrown if
+ Thrown if
+
+
+
+ Creates an instance of the resolved type and initializes it using
+ constructor parameter, field and property slot values.
+
+ The new instance, never null.
+ Thrown if the type is not instantiable.
+
+
+
+
+
+ Gets the type or generic type definition to be instantiated.
+
+
+
+
+ Gets the resolved type given any generic type arguments that may have
+ been provided as slot values.
+
+
+
+
+ Gets the resolved constructor, or null if the type was abstract or if it was
+ a struct and the default struct constructor is being use.
+
+
+
+
+ Gets the resolved constructor arguments.
+
+
+
+ The values have already been converted to appropriate types for invoking the constructor.
+
+
+ If
+
+
+
+
+ Gets the resolved fields and their values.
+
+
+
+ The values have already been converted to appropriate types for setting the fields.
+
+
+
+
+
+ Gets the resolved properties and their values.
+
+
+
+ The values have already been converted to appropriate types for setting the properties.
+
+
+
+
+
+ The pairwise strategy constructs a limited number of combinations of the
+ items within the data providers such that they cover all possible pairs
+ of values from each data source.
+
+
+
+ This strategy can be more efficient than one based on exhaustively testing all
+ combinations since many test failures result from the interaction of a relatively
+ small number of factors: often just two of them.
+
+
+ Computing orthogonal arrays for pairwise joins for large domains can be very expensive
+ computationally. Therefore most practical algorithms use approximations.
+
+
+ The algorithm used here makes a list of all pairs that must be covered. Then it constructs
+ combinations greedily by trying to include as many uncovered pairs in each one as possible,
+ preferring pairs used less often over other ones. The combinations produced may not be
+ optimal but empirically it covers all pairs using a sufficiently small number of cases for
+ most practical purposes.
+
+
+ Many thanks to James Bach at Satisfice (www.satisfice.com) for his AllPairs program from
+ which the algorithm used here was adapted.
+
+
+ The choice of considering only 2 factors was made for the sake of implementation
+ convenience. It turns out that an N-wise combination strategy is much more complex
+ to implement efficiently because the general problem is NP-Complete. However, if you
+ should choose to implement such a join strategy on your own, please consider contributing
+ it back to the Gallio project for others to use. Thanks!
+
+
+ See also:
+
+
+
+
+ Gets the singleton instance of the strategy.
+
+
+
+
+
+
+ A data set constructed from a sequence of data items.
+
+
+
+
+ Creates a row data set.
+
+ Thrown if
+ Thrown if
+
+
+
+
+
+
+
+
+
+ A scalar data item represents a single static data value combined with
+ optional metadata for the item. Data binding occurs whenever the binding
+ index is 0.
+
+ The value type.
+
+
+
+ Creates a scalar data item with optional metadata.
+
+
+
+
+
+
+
+
+ The sequential join strategy combines items from each data provider sequentially.
+ If one provider contains fewer items than the others, the sequential join strategy
+ will insert a
+
+
+
+ Gets the singleton instance of the strategy.
+
+
+
+
+
+
+ The union merge strategy combines the items from multiple providers by
+ discarding all items whose values duplicate those of other items that
+ have already been enumerated.
+
+
+
+ Uniqueness is determined by the natural equality of each bound value in the item.
+
+
+
+
+
+ Gets the singleton instance of the strategy.
+
+
+
+
+
+
+ An XML data set selects nodes from an XML document using XPath
+ expressions. The selected nodes are returned as
+
+
+ Two XPath expressions are used.
+
+ -
+
Item Path : An XPath expression that selects a set of nodes that are used to
+ uniquely identify records. For example, the item path might be used to select
+ the containing element of each Book element in an XML document of Books.
+ The item path is specified in the constructor.
+
+ -
+
Binding Path : An XPath expression that selects a node relative to the item path
+ that contains a particular data value of interest. For example, the binding path
+ might be used to select the Author attribute of a Book element in an XML document of Books.
+ The binding path is specified by the
+
+
+
+
+ The XML may contain metadata at the row level by adding metadata elements in the
+ http://www.gallio.org/ namespace containing metadata entries. In the following example,
+ the row values would be selected using an Item Path of "//row" and a Binding Path of "@value".
+ Additionally, some rows would have metadata as specified.
+
+
+
+
+
+
+
+ |
+
+ ]]>
+
+
+
+
+
+
+ Creates an XML data set.
+
+ Thrown if
+
+
+
+
+
+
+
+ Gets the name of the location that is providing the data, or null if none.
+
+
+
+ The data location name and line number are exposed as
+
+
+
+ The default value is null.
+
+
+
+
+
+
+
+
+ Associates an annotation message with a code element. When the code element
+ is processed as part of building some other test, the annotation message will
+ be emitted. This may be used to signal error, warning, and informational
+ messages associated with the code element in question.
+
+
+
+ Many annotations are automatically generated by the framework. For example,
+ improperly used attributes generally cause error annotations to be emitted.
+ This attribute provides an easy way for test authors to leverage the annotation
+ mechanism for other discretionary purposes where it is desirable to draw
+ attention to a particular code element.
+
+
+ Note that the annotation will only be emitted if it is encountered during the
+ process of building a test. If for some reason the annotated code element
+ is not processed, then the attribute will have no effect.
+
+
+
+
+
+ Associates an annotation message of the specified type with the code element.
+
+ Thrown if
+
+
+
+
+
+ Gets the annotation type.
+
+
+
+
+ Gets the annotation message.
+
+
+
+
+ Gets or sets optional detail text of the annotation, or null if none.
+
+
+
+
+ A contribution method pattern attribute applies decorations to a containing scope
+ such as by introducing a new setup or teardown action to a test.
+
+
+
+
+
+
+
+
+ Verifies that the attribute is being used correctly.
+
+ Thrown if the attribute is being used incorrectly.
+
+
+
+ Applies decorations to the containing test.
+
+
+
+
+
+
+ A test assembly decorator pattern attribute applies decorations to an
+ existing test declared at the assembly-level.
+
+
+
+
+
+
+ Verifies that the attribute is being used correctly.
+
+ Thrown if the attribute is being used incorrectly.
+
+
+
+ Applies decorations to an assembly-level test.
+
+
+
+ A typical use of this method is to augment the test with additional metadata
+ or to add additional behaviors to the test.
+
+
+
+
+
+ An assembly initialization attribute gets a chance to perform early initialization
+ of the system before enumerating the tests within the assembly.
+
+
+
+ For examples, a subclass of this attribute may be used to register an assembly
+ resolver before test enumeration occurs to ensure that all referenced assemblies
+ can be loaded.
+
+
+
+
+
+ Performs early initialization for the specified assembly.
+
+
+
+
+ Declares that an assembly generates an assembly-level test.
+
+
+
+ Subclasses of this attribute can customize how test enumeration takes place within the assembly.
+
+
+ At most one attribute of this type may appear on any given assembly.
+
+
+
+
+
+ Gets a default instance of the assembly pattern attribute to use
+ when no other pattern consumes an assembly.
+
+
+
+
+
+
+
+
+ Verifies that the attribute is being used correctly.
+
+ Thrown if the attribute is being used incorrectly.
+
+
+
+ Initializes a test for an assembly after it has been added to the test model.
+
+
+
+
+ Applies semantic actions to the assembly-level test to estalish its runtime behavior.
+
+
+
+ This method is called after
+
+ The default behavior for a
+
+
+
+ You can override this method to change the semantics as required.
+
+
+
+
+
+ Populates the children of the assembly test all at once.
+
+
+
+ The default implementation processes all public and non-public types within the assembly.
+
+
+
+
+
+ Prepares to populate the children of the assembly test on demand by
+ adding a deferred populator with
+
+
+
+
+
+ Gets the default pattern to apply to types that do not have a primary pattern, or null if none.
+
+
+
+ The default implementation returns
+
+
+
+
+ Abstract base implementation of
+
+
+
+
+
+
+
+
+
+
+
+ The data pattern attribute applies a data source to a fixture or test
+ parameter declaratively.
+
+
+
+ It can be attached to a fixture class, a public property
+ or field of a fixture, a test method or a test method parameter. When attached
+ to a property or field of a fixture, implies that the property or field is
+ a fixture parameter (so the
+
+ The order in which items contributed by a data pattern attribute are
+ use can be controlled via the
+
+
+ The following example ensures that the rows are processed in exactly the order they appear.
+
+
+
+
+
+
+ Verifies that the attribute is being used correctly.
+
+ Thrown if the attribute is being used incorrectly.
+
+
+
+ Populates the data source with the contributions of this attribute.
+
+
+
+
+ Gets or sets the name of the data source to create so that the values produced
+ by this attribute can be referred to elsewhere.
+
+
+
+ Multiple data attributes may use the same data source name to produce a compound
+ data source consisting of all of their values combined.
+
+
+ If no name is given to the data source (or it is an empty string), the data source
+ is considered anonymous. An anonymous data source is only visible
+ within the scope of the code element with which the data source declaration
+ is associated. By default, test parameters are bound to
+ the anonymous data source of their enclosing scope.
+
+
+ Thrown if
+
+
+
+ A declarative pattern resolver based on
+
+
+
+ The pattern resolver provides a means for obtaining the
+
+
+
+ Gets the patterns associated with the specified code element.
+
+ The enumeration of patterns.
+ Thrown if
+
+
+
+ Gets the singleton instance of the declarative pattern resolver.
+
+
+
+
+
+
+ Standard
+
+
+
+ Valid attribute targets for tests.
+
+
+
+
+ Valid attribute targets for test assemblies.
+
+
+
+
+ Valid attribute targets for test types.
+
+
+
+
+ Valid attribute targets for test methods.
+
+
+
+
+ Valid attribute targets for test parameters.
+
+
+
+
+ Valid attribute targets for tests or test parameters.
+
+
+
+
+ Valid attribute targets for test constructors.
+
+
+
+
+ Valid attribute targets for data contexts.
+
+
+
+
+ Valid attribute targets for contribution methods.
+
+
+
+
+ Valid attribute targets for test contracts.
+
+
+
+
+ Default implementation of a pattern scope.
+
+
+
+
+ Creates a new scope.
+
+ Thrown if
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ An interface shared by
+
+
+
+ Sets the name of the component.
+
+
+
+
+ Gets the data context of the component.
+
+
+
+
+ A pattern test data context introduces a scope for data source declarations.
+
+
+
+ Each
+
+ For example, the constructor of a test class typically augments its containing test with
+ additional test parameters that represent its own constructor parameters. If data binding
+ attributes are applied to the constructor, they should operate within the scope of that
+ constructor only. To achieve this effect, the constructor declares a new
+
+
+
+
+ Creates a new data context.
+
+
+
+
+ Defines a new data source within this data context if one does not exist.
+ Otherwise returns the existing one.
+
+ The defined data source.
+ Thrown if
+
+
+
+
+
+ Returns the index that should be used to implicitly bind to the nearest
+ anonymous data source that can be found.
+
+
+
+ The index is computed as the sum of the
+
+ The implicit data binding index, or null if no anonymous data sources were found.
+
+
+
+ Creates a child data context.
+
+ A handle for the child context.
+
+
+
+ Gets the containing data context, or null if none.
+
+
+
+
+ Gets or sets the offset to add to a test parameter's implicit data binding index to map it
+ into the containing data context.
+
+
+
+ This property is used to determine the data binding index of a test parameter that
+ has not been explicitly bound. The offsets are summed cumulatively to produce an implicit
+ data binding index while traversing the chain of containing data contexts while locating the
+ first anonymous data source.
+
+
+ For example, suppose Y is the second parameter of a test method. If Y does not
+ have an explicit data binding, we will apply implicit data binding rules as follows.
+
+ - If
Y 's data context contains an anonymous data source, then the implicit data binding index will be 0.
+ - Otherwise, if
Y 's containing data context contains an anonymous data source, then the implicit data
+ binding index will equal the offset specified in Y 's data context: 1 (since it is the second parameter).
+ - Otherwise, we continue searching containing data contexts and summing their offsets until we find an
+ anonymous data source. If none is found, then data binding will fail.
+
+
+
+
+
+
+ The type of exception thrown when a test declaration is malformed or
+ contains an error.
+
+
+
+ Implementations of
+
+ The exception effectively halts the processing of the pattern. The message
+ text is then manifested as an error annotation that may be displayed to the user.
+
+
+ When you see this error, check to make sure that the syntax of the test
+ is correct, all required parameters have been provided and they contain
+ valid values.
+
+
+
+
+
+ Creates a usage error exception.
+
+
+
+
+ Creates a usage error exception.
+
+
+
+
+ Creates an exception from serialization info.
+
+
+
+
+ A dependency pattern attribute creates a dependency on the tests defined
+ by some other code element.
+
+
+
+
+
+
+ Verifies that the attribute is being used correctly.
+
+ Thrown if the attribute is being used incorrectly.
+
+
+
+ Gets the code element that declares the tests on which this test should depend.
+
+ The code element representing the dependency.
+
+
+
+ Default implementation of a pattern evaluator.
+
+
+
+
+ Creates a pattern evaluator.
+
+ Thrown if
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Applies declarative metadata to a test component.
+
+
+
+ A metadata attribute is similar to a decorator but more restrictive. Metadata does
+ not modify the structure of a test directly. Instead it introduces additional metadata
+ key / value pairs for classification, filtering, reporting, documentation or other purposes.
+
+
+
+
+
+
+
+ Verifies that the attribute is being used correctly.
+
+ Thrown if the attribute is being used incorrectly.
+
+
+
+ Gets the metadata key / value pairs to be added to the test component.
+
+ The metadata entries.
+
+
+
+ A test case that has been defined by the
+
+
+
+ A test object represents a parameterized test case or test
+ container. The test parameters are used as placeholders for
+ data-binding during test execution. A single test can
+ produce multiple steps (
+
+
+ A
+
+ A test may depend on one or more other tests. When a test
+ fails, the tests that depend on it are also automatically
+ considered failures. Moreover, the test harness ensures
+ that a test will only run once all of its dependencies have
+ completed execution successfully. A run-time error will
+ occur when the system detects the presence of circular test dependencies
+ or attempts to execute a test concurrently with its dependencies.
+
+
+ A test contain child tests. The children of a test are executed
+ in dependency order within the scope of the parent test. Thus the parent
+ test may setup/teardown the execution environment used to execute
+ its children. Tests that belong to different subtrees are executed in
+ relative isolation within the common environment established by their common parent.
+
+
+ The object model distinguishes between tests that represent individual test cases
+ and other test containers. Test containers are skipped if they do not
+ contain any test cases or if none of their test cases have been selected for execution.
+
+
+ The kind of type type of test is set to
+
+
+
+
+ Common interface for elements in the test object model.
+
+
+
+ All components have a name for presentation, metadata for
+ annotations, and a code reference to its point of definition.
+
+
+
+
+
+ Initializes a test component.
+
+ Thrown if
+
+
+
+
+
+ Gets or sets the stable unique identifier of the component.
+
+
+
+ The identifier must be unique across all components
+ within a given test project. It should also be stable so that the
+ identifier remains valid across recompilations and code changes that
+ do not alter the underlying declarations (insofar as is possible).
+
+
+ The identifier does not refer to a specific instance of
+
+ Thrown if
+
+
+
+ Gets or sets the name of the component.
+
+
+
+ The name does not need to be globally unique.
+
+
+
+
+
+ Gets or sets the value of the
+
+
+ This is a convenience method.
+
+
+
+ One of the
+
+
+
+ Gets the metadata of the component.
+
+
+
+
+ Gets or sets a reference to the point of definition of this test
+ component in the code, or null if unknown.
+
+
+
+
+ Initializes a test initially without a parent.
+
+ Thrown if
+
+
+
+ Clears the list of test parameters.
+
+
+
+
+ Adds a test parameter and sets its
+ Thrown if
+ Thrown if
+
+
+
+ Removes a test parameter and resets its
+ Thrown if
+ Thrown if
+
+
+
+ Clears the list of children.
+
+
+
+
+ Adds a child test and sets its
+ Thrown if
+ Thrown if
+
+
+
+ Removes a child test and resets its
+ Thrown if
+ Thrown if
+
+
+
+ Clears the list of dependencies.
+
+
+
+
+ Adds a test dependency.
+
+ Thrown if
+
+
+
+ Removes a test dependency.
+
+ Thrown if
+
+
+
+ Obtains a unique local id for a child of this test.
+
+ The unique local id to use.
+ Thrown if
+
+
+
+
+
+
+
+ Gets or sets a suggested
+
+
+ The value returned by this method will be checked for uniqueness and amended as necessary
+ to produce a truly unique
+
+
+ The default value of this property is null which causes the
+ The local id hint.
+
+
+
+ Gets the full name of the test. The full name is derived by concatenating the
+
+
+
+ The full name of the root test is empty.
+
+
+
+
+
+ Gets or sets the parent of this test, or null if this is the root test.
+
+
+
+
+ Gets a locally unique identifier for this test that satisfies the following conditions:
+
+
+
+
+ - The identifier is unique among all siblings of this test belonging to the same parent.
+ - The identifier is likely to be stable across multiple sessions including
+ changes and recompilations of the test projects.
+ - The identifier is non-null.
+
+
+
+ The local identifier may be the same as the test's name. However since the name is
+ intended for display to end-users, it may contain irrelevant details (such as version
+ numbers) that would reduce its long-term stability. In that case, a different
+ local identifier should be selected such as one based on the test's
+
+
+ The locally unique
+
+ The locally unique identifier.
+
+
+
+ Gets whether this test represents an individual test case
+ as opposed to a test container such as a fixture or suite.
+
+
+
+ The value of this property can be used by the test harness to avoid processing
+ containers that have no test cases. It can also be used by the reporting infrastructure
+ to constrain output statistics to test cases only.
+
+
+ Not all test cases are leaf nodes in the test tree and vice-versa.
+
+
+ This value is defined as a property rather than as a metadata key because it
+ significantly changes the semantics of test execution.
+
+
+
+
+
+ Gets a read-only list of the parameters of this test.
+
+
+
+ Each parameter must have a unique name.
+
+
+ The order in which the parameters appear is not significant.
+
+
+
+
+
+ Gets a read-only list of the children of this test.
+
+
+
+
+ Gets a read-only list of the dependencies of this test.
+
+
+
+ Some test frameworks may choose to ignore test dependencies or may impose their own dependency schemes.
+
+
+
+
+
+ Gets or sets a number that defines an ordering for the test with respect to its siblings.
+
+
+
+ Unless compelled otherwise by test dependencies, tests with a lower order number than
+ their siblings will run before those siblings and tests with the same order number
+ as their siblings with run in an arbitrary sequence with respect to those siblings.
+
+
+ Some test frameworks may choose to ignore test order or may impose their own ordering schemes.
+
+
+ The test execution order with respect to siblings, initially zero.
+
+
+
+ Initializes a test initially without a parent.
+
+ Thrown if
+
+
+
+
+
+ Gets or sets the maximum amount of time the whole test including
+ its setup, teardown and body should be permitted to run.
+
+
+
+ If the test runs any longer than this, it will be aborted by the framework.
+ The timeout may be null to indicate the absence of a timeout.
+
+
+ Thrown if
+ The timeout. Default value is null.
+
+
+
+ Gets or sets the apartment state to be used to run the test.
+
+
+
+ If the apartment state is
+
+ The test runner guarantees that the root test runs with the
+
+
+ The default value of this property is
+
+
+
+ Gets or sets whether the test is parallelizable.
+
+
+ True if the test is parallelizable. The default value of this property is false .
+
+
+
+
+ Gets the set of actions that describe the behavior of the test.
+
+
+
+
+ Gets the set of actions that describe the behavior of the test's instances.
+
+
+
+
+
+
+ Pattern test action provide the logic that implements the various
+ phases of the test execution lifecycle.
+
+
+
+ Each chain of actions represents the behavior to be performed during a particular phase.
+ Different actions are permitted during each phase. Consult the
+ documentation of the chains for restrictions.
+
+
+ The phases generally run in the following order. Some phases may be skipped
+ due to exceptions or if there is no work to be done.
+
+ - -- for each test instance --
+ - Run the actions in the decorated
+ - -- end --
+
+
+
+ This class is the backbone of the
+
+
+
+
+ Creates a test actions object initially configured with empty action chains
+ that do nothing.
+
+
+
+
+ Creates a copy of the test actions.
+
+ The new copy.
+
+
+
+ Gets the test instance actions that describes the lifecycle of a test instance.
+
+
+
+ These actions may be further decorated on a per-instance basis using
+
+
+
+
+ Prepares a newly created test state before its use.
+
+
+
+ This method runs in the
+
+ The following actions are typically performed during this phase:
+
+ - Configuring the
+ - Accessing user data via
+ - Skipping the test by throwing an appropriate
+
+
+
+ The following actions are forbidden during this phase because they would
+ either go unnoticed or have undesirable side-effects upon test execution:
+
+ - Modifying the
+
+
+
+
+
+
+ Initializes a test prior to the execution of its instances.
+
+
+
+ This method runs in the
+
+ The following actions are typically performed during this phase:
+
+ - Aborting the test run if any preconditions have not been satisfied or if the test is to be skipped.
+ - Configuring the test environment in advance of the enumeration and execution of all test instances.
+ - Accessing user data via
+
+
+
+ The following actions are forbidden during this phase because they would
+ either go unnoticed or have undesirable side-effects upon test execution:
+
+ - Modifying the
+ - Modifying the
+
+
+
+
+
+
+ Cleans up a test following the execution of its instances.
+
+
+
+ This method runs in the
+
+ The following actions are typically performed during this phase:
+
+ - Deconfiguring the test environment following the enumeration and execution of all test instances.
+ - Accessing user data via
+
+
+
+ The following actions are forbidden during this phase because they would
+ either go unnoticed or have undesirable side-effects upon test execution:
+
+ - Modifying the
+ - Modifying the
+
+
+
+
+
+
+ Cleans up a completed test state after its use.
+
+
+
+ This method runs in the
+
+ The following actions are typically performed during this phase:
+
+ - Accessing user data via
+
+
+
+ The following actions are forbidden during this phase because they would
+ either go unnoticed or have undesirable side-effects upon test execution:
+
+ - Modifying the
+ - Modifying the
+
+
+
+
+
+
+ Decorates the
+
+
+ This method runs in the
+
+ This method may apply any number of decorations to the test instance's actions
+ to the supplied
+
+ The following actions are typically performed during this phase:
+
+ - Adding additional actions for the test instance to the
+ - Accessing user data via
+
+
+
+ The following actions are forbidden during this phase because they would
+ either go unnoticed or have undesirable side-effects upon test execution:
+
+ - Modifying the
+ - Modifying the
+ - Modifying the
+
+
+
+
+
+
+ Controls the execution of
+
+
+
+ Creates a pattern test controller.
+
+ Thrown if
+
+
+
+
+
+ Encapsulates the algorithm for recursively running a
+
+
+ Please note that this code has been optimized to minimize the stack depth so as
+ to be more debugger-friendly. That means some of these methods (and the methods
+ they call) are rather a lot longer and harder to read than they used to be.
+ However the payoff is very significant for end-users. As a result of this optimization
+ the effective stack depth for a simple test has been reduced from over 160 to about 30 in many cases.
+ -- Jeff.
+
+
+
+
+
+ Test driver for the pattern test framework.
+
+
+
+
+ The pattern test framework is a built-in framework that Gallio provides based on
+ reflection over attributes that implement
+
+
+ The pattern test framework does not provide many attributes that end-users would use
+ to write tests. The framework is intended to be extended by
+ components and libraries that define the test syntax and other facilities.
+
+
+ For example, a Test-Driven framework would augment the base framework with a syntax based
+ around test fixtures, test methods and assertions. A Behavior-Driven framework
+ would instead use a syntax based around contexts and specifications. Both frameworks
+ would share the common attribute-based model provided by the pattern test framework.
+ They may even interoperate to a large extent.
+
+
+ Other add-on libraries and tools may further contribute functionality to the pattern
+ test framework by registering components with the runtime or by subclassing
+ pattern attributes.
+
+
+ Gallio supports the use of multiple test frameworks. The pattern test framework
+ model defined here may not be appropriate for all purposes. Therefore you may
+ consider creating a new test framework from scratch by implementing
+
+ The name of the Pattern Test Framework derives from the similarity between the recursive
+ construction process performed by
+
+
+
+
+
+
+ Gets information about a particular pattern test framework extension.
+
+
+
+ The information will be included in the report as part of the framework
+ node that contains the assembly.
+
+
+ If there are no framework extensions associated with a particular assembly then
+ the assembly will not be explored for tests.
+
+
+ The pattern test framework extension information.
+
+
+
+ A step that belongs to a
+
+
+
+ A test step is a delimited region of a test defined at run-time.
+
+
+
+ Each test that is executed consists of at least one step: the "primary" step.
+ During execution, each test may spawn additional nested steps that may run in
+ parallel or in series with one another as required.
+
+
+ A test step may be used to describe a particular instance of a data driven test.
+ It can also be used to generate a completely dynamic hierarchy at runtime that
+ mirrors and extends the static test hierarchy with new information derived from
+ the actual execution of the test.
+
+
+ Each step has its own execution log and test result (pass/fail/inconclusive).
+ Therefore a multi-step test may possess multiple execution logs and test results.
+ This is deliberate. Think of a
+
+ A test step also has metadata that can be update at run-time to carry additional
+ declarative information about the step.
+
+
+
+
+
+ Creates a primary step using the same name, code element and metadata
+ as the test to which it belongs.
+
+ Thrown if
+
+
+
+ Creates a step.
+
+
+
+ If
+
+ Thrown if
+
+
+
+
+
+
+
+ Gets the full name of the step.
+
+
+
+ The full name is derived by concatenating the
+
+ The full name of the root test step is empty.
+
+
+ Examples:
+
+ "" : The root step."SomeAssembly/SomeFixture/SomeTest" : The step corresponding to SomeTest."SomeAssembly/SomeFixture/SomeTest/ChildStep" : A child step of SomeTest.
+
+
+
+
+
+ Gets the step that contains this one, or null if this instance represents the
+ root step of the test step tree.
+
+
+
+
+ Gets the test to which this step belongs.
+
+
+
+
+ Returns true if the test step is the top node of a hierarchy of test steps that are
+ all associated with the same test.
+
+
+
+ In the case where a single test step is associated with a test, then it is the primary test step.
+ There may be multiple primary test steps of the same test if they are not
+ directly related by ancestry (ie. one does not contain the other).
+
+
+ A non-primary test step is known as a derived test step.
+
+
+ For example, suppose we have a data-driven test fixture F which contains a data-driven
+ test T. There will be a primary test step of F that represents the undifferentiated
+ fixture with no data bound to it. Its immediate children will be derived test steps of F with particular data bindings.
+ Similarly, each of these derived test steps of F will contain a primary test step of T
+ which then contains derived test steps of T.
+
+
+ This case is illustrated like this where periods delimit path segments in the test step hierarchy.
+
+ F : Primary test step of FF.F1 : Non-primary test step of F with data bindingsF.F1.T : Primary test step of TF.F1.T.T1 : Non-primary test step of T with data bindingsF.F1.T.T2 : Non-primary test step of T with data bindingsF.F2 : Non-primary test step of F with data bindingsF.F2.T : Primary test step of TF.F2.T.T1 : Non-primary test step of T with data bindingsF.F2.T.T2 : Non-primary test step of T with data bindings
+
+
+
+
+
+ Gets or sets whether the test step is dynamic.
+
+
+
+ A dynamic test step is one whose execution is governed by parameters that are not
+ known a priori.
+
+
+ For example, a primary test step is generally not dynamic because its existence
+ usually only depends on statically known information derived from the test model.
+ However, a child test step created at runtime by a data binding process might be
+ considered dynamic if the data items that were used may change between test runs
+ even when the static structure of the test code remains the same. So a test step
+ that uses random data items or that owes its existence to processes that are not
+ entirely under the control of the test framework should be flagged as dynamic.
+
+
+ It can be useful to distinguish between static and dynamic test steps when
+ correlating results across test runs. Dynamic test steps are more likely to
+ change in dramatic ways between test runs than static test steps.
+
+
+
+
+
+ Gets or sets whether the test step represents a distinct test case.
+
+
+
+ A test case is typically a leaf of the test step hierarchy.
+
+
+ A test step can only be a test case if its associated
+
+
+
+
+ Creates a primary step using the same name, code element and metadata
+ as the test to which it belongs.
+
+ Thrown if
+
+
+
+ Creates a step.
+
+
+
+ If
+
+ Thrown if
+
+
+
+ Gets the associated test.
+
+
+
+
+ Pattern test instance actions provide the logic that implements the various
+ phases of the test instance execution lifecycle.
+
+
+
+ Each chain represents the behavior to be performed during a particular phase.
+ Different actions are permitted during each phase. Consult the
+ documentation of the chains for restrictions.
+
+
+ The phases generally run in the following order. Some phases may be skipped
+ due to exceptions or if there is no work to be done.
+
+ - --- begin
+ - --- end
+
+
+
+
+
+
+ Creates a test instance actions object initially configured with empty action chains
+ that do nothing.
+
+
+
+
+ Creates a copy of the test instance actions.
+
+ The new copy.
+
+
+
+ Prepares a newly created test instance state before its use.
+
+
+
+ This method runs in the
+
+ If
+
+ The following actions are typically performed during this phase:
+
+ - Adding or changing slot values.
+ - Configuring the test environment in advance of test initialization.
+ - Modifying the name or metadata of the
+ - Accessing user data via
+
+
+
+ The following actions are forbidden during this phase because they would
+ either go unnoticed or have undesirable side-effects upon test execution:
+
+ - Modifying the
+ - Modifying the
+ - Modifying the
+ - Skipping the test instance by throwing an appropriate
+
+
+
+
+
+
+ Initializes a test instance that has just started running.
+
+
+
+ This method runs in the
+
+ The following actions are typically performed during this phase:
+
+ - Creating the test fixture instance and setting
+ - Configuring the test fixture in advance of test execution.
+ - Accessing user data via
+
+
+
+ The following actions are forbidden during this phase because they would
+ either go unnoticed or have undesirable side-effects upon test execution:
+
+ - Modifying the
+ - Modifying the
+ - Modifying the
+
+
+
+
+
+
+ Sets up a test instance prior to execution.
+
+
+
+ This method runs in the
+
+ The following actions are typically performed during this phase:
+
+ - Invoking test setup methods.
+ - Accessing user data via
+
+
+
+ The following actions are forbidden during this phase because they would
+ either go unnoticed or have undesirable side-effects upon test execution:
+
+ - Modifying the
+ - Modifying the
+ - Modifying the
+
+
+
+
+
+
+ Executes the test instance.
+
+
+
+ This method runs in the
+
+ The following actions are typically performed during this phase:
+
+ - Invoking test methods.
+ - Accessing user data via
+
+
+
+ The following actions are forbidden during this phase because they would
+ either go unnoticed or have undesirable side-effects upon test execution:
+
+ - Modifying the
+ - Modifying the
+ - Modifying the
+
+
+
+
+
+
+ Tears down a test instance following execution.
+
+
+
+ This method runs in the
+
+ The following actions are typically performed during this phase:
+
+ - Invoking test teardown methods.
+ - Accessing user data via
+
+
+
+ The following actions are forbidden during this phase because they would
+ either go unnoticed or have undesirable side-effects upon test execution:
+
+ - Modifying the
+ - Modifying the
+ - Modifying the
+
+
+
+
+
+
+ Disposes a test instance that is about to terminate.
+
+
+
+ This method runs in the
+
+ The following actions are typically performed during this phase:
+
+ - Deconfiguring the test fixture following test execution.
+ - Disposing the test fixture instance.
+ - Disposing other resources.
+ - Accessing user data via
+
+
+
+ The following actions are forbidden during this phase because they would
+ either go unnoticed or have undesirable side-effects upon test execution:
+
+ - Modifying the
+ - Modifying the
+ - Modifying the
+
+
+
+
+
+
+ Cleans up a completed test instance after its use.
+
+
+
+ This method runs in the
+
+ The following actions are typically performed during this phase:
+
+ - Deconfiguring the test environment following the test disposal.
+ - Accessing user data via
+
+
+
+ The following actions are forbidden during this phase because they would
+ either go unnoticed or have undesirable side-effects upon test execution:
+
+ - Modifying the
+ - Modifying the
+ - Modifying the
+
+
+
+
+
+
+ Decorates the
+
+
+ This method runs in the
+
+ This method may apply any number of decorations to the child test's actions
+ to the supplied
+
+ A typical use of this method is to augment the
+
+ It is also possible to decorate descendants besides direct children.
+ To do so, decorate the child's
+
+ The following actions are typically performed during this phase:
+
+ - Adding additional actions for the child test to the
+ - Accessing user data via
+
+
+
+ The following actions are forbidden during this phase because they would
+ either go unnoticed or have undesirable side-effects upon test execution:
+
+ - Modifying the
+ - Modifying the
+ - Modifying the
+
+
+
+ The
+
+ For some purposes it may be useful to save the
+
+
+
+
+ Runs the body of the test from the Initialize phase through the Dispose phase.
+
+
+
+ This method is somewhat special in that it gives the test instance actions a chance to
+ encapsulate the context in which the test runs. It can cause the test to run repeatedly,
+ or in another thread, or with some special execution context. Of course, if it does any
+ of these things then it is responsible for properly cleaning up the test and responding
+ in a timely manner to abort events from the current test context's
+
+
+
+
+ Represents the run-time state of a single instance of a
+
+
+ Typical lifecycle of
+ - The
+ - The controller populates the instance state with slot values for each slot with
+ an associated
+ - The controller calls
+ - The controller initializes, sets up, executes, tears down and disposes the test instance.
+ - The controller calls
+
+
+
+
+
+
+ Creates an initial test instance state object.
+
+ Thrown if
+ Thrown if
+
+
+
+ Gets the pattern test instance state from the specified context.
+
+ The pattern test instance state, or null if none.
+ Thrown if
+
+
+
+ Adds a suffix to the name base.
+
+
+
+ The suffixes may only be added during
+
+ Thrown if
+
+
+
+ Gets a fixture object creation specification using the state's bound
+ The fixture instance.
+
+ The values of
+ Thrown if
+ Thrown if the slots or values in
+
+
+
+ Gets a test method invocation specification using the state's bound
+ The method return value.
+ Thrown if
+ Thrown if the slots or values in
+ Thrown if
+
+
+
+ Invokes a fixture method using the specified
+ The method return value.
+ Thrown if
+ Thrown if the slots or values in
+ Thrown if
+ Any exception thrown by the invoked method.
+
+
+
+ Invokes the test method specified by
+
+
+ If there is no test method or no arguments, the method does nothing.
+
+
+ The method return value, or null if there was none.
+ Any exception thrown by the invoked method.
+
+
+
+ Runs the body of the test.
+
+ The test outcome.
+
+
+
+ Gets the converter for data binding.
+
+
+
+
+ Gets the formatter for data binding.
+
+
+
+
+ Gets the test step used to execute the test instance.
+
+
+
+
+ Gets the test instance actions.
+
+
+
+
+ Gets the test associated with this test instance state.
+
+
+
+
+ Gets the test state associated with this test instance state.
+
+
+
+
+ Gets the data item obtained from the test's
+
+
+
+ Gets the user data collection associated with the test instance state.
+
+
+
+ It may be used
+ to associate arbitrary key/value pairs with the execution of the test instance.
+
+
+
+
+
+ Gets or sets the test fixture type or null if none.
+
+ Thrown if
+
+
+
+ Gets or sets the test fixture instance or null if none.
+
+
+
+
+ Gets or sets the test method or null if none.
+
+ Thrown if
+
+
+
+ Gets or sets the test method arguments or null if none.
+
+
+
+
+ Gets a mutable dictionary of slots and their bound values.
+
+
+
+ The dictionary maps slots to the values that will be stored in them
+ during test execution.
+
+
+ The slots should be valid for the type of test in question. For example,
+ a test fixture supports constructor parameters, generic type parameters,
+ fields and properies declared by the test fixture type. Likewise a test method
+ supports method parameters and generic method parameters declared by the test
+ method. Other novel kinds of tests might additional capabilities.
+
+
+ A value should be of a type that is compatible with the slot's
+
+
+
+
+ Gets a mutable dictionary of values assigned to test parameters.
+
+
+
+ The contents of the dictionary are initialized by the framework as part of the
+ test parameter binding phase for the test instance, just before the "before test instance"
+ actions run.
+
+
+
+
+
+ Returns true if the
+
+
+ False if a new
+
+
+
+
+ Gets or sets the basic name of the test instance which usually consists of the method or
+ class name and a description of its bound argument values.
+
+
+
+ The name may only be changed during
+
+ Thrown if
+
+
+
+ Represents an parameter of a
+
+
+
+ A test parameter describes a formal parameter of a
+
+
+ The
+
+
+
+
+ Initializes a test parameter.
+
+ Thrown if
+
+
+
+
+
+ Gets or sets the test that owns this parameter, or null if this parameter
+ does not yet have an owner.
+
+
+
+
+ Creates a test pattern parameter.
+
+ Thrown if
+
+
+
+
+
+ Gets the set of actions that describe the behavior of the test parameter.
+
+
+
+
+ Gets the test that owns this parameter.
+
+
+
+
+ Gets or sets the
+
+ The default value is a
+ Thrown if
+
+
+
+
+
+ A delegate used to lazily populate the children of an
+
+
+
+ Represents the run-time state of a
+
+
+ Typical lifecycle of
+ - The
+ - The controller populates the test state with slot binding accessors for each
+ - The controller calls
+ - The controller begins iterating over the
+ - The controller calls
+
+
+
+
+
+
+ Creates an initial test state object.
+
+ Thrown if
+
+
+
+ Gets the pattern test state from the specified context.
+
+ The pattern test state, or null if none.
+ Thrown if
+
+
+
+ Gets the test associated with this test state.
+
+
+
+
+ Gets the primary test step associated with this test state.
+
+
+
+ If the test has data bindings, the test instance for each data item will
+ be executed as children of the primary test step. Otherwise,
+ the primary test step will be used for the entire test run.
+
+
+
+
+
+ Gets the test actions.
+
+
+
+
+ Gets the data binding context of the test.
+
+
+
+ The context is used to produce data items for test instances.
+
+
+
+
+
+ Gets the converter for data binding.
+
+
+
+
+ Gets the formatter for data binding.
+
+
+
+
+ Returns true if the test was selected explicitly.
+
+
+
+
+ Gets the user data collection associated with the test state.
+
+
+
+ It may be used to associate arbitrary key/value pairs with the execution of the test.
+
+
+
+
+
+ Gets a mutable dictionary of data accessors that will provide
+ values assigned to test parameters given a data binding item.
+
+
+
+ The contents of the dictionary are initialized by the framework as part of the
+ test parameter binding phase for the test instance, just before the "before test"
+ actions run.
+
+
+
+
+
+ Declares that a constructor is used to provide test fixture parameters.
+
+
+
+ Subclasses of this attribute can control what happens with the constructor.
+
+
+ At most one attribute of this type may appear on any given constructor.
+
+
+
+
+
+ Gets a default instance of the constructor pattern attribute to use
+ when no other pattern consumes a contructor.
+
+
+
+
+
+
+
+
+ Verifies that the attribute is being used correctly.
+
+ Thrown if the attribute is being used incorrectly.
+
+
+
+ Initializes the
+
+
+
+
+
+ Gets the default pattern to apply to constructor parameters that do not have a primary pattern, or null if none.
+
+
+
+ The default implementation returns
+
+
+
+
+ A test decorator pattern attribute applies decorations to a test defined by an
+ assembly, type, or method.
+
+
+
+
+
+
+ Verifies that the attribute is being used correctly.
+
+ Thrown if the attribute is being used incorrectly.
+
+
+
+ Applies decorations to a test.
+
+
+
+ A typical use of this method is to augment the test with additional metadata
+ or to add additional behaviors to the test.
+
+
+
+
+
+ A test decorator pattern attribute applies decorations to an
+ existing test declared at the method-level.
+
+
+
+
+
+
+ Verifies that the attribute is being used correctly.
+
+ Thrown if the attribute is being used incorrectly.
+
+
+
+ Applies decorations to a method-level test.
+
+
+
+ A typical use of this method is to augment the test with additional metadata
+ or to add additional behaviors to the test.
+
+
+
+
+
+ Declares that a method represents a test.
+
+
+
+ Subclasses of this attribute can control what happens with the method.
+
+
+ At most one attribute of this type may appear on any given method.
+
+
+ A test method has a timeout of 10 minutes by default.
+
+
+
+
+
+
+
+
+
+ Verifies that the attribute is being used correctly.
+
+ Thrown if the attribute is being used incorrectly.
+
+
+
+ Initializes a test for a method after it has been added to the test model.
+
+
+
+
+ Applies semantic actions to a test to estalish its runtime behavior.
+
+
+
+ This method is called after
+
+ The default behavior for a
+
+
+
+ You can override this method to change the semantics as required.
+
+
+
+
+
+ Executes the test method.
+
+
+
+ The default implementation just calls
+
+
+
+
+ Gets or sets a number that defines an ordering for the test with respect to its siblings.
+
+
+
+ Unless compelled otherwise by test dependencies, tests with a lower order number than
+ their siblings will run before those siblings and tests with the same order number
+ as their siblings with run in an arbitrary sequence with respect to those siblings.
+
+
+ The test execution order with respect to siblings, initially zero.
+
+
+
+
+
+ Gets the default pattern to apply to generic parameters that do not have a primary pattern, or null if none.
+
+
+
+ The default implementation returns
+
+
+
+
+ Gets the default pattern to apply to method parameters that do not have a primary pattern, or null if none.
+
+
+
+ The default implementation returns
+
+
+
+
+ A test parameter decorator pattern attribute applies decorations to an
+ existing
+
+
+
+
+
+ Verifies that the attribute is being used correctly.
+
+ Thrown if the attribute is being used incorrectly.
+
+
+
+ Applies decorations to a
+
+
+ A typical use of this method is to augment the test parameter with additional metadata
+ or to add additional behaviors to the test parameter.
+
+
+
+
+
+ Declares that a field, property, method parameter or generic parameter
+ represents a
+
+
+ Subclasses of this attribute can control what happens with the parameter.
+
+
+ At most one attribute of this type may appear on any given property,
+ field or parameter declaration.
+
+
+
+
+
+ Gets a default instance of the parameter pattern attribute to use
+ when no other pattern consumes the parameter.
+
+
+
+
+ Gets an instance of the parameter pattern attribute to use when no
+ other pattern consumes the parameter but when the parameter appears to have
+ other contributing pattern attributes associated with it.
+
+
+
+ So a test parameter is created automatically if we try to apply contributions to it, such as data items,
+ but otherwise it is silent. This is particularly useful with fields and properties.
+
+
+
+
+
+
+
+
+
+ Verifies that the attribute is being used correctly.
+
+ Thrown if the attribute is being used incorrectly.
+
+
+
+ Initializes a test parameter after it has been added to the containing test.
+
+
+
+
+
+
+ A test type decorator pattern attribute applies decorations to an
+ existing test declared at the type-level.
+
+
+
+
+
+
+ Verifies that the attribute is being used correctly.
+
+ Thrown if the attribute is being used incorrectly.
+
+
+
+ Applies decorations to a type-level test.
+
+
+
+ A typical use of this method is to augment the test with additional metadata
+ or to add additional behaviors to the test.
+
+
+
+
+
+ Declares that a type represents a test.
+
+
+
+ Subclasses of this attribute can control what happens with the type.
+
+
+ At most one attribute of this type may appear on any given class.
+
+
+ A test type has no timeout by default.
+
+
+
+
+
+ Gets an instance of the test type pattern attribute to use when no
+ other pattern consumes the type.
+
+
+ If the type can be inferred to be a test type then the pattern will behave as if the type has a
+ test type pattern attribute applied to it. Otherwise it will simply recurse into nested types.
+
+
+
+
+
+
+
+
+ Verifies that the attribute is being used correctly.
+
+ Thrown if the attribute is being used incorrectly.
+
+
+
+ Initializes a test for a type after it has been added to the test model.
+
+
+
+ The members of base types are processed before those of subtypes.
+
+
+ The default implementation processes all public members of the type including
+ the first constructor found, then recurses to process all public and non-public
+ nested types. Non-public members other than nested types are ignored.
+
+
+
+
+
+ Consumes type members including fields, properties, methods and events.
+
+
+
+
+ Consumes type constructors.
+
+
+
+
+ Consumes nested types.
+
+
+
+
+ Applies semantic actions to a test to estalish its runtime behavior.
+
+
+
+ This method is called after
+
+ The default behavior for a
+
+
+
+ You can override this method to change the semantics as required.
+
+
+
+
+
+ Gets the binding flags that should be used to enumerate non-nested type members
+ of the type for determining their contribution to the test fixture.
+
+
+
+ Instance members are only included if the type is not abstract.
+
+
+ The binding flags for enumerating members.
+
+
+
+ Infers whether the type is a test type based on its structure.
+
+
+
+ Returns true if the type any associated patterns, if it has
+ non-nested type members (subject to
+
+ True if the type is likely a test type.
+
+
+
+ Gets or sets a number that defines an ordering for the test with respect to its siblings.
+
+
+
+ Unless compelled otherwise by test dependencies, tests with a lower order number than
+ their siblings will run before those siblings and tests with the same order number
+ as their siblings with run in an arbitrary sequence with respect to those siblings.
+
+
+ The test execution order with respect to siblings, initially zero.
+
+
+
+
+
+ Gets the default pattern to apply to generic parameters that do not have a primary pattern, or null if none.
+
+
+
+ The default implementation returns
+
+
+
+
+ Gets the default pattern to apply to methods that do not have a primary pattern, or null if none.
+
+
+
+ The default implementation returns null .
+
+
+
+
+
+ Gets the default pattern to apply to events that do not have a primary pattern, or null if none.
+
+
+
+ The default implementation returns null .
+
+
+
+
+
+ Gets the default pattern to apply to fields that do not have a primary pattern, or null if none.
+
+
+
+ The default implementation returns
+
+
+
+
+ Gets the default pattern to apply to properties that do not have a primary pattern, or null if none.
+
+
+
+ The default implementation returns
+
+
+
+
+ Gets the default pattern to apply to constructors that do not have a primary pattern, or null if none.
+
+
+
+ The default implementation returns
+
+
+
+
+ Gets the default pattern to apply to nested types that do not have a primary pattern, or null if none.
+
+
+
+ The default implementation returns
+
+
+
+
+ A sandbox is an isolated environments for executing test actions.
+
+
+
+ It provides the ability to abort actions in progress so that the test runner can proceed
+ to run other actions.
+
+
+ Sandboxes are hierarchically structured. When an outer sandbox is aborted, all
+ of its inner sandboxes are likewise aborted. A sandbox also provides the ability
+ to create new child sandboxes at will so that test actions can be isolated with
+ fine granularity.
+
+
+ This class is safe for use from multiple concurrent threads.
+
+
+
+
+
+ Creates a root sandbox.
+
+
+
+
+ Disposes the sandbox.
+
+
+
+ All currently executing actions are aborted with
+
+
+
+
+ Creates a child sandbox.
+
+
+
+ When the parent sandbox is aborted, the child will likewise be aborted. This policy
+ offers a mechanism to scope actions recursively.
+
+
+ The child sandbox.
+ Thrown if the sandbox was disposed.
+
+
+
+ Aborts all actions in progress within this context.
+
+
+
+ The abort is persistent and cannot be reverted. Therefore once aborted, no further
+ test actions will be permitted to run. Subsequent calls to
+
+ Thrown if the sandbox was disposed.
+
+
+
+ Uses a specified timeout for all actions run within a block of code.
+ When the timeout expires, the sandbox will be aborted.
+
+
+
+
+ An object that when disposed ends the timeout block, possibly null if there was no timeout.
+ Thrown if the sandbox was disposed.
+ Thrown if
+
+
+
+ Runs a test action.
+
+
+
+ If the action throws an exception or if the test action is aborted, then logs a
+ message to the true and false then the exception is effectively silent. Therefore the action can modify
+ its outcome and cause messages to be logged by throwing a suitable exception such as
+
+
+ If the
+
+ Produces an outcome in the following manner:
+
+ - If the action completed without throwing an exception returns
+ - If the action threw a
+ - If the action threw an different kind of exception, logs
+ the exception and returns
+ - If the action was aborted, returns
+ - If the action timed out, returns
+
+
+
+ The outcome of the action.
+ Thrown if
+ Thrown if the sandbox was disposed.
+
+
+
+ Runs an action inside of a protected context wherein it cannot receive
+ a thread abort from this
+
+
+ This method enables critical system code to be protected from aborts that
+ may affect the sandbox. This call cannot be nested.
+
+
+ An object that when disposed ends the protected block, possibly null if there was no protection necessary.
+
+
+
+ An event that is dispatched when
+
+
+ If the sandbox has already been aborted then the event handler is immediately invoked.
+
+
+ Thrown if the sandbox was disposed.
+
+
+
+ Returns true if
+ Thrown if the sandbox was disposed.
+
+
+
+ Returns the
+ Thrown if the sandbox was disposed.
+
+
+
+ Gets a message that will be logged when the sandbox is aborted, or null if none.
+
+ Thrown if the sandbox was disposed.
+
+
+
+ This exception type is used to signal a test outcome silently without logging the exception.
+
+
+
+
+ Creates a silent test exception with the specified outcome.
+
+
+
+
+ Creates a silent test exception with the specified outcome.
+
+
+
+
+ Creates a exception from serialization info.
+
+
+
+
+
+
+ Provides functions for manipulating test steps.
+
+
+
+ A step is a delimited region of a test. Each step appears in the report as
+ if it were a dynamically generated test nested within the body of the test
+ (or some other step) that spawned it. The step has its own execution log,
+ pass/fail/inconclusive result and in all other respects behaves much like
+ an ordinary test would.
+
+
+ The number of steps within a test does not need to be known ahead of time.
+ This can be useful in situations where insufficient information is known
+ about the internal structure of a test to be able to fully populate the
+ test tree will all of its details. Because steps are dynamically generated
+ at runtime, they appear in test reports but they are invisible to test runners.
+ that traverse the test tree.
+
+
+ There are many interesting uses for steps. For example:
+
+ - A single test consisting of a long sequence of actions can be subdivided
+ into steps to simplify analysis.
+ - A test might depend on environmental configuration that cannot be
+ known a priori.
+ - A performance test might be scheduled to run for a certain duration
+ but the total number of iterations is unknown. By running each iteration
+ as a step within a single test, the test report can display the execution
+ log and pass/fail result of each iteration independently of the others.
+ - A script-driven test driver could execute a scripted sequence of verification
+ commands as a distinct step. If the script is written in a general purpose
+ programming language, the total number of commands and the order in which they
+ will be performed might not be known ahead of time. Using steps enables the
+ integration of tests written in forms that cannot be directly adapted
+ to the framework's native testing primitives.
+ - When testing non-deterministic algorithms, it is sometimes useful to repeat
+ a test multiple times under slightly different conditions until a certain level
+ of confidence is reached. The variety of conditions tested might be determined
+ adaptively based on an error estimation metric. Using steps each condition
+ verified can be reported independently.
+
+
+
+
+
+ Running as many iterations of a test as possible for a set maximum duration.
+ Each iteration will run as a separate test step so that it has its own test
+ execution log and test outcome included in the test report.
+
+
+
+
+
+ Performs an action as a new step within the current context and associates
+ it with the calling function. Does not verify the outcome of the step.
+
+
+
+ This method creates a new child context with a new nested
+
+ This method may be called recursively to create nested steps or concurrently
+ to create parallel steps.
+
+
+ This method does not verify that the test step completed successfully. Check the
+
+
+ The context of the step that ran.
+ Thrown if
+ Thrown if
+ Thrown if there is no current test context.
+
+
+
+ Performs an action as a new step within the current context and associates
+ it with the calling function. Does not verify the outcome of the step.
+
+
+
+ This method creates a new child context with a new nested
+
+ This method may be called recursively to create nested steps or concurrently
+ to create parallel steps.
+
+
+ This method does not verify that the test step completed successfully. Check the
+
+
+ The context of the step that ran.
+ Thrown if
+ Thrown if
+ Thrown if
+ Thrown if there is no current test context.
+
+
+
+ Performs an action as a new step within the current context and associates it
+ with the specified code reference. Does not verify the outcome of the step.
+
+
+
+ This method creates a new child context with a new nested
+
+ This method may be called recursively to create nested steps or concurrently
+ to create parallel steps.
+
+
+ This method does not verify that the test step completed successfully. Check the
+
+
+ The context of the step that ran.
+ Thrown if
+ Thrown if
+ Thrown if
+ Thrown if there is no current test context.
+
+
+
+ Performs an action as a new step within the current context and associates
+ it with the calling function. Verifies that the step produced the expected outcome.
+
+
+
+ This method creates a new child context with a new nested
+
+ This method may be called recursively to create nested steps or concurrently
+ to create parallel steps.
+
+
+ This method verifies that the step produced the expected outcome. If a different outcome
+ was obtained, then raises an assertion failure.
+
+
+ The context of the step that ran.
+ Thrown if
+ Thrown if
+ Thrown if the expected outcome was not obtained.
+ Thrown if there is no current test context.
+
+
+
+ Performs an action as a new step within the current context and associates
+ it with the calling function. Verifies that the step produced the expected outcome.
+
+
+
+ This method creates a new child context with a new nested
+
+ This method may be called recursively to create nested steps or concurrently
+ to create parallel steps.
+
+
+ This method verifies that the step produced the expected outcome. If a different outcome
+ was obtained, then raises an assertion failure.
+
+
+ The context of the step that ran.
+ Thrown if
+ Thrown if
+ Thrown if
+ Thrown if the expected outcome was not obtained.
+ Thrown if there is no current test context.
+
+
+
+ Performs an action as a new step within the current context and associates it
+ with the specified code reference. Verifies that the step produced the expected outcome.
+
+
+
+ This method creates a new child context with a new nested
+
+ This method may be called recursively to create nested steps or concurrently
+ to create parallel steps.
+
+
+ This method verifies that the step produced the expected outcome. If a different outcome
+ was obtained, then raises an assertion failure.
+
+
+ The context of the step that ran.
+ Thrown if
+ Thrown if
+ Thrown if
+ Thrown if the expected outcome was not obtained.
+ Thrown if there is no current test context.
+
+
+
+ Adds metadata to the step that is running in the context.
+
+ Thrown if
+ Thrown if there is no current test context.
+
+
+
+ Gets reflection information about the current step.
+
+ Thrown if there is no current test context.
+
+
+
+ The tasks class provides a mechanism for coordinating the actions of multiple
+ tasks within a test case.
+
+
+
+ Each task started by a test case is monitored. When the test exits, any
+ remaining tasks are automatically aborted and disposed.
+
+
+
+
+
+ Adds a new task for the task manager to watch.
+
+
+
+ The task manager will track when the task starts and finishes, ensure
+ that the task is aborted when the test ends, report any exception thrown
+ by the task as a warning in the log, and include the task in the list of those
+ to join and/or verify.
+
+
+ Thrown if
+
+
+
+ Creates a new thread task but does not start it.
+
+
+
+ There is no need to call
+
+ The new thread task.
+ Thrown if
+
+
+
+ Starts a new thread task.
+
+
+
+ There is no need to call
+
+ The new thread task.
+ Thrown if
+
+
+
+ Creates a new process task but does not start it.
+
+
+
+ The output of the process will be logged and included as part of the test results. It
+ may also be examined using the
+
+ There is no need to call
+
+ The new thread task.
+ Thrown if
+
+
+
+ Starts a new process and begins watching it.
+
+
+
+ The output of the process will be logged and included as part of the test results. It
+ may also be examined using the
+
+ There is no need to call
+
+ The new thread task.
+ Thrown if
+
+
+
+ Waits for all tasks to complete or for timeout to occur;
+ then verifies that no failures have occurred in any of the tasks.
+
+ Thrown if some of the tasks did not complete
+ or if any of the tasks failed.
+
+
+
+ Verifies that no failures have occurred in any of the tasks.
+
+ Thrown if any of the tasks failed.
+
+
+
+ Gets the task container for the current
+
+
+
+ Runs sample test cases within an embedded copy of the test runner and provides
+ access to the resulting test report.
+
+
+
+ Logs debug output from the embedded test runner while the sample tests run.
+
+
+ This utility class is intended to help write integration tests for test framework features.
+
+
+ This class is NOT intended to be used for instructional purposes as a template for
+ creating a new test runner. Do NOT copy this code and try to make a new test runner
+ out of it. Instead, please examine the code for the Gallio Echo test runner and pay
+ attention to how it uses the
+
+
+
+
+ Creates a sample runner.
+
+
+
+
+ Adds a test file to the package configuration, if not already added.
+
+ Thrown if
+
+
+
+ Adds a test assembly to the package configuration, if not already added.
+
+ Thrown if
+
+
+
+ Adds a test fixture type to the list of filters, and automatically adds its containing
+ test assembly to the package configuration, if not already added.
+
+ Thrown if
+
+
+
+ Adds a test method to the list of filters, and automatically adds its containing
+ test assembly to the package configuration, if not already added.
+
+ Thrown if
+
+
+
+ Adds a test filter to the combined list of filters that select which tests to include in the run,
+ if not already added.
+
+ Thrown if
+
+
+
+ Gets information about the test with the given code reference.
+
+
+
+ Can only be called after the tests have run.
+
+
+ The test data, or null if not found.
+
+
+
+ Gets information about the test that matches a predicate.
+
+
+
+ Can only be called after the tests have run.
+
+
+ The test data, or null if not found.
+
+
+
+ Gets all test step runs with the given code reference.
+
+
+
+ Can only be called after the tests have run.
+
+
+ The enumeration of test step runs, or null if not found.
+
+
+
+ Gets all test step runs that match a predicate.
+
+
+
+ Can only be called after the tests have run.
+
+
+ The enumeration of test step runs, or null if not found.
+
+
+
+ Gets all test step runs with the code reference infered from the method of the specified type.
+
+
+
+ Can only be called after the tests have run.
+
+
+ The enumeration of test step runs, or null if not found.
+
+
+
+ Gets the primary test step run of a test with the given code reference.
+
+
+
+ If there are multiple primary steps, returns the first one found.
+
+
+ Can only be called after the tests have run.
+
+
+ The first test step run, or null if not found.
+
+
+
+ Gets the primary test step run that match a predicate.
+
+
+
+ If there are multiple primary steps, returns the first one found.
+
+
+ Can only be called after the tests have run.
+
+
+ The first test step run, or null if not found.
+
+
+
+ Gets the primary test step run of a test with the code reference infered from the method of the specified type.
+
+
+
+ If there are multiple primary steps, returns the first one found.
+
+
+ Can only be called after the tests have run.
+
+
+ The first test step run, or null if not found.
+
+
+
+ Gets all test step runs that represent test cases within a test with
+ the specified code reference.
+
+
+
+ Can only be called after the tests have run.
+
+
+ The first test step run, or null if not found.
+
+
+
+ Explores the tests but does not run them.
+
+
+
+
+ Runs the tests.
+
+
+
+
+ Gets the test report that was produced by the test run.
+
+
+
+
+ Gets the result of the test run.
+
+
+
+
+ Gets the test package for the test run.
+
+
+
+ The returned object may be modified prior to running the tests to configure
+ various parameters of the test run.
+
+
+
+
+
+ Gets or sets the name of the test runner factory to use.
+
+ The test runner factory name, defaults to
+
+
+
+ Gets the test runner options.
+
+
+
+
+ An annotation associates a message with a source code location
+ to inform the user about a problem.
+
+
+
+
+ Creates an annotation with a detail message string.
+
+ Thrown if
+
+
+
+ Creates an annotation with a detail exception.
+
+ Thrown if
+
+
+
+ Creates an annotation with no details.
+
+ Thrown if
+
+
+
+ Gets the annotation type.
+
+
+
+
+ Gets the code element associated with the annotation.
+
+
+
+
+ Gets the annotation message.
+
+
+
+
+ Gets additional details such as exception text, or null if none.
+
+
+
+
+ Specifies the type of an annotation.
+
+
+
+
+ An informational annotation.
+
+
+
+
+ A warning annotation.
+
+
+
+
+ An error annotation.
+
+
+
+
+ Describes the configuration of a Gallio installation.
+
+
+
+
+ Loads the configuration from the registry.
+
+ The installed configuration.
+
+
+
+ Clears the list of additional plugin directories.
+
+
+
+
+ Adds an additional plugin directory if not already in the configuration.
+
+ Thrown if
+
+
+
+ Removes an additional plugin directory.
+
+ Thrown if
+
+
+
+ Saves the additional plugin directories into the registry.
+
+
+
+
+ Saves the installation id into the registry.
+
+
+
+
+ Get or sets the version that was installed, or null if Gallio is not installed.
+
+
+
+
+ Get or sets the folder where Gallio was installed, or null if Gallio is not installed.
+
+
+
+
+ Gets or sets the unique id of this Gallio installation.
+
+
+
+ Returns
+
+
+
+
+ Gets a read-only list of additional plugin directories.
+
+
+
+
+ A
+
+
+
+ A test command requests the execution of a tree of
+
+
+ The order in which commands appear in the command tree is significant.
+ Commands should be sorted such that if command A depends on command B,
+ then B will appear before A in a pre-order traversal of the tree.
+
+
+ The ordering constraint is intended to simplify the implementation of
+
+
+ However, a
+
+ In order to achieve correct behavior, a
+ - A test command runs within the scope of its parent test command.
+ - A test command runs only after all of the test commands it depends on have passed.
+ - A test command with a failed dependency or that is not run for internal reasons reports a test outcome of
+
+
+
+
+
+
+ Gets a list consisting of this command and all of its descendants as
+ enumerated by pre-order tree traversal.
+
+ The list of all command.
+
+
+
+ Returns true if all of the dependencies of this test command have
+ been satisfied including transitive dependencies.
+
+ True if the dependencies of this test command have been satisfied.
+
+
+
+ Starts a new step of the test using the specified test step object.
+
+
+
+ The current thread's test context is set to a new context for the
+ test step that is starting. The new context will be a child of the
+ current thread's context.
+
+
+ The test context for the test step.
+ Thrown if
+ Thrown if
+
+
+
+ Starts the primary step of the test associated with this command as a child
+ of the specified test step and returns its test context.
+
+
+
+ This method is equivalent to calling
+
+ The test context for the new primary test step.
+
+
+
+ Gets the test that is to be executed.
+
+
+
+
+ Gets the total number of tests in the command subtree, including itself.
+
+
+
+
+ Returns true if the test was explicitly selected by a filter.
+
+
+
+ This flag enables test controllers to distinguish the case when a particular test
+ was explicitly selected by a user-specified filter rather than by virtue of
+ one of its parents having been selected.
+
+
+
+
+
+ Gets the number of times that a root step of this test has failed.
+
+
+
+ The value of this field is automatically updated as each root step
+ created by
+
+
+
+
+ Gets the list of child commands to run within the scope of this command.
+
+
+
+ Each child command represents a test that is a child of the test
+ managed by this command.
+
+
+ The children are listed in an order that is consistent with
+ their dependencies. See class commends for details.
+
+
+
+
+
+ Gets the list of other commands that this command depends upon.
+
+
+
+ The dependent commands are guaranteed to have appeared before this
+ command in a pre-order traversal of the command tree.
+ A test command cannot depend on one of its direct ancestors.
+
+
+ There must be no circular dependencies.
+
+
+
+
+
+ Enumerates this command and all of its descendants in pre-order tree
+ traversal.
+
+
+
+
+ Creates a test command.
+
+
+
+
+
+
+
+
+
+
+
+
+ Adds a child test command.
+
+
+
+
+ Adds a test command dependency.
+
+
+
+
+ Clears the children of the command.
+
+
+
+
+ Gets the list of children as an array.
+
+ The array of children.
+
+
+
+ Returns a description of the test command for debugging purposes.
+
+ A description of the test command.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ An observable test context monitors translates state changes on the
+ test context into notifications on a
+
+
+
+ The context provides information about the environment in which
+ a test is executing. A new context is created each time a test or
+ test step begins execution.
+
+
+
+ Contexts are arranged in a hierarchy that corresponds to the order in which
+ the contexts were entered. Thus the context for a test likely has as
+ its parent the context for its containing test fixture.
+
+
+ Arbitrary user data can be associated with a context. Furthermore, client
+ code may attach
+
+ When the context is disposed, its associated test step is automatically
+ marked as being finished unless
+
+
+
+
+ Adds the specified amount to the assert count atomically.
+
+ Thrown if the test is not running.
+
+
+
+ Adds metadata to the step that is running in the context.
+
+ Thrown if
+ Thrown if the test is not running.
+
+
+
+ Sets the step's interim
+
+
+ The interim outcome is used to communicate the anticipated outcome of the step to
+ later phases of execution.
+
+
+ The value set here will be overridden by whatever final outcome the step
+ returns. Consequently the actual outcome may still differ from the anticipated
+ outcome that was set using this method.
+
+
+ Thrown if attempting to set the outcome while the test is not running.
+
+
+
+ Starts a child step of the test and returns its context.
+
+
+
+ The current thread's test context is set to the context of the
+ test step that is starting.
+
+
+ The context of the child step.
+ Thrown if the step has finished.
+ Thrown if
+ Thrown if
+
+
+
+ Finishes a step and submits its final result.
+
+
+
+ If any children of the step are still executing their contexts are automatically
+ disposed. Then
+
+ The final test result.
+
+
+
+ This method informs the test context that it may be finished on a
+ different thread than it started. This changes how the test context
+ will exit when finished.
+
+
+
+ After this method is called, the caller will become responsible for
+ exiting the context after
+
+
+
+
+ Gets the parent context or null if this context has no parent.
+
+
+
+
+ Gets the test step associated with the context.
+
+
+
+
+ Gets the log writer for the test executing in this context.
+
+
+
+ Each test step gets its own log writer that is distinct from those
+ of other steps. So the log writer returned by this property is
+ particular to the step represented by this test context.
+
+
+
+
+
+ Gets or sets the lifecycle phase the context is in.
+
+ Thrown if
+ Thrown if attempting to set the phase while the test is not running.
+
+
+
+ Gets the step's outcome or its interim outcome if the test is still running.
+
+
+
+ The value of this property is initially
+
+ For example, this property enables code running as part of the tear down phase to
+ determine whether the test is failing and to perform different actions in that case.
+
+
+
+
+
+ Gets the user data collection associated with the context.
+
+
+
+ It may be used to associate arbitrary key/value pairs with the context.
+
+
+ Each context has its own distinct user data collection.
+
+
+
+
+
+ Gets the current assertion count.
+
+
+
+
+ Gets the final test result or null if the test has not yet finished running.
+
+
+
+ The test result cannot be changed.
+
+
+
+
+
+ Gets the message sink to which custom test messages may be published.
+
+
+
+
+ Returns true if the step associated with the context has finished execution
+ and completed all
+
+
+
+ The
+
+
+ Clients may attach handlers to this event to perform cleanup
+ activities and other tasks as needed. If a new event handler is
+ added and the step has already finished, the handler is immediately invoked.
+
+
+
+
+
+ Creates an observable test context.
+
+ Thrown if
+
+
+
+ An observable test context manager creates and tracks test contexts and
+ publishes test messages back to a
+
+
+
+ A test context manager provides access to the
+
+
+
+ Starts a test step and returns its associated test context.
+
+
+
+ The current thread's test context is set to a new context for the
+ test step that is starting. The new context will be a child of the
+ current thread's context.
+
+
+ The test context associated with the test step.
+ Thrown if
+
+
+
+ Gets the test context tracker.
+
+
+
+
+ Creates a test context manager.
+
+ Thrown if
+
+
+
+
+
+
+
+ Gets the message sink to which test messages are published.
+
+
+
+
+ A log writer that sends messages to a
+
+
+
+ Creates a log writer.
+
+ Thrown if
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ A stub implementation of
+
+
+ Does not fully support nested test steps or other dynamic features.
+
+
+
+
+
+ Creates a stub context.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ The stub context tracker is a dummy implementation of
+
+
+ A typical use of this stub is to support the use of certain framework methods from
+ clients that are not being executed inside of the Gallio test harness such as when
+ test code is run by third party tools.
+
+
+
+
+
+ The default context tracker tracks the current context by way
+ of the thread's
+
+
+ The .Net framework ensures that this context information flows across threads
+ during asynchronous callbacks, timer events and thread pool work item execution.
+
+
+
+
+
+ The context tracker tracks the
+
+
+ All context tracker operations are thread safe.
+
+
+
+
+
+ Enters a context.
+
+ A cookie that can be used to restore the current thread's context to its previous value when disposed.
+
+
+
+ Sets the default context for the specified thread.
+
+
+
+ The default context for a thread is
+
+ Changing the default context of a thread is useful for capturing existing threads created
+ outside of a test into a particular context. Among other things, this ensures that side-effects
+ of the thread, such as writing text to the console, are recorded as part of the step
+ represented by the specified context.
+
+
+ Thrown if
+
+
+
+ Gets the default context for the specified thread.
+
+
+
+ The default context for a thread is
+
+ Changing the default context of a thread is useful for capturing existing threads created
+ outside of a test into a particular context. Among other things, this ensures that side-effects
+ of the thread, such as writing text to the console, are recorded as part of the step
+ represented by the specified context.
+
+
+ The default context of the thread.
+ Thrown if
+
+
+
+ Gets the context of the current thread, or null if there is no
+ current context.
+
+
+
+ A thread's current context is determined in the following manner:
+
+ - If the thread's context stack is not empty then the top-most item of the
+ stack is used.
+ - Otherwise, if the thread has an default context, then it is used.
+
+ - Otherwise, the
+
+
+
+ Context information may flow across threads by inheritance such that a child
+ thread acquires the context of its parent. However, each thread has its own
+ context stack distinct from that of any other.
+
+
+
+
+
+ Gets or the global context of the environment, or null if there is no
+ such context.
+
+
+
+
+ Initializes the context tracker.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Creates a stub context tracker.
+
+
+
+
+ A function with zero arguments.
+
+ The result type.
+ The function result.
+
+
+
+ A function with one argument.
+
+ The first argument type.
+ The result type.
+ The function result.
+
+
+
+ A function with two arguments.
+
+ The first argument type.
+ The second argument type.
+ The result type.
+ The function result.
+
+
+
+ A function with three arguments.
+
+ The first argument type.
+ The second argument type.
+ The third argument type.
+ The result type.
+ The function result.
+
+
+
+ A function with four arguments.
+
+ The first argument type.
+ The second argument type.
+ The third argument type.
+ The fourth argument type.
+ The result type.
+ The function result.
+
+
+
+ This exception type is used to signal that a test has not produced a conclusive
+ pass or fail result.
+
+
+
+ The exception message, if present, should explain the
+ reason no conclusive result was obtained.
+
+
+
+
+
+ Creates an exception.
+
+
+
+
+ Creates an exception.
+
+
+
+
+ Creates an exception.
+
+
+
+
+ Creates an exception from serialization info.
+
+
+
+
+ Returns
+
+
+
+ Attaches to a
+
+
+
+ Installs an assembly resolver that provides access to the installation path
+ using the
+
+
+ Does nothing if the host is local.
+
+
+ This hook is recommended for newly created domains.
+
+
+ Thrown if
+
+
+
+ Installs an assembly resolver that delegates to the creating
+
+
+ Does nothing if the host is local.
+
+
+ This hook is useful for testing but should not be used in production code.
+
+
+ Thrown if
+
+
+
+ An isolated app domain host is a
+
+
+ The
+
+
+
+
+ An implementation of
+
+
+ This implementation also provides a mechanism for periodically polling
+ the remote service to keep it alive and to detect abrupt disconnection.
+
+
+
+
+
+ Creates an uninitialized host.
+
+ Thrown if
+
+
+
+
+
+
+
+
+
+ Connects to the remote host service.
+
+ The remote host service.
+
+
+
+
+
+ Creates an uninitialized host.
+
+ Thrown if
+
+
+
+
+
+
+
+ An isolated process host is a
+
+
+ Communication with the external process occurs over
+ an inter-process communication channel.
+
+
+ The host application is copied to a unique temporary folder and configured
+ in place according to the
+
+
+
+
+ Creates an uninitialized host.
+
+ Thrown if
+
+
+
+
+
+
+
+ Creates the process task to start the process.
+
+
+
+ This method can be overridden to change how the process is started.
+
+
+ The process task.
+
+
+
+ Prepares the parameters for the remote connection.
+
+
+
+
+ Provides support for working with different implementations of the .Net runtime.
+
+
+
+
+ When using Mono, creates
+ The process start info.
+ Thrown if
+
+
+
+ Returns true if the application is running within the Mono runtime.
+
+
+
+ It is occasionally necessary to tailor the execution of the test runner
+ depending on whether Mono is running. However, the number of such
+ customizations should be very limited.
+
+
+
+
+
+ Get the type of the .Net runtime currently executing this process.
+
+
+
+
+ Gets the .Net runtime version in use.
+
+
+
+ The runtime version indicates the version of the virtual machine that is running.
+ It cannot be used to distinguish among the .Net 2.0, 3.0 and 3.5 frameworks because
+ those frameworks are just libraries that usually run on the 2.0.50727 runtime on the CLR.
+
+
+ The runtime version, eg. "v2.0.50727" or "v4.0.30319"
+
+
+
+ Gets the version of the installed .Net 2.0 runtime, or null if not installed.
+
+ The runtime version, eg. "v2.0.50727"
+
+
+
+ Gets the version of the installed .Net 4.0 runtime version, or null if not installed.
+
+ The runtime version, eg. "v4.0.30319"
+
+
+
+ Gets the version of the most recent installed .Net runtime version.
+
+ The runtime version, eg. "v4.0.30319"
+
+
+
+ An exception that expresses a problem performing a runtime service.
+
+
+
+
+ Creates an exception.
+
+
+
+
+ Creates an exception.
+
+
+
+
+ Creates an exception.
+
+
+
+
+ Creates an exception from serialization info.
+
+
+
+
+ Describes the runtime configuration of a
+
+
+
+ Creates a default host configuration.
+
+
+
+
+ Clears the list of supported runtime versions.
+
+
+
+
+ Adds a supported runtime version number if it is not already in the configuration.
+
+ Thrown if
+
+
+
+ Removes a supported runtime version number.
+
+ Thrown if
+
+
+
+ Adds a binding to the configuration for the specified assembly.
+
+
+
+ Depending on how the binding is configured, this method will add an assembly dependency
+ record and possibly an assembly qualification record.
+
+
+ Thrown if
+
+
+
+ Clears the list of assembly dependencies.
+
+
+
+
+ Adds an assembly dependency if it is not already in the configuration.
+
+ Thrown if
+
+
+
+ Adds an assembly dependency element if a suitable one does not already exist.
+
+ The assembly dependency element.
+
+
+
+ Removes an assembly dependency.
+
+ Thrown if
+
+
+
+ Clears the list of assembly qualifications.
+
+
+
+
+ Adds an assembly qualification if it is not already in the configuration.
+
+ Thrown if
+
+
+
+ Adds an assembly qualification element if a suitable one does not already exist.
+
+ The assembly qualification element.
+ Thrown if an assembly qualification already
+ exists for the same partial name but with a different full name.
+
+
+
+ Removes an assembly qualification.
+
+ Thrown if
+
+
+
+ Overlays the
+ The combined Xml configuration.
+
+
+
+ Overlays the
+ Thrown if
+ Thrown if the configuration could not be written.
+
+
+
+ Overlays the
+ Thrown if
+ Thrown if the configuration could not be written.
+
+
+
+ Creates a copy of the host configuration information.
+
+ The copy.
+
+
+
+ Gets or sets the primary Xml configuration data, or null if none.
+
+
+ The default value is null .
+
+
+
+
+ Gets or sets whether the legacy unhandled exception policy is enabled.
+
+
+ The default value is true which prevents the application from terminating
+ abruptly when an unhandled exception occurs.
+
+
+
+
+ Gets or sets whether to allow assemblies to be loaded from remote sources on .Net 4.0.
+
+
+ The default value is true which enables loading from remote sources.
+
+
+
+
+ Gets or sets whether the
+
+ The default value is false which prevents the assertion dialog from appearing
+ when an assertion fails.
+
+
+
+
+ Gets or sets whether remoting exceptions are substituted with custom errors instead
+ of being passed through to the remote client.
+
+
+ The default value is false which ensures that the remote client receives
+ all exception details.
+
+
+
+
+ Gets a read-only list of assembly qualifications.
+
+
+
+
+ Gets a read-only list of assembly dependencies.
+
+
+
+
+ Gets a read-only list of supported runtime versions in order of preference.
+
+
+
+ When the list is empty, the runtime version used to build the application is used.
+ Otherwise one of the supported runtimes in the list is used.
+
+
+ The default value is an empty list. Each entry should start with a "v". eg. "v2.0.50727".
+
+
+ Note that the host factory will use the
+
+
+
+
+ Describes an assembly name qualification configuration entry that
+ maps an assembly partial name to its full name.
+
+
+
+
+ Creates an assembly name qualification.
+
+ Thrown if
+
+
+
+ Creates a copy of the assembly qualification information.
+
+ The copy.
+
+
+
+ Gets or sets the assembly partial name to qualify.
+
+ Thrown if
+
+
+
+ Gets or sets the assembly full name to use.
+
+ Thrown if
+
+
+
+ Describes a dependent assembly configuration entry that optionally
+ specifies the codebase, a publisher policy and binding redirects.
+
+
+
+
+ Creates an assembly dependency.
+
+ Thrown if
+
+
+
+ Creates a copy of the assembly dependency information.
+
+ The copy.
+
+
+
+ Clears the list of assembly binding redirects.
+
+
+
+
+ Adds an assembly binding redirect if it is not already in the configuration.
+
+ Thrown if
+
+
+
+ Adds an assembly binding redirect element if a suitable one is not already present.
+
+ The binding redirect element.
+
+
+
+ Removes an assembly binding redirect.
+
+ Thrown if
+
+
+
+ Clears the list of assembly codebases.
+
+
+
+
+ Adds an assembly codebase if it is not already in the configuration.
+
+ Thrown if
+
+
+
+ Removes an assembly codebase.
+
+ Thrown if
+
+
+
+ Adds an assembly code-base element if a suitable one is not already present.
+
+
+
+ If another codebase element exists with the same version but perhaps
+ a different Uri, then we do not add a new codebase since this most
+ likely indicates that the same assembly can be loaded from multiple locations.
+
+
+ The code base element.
+
+
+
+ Gets or sets assembly name.
+
+ Thrown if
+
+
+
+ Gets or sets the assembly public key token, or null if none.
+
+
+
+
+ Gets or sets the assembly culture, or null if none.
+
+
+
+
+ Gets or sets the assembly processor architecture, or null if none.
+
+
+
+
+ Gets or sets whether to apply the publisher policy for this assembly.
+
+
+ The default value is true.
+
+
+
+
+ Gets a read-only list of assembly binding redirect elements.
+
+
+
+
+ Gets a mutable list of assembly code base elements.
+
+
+
+
+ Describes an assembly binding redirection from an old version range to
+ a new version.
+
+
+
+
+ Creates an assembly binding redirect.
+
+ Thrown if
+
+
+
+ Creates a copy of the assembly binding redirect information.
+
+ The copy.
+
+
+
+ Gets or sets the range of old versions to redirect, specified
+ either as a single version such as "1.2.3.4" or as a range such as "1.2.3.4-10.11.12.13"
+
+ Thrown if
+
+
+
+ Gets or sets the new version to which the binding should be redirected
+ such as "1.2.3.4"
+
+ Thrown if
+
+
+
+ Describes the location of the codebase of a particular assembly version.
+
+
+
+
+ Creates an assembly code base element.
+
+ Thrown if
+ Thrown if
+ Thrown if
+
+
+
+ Creates a copy of the assembly binding redirect information.
+
+ The copy.
+
+
+
+ Gets or sets the assembly version to which this element applies
+ such as "1.2.3.4".
+
+ Thrown if
+
+
+
+ Gets or sets the Uri that specifies the location of the assembly.
+
+ Thrown if
+ Thrown if
+ Thrown if
+
+
+
+ The type of exception thrown when hosting operations fail.
+
+
+
+
+ Creates an exception.
+
+
+
+
+ Creates an exception.
+
+
+
+
+ Creates an exception.
+
+
+
+
+ Creates an exception from serialization info.
+
+
+
+
+ Provides utilities to interact with a
+
+
+
+ Gets the name used to register the
+
+
+
+ Gets a remote host service using the specified channel.
+
+ The remote host service.
+
+
+
+ Registers the host service with a channel.
+
+ Thrown if
+
+
+
+ Specifies a collection of parameters for setting up a
+
+
+
+ Creates a default host setup.
+
+
+
+
+ Clears the list of hint directories.
+
+
+
+
+ Adds the relative or absolute path of a hint directory if it is not already in the host setup.
+
+
+
+ If relative, the path is based on the current working directory,
+ so a value of "" causes the current working directory to be used.
+
+
+ Relative paths should be canonicalized as soon as possible.
+ See
+
+ Thrown if
+
+
+
+ Removes a hint directory.
+
+ Thrown if
+
+
+
+ Clears the collection of properties.
+
+
+
+
+ Adds a property key/value pair.
+
+ Thrown if
+ Thrown if
+
+
+
+ Removes a property key/value pair.
+
+ Thrown if
+
+
+
+ Creates a copy of the host setup information.
+
+ The copy.
+
+
+
+ Makes all paths in this instance absolute.
+
+
+
+
+ Writes a temporary configuration file for the application to disk and returns its path
+ based on
+
+
+ The file is created with a unique name each time.
+
+
+ The file should be deleted by the caller when no longer required.
+
+
+ The full path of the configuration file that was written, or null if no file was written.
+ Thrown if null but
+ Thrown if the configuration file could not be written.
+
+
+
+ Gets a read-only collection of configuration properties for the host.
+
+
+
+
+ Gets or sets the relative or absolute path of the application base directory,
+ or null to use a default value selected by the consumer.
+
+
+
+ If relative, the path is based on the current working directory,
+ so a value of "" causes the current working directory to be used.
+
+
+ Relative paths should be canonicalized as soon as possible.
+ See
+
+
+ The application base directory. Default is null .
+
+
+
+
+ Gets or sets the relative or absolute path of the working directory
+ or null to use a default value selected by the consumer.
+
+
+
+ If relative, the path is based on the current working directory,
+ so a value of "" causes the current working directory to be used.
+
+
+ Relative paths should be canonicalized as soon as possible.
+ See
+
+
+ The working directory. Default is null .
+
+
+
+
+ Gets the read-only list of relative or absolute paths of
+ hint directories used to resolve assemblies.
+
+
+
+ If relative, the path is based on the current working directory,
+ so a value of "" causes the current working directory to be used.
+
+
+ Relative paths should be canonicalized as soon as possible.
+ See
+
+
+
+
+ Gets or sets whether assembly shadow copying is enabled.
+
+ True if shadow copying is enabled. Default is false .
+
+
+
+ Gets or sets the debugger setup options, or null if not debugging.
+
+ The debugger setup options. Default is null .
+
+
+
+ Gets or sets the .Net runtime version of the host, or null to auto-detect.
+
+ The runtime version, eg. "v2.0.50727". Default is null .
+
+
+
+ Gets or sets whether the host should run with elevated privileges.
+
+ True if the host should have elevated privileges. Default is false .
+
+
+
+ Gets or sets where the host should write out the configuration file for the hosted components.
+
+ The configuration file location. Default is
+
+
+
+ Gets or sets the host configuration information.
+
+ Thrown if
+
+
+
+ Gets or sets the processor architecture that the host should target, when supported.
+
+ The processor architecture. Default is
+
+
+
+ A factory for initialized
+
+
+
+ Gets the component Id of this factory.
+
+
+
+
+ Creates a host factory.
+
+ Thrown if
+
+
+
+
+
+ A factory for initialized
+
+
+
+ Gets the component Id of this factory.
+
+
+
+
+ Creates a host factory.
+
+ Thrown if
+
+
+
+
+
+ Gets the path of the runtime components, in particular the folder where Gallio.Host.exe is located.
+
+
+
+
+ A remotely accessible host service.
+
+
+
+
+ Creates a host service.
+
+
+
+
+ Waits until the host service is shutdown or a ping timeout occurs.
+
+
+
+
+
+
+
+
+
+
+ Returns true if the watchdog timer expired.
+
+
+
+
+ Wraps a logger so that it can be accessed remotely.
+
+
+
+
+ Creates a wrapper for the specified logger.
+
+ Thrown if
+
+
+
+
+
+ Forwards messages to the host's logger.
+
+
+
+
+ Static service locator for
+
+
+ Handles the case where the runtime is not initialized by returning a
+
+
+
+
+
+ Gets the global test context tracker singleton.
+
+
+
+
+ Generates test commands from a tree of tests using topological sort to
+ order tests by dependencies and a test order strategy for tie-breaking.
+
+
+
+
+ Creates a test command factory with a default test order strategy.
+
+
+
+
+
+
+ Gets or sets the test order strategy to use when deciding how test commands
+ should be sorted.
+
+ The test order strategy. Defaults to
+ Thrown if
+
+
+
+ A filter that matches objects whose
+
+
+
+ Abstract base class for filters that encapsulate a rule
+ for selecting some property of an object to be compared
+ against a string value filter.
+
+
+
+
+ A filter is a serializable predicate.
+
+
+
+ The framework uses filters to select among tests discovered through
+ the process of test enumeration.
+
+
+ Filters must be serializable objects defined in the framework assembly
+ or in plugins. The reason is that filter definitions may need to be
+ transferred across AppDomains so the filter's concrete type must be
+ known to the recipient. Filters do not implement
+
+
+
+
+ Determines whether the filter matches the value.
+
+ True if the filter matches the value.
+
+
+
+ Accepts a visitor and performs double-dispatch.
+
+
+
+
+ Formats the filter to a string suitable for parsing by
+ The formatted filter expression.
+
+
+
+ Creates a filter for some property by string value.
+
+ Thrown if
+
+
+
+
+
+ Gets the key that represents the filtered property.
+
+
+
+
+ Gets the string value filter.
+
+
+
+
+ Creates a name filter.
+
+ Thrown if
+
+
+
+
+
+
+
+
+
+ Describes an annotation in a portable manner for serialization.
+
+
+
+
+ Creates an uninitialized instance for Xml deserialization.
+
+
+
+
+ Creates an annotation.
+
+ Thrown if
+
+
+
+ Copies the contents of an annotation.
+
+ Thrown if
+
+
+
+ Recreates a
+
+
+ Because an annotation data object does not contain all of the details of the original
+ annotation some information may be lost in the round trip.
+
+
+ The annotation.
+
+
+
+ Writes the annotation to a logger for presentation.
+
+ Thrown if
+
+
+
+
+
+ Gets or sets the code element or null if none. (not serialized)
+
+
+
+
+ Gets or sets the annotation type.
+
+
+
+
+ Gets or sets the code location associated with the annotation.
+
+
+
+
+ Gets or sets the code reference associated with the annotation.
+
+
+
+
+ Gets or sets the annotation message.
+
+ Thrown if
+
+
+
+ Gets or sets additional details such as exception text, or null if none.
+
+
+
+
+ A factory for
+
+
+
+ A test tunner factory is a service that creates an
+
+
+ Each factory has a name which is used by
+
+
+
+
+ Creates a test runner.
+
+ The test runner.
+
+
+
+ Creates a test runner factory.
+
+ Thrown if
+
+
+
+
+
+ The default implementation of
+
+
+
+ A test runner manager enumerates the names of the
+
+
+
+
+ Gets the factory by name, or null if none.
+
+ The test runner.
+ Thrown if
+
+
+
+ Creates a test runner.
+
+ The test runner.
+ Thrown if
+
+
+
+ Gets handles for all registered test runner factories.
+
+
+
+
+ Creates a test runner manager.
+
+ Thrown if
+
+
+
+
+
+
+
+
+
+ Utilities for working with
+
+
+
+ Recursively copies files and folders from the source path in the native
+ file system to the destination path within the report container.
+
+ Thrown if
+
+
+
+ Describes the number of test cases with a particular
+
+
+
+ Gets or sets the outcome.
+
+
+
+
+ Gets or sets the number of test cases with the specified outcome.
+
+
+
+
+ Provides constant names for the standard test runner factories.
+
+
+
+
+ Runs the test runner in the local AppDomain.
+
+
+
+ This is is usually the default mode because tests typically
+ run inside of isolated AppDomains of their own nested within
+ the test runner.
+
+
+
+
+
+ Runs the test runner in an isolated AppDomain of the current process.
+
+
+
+
+ Runs the test runner in an isolated process.
+
+
+
+
+ Initializes and shuts down the runtime.
+
+
+
+
+ Initializes the runtime.
+
+
+
+ Loads plugins and initalizes the runtime component model. The
+ specifics of the system can be configured by editing the appropriate
+ *.plugin files to register new components and facilities as required.
+
+
+ An object that when disposed automatically calls
+ Thrown if
+ Thrown if the runtime has already been initialized.
+
+
+
+ Shuts down the runtime if it is currently initialized.
+
+
+
+ Does nothing if the runtime has not been initialized.
+
+
+
+
+
+ Provides support for working with different process execution models.
+
+
+
+
+ Returns true if the current process is running in 32bit mode.
+
+
+
+
+ Returns true if the current process is running in 64bit mode.
+
+
+
+
+ Gets the process type of the current process.
+
+
+
+
+ Gets the integrity level of the current process.
+
+
+
+
+ Returns true if the current process has elevated privileges.
+
+
+
+
+ Specifies the version of the .Net framework.
+
+
+
+
+ .Net Framework 2.0.
+
+
+
+
+ .Net Framework 3.0.
+
+
+
+
+ .Net Framework 3.5.
+
+
+
+
+ .Net Framework 4.0.
+
+
+
+
+ Default implementation of
+
+
+
+ The runtime is instantiated within the test runner to provide a suitable
+ hosting environment for test enumeration and execution.
+
+
+
+ The runtime provides services to support the Gallio test automation platform.
+ New services are typically registered by adding them to plugin configuration
+ files.
+
+
+
+
+
+ Initializes the runtime.
+
+ Thrown if the runtime could not be initialized.
+
+
+
+ Gets a deep copy of the runtime setup used to configure this runtime.
+
+ The runtime setup.
+
+
+
+ Gets the list of all plugin assembly bindings.
+
+ The assembly bindings.
+
+
+
+ Verifies that the runtime is correctly installed. Writes details to the log.
+
+ True if the installation appears ok.
+
+
+
+ Adds a log listener that will receive log messages dispatched to the runtime logger.
+
+ Thrown if
+
+
+
+ Removes a log listener so that it will no longer receive log messages dispatched to the runtime logger.
+
+ Thrown if
+
+
+
+ Gets the plugin, service and component registry.
+
+
+
+
+ Gets the service locator.
+
+
+
+
+ Gets the resource locator.
+
+
+
+
+ Gets the runtime logger.
+
+
+
+
+ Gets the runtime assembly loader.
+
+
+
+
+ Gets the condition context that is used to enable or disable plugins,
+ components and services based on characteristics of the runtime environment.
+
+
+
+
+ An event that is fired when a log message is sent to the runtime logger.
+
+
+
+
+ Initializes the runtime.
+
+ Thrown if
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Default implementation of
+
+
+
+ Provides privilege elevation services to perform tasks that require administrative rights.
+
+
+
+ This service interacts with the OS to determine whether the current user has administrative
+ rights and to prompt for elevation when required. For example, on Windows Vista this may
+ result in the appearance of a UAC dialog.
+
+
+ Windows does not support privilege elevation in process. Consequently the requested tasks
+ may be performed in a separate process when required. Parameters and results are
+ serialized and communicated with the foreign process via .Net serialization.
+
+
+ Since acquiring an elevation context may require prompting the user, they should
+ be used sparingly and in a reasonably coarse-grained manner (without compromising
+ security by running everything in an elevation context).
+
+
+
+
+
+ Acquires a context for performing elevated commands.
+
+
+
+ Provides the action with an elevation context for executing elevated commands.
+ Note that the action itself does not run with elevated privileges.
+
+
+ True if the elevation context was acquired and the action completed
+ successfully, false if the action failed or elevation was forbidden by the user or by the
+ operating system.
+ Thrown if
+
+
+
+ Returns true if the user of the current process has elevated privileges.
+
+
+
+
+ Creates an elevation manager.
+
+
+
+
+
+
+
+
+ Provides a context within which commands may be executed with elevated privileges.
+
+
+
+
+ Executes an elevated command.
+
+ The command result.
+ Thrown if
+
+
+
+ Performs an action using an elevation context.
+
+ True if the action completed successfully.
+
+
+
+ Impersonate a user according to the specified credentials.
+
+
+
+ Ref. Microsoft Help and Support .
+
+
+
+
+
+
+
+ Starts the impersonation process.
+
+ Thrown if
+ Thrown when the impersonation process has failed.
+
+
+
+ Stops the impersonation process.
+
+
+
+
+ The Gallio.Runtime.Security namespace contains types for managing permissions
+ and performing privilege elevation on demand.
+
+
+
+
+ An exception that expresses a problem while trying to impersonata user account.
+
+
+
+
+ Creates an exception.
+
+
+
+
+ Creates an exception.
+
+
+
+
+ Creates an exception.
+
+
+
+
+ Creates an exception from serialization info.
+
+
+
+
+ A utility command to clear the current user's plugin metadata cache.
+
+
+
+
+
+
+ A utility command to load an XML test report and save
+
+
+
+
+
+
+ The arguments for the command.
+
+
+
+
+ The format of the output report name.
+
+
+
+
+ The format of the output report name.
+
+
+
+
+ The path of the output report (optiona).
+
+
+
+
+ Pack the resulting report in a compressed archive (optional).
+
+
+
+
+ The type of the output report.
+
+
+
+
+ An elevated command used for resetting the installation id.
+
+
+
+
+ The id of this elevated command.
+
+
+
+
+ Initializes the command.
+
+
+
+
+
+
+ Arguments for the command.
+
+
+
+
+ A utility command to reset the installation id.
+
+
+
+
+ Creates the command.
+
+
+
+
+
+
+ The default utility command manager implementation.
+
+
+
+
+ Provides services for managing utility commands.
+
+
+
+
+ Gets the utility command with the specified name ignoring case, or null if not registered.
+
+ The command.
+ Thrown if
+
+
+
+ Gets handles for all registered utility commands.
+
+
+
+
+ Creates a utility command manager.
+
+
+
+
+
+
+
+
+ The Gallio.Runtime.UtilityCommands namespace contains types for defining
+ an extensible set of utility commands that can be invoked from the
+ Gallio.Utility.exe application.
+
+
+
+
+ Describes the execution context of a utility command and allows it
+ to interact with the environment.
+
+
+
+
+ Creates a utility command context.
+
+ Thrown if
+
+
+
+ Gets the parsed command-line arguments.
+
+
+
+
+ Gets the console.
+
+
+
+
+ Get the logger for writing messages to the console colored and
+ filtered by severity.
+
+
+
+
+ Gets the progress monitor provider for obtaining console progress monitors,
+ or a null progress monitor provider if progress monitoring has been disabled.
+
+
+
+
+ Gets the verbosity requested by the user.
+
+
+
+
+ Provides traits for
+
+
+
+ Creates utility command traits.
+
+
+
+
+ Gets the unique name of the utility command.
+
+
+
+
+ Gets the description of the utility command.
+
+
+
+
+ A utility command to verify that the plugin metadata and installation parameters are correct.
+
+
+
+
+ Creates the command.
+
+
+
+
+
+
+ Describes an assembly used by a plugin and how the loader should bind to it.
+
+
+
+
+ Creates an uninitialized assembly reference for XML deserialization.
+
+
+
+
+ Creates an assembly reference.
+
+ Thrown if
+
+
+
+
+
+ Gets or sets the assembly full name.
+
+ Thrown if
+
+
+
+ Gets or sets the assembly code base as a relative path to the plugin
+ base directory or to the 'bin' directory within, or null if none.
+
+
+
+
+ Gets or sets whether the assembly full name should be used to qualify all partial
+ name references to the assembly.
+
+
+
+
+ Gets or sets whether to apply the assembly publisher policy. Default is true .
+
+
+
+
+ Gets the mutable list of assembly binding redirects.
+
+
+
+
+ Describes a plugin cache file.
+
+
+
+ This type supports the framework and is not intended to be used by client code.
+
+
+
+
+
+ Creates an empty cache.
+
+
+
+
+
+
+ Gets or sets the installation id of the Gallio installation whose plugin information has been recorded in the cache, or null if not known.
+
+
+
+
+ Gets the mutable list of plugin information records in the cache.
+
+
+
+
+ Represents a component descriptor in Xml.
+
+
+
+
+ Creates an uninitialized component descriptor for XML deserialization.
+
+
+
+
+ Creates a component descriptor.
+
+ Thrown if
+
+
+
+
+
+ Gets or sets the component id.
+
+ Thrown if
+
+
+
+ Gets or sets the service id.
+
+ Thrown if
+
+
+
+ Gets or sets the assembly-qualified component type name, or null to use the
+ default for the service.
+
+
+
+
+ Gets or sets the component parameters, or null if there are none.
+
+
+
+
+ Gets or sets the component traits, or null if there are none.
+
+
+
+
+ Describes information about a plugin whose metadata has been cached.
+
+
+
+ This type supports the framework and is not intended to be used by client code.
+
+
+
+
+
+
+
+ Gets or sets the plugin file path.
+
+
+
+
+ Gets or sets the plugin file modification time stamp.
+
+
+
+
+ Gets or sets the plugin metadata.
+
+
+
+
+ Gets or sets the plugin base directory path.
+
+
+
+
+ Specifies an old version range for an assembly binding redirect.
+
+
+
+
+ Creates an uninitialized assembly binding redirect for XML deserialization.
+
+
+
+
+ Creates an assembly binding redirect.
+
+
+
+ Accepts a version number like "1.2.3.4" or a range like "1.0.0.0-1.1.65535.65535".
+
+
+ Thrown if
+
+
+
+
+
+ Gets or sets the old assembly version number or range.
+
+
+
+ Accepts a version number like "1.2.3.4" or a range like "1.0.0.0-1.1.65535.65535".
+
+
+ Thrown if
+
+
+
+ Describes a file that belongs to a plugin.
+
+
+
+
+ Creates an uninitialized file description for XML deserialization.
+
+
+
+
+ Creates a file description.
+
+ Thrown if
+
+
+
+
+
+ Gets or sets the path of the file relative to the plugin base directory.
+
+ Thrown if
+
+
+
+ Describes a dependency on another plugin.
+
+
+
+
+ Creates an uninitialized dependency for XML deserialization.
+
+
+
+
+ Creates an plugin dependency reference.
+
+ Thrown if
+
+
+
+
+
+ Gets or sets the referenced plugin id.
+
+ Thrown if
+
+
+
+ The Gallio.Runtime.Extensibility.Schema namespace contains the plugin Xml schema.
+
+
+
+
+ Represents a plugin descriptor in Xml.
+
+
+
+
+ Creates an uninitialized plugin descriptor for XML deserialization.
+
+
+
+
+ Creates a plugin descriptor with an id.
+
+ Thrown if
+
+
+
+
+
+ Gets or sets the plugin id.
+
+ Thrown if
+
+
+
+ Gets or sets a condition governing the activation of the plugin,
+ or null if there is no condition. The plugin will be disabled if a
+ condition is provided but is not satisfied.
+
+
+
+
+ Gets or sets the recommended installation path for the plugin files relative to
+ the runtime installation directory, or null if there is no preference.
+
+
+
+
+ Gets or sets the assembly-qualified plugin type name, or null if the default
+ implementation may be used.
+
+
+
+
+ Gets the mutable list of plugin dependencies.
+
+
+
+
+ Gets the mutable list of files that belong to a plugin.
+
+
+
+
+ Gets the mutable list of plugin assembly bindings.
+
+
+
+
+ Gets the mutable list of services belonging to the plugin.
+
+
+
+
+ Gets the mutable list of components belonging to the plugin.
+
+
+
+
+ Gets or sets the plugin parameters, or null if there are none.
+
+
+
+
+ Gets or sets the plugin traits, or null if there are none.
+
+
+
+
+ Gets the mutable list of additional probing paths in which to
+ attempt to locate referenced assemblies.
+
+
+
+
+ Represents a table of key and value pairs as a sequence of Xml elements whose local name
+ represents the key and whose text body contains the value.
+
+
+
+
+ Creates an empty key value table.
+
+
+
+
+ Gets or sets the Xml elements that describe the property entries
+ during serialization.
+
+ Thrown if
+
+
+
+ Gets or sets a mutable view of the properties as a property set.
+
+ Thrown if
+
+
+
+ Represents a service descriptor in Xml.
+
+
+
+
+ Creates an uninitialized service descriptor for XML deserialization.
+
+
+
+
+ Creates a service descriptor.
+
+ Thrown if
+
+
+
+
+
+ Gets or sets the service id.
+
+ Thrown if
+
+
+
+ Gets or sets the assembly-qualified service type name.
+
+ Thrown if
+
+
+
+ Gets or sets the assembly-qualified default component type name, or null if none.
+
+
+
+
+ An exception that expresses a data validation error.
+
+
+
+
+ Creates an exception.
+
+
+
+
+ Creates an exception.
+
+
+
+
+ Creates an exception.
+
+
+
+
+ Creates an exception from serialization info.
+
+
+
+
+ Represents a collection of preferences in Xml.
+
+
+
+
+ Creates a preference container.
+
+
+
+
+
+
+ Gets the mutable list of preference settings.
+
+
+
+
+ Represents a preference setting in Xml.
+
+
+
+
+ Creates an uninitialized preference setting for XML deserialization.
+
+
+
+
+ Creates a preference setting.
+
+ Thrown if
+
+
+
+
+
+ Gets or sets the preference setting name.
+
+ Thrown if
+
+
+
+ Gets or sets the preference setting value.
+
+ Thrown if
+
+
+
+ Defines constants used throughout the Gallio schema.
+
+
+
+
+ The XML namespace for all schema types.
+
+
+
+
+ Validation utilities.
+
+
+
+ These utilities are not intended to be used for argument validation; use
+ code that throws
+
+
+
+
+ Validates that an item is not null.
+
+ The item type.
+
+
+
+ Validates that an item is a valid assembly name.
+
+
+
+
+ Validates that all items in a collection are not null.
+
+ The item type.
+ Thrown if the validation fails.
+
+
+
+ Validates all non-null items of an enumeration of validatable elements.
+
+ The item type.
+ Thrown if the validation fails.
+
+
+
+ An immutable record that holds three values.
+
+ The type of the first value.
+ The type of the second value.
+ The type of the third value.
+
+
+
+ Creates a triple.
+
+
+
+
+ Gets the first value.
+
+
+
+
+ Gets the second value.
+
+
+
+
+ Gets the third value.
+
+
+
+
+ Default implementation of IFileSystem using System.IO classes.
+
+
+
+
+ Wrapper for static System.IO.File operations to
+ allow testing.
+
+
+
+
+ Checks if a given file exists (File.Exists).
+
+ True if the file exists, otherwise False.
+
+
+
+ Checks if a path is relative or absolute (Path.IsPathRooted).
+
+ True if the path is absolute, otherwise False.
+
+
+
+ Checks if a directory exists (Directory.Exists)
+
+ True if the directory exists, otherwise False.
+
+
+
+ Attempts to create a directory.
+
+
+
+
+ Attempts to delete a file.
+
+
+
+
+ Attempts to open a file using the default program.
+
+
+
+
+ Opens an existing file for reading.
+
+ The content of the file as a readable stream.
+
+
+
+ Returns a list of matching files in the specified directory.
+
+ A string array of filenames.
+
+
+
+ Copies an existing file to a new file. Overwriting a file of the same name is allowed.
+
+
+
+
+ Deletes the specified directory and, if indicated,
+ any subdirectories in the directory.
+
+
+
+
+ Copy a directory and contents.
+
+
+
+
+ Opens a binary file, reads the contents of the file into a byte array, and then closes the file.
+
+ The binary contents of the file.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Provides Xml serialization and deserialization services.
+
+
+
+
+ Saves an object graph to a pretty-printed Xml file using
+ The root object type.
+ Thrown if
+
+
+
+ Loads an object graph from an Xml file using
+ The root object.
+ The root object type.
+ Thrown if
+
+
+
+ A structure that memoizes the result of some computation for later reuse.
+
+
+
+ Not thread safe.
+
+
+ The value type.
+
+ valueMemoizer = new Memoizer();
+
+ public int GetValue()
+ {
+ return valueMemoizer.Memoize(() =>
+ {
+ // Expensive calculation here.
+ return 42;
+ });
+ }
+ }
+ ]]>
+
+
+
+
+ Gets the memoized value if available, otherwise populates it
+ using the specified populator function and stores it for later reuse.
+
+ The value returned by the populator, possibly memoized.
+
+
+
+ Sets
+
+
+
+ Saves the current directory then changes it to the specified value.
+
+ Thrown if
+ Thrown if the current directory could not be set.
+
+
+
+ Resets the current directory to its original saved value.
+
+ Thrown if the current directory could not be reset.
+
+
+
+ Resets the current directory to its original saved value if disposing.
+
+ Thrown if the current directory could not be reset.
+
+
+
+ Provides a few functions for working with
+
+
+
+ Safely invokes each delegate in the invocation list of an event handler.
+ Sends any exceptions thrown by the handler to
+
+
+
+ Safely invokes each delegate in the invocation list of an event handler.
+ Sends any exceptions thrown by the handler to
+
+
+
+ A structure that memoizes the result of some computation for later reuse.
+ Maintains an internal dictionary to memoize results by key.
+
+
+
+ Not thread safe.
+
+
+ The key type.
+ The value type.
+
+ valueMemoizer = new KeyedMemoizer();
+
+ public int GetValue(string key)
+ {
+ return valueMemoizer.Memoize(key, () =>
+ {
+ // Expensive calculation here.
+ return 42;
+ });
+ }
+ }
+ ]]>
+
+
+
+
+ Gets the memoized value for the given key if available, otherwise populates it
+ using the specified populator function and stores it in association with its keys
+ for later reuse.
+
+ The value returned by the populator, possibly memoized.
+
+
+
+ This class provides a mechanism for reporting unhandled exceptions when the infrastructure
+ is otherwise unable to deal with them locally.
+
+
+
+ The methods of this class should be considered as the last resort for reporting failures
+ that might otherwise cause the system to crash.
+
+
+
+
+
+ Reports an unhandled exception.
+
+ Thrown if
+
+
+
+ Adds or removes an event handler that is notified when unhandled exceptions occur
+ and is given a chance to add additional information the event about the
+ context in which the exception occurred.
+
+
+
+
+ Adds or removes an event handler that is notified when unhandled exceptions occur.
+
+
+
+
+ Returns true if there is at least one handler registered for
+
+
+
+ This property can be used to avoid duplicate exception reporting
+ if some other system component has already registered a handler.
+
+
+
+
+
+ Formats filters in such manner that they can be reparsed using the
+
+
+
+
+ Visits the structure of filters.
+
+
+
+
+ Visits a
+
+
+
+ Visits a
+
+
+
+ Visits a
+
+
+
+ Visits a
+
+
+
+ Visits a
+
+
+
+ Visits a
+
+
+
+ Visits a
+
+
+
+ Visits a
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Gets the formatted filter contents.
+
+ The formatted filter.
+
+
+
+ An equality filter compares values for strict equality.
+
+
+
+
+ Creates an equality filter.
+
+
+
+
+
+
+
+
+
+
+ Gets the value to compare for equality.
+
+
+
+
+ Provides utilities for manipulating filters.
+
+
+
+
+ Parses a test filter set.
+
+ The parsed filter set.
+
+
+
+ Parses a test filter.
+
+ The parsed filter.
+
+
+
+ Creates filters of a given type based on a specification that
+ consists of a filter key and a rule for matching values.
+
+ The filter type.
+
+
+
+ Creates a filter from a specification
+
+ The filter.
+
+
+
+ Builds filters for
+
+
+ Recognizes the following filter keys:
+
+ - Id: Filter by id
+ - Name: Filter by name
+ - Assembly: Filter by assembly name
+ - Namespace: Filter by namespace name
+ - Type: Filter by type name, including inherited types
+ - ExactType: Filter by exact type name, excluding inherited types
+ - Member: Filter by member name
+ - *: All other names are assumed to correspond to metadata keys
+
+
+
+ The
+
+
+
+
+
+ A regex filter matches strings against a given
+
+
+ Null string values are converted to empty strings for regex evaluation purposes.
+
+
+
+
+
+ Creates an regex filter.
+
+ Thrown if
+
+
+
+
+
+
+
+
+
+ Gets the regular expression for matching strings.
+
+
+
+
+ Filter record for Gallio project.
+
+
+
+
+ Parameterless constructor for serialization.
+
+
+
+
+ Creates a filter description.
+
+ Thrown if
+
+
+
+ Creates a copy of the filter.
+
+ The new copy.
+
+
+
+
+
+ Gets or sets the name of the filter.
+
+ Thrown if
+
+
+
+ Gets or sets a string representation of the filter expression.
+
+ Thrown if
+
+
+
+ Describes a test project in a portable manner for serialization.
+
+
+
+
+ Creates an empty test project.
+
+
+
+
+ Copies the contents of a test project.
+
+ Thrown if
+
+
+
+ Initializes a test project with the contents of this structure.
+
+ Thrown if
+
+
+
+ Creates a test project with the contents of this structure.
+
+ The test project.
+
+
+
+ Makes the test project paths relative to the specified base path.
+
+ Thrown if
+
+
+
+ Makes the test project paths absolute given the specified base path.
+
+ Thrown if
+
+
+
+
+
+ Gets or sets the test package.
+
+ Thrown if
+
+
+
+ Gets a mutable list of named test filters for the project.
+
+
+
+
+ Gets a mutable list of test runner extensions used by the project.
+
+
+
+
+ Gets or sets the folder to save generated reports to.
+
+
+
+ Relative to project location, if not absolute.
+
+
+ Thrown if
+
+
+
+ Gets or sets the format for the filename of generated reports.
+
+ Thrown if
+
+
+
+ Default implementation of a report reader.
+
+
+
+
+ A report reader provides services for loading a previously saved report
+ from a
+
+
+
+ Loads the report from an XML file.
+
+
+
+ The path of the saved report is constructed by appending the extension ".xml"
+ to the container's
+
+ The loaded report.
+ Thrown if
+
+
+
+ Loads referenced report attachments from the container.
+
+
+
+ This method has the effect of populating the contents of all
+
+ Thrown if
+
+
+
+ Gets the report container.
+
+
+
+
+ Creates a report reader.
+
+ Thrown if
+
+
+
+
+
+
+
+
+
+ Default implementation of a report writer.
+
+
+
+
+ A report writer provides services for formatting or saving a report
+ to a
+
+
+ The writer tracks the paths of the report documents paths
+ that are created within the report container. Likewise it remembers whether
+ attachments have been saved so as to avoid redundantly resaving them when
+ the same report is generated in multiple formats.
+
+
+
+
+
+ Adds the path of a report document that has been created within the report container.
+
+
+
+
+ Serializes the report to XML.
+
+ Thrown if
+
+
+
+ Saves the report as an XML file.
+
+
+
+ The saved report XML file is automatically added to the
+
+ The path of the saved report is constructed by appending the extension ".xml"
+ to the container's
+
+ This method may do nothing if the report has already been saved.
+
+
+ Thrown
+
+
+
+ Saves all report attachments as individual content files to the container.
+
+
+
+ The convention for attachments is to save them in a directory with the same name
+ as the container's
+
+ This method may do nothing if the attachments have already been saved.
+
+
+ Thrown if
+
+
+
+ Gets the report being generated.
+
+
+
+
+ Gets the report container.
+
+
+
+
+ Gets the paths of all report documents that have been generated within
+ the report container.
+
+
+
+ Report documents are the primary files when reports
+ are formatted or saved such as an XML file, a Text file, or the main
+ HTML file that contains the body of the report.
+
+
+
+
+
+ Creates a report writer for the specified report.
+
+ Thrown if
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ A file-system based representation of a report container that uses
+ ordinary files and folders to store report contents.
+
+
+
+
+ Creates a file-system based representation of a report container.
+
+ Thrown if
+ Thrown if
+
+
+
+
+
+
+
+
+
+ Contains the result of a complete test run.
+
+
+
+
+ Creates a launcher result object.
+
+
+
+
+ Sets the result code of the result.
+
+
+
+
+ Adds a new report document path.
+
+ Thrown if
+
+
+
+ Generates reports of the desired forms.
+
+
+
+ This method adds the paths of the generated report documents to
+
+ Thrown if
+
+
+
+ Shows the report documents enumerated in the launcher result.
+
+ True if the report documents were successfully opened.
+
+
+
+ Gets the result code.
+
+
+
+
+ Gets the test report.
+
+
+
+ The report might be incomplete in varying degrees depending on how much
+ of the test execution was successfully performed.
+
+
+
+
+
+ Gets a short summary with the number of test that passed, failed and so on.
+
+
+
+
+ Gets the statistics of the execution from the report
+ or an empty statistics object if none.
+
+
+
+
+ Gets the full paths of the formatted report documents.
+
+ The full paths of the formatted report documents.
+
+
+
+ Describes a test model component in a portable manner for serialization.
+
+
+
+
+ Creates an uninitialized instance for Xml deserialization.
+
+
+
+
+ Creates a test component.
+
+ Thrown if
+
+
+
+ Copies the contents of a test component.
+
+
+
+
+ Gets or sets the code element or null if none. (not serialized)
+
+
+
+
+ Gets or sets the test component id. (non-null)
+
+ Thrown if
+
+
+
+ Gets or sets the test component name. (non-null)
+
+ Thrown if
+
+
+
+ Gets or sets the code reference or
+
+
+
+ Gets or sets the code location or
+
+
+
+ Gets or sets the metadata map. (non-null)
+
+ Thrown if
+
+
+
+ Describes a test step in a portable manner for serialization.
+
+
+
+
+ Creates an uninitialized instance for Xml deserialization.
+
+
+
+
+ Creates a step.
+
+ Thrown if
+
+
+
+ Copies the contents of a test step.
+
+ Thrown if
+
+
+
+ Recreates a
+
+
+ Because a test step data object does not contain all of the details of the original
+ test step some information may be lost in the round trip.
+
+
+ The test step.
+ Thrown if
+
+
+
+
+
+ Gets or sets the full name of the step.
+
+ Thrown if
+
+
+
+ Gets or sets the id of the parent step.
+
+
+
+
+ Gets or sets the id of the test to which the step belongs.
+
+ Thrown if
+
+
+
+ Gets or sets whether the test step is primary.
+
+
+
+
+ Gets or sets whether the test step represents a test case.
+
+
+
+
+ Gets or sets whether the test step is dynamic.
+
+
+
+
+ Describes a test parameter in a portable manner for serialization.
+
+
+
+
+ Creates an uninitialized instance for Xml deserialization.
+
+
+
+
+ Creates a parameter data object.
+
+ Thrown if
+
+
+
+ Copies the contents of a test parameter.
+
+ Thrown if
+
+
+
+ Recreates a
+
+
+ Because a test parameter data object does not contain all of the details of the original
+ test parameter some information may be lost in the round trip.
+
+
+ The test parameter.
+
+
+
+
+
+ Describes a test in a portable manner for serialization.
+
+
+
+
+ Creates an uninitialized instance for Xml deserialization.
+
+
+
+
+ Creates a test data object.
+
+ Thrown if
+
+
+
+ Copies the contents of a test recursively including its children.
+
+ Thrown if
+
+
+
+ Copies the contents of a test.
+
+ Thrown if
+
+
+
+ Recreates a
+
+
+ Because a test data object does not contain all of the details of the original
+ test some information may be lost in the round trip.
+
+
+ The test.
+
+
+
+
+
+
+
+ Gets or sets the full name of the test.
+
+ Thrown if
+
+
+
+ Gets or sets whether this node is a test case.
+
+
+
+
+ Gets the mutable list of children.
+
+
+
+
+ Gets the mutable list of parameters.
+
+
+
+
+ Recursively enumerates this test and all of its descendants.
+
+
+
+
+ Provides options that control how test execution occurs.
+
+
+
+
+ Creates a default set of test execution options.
+
+
+
+
+ Clears the collection of properties.
+
+
+
+
+ Adds a property key/value pair.
+
+ Thrown if
+ Thrown if
+
+
+
+ Removes a property key/value pair.
+
+ Thrown if
+
+
+
+ Creates a copy of the options.
+
+ The copy.
+
+
+
+ Gets or sets the filter set.
+
+ Defaults to an empty filter set.
+ Thrown if
+
+
+
+ Gets or sets whether the filter exactly specifies all tests to select.
+
+
+
+ If false , then children of the selected tests are also included.
+
+
+ Defaults to false.
+
+
+
+ Gets or sets whether to skip running tests that use dynamic data items.
+
+
+
+ This flag can be useful in combination with
+
+ Defaults to false
+
+
+
+ Gets or sets whether to skip the execution of tests.
+
+
+
+ The test runner will go through most of the motions of running tests but will skip
+ the actual execution phase. This option can be used to enumerate data-driven test
+ steps without running them. It can also be used to verify that the execution
+ environment is sane without doing most of the work of running the tests.
+
+
+ Defaults to false
+
+
+
+ Gets or sets whether to run tests within a single thread. This ensures that the
+ tests will run on the same thread as the initial call to the test harness (unless
+ the test framework itself spawns any new threads).
+
+
+
+ When tests are run single-threaded, the test harness will no longer be able to guarantee
+ that the default apartment state is
+
+ Defaults to false .
+
+
+
+ Gets a read-only collection of configuration properties for test execution.
+
+
+
+
+ The test model captures the root of the test data tree along with an index by id.
+
+
+
+ This class is safe for used by multiple threads.
+
+
+
+
+
+ Creates an empty test model with just a root test.
+
+
+
+
+ Copies the contents of a test model.
+
+ Thrown if
+
+
+
+ Creates a test model.
+
+ Thrown if
+
+
+
+ Gets the number of error annotations on the model.
+
+ The numer of error annotations present.
+
+
+
+ Gets a test by its id.
+
+ The test, or null if not found.
+ Thrown if
+
+
+
+ Resets the test index by id in case the test model has been modified.
+
+
+
+
+ Merged a subtree of tests into the model.
+
+
+
+ Merges tests with duplicate ids. Adds new tests in place.
+
+
+ The merged test, if the test was already present in the tree.
+ Thrown if
+
+
+
+ Gets or sets the root test in the model.
+
+ Thrown if
+
+
+
+ Gets the mutable list of annotations.
+
+
+
+
+ Recursively enumerates all tests including the root test.
+
+
+
+
+ A test result describes the final result of having executed a test.
+
+
+
+
+ Creates a test result with an inconclusive outcome.
+
+
+
+
+ Creates a test result with a particular outcome.
+
+
+
+
+ Creates a copy of the test result.
+
+ The copy.
+
+
+
+
+
+ Gets or sets the test outcome, including its children (unless they were skipped
+ or are otherwise irrelevant to the outcome of their parent).
+
+
+ Defaults to
+
+
+
+ Gets or sets the number of assertions evaluated by the test, including its children.
+
+
+
+
+ Gets or sets the test duration, including its children.
+
+
+
+
+ Gets or sets the test duration in seconds, including its children.
+
+
+
+
+ The default implementation of
+
+
+
+ The report manager provides services for manipulating reports.
+
+
+
+
+ Gets the report formatter with the specified name, or null if none.
+
+ The formatter, or null on failure.
+ Thrown if
+
+
+
+ Formats the report indicated by the report writer.
+
+ Thrown if
+ Thrown if there is no formatter with the specified name.
+
+
+
+ Gets a report reader to load a report from the specified container.
+
+ The report reader.
+ Thrown if
+
+
+
+ Gets a report writer to save or format a report to the specified container.
+
+ The report writer.
+ Thrown if
+
+
+
+ Gets handles for all registered formatters.
+
+
+
+
+ Creates a report manager.
+
+ Thrown if
+
+
+
+
+
+
+
+
+
+
+
+
+
+ A report formatter provides a strategy for formatting reports for human consumption.
+
+
+
+
+ Formats the report indicated by the report writer.
+
+ Thrown if
+
+
+
+ Summarizes the execution of a test package for reporting purposes.
+
+
+
+
+ Creates an empty package run.
+
+
+
+
+ Gets or sets the time when the package run started.
+
+
+
+
+ Gets or sets the time when the package run ended.
+
+
+
+
+ Gets or sets the root test step run, or null if the root test has not run.
+
+
+
+
+ Gets or sets the statistics for the package run.
+
+ Thrown if
+
+
+
+ Recursively enumerates all test step runs including the root test step run.
+
+
+
+
+ Collects summary statistics about test execution for reporting purposes.
+
+
+
+
+ Creates an empty statistics record.
+
+
+
+
+ Gets the number of tests with the specified outcome.
+
+ The number of tests with the specified outcome.
+
+
+
+ Sets the number of tests with the specified outcome.
+
+ Thrown if
+
+
+
+ Formats a single line of text summarizing test case results.
+
+
+
+
+ Merges statistics from a test step run, incrementing the relevant counters.
+
+ Thrown if
+
+
+
+ Updates the test outcome statistics counters with an the outcome of a test.
+
+
+ Does not update the test or step count.
+
+
+
+
+ Gets or sets the number of assertions evaluated.
+
+
+
+
+ Gets or sets the total duration summarized tests in seconds.
+
+
+
+
+ Gets or sets the number of test cases that were run.
+
+
+
+
+ Gets or sets the number of test cases that ran and passed.
+
+
+
+
+ Gets or sets the number of test cases that ran and failed.
+
+
+
+
+ Gets or sets the number of test cases that ran and were inconclusive.
+
+
+
+
+ Gets or sets the number of test cases that did not run.
+
+
+
+
+ Gets or sets the total number of test cases.
+
+
+
+
+ Gets or sets the total number of test steps.
+
+
+
+
+ Gets or sets the test outcome summaries.
+
+ Thrown if
+
+
+
+ A report includes a description of the test package, the model objects,
+ the combined results of all test runs and summary statistics.
+
+
+
+
+ Creates an empty report.
+
+
+
+
+ Adds a log entry to the report.
+
+ Thrown if
+
+
+
+ Formats the specified name.
+
+
+
+ The following tags are processed:
+
+ {0} is replaced by the start date of the test run, or by the current date if not applicable ("yyyyMMdd").{1} is replaced by the start time of the test run, or by the current time if not applicable ("HHmmss").
+
+
+ The resulting formatted report name.
+
+
+
+ Gets or sets the test package configuration, or null if none.
+
+
+
+
+ Gets or sets the test model, or null if none.
+
+
+
+
+ Gets or sets the test package run results, or null if none.
+
+
+
+
+ Gets a mutable list of log entries.
+
+
+
+
+ Summarizes the execution of a single test step for reporting purposes.
+
+
+
+
+ Creates an uninitialized instance for Xml deserialization.
+
+
+
+
+ Creates a test run step.
+
+ Thrown if
+
+
+
+ Returns the name of the test step run.
+
+
+
+
+ Gets or sets information about the step.
+
+ Thrown if
+
+
+
+ Gets the list of child step runs.
+
+
+
+
+ Gets or sets the time when the test run started.
+
+
+
+
+ Gets or sets the time when the test run ended.
+
+
+
+
+ Gets or sets the test result from the run.
+
+ Thrown if
+
+
+
+ Gets or sets the test log.
+
+ Thrown if
+
+
+
+ Recursively enumerates all test step runs including this one.
+
+
+
+
+ The type of exception thrown when the test runner or one of its
+ supportive components like a test domain fails in an unrecoverable manner.
+
+
+
+ It can happen that the test results will be lost or incomplete.
+
+
+
+
+
+ Creates an exception.
+
+
+
+
+ Creates an exception.
+
+
+
+
+ Creates an exception.
+
+
+
+
+ Creates an exception from serialization info.
+
+
+
+
+ A filter parser constructs filters from its textual representation as a filter
+ expression.
+
+
+
+ A filter rule consists of zero or more filter expressions
+ that may be combined using 'and', 'or', and 'not' and grouped with
+ parentheses. A filter expression consists of a filter key followed by one or
+ more comma-delimited matching values in the form 'key: value, "quoted value",
+ /regular expression/'.
+
+ The filter grammar is defined as follows:
+
+ ::= [^:,*()/\"']+
+
+ ::= '"' .* '"' # String delimited by double quotation marks
+ | "'" .* "'" # String delimited by single quotation marks
+
+ ::=
+ |
+
+ ::= "/" .* "/" # Regular expression
+ | "/" .* "/i" # Case-insensitive regular expression
+
+ ::=
+
+ ::= # Value specified by exact string
+ | # Value specified by regular expression
+
+ ::= (',' )* # One or more comma-separated values
+
+ ::= "*" # "Any"
+ | ":" matchSeq>
+ | OR filterExpr> # Combine filter expressions with OR
+ | AND filterExpr> # Combine filter expressions with AND
+ | NOT # Negate filter expression
+ | "(" ")" # Grouping filter expression
+
+ ::= # Inclusion rule (default case)
+ | INCLUDE # Inclusion rule
+ | EXCLUDE # Exclusion rule
+
+ ::= # Filter set consists of at least one filter rule.
+ | # But may be a sequence of rules.
+ ]]>
+
+ - By default this property takes the value "*", which means the "Any" filter will be applied.
+ -
+ The operator precedence is, from highest to lowest: NOT, AND, and OR. All these operators are
+ left-associative.
+
+ -
+ The commas used to separate the values are interpreted as OR operators, so "Type:Fixture1,Fixture2"
+ is equivalent to "Type:Fixture1 or Type:Fixture2".
+
+ -
+ White-space is ignored outside quoted strings, so "Type:Fixture1|Type:Fixture2" is equivalent
+ to "Type : Fixture1 | Type : Fixture2".
+
+ -
+ Commas, colons, slashes, backslashes and quotation marks can be escaped with a backslash. For
+ example, \' will be interpreted as '. Using a single backslash in front of any other character
+ is invalid.
+
+ -
+ Currently the following filter keys are recognized:
+
+ - Id: Filter by id.
+ - Name: Filter by name.
+ - Assembly: Filter by assembly name.
+ - Namespace: Filter by namespace name.
+ - Type: Filter by type name, including inherited types.
+ - ExactType: Filter by type name, excluding inherited types.
+ - Member: Filter by member name.
+ -
+ *: All other names are assumed to correspond to metadata keys. See
+
+
+
+
+
+
+ Assuming the following fixtures have been defined:
+ The following filters could be applied:
+ -
+
Type: Fixture1
+ All the tests within Fixture1 will be run.
+
+
+ -
+
Member: Test1
+ Only Fixture1.Test1 and Fixture2.Test1 will be run.
+
+
+ -
+
Type: Fixture1, Fixture2
+ All the tests within Fixture1 or Fixture2 will be run.
+
+
+ -
+
Type:Fixture1 or Type:Fixture2
+ All the tests within Fixture1 or Fixture2 will be run.
+
+
+ -
+
Type:Fixture1, Fixture2 and Member:Test2
+ Only Fixture1.Test2 and Fixture2.Test2 will be run.
+
+
+ -
+
Type:/Fixture*/ and Member:Test2
+ Only Fixture1.Test2 and Fixture2.Test2 will be run.
+
+
+ -
+
AuthorName:AlbertEinstein
+ All the tests within Fixture1 will be run because its author attribute is set to "AlbertEinstein".
+
+
+ -
+
Category: IntegrationTest
+ All the tests within Fixture2 will be run because its category attribute is set to "IntegrationTest".
+
+
+ -
+
("Type": 'Fixture1' and "Member":/Test*/) or (Type : Fixture2 and Member: /Test*/)
+ All the tests will be run. This example also shows that you can enclose key and
+ values with quotation marks, and group expressions with parentheses.
+
+
+ -
+
exclude AuthorName: AlbertEinstein
+ All the tests within Fixture2 will be run because its author attribute is not set to "AlbertEinstein".
+
+
+ -
+
exclude Type: Fixture2 include Member: Test2
+ Only Fixture1.Test2 will be run because Fixture2 was excluded from consideration before the inclusion rule was applied.
+
+
+
+
+
+
+ Creates a filter parser.
+
+ Thrown if
+
+
+
+ Creates a filter set from its textual representation as a filter set expression
+ consisting of inclusion and exclusion rules.
+
+
+
+ If the filter set expression is empty or contains only whitespace then the
+ resulting filter set will be empty.
+
+
+ The parsed filter set.
+
+
+
+ Creates a filter from its textual representation as a filter expression.
+
+ The parsed filter.
+
+
+
+ Monitors
+
+
+
+
+
+ The log extension writes a summary of test execution progress to the test runner's logger
+ so the user can monitor what's going on.
+
+
+
+ Passing tests are recorded with severity
+
+
+
+
+
+
+ Logs an annotation.
+
+
+
+
+ Logs a message about a test case that has started.
+
+
+
+ This method is not called for test steps that have
+
+
+
+
+ Logs a message about a test case that has finished.
+
+
+
+ This method is not called for test steps that have
+
+
+
+
+ Logs a message about a non-test case that has finished with some problem that
+ may have prevented other test cases from running correctly.
+
+
+
+ This method is not called for steps within test cases.
+
+
+ This method is not called for test steps that have
+
+
+
+
+ Describes the result codes used by the application.
+
+
+
+
+ The tests ran successfully or there were no tests to run.
+
+ 0
+
+
+
+ Some tests failed.
+
+ 1
+
+
+
+ The tests were canceled.
+
+ 2
+
+
+
+ A fatal runtime exception occurred.
+
+ 3
+
+
+
+ Invalid arguments were supplied on the command-line.
+
+ 10
+
+
+
+ No tests were found.
+
+ 16
+
+
+
+ The test launcher encapsulated the entire test execution lifecycle from
+ start to finish and provides a simplified pattern for running tests.
+
+
+
+ The basic usage pattern is as follows:
+
+ - Create the launcher.
+ - Set properties to specify the inputs and outputs of the test run.
+ - Run the tests all in one go.
+ - Optionally do something with the contents of the final report.
+
+
+
+ By default, the launcher assumes that a runtime environment has already been
+ established and is accessible via the
+
+
+
+
+ Creates a launcher with default options and no test assemblies specified.
+
+
+
+
+ Clears the list of file patterns.
+
+
+
+
+ Adds a file pattern if not already added to the launcher.
+
+ Thrown if
+
+
+
+ Removes a file pattern.
+
+ Thrown if
+
+
+
+ Clears the list of report formats.
+
+
+
+
+ Adds a report format if not already added to the launcher.
+
+ Thrown if
+
+
+
+ Removes a report format.
+
+ Thrown if
+
+
+
+ Cancels the test run and prevents a new one from starting.
+
+
+
+
+ Runs the test package as configured.
+
+
+
+ If null ,
+ initializes the runtime for the duration of this method then shuts it down automatically
+ before returning. Otherwise assumes the runtime has already been initialized and
+ accesses it using
+
+ Runtimes cannot be nested. So if the launcher is asked to initialize the runtime and
+ it has already been initialized, then it will not be initialized again.
+
+
+ A result object.
+
+
+
+ Processes test file patterns and generates a consolidated test project.
+
+
+
+
+ Gets or sets the progress monitor provider to use.
+
+
+
+ The default provider is
+
+ Thrown if
+
+
+
+ Gets or sets the logger to use.
+
+
+
+ The default logger is
+
+ Thrown if
+
+
+
+ Gets or sets the null if the runtime is already initialized.
+
+
+
+ If this value if not null then the launcher will initialize the runtime
+ using this
+
+ The default value is null which assumes that the runtime is already initialized.
+
+
+
+
+
+ Gets or sets the test runner options.
+
+ Thrown if
+
+
+
+ Gets a read-only list of test file patterns (with wildcards) or test project files
+ that are to be resolved and included in the test package prior to execution.
+
+
+
+
+ Gets or sets the test project.
+
+ Thrown if
+
+
+
+ Gets or sets the test exploration options.
+
+ Thrown if
+
+
+
+ Gets or sets the test execution options.
+
+ Thrown if
+
+
+
+ Controls whether the test runner will echo result to the
+
+
+ The default value is false .
+
+
+
+
+
+ Gets or sets whether to skip test execution.
+
+
+
+ This option may be used to produce a report that contains test
+ metadata for consumption by other tools.
+
+
+ The default value is false .
+
+
+
+
+
+ Gets a read-only list of report formats to generate.
+
+
+
+
+ Gets or sets the report formatter options.
+
+ Thrown if
+
+
+
+ Gets or sets whether to show the reports after the test run finishes.
+
+
+
+ The default value is false .
+
+
+
+
+
+ Gets or sets whether to ignore annotations when determining the result code.
+
+
+
+ If false, then error annotations, usually indicative of broken tests, will cause
+ a failure result to be generated.
+
+
+ The default value is false .
+
+
+
+
+
+ Gets or sets the maximum amount of time the tests can run before they are canceled.
+
+
+
+ The default value is null , meaning an infinite time.
+
+
+
+
+
+ Resolves assemblies using hint paths and custom resolvers.
+
+
+
+
+ Provides support for resolving and loading assemblies using hint paths and custom resolvers.
+
+
+
+
+ Adds an assembly load hint directory to search when standard assembly
+ resolution fails.
+
+ Thrown if
+
+
+
+ Adds a custom assembly resolver to use when standard assembly resolution fails.
+
+ Thrown if
+
+
+
+ Loads an assembly from the specified file.
+
+ The loaded assembly.
+ Thrown if the
+ Thrown if the assembly could not be loaded.
+
+
+
+ Initializes the assembly resolver manager.
+
+
+
+
+
+
+
+
+
+
+
+
+ Provides configuration parameters for setting up the
+
+
+
+ Creates a default runtime setup.
+
+
+
+
+ Creates a deep copy of the runtime setup parameters.
+
+ The copy.
+
+
+
+ Makes all paths in this instance absolute.
+
+
+
+
+ Sets the configuration file path to the *.config file associated with an assembly.
+
+ Thrown if
+
+
+
+ Clears the list of plugin directories.
+
+
+
+
+ Adds a plugin directory if not already in the configuration.
+
+ Thrown if
+
+
+
+ Removes a plugin directory.
+
+ Thrown if
+
+
+
+ Gets a read-only list of relative or absolute paths of directories to be
+ searched for plugin configuration files in addition to the
+ primary Gallio directories.
+
+
+
+
+ Gets or sets the runtime path, or null to determine it automatically
+ based on the location of the application itself.
+
+
+
+ The runtime path specifies where the standard runtime plugins are located.
+
+
+
+ The runtime path. Default is null .
+
+
+
+
+ Gets or sets the installation configuration which specifies characteristics
+ about the Gallio installation on the local machine, or null to determine it automatically.
+
+
+ The installation configuration. Default is null .
+
+
+
+
+ Gets or sets the path of the primary configuration file to be
+ loaded by the runtime (if it exists).
+
+
+
+ This is useful when Gallio is launched by a library instead of as a standalone
+ executable.
+
+
+
+ The primary configuration file path. Default is null to load the
+ configuration from the
+
+
+
+ Provides helper functions for test runner tools.
+
+
+
+
+ Presents a generated report to the user using the default viewing
+ application for the report's document type.
+
+ True if the report document was successfully opened.
+
+
+
+ Creates a test runner given its factory name.
+
+ The test runner.
+ Thrown if
+
+
+
+ Provides helper functions for manipulating
+
+
+
+ Safely converts an exception to a string.
+
+
+
+ This method protects the caller from unexpected failures that may occur while
+ reporting an exception of untrusted origin. If an error occurs while converting the
+ exception to a string, this method returns a generic description of the exception
+ that can be used instead of the real thing.
+
+
+ It can happen that converting an exception to a string produces a secondary exception
+ because the
+
+ The string contents.
+ Thrown if
+
+
+
+ Safely obtains the
+ The message.
+ Thrown if
+
+
+
+ Safely obtains the
+ The stack trace.
+ Thrown if
+
+
+
+ Rethrows an exception without discarding its stack trace.
+ This enables the inner exception of
+
+
+ This implementation is based on code by Brad Wilson .
+
+
+
+
+
+ Invokes a method without producing a
+ The method return value, or null if none.
+ Thrown if
+
+
+
+ Invokes a constructor without producing a
+ The new instance, or null if none.
+ Thrown if
+
+
+
+ Creates an object using
+ The new instance, or null if none.
+ Thrown if
+
+
+
+ Utilities for manipulating files.
+
+
+
+
+ Replaces invalid characters in a file or directory name with underscores
+ and trims it if it is too long.
+
+ The encoded file or directory name.
+ Thrown if
+
+
+
+ Gets the full path of the containing directory.
+
+ The full path of the parent directory or null if it is at the root.
+ Thrown if
+
+
+
+ Recursively copies files and folders from the source path to the destination.
+
+ Thrown if
+
+
+
+ Recursively copies files and folders from the source path to the destination
+ using an indirect mechanism to actually create a file or folder.
+
+ Thrown if
+
+
+
+ Recursively deletes a file or directory.
+ Does nothing if the file or directory does not exist.
+
+
+
+
+ Makes all paths in the list absolute.
+
+
+
+
+ Makes an absolute path.
+
+ The absolute path, or null if none.
+
+
+
+ Strips the trailing backslash off of a directory path, if present.
+
+ The stripped path, or null if none.
+
+
+
+
+ Copies the contents of a source stream to a destination stream.
+
+
+
+ Does not close either stream.
+
+ Thrown if
+
+
+
+ Makes a relative path from an absolute path if possible.
+
+ The path relative to the base path, or an absolute path if the paths are unrelated.
+
+
+
+ Makes an absolute path from an relative path if possible.
+
+ The absolute path.
+
+
+
+ A 64 bit hash code value type.
+
+
+
+ Provides somewhat more protection against collisions than 32 bit hashes.
+
+
+
+
+
+ Gets a hash code containing the specified 64bit value.
+
+
+
+
+ Creates a proabilistically unique 64bit hash code.
+
+
+
+
+ Produces a new hash code by combining information from the specified string
+ with this hash code.
+
+ The augmented hash code.
+
+
+
+
+
+
+
+
+
+
+
+ The test context provides information about the environment in which
+ a test is executing. A new context is created each time a test or
+ test step begins execution.
+
+
+
+ Test contexts are arranged in a hierarchy that corresponds to the order in which
+ the contexts were entered. Thus the context for a test likely has as
+ its parent the context for its containing test fixture.
+
+
+ Arbitrary user data can be associated with a test context. Furthermore, client
+ code may attach
+
+
+
+
+ Creates a wrapper for a
+ Thrown if
+
+
+
+ Sets the default context for the specified thread.
+
+
+
+ The default context for a thread is
+
+ Changing the default context of a thread is useful for capturing existing threads created
+ outside of a test into a particular context. Among other things, this ensures that side-effects
+ of the thread, such as writing text to the console, are recorded as part of the step
+ represented by the specified context.
+
+
+ Thrown if
+
+
+
+ Gets the default context for the specified thread.
+
+
+
+ The default context for a thread is
+
+ Changing the default context of a thread is useful for capturing existing threads created
+ outside of a test into a particular context. Among other things, this ensures that side-effects
+ of the thread, such as writing text to the console, are recorded as part of the step
+ represented by the specified context.
+
+
+ The default context.
+ Thrown if
+
+
+
+ Enters the specified context with the current thread.
+
+
+
+ Conceptually this method pushes the specified context onto the context
+ stack for the current thread. It then returns a cookie that can be used
+ to restore the current thread's context to its previous value.
+
+
+ A cookie that can be used to restore the current thread's context to its previous value.
+
+
+
+ Automatically executes an action when a triggering event occurs.
+
+ Thrown if
+
+
+
+ Automatically executes an action when a triggering event occurs.
+
+ Thrown if
+
+
+
+ Returns true if a trigger event has been satisfied.
+
+
+
+ This method assumes that the body of the test has already finished and is
+ currently running tear down, dispose, or finishing actions.
+
+
+ True if the trigger event is satisfied.
+
+
+
+ Performs an action as a new step within the current context and associates it
+ with the specified code reference. Does not verify the outcome of the step.
+
+
+
+ This method creates a new child context with a new nested
+
+ This method may be called recursively to create nested steps or concurrently
+ to create parallel steps.
+
+
+ This method does not verify that the test step completed successfully. Check the
+
+
+ Thrown if
+ The context of the step that ran.
+ Thrown if
+ Thrown if
+
+
+
+ Performs an action as a new step within the current context and associates it
+ with the specified code reference. Verifies that the step produced the expected outcome.
+
+
+
+ This method creates a new child context with a new nested
+
+ This method may be called recursively to create nested steps or concurrently
+ to create parallel steps.
+
+
+ This method verifies that the step produced the expected outcome. If a different outcome
+ was obtained, then raises an assertion failure.
+
+
+ Thrown if
+ The context of the step that ran.
+ Thrown if
+ Thrown if
+ Thrown if the expected outcome was not obtained.
+
+
+
+ Adds metadata to the step that is running in the context.
+
+ Thrown if
+
+
+
+ Sets the step's interim
+
+
+ The interim outcome is used to communicate the anticipated outcome
+ of the step to later phases of execution.
+
+
+ The value set here will be overridden by whatever final outcome the step
+ returns. Consequently the actual outcome may still differ from the anticipated outcome
+ that was set using this method.
+
+
+ Thrown if attempting to set the outcome while the test is not running.
+
+
+
+ Enters this context with the current thread.
+
+
+
+ Conceptually this method pushes this context onto the context
+ stack for the current thread. It then returns a cookie that can be used
+ to restore the current thread's context to its previous value.
+
+
+ A cookie that can be used to restore the current thread's context to its previous value.
+
+
+
+ Increments the assert count atomically.
+
+
+
+
+ Adds the specified amount to the assert count atomically.
+
+
+
+
+ Publishes a message to the message sink.
+
+ Thrown if
+
+
+
+ Starts a child step of the context.
+
+ The context of the child step.
+ Thrown if
+
+
+
+ Finishes the step represented by the context.
+
+ The final test result.
+
+
+
+ Prepares a
+
+
+ The wrapper is cached for the duration of the lifetime of the inner context.
+
+
+ The wrapper context.
+ Thrown if
+
+
+
+ Wraps an existing context.
+
+
+
+ If the context has already been prepared, returns
+ the prepared context. Otherwise creates a new wrapper.
+
+
+ The wrapped context, or null if none.
+
+
+
+ Gets the context of the current thread, or null if there is no
+ current context.
+
+
+
+
+ Gets the global context of the environment, or null if there is no
+ such context.
+
+
+
+
+ Gets the parent context or null if this context has no parent.
+
+
+
+
+ Gets the test associated with the context.
+
+
+
+
+ Gets the test step associated with the context.
+
+
+
+
+ Gets the log writer for this context.
+
+
+
+ Each test step gets its own log writer that is distinct from those
+ of other steps. So the log writer returned by this property is
+ particular to the step represented by this test context.
+
+
+
+
+
+ Gets the sandbox of the test step, or null if none.
+
+
+
+ The value will typically only be null in the case where the test step
+ belongs to a different test framework that does not use sandboxes.
+
+
+
+
+
+ Gets or sets the lifecycle phase the context is in.
+
+ Thrown if
+
+
+
+ Gets the current assertion count.
+
+
+
+
+ Gets the step's outcome or its interim outcome if the test is still running.
+
+
+
+ The value of this property is initially
+
+ For example, this property enables code running as part of the tear down phase to
+ determine whether the test is failing and to perform different actions in that case.
+
+
+
+
+
+ Gets a copy of the step's final result or null if the test has not finished yet.
+
+
+
+ The test result cannot be changed.
+
+
+
+
+
+ Returns true if the step associated with the context has finished execution
+ and completed all
+
+
+
+ Gets the user data collection associated with the context. It may be used
+ to associate arbitrary key/value pairs with the context.
+
+
+
+ Each context has its own distinct user data collection.
+
+
+
+
+
+ The
+
+
+
+ A context cookie is used to unwind the context stack of the current thread
+ to its previous state prior to a context having been entered.
+
+
+
+
+ Creates a context cookie with a given dispose action.
+
+
+
+
+ Exits the context that was entered when the cookie was granted.
+
+
+
+ Equivalent to calling
+
+ This method will also exit nested contexts on the current thread that were
+ entered after the context for which this cookie was produced but have not
+ yet been exited.
+
+
+ Thrown if the cookie belongs to a different
+
+ Thrown if the context manager has been disposed.
+
+
+
+ Exits the context that was entered when the cookie was granted.
+
+
+
+ This method will also exit nested contexts on the current thread that were
+ entered after the context for which this cookie was produced but have not
+ yet been exited.
+
+
+ Thrown if the cookie belongs to a different
+
+ Thrown if the context manager has been disposed.
+
+
+
+ A custom assembly resolver participates in assembly resolution when
+ standard assembly resolution fails to load the desired assembly
+ but before assembly load paths are considered.
+
+
+
+
+ Resolves the assembly with the specified name.
+
+ The assembly, or null if it could not be resolved.
+
+
+
+ An action chain captures a sequence of actions to be performed as
+ part of a complex multi-part process.
+
+
+ Later actions in a chain will not run if prior ones throw an exception.
+ To catch and handle exceptions, use
+
+
+
+ Gets a singleton action that does nothing when invoked.
+
+
+
+
+ Registers an action to perform before all other actions
+ currently in the chain.
+
+
+
+ The value of
+
+ Thrown if
+
+
+
+ Registers an action to perform after all other actions
+ currently in the chain.
+
+
+
+ The value of
+
+ Thrown if
+
+
+
+ Registers an action to perform around all other actions
+ currently in the chain. The contained part of the chain
+ is passed in as an action to the decorator that the decorator
+ can choose to run (or not) as needed.
+
+
+
+ The value of
+
+ Thrown if
+
+
+
+ Clears the chain and sets it action to
+
+
+
+ Gets or sets a representation of the chain as a single action.
+
+
+
+ The action is progressively augmented as new contributions are
+ registered using
+
+ Thrown if
+
+
+
+ An action chain captures a sequence of actions to be performed as
+ part of a complex multi-part process.
+
+
+ Later actions in a chain will not run if prior ones throw an exception.
+ To catch and handle exceptions, use
+ The action argument type.
+
+
+
+ Gets a singleton action that does nothing when invoked.
+
+
+
+
+ Registers an action to perform before all other actions
+ currently in the chain.
+
+
+
+ The value of
+
+ Thrown if
+
+
+
+ Registers an action to perform after all other actions
+ currently in the chain.
+
+
+
+ The value of
+
+ Thrown if
+
+
+
+ Registers an action to perform around all other actions
+ currently in the chain. The contained part of the chain
+ is passed in as an action to the decorator that the decorator
+ can choose to run (or not) as needed.
+
+
+
+ The value of
+
+ Thrown if
+
+
+
+ Clears the chain and sets it action to
+
+
+
+ Gets or sets a representation of the chain as a single action.
+
+
+
+ The action is progressively augmented as new contributions are
+ registered using
+
+ Thrown if
+
+
+
+ An action chain captures a sequence of actions to be performed as
+ part of a complex multi-part process.
+
+
+
+ Later actions in a chain will not run if prior ones throw an exception.
+ To catch and handle exceptions, use
+
+ The first argument type.
+ The second argument type.
+
+
+
+ Gets a singleton action that does nothing when invoked.
+
+
+
+
+ Registers an action to perform before all other actions
+ currently in the chain.
+
+
+
+ The value of
+
+ Thrown if
+
+
+
+ Registers an action to perform after all other actions
+ currently in the chain.
+
+
+
+ The value of
+
+ Thrown if
+
+
+
+ Registers an action to perform around all other actions
+ currently in the chain. The contained part of the chain
+ is passed in as an action to the decorator that the decorator
+ can choose to run (or not) as needed.
+
+
+
+ The value of
+
+ Thrown if
+
+
+
+ Clears the chain and sets it action to
+
+
+
+ Gets or sets a representation of the chain as a single action.
+
+
+
+ The action is progressively augmented as new contributions are
+ registered using
+
+ Thrown if
+
+
+
+ Represents a delegate that decorates an action.
+
+
+
+
+ Represents a delegate that decorates an action.
+
+ The type of object the action is performed upon.
+
+
+
+ Represents a delegate that decorates an action.
+
+ The first argument type.
+ The second argument type.
+
+
+
+ A filter combinator that matches a value when all of its constituent filters
+ match the value.
+
+
+
+
+ Creates an AND-filter.
+
+ Thrown if
+
+
+
+
+
+
+
+
+
+ Gets the filters that must jointly be matched.
+
+
+
+ If the list is empty, the filter matches everything.
+
+
+
+
+
+ A filter that matches anything and always returns true.
+
+
+
+
+
+
+
+
+
+
+ A filter that matches objects whose
+
+
+
+ Creates an assembly filter.
+
+
+ - Full name as returned by
+ - Simple name (aka. partial name) as returned by
+
+
+ Thrown if
+
+
+
+
+
+
+
+
+
+ A filter that matches objects whose
+
+
+
+ Creates an identity filter.
+
+ Thrown if
+
+
+
+
+
+
+
+
+
+ A filter that matches objects whose
+
+
+
+ Creates a member filter.
+
+ Thrown if
+
+
+
+
+
+
+
+
+
+ A filter that matches objects whose
+
+
+
+ Creates a metadata filter.
+
+ Thrown if
+
+
+
+
+
+
+
+
+
+ A filter that matches objects whose
+
+
+
+ Creates a namespace filter.
+
+ Thrown if
+
+
+
+
+
+
+
+
+
+ A filter that matches nothing and always returns false.
+
+
+
+
+
+
+
+
+
+
+ A filter combinator that is the negation of another filter.
+
+
+
+
+ Creates a NOT-filter.
+
+ Thrown if
+
+
+
+
+
+
+
+
+
+ Gets the filter to be negated.
+
+
+
+
+ A filter combinator that matches a value when at least one of its constituent filters
+ matches the value.
+
+
+
+
+ Creates an OR-filter.
+
+ Thrown if
+
+
+
+
+
+
+
+
+
+ Gets the filters from which at least one match must be found.
+
+
+
+ If the list is empty, the filter matches everything.
+
+
+
+
+
+ A filter that matches objects whose
+
+
+ Generic types should be specified by the name of their generic type definition.
+ eg. Foo`1.
+
+
+
+
+
+ Creates a type filter.
+
+
+ - Fully qualified by namespace and assembly as returned by
+ - Qualified by namespace as returned by
+ - Unqualified as returned by the type's
+
+
+ Thrown if
+
+
+
+
+
+
+
+
+
+ A list of standard test kind names provided by Gallio.
+
+
+
+ The test kind has no effect on the semantics of the test runner but it allows tests to
+ be classified so that a user interface can provide appropriate icons, descriptions,
+ decorations and affordances for registered test kinds.
+
+
+ To create your own custom test kinds for your test framework, register a
+
+
+
+
+
+ The test represents the root of the test tree.
+
+
+
+
+ The test represents the tests contained in a single test file.
+
+
+
+ A file should have an associated
+
+
+
+
+ The test represents the tests contained in a single test assembly.
+
+
+
+ An assembly should have an associated
+
+
+
+
+ The test represents the tests contained in a single test namespace.
+
+
+
+
+ The test represents a grouping of tests for descriptive purposes.
+
+
+
+
+ The test represents a test suite.
+
+
+
+
+ The test represents a test fixture.
+
+
+
+
+ The test represents a test case.
+
+
+
+
+ The test is a placeholder for an unsupported test file or element.
+
+
+
+
+ Defines the names of common test step lifecycle phases.
+
+
+
+ Custom phases may also be defined.
+
+
+
+
+
+ The test step is starting.
+
+
+
+
+ The test is being initialize. (Fixture construction, etc.)
+
+
+
+
+ The test step is being set up.
+
+
+
+
+ The test step is executing its main body.
+
+
+
+
+ The test step is being torn down.
+
+
+
+
+ The test step's context is being disposed.
+
+
+
+
+ The test step is finishing.
+
+
+
+
+ Provides common metadata keys.
+
+
+
+
+ The metadata key for the author's email.
+
+
+
+ May be derived from AuthorAttribute in MbUnit or its equivalent.
+
+
+
+
+
+ The metadata key for the author's name.
+
+
+
+ May be derived from AuthorAttribute in MbUnit or its equivalent.
+
+
+
+
+
+ The metadata key for the author's homepage.
+
+
+
+ May be derived from AuthorAttribute in MbUnit or its equivalent.
+
+
+
+
+
+ The metadata key for the name of a category to which a test belongs.
+
+
+
+ May be derived from CategoryAttribute in MbUnit or its equivalent.
+
+
+
+
+
+ The matadata key for the location of an assembly as a local
+ file path or as a Uri.
+
+
+
+ May be derived from the assembly's
+
+
+
+
+ The metadata key for the name of the company associated with a test.
+
+
+
+ May be derived from
+
+
+
+
+ The metadata key for build/release configuration information associated with a test.
+
+
+
+ It describes the target environment or usage for the test.
+
+
+ May be derived from
+
+
+
+
+ The metadata key for a copyright associated with a test.
+
+
+
+ May be derived from
+
+
+
+
+ The metadata key for specifying the origin of data used by a test.
+
+
+
+ May be the file name and line number of a record in a file, the ID
+ of a database record or some other identifying characteristic.
+
+
+
+
+
+ The metadata key for the description of a test component.
+
+
+
+ May be derived from DescriptionAttribute in MbUnit or its equivalent.
+
+
+
+
+
+ The metadata key for the expected exception type which should be the name,
+ full name or assembly-qualified name of the expected exception type.
+
+
+
+ May be derived from ExpectedExceptionAttribute in MbUnit
+ or its equivalent.
+
+
+
+
+
+ The metadata key for the expected exception message.
+ May be a substring of the actual exception message.
+
+
+
+ May be derived from ExpectedExceptionAttribute in MbUnit
+ or its equivalent.
+
+
+
+
+
+ The metadata key that describes the reason that a test should be run explicitly.
+
+
+
+ Tests may of course be marked explicit without a declared reason.
+
+
+ May be derived from ExplicitAttribute in MbUnit or its equivalent.
+
+
+
+
+
+ The metadata key for a file associated with a test.
+
+
+
+ The file key should be associated with the top test produced by a file that
+ the test framework was asked to explore. For example, if the test package
+ included "C:\Tests\MyTests.dll" then the assembly-level test emitted by the framework
+ should have a File metadata entry with the value "C:\Tests\MyTests.dll".
+
+
+
+
+
+ The metadata key for a file version number associated with a test.
+
+
+
+ May be derived from
+
+
+
+
+ The metadata key for the test framework name associated with a test assembly in the test tree.
+
+
+
+ The value should be the descriptive name of the framework including its version. eg. "MbUnit v3.1 build 200"
+
+
+ A single assembly may have multiple associated frameworks.
+
+
+
+
+
+ The metadata key that describes the reason that a test is being ignored.
+
+
+
+ Tests may of course be ignored without a declared reason.
+
+
+ May be derived from IgnoreAttribute in MbUnit or its equivalent.
+
+
+
+
+
+ The metadata key for the importance of a test component as the
+ string representation of one of the TestImportance constants in MbUnit
+ or its equivalent.
+
+
+
+ May be derived from ImportantAttribute in MbUnit or its equivalent.
+
+
+
+
+
+ The metadata key for an informational version number associated with a test.
+
+
+
+ May be derived from
+
+
+
+
+ The metadata key that describes the reason that a test is pending.
+
+
+
+ Tests may of course be marked pending without a declared reason.
+
+
+ May be derived from PendingAttribute in MbUnit or its equivalent.
+
+
+
+
+
+ The metadata key for a product associated with a test.
+
+
+
+ May be derived from
+
+
+
+
+ The metadata key for the name of the type being tested.
+
+
+
+ The associated value should be the full name of the type from
+
+ May be derived from TestsOnAttribute in MbUnit or its equivalent.
+
+
+
+
+
+ The metadata key used to describe the kind of a test as the
+ string representation of one of the
+
+
+
+ The metadata key for a title associated with a test.
+
+
+
+ May be derived from
+
+
+
+
+ The metadata key for a trademark associated with a test.
+
+
+
+ May be derived from
+
+
+
+
+ The metadata key for a version number associated with a test.
+
+
+
+ May be derived from
+
+
+
+
+ The metadata key for the XML documentation of the test derived from
+ XML code documentation comments.
+
+
+
+
+ The type of exception thrown when test model and test framework
+ operations fail.
+
+
+
+
+ Creates an exception.
+
+
+
+
+ Creates an exception.
+
+
+
+
+ Creates an exception.
+
+
+
+
+ Creates an exception from serialization info.
+
+
+
+
+ Provides utility functions for manipulating the object model.
+
+
+
+
+ Populates the provided metadata map with asembly-level metadata derived
+ from custom attributes.
+
+
+
+ Currently recognized attributes:
+
+
+
+
+
+
+
+ The root test in the test tree.
+
+
+
+
+ Gets the root test name.
+
+
+
+
+ Creates the root test.
+
+
+
+
+ Provides options that control how test exploration occurs.
+
+
+
+
+ Creates a default set of test execution options.
+
+
+
+
+ Clears the collection of properties.
+
+
+
+
+ Adds a property key/value pair.
+
+ Thrown if
+ Thrown if
+
+
+
+ Removes a property key/value pair.
+
+ Thrown if
+
+
+
+ Creates a copy of the options.
+
+ The copy.
+
+
+
+ Gets a read-only collection of configuration properties for test exploration.
+
+
+
+
+ Describes the outcome of a test.
+
+
+
+ An outcome consists of two parts. First, a required
+
+
+
+
+ Creates a test outcome with no category.
+
+
+
+
+ Creates a test outcome with an optional category.
+
+
+
+
+ If the other outcome is more severe than this one, returns it.
+ Otherwise returns this outcome.
+
+
+
+ This combination rule has the nice property of preserving the first
+ failure encountered even if subsequent failures occur and are combined.
+
+
+ The combined outcome.
+
+
+
+ Produces an outcome with the same status but omitting the category information.
+
+ The generalized outcome.
+
+
+
+
+
+ Returns the
+ The display name.
+
+
+
+ Provides the Xml schema for this element.
+
+ The schema type of the element.
+
+
+
+ Compares two outcomes for equality.
+
+ True if the outcomes are equal.
+
+
+
+ Compares two outcomes for inequality.
+
+ True if the outcomes are not equal.
+
+
+
+
+
+
+
+
+
+ Gets the test status.
+
+
+
+ The test status describes whether a test passed, failed or produced an inconclusive
+ result. This information may be reported to the user with icons and textual
+ labels to explain the overall significance of the outcome.
+
+
+
+
+
+ Gets the test outcome category, or null if none. Never an empty string.
+
+
+
+ The category, when provided, provides additional information to describe what happened
+ to result in this particular outcome.
+
+
+ Examples: "ignored", "skipped", "pending", "canceled", "aborted", "timeout".
+
+
+ Naming guidelines:
+
+ - A category should be a single lower-case word.
+ - It should be a word that can appear on its own or following a number. Consequently, nouns are poor choices because they may need to be pluralized.
+ - It should not repeat the information already provided by the
+ - It should be a standard category, if possible.
+ - It should not be too granular. If too many categories are in common usage, test result summaries by category may become unwieldly.
+
+
+
+
+
+
+ Gets the name of the outcome as it should be displayed.
+
+
+
+ The display name is the outcome's
+
+
+
+
+ Gets a standard outcome for a test that passed.
+
+
+
+ Status:
+
+ The outcome.
+
+
+
+ Gets a standard outcome for a test that failed.
+
+
+
+ Status:
+
+ The outcome.
+
+
+
+ Gets a standard outcome for a test that failed due to an error.
+
+
+
+ Status:
+
+ The outcome.
+
+
+
+ Gets a standard outcome for a test that failed because it ran out of time.
+
+
+
+ Status:
+
+ The outcome.
+
+
+
+ Gets a standard outcome for a test that was inconclusive.
+
+
+
+ Status:
+
+ The outcome.
+
+
+
+ Gets a standard outcome for a test that has an inconclusive outcome because it was canceled.
+
+
+
+ Status:
+
+ The outcome.
+
+
+
+ Gets a standard outcome for a test that did not run.
+
+
+
+ Status:
+
+ The outcome.
+
+
+
+ Gets a standard outcome for a test that did not run because the user is choosing
+ to ignore it. Perhaps the test is broken or non-functional.
+
+
+
+ Status:
+
+ The outcome.
+
+
+
+ Gets a standard outcome for a test that did not run because it has unsatisfied
+ prerequisites. The test may depend on functionality that has not yet been implemented
+ or perhaps the test itself has yet to be implemented.
+
+
+
+ Status:
+
+ The outcome.
+
+
+
+ Gets a standard outcome for a test that did not run because it must be selected explicitly.
+ The test may be particularly expensive or require manual supervision by an operator.
+
+
+
+ Status:
+
+ The outcome.
+
+
+
+ Describes whether a test passed, failed, was skipped or was inconclusive.
+
+
+
+ The status codes are ranked in order of severity from least to greatest
+ as follows:
+
+
+
+
+ The test passed.
+
+
+
+
+ The test did not run so nothing is known about its status.
+
+
+
+
+ The test did not run or its result was inconclusive.
+
+
+
+
+ The test failed or encountered an error during execution.
+
+
+
+
+ Provides helpers for cross-thread synchronization.
+
+
+
+
+ Synchronizes an action.
+
+ The exception thrown by the action.
+
+
+
+ Synchronizes a function that returns a value.
+
+ The value returned by the function.
+ The function return type.
+ The exception thrown by the function.
+
+
+
+ Default IXmlSerializer implementation.
+
+
+
+
+
+
+
+
+ Provides utilities for manipulating Xml.
+
+
+
+
+ Produces an XPathDocument given an action applied to an XmlWriter.
+
+ The XPathDocument.
+ Thrown if
+
+
+
+ Describes an exception that is to be reported.
+
+
+
+
+ Creates event arguments for reporting an exception.
+
+ Thrown if
+
+
+
+ Adds a message that serves to describe the context in which the exception occurred.
+ The
+ Thrown if
+
+
+
+ Formats a description of the exception to a string like: "Message\nException\nReported by: ReporterStackTrace".
+
+ The formatted string.
+
+
+
+ Formats the defaults of the exception to a string like: "Exception\nReported by: ReporterStackTrace".
+
+ The formatted string.
+
+
+
+ Gets the message associated with the exception.
+
+
+
+
+ Gets the exception that occurred.
+
+
+
+ The event handler should use care when processing the exception object as it
+ may have been obtained from an untrusted source.
+
+
+
+
+
+ Gets the stack trace of the code that called to report the exception or null if not available.
+
+
+
+
+ Returns true if a second exception occurred while attempting to report a previous
+ exception on the same thread.
+
+
+
+
+ Provides utility functions for working with strings.
+
+
+
+
+ Truncates the string to the specified maximum length.
+ Discards characters at the end of the string with indices greater than
+ or equal to
+ The truncated string.
+ Thrown if
+ Thrown if
+
+
+
+ If the string is longer than the specified maximum length, truncates
+ it and appends an ellipsis mark ("..."). If the maximum length is
+ less than or equal to 3, omits the ellipsis mark on truncation.
+
+ The truncated string.
+ Thrown if
+ Thrown if
+
+
+
+ Gets a lowercase hexadecimal digit corresponding to the least significant nybble of
+ the specified value.
+
+ The hexadecimal digit.
+
+
+
+ Formats a character value as "'x'" or "'\n'" with support for escaped characters
+ as a valid literal value. Encloses the char in single quotes (').
+
+
+
+ Replaces common escaped characters with C# style escape codes. Unprintable characters
+ are represented by a Unicode character escape.
+
+
+ The formatted character.
+
+
+
+ Escapes a character value as "x" or "\n". Unlike
+
+
+ Replaces common escaped characters with C# style escape codes. Unprintable characters
+ are represented by a Unicode character escape.
+
+
+ The unquoted char literal.
+
+
+
+ Formats a string value as ""abc\ndef"" with support for escaped characters
+ as a valid literal value. Encloses the string in quotes (").
+
+
+
+ Replaces common escaped characters with C# style escape codes. Unprintable characters
+ are represented by a Unicode character escape.
+
+
+ The formatted string.
+
+
+
+ Escapes a string value such as "abc\ndef". Unlike
+
+
+ Replaces common escaped characters with C# style escape codes. Unprintable characters
+ are represented by a Unicode character escape.
+
+
+ The unquoted string literal.
+
+
+
+ Parses a key/value pair from an input string of the form "key=value", with the
+ value optionally quoted and optional surrounding whitespace removed.
+
+
+
+ If the value is quoted, the outermost quotes will be removed.
+ If the equals or value is absent then an empty string will be used as the value.
+ Also trims whitespace around the key and value.
+
+
+ The key value pair.
+ Thrown if
+
+
+
+ Parses a string of whitespace delimited and possibly quoted arguments and
+ returns an array of each one unquoted.
+
+ The parsed and unquoted arguments.
+ Thrown if
+
+
+
+ The test log class provides services for writing information to the
+ execution log associated with a test.
+
+
+
+ A test log records the output of a test during its execution including any text
+ that was written to console output streams, exceptions that occurred, and
+ anything else the test writer might want to save.
+
+
+ A log consists of zero or more log streams that are opened automatically
+ on demand to capture independent sequences of log output. Each stream can
+ further be broken down into possibly nested sections to classify output
+ during different phases of test execution (useful for drilling into complex tests).
+ In addition to text, a log can contain attachments that are either attached
+ at the top level of the log or embedded into log streams. Attachments are
+ typed by mime-type and can contain Text, Xml, Images, Blobs, or any other content.
+ Certain test frameworks may automatically create attachments to gather all manner
+ of diagnostic information over the course of the test.
+
+
+ Test log messages are not echoed to the console or runtime log during test execution,
+ they are incorporated into the test report. Use
+
+
+
+
+ Flushes the log writer.
+
+
+
+ This is a convenience method that forwards the request to the current log
+ writer as returned by the
+
+
+
+
+ Attaches an attachment to the execution log.
+
+
+
+ This is a convenience method that forwards the request to the current log
+ writer as returned by the
+
+ The attachment.
+ Thrown if
+ Thrown if there is already an attachment
+ with the same name.
+
+
+
+ Attaches an plain text attachment with mime-type
+
+
+ This is a convenience method that forwards the request to the current log
+ writer as returned by the
+
+ The attachment.
+ Thrown if
+ Thrown if there is already an attachment
+ with the same name.
+
+
+
+ Attaches an HTML attachment with mime-type
+
+
+ This is a convenience method that forwards the request to the current log
+ writer as returned by the
+
+ The attachment.
+ Thrown if
+ Thrown if there is already an attachment
+ with the same name.
+
+
+
+ Attaches an XHTML attachment with mime-type
+
+
+ This is a convenience method that forwards the request to the current log
+ writer as returned by the
+
+ The attachment.
+ Thrown if
+ Thrown if there is already an attachment
+ with the same name.
+
+
+
+ Attaches an XML attachment with mime-type
+
+
+ This is a convenience method that forwards the request to the current log
+ writer as returned by the
+
+ The attachment.
+ Thrown if
+ Thrown if there is already an attachment
+ with the same name.
+
+
+
+ Attaches an image attachment with a mime-type compatible with its internal representation.
+
+
+
+ This is a convenience method that forwards the request to the current log
+ writer as returned by the
+
+ The attachment.
+ Thrown if
+ Thrown if there is already an attachment
+ with the same name.
+
+
+
+ Attaches a video attachment with a mime-type compatible with its internal representation.
+
+
+
+ This is a convenience method that forwards the request to the current log
+ writer as returned by the
+
+ The attachment.
+ Thrown if
+ Thrown if there is already an attachment
+ with the same name.
+
+
+
+ Attaches an XML-serialized object as an XML attachment with mime-type
+
+
+ This is a convenience method that forwards the request to the current log
+ writer as returned by the
+
+ The attachment.
+ Thrown if
+ Thrown if there is already an attachment
+ with the same name.
+
+
+
+ Attaches an XML-serialized object as an XML attachment with mime-type
+
+
+ This is a convenience method that forwards the request to the current log
+ writer as returned by the
+
+ The attachment.
+ Thrown if
+ Thrown if there is already an attachment
+ with the same name.
+
+
+
+ Writes a character.
+
+
+
+ This is a convenience method that forwards the request to the current default
+ log stream writer as returned by the
+
+
+
+
+ Writes a string.
+
+
+
+ This is a convenience method that forwards the request to the current default
+ log stream writer as returned by the
+
+
+
+
+ Writes a formatted object.
+
+
+
+ This is a convenience method that forwards the request to the current default
+ log stream writer as returned by the
+
+
+
+
+ Writes an array of characters.
+
+
+
+ This is a convenience method that forwards the request to the current default
+ log stream writer as returned by the
+
+
+
+
+ Writes an array of characters.
+
+
+
+ This is a convenience method that forwards the request to the current default
+ log stream writer as returned by the
+
+ Thrown if
+ Thrown if
+
+
+
+ Writes a formatted string.
+
+
+
+ This is a convenience method that forwards the request to the current default
+ log stream writer as returned by the
+
+ Thrown if
+
+
+
+ Writes a line delimiter.
+
+
+
+ This is a convenience method that forwards the request to the current default
+ log stream writer as returned by the
+
+
+
+
+ Writes a character followed by a line delimiter.
+
+
+
+ This is a convenience method that forwards the request to the current default
+ log stream writer as returned by the
+
+
+
+
+ Writes a string followed by a line delimiter.
+
+
+
+ This is a convenience method that forwards the request to the current default
+ log stream writer as returned by the
+
+
+
+
+ Writes a formatted object followed by a line delimiter.
+
+
+
+ This is a convenience method that forwards the request to the current default
+ log stream writer as returned by the
+
+
+
+
+ Writes an array of characters followed by a line delimiter.
+
+
+
+ This is a convenience method that forwards the request to the current default
+ log stream writer as returned by the
+
+
+
+
+ Writes a formatted string followed by a line delimiter.
+
+
+
+ This is a convenience method that forwards the request to the current default
+ log stream writer as returned by the
+
+ Thrown if
+
+
+
+ Writes a test log stream writable object to the stream.
+
+
+
+ This is a convenience method that forwards the request to the current default
+ log stream writer as returned by the
+
+
+
+
+ Writes an exception.
+
+
+
+ This is a convenience method that forwards the request to the current default
+ log stream writer as returned by the
+
+ The exception will not be terminated by a new line.
+
+
+ Thrown if
+
+
+
+ Writes an exception within its own section.
+
+
+
+ This is a convenience method that forwards the request to the current default
+ log stream writer as returned by the
+
+ The exception will not be terminated by a new line.
+
+
+ Thrown if
+
+
+
+ Writes an exception.
+
+
+
+ This is a convenience method that forwards the request to the current default
+ log stream writer as returned by the
+
+ The exception will not be terminated by a new line.
+
+
+ Thrown if
+
+
+
+ Writes an exception within its own section which provides additional cues for interpretation.
+
+
+
+ This is a convenience method that forwards the request to the current default
+ log stream writer as returned by the
+
+ The exception will not be terminated by a new line.
+
+
+ Thrown if
+
+
+
+ Writes highlighted text.
+
+
+
+ Highlights can be used to emphasize important information such differences
+ between similar expected and actual values.
+
+
+ This is a convenience method that forwards the request to the current default
+ log stream writer as returned by the
+
+ This is a convenience method that simply encapsulates the highlighted text within a
+ marker region of type
+
+
+
+
+ Writes an ellipsis to indicate where content has been elided for brevity.
+
+
+
+ An ellipsis may be used, for example, when printing assertion failures to clearly
+ identify sections where the user is not being presented all of the information
+ because it was too long and had to be truncated.
+
+
+ This is a convenience method that forwards the request to the current default
+ log stream writer as returned by the
+
+ This is a convenience method that simply encapsulates "..." within a
+ marked region of type
+
+
+
+
+ Begins a section with the specified name. May be nested.
+
+
+
+ A section groups together related content in the test log to make it
+ easier to distinguish. The section name is used as a heading.
+
+
+ This is a convenience method that forwards the request to the current default
+ log stream writer as returned by the
+
+
+
+ A Disposable object that calls
+ Thrown if
+
+
+
+ Begins a marked region. May be nested.
+
+
+
+ A marker is a hidden tag that labels its contents with a semantic class.
+ It is roughly equivalent in operation to an HTML "span" tag. Various tools
+ may inspect the markers and modify the presentation accordingly.
+
+
+ This is a convenience method that forwards the request to the current default
+ log stream writer as returned by the
+
+
+
+ A Disposable object that calls
+
+
+
+ Ends the region most recently started with one of the Begin* methods.
+
+
+
+ This is a convenience method that forwards the request to the current default
+ log stream writer as returned by the
+
+ Thrown if there is no current nested region.
+
+
+
+ Embeds an attachment.
+
+
+
+ This is a convenience method that forwards the request to the current default
+ log stream writer as returned by the
+
+
+ An attachment instance can be embedded multiple times efficiently since each
+ embedded copy is typically represented as a link to the same common attachment instance.
+
+ The attachment.
+ Thrown if
+ Thrown if there is already an attachment
+ with the same name.
+
+
+
+ Embeds another copy of an existing attachment.
+
+
+
+ This is a convenience method that forwards the request to the current default
+ log stream writer as returned by the
+
+
+
+ This method can be used to
+ repeatedly embed an existing attachment at multiple points in multiple
+ streams without needing to keep the
+
+ An attachment instance can be embedded multiple times efficiently since each
+ embedded copy is typically represented as a link to the same common attachment instance.
+
+
+ Thrown if
+ Thrown if no attachment with the specified
+ name has been previously attached.
+
+
+
+ Embeds an plain text attachment with mime-type
+
+
+ This is a convenience method that forwards the request to the current default
+ log stream writer as returned by the
+
+ The attachment.
+ Thrown if
+ Thrown if there is already an attachment
+ with the same name.
+
+
+
+ Embeds an HTML attachment with mime-type
+
+
+ This is a convenience method that forwards the request to the current default
+ log stream writer as returned by the
+
+ The attachment.
+ Thrown if
+ Thrown if there is already an attachment
+ with the same name.
+
+
+
+ Embeds an XHTML attachment with mime-type
+
+
+ This is a convenience method that forwards the request to the current default
+ log stream writer as returned by the
+
+ The attachment.
+ Thrown if
+ Thrown if there is already an attachment
+ with the same name.
+
+
+
+ Embeds an XML attachment with mime-type
+
+
+ This is a convenience method that forwards the request to the current default
+ log stream writer as returned by the
+
+ The attachment.
+ Thrown if
+ Thrown if there is already an attachment
+ with the same name.
+
+
+
+ Embeds an image attachment with a mime-type compatible with its internal representation.
+
+
+
+ This is a convenience method that forwards the request to the current default
+ log stream writer as returned by the
+
+ The attachment.
+ Thrown if
+ Thrown if there is already an attachment
+ with the same name.
+
+
+
+ Embeds a video attachment with a mime-type compatible with its internal representation.
+
+
+
+ This is a convenience method that forwards the request to the current default
+ log stream writer as returned by the
+
+ The attachment.
+ Thrown if
+ Thrown if there is already an attachment
+ with the same name.
+
+
+
+ Embeds an XML-serialized object as an XML attachment with mime-type
+
+
+ This is a convenience method that forwards the request to the current default
+ log stream writer as returned by the
+
+ The attachment.
+ Thrown if
+ Thrown if there is already an attachment
+ with the same name.
+
+
+
+ Embeds an XML-serialized object as an XML attachment with mime-type
+
+
+ This is a convenience method that forwards the request to the current default
+ log stream writer as returned by the
+
+ The attachment.
+ Thrown if
+ Thrown if there is already an attachment
+ with the same name.
+
+
+
+ Gets the current log writer.
+
+ The execution log, never null.
+ Thrown if there is no current log writer.
+
+
+
+ Gets the current stream writer for captured
+
+
+
+ Gets the current stream writer for captured
+
+
+
+ Gets the current stream writer for captured
+
+
+
+ Gets the current stream writer for diagnostic
+
+
+
+ Gets the current stream writer for reporting failure messages and exceptions.
+
+
+
+
+ Gets the current stream writer for reporting warning messages.
+
+
+
+
+ Gets the current stream writer for generic log messages such as those written
+ using the static methods of this class.
+
+
+
+
+ Provides functions for obtaining runtime services.
+
+
+
+
+ Sets the runtime instance.
+
+
+
+ This method should only be used by applications that host Gallio
+ and not generally by client code.
+
+
+
+
+
+ Gets the runtime instance.
+
+ Thrown if the runtime has not been initialized.
+
+
+
+ Gets the runtime's logger, or a
+
+
+
+ Gets the runtime's assembly loader.
+
+ Thrown if the runtime has not been initialized.
+
+
+
+ Gets the runtime's registry.
+
+ Thrown if the runtime has not been initialized.
+
+
+
+ Gets the runtime's service locator.
+
+ Thrown if the runtime has not been initialized.
+
+
+
+ Gets the runtime's resource locator.
+
+ Thrown if the runtime has not been initialized.
+
+
+
+ Returns true if the runtime has been initialized.
+
+
+
+
+ The event dispatched when the value of the current runtime
+
+
+
+
+ Gets the path of the Gallio runtime components.
+
+ The runtime path.
+
+
+
+ A strongly-typed resource class, for looking up localized strings, etc.
+
+
+
+
+ Returns the cached ResourceManager instance used by this class.
+
+
+
+
+ Overrides the current thread's CurrentUICulture property for all
+ resource lookups using this strongly typed resource class.
+
+
+
+
+ Looks up a localized string similar to The parameter list already contains a parameter named '{0}'..
+
+
+
+
+ Looks up a localized string similar to The test to be added is already a child of another test..
+
+
+
+
+ Looks up a localized string similar to Parameter '{0}' of .
+
+
+
+
+ Looks up a localized string similar to Collection arguments must have AllowMultiple flag..
+
+
+
+
+ Looks up a localized string similar to Duplicate '{0}' argument..
+
+
+
+
+ Looks up a localized string similar to Duplicate '{0}' argument value '{1}', expected unique values..
+
+
+
+
+ Looks up a localized string similar to Invalid '{0}' argument value '{1}'..
+
+
+
+
+ Looks up a localized string similar to Unique flag only applicable to collection arguments..
+
+
+
+
+ Looks up a localized string similar to Argument long name must be specified..
+
+
+
+
+ Looks up a localized string similar to Missing required argument '/{0}'..
+
+
+
+
+ Looks up a localized string similar to Missing required default argument..
+
+
+
+
+ Looks up a localized string similar to Unsupported value type..
+
+
+
+
+ Looks up a localized string similar to Parsed argument object is not of the correct type..
+
+
+
+
+ Looks up a localized string similar to Duplicate argument name '{0}'..
+
+
+
+
+ Looks up a localized string similar to Error opening response file '{0}': {1}..
+
+
+
+
+ Looks up a localized string similar to A fatal exception occurred while parsing arguments: {0}.
+
+
+
+
+ Looks up a localized string similar to Mismatched quotes in response file '{0}'.
+
+
+
+
+ Looks up a localized string similar to More than one default command line argument has been defined..
+
+
+
+
+ Looks up a localized string similar to No fields tagged with CommandLineArgumentAttribute..
+
+
+
+
+ Looks up a localized string similar to Read response file for more options..
+
+
+
+
+ Looks up a localized string similar to Response file '0' does not exist..
+
+
+
+
+ Looks up a localized string similar to file.
+
+
+
+
+ Looks up a localized string similar to Unrecognized argument '{0}'..
+
+
+
+
+ Looks up a localized string similar to The available options are: .
+
+
+
+
+ Looks up a localized string similar to (Short form: {0}).
+
+
+
+
+ Looks up a localized string similar to {0} - Version {1}.
+
+
+
+
+ Looks up a localized string similar to --- CANCELED ---.
+
+
+
+
+ Looks up a localized string similar to >>> CANCELING <<<.
+
+
+
+
+ Looks up a localized string similar to The runtime could not be initialized..
+
+
+
+
+ Looks up a localized string similar to Cannot escape character {0}.
+
+
+
+
+ Looks up a localized string similar to (char code = {0}).
+
+
+
+
+ Looks up a localized string similar to Colon expected.
+
+
+
+
+ Looks up a localized string similar to Comma expected.
+
+
+
+
+ Looks up a localized string similar to The filter expression can't be empty.
+
+
+
+
+ Looks up a localized string similar to Missing end {0}.
+
+
+
+
+ Looks up a localized string similar to Missing escaped character.
+
+
+
+
+ Looks up a localized string similar to Right bracket expected.
+
+
+
+
+ Looks up a localized string similar to String literal expected.
+
+
+
+
+ Looks up a localized string similar to Unexpected character found ({0}).
+
+
+
+
+ Looks up a localized string similar to Unexpected end of input.
+
+
+
+
+ Looks up a localized string similar to Value expected.
+
+
+
+
+ Looks up a localized string similar to Expected a method with signature ({0}) but found ({1})..
+
+
+
+
+ Looks up a localized string similar to The remote host service threw an exception or could not be reached..
+
+
+
+
+ Looks up a localized string similar to Root.
+
+
+
+
+ Looks up a localized string similar to At most one action may be active within the scope at a time..
+
+
+
+
diff --git a/lib/Gallio_3.2.517.0/Gallio35.dll b/lib/Gallio_3.2.517.0/Gallio35.dll
new file mode 100644
index 00000000..58e4a672
Binary files /dev/null and b/lib/Gallio_3.2.517.0/Gallio35.dll differ
diff --git a/lib/Gallio_3.2.517.0/Gallio35.pdb b/lib/Gallio_3.2.517.0/Gallio35.pdb
new file mode 100644
index 00000000..619d1d97
Binary files /dev/null and b/lib/Gallio_3.2.517.0/Gallio35.pdb differ
diff --git a/lib/Gallio_3.2.517.0/Gallio35.plugin b/lib/Gallio_3.2.517.0/Gallio35.plugin
new file mode 100644
index 00000000..856ad628
--- /dev/null
+++ b/lib/Gallio_3.2.517.0/Gallio35.plugin
@@ -0,0 +1,35 @@
+
+
+
+ Gallio Extensions for .Net 3.5
+ 3.2.0.0
+ Provides additional Gallio features for use with .Net 3.5.
+ plugin://Gallio/Resources/Gallio.ico
+
+
+
+
+
+
+
+
+
+
+
+
+
+
\ No newline at end of file
diff --git a/lib/Gallio_3.2.517.0/Gallio35.xml b/lib/Gallio_3.2.517.0/Gallio35.xml
new file mode 100644
index 00000000..93b8414d
--- /dev/null
+++ b/lib/Gallio_3.2.517.0/Gallio35.xml
@@ -0,0 +1,293 @@
+
+
+
+ Gallio35
+
+
+
+
+ Extension methods for
+
+
+
+ Wraps an action as a function that returns a dummy
+ The function.
+
+
+
+ Extension methods for
+
+
+
+ Binds the arguments of a function expression.
+
+ The parameter type.
+ The result type.
+ The bound function.
+
+
+
+ Binds the arguments of a function expression.
+
+ The first parameter type.
+ The second parameter type.
+ The result type.
+ The bound function.
+
+
+
+ Returns true if the expression represents a captured variable within a closure.
+
+ True if the expression represents a captured variable.
+
+
+
+ Returns true if the expression represents a captured variable within a closure.
+
+ True if the expression represents a captured variable.
+
+
+
+ Returns true if the expression represents a captured variable or a parameter.
+
+ True if the expression represents a captured variable or a parameter.
+
+
+
+ Instuments an
+
+
+
+ Compiles an expression to introduce trace points.
+
+ The expression type.
+ The compiled delegate representing expression.
+ Thrown if
+
+
+
+ Rewrites an expression tree to introduce trace points.
+
+ The expression type.
+ The compiled delegate representing expression.
+ Thrown if
+
+
+
+ Evaluates a sub-expression and collects trace information.
+
+ The return type of the sub-expression.
+ The result of the evaluation.
+
+
+
+ Performs different actions depending on the type of
+ The visitor result type.
+
+
+
+ Visits the expression.
+
+ The result.
+
+
+
+ Visits a binary expression.
+
+ The result.
+
+
+
+ Visits a unary expression.
+
+ The result.
+
+
+
+ Visits a call expression.
+
+ The result.
+
+
+
+ Visits a conditional expression.
+
+ The result.
+
+
+
+ Visits a constant expression.
+
+ The result.
+
+
+
+ Visits an invocation expression.
+
+ The result.
+
+
+
+ Visits a lambda expression.
+
+ The result.
+
+
+
+ Visits an list init expression.
+
+ The result.
+
+
+
+ Visits a member access expression.
+
+ The result.
+
+
+
+ Visits a member init expression.
+
+ The result.
+
+
+
+ Visits a new expression.
+
+ The result.
+
+
+
+ Visits a new array expression.
+
+ The result.
+
+
+
+ Visits a parameter expression.
+
+ The result.
+
+
+
+ Visits a type binary expression.
+
+ The result.
+
+
+
+
+ Visits an expression of any type that does not have other special behavior.
+
+
+ The default implementation throws
+
+ The result.
+
+
+
+ The Gallio.Common.Linq namespace contains types for manipulating Linq expressions.
+
+
+
+
+ Evaluates a conditional expression. If the condition evaluates differently
+ than expected, returns a detailed
+
+
+
+ Evaluates a conditional expression.
+
+ The assertion failure if the conditional expression evaluated
+ to a different result than was expected or threw an exception, otherwise null.
+ Thrown if
+
+
+
+ A formatting rule for
+
+
+ Formats expression trees using a more familiar C#-like syntax than
+ the default. Also recognizes captured variables and displays them
+ naturally to conceal the implied field access to an anonymous class.
+
+
+ Made-up syntax for nodes that cannot be directly represented in C#.
+
+ - Power operator: **, as in a ** b
+ - Quote expression: `...`, as in `a + b`
+ - Constants: formatted recursively using other formatters, which may yield unusual syntax
+
+
+
+
+
+
+
+
+
+
+ Extensions methods for formatting.
+
+
+
+
+ Formats an object using the default
+ The formatted object.
+
+
+
+ Formats an object using the specified
+ The formatted object.
+
+
+
diff --git a/lib/Gallio_3.2.517.0/Gallio40.dll b/lib/Gallio_3.2.517.0/Gallio40.dll
new file mode 100644
index 00000000..1701819c
Binary files /dev/null and b/lib/Gallio_3.2.517.0/Gallio40.dll differ
diff --git a/lib/Gallio_3.2.517.0/Gallio40.pdb b/lib/Gallio_3.2.517.0/Gallio40.pdb
new file mode 100644
index 00000000..e654f1e2
Binary files /dev/null and b/lib/Gallio_3.2.517.0/Gallio40.pdb differ
diff --git a/lib/Gallio_3.2.517.0/Gallio40.plugin b/lib/Gallio_3.2.517.0/Gallio40.plugin
new file mode 100644
index 00000000..9730c4b9
--- /dev/null
+++ b/lib/Gallio_3.2.517.0/Gallio40.plugin
@@ -0,0 +1,29 @@
+
+
+
+ Gallio Extensions for .Net 4.0
+ 3.2.0.0
+ Provides additional Gallio features for use with .Net 4.0.
+ plugin://Gallio/Resources/Gallio.ico
+
+
+
+
+
+
+
+
+
+
+
diff --git a/lib/Gallio_3.2.517.0/Gallio40.xml b/lib/Gallio_3.2.517.0/Gallio40.xml
new file mode 100644
index 00000000..9cd44d01
--- /dev/null
+++ b/lib/Gallio_3.2.517.0/Gallio40.xml
@@ -0,0 +1,8 @@
+
+
+
+ Gallio40
+
+
+
+
diff --git a/lib/Gallio_3.2.517.0/ICSharpCode.TextEditor.dll b/lib/Gallio_3.2.517.0/ICSharpCode.TextEditor.dll
new file mode 100644
index 00000000..75accd53
Binary files /dev/null and b/lib/Gallio_3.2.517.0/ICSharpCode.TextEditor.dll differ
diff --git a/lib/Gallio_3.2.517.0/MbUnit.Compatibility.dll b/lib/Gallio_3.2.517.0/MbUnit.Compatibility.dll
new file mode 100644
index 00000000..ad5627d8
Binary files /dev/null and b/lib/Gallio_3.2.517.0/MbUnit.Compatibility.dll differ
diff --git a/lib/Gallio_3.2.517.0/MbUnit.Compatibility.pdb b/lib/Gallio_3.2.517.0/MbUnit.Compatibility.pdb
new file mode 100644
index 00000000..cb839633
Binary files /dev/null and b/lib/Gallio_3.2.517.0/MbUnit.Compatibility.pdb differ
diff --git a/lib/Gallio_3.2.517.0/MbUnit.Compatibility.plugin b/lib/Gallio_3.2.517.0/MbUnit.Compatibility.plugin
new file mode 100644
index 00000000..78fd870d
--- /dev/null
+++ b/lib/Gallio_3.2.517.0/MbUnit.Compatibility.plugin
@@ -0,0 +1,28 @@
+
+
+
+ MbUnit v3 Extensions for Backwards Compatibility
+ 3.2.0.0
+ Provides extensions for MbUnit v3 to assist with test migration from MbUnit v2.
+ plugin://MbUnit/Resources/MbUnit.ico
+
+
+
+
+
+
+
+
+
+
+
\ No newline at end of file
diff --git a/lib/Gallio_3.2.517.0/MbUnit.Compatibility.xml b/lib/Gallio_3.2.517.0/MbUnit.Compatibility.xml
new file mode 100644
index 00000000..9ba837e0
--- /dev/null
+++ b/lib/Gallio_3.2.517.0/MbUnit.Compatibility.xml
@@ -0,0 +1,3419 @@
+
+
+
+ MbUnit.Compatibility
+
+
+
+
+ Array Assertion class
+
+
+
+
+ Verifies that both array have the same dimension and elements.
+
+
+
+
+ Checks whether an object is of an
+ True if
+
+
+
+ Assertion class
+
+
+
+
+ The Equals method throws an AssertionException. This is done
+ to make sure there is no mistake by calling this function.
+
+
+
+
+ override the default ReferenceEquals to throw an AssertionException. This
+ implementation makes sure there is no mistake in calling this function
+ as part of Assert.
+
+
+
+
+ Checks the type of the object, returning true if
+ the object is a numeric type.
+
+ true if the object is a numeric type.
+
+
+
+ Used to compare numeric types. Comparisons between
+ same types are fine (Int32 to Int32, or Int64 to Int64),
+ but the Equals method fails across different types.
+ This method was added to allow any numeric type to
+ be handled correctly, by using ToString and
+ comparing the result
+
+
+
+
+ Asserts that a condition is true. If the condition is false the method throws
+ an
+
+
+ The error message is formatted using
+
+
+
+
+ Asserts that a condition is true. If the condition is false the method throws
+ an
+
+
+
+ Asserts that a condition is false. If the condition is true the method throws
+ an
+
+
+ The error message is formatted using
+
+
+
+
+ Asserts that a condition is false. If the condition is true the method throws
+ an
+
+
+
+ Verifies that two doubles are equal considering a delta. If the
+ expected value is infinity then the delta value is ignored. If
+ they are not equals then an
+
+
+
+ Verifies that two doubles are equal considering a delta. If the
+ expected value is infinity then the delta value is ignored. If
+ they are not equals then an
+
+
+
+ Verifies that two floats are equal considering a delta. If the
+ expected value is infinity then the delta value is ignored. If
+ they are not equals then an
+
+
+
+ Verifies that two floats are equal considering a delta. If the
+ expected value is infinity then the delta value is ignored. If
+ they are not equals then an
+
+
+
+ Verifies that two decimals are equal. If
+ they are not equals then an
+
+
+
+ Verifies that two decimals are equal. If
+ they are not equals then an
+
+
+ The error message is formatted using
+
+
+
+
+ Verifies that two decimals are equal. If
+ they are not equals then an
+
+
+
+ Verifies that two ints are equal. If
+ they are not equals then an
+
+
+
+ Verifies that two ints are equal. If
+ they are not equals then an
+
+
+ The error message is formatted using
+
+
+
+
+ Verifies that two ints are equal. If
+ they are not equals then an
+
+
+
+ Verifies that two objects are equal. Two objects are considered
+ equal if both are null, or if both have the same value. All
+ non-numeric types are compared by using the Equals method.
+ If they are not equal an
+
+
+ The error message is formatted using
+
+
+
+
+ Verifies that two objects are equal. Two objects are considered
+ equal if both are null, or if both have the same value. All
+ non-numeric types are compared by using the Equals method.
+ If they are not equal an
+
+
+
+ Verifies that two objects are equal. Two objects are considered
+ equal if both are null, or if both have the same value. All
+ non-numeric types are compared by using the Equals method.
+ If they are not equal an
+
+
+
+ Verifies that the value of the property described by
+
+
+
+ Asserts that two objects are not equal. If they are equal
+ an
+
+
+
+ Asserts that two objects are not equal. If they are equal
+ an
+
+
+
+ Asserts that two objects are not equal. If they are equal
+ an
+
+
+
+ Asserts that two ints are not equal. If they are equal
+ an
+
+
+
+ Asserts that two ints are not equal. If they are equal
+ an
+
+
+
+ Asserts that two ints are not equal. If they are equal
+ an
+
+
+
+ Asserts that two uints are not equal. If they are equal
+ an
+
+
+
+ Asserts that two uints are not equal. If they are equal
+ an
+
+
+
+ Asserts that two uints are not equal. If they are equal
+ an
+
+
+
+ Asserts that two decimals are not equal. If they are equal
+ an
+
+
+
+ Asserts that two decimals are not equal. If they are equal
+ an
+
+
+
+ Asserts that two decimals are not equal. If they are equal
+ an
+
+
+
+ Asserts that two floats are not equal. If they are equal
+ an
+
+
+
+ Asserts that two floats are not equal. If they are equal
+ an
+
+
+
+ Asserts that two floats are not equal. If they are equal
+ an
+
+
+
+ Asserts that two doubles are not equal. If they are equal
+ an
+
+
+
+ Asserts that two doubles are not equal. If they are equal
+ an
+
+
+
+ Asserts that two doubles are not equal. If they are equal
+ an
+
+
+
+ Verifies that the object that is passed in is not equal to null
+ If the object is not null then an
+
+
+ The error message is formatted using
+
+
+
+
+ Verifies that the object that is passed in is not equal to null
+ If the object is null then an
+
+
+
+ Verifies that the object that is passed in is not equal to null
+ If the object is not null then an
+
+
+
+ Verifies that the object that is passed in is equal to null
+ If the object is null then an
+
+
+ The error message is formatted using
+
+
+
+
+ Verifies that the object that is passed in is equal to null
+ If the object is null then an
+
+
+
+ Verifies that the object that is passed in is equal to null
+ If the object is null then an
+
+
+
+ Asserts that two objects refer to the same object. If they
+ are not the same an
+
+
+
+ Asserts that two objects refer to the same object. If they
+ are not the same an
+
+
+ The error message is formatted using
+
+
+
+
+ Asserts that two objects refer to the same object. If they
+ are not the same an
+
+
+
+ Throws an
+
+
+ The error message is formatted using
+
+
+
+
+ Throws an
+
+
+
+ Throws an
+
+
+
+ Verifies that
+
+
+
+ Verifies that
+
+
+
+ Verifies that
+
+
+
+ Verifies that
+
+
+
+ Verifies that
+
+
+
+ Verifies that
+
+
+
+ Verifies that
+
+
+
+ Verifies that
+
+
+
+ Verifies that
+
+
+
+ Verifies that
+
+
+
+ Verifies that
+
+
+
+ Verifies that
+
+
+
+ Verifies that
+
+
+
+ Verifies that
+
+
+
+ Verifies that
+
+
+
+ Verifies that
+
+
+
+ Verifies that
+
+
+
+ Verifies that
+
+
+
+ Verifies that
+
+
+
+ Verifies that
+
+
+
+ Verifies that
+
+
+
+ Verifies that
+
+
+
+ Verifies that
+
+
+
+ Verifies that
+
+
+
+ Verifies that
+
+
+
+ Verifies that
+
+
+
+ Verifies that
+
+
+
+ Verifies that
+
+
+
+ Verifies that
+
+
+
+ Verifies that
+
+
+
+ Verifies that
+
+
+
+ Verifies that
+
+
+
+ Verifies that
+
+
+
+ Verifies that
+
+
+
+ Verifies that
+
+
+
+ Verifies that
+
+
+
+ Verifies that
+
+
+
+ Verifies that
+
+
+
+ Verifies that
+
+
+
+ Verifies that
+
+
+
+ Verifies that
+
+
+
+ Verifies that
+
+
+
+ Verifies that the first value is less than the second
+ value. If it is not, then an
+
+
+
+
+ Verifies that the first value is less than the second
+ value. If it is not, then an
+
+
+
+
+ Verifies that the first value is less than the second
+ value. If it is not, then an
+
+
+
+
+ Verifies that the first value is less than the second
+ value. If it is not, then an
+
+
+
+
+ Verifies that the first value is less than the second
+ value. If it is not, then an
+
+
+
+
+ Verifies that the first value is less than the second
+ value. If it is not, then an
+
+
+
+
+ Verifies that the first value is less than the second
+ value. If it is not, then an
+
+
+
+
+ Verifies that the first value is less than the second
+ value. If it is not, then an
+
+
+
+
+ Verifies that the first value is less than the second
+ value. If it is not, then an
+
+
+
+
+ Verifies that the first value is less than the second
+ value. If it is not, then an
+
+
+
+
+ Verifies that the first value is less than the second
+ value. If it is not, then an
+
+
+
+
+ Verifies that the first value is less than the second
+ value. If it is not, then an
+
+
+
+
+ Verifies that the first value is less than the second
+ value. If it is not, then an
+
+
+
+
+ Verifies that the first value is less than the second
+ value. If it is not, then an
+
+
+
+
+ Verifies that the first value is less than the second
+ value. If it is not, then an
+
+
+
+
+ Verifies that the first value is less than the second
+ value. If it is not, then an
+
+
+
+
+ Verifies that the first value is less than the second
+ value. If it is not, then an
+
+
+
+
+ Verifies that the first value is less than the second
+ value. If it is not, then an
+
+
+
+
+ Verifies that the first value is less than the second
+ value. If it is not, then an
+
+
+
+
+ Verifies that the first value is less than the second
+ value. If it is not, then an
+
+
+
+
+ Verifies that the first value is less than the second
+ value. If it is not, then an
+
+
+
+
+ Verifies that
+
+
+
+ Verifies that
+
+
+
+ Verifies that
+
+
+
+ Verifies that
+
+
+
+ Verifies that
+
+
+
+ Verifies that
+
+
+
+ Verifies that
+
+
+
+ Verifies that
+
+
+
+ Verifies that
+
+
+
+ Verifies that
+
+
+
+ Verifies that
+
+
+
+ Verifies that
+
+
+
+ Verifies that
+
+
+
+ Verifies that
+
+
+
+ Verifies that
+
+
+
+ Verifies that
+
+
+
+ Verifies that
+
+
+
+ Verifies that
+
+
+
+ Verifies that
+
+
+
+ Verifies that
+
+
+
+ Verifies that
+
+
+
+ Verifies that the first value is greater than the second
+ value. If they are not, then an
+
+
+
+
+ Verifies that the first value is greater than the second
+ value. If they are not, then an
+
+
+
+
+ Verifies that the first value is greater than the second
+ value. If they are not, then an
+
+
+
+
+ Verifies that the first value is greater than the second
+ value. If they are not, then an
+
+
+
+
+ Verifies that the first value is greater than the second
+ value. If they are not, then an
+
+
+
+
+ Verifies that the first value is greater than the second
+ value. If they are not, then an
+
+
+
+
+ Verifies that the first value is greater than the second
+ value. If they are not, then an
+
+
+
+
+ Verifies that the first value is greater than the second
+ value. If they are not, then an
+
+
+
+
+ Verifies that the first value is greater than the second
+ value. If they are not, then an
+
+
+
+
+ Verifies that the first value is greater than the second
+ value. If they are not, then an
+
+
+
+
+ Verifies that the first value is greater than the second
+ value. If they are not, then an
+
+
+
+
+ Verifies that the first value is greater than the second
+ value. If they are not, then an
+
+
+
+
+ Verifies that the first value is greater than the second
+ value. If they are not, then an
+
+
+
+
+ Verifies that the first value is greater than the second
+ value. If they are not, then an
+
+
+
+
+ Verifies that the first value is greater than the second
+ value. If they are not, then an
+
+
+
+
+ Verifies that the first value is greater than the second
+ value. If they are not, then an
+
+
+
+
+ Verifies that the first value is greater than the second
+ value. If they are not, then an
+
+
+
+
+ Verifies that the first value is greater than the second
+ value. If they are not, then an
+
+
+
+
+ Verifies that the first value is greater than the second
+ value. If they are not, then an
+
+
+
+
+ Verifies that the first value is greater than the second
+ value. If they are not, then an
+
+
+
+
+ Verifies that the first value is greater than the second
+ value. If they are not, then an
+
+
+
+
+ Verifies that
+
+
+
+ Verifies that
+
+
+
+ Verifies that
+
+
+
+ Verifies that
+
+
+
+ Verifies that
+
+
+
+ Verifies that
+
+
+
+ Verifies that
+
+
+
+ Verifies that
+
+
+
+ Verifies that
+
+
+
+ Verifies that
+
+
+
+ Verifies that
+
+
+
+ Verifies that
+
+
+
+ Verifies that
+
+
+
+ Verifies that
+
+
+
+ Verifies that
+
+
+
+ Verifies that
+
+
+
+ Verifies that
+
+
+
+ Verifies that
+
+
+
+ Verifies that
+
+
+
+ Verifies that
+
+
+
+ Verifies that
+
+
+
+ Asserts that
+
+
+
+ Asserts that
+
+
+
+ Asserts that
+
+
+
+ Asserts that
+
+
+
+ Asserts that
+
+
+
+ Asserts that
+
+
+
+ Asserts that
+
+
+
+ Asserts that
+
+
+
+ Asserts that
+
+
+
+ Asserts that
+
+
+
+ Asserts that
+
+
+
+ Asserts that
+
+
+
+ Asserts that
+
+
+
+ Asserts that
+
+
+
+ Asserts that
+
+
+
+ Asserts that
+
+
+
+ Asserts that
+
+
+
+ Asserts that
+
+
+
+ Asserts that
+
+
+
+ Asserts that
+
+
+
+ Asserts that
+
+
+
+ Asserts that not between
+
+
+
+ Asserts that not between
+
+
+
+ Asserts that not between
+
+
+
+ Asserts that not between
+
+
+
+ Asserts that not between
+
+
+
+ Asserts that not between
+
+
+
+ Asserts that not between
+
+
+
+ Asserts that
+
+
+
+ Asserts that
+
+
+
+ Asserts that
+
+
+
+ Asserts that
+
+
+
+ Asserts that
+
+
+
+ Asserts that
+
+
+
+ Asserts that not in the dic
+
+
+
+ Asserts that not in the dic
+
+
+
+ Asserts that not in the list
+
+
+
+ Asserts that not in the list
+
+
+
+ Asserts that not in the enumerable collection
+
+
+
+ Asserts that not in the enumerable collection
+
+
+
+ Assert that a string is empty - that is equal to string.Empty
+
+
+
+
+ Assert that a string is empty - that is equal to string.Emtpy
+
+
+
+
+ Assert that a string is empty - that is equal to string.Emtpy
+
+
+
+
+ Assert that an array, list or other collection is empty
+
+
+
+
+ Assert that an array, list or other collection is empty
+
+
+
+
+ Assert that an array,list or other collection is empty
+
+
+
+
+ Assert that a string is empty - that is equal to string.Emtpy
+
+
+
+
+ Assert that a string is empty - that is equal to string.Emtpy
+
+
+
+
+ Assert that a string is empty - that is equal to string.Emtpy
+
+
+
+
+ Assert that an array, list or other collection is empty
+
+
+
+
+ Assert that an array, list or other collection is empty
+
+
+
+
+ Assert that an array,list or other collection is empty
+
+
+
+
+ Verifies that the double is passed is an NaN value.
+ If the object is not NaN then an
+
+
+
+ Verifies that the double is passed is an NaN value.
+ If the object is not NaN then an
+
+
+
+ Verifies that the double is passed is an NaN value.
+ If the object is not NaN then an
+
+
+
+ Asserts that an object may be assigned a value of a given Type.
+
+
+
+
+ Asserts that an object may be assigned a value of a given Type.
+
+
+
+
+ Asserts that an object may be assigned a value of a given Type.
+
+
+
+
+ Asserts that an object may not be assigned a value of a given Type.
+
+
+
+
+ Asserts that an object may not be assigned a value of a given Type.
+
+
+
+
+ Asserts that an object may not be assigned a value of a given Type.
+
+
+
+
+ Asserts that an object is an instance of a given type.
+
+
+
+
+ Asserts that an object is an instance of a given type.
+
+
+
+
+ Asserts that an object is an instance of a given type.
+
+
+
+
+ Asserts that an object is not an instance of a given type.
+
+
+
+
+ Asserts that an object is not an instance of a given type.
+
+
+
+
+ Asserts that an object is not an instance of a given type.
+
+
+
+
+ This method is called when two objects have been compared and found to be
+ different. This prints a nice message to the screen.
+
+
+
+ The error message is formatted using
+
+
+
+
+ This method is called when the two objects are not the same.
+
+
+
+ The error message is formatted using
+
+
+
+
+ Assertion helper for the
+
+
+ This class contains static helper methods to verify assertions on the
+
+
+
+
+
+ Verifies that the property value
+
+
+
+ Verifies that the property value
+
+
+
+ Verifies that the property value
+
+
+
+ Verifies that the property value
+
+
+
+ Verifies that the property value
+
+
+
+ Verifies that the property value
+
+
+
+ Verifies that the property value
+
+
+
+ Verifies that the property value
+
+
+
+ Verifies that the
+
+
+
+
+
+ Verifies that
+
+
+
+ Verifies that
+
+
+
+ Verifies that
+
+
+
+ Asserts that all items contained in collection are of the type specified by expectedType.
+
+
+
+
+ Asserts that all items contained in collection are of the type specified by expectedType.
+
+
+
+
+ Asserts that all items contained in collection are of the type specified by expectedType.
+
+
+
+
+ Asserts that all items contained in collection are not equal to null.
+
+
+
+
+ Asserts that all items contained in collection are not equal to null.
+
+
+
+
+ Asserts that all items contained in collection are not equal to null.
+
+
+
+
+ Ensures that every object contained in collection exists within the collection
+ once and only once.
+
+
+
+
+ Ensures that every object contained in collection exists within the collection
+ once and only once.
+
+
+
+
+ Ensures that every object contained in collection exists within the collection
+ once and only once.
+
+
+
+
+ Asserts that expected and actual are equivalent, containing the same objects but the match may be in any order.
+
+
+
+
+ Asserts that expected and actual are equivalent, containing the same objects but the match may be in any order.
+
+
+
+
+ Asserts that expected and actual are equivalent, containing the same objects but the match may be in any order.
+
+
+
+
+ Asserts that expected and actual are not exactly equal.
+
+
+
+
+ Asserts that expected and actual are not exactly equal.
+ If comparer is not null then it will be used to compare the objects.
+
+
+
+
+ Asserts that expected and actual are not exactly equal.
+
+
+
+
+ Asserts that expected and actual are not exactly equal.
+ If comparer is not null then it will be used to compare the objects.
+
+
+
+
+ Asserts that expected and actual are not exactly equal.
+
+
+
+
+ Asserts that expected and actual are not exactly equal.
+ If comparer is not null then it will be used to compare the objects.
+
+
+
+
+ Asserts that expected and actual are not equivalent.
+
+
+
+
+ Asserts that expected and actual are not equivalent.
+
+
+
+
+ Asserts that expected and actual are not equivalent.
+
+
+
+
+ Asserts that collection contains actual as an item.
+
+
+
+
+ Asserts that collection contains actual as an item.
+
+
+
+
+ Asserts that collection contains actual as an item.
+
+
+
+
+ Asserts that collection does not contain actual as an item.
+
+
+
+
+ Asserts that collection does not contain actual as an item.
+
+
+
+
+ Asserts that collection does not contain actual as an item.
+
+
+
+
+ Asserts that subset is not a subset of superset.
+
+
+
+
+ Asserts that subset is not a subset of superset.
+
+
+
+
+ Asserts that subset is not a subset of superset.
+
+
+
+
+ Asserts that subset is a subset of superset.
+
+
+
+
+ Asserts that subset is a subset of superset.
+
+
+
+
+ Asserts that subset is a subset of superset.
+
+
+
+
+ Checks an item if included in a given collection.
+
+ True if item is included, False otherwise.
+
+
+
+ Assertion class
+
+
+
+
+ Assert that an array, list or other collection is empty
+
+
+
+
+ Assert that an array, list or other collection is empty
+
+
+
+
+ Assert that an array,list or other collection is empty
+
+
+
+
+ Assert that an array, list or other collection is empty
+
+
+
+
+ Assert that an array, list or other collection is empty
+
+
+
+
+ Assert that an array,list or other collection is empty
+
+
+
+
+ Reflection Assertion class
+
+
+
+
+ Asserts whether an instance of the
+
+
+
+ Asserts whether
+
+
+
+ Asserts that the type has a default public constructor
+
+
+
+
+ Asserts that the type has a public instance constructor with a signature defined by parameters.
+
+
+
+
+ Asserts that the type has a constructor, with the specified bindind flags, with a signature defined by parameters.
+
+
+
+
+ Asserts that the type has a public instance method with a signature defined by parameters.
+
+
+
+
+ Asserts that the type has a method, with the specified bindind flags, with a signature defined by parameters.
+
+
+
+
+ Asserts that the type has a public field method with a signature defined by parameters.
+
+
+
+
+ Asserts that the type has a field, with the specified bindind flags, with a signature defined by parameters.
+
+
+
+
+ String Assertion class
+
+
+
+
+ Asserts that two strings are equal, ignoring the case
+
+
+
+
+ Asserts that the string is non null and empty
+
+
+
+
+ Asserts that the string is non null and non empty
+
+
+
+
+ Asserts the regular expression reg makes a full match on s
+
+
+
+
+ Asserts the regular expression regex makes a full match on
+
+
+
+
+ Asserts the regular expression reg makes a match on s
+
+
+
+
+ Asserts the regular expression regex makes a match on s
+
+
+
+
+ Asserts the regular expression reg makes a match on s
+
+
+
+
+ Asserts the regular expression regex makes a match on s
+
+
+
+
+ Asserts the string does not contain c
+
+
+
+
+ Access modifier of a class or class member.
+
+
+
+
+ Public.
+
+
+
+
+ Protected, internal, private.
+
+
+
+
+ Static.
+
+
+
+
+ Default that includes public, protected, internal, private, and static.
+
+
+
+
+ Member types of a class.
+
+
+
+
+ Method.
+
+
+
+
+ Field or variable.
+
+
+
+
+ Property.
+
+
+
+
+ The MbUnit.Framework.Reflection namespace provides helpers for accessing
+ non-public members of types from test code.
+
+
+
+
+ Indicates that a reflection operation performed by
+
+
+
+ Creates an exception.
+
+
+
+
+ Creates an exception.
+
+
+
+
+ Creates an exception.
+
+
+
+
+ Creates an exception from serialization info.
+
+
+
+
+ Helper class to test non-public classes and class members.
+
+
+
+
+ Constructor for object.
+
+
+
+
+ Use this constructor if you plan to test default constructor of a non-public class.
+
+
+
+
+ Use this constructor if you plan to test constructor with arguments of a non-public class.
+
+
+
+
+ Gets the public, non-public, or static field value.
+
+ Field value.
+
+
+
+ Gets the field value.
+
+ Field value.
+
+
+
+ Gets the field value.
+
+ Field value.
+
+
+
+ Sets the field value.
+
+
+
+
+ Sets the field value.
+
+
+
+
+ Gets the property value
+
+ Property Value.
+
+
+
+ Get the property value
+
+ Property Value.
+
+
+
+ Get the property value.
+
+ Property Value.
+
+
+
+ Sets the property value.
+
+
+
+
+ Sets the property value.
+
+
+
+
+ Executes a non-public method with arguments on a object
+
+ The object the method should return.
+
+
+
+ Executes a non-public method with arguments on a object
+
+ The object the method should return.
+
+
+
+ Executes a non-public method with arguments on a object
+
+ The object the method should return.
+
+
+
+ Creates an instance
+
+ Newly created object.
+
+
+
+ Creates an instance
+
+ Newly created object.
+
+
+
+ Gets the public, non-public, or static field value.
+
+ Field value.
+
+
+
+ Gets the field value.
+
+ Field value.
+
+
+
+ Gets the field value.
+
+ Field value.
+
+
+
+ Sets the field value.
+
+
+
+
+ Sets the field value.
+
+
+
+
+ Sets the field value.
+
+
+
+
+ Gets the property value.
+
+ Property Value.
+
+
+
+ Gets the property value.
+
+ Property Value.
+
+
+
+ Gets the property value.
+
+ Property Value.
+
+
+
+ Sets the property value.
+
+
+
+
+ Sets the property value.
+
+
+
+
+ Sets the property value.
+
+
+
+
+ Executes a non-public method with arguments on a object
+
+ The object the method should return.
+
+
+
+ Executes a non-public method with arguments on a object
+
+ The object the method should return.
+
+
+
+ Executes a non-public method with arguments on a object
+
+ The object the method should return.
+
+
+
+ Executes a non-public method with arguments on a object
+
+ The object the method should return.
+
+
+
+ Provides compatibility with MbUnit v2 row test feature.
+
+
+
+
+ Security Assertion class
+
+
+
+
+ Asserts that
+
+
+
+ Asserts that
+
+
+
+ Asserts that the current windows identity is authenticated.
+
+
+
+
+ Asserts that the current windows identity is not authenticated.
+
+
+
+
+ Asserts that the current windows identity is in
+
+
+
+ Asserts that the current windows identity is in
+
+
+
+
+ Asserts that the current windows identity is in
+
+
+
+
+ Asserts that the current windows identity is in
+
+
+
+
+ Asserts that the current windows identity is in
+
+
+
+
+ Provides compatibility with MbUnit v2 test fixture set up.
+
+
+
+
+ Provides compatibility with MbUnit v2 test fixture tear down.
+
+
+
+
+ Class containing generic assert methods for XML markup
+
+
+
+
+ Asserts that two pieces of XML are similar.
+
+
+
+
+ Asserts that two pieces of XML are similar.
+
+
+
+
+ Asserts that two pieces of XML are similar.
+
+
+
+
+ Asserts that two pieces of XML are identical.
+
+
+
+
+ Asserts that two pieces of XML are identical.
+
+
+
+
+ Asserts that two pieces of XML are identical.
+
+
+
+
+ Asserts that two pieces of XMl are similar given their diff
+
+
+
+
+ Asserts that two pieces of XMl are not similar given their diff
+
+
+
+
+ Asserts that two pieces of XML are similar (or not) given their diff and a boolean value
+
+ true the assert passes if the XML is similar.
+ if false , the assert passes if the XML is not similar.
+
+
+
+ Asserts that two pieces of XML are identical given their diff
+
+
+
+
+ Asserts that two pieces of XML are not identical given their diff
+
+
+
+
+ Asserts that two pieces of XML are identical (or not) given their diff and a boolean value
+
+ true the assert passes if the XML is identical.
+ if false , the assert passes if the XML is not identical.
+
+
+
+ Asserts that
+
+
+
+ Asserts that
+
+
+
+ Asserts that some XML is valid.
+
+
+
+
+ Asserts that some XML is valid given a
+
+
+
+ Asserts that some XML is valid.
+
+
+
+
+ Asserts that some XML is valid.
+
+
+
+
+ Assert that an XPath expression matches at least one node in someXml
+
+
+
+
+ Assert that an XPath expression matches at least one node in someXml
+
+
+
+
+ Assert that an XPath expression matches at least one node in someXml
+
+
+
+
+ Asserts that the flattened String obtained by executing an Xpath on some XML is a particular value
+
+
+
+
+ Asserts that the flattened String obtained by executing an Xpath on some XML is a particular value
+
+
+
+
+ Asserts that the flattened String obtained by executing an Xpath on some XML is a particular value
+
+
+
+
+ Asserts that the results of an XSL transform on some XML are the expected result
+
+
+
+
+ Asserts that the results of an XSL transform on some XML are the expected result
+
+
+
+
+ Utilities for manipulating differences.
+
+
+
+
+ Returns true is a difference is considered significant.
+
+
+
+
+ Describes the type of difference found.
+
+
+
+
+ Comparing an implied attribute value against an explicit value
+
+
+
+
+ Comparing 2 elements and one has an attribute the other does not
+
+
+
+
+ Comparing 2 attributes with the same name but different values
+
+
+
+
+ Comparing 2 attribute lists with the same attributes in different sequence
+
+
+
+
+ Comparing 2 CDATA sections with different values
+
+
+
+
+ Comparing 2 comments with different values
+
+
+
+
+ Comparing 2 document types with different names
+
+
+
+
+ Comparing 2 document types with different public identifiers
+
+
+
+
+ Comparing 2 document types with different system identifiers
+
+
+
+
+ Comparing 2 elements with different tag names
+
+
+
+
+ Comparing 2 elements with different number of attributes
+
+
+
+
+ Comparing 2 processing instructions with different targets
+
+
+
+
+ Comparing 2 processing instructions with different instructions
+
+
+
+
+ Comparing 2 different text values
+
+
+
+
+ Comparing 2 nodes with different namespace prefixes
+
+
+
+
+ Comparing 2 nodes with different namespace URIs
+
+
+
+
+ Comparing 2 nodes with different node types
+
+
+
+
+ Comparing 2 nodes but only one has any children
+
+
+
+
+ Comparing 2 nodes with different numbers of children
+
+
+
+
+ Comparing 2 nodes with children whose nodes are in different sequence
+
+
+
+
+ Comparing 2 Documents only one of which has a doctype
+
+
+
+
+ Comparing 2 Documents only one of which has an XML Prefix Declaration
+
+
+
+
+ The MbUnit.Framework.Xml namespace contains types for comparing Xml documents.
+
+
+
+
diff --git a/lib/Gallio_3.2.517.0/MbUnit.dll b/lib/Gallio_3.2.517.0/MbUnit.dll
new file mode 100644
index 00000000..9439aa7a
Binary files /dev/null and b/lib/Gallio_3.2.517.0/MbUnit.dll differ
diff --git a/lib/Gallio_3.2.517.0/MbUnit.dll.tdnet b/lib/Gallio_3.2.517.0/MbUnit.dll.tdnet
new file mode 100644
index 00000000..367728e3
--- /dev/null
+++ b/lib/Gallio_3.2.517.0/MbUnit.dll.tdnet
@@ -0,0 +1,6 @@
+
+ MbUnit v{0}.{1}
+ TDNet\Gallio.TDNetRunner.dll
+ Gallio.TDNetRunner.GallioResidentTestRunner
+ Resident
+
diff --git a/lib/Gallio_3.2.517.0/MbUnit.pdb b/lib/Gallio_3.2.517.0/MbUnit.pdb
new file mode 100644
index 00000000..a8f95218
Binary files /dev/null and b/lib/Gallio_3.2.517.0/MbUnit.pdb differ
diff --git a/lib/Gallio_3.2.517.0/MbUnit.plugin b/lib/Gallio_3.2.517.0/MbUnit.plugin
new file mode 100644
index 00000000..d55f27db
--- /dev/null
+++ b/lib/Gallio_3.2.517.0/MbUnit.plugin
@@ -0,0 +1,54 @@
+
+
+
+ MbUnit v3
+ 3.2.0.0
+ Provides support for running MbUnit v3 tests.
+ plugin://MbUnit/Resources/MbUnit.ico
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ MbUnit v3
+ MbUnit, Version=3.2.0.0
+ plugin://MbUnit/Resources/MbUnit.ico
+ 3.2.0.0
+ Assembly
+
+
+
+
+
+ MbUnit v3 Assembly
+ MbUnit v3 Test Assembly
+ plugin://MbUnit/Resources/MbUnit.ico
+
+
+
+
\ No newline at end of file
diff --git a/lib/Gallio_3.2.517.0/MbUnit.xml b/lib/Gallio_3.2.517.0/MbUnit.xml
new file mode 100644
index 00000000..b3740ca5
--- /dev/null
+++ b/lib/Gallio_3.2.517.0/MbUnit.xml
@@ -0,0 +1,11494 @@
+
+
+
+ MbUnit
+
+
+
+
+ Associates an annotation message of the specified type with the code element.
+
+
+
+ An annotation is a message that is associated with code. This is different
+ from the metadata that may be associated with a test because an annotation
+ can apply to code elements that are not tests.
+
+
+ For example, if an error occurs while parsing the declarative attribute
+ structure that defines a test, then the test itself may not be added to
+ the test tree. Instead, the Pattern Test Framework will associated an
+ error annotation with the point of definition of the test. This annotation
+ is displayed by the test runner as an error. Some test runners, such as the
+ ReSharper test runner, will actually highlight the annotated element in the
+ IDE using an error stripe.
+
+
+ This attribute makes it possible to add annotations to code elements
+ declaratively.
+
+
+ Note: The annotation will only be added if the associated code element is
+ traversed during the normal sequence of test exploration.
+
+
+
+
+
+ Associates an annotation message of the specified type with the code element.
+
+ Thrown if
+
+
+
+ Sets the apartment state to be used to run the decorated test and its children
+ unless subsequently overridden.
+
+
+
+ If no apartment state is specified or if it is
+
+ The default apartment state for a test assembly is
+
+
+
+
+ Sets the apartment state to be used to run the decorated test and its children
+ unless subsequently overridden.
+
+
+
+ If no apartment state is specified or if it is
+
+ The default apartment state for a test assembly is
+
+
+
+
+
+
+ Gets the apartment state to be used to run the decorated test.
+
+
+
+
+ Declares that a class contains assembly-level setup and teardown methods.
+
+
+
+ The assembly fixture attribute is applied to a class that contains setup and
+ teardown methods that are to be applied at the assembly level. Conceptually,
+ the
+
+ The following attributes are typically used within an assembly fixture:
+
+
+
+
+ It is also possible to use other attributes as with an ordinary
+
+ The class must have a public default constructor. The class may not be static.
+
+
+ There must only be at most one class with an
+
+
+
+
+
+
+
+
+
+
+ Defines a set of assertions that enable a test to verify the expected
+ behavior of the subject under test.
+
+
+
+ Each assertion is generally provided in at least 4 flavors distinguished by overloads:
+
+ - A simple form that takes only the assertion parameters.
+ - A simple form that accepts a custom message format string and arguments in addition to the assertion parameters.
+ - A rich form that takes the assertion parameters and a custom comparer object.
+ - A rich form that accepts a custom message format string and arguments in addition to the assertion parameters and a custom comparer object.
+
+
+
+ The value upon which the assertion is being evaluated is usually called the "actual value".
+ Other parameters for the assertion are given names such as the "expected value", "unexpected value",
+ or other terms as appropriate. In some cases where the role of a parameter is ambiguous,
+ we may use designations such as "left" and "right" to distinguish the parameters.
+
+
+ The Assert class does not provide direct support for old-style collection types such as
+
+ ICollection myOldCollection = subjectUnderTest.DoSomething();
+ Assert.AreElementsEqual(new[] { "a", "b", "c" }, myOldCollection.Cast<string>());
+
+
+
+
+ Framework authors may choose to extend this class with additional assertions by creating
+ a subclass. Alternately, new assertions can be defined in other classes.
+
+
+ When formatting values for inclusion in assertion failures, it is recommended to use the
+ formatter provided by the
+
+
+
+
+ Verifies that the specified sequence, collection, or array contains the expected number of elements.
+
+
+
+ The assertion counts the elements according to the underlying type of the sequence.
+
+ - Uses
+ - Uses
+ - Enumerates and counts the elements if the sequence is a simple
+
+
+
+ Thrown if the verification failed unless the current
+ Thrown if
+ Thrown if
+
+
+
+ Verifies that the specified sequence, collection, or array contains the expected number of elements.
+
+
+
+ The assertion counts the elements according to the underlying type of the sequence.
+
+ - Uses
+ - Uses
+ - Enumerates and counts the elements if the sequence is a simple
+
+
+
+ Thrown if the verification failed unless the current
+ Thrown if
+ Thrown if
+
+
+
+ Prevents instantiation.
+ Subclasses should likewise define their constructor to be protected.
+
+
+
+
+ Always throws an
+
+
+
+ Always throws an
+
+
+
+ Signals an unconditional assertion failure.
+
+
+
+ Use
+
+ Thrown unless the current
+
+
+
+ Signals an unconditional assertion failure with a particular message.
+
+
+
+ Use
+
+ Thrown unless the current
+
+
+
+ Terminates the test and reports an inconclusive test outcome.
+
+
+
+ The test is terminated with an inconclusive test outcome by throwing a
+
+
+ Thrown always.
+
+
+
+ Terminates the test and reports an inconclusive test outcome.
+
+
+
+ The test is terminated with an inconclusive test outcome by throwing a
+
+
+ Thrown always.
+
+
+
+ Terminates the test and reports a specific test outcome.
+
+
+
+ The test is terminated with by throwing a
+
+ Thrown always.
+
+
+
+ Terminates the test and reports a specific test outcome.
+
+
+
+ The test is terminated with by throwing a
+
+ Thrown always.
+
+
+
+ Terminates the test silently and reports a specific test outcome.
+
+
+
+ Unlike
+
+ The test is terminated with by throwing a
+
+ Thrown always.
+
+
+
+ Terminates the test silently and reports a specific test outcome.
+
+
+
+ Unlike
+
+ The test is terminated with by throwing a
+
+ Thrown always.
+
+
+
+ Evaluates a block of code that contains multiple related assertions.
+
+
+
+ While the action delegate runs, the behavior of assertions is change such that
+ failures are captured but do not cause a
+
+ A multiple assertion block is useful for verifying the state of a single
+ component with many parts that require several assertions to check.
+ This feature can accelerate debugging because more diagnostic information
+ become available at once.
+
+
+ Thrown if
+
+
+
+ Evaluates a block of code that contains multiple related assertions.
+
+
+
+ While the action delegate runs, the behavior of assertions is change such that
+ failures are captured but do not cause a
+
+ A multiple assertion block is useful for verifying the state of a single
+ component with many parts that require several assertions to check.
+ This feature can accelerate debugging because more diagnostic information
+ become available at once.
+
+
+ Thrown if
+
+
+
+ Verifies that a string contains some expected value.
+
+
+
+ This assertion will fail if the string is null.
+
+
+ Thrown if the verification failed unless the current
+ Thrown if
+
+
+
+ Verifies that a string contains some expected value.
+
+
+
+ This assertion will fail if the string is null.
+
+
+ Thrown if the verification failed unless the current
+ Thrown if
+
+
+
+ Verifies that a string does not contain some unexpected substring.
+
+
+
+ This assertion will fail if the string is null.
+
+
+ Thrown if the verification failed unless the current
+ Thrown if
+
+
+
+ Verifies that a string does not contain some unexpected substring.
+
+
+
+ This assertion will fail if the string is null.
+
+
+ Thrown if the verification failed unless the current
+ Thrown if
+
+
+
+ Asserts that two strings are equal according to a particular string comparison mode.
+
+ Thrown if the verification failed unless the current
+
+
+
+ Asserts that two strings are equal according to a particular string comparison mode.
+
+ Thrown if the verification failed unless the current
+
+
+
+ Asserts that two strings are not equal according to a particular string comparison mode.
+
+ Thrown if the verification failed unless the current
+
+
+
+ Asserts that two strings are not equal according to a particular string comparison mode.
+
+ Thrown if the verification failed unless the current
+
+
+
+ Verifies that a string matches regular expression pattern exactly.
+
+
+
+ This assertion will fail if the string is null.
+
+
+ Thrown if the verification failed unless the current
+ Thrown if
+
+
+
+ Verifies that a string matches regular expression pattern exactly.
+
+
+
+ This assertion will fail if the string is null.
+
+
+ Thrown if the verification failed unless the current
+ Thrown if
+
+
+
+ Verifies that a string matches regular expression pattern exactly.
+
+
+
+ This assertion will fail if the string is null.
+
+
+ Thrown if the verification failed unless the current
+ Thrown if
+
+
+
+ Verifies that a string matches regular expression pattern exactly.
+
+
+
+ This assertion will fail if the string is null.
+
+
+ Thrown if the verification failed unless the current
+ Thrown if
+
+
+
+ Verifies that a string matches regular expression pattern exactly.
+
+
+
+ This assertion will fail if the string is null.
+
+
+ Thrown if the verification failed unless the current
+ Thrown if
+
+
+
+ Verifies that a string matches regular expression pattern exactly.
+
+
+
+ This assertion will fail if the string is null.
+
+
+ Thrown if the verification failed unless the current
+ Thrown if
+
+
+
+ Verifies that a string contains a full or partial match of a regular expression pattern.
+
+
+
+ This assertion will fail if the string is null.
+
+
+ Thrown if the verification failed unless the current
+ Thrown if
+
+
+
+ Verifies that a string contains a full or partial match of a regular expression pattern.
+
+
+
+ This assertion will fail if the string is null.
+
+
+ Thrown if the verification failed unless the current
+ Thrown if
+
+
+
+ Verifies that a string contains a full or partial match of a regular expression pattern.
+
+
+
+ This assertion will fail if the string is null.
+
+
+ Thrown if the verification failed unless the current
+ Thrown if
+
+
+
+ Verifies that a string contains a full or partial match of a regular expression pattern.
+
+
+
+ This assertion will fail if the string is null.
+
+
+ Thrown if the verification failed unless the current
+ Thrown if
+
+
+
+ Verifies that a string contains a full or partial match of a regular expression pattern.
+
+
+
+ This assertion will fail if the string is null.
+
+
+ Thrown if the verification failed unless the current
+ Thrown if
+
+
+
+ Verifies that a string contains a full or partial match of a regular expression pattern.
+
+
+
+ This assertion will fail if the string is null.
+
+
+ Thrown if the verification failed unless the current
+ Thrown if
+
+
+
+ Verifies that a string does not contain a full or partial match of a regular expression pattern.
+
+
+
+ This assertion will fail if the string is null.
+
+
+ Thrown if the verification failed unless the current
+ Thrown if
+
+
+
+ Verifies that a string does not contain a full or partial match of a regular expression pattern.
+
+
+
+ This assertion will fail if the string is null.
+
+
+ Thrown if the verification failed unless the current
+ Thrown if
+
+
+
+ Verifies that a string does not contain a full or partial match of a regular expression pattern.
+
+
+
+ This assertion will fail if the string is null.
+
+
+ Thrown if the verification failed unless the current
+ Thrown if
+
+
+
+ Verifies that a string does not contain a full or partial match of a regular expression pattern.
+
+
+
+ This assertion will fail if the string is null.
+
+
+ Thrown if the verification failed unless the current
+ Thrown if
+
+
+
+ Verifies that a string does not contain a full or partial match of a regular expression pattern.
+
+
+
+ This assertion will fail if the string is null.
+
+
+ Thrown if the verification failed unless the current
+ Thrown if
+
+
+
+ Verifies that a string does not contain a full or partial match of a regular expression pattern.
+
+
+
+ This assertion will fail if the string is null.
+
+
+ Thrown if the verification failed unless the current
+ Thrown if
+
+
+
+ Verifies that a string starts with the specified text.
+
+
+
+ This assertion will fail if the string is null.
+
+
+ Thrown if the verification failed unless the current
+ Thrown if
+
+
+
+ Verifies that a string starts with the specified text.
+
+
+
+ This assertion will fail if the string is null.
+
+
+ Thrown if the verification failed unless the current
+ Thrown if
+
+
+
+ Verifies that a string ends with the specified text.
+
+
+
+ This assertion will fail if the string is null.
+
+
+ Thrown if the verification failed unless the current
+ Thrown if
+
+
+
+ Verifies that a string ends with the specified text.
+
+
+
+ This assertion will fail if the string is null.
+
+
+ Thrown if the verification failed unless the current
+ Thrown if
+
+
+
+ Verifies that expected and actual sequences have the same number of elements and
+ that the elements are equal and in the same order.
+
+ The type of value.
+ Thrown if the verification failed unless the current
+
+
+
+ Verifies that expected and actual sequences have the same number of elements and
+ that the elements are equal and in the same order.
+
+ The type of value.
+ Thrown if the verification failed unless the current
+
+
+
+ Verifies that expected and actual sequences have the same number of elements and
+ that the elements are equal and in the same order.
+
+ The type of value.
+ Thrown if the verification failed unless the current
+
+
+
+ Verifies that expected and actual sequences have the same number of elements and
+ that the elements are equal and in the same order.
+
+ The type of value.
+ Thrown if the verification failed unless the current
+
+
+
+ Verifies that expected and actual sequences have the same number of elements and
+ that the elements are equal and in the same order.
+
+ The type of value.
+ Thrown if the verification failed unless the current
+
+
+
+ Verifies that expected and actual sequences have the same number of elements and
+ that the elements are equal and in the same order.
+
+ The type of value.
+ Thrown if the verification failed unless the current
+
+
+
+ Verifies that unexpected and actual sequences differ in at least one element.
+
+ The type of value.
+ Thrown if the verification failed unless the current
+
+
+
+ Verifies that unexpected and actual sequences differ in at least one element.
+
+ The type of value.
+ Thrown if the verification failed unless the current
+
+
+
+ Verifies that unexpected and actual sequences differ in at least one element.
+
+ The type of value.
+ Thrown if the verification failed unless the current
+
+
+
+ Verifies that unexpected and actual sequences differ in at least one element.
+
+ The type of value.
+ Thrown if the verification failed unless the current
+ Thrown if the verification failed unless the current
+
+
+
+ Verifies that unexpected and actual sequences differ in at least one element.
+
+ The type of value.
+ Thrown if the verification failed unless the current
+
+
+
+ Verifies that unexpected and actual sequences differ in at least one element.
+
+ The type of value.
+ Thrown if the verification failed unless the current
+
+
+
+ Verifies that expected and actual sequences have the same number of elements and
+ that the elements are equal but perhaps in a different order.
+
+ The type of value.
+ Thrown if the verification failed unless the current
+
+
+
+ Verifies that expected and actual sequences have the same number of elements and
+ that the elements are equal but perhaps in a different order.
+
+ The type of value.
+ Thrown if the verification failed unless the current
+
+
+
+ Verifies that expected and actual sequences have the same number of elements and
+ that the elements are equal but perhaps in a different order.
+
+ The type of value.
+ Thrown if the verification failed unless the current
+
+
+
+ Verifies that expected and actual sequences have the same number of elements and
+ that the elements are equal but perhaps in a different order.
+
+ The type of value.
+ Thrown if the verification failed unless the current
+
+
+
+ Verifies that expected and actual sequences have the same number of elements and
+ that the elements are equal but perhaps in a different order.
+
+ The type of value.
+ Thrown if the verification failed unless the current
+
+
+
+ Verifies that expected and actual sequences have the same number of elements and
+ that the elements are equal but perhaps in a different order.
+
+ The type of value.
+ Thrown if the verification failed unless the current
+
+
+
+ Verifies that expected and actual sequences have the same number of elements and
+ that the elements are referentially equal and in the same order.
+
+ The type of value.
+ Thrown if the verification failed unless the current
+
+
+
+ Verifies that expected and actual sequences have the same number of elements and
+ that the elements are referentially equal and in the same order.
+
+ The type of value.
+ Thrown if the verification failed unless the current
+
+
+
+ Verifies that unexpected and actual sequences differ in at least one element.
+
+ The type of value.
+ Thrown if the verification failed unless the current
+
+
+
+ Verifies that unexpected and actual sequences differ in at least one element.
+
+ The type of value.
+ Thrown if the verification failed unless the current
+
+
+
+ Verifies that expected and actual sequences have the same number of elements and
+ that the elements are referentially equal but perhaps in a different order.
+
+ The type of value.
+ Thrown if the verification failed unless the current
+
+
+
+ Verifies that expected and actual sequences have the same number of elements and
+ that the elements are referentially equal but perhaps in a different order.
+
+ The type of value.
+ Thrown if the verification failed unless the current
+
+
+
+ Verifies that
+ The type of value.
+ Thrown if the verification failed unless the current
+
+
+
+ Verifies that
+ The type of value.
+ Thrown if the verification failed unless the current
+
+
+
+ Verifies that
+ The type of key.
+ The type of value.
+ Thrown if the verification failed unless the current
+
+
+
+ Verifies that
+ The type of key.
+ The type of value.
+ Thrown if the verification failed unless the current
+
+
+
+ Verifies that
+ The type of value.
+ Thrown if the verification failed unless the current
+
+
+
+ Verifies that
+ The type of value.
+ Thrown if the verification failed unless the current
+
+
+
+ Verifies that
+ The type of key.
+ The type of value.
+ Thrown if the verification failed unless the current
+
+
+
+ Verifies that
+ The type of key.
+ The type of value.
+ Thrown if the verification failed unless the current
+
+
+
+ Verifies that an actual value contains no elements.
+
+ Thrown if the verification failed unless the current
+
+
+
+ Verifies that an actual value contains no elements.
+
+ Thrown if the verification failed unless the current
+
+
+
+ Verifies that an actual value contains at least one element.
+
+ Thrown if the verification failed unless the current
+
+
+
+ Verifies that an actual value contains at least one element.
+
+ Thrown if the verification failed unless the current
+
+
+
+ Verifies that all the elements of the sequence meet the specified condition.
+
+ The type of values in the sequence.
+ true ) by all the elements of the sequence.
+ Thrown if the verification failed unless the current
+
+
+
+ Verifies that all the elements of the sequence meet the specified condition.
+
+ The type of values in the sequence.
+ true ) by all the elements of the sequence.
+ Thrown if the verification failed unless the current
+
+
+
+ Verifies that at least one element of the sequence meets the specified condition.
+
+ The type of values in the sequence.
+ true ) by at least one element of the sequence.
+ Thrown if the verification failed unless the current
+
+
+
+ Verifies that at least one element of the sequence meets the specified condition.
+
+ The type of values in the sequence.
+ true ) by at least one element of the sequence.
+ Thrown if the verification failed unless the current
+
+
+
+ Verifies that an actual value equals some expected value.
+
+ The type of value.
+ Thrown if the verification failed unless the current
+
+
+
+
+ Verifies that an actual value equals some expected value.
+
+ The type of value.
+ Thrown if the verification failed unless the current
+
+
+
+ Verifies that an actual value equals some expected value according to a particular comparer.
+
+ The type of value.
+ Thrown if the verification failed unless the current
+
+
+
+ Verifies that an actual value equals some expected value according to a particular comparer.
+
+ The type of value.
+ Thrown if the verification failed unless the current
+
+
+
+ Verifies that an actual value equals some expected value according to a particular comparer.
+
+ The type of value.
+ Thrown if the verification failed unless the current
+
+
+
+ Verifies that an actual value equals some expected value according to a particular comparer.
+
+ The type of value.
+ Thrown if the verification failed unless the current
+
+
+
+ Verifies that an actual value does not equal some unexpected value.
+
+ The type of value.
+ Thrown if the verification failed unless the current
+
+
+
+ Verifies that an actual value does not equal some unexpected value.
+
+ The type of value.
+ Thrown if the verification failed unless the current
+
+
+
+ Verifies that an actual value does not equal some unexpected value according to a particular comparer.
+
+ The type of value.
+ Thrown if the verification failed unless the current
+
+
+
+ Verifies that an actual value does not equal some unexpected value according to a particular comparer.
+
+ The type of value.
+ Thrown if the verification failed unless the current
+
+
+
+ Verifies that an actual value does not equal some unexpected value according to a particular comparer.
+
+ The type of value.
+ Thrown if the verification failed unless the current
+
+
+
+ Verifies that an actual value does not equal some unexpected value according to a particular comparer.
+
+ The type of value.
+ Thrown if the verification failed unless the current
+
+
+
+ Verifies that an actual value is referentially identical to some expected value.
+
+ The type of value.
+ Thrown if the verification failed unless the current
+
+
+
+ Verifies that an actual value is referentially identical to some expected value.
+
+ The type of value.
+ Thrown if the verification failed unless the current
+
+
+
+ Verifies that an actual value is not referentially identical to some unexpected value.
+
+ The type of value.
+ Thrown if the verification failed unless the current
+
+
+
+ Verifies that an actual value is not referentially identical to some unexpected value.
+
+ The type of value.
+ Thrown if the verification failed unless the current
+
+
+
+ Verifies that an actual value is true.
+
+ Thrown if the verification failed unless the current
+
+
+
+ Verifies that an actual value is true.
+
+ Thrown if the verification failed unless the current
+
+
+
+ Verifies that an actual value is false.
+
+ Thrown if the verification failed unless the current
+
+
+
+ Verifies that an actual value is false.
+
+ Thrown if the verification failed unless the current
+
+
+
+ Verifies that an actual value is null.
+
+ Thrown if the verification failed unless the current
+
+
+
+ Verifies that an actual value is null.
+
+ Thrown if the verification failed unless the current
+
+
+
+ Verifies that an actual value is not null.
+
+ Thrown if the verification failed unless the current
+
+
+
+ Verifies that an actual value is not null.
+
+ Thrown if the verification failed unless the current
+
+
+
+ Verifies that an actual value approximately equals some expected value
+ to within a specified delta.
+
+
+
+ The values are considered approximately equal if the absolute value of their difference
+ is less than or equal to the delta.
+
+
+ This method works with any comparable type that also supports a subtraction operator
+ including
+
+ The type of values to be compared.
+ The type of the difference produced when the values are
+ subtracted, for numeric types this is the same as
+ Thrown if the verification failed unless the current
+
+
+
+ Verifies that an actual value approximately equals some expected value
+ to within a specified delta.
+
+
+
+ The values are considered approximately equal if the absolute value of their difference
+ is less than or equal to the delta.
+
+
+ This method works with any comparable type that also supports a subtraction operator
+ including
+
+ The type of values to be compared.
+ The type of the difference produced when the values are
+ subtracted, for numeric types this is the same as
+ Thrown if the verification failed unless the current
+
+
+
+ Verifies that an actual value does not approximately equal some unexpected value
+ to within a specified delta.
+
+
+
+ The values are considered approximately equal if the absolute value of their difference
+ is less than or equal to the delta.
+
+
+ This method works with any comparable type that also supports a subtraction operator
+ including
+
+ The type of values to be compared.
+ The type of the difference produced when the values are
+ subtracted, for numeric types this is the same as
+ Thrown if the verification failed unless the current
+
+
+
+ Verifies that an actual value does not approximately equal some unexpected value
+ to within a specified delta.
+
+
+
+ The values are considered approximately equal if the absolute value of their difference
+ is less than or equal to the delta.
+
+
+ This method works with any comparable type that also supports a subtraction operator
+ including
+
+ The type of values to be compared.
+ The type of the difference produced when the values are
+ subtracted, for numeric types this is the same as
+ Thrown if the verification failed unless the current
+
+
+
+ Verifies that a block of code throws an exception of a particular type.
+
+
+
+ If the block of code throws a subtype of the expected exception type then
+ this method will still succeed.
+
+
+ This method returns the exception that was caught. To verify additional
+ properties of the exception, such as the exception message, follow up this
+ assertion with additional ones that verify these properties of the exception object
+ that was returned.
+
+
+ The expected type of exception.
+ The exception that was thrown.
+ Thrown if
+ Thrown if the verification failed unless the current
+
+
+
+ Verifies that a block of code throws an exception of a particular type; and that
+ the exception has an inner exception of a particular type.
+
+
+
+ If the block of code throws a subtype of the expected exception types then
+ this method will still succeed.
+
+
+ This method returns the exception that was caught. To verify additional
+ properties of the exception, such as the exception message, follow up this
+ assertion with additional ones that verify these properties of the exception object
+ that was returned.
+
+
+ The expected type of exception.
+ The expected type of the inner exception.
+ The exception that was thrown.
+ Thrown if
+ Thrown if the verification failed unless the current
+
+
+
+ Verifies that a block of code throws an exception of a particular type.
+
+
+
+ If the block of code throws a subtype of the expected exception type then
+ this method will still succeed.
+
+
+ This method returns the exception that was caught. To verify additional
+ properties of the exception, such as the exception message, follow up this
+ assertion with additional ones that verify these properties of the exception object
+ that was returned.
+
+
+ The expected type of exception.
+ The exception that was thrown.
+ Thrown if
+ Thrown if the verification failed unless the current
+
+
+
+ Verifies that a block of code throws an exception of a particular type; and that
+ the exception has an inner exception of a particular type.
+
+
+
+ If the block of code throws a subtype of the expected exception types then
+ this method will still succeed.
+
+
+ This method returns the exception that was caught. To verify additional
+ properties of the exception, such as the exception message, follow up this
+ assertion with additional ones that verify these properties of the exception object
+ that was returned.
+
+
+ The expected type of the exception.
+ The expected type of the inner exception.
+ The exception that was thrown.
+ Thrown if
+ Thrown if the verification failed unless the current
+
+
+
+ Verifies that a block of code throws an exception of a particular type.
+
+
+
+ If the block of code throws a subtype of the expected exception type then
+ this method will still succeed.
+
+
+ This method returns the exception that was caught. To verify additional
+ properties of the exception, such as the exception message, follow up this
+ assertion with additional ones that verify these properties of the exception object
+ that was returned.
+
+
+ The exception that was thrown.
+ Thrown if
+ Thrown if the verification failed unless the current
+
+
+
+ Verifies that a block of code throws an exception of a particular type; and that
+ the exception has an inner exception of a particular type.
+
+
+
+ If the block of code throws a subtype of the expected exception types then
+ this method will still succeed.
+
+
+ This method returns the exception that was caught. To verify additional
+ properties of the exception, such as the exception message, follow up this
+ assertion with additional ones that verify these properties of the exception object
+ that was returned.
+
+
+ The exception that was thrown.
+ Thrown if
+ Thrown if the verification failed unless the current
+
+
+
+ Verifies that a block of code throws an exception of a particular type.
+
+
+
+ If the block of code throws a subtype of the expected exception type then
+ this method will still succeed.
+
+
+ This method returns the exception that was caught. To verify additional
+ properties of the exception, such as the exception message, follow up this
+ assertion with additional ones that verify these properties of the exception object
+ that was returned.
+
+
+ The exception that was thrown.
+ Thrown if
+ Thrown if the verification failed unless the current
+
+
+
+ Verifies that a block of code throws an exception of a particular type; and that
+ the exception has an inner exception of a particular type.
+
+
+
+ If the block of code throws a subtype of the expected exception types then
+ this method will still succeed.
+
+
+ This method returns the exception that was caught. To verify additional
+ properties of the exception, such as the exception message, follow up this
+ assertion with additional ones that verify these properties of the exception object
+ that was returned.
+
+
+ The exception that was thrown.
+ Thrown if
+ Thrown if the verification failed unless the current
+
+
+
+ Verifies that a block of code does not throw an exception of any type.
+
+
+
+ The purpose of this assertion is to improve the readability of tests
+ that only verify that an exception was not thrown. Using this assertion
+ makes a positive and explicit statement that not throwing an exception
+ is itself the primary behavior that is being verified.
+
+
+ Thrown if
+ Thrown if the verification failed unless the current
+
+
+
+ Verifies that a block of code does not throw an exception of any type.
+
+
+
+ The purpose of this assertion is to improve the readability of tests
+ that only verify that an exception was not thrown. Using this assertion
+ makes a positive and explicit statement that not throwing an exception
+ is itself the primary behavior that is being verified.
+
+
+ Thrown if
+ Thrown if the verification failed unless the current
+
+
+
+ Verifies that a type may be assigned to a variable of the specified type.
+
+
+
+ This assertion will fail if
+
+ Thrown if
+
+
+
+ Verifies that a type may be assigned to a variable of the specified type.
+
+
+
+ This assertion will fail if
+
+ Thrown if
+
+
+
+ Verifies that a type may be assigned to a variable of the specified type.
+
+
+
+ This assertion will fail if
+
+ The Type to compare with the object's Type.
+ Thrown if
+
+
+
+ Verifies that a type may be assigned to a variable of the specified type.
+
+
+
+ This assertion will fail if
+
+ The Type to compare with the object's Type.
+ Thrown if
+
+
+
+ Verifies that a Type may not be assigned to a variable of the specified type.
+
+
+
+ This assertion will fail if
+
+ Thrown if
+
+
+
+ Verifies that a Type may not be assigned to a variable of the specified type.
+
+
+
+ This assertion will fail if
+
+ Thrown if
+
+
+
+ Verifies that a Type may not be assigned to a variable of the specified type.
+
+
+
+ This assertion will fail if
+
+ The Type to compare with the object's Type.
+
+
+
+ Verifies that a Type may not be assigned to a variable of the specified type.
+
+
+
+ This assertion will fail if
+
+ The Type to compare with the object's Type.
+
+
+
+ Verifies that an actual value is an instance of some expected type.
+
+
+
+ This assertion will fail if the object is null.
+
+
+ Thrown if the verification failed unless the current
+ Thrown if
+
+
+
+ Verifies that an actual value is an instance of some expected type.
+
+
+
+ This assertion will fail if the object is null.
+
+
+ Thrown if the verification failed unless the current
+ Thrown if
+
+
+
+ Verifies that an actual value is an instance of some expected type.
+
+
+
+ This assertion will fail if the object is null.
+
+
+ The expected type.
+ Thrown if the verification failed unless the current
+
+
+
+ Verifies that an actual value is an instance of some expected type.
+
+
+
+ This assertion will fail if the object is null.
+
+
+ The expected type.
+ Thrown if the verification failed unless the current
+
+
+
+ Verifies that an actual value is not an instance of some unexpected type.
+
+
+
+ This assertion will fail if the object is null.
+
+
+ Thrown if the verification failed unless the current
+ Thrown if
+
+
+
+ Verifies that an actual value is not an instance of some unexpected type.
+
+
+
+ This assertion will fail if the object is null.
+
+
+ Thrown if the verification failed unless the current
+ Thrown if
+
+
+
+ Verifies that an actual value is not an instance of some unexpected type.
+
+
+
+ This assertion will fail if the object is null.
+
+
+ The unexpected type.
+ Thrown if the verification failed unless the current
+
+
+
+ Verifies that an actual value is not an instance of some unexpected type.
+
+
+
+ This assertion will fail if the object is null.
+
+
+ The unexpected type.
+ Thrown if the verification failed unless the current
+
+
+
+ Verifies that the left value is greater than the right value according to a particular comparer.
+
+ The type of value.
+
+
+
+ Verifies that the left value is greater than the right value according to a particular comparer.
+
+ The type of value.
+ Thrown if the verification failed unless the current
+
+
+
+ Verifies that the left value is greater than the right value according to a particular comparer.
+
+ The type of value.
+ Thrown if the verification failed unless the current
+
+
+
+ Verifies that the left value is greater than the right value according to a particular comparer.
+
+ The type of value.
+ Thrown if the verification failed unless the current
+
+
+
+ Verifies that the left value is greater than the right value according to a particular comparer.
+
+ The type of value.
+ Thrown if the verification failed unless the current
+
+
+
+ Verifies that the left value is greater than the right value according to a particular comparer.
+
+ The type of value.
+ Thrown if the verification failed unless the current
+
+
+
+ Verifies that the left value is greater than or equal to the right value according to a particular comparer.
+
+ The type of value.
+
+
+
+ Verifies that the left value is greater than or equal to the right value according to a particular comparer.
+
+ The type of value.
+ Thrown if the verification failed unless the current
+
+
+
+ Verifies that the left value is greater than or equal to the right value according to a particular comparer.
+
+ The type of value.
+ Thrown if the verification failed unless the current
+
+
+
+ Verifies that the left value is greater than or equal to the right value according to a particular comparer.
+
+ The type of value.
+ Thrown if the verification failed unless the current
+
+
+
+ Verifies that the left value is greater than or equal to the right value according to a particular comparer.
+
+ The type of value.
+ Thrown if the verification failed unless the current
+
+
+
+ Verifies that the left value is greater or equal than right value according to a particular comparer.
+
+ The type of value.
+ Thrown if the verification failed unless the current
+
+
+
+ Verifies that the left value is less than the right value according to a particular comparer.
+
+ The type of value.
+
+
+
+ Verifies that the left value is less than the right value according to a particular comparer.
+
+ The type of value.
+ Thrown if the verification failed unless the current
+
+
+
+ Verifies that the left value is less than the right value according to a particular comparer.
+
+ The type of value.
+ Thrown if the verification failed unless the current
+
+
+
+ Verifies that the left value is less than the right value according to a particular comparer.
+
+ The type of value.
+ Thrown if the verification failed unless the current
+
+
+
+ Verifies that the left value is less than the right value according to a particular comparer.
+
+ The type of value.
+ Thrown if the verification failed unless the current
+
+
+
+ Verifies that the left value is less than the right value according to a particular comparer.
+
+ The type of value.
+ Thrown if the verification failed unless the current
+
+
+
+ Verifies that the left value is less than or equal to the right value according to a particular comparer.
+
+ The type of value.
+
+
+
+ Verifies that the left value is less than or equal to the right value according to a particular comparer.
+
+ The type of value.
+ Thrown if the verification failed unless the current
+
+
+
+ Verifies that the left value is less than or equal to the right value according to a particular comparer.
+
+ The type of value.
+ Thrown if the verification failed unless the current
+
+
+
+ Verifies that the left value is less than or equal to the right value according to a particular comparer.
+
+ The type of value.
+ Thrown if the verification failed unless the current
+
+
+
+ Verifies that the left value is less than or equal to the right value according to a particular comparer.
+
+ The type of value.
+ Thrown if the verification failed unless the current
+
+
+
+ Verifies that the left value is less than or equal to the right value according to a particular comparer.
+
+ The type of value.
+ Thrown if the verification failed unless the current
+
+
+
+ Verifies that a test value is between left and right values according to a particular comparer.
+
+ The type of value.
+
+
+
+ Verifies that a test value is between left and right values according to a particular comparer.
+
+ The type of value.
+ Thrown if the verification failed unless the current
+
+
+
+ Verifies that a test value is between left and right values according to a particular comparer.
+
+ The type of value.
+ Thrown if the verification failed unless the current
+
+
+
+ Verifies that a test value is between left and right values according to a particular comparer.
+
+ The type of value.
+ Thrown if the verification failed unless the current
+
+
+
+ Verifies that a test value is between left and right values according to a particular comparer.
+
+ The type of value.
+ Thrown if the verification failed unless the current
+
+
+
+ Verifies that a test value is between left and right values according to a particular comparer.
+
+ The type of value.
+ Thrown if the verification failed unless the current
+
+
+
+ Verifies that a test value is not between left and right values according to a particular comparer.
+
+ The type of value.
+
+
+
+ Verifies that a test value is not between left and right values according to a particular comparer.
+
+ The type of value.
+ Thrown if the verification failed unless the current
+
+
+
+ Verifies that a test value is not between left and right values according to a particular comparer.
+
+ The type of value.
+ Thrown if the verification failed unless the current
+
+
+
+ Verifies that a test value is not between left and right values according to a particular comparer.
+
+ The type of value.
+ Thrown if the verification failed unless the current
+
+
+
+ Verifies that a test value is not between left and right values according to a particular comparer.
+
+ The type of value.
+ Thrown if the verification failed unless the current
+
+
+
+ Verifies that a test value is not between left and right values according to a particular comparer.
+
+ The type of value.
+ Thrown if the verification failed unless the current
+
+
+
+ Verifies that a type supports the runtime serialization protocol.
+
+
+
+ Ensures that the type has the
+
+ Thrown if the verification failed unless the current
+ Thrown if
+
+
+
+ Verifies that a type supports the runtime serialization protocol.
+
+
+
+ Ensures that the type has the
+
+ Thrown if the verification failed unless the current
+ Thrown if
+
+
+
+ Verifies that an object can be serialized to a stream using the specified
+
+
+ The assertion fails if
+
+ The serialized stream.
+ Thrown if
+ Thrown if the verification failed unless the current
+
+
+
+ Verifies that an object can be serialized to a stream using the specified
+
+
+ The assertion fails if
+
+ The serialized stream.
+ Thrown if
+ Thrown if the verification failed unless the current
+
+
+
+ Verifies that an object can be deserialized from a stream using the
+ specified
+
+
+ The assertion fails if
+
+ The deserialized object.
+ Thrown if
+ Thrown if the verification failed unless the current
+
+
+
+ Verifies that an object can be deserialized from a stream using the specified
+
+
+
+ The assertion fails if
+
+ The deserialized object.
+ Thrown if
+ Thrown if the verification failed unless the current
+
+
+
+ Verifies that an object can be serialized then deserialized to and from a stream using the
+ specified
+
+
+ The assertion fails if
+
+ The serialized then deserialized object.
+ Thrown if
+ Thrown if the verification failed unless the current
+
+
+
+ Verifies that an object can be serialized and deserialized to and from a stream using the
+ specified
+
+
+ The assertion fails if
+
+ The serialized then deserialized object.
+ Thrown if
+ Thrown if the verification failed unless the current
+
+
+
+ Verifies that an object can be serialized to a stream using a
+
+
+ The assertion fails if
+
+ The serialized stream.
+ Thrown if the verification failed unless the current
+
+
+
+ Verifies that an object can be serialized to a stream using a
+
+
+ The assertion fails if
+
+ The serialized stream.
+ Thrown if the verification failed unless the current
+
+
+
+ Verifies that an object can be deserialized from a stream using a
+
+
+
+ The assertion fails if
+
+ The deserialized object.
+ Thrown if the verification failed unless the current
+
+
+
+ Verifies that an object can be deserialized from a stream using a
+
+
+
+ The assertion fails if
+
+ The deserialized object.
+ Thrown if the verification failed unless the current
+
+
+
+ Verifies that an object can be serialized then deserialized to and from a stream using a
+
+
+
+ The assertion fails if
+
+ The serialized then deserialized object.
+ Thrown if the verification failed unless the current
+
+
+
+ Verifies that an object can be serialized and deserialized to and from a stream using a
+
+
+
+ The assertion fails if
+
+ The serialized then deserialized object.
+ Thrown if the verification failed unless the current
+
+
+
+ Verifies that a type supports the Xml serialization protocol used by
+
+
+ Ensures that an
+
+ Thrown if the verification failed unless the current
+ Thrown if
+
+
+
+ Verifies that a type supports the Xml serialization protocol used by
+
+
+ Ensures that an
+
+ Thrown if the verification failed unless the current
+ Thrown if
+
+
+
+ Verifies that an object can be serialized to Xml using an
+
+
+
+ The assertion fails if
+
+ The serialized Xml.
+ Thrown if the verification failed unless the current
+
+
+
+ Verifies that an object can be serialized to Xml using
+ an
+
+
+ The assertion fails if
+
+ The serialized Xml.
+ Thrown if the verification failed unless the current
+
+
+
+ Verifies that an object can be deserialized from Xml using
+ an
+
+
+ The assertion fails if
+
+ The deserialized object.
+ Thrown if the verification failed unless the current
+
+
+
+ Verifies that an object can be deserialized from Xml using
+ an
+
+
+ The assertion fails if
+
+ The deserialized object.
+ Thrown if the verification failed unless the current
+
+
+
+ Verifies that an object can be serialized then deserialized to and from Xml using
+ an
+
+
+ The assertion fails if
+
+ The serialized then deserialized object.
+ Thrown if the verification failed unless the current
+
+
+
+ Verifies that an object can be serialized then deserialized to and from Xml using
+ an
+
+
+ The assertion fails if
+
+ The serialized then deserialized object.
+ Thrown if the verification failed unless the current
+
+
+
+ Verifies that the sequence of values are sorted in the specified order.
+
+ The type of value.
+ Thrown if the verification failed unless the current
+
+
+
+ Verifies that the sequence of values are sorted in the specified order.
+
+ The type of value.
+ Thrown if the verification failed unless the current
+
+
+
+ Verifies that the sequence of values are sorted in the specified order.
+
+ The type of value.
+ Thrown if the verification failed unless the current
+
+
+
+ Verifies that the sequence of values are sorted in the specified order.
+
+ The type of value.
+ Thrown if the verification failed unless the current
+
+
+
+ Verifies that the sequence of values are sorted in the specified order.
+
+ The type of value.
+ Thrown if the verification failed unless the current
+
+
+
+ Verifies that the sequence of values are sorted in the specified order.
+
+ The type of value.
+ Thrown if the verification failed unless the current
+
+
+
+ Verifies that the sequence of objects contains distinct values.
+
+ The type of value.
+ Thrown if the verification failed unless the current
+
+
+
+ Verifies that the sequence of objects contains distinct values.
+
+ The type of value.
+ Thrown if the verification failed unless the current
+
+
+
+ Verifies that the sequence of objects contains distinct values.
+
+ The type of value.
+ Thrown if the verification failed unless the current
+
+
+
+ Verifies that the sequence of objects contains distinct values.
+
+ The type of value.
+ Thrown if the verification failed unless the current
+
+
+
+ Verifies that the sequence of objects contains distinct values.
+
+ The type of value.
+ Thrown if the verification failed unless the current
+
+
+
+ Verifies that the sequence of objects contains distinct values.
+
+ The type of value.
+ Thrown if the verification failed unless the current
+
+
+
+ Provides methods for composing assertions to map over complex data structures.
+
+
+
+
+ Returns true if there is a pending unreported assertion failure.
+
+
+
+ This property is used in conjuction with the
+
+
+
+
+ Assertions for XML data.
+
+
+
+
+ Asserts that two XML fragments have the same content.
+
+ Thrown if the verification failed unless the current
+ Thrown if
+
+
+
+ Asserts that two XML fragments have the same content.
+
+ Thrown if the verification failed unless the current
+ Thrown if
+
+
+
+ Asserts that two XML fragments have the same content.
+
+ Thrown if the verification failed unless the current
+ Thrown if
+
+
+
+ Asserts that two XML fragments have the same content.
+
+ Thrown if the verification failed unless the current
+ Thrown if
+
+
+
+ Asserts that two XML fragments have the same content.
+
+ Thrown if the verification failed unless the current
+ Thrown if
+
+
+
+ Asserts that two XML fragments have the same content.
+
+ Thrown if the verification failed unless the current
+ Thrown if
+
+
+
+ Asserts that two XML fragments have the same content.
+
+ Thrown if the verification failed unless the current
+ Thrown if
+
+
+
+ Asserts that two XML fragments have the same content.
+
+ Thrown if the verification failed unless the current
+ Thrown if
+
+
+
+ Asserts that the XML fragment contains the searched element or attribute.
+
+ Thrown if the verification failed unless the current
+ Thrown if
+
+
+ Options not related to the name case of elements and attributes are going to be ignored.
+
+
+ The path specified in
+
+ Assuming the following XML fragment exits:
+
+
+
+
+
+ ]]>
+
+ The following path would be valid:
+
+
+
+
+
+
+ Asserts that the XML fragment contains the searched element or attribute.
+
+
+
+ Options not related to the name case of elements and attributes are going to be ignored.
+
+
+ The path specified in
+
+ Assuming the following XML fragment exits:
+
+
+
+
+
+ ]]>
+
+ The following path would be valid:
+
+
+
+ Thrown if the verification failed unless the current
+ Thrown if
+
+
+
+ Asserts that the XML fragment contains the searched element or attribute.
+
+
+
+ The path specified in
+
+ Assuming the following XML fragment exits:
+
+
+
+
+
+ ]]>
+
+ The following path would be valid:
+
+
+
+ Thrown if the verification failed unless the current
+ Thrown if
+
+
+
+ Asserts that the XML fragment contains the searched element or attribute.
+
+
+
+ Options not related to the name case of elements and attributes are going to be ignored.
+
+
+ The path specified in
+
+ Assuming the following XML fragment exits:
+
+
+
+
+
+ ]]>
+
+ The following path would be valid:
+
+
+
+ Thrown if the verification failed unless the current
+ Thrown if
+
+
+
+ Asserts that the XML fragment contains the searched element or attribute.
+
+
+
+ Options not related to the name case of elements and attributes are going to be ignored.
+
+
+ The path specified in
+
+ Assuming the following XML fragment exits:
+
+
+
+
+
+ ]]>
+
+ The following path would be valid:
+
+
+
+ Thrown if the verification failed unless the current
+ Thrown if
+
+
+
+ Asserts that the XML fragment contains the searched element or attribute, and that it has the expected value.
+
+
+
+ If null , the assertion behaves like
+
+ The path specified in
+
+ Assuming the following XML fragment exits:
+
+
+
+
+
+ ]]>
+
+ The following path would be valid:
+
+
+
+ Thrown if the verification failed unless the current
+ Thrown if
+
+
+
+ Asserts that the XML fragment contains the searched element or attribute, and that it has the expected value.
+
+
+
+ If null , the assertion behaves like
+
+ The path specified in
+
+ Assuming the following XML fragment exits:
+
+
+
+
+
+ ]]>
+
+ The following path would be valid:
+
+
+
+ Thrown if the verification failed unless the current
+ Thrown if
+
+
+
+ Asserts that the XML fragment contains the searched element or attribute, and that it has the expected value.
+
+
+
+ If null , the assertion behaves like
+
+ The path specified in
+
+ Assuming the following XML fragment exits:
+
+
+
+
+
+ ]]>
+
+ The following path would be valid:
+
+
+
+ Thrown if the verification failed unless the current
+ Thrown if
+
+
+
+
+
+ Asserts that the XML fragment contains the searched element or attribute.
+
+
+
+ Options not related to the name case of elements and attributes are going to be ignored.
+
+
+ Thrown if the verification failed unless the current
+ Thrown if
+
+
+
+ Asserts that the XML fragment contains the searched element or attribute.
+
+
+
+ Options not related to the name case of elements and attributes are going to be ignored.
+
+
+ Thrown if the verification failed unless the current
+ Thrown if
+
+
+
+ Asserts that the XML fragment contains the searched element or attribute.
+
+ Thrown if
+
+
+ Options not related to the name case of elements and attributes are going to be ignored.
+
+
+ Thrown if the verification failed unless the current
+
+
+
+ Asserts that the XML fragment contains the searched element or attribute.
+
+ Thrown if the verification failed unless the current
+ Thrown if
+
+
+ Options not related to the name case of elements and attributes are going to be ignored.
+
+
+
+
+
+ Asserts that the XML fragment contains the searched element or attribute, and that it has the expected value.
+
+ Thrown if the verification failed unless the current
+ Thrown if
+
+
+ If null , the assertion behaves like
+
+
+
+
+ Asserts that the XML fragment contains the searched element or attribute, and that it has the expected value.
+
+ Thrown if the verification failed unless the current
+ Thrown if
+
+
+ If null , the assertion behaves like
+
+
+
+
+ Asserts that the XML fragment contains the searched element or attribute, and that it has the expected value.
+
+ Thrown if the verification failed unless the current
+ Thrown if
+
+
+ If null , the assertion behaves like
+
+
+
+
+ Asserts that the XML fragment contains the searched element or attribute, and that it has the expected value.
+
+ Thrown if the verification failed unless the current
+ Thrown if
+
+
+ If null , the assertion behaves like
+
+
+
+
+ Asserts that the XML fragment contains the searched element or attribute, and that this element or attribute is unique in the entire fragment.
+
+
+
+ The path specified in
+
+ Assuming the following XML fragment exits:
+
+
+
+
+
+ ]]>
+
+ The following path would be valid:
+
+
+
+ Thrown if the verification failed unless the current
+ Thrown if
+
+
+ Options not related to the name case of elements and attributes are going to be ignored.
+
+
+
+
+
+ Asserts that the XML fragment contains the searched element or attribute, and that this element or attribute is unique in the entire fragment.
+
+
+ Options not related to the name case of elements and attributes are going to be ignored.
+
+
+
+ The path specified in
+
+ Assuming the following XML fragment exits:
+
+
+
+
+
+ ]]>
+
+ The following path would be valid:
+
+
+
+ Thrown if the verification failed unless the current
+ Thrown if
+
+
+
+ Asserts that the XML fragment contains the searched element or attribute, and that this element or attribute is unique in the entire fragment.
+
+
+
+ Options not related to the name case of elements and attributes are going to be ignored.
+
+
+ The path specified in
+
+ Assuming the following XML fragment exits:
+
+
+
+
+
+ ]]>
+
+ The following path would be valid:
+
+
+
+ Thrown if the verification failed unless the current
+ Thrown if
+
+
+
+ Asserts that the XML fragment contains the searched element or attribute, and that this element or attribute is unique in the entire fragment.
+
+
+
+ Options not related to the name case of elements and attributes are going to be ignored.
+
+
+ The path specified in
+
+ Assuming the following XML fragment exits:
+
+
+
+
+
+ ]]>
+
+ The following path would be valid:
+
+
+
+ Thrown if the verification failed unless the current
+ Thrown if
+
+
+
+ Asserts that the XML fragment contains the searched element or attribute, that it has the expected value, and that this element or attribute is unique in the entire fragment.
+
+
+
+ If null , the assertion behaves like
+
+ The path specified in
+
+ Assuming the following XML fragment exits:
+
+
+
+
+
+ ]]>
+
+ The following path would be valid:
+
+
+
+ Thrown if the verification failed unless the current
+ Thrown if
+
+
+
+ Asserts that the XML fragment contains the searched element or attribute, that it has the expected value, and that this element or attribute is unique in the entire fragment.
+
+
+
+ If null , the assertion behaves like
+
+ The path specified in
+
+ Assuming the following XML fragment exits:
+
+
+
+
+
+ ]]>
+
+ The following path would be valid:
+
+
+
+ Thrown if the verification failed unless the current
+ Thrown if
+
+
+
+ Asserts that the XML fragment contains the searched element or attribute, that it has the expected value, and that this element or attribute is unique in the entire fragment.
+
+
+
+ If null , the assertion behaves like
+
+ The path specified in
+
+ Assuming the following XML fragment exits:
+
+
+
+
+
+ ]]>
+
+ The following path would be valid:
+
+
+
+ Thrown if the verification failed unless the current
+ Thrown if
+
+
+
+ Asserts that the XML fragment contains the searched element or attribute, that it has the expected value, and that this element or attribute is unique in the entire fragment.
+
+
+
+ If null , the assertion behaves like
+
+ The path specified in
+
+ Assuming the following XML fragment exits:
+
+
+
+
+
+ ]]>
+
+ The following path would be valid:
+
+
+
+ Thrown if the verification failed unless the current
+ Thrown if
+
+
+
+ Asserts that the XML fragment contains the searched element or attribute, and that this element or attribute is unique in the entire fragment.
+
+
+
+ Options not related to the name case of elements and attributes are going to be ignored.
+
+
+ Thrown if the verification failed unless the current
+ Thrown if
+
+
+
+ Asserts that the XML fragment contains the searched element or attribute, and that this element or attribute is unique in the entire fragment.
+
+
+
+ Options not related to the name case of elements and attributes are going to be ignored.
+
+
+ Thrown if the verification failed unless the current
+ Thrown if
+
+
+
+ Asserts that the XML fragment contains the searched element or attribute, and that this element or attribute is unique in the entire fragment.
+
+
+
+ Options not related to the name case of elements and attributes are going to be ignored.
+
+
+ Thrown if the verification failed unless the current
+ Thrown if
+
+
+
+ Asserts that the XML fragment contains the searched element or attribute, and that this element or attribute is unique in the entire fragment.
+
+
+
+ Options not related to the name case of elements and attributes are going to be ignored.
+
+
+ Thrown if the verification failed unless the current
+ Thrown if
+
+
+
+ Asserts that the XML fragment contains the searched element or attribute, that it has the expected value, and that this element or attribute is unique in the entire fragment.
+
+
+
+ If null , the assertion behaves like
+
+ Thrown if the verification failed unless the current
+ Thrown if
+
+
+
+ Asserts that the XML fragment contains the searched element or attribute, that it has the expected value, and that this element or attribute is unique in the entire fragment.
+
+
+
+ If null , the assertion behaves like
+
+ Thrown if the verification failed unless the current
+ Thrown if
+
+
+
+ Asserts that the XML fragment contains the searched element or attribute, that it has the expected value, and that this element or attribute is unique in the entire fragment.
+
+
+
+ If null , the assertion behaves like
+
+ Thrown if the verification failed unless the current
+ Thrown if
+
+
+
+ Asserts that the XML fragment contains the searched element or attribute, that it has the expected value, and that this element or attribute is unique in the entire fragment.
+
+
+
+ If null , the assertion behaves like
+
+ Thrown if the verification failed unless the current
+ Thrown if
+
+
+
+ The bind attribute overrides the default binding rules for a test parameter
+ by specifying a different data source, a binding path or an index.
+
+
+
+ At most one such attribute may appear on any given test parameter.
+
+
+ The bind attribute supports more complex data binding binding scenarios.
+ For example, in a typical use of
+
+
+
+
+ Sets the binding path for the associated test parameter.
+
+ Thrown if
+
+
+
+ Sets the binding index for the associated test parameter.
+
+
+
+
+
+
+ Gets or sets the name of the data source to bind, or null to bind
+ the default data source for the test parameter.
+
+
+
+ The default source for a test parameter is the anonymous data source defined
+ within the scope of the test parameter or by its enclosing test.
+
+
+
+
+
+ Gets the binding path, or null if none.
+
+
+
+
+ Gets the binding index, or null if none.
+
+
+
+
+ Provides a column of literal values as a data source.
+
+
+
+ This attribute is a compact equivalent to providing a sequence of values
+ using
+
+ By default, the column provided by the column data source is unnamed.
+ Use
+
+
+
+
+ An abstract base class for MbUnit attributes that contribute values to data sources
+ along with metadata such a description or expected exception type.
+
+
+
+ You may define a new data source by creating a subclass of this attribute
+ and overriding
+
+
+
+
+ Gets the metadata for the data source.
+
+ The metadata keys and values.
+
+
+
+ Gets or sets a description of the values provided by the data source.
+
+
+
+
+ Gets or sets the type of exception that should be thrown when the
+ values provided by the data source are consumed by test.
+
+
+
+
+ Gets or sets the message of the exception that should be thrown when the
+ values provided by the data source are consumed by test.
+ May be a substring of the actual exception message.
+
+
+
+
+ Adds a column of literal values.
+
+
+
+ There exist two ambiguities in the use of this attribute that
+ result from how the C# compiler handles functions that accept
+ a variable number of arguments.
+
+
+ Case 1: If there is only 1 argument and its value is null , the
+ compiler will pass a null array reference to the attribute constructor.
+ Since the value array cannot be null, the attribute will assume that
+ you meant to create an array consiting of a single null .
+
+
+ Case 2: If there is only 1 argument and its value is an object array, the
+ compiler will pass the array itself as the argument values. Unfortunately,
+ the attribute constructor cannot distinguish this case from the usual case
+ when multiple arguments are present. So you need to disambiguate this case
+ explicitly.
+
+
+ To fix this case, you must provide explicit disambiguation.
+ (We cannot do it automatically based on the number of method parameters provided
+ because the row attribute can be applied to other elements besides methods and
+ its contents might be consumed in other ways.)
+
+
+
+
+
+
+
+ Gets the array of values in the column.
+
+
+
+
+ Sets the join strategy of a test to be combinatorial.
+
+
+
+ The test will be executed using all possible combinations of values from each data source.
+
+
+ If there are two data sources, A and B with values A1, A2, B1 and B2, then the test will
+ be run four times with inputs: (A1, B1), (A1, B2), (A2, B1) and (A2, B2).
+
+
+ This is the default join strategy for tests. So you do not need to specify this attribute
+ unless you want to be explicit about selecting it.
+
+
+
+
+
+ An abstract class for attributes that specify the join strategy of a test.
+
+
+
+ You may define a new join strategy by creating a subclass of this attribute
+ and overriding
+
+
+
+
+
+
+ Verifies that the attribute is being used correctly.
+
+ Thrown if the attribute is being used incorrectly.
+
+
+
+ Gets the join strategy to use.
+
+ The join strategy.
+
+
+
+
+
+ A map that stores the occurences of hash code values and computes various statistical data.
+
+
+
+
+ Constructs a map from the specified hash codes.
+
+
+
+
+ Gets the results of the analysis.
+
+
+
+
+ Simple container for hash code stochastic analysis results.
+
+
+
+
+ Constructor.
+
+
+
+
+ Gets the total number of hash codes used to perform the analysis.
+
+
+
+
+ Gets the probability that two values randomly chosen have the same hash code.
+
+
+
+
+ Gets the probability of deviation from a uniform distribution.
+
+
+
+
+ Contract for verifying the efficiency of the hash code generation algorithm for a given type.
+
+
+
+ Built-in verifications:
+
+ -
+
CollisionProbabilityTest : The probability of hash code collision for the specified set of instances
+ is less than the specified limit.
+
+ -
+
UniformDistributionTest : The probability of deviation from uniform distribution is less than
+ the specified limit.
+
+
+
+
+
+ The following examples shows a simple class that overrides the
+ {
+ CollisionProbabilityLimit = CollisionProbability.VeryLow,
+ UniformDistributionQuality = UniformDistributionQuality.Excellent,
+ DistinctInstances = GetDistinctInstances();
+ };
+
+ private static IEnumerable GetDistinctInstances()
+ {
+ for(int i=0; i<1000; i++)
+ for(int j=0; j<1000; j++)
+ yield return new Foo(i, j);
+ }
+ }
+ ]]>
+
+ The type of the object for which the hash code generation must be evaluated.
+
+
+
+ Abstract base class for contracts.
+
+
+
+
+ Describes a contract that can be verified.
+
+
+
+ Contracts can be composed together into more complex forms by combining their
+ lists of verification tests to create test suites. This enables the implementation
+ of one contract to leverage that of another.
+
+
+
+
+
+ Gets an enumeration of test cases whose purpose is to verify the contract.
+
+ An enumeration of tests.
+
+
+
+
+
+ Gets an enumeration of test cases whose purpose is to verify the contract.
+
+ An enumeration of tests.
+
+
+
+ Gets the interface of a particular type if it is implemented by another type,
+ otherwise returns null.
+
+ The interface type or null if it is not implemented by the implementation type.
+
+
+
+ Verifies that the specified method info object is not null, indicating that the
+ method exists, otherwise raises an assertion failure and describes the expected method signature.
+
+
+
+
+ Gets the execution context.
+
+
+
+
+ Constructs a contract verifier to evaluate the efficiency of the hash code generation algorithm for a given type.
+
+
+
+
+
+
+ Gets or sets the maximum collision probability tolerated.
+
+
+
+ If the actual probability calculated from the specified distinct instances is greater
+ than this limit, the test will fail.
+
+
+ The default is 0.01 (1%).
+
+
+
+
+
+ Gets or sets the required significance level to determine whether the distribution is uniform.
+
+
+
+ If the actual probability calculated from the specified distinct instances is greater than
+ the specified value, the test fails.
+
+
+ The default is 0.05 (5%).
+
+
+
+
+
+ Gets or sets an enumeration of distinct instances to extract the hash code from.
+
+
+
+
+ A list of common limits for the collision probability.
+
+
+
+
+ No collision allowed (0%)
+
+
+
+
+ Represents a very low probability of collision (less than 1%)
+
+
+
+
+ Represents a low probability of collision (less than 5%)
+
+
+
+
+ Represents a reasonable probability of collision (less than 10%)
+
+
+
+
+ Represents a mediocre probability of collision (less than 30%)
+
+
+
+
+ A list of common limits for the uniform distribution significance level.
+
+
+
+
+ Nearly uniform (less than 1% of deviation probability)
+
+
+
+
+ Characterizes a roughly uniform distribution (less than 5% of deviation probability)
+
+
+
+
+ Characterizes a reasonably uniform distribution (less than 10% of deviation probability)
+
+
+
+
+ Characterizes a poor uniform distribution (less than 30% of deviation probability)
+
+
+
+
+ Contains a collection of equivalent object instances.
+
+
+
+ All the elements of the collection should be equal together, in
+ the sense of the local implementation of an equality contract
+ (
+
+ Equivalence classes are used by some contract verifiers such as
+
+
+ The type of equivalent object instances.
+
+
+
+ Constructs a class of equivalent instances.
+
+
+
+ All the elements of the collection should be equal together, in
+ the sense of the local implementation of an equality contract
+ (
+
+
+
+
+ Returns a strongly-typed enumerator that iterates through the collection.
+
+ A strongly-typed enumerator.
+
+
+
+ Gets the collection of equivalent instances.
+
+
+
+
+ A collection of equivalence classes.
+
+
+
+ Equivalent classes are used by some contract verifiers such as
+
+
+ Use the default constructor followed by a list initializer to create a
+ collection of equivalence classes which contains a variable number of object instances.
+
+ {
+ { new Foo(1), new Foo("One") },
+ { new Foo(2), new Foo("Two") },
+ { new Foo(3), new Foo("Three") }
+ };
+ ]]>
+
+
+ Use the single-parameter constructor to create a collection of equivalence classes
+ which contains one single object instance each.
+ (new Foo(1), new Foo(2), new Foo(3));
+ ]]>
+
+
+ The type of equivalent object instances.
+
+
+
+ Constructs an empty collection of equivalence classes.
+
+
+
+
+ Constructs a collection of equivalence classes from the specified distinct object instances.
+
+
+
+ The resulting collection contains as many equivalence class as provided instances. Each equivalence
+ class contains one single object. To construct a collection with equivalence classes containing
+ several equivalent instances, use preferably the default constructor followed by a list initializer.
+
+
+
+
+ {
+ { new Foo(1), new Foo("One") },
+ { new Foo(2), new Foo("Two") },
+ { new Foo(3), new Foo("Three") }
+ };
+ ]]>
+
+
+
+
+ Adds to the collection a new equivalence class which contains the specified objects.
+
+
+
+
+ Returns a strongly-typed enumerator that iterates through the collection.
+
+ A strongly-typed enumerator.
+
+
+
+ Gets the equivalence classes.
+
+
+
+
+ Helper methods to quickly combine and generate random or constrained values for data-driven tests.
+
+
+ Helper methods to quickly combine and generate random or constrained values for data-driven tests.
+
+
+ Helper methods to quickly combine and generate random or constrained values for data-driven tests.
+
+
+
+
+ Joins the two specified enumerations of values into a single enumeration of paired values
+ by applying the default combinatorial join strategy.
+
+ The type of the values in the first enumeration.
+ The type of the values in the first enumeration.
+ The resulting enumeration of paired values.
+ Thrown if
+
+
+
+ Joins the two specified enumerations of values into a single enumeration of paired values
+ by applying the specified join strategy.
+
+ The type of the values in the first enumeration.
+ The type of the values in the first enumeration.
+ The resulting enumeration of paired values.
+ Thrown if
+
+
+
+ Joins the three specified enumerations of values into a single enumeration of triplet values
+ by applying the default combinatorial join strategy.
+
+ The type of the values in the first enumeration.
+ The type of the values in the second enumeration.
+ The type of the values in the third enumeration.
+ The resulting enumeration of triplet values.
+ Thrown if
+
+
+
+ Joins the two specified enumerations of values into a single enumeration of triplet values
+ by applying the specified join strategy.
+
+ The type of the values in the first enumeration.
+ The type of the values in the second enumeration.
+ The type of the values in the third enumeration.
+ The resulting enumeration of triplet values.
+ Thrown if
+
+
+
+ Joins the two specified enumerations of values into a single enumeration of paired values
+ by applying the default combinatorial join strategy.
+
+ The resulting enumeration of combined values in arrays.
+ Thrown if
+
+
+
+ Joins the two specified enumerations of values into a single enumeration of paired values
+ by applying the specified join strategy.
+
+ The resulting enumeration of paired values.
+ Thrown if
+
+
+
+ Generates random values.
+
+
+
+
+ Returns the an enumeration of random numbers.
+
+ An enumeration of random number values.
+ Thrown if the specified parameters are inconsistent or invalid.
+
+
+
+ Returns the an enumeration of random numbers.
+
+ An enumeration of random number values.
+ Thrown if the specified parameters are inconsistent or invalid.
+
+
+
+ Returns the an enumeration of random numbers.
+
+ An enumeration of random number values.
+ Thrown if the specified parameters are inconsistent or invalid.
+
+
+
+ Returns an enumeration of random strings based on a regular expression filter.
+
+ An enumeration of random string values.
+ Thrown if the specified parameters are inconsistent or invalid.
+
+
+
+ Returns an enumeration of random strings from a pre-existing stock of values.
+
+ An enumeration of random string values.
+ Thrown if the specified parameters are inconsistent or invalid.
+
+
+
+ Generates sequential values.
+
+
+
+
+ Generates a linear sequence of
+ Thrown if the specified parameters are inconsistent or invalid.
+
+
+
+ Generates a linear sequence of
+ Thrown if the specified parameters are inconsistent or invalid.
+
+
+
+ Generates a linear sequence of
+ Thrown if the specified parameters are inconsistent or invalid.
+
+
+
+ Generates a linear sequence of
+ Thrown if the specified parameters are inconsistent or invalid.
+
+
+
+ Generates a linear sequence of
+ Thrown if the specified parameters are inconsistent or invalid.
+
+
+
+ Generates a linear sequence of
+ Thrown if the specified parameters are inconsistent or invalid.
+
+
+
+ Provides data from Comma Separated Values (CSV) contents.
+
+
+
+ If the CSV document has a header,
+ then it is interpreted as the names of the columns. Columns with names in brackets, such as "[ExpectedException]",
+ are interpreted as containing metadata values associated with the named key.
+
+
+
+
+ This example reads data from an Embedded Resource called Data.csv within the
+ same namespace as the test fixture.
+
+
+ Data files:
+
+
+ A simple test.
+
+
+
+
+
+ An abstract base class for data source attributes that obtain contents from
+ a local file, manifest resource, or inline data.
+
+
+
+ At most one location type may be used.
+
+
+
+
+
+ Default constructor.
+
+
+
+
+ Gets the name of the location that is providing the data, or null if none.
+
+
+
+ The name will be the filename or resource path if specified, or a special
+ locale-aware string (such as "<inline>") if the contents were specified
+ inline via the
+
+
+
+
+ Opens the contents as a stream.
+
+
+
+ If you override this method to return data from a different stream, consider
+ also overriding
+
+ The stream.
+
+
+
+ Opens the contents as a text reader.
+
+
+
+ If you override this method to return data from a different stream, consider
+ also overriding
+
+ The text reader.
+
+
+
+
+
+ Validates the data source properties of the content attribute.
+
+
+
+ Throws a
+
+ Thrown if none of the source properties, such as
+
+
+
+ Gets or sets the inline data contents as a string.
+
+
+
+ It is an error to specify more than one content source property.
+
+
+
+
+
+ Gets or sets the path of a local file relative to the current working
+ directory from which the file contents should be read.
+
+
+
+ It is an error to specify more than one content source property.
+
+
+
+
+
+ Gets or sets a
+
+
+ If no value is specified, the test fixture type is used as the resource scope.
+
+
+
+
+
+ Gets or sets the path of a manifest resource from which the contents should be read.
+
+
+
+ The path will be resolved within the assembly containing the
+
+
+ During resolution, a resource name is constructed from the resource path by
+ translating backslashes to periods. If the named resource is found within
+ the scoped assembly manifest, it is used. Otherwise, the name is prepended
+ with the scoped type's namespace and second lookup is attempted. If this
+ final attempt fails, then an error is raised at runtime.
+
+
+ Examples:
+
+ - If the
MyNamespace.MyType within
+ assembly MyAssembly.dll and if "Resources\Image.gif" , then
+ resolution will first check whether Resources.Image.gif in
+ MyAssembly.dll is a valid resource. If not found, it will consider
+ MyNamespace.Resources.Image.gif . If still not found, then a runtime error will be raised.
+ - If no
+
+
+
+ It is an error to specify more than one content source property.
+
+
+
+
+
+ Gets or sets the outcome of the test when an error occured
+ while opening or reading the data file or the resource.
+
+
+
+ The default outcome is
+
+
+
+
+ Returns true if the contents are dynamic, or false if they are static.
+
+
+
+ Static contents can only change if the test assembly is recompiled.
+
+
+
+
+
+ Constructs a Comma Separated Values (CSV) contents attribute.
+
+
+
+
+
+
+ Gets or sets the field delimiter character.
+
+
+ The default value is ',' (comma).
+
+
+
+
+ Gets or sets a character that indicates that a line in the source represents a comment.
+
+
+
+ May be set to '\0' (null) to disable comment handling.
+
+
+ Comment lines are excluded from the record set.
+
+
+
+ The default value is '#' (pound).
+
+
+
+
+ Gets or sets whether the CSV document has a header that should be used to provide
+ aliases for indexed columns.
+
+
+ The default value is false which indicates that the file does not have a header.
+
+
+
+
+ Creates a dependency from this test assembly, test fixture or test method on some other test
+ fixture or test method.
+
+
+
+ If the other test fixture or test method fails then this test
+ will not run. Moreover, the dependency forces this test to run after those
+ it depends upon.
+
+
+ This attribute can be repeated multiple times if there are multiple dependencies.
+
+
+
+
+
+ Creates a dependency from this test on another test fixture.
+
+ Thrown if
+
+
+
+ Creates a dependency from this test on a particular test method within another test fixture.
+
+ Thrown if
+
+
+
+ Creates a dependency from this test on another test method within this test fixture.
+
+ Thrown if
+
+
+
+
+
+ Gets the dependent test fixture type, or null if the dependency is on another
+ test method of this test fixture.
+
+
+
+
+ Gets the dependent test method name, or null if the dependency
+ is on the whole test fixture.
+
+
+
+
+ Indicates that a test should only be run explicitly.
+
+
+
+ The test will still appear in the test tree but it will not run and it will not appear
+ in the test results unless it is explicitly selected for execution.
+
+
+ A test is considered to be explicitly selected when the filter used to run the tests
+ matches the test or its descendants but none of its ancestors. For example, if the filter
+ matches a test case but not its containing test fixture then the test case will be deemed
+ to be explicitly selected. Otherwise the test case will be implicitly selected by virtue
+ of the fact that the filter matched one of its ancestors.
+
+
+ This attribute can be used to exclude from normal execution any tests that are
+ particularly expensive or require manual supervision by an operator.
+
+
+
+
+
+ Indicates that this test should only run explicitly without providing a reason.
+
+
+
+
+ Indicates that this test should only run explicitly and provides a reason.
+
+ Thrown if
+
+
+
+
+
+ Gets the reason that the test should only run explicitly.
+
+
+
+
+ Determines the outcome of data-driven test when an error occured while
+ opening or reading the external data file or resource.
+
+
+
+
+ The test is skipped on file error.
+
+
+
+
+ The test is inconclusive on file error.
+
+
+
+
+ The test failed on file error.
+
+
+
+
+ Specifies a factory member that will provide values for a data-driven test.
+
+
+
+ The factory may be an instance or static member of the fixture class or a
+ static member of some other class.
+
+
+ Refer to
+
+
+
+
+ Specifies the name of a method, property or field of the fixture
+ class that will provide values for a data-driven test.
+
+
+
+ The factory member must return an enumeration of values (
+
+ The factory member may be non-static if it will be used within the
+ scope of an initialized fixture. Typically this is the case for factory
+ members referenced by non-static test methods.
+
+
+ Thrown if
+
+
+
+ Specifies the declaring type and name of a static method, property or field
+ that will provide values for a data-driven test.
+
+
+
+ The factory member must return an enumeration of values (
+
+ Thrown if
+
+
+
+
+
+ Gets the declaring type of the factory, or null if it is assumed to be the fixture class.
+
+
+
+
+ Gets the factory member name, never null.
+
+
+
+
+ Gets or sets the kind of the factory.
+
+
+
+ Defaults to
+
+ The kind of the factory.
+
+
+
+ Gets or sets the number of columns produced by the factory, or 0 if unknown.
+
+
+
+ Defaults to 0.
+
+
+ The number of columns
+ Thrown if
+
+
+
+ Defines names as aliases for the columns in an indexed data source
+ such as those that have been populated by
+
+
+ The names may subsequently be used in data binding expressions in place
+ of their corresponding column indices.
+
+
+
+
+
+
+
+ Defines names as aliases for the columns in an indexed data source.
+
+ Thrown if
+
+
+
+
+
+ Gets the array of column names.
+
+
+
+
+ Specifies a method that is to be invoked after a fixture instance has been
+ created to complete its initialization before test fixture setup runs.
+
+
+
+ This attribute provides a mechanism for completing the initialization
+ of a fixture if the work cannot be completed entirely within the
+ constructor. For example, data binding might be used to set fields
+ and property values of the fixture instance. Consequently post-construction
+ initialization may be required.
+
+
+
+
+ The attribute may be applied to multiple methods within a fixture, however
+ the order in which they are processed is undefined.
+
+
+ The method to which this attribute is applied must be declared by the
+ fixture class and must not have any parameters. The method may be static.
+
+
+
+
+
+
+
+
+
+ Specifies options for the
+
+
+
+ Specifies the maximum number of evaluation attempts, before the
+
+
+ If not specified, the condition will be evaluated an infinite number of times, or until some
+ other stop criterion is reached.
+
+
+ An instance to specify other options for the retry operation.
+ Thrown if the
+
+
+
+ Specifies a polling time expressed in milliseconds between each consecutive evaluation of the condition.
+
+
+
+ If not specified, the default polling time is zero; which causes the condition to be evaluated as fast as possible, with
+ only a brief suspension of the current thread (
+
+ An instance to specify other options for the retry operation.
+ Thrown if the option was called more than once.
+ Thrown if
+
+
+
+ Specifies a polling time between each consecutive evaluation of the condition.
+
+
+
+ If not specified, the default polling time is zero; which causes the condition to be evaluated as fast as possible, with
+ only a brief suspension of the current thread (
+
+ An instance to specify other options for the retry operation.
+ Thrown if the option was called more than once.
+ Thrown if
+
+
+
+ Specifies a timeout value expressed in milliseconds.
+
+
+
+ The retry operation fails if the overall duration exceeds the specified timeout value.
+
+
+ If not specified, the default timeout value is set to 10 seconds.
+
+
+ An instance to specify other options for the retry operation.
+ Thrown if the option was called more than once.
+
+
+
+ Specifies a timeout value.
+
+
+
+ The retry operation fails if the overall duration exceeds the specified timeout value.
+
+
+ If not specified, the default timeout value is set to 10 seconds.
+
+
+ An instance to specify other options for the retry operation.
+ Thrown if the option was called more than once.
+
+
+
+ Specifies a custom action to be executed between each consecutive attempt, but not before the first one.
+
+ An instance to specify other options for the retry operation.
+ Thrown if the option was called more than once.
+ Thrown if
+
+
+
+ Specifies a custom formatted message to be added to the text of the assertion raised when
+ the retry operation has failed.
+
+
+
+
+ Specifies the condition to evaluate repeatedly, and starts the entire operation.
+
+
+
+ The condition is considered fulfilled when it returns true.
+
+
+ Thrown when the condition is false, and a timeout occured, or the maximum
+ number of evaluation attempts was reached.
+
+
+
+ Specifies a
+ Thrown when the wait handle is unsignaled, and a timeout occured, or the maximum
+ number of evaluation attempts was reached.
+
+
+
+ Specifies a
+ Thrown when the thread is still alive, and a timeout occured, or the maximum
+ number of evaluation attempts was reached.
+
+
+
+ Defines a strategy for joining data.
+
+
+
+
+ Combinatorial join strategy.
+
+
+
+
+ Sequential join strategy.
+
+
+
+
+ Pairwise join strategy.
+
+
+
+
+ A mirror uses reflection to provide access to non-public members of an object
+ or type for testing purposes.
+
+
+
+ Writing tests that require access to non-public members is not recommended.
+ Non-public members should be considered internal implementation details of
+ the subject under test. Relying on their behavior can yield brittle tests.
+
+
+ These reflection helpers are not intended to assist with all possible reflection
+ scenarios. For everything else, use the standard .Net reflection library.
+
+
+ Another useful function related to
+
+
+
+ In this example, we use a
+
+ // A sample object with various members including a private nested class
+ // that has a public yet inaccessible static method.
+ public class SampleObject
+ {
+ private int privateField;
+ private int PrivateProperty { get; set;}
+ private event EventHandler PrivateEvent;
+ private int PrivateMethod(int a, int b) { ... }
+
+ private static class PrivateNestedClass
+ {
+ public int StaticMethod(object y) { ... }
+
+ public int OverloadedMethod(object y) { ... }
+
+ public int OverloadedMethod(string y) { ... }
+
+ public T GenericMethod<T>(T x) { ... }
+ }
+ }
+
+ internal class InternalObject { ... }
+
+ internal delegate int InternalDelegate(InternalObject x);
+
+ // A sample test fixture.
+ public class Fixture
+ {
+ [Test]
+ public void Test()
+ {
+ // Setup.
+ SampleObject obj = new SampleObject();
+ Mirror objMirror = Mirror.ForObject(obj);
+
+ // Reading from a private field.
+ int privateFieldValue = (int) objMirror["privateField"].Value;
+
+ // Writing to a private property.
+ objMirror["PrivateProperty"].Value = 42;
+
+ // Obtaining a mirror for a value at index 5 in a private indexed property.
+ Mirror valueMirror = objMirror["Item"][5].ValueAsMirror;
+
+ // Invoking a private method.
+ int result = (int) objMirror["PrivateMethod"].Invoke(1, 2);
+
+ // Accessing a private type.
+ Type privateNestedClass = objMirror["PrivateNestedClass"].Type;
+ Mirror privateNestedClassMirror = Mirror.ForType(privateNestedClass);
+
+ // Invoking a static method.
+ int result2 = privateNestedClassMirror["StaticMethod"].Invoke(42);
+
+ // Invoking an overloaded static method when we cannot determine the parameter
+ // type automatically from the arguments, such as when an argument is null.
+ int result2 = privateNestedClassMirror["OverloadedMethod"].WithSignature(typeof(object)).Invoke(null);
+ int result3 = privateNestedClassMirror["OverloadedMethod"].WithSignature(typeof(string)).Invoke(null);
+
+ // Invoking a generic method.
+ int result3 = privateNestedClassMirror["GenericMethod"].Invoke(42);
+
+ // Invoking a generic method using specific type arguments.
+ object result4 = privateNestedClassMirror["GenericMethod"].WithTypeArgs(typeof(object)).Invoke(42);
+
+ // Creating an instance of an internal object.
+ Mirror internalObjTypeMirror = Mirror.ForType("My.Namespace.InternalObject", "MyAssembly");
+ object internalObj = internalObjTypeMirror.CreateInstance();
+
+ // Creating an instance of an internal delegate.
+ // Notice that the Mirror automatically adapts the provided delegate signature
+ // to the actual delegate signature to make it easier to write tests when the delegate
+ // parameter or result types are themselves inaccessible.
+ Mirror internalDelegateTypeMirror = Mirror.ForType("My.Namespace.InternalDelegate", "MyAssembly");
+ Delegate internalDelegate = internalDelegateTypeMirror.CreateDelegate(
+ new Func<object, int>(x => { return 5; }));
+ }
+ }
+
+
+
+
+
+ Gets an instance of a mirror that represents a null object of unknown type.
+
+
+
+
+ Creates a mirror for the specified type.
+
+ The type.
+ The new mirror.
+
+
+
+ Creates a mirror for the specified type.
+
+ The new mirror.
+ Thrown if
+
+
+
+ Creates a mirror for the specified type by assembly-qualified name.
+
+ The new mirror.
+ Thrown if
+ Thrown if the type is not found.
+
+
+
+ Creates a mirror for the specified type by namespace-qualified name and assembly.
+
+ The new mirror.
+ Thrown if
+ Thrown if the type is not found.
+
+
+
+ Creates a mirror for the specified type by namespace-qualified name and assembly name.
+
+ The new mirror.
+ Thrown if
+ Thrown if the type is not found.
+
+
+
+ Creates a mirror for the specified object.
+
+ The new mirror.
+ Thrown if
+
+
+
+ Returns true if the mirror represents a null object.
+
+
+
+
+ Returns true if the mirror represents a null object of unknown type.
+
+
+
+
+ Gets the reflected type seen in the mirror, or null if the mirror represents a null
+ object of unknown type.
+
+
+
+
+ Gets the object instance seen in the mirror, or null if the mirror does not represent
+ a particular instance of a type.
+
+
+
+
+ Gets an object that can access the mirror type's members with the specified name.
+
+
+
+ If there are no members with the specified name, the member set will be
+ empty and all operations performed on it will fail. If there are multiple
+ members with the specified name (when the name is overloaded), the member set
+ will refer to multiple members. When an operation is performed on the
+ member set, a specific member will chosen from the set or an error will
+ be emitted.
+
+
+ The member set that represents the mirror type's members with the specified name.
+ Thrown if
+ Thrown if the mirror represents a null object of unknown type.
+
+
+
+ Gets an object that can access the mirror type's constructors.
+
+
+
+ If there are no constructors, the member set will be
+ empty and all operations performed on it will fail. If there are multiple
+ constructors (when the constructor is overloaded), the member set
+ will refer to multiple constructors. When an operation is performed on the
+ member set, a specific constructor will chosen from the set or an error will
+ be emitted.
+
+
+ The member set that represents the mirror type's constructors.
+ Thrown if the mirror represents a null object of unknown type.
+
+
+
+ Gets an object that can access the mirror type's static constructors.
+
+
+
+ If there are no static constructors, the member set will be
+ empty and all operations performed on it will fail.
+
+
+ The member set that represents the mirror type's static constructors.
+ Thrown if the mirror represents a null object of unknown type.
+
+
+
+ A member set provides reflection operations on members of an object or type.
+
+
+
+ The specific member that is chosen for a given operation depends on the operation arguments.
+ For example, if a member set represents an overloaded method then the arguments to
+
+
+
+
+
+ Invokes the method represented by the member set and returns its result.
+
+
+
+ When the method set contains multiple overloads attempts to choose an
+ overload that is compatible with the argument list or raises an exception
+ if none is found.
+
+
+ The method result.
+ Thrown if the operation failed because
+ of a reflection problem such as when the member access is invalid or ambiguous.
+
+
+
+ Invokes the method represented by the member set and returns its result.
+
+
+
+ When the method set contains multiple overloads attempts to choose an
+ overload that is compatible with the argument list or raises an exception
+ if none is found.
+
+
+ The method result.
+ Thrown if the operation failed because
+ of a reflection problem such as when the member access is invalid or ambiguous.
+
+
+
+ Invokes the method represented by the member set and returns its result.
+
+
+
+ When the method set contains multiple overloads attempts to choose an
+ overload that is compatible with the argument list or raises an exception
+ if none is found.
+
+
+ The method result.
+ Thrown if
+ Thrown if the operation failed because
+ of a reflection problem such as when the member access is invalid or ambiguous.
+
+
+
+ Invokes the method represented by the member set and returns its result as a mirror.
+
+
+
+ When the method set contains multiple overloads attempts to choose an
+ overload that is compatible with the argument list or raises an exception
+ if none is found.
+
+
+ The method result as a mirror.
+ Thrown if the operation failed because
+ of a reflection problem such as when the member access is invalid or ambiguous.
+
+
+
+ Invokes the method represented by the member set and returns its result as a mirror.
+
+
+
+ When the method set contains multiple overloads attempts to choose an
+ overload that is compatible with the argument list or raises an exception
+ if none is found.
+
+
+ The method result as a mirror.
+ Thrown if the operation failed because
+ of a reflection problem such as when the member access is invalid or ambiguous.
+
+
+
+ Invokes the method represented by the member set and returns its result as a mirror.
+
+
+
+ When the method set contains multiple overloads attempts to choose an
+ overload that is compatible with the argument list or raises an exception
+ if none is found.
+
+
+ The method result as a mirror.
+ Thrown if
+ Thrown if the operation failed because
+ of a reflection problem such as when the member access is invalid or ambiguous.
+
+
+
+ Adds an event handler to the event represented by the member set.
+
+ Thrown if the operation failed because
+ of a reflection problem such as when the member access is invalid or ambiguous.
+
+
+
+ Adds an event handler to the event represented by the member set.
+
+ Thrown if the operation failed because
+ of a reflection problem such as when the member access is invalid or ambiguous.
+
+
+
+ Adds an event handler to the event represented by the member set.
+
+ Thrown if the operation failed because
+ of a reflection problem such as when the member access is invalid or ambiguous.
+
+
+
+ Removes an event handler to the event represented by the member set.
+
+ Thrown if the operation failed because
+ of a reflection problem such as when the member access is invalid or ambiguous.
+
+
+
+ Removes an event handler to the event represented by the member set.
+
+ Thrown if the operation failed because
+ of a reflection problem such as when the member access is invalid or ambiguous.
+
+
+
+ Removes an event handler to the event represented by the member set.
+
+ Thrown if the operation failed because
+ of a reflection problem such as when the member access is invalid or ambiguous.
+
+
+
+ Returns a new member set that selects members with the specified signature.
+ This is particularly useful when the member is overloaded and cannot be resolved
+ automatically.
+
+ A member set that selects members with the specified signature.
+ Thrown if
+
+
+
+ Returns a new member set that selects members with the specified generic arguments.
+ This is particularly useful when the member has multiple generic overloads
+ that cannot be resolved automatically.
+
+ A member set that selects members with the specified generic arguments.
+ Thrown if
+
+
+
+ Returns a new member set that selects members that match the specified binding flags.
+
+ A member set that selects members that match the specified binding flags.
+
+
+
+ Gets the member info that the member set represents.
+
+
+
+ This call will fail if the member set matches multiple members in which case
+ you should use the
+
+ The nested type.
+ Thrown if the operation failed because
+ of a reflection problem such as when the member access is invalid or ambiguous.
+
+
+
+ Gets the nested type that the member set represents.
+
+ The nested type.
+ Thrown if the operation failed because
+ of a reflection problem such as when the member access is invalid or ambiguous.
+
+
+
+ Gets the nested type that the member set represents as a mirror.
+
+ The nested type as a mirror.
+ Thrown if the operation failed because
+ of a reflection problem such as when the member access is invalid or ambiguous.
+
+
+
+ Gets an object that represents a particular index of a property whose value can be manipulated.
+
+ The property index.
+ Thrown if the operation failed because
+ of a reflection problem such as when the member access is invalid or ambiguous.
+
+
+
+ Gets an object that represents a particular index of a property whose value can be manipulated.
+
+ The property index.
+ Thrown if the operation failed because
+ of a reflection problem such as when the member access is invalid or ambiguous.
+
+
+
+ Gets or sets the value of the field or property represented by the member set.
+
+ The value.
+ Thrown if the operation failed because
+ of a reflection problem such as when the member access is invalid or ambiguous.
+
+
+
+ Gets the value of the field or property represented by the member set as a mirror.
+
+ The value as a mirror.
+ Thrown if the operation failed because
+ of a reflection problem such as when the member access is invalid or ambiguous.
+
+
+
+ A property index provides a means of getting or setting the value of an indexed property
+ using particular index arguments.
+
+
+
+
+ Gets or sets the value of the indexed property.
+
+ The value.
+ Thrown if the operation failed because
+ of a reflection problem such as when the member access is invalid or ambiguous.
+
+
+
+ Gets the value of the indexed property as a mirror.
+
+ The value as a mirror.
+ Thrown if the operation failed because
+ of a reflection problem such as when the member access is invalid or ambiguous.
+
+
+
+ Runs the test as if it were surrounded by
+
+
+ When an assertion failure occurs, it is reported but the test is allowed to proceed
+ until it completes or throws an unhandled exception. When the test finishes, it will
+ still be marked as failed, as usual.
+
+
+
+
+
+
+
+ Overrides the name of a test or test parameter.
+
+
+
+ Use this attribute to specify a more descriptive or readable name than
+ the one chosen by default by MbUnit which is usually derived from the method,
+ class, field, property, or parameters name. The test name specified by this
+ attribute can contain
+
+
+
+
+
+ Overrides the name of a test or test parameter.
+
+ Thrown if
+
+
+
+
+
+ Verifies that the attribute is being used correctly.
+
+ Thrown if the attribute is being used incorrectly.
+
+
+
+ Gets the overridden name.
+
+
+
+
+ Defines methods used with the
+
+
+
+ Evaluates an assertion over pairs of values taken from two sequences.
+
+
+
+ This assertion fails if the collections have different sizes or if one is null but not the other.
+
+
+ The left value type.
+ The right value type.
+
+
+
+ Evaluates an assertion over pairs of values taken from two sequence.
+
+
+
+ This assertion fails if the collections have different sizes or if one is null but not the other.
+
+
+ The left value type.
+ The right value type.
+
+
+
+ Evaluates an assertion over key/value pairs with identical keys drawn from two dictionaries.
+
+
+
+ This assertion fails if the collections have different sizes or if one is null but not the other.
+
+
+ The key type.
+ The expected value type.
+ The expected value type.
+ Thrown if the verification failed unless the current
+
+
+
+ Evaluates an assertion over key/value pairs with identical keys drawn from two dictionaries.
+
+
+
+ This assertion fails if the collections have different sizes or if one is null but not the other.
+
+
+ The key type.
+ The expected value type.
+ The expected value type.
+ Thrown if the verification failed unless the current
+
+
+
+ Evaluates an assertion over key/value pairs with identical keys drawn from two dictionaries.
+
+
+
+ This assertion fails if the collections have different sizes or if one is null but not the other.
+
+
+ The key type.
+ The expected value type.
+ The expected value type.
+ Thrown if the verification failed unless the current
+
+
+
+ Evaluates an assertion over key/value pairs with identical keys drawn from two dictionaries.
+
+
+
+ This assertion fails if the collections have different sizes or if one is null but not the other.
+
+
+ The key type.
+ The expected value type.
+ The expected value type.
+ Thrown if the verification failed unless the current
+
+
+
+ Sets the join strategy of a test to be pairwise.
+
+
+
+ The test will be executed using values drawn from each data source and combined so
+ that all possible pairings of values from each data source are produced. This constraint vastly
+ reduces the number of combinations because we only consider all interactions among
+ pairs of variables rather than among all variables at once. This strategy still
+ provides a high degree of variability among combinations and has a high likelihood of
+ finding bugs while incurring much less cost than testing all possible combinations.
+
+
+ If there are three data sources, A, B and C with values A1, A2, B1, B2, C1 and C2 then
+ the test will be run four times with inputs: (A1, B1, C1), (A2, B2, C1), (A1, B2, C2), (A2, B1, C2).
+ Compare this with the eight times that a standard cross-product combinatorial join
+ strategy would have required.
+
+
+ The algorithm used to compute pairwise coverings is approximate and might not find
+ a minimal pairwise covering of values. However, the relative size of a full combinatorial
+ cross product will still be exponentially larger than that of the covering that is produced.
+
+
+
+
+
+
+
+ Indicates that a test has pending prerequisites so it will not be run.
+
+
+
+ The test will still appear in test reports along with an explanation of the
+ reason it it pending, if provided.
+
+
+ This attribute can be used to disable tests that cannot run because the
+ subject under test is missing certain prerequisite functionality. It may
+ also serve as a placeholder for test that have yet to be implemented.
+
+
+
+
+
+ Indicates that this test has pending prerequisites without providing a reason.
+
+
+
+
+ Indicates that this test has pending prerequisites and provides a reason.
+
+ Thrown if
+
+
+
+
+
+ Gets the reason that the test is pending.
+
+
+
+
+ Decorates a test method and causes it to be invoked repeatedly.
+
+
+
+ Each repetition of the test method will occur within its own individually labeled
+ test step so that it can be identified in the test report.
+
+
+ The initialize, setup, teardown and dispose methods will are invoked around each
+ repetition of the test.
+
+
+
+
+
+ Executes the test method repeatedly.
+
+
+
+ Thrown if
+
+
+
+
+
+ Evaluates repeatedly the specified condition until it becomes fulfilled, or throws
+ a
+
+ Here is an example that illustrates the usage of { /* DoSomethingBetweenEachCall */ })
+ .Until(() => { return EvaluateSomeCondition(); });
+ }
+ }
+ ]]>
+
+
+
+
+ Specifies the maximum number of evaluation attempts, before the
+
+
+ If not specified, the condition will be evaluated an infinite number of times, or until some
+ other stop criterion is reached.
+
+
+ An instance to specify other options for the retry operation.
+ Thrown if the options was called more than once.
+
+
+
+ Specifies a polling time expressed in milliseconds between each consecutive evaluation of the condition.
+
+
+
+ If not specified, the default polling time is zero; which causes the condition to be evaluated as fast as possible, with
+ only a brief suspension of the current thread (
+
+ An instance to specify other options for the retry operation.
+ Thrown if the option was called more than once.
+ Thrown if
+
+
+
+ Specifies a polling time between each consecutive evaluation of the condition.
+
+
+
+ If not specified, the default polling time is zero; which causes the condition to be evaluated as fast as possible, with
+ only a brief suspension of the current thread (
+
+ An instance to specify other options for the retry operation.
+ Thrown if the option was called more than once.
+ Thrown if
+
+
+
+ Specifies a timeout value expressed in milliseconds.
+
+
+
+ The retry operation fails if the overall duration exceeds the specified timeout value.
+
+
+ If not specified, the default timeout value is set to 10 seconds.
+
+
+ An instance to specify other options for the retry operation.
+ Thrown if the option was called more than once.
+
+
+
+ Specifies a timeout value.
+
+
+
+ The retry operation fails if the overall duration exceeds the specified timeout value.
+
+
+ If not specified, the default timeout value is set to 10 seconds.
+
+
+ An instance to specify other options for the retry operation.
+ Thrown if the option was called more than once.
+
+
+
+ Specifies a custom action to be executed between each consecutive attempt, but not before the first one.
+
+ An instance to specify other options for the retry operation.
+ Thrown if the option was called more than once.
+ Thrown if
+
+
+
+ Specifies a custom formatted message to be added to the text of the assertion raised when
+ the retry operation has failed.
+
+
+
+
+ Specifies the condition to evaluate repeatedly, and starts the entire operation.
+
+
+
+ The condition is considered fulfilled when it returns true.
+
+
+ Thrown when the condition is still false, and a timeout occured, or the maximum
+ number of evaluation attempts was reached.
+
+
+
+ Specifies a
+ Thrown when the wait handle is still unsignaled, and a timeout occured, or the maximum
+ number of evaluation attempts was reached.
+
+
+
+ Specifies a
+ Thrown when the thread is still alive, and a timeout occured, or the maximum
+ number of evaluation attempts was reached.
+
+
+
+ Provides a row of literal values as a data source.
+
+
+
+ The values specified in the row are used for data-driven testing purposes.
+ A row may specify zero or more values that are manipulated as a unit. Typically
+ each row generates a single instance instance of a data-driven test.
+
+
+ By default, the columns provided by the row data source are unnamed.
+ Use
+
+
+
+
+
+
+ Adds a row of literal values.
+
+
+
+ There exist two ambiguities in the use of this attribute that
+ result from how the C# compiler handles functions that accept
+ a variable number of arguments.
+
+
+ Case 1: If there is only 1 argument and its value is null , the
+ compiler will pass a null array reference to the attribute constructor.
+ Since the value array cannot be null, the attribute will assume that
+ you meant to create an array consiting of a single null .
+
+
+ Case 2: If there is only 1 argument and its value is an object array, the
+ compiler will pass the array itself as the argument values. Unfortunately,
+ the attribute constructor cannot distinguish this case from the usual case
+ when multiple arguments are present. So you need to disambiguate this case
+ explicitly.
+
+
+ To fix this case, you must provide explicit disambiguation.
+ (We cannot do it automatically based on the number of method parameters provided
+ because the row attribute can be applied to other elements besides methods and
+ its contents might be consumed in other ways.)
+
+
+
+
+
+
+
+ Gets the array of values in the row.
+
+
+
+
+ Registers a custom assembly resolver.
+
+
+
+ A custom assembly resolver allows a test assembly to augment the default
+ assembly loading policy with custom rules.
+
+
+ To create a custom assembly resolver, define a resolver class that implement
+ the
+
+
+
+
+ Registers a custom assembly resolver.
+
+
+
+
+
+
+ Gets the assembly resolver type.
+
+
+
+
+ Associates the author's name and email address with a test fixture, test method,
+ test parameter or other test component.
+
+
+
+
+ Associates the author's name with the test component annotated
+ by this attribute.
+
+ Thrown if
+
+
+
+ Associates the author's name and email address with the test component annotated
+ by this attribute.
+
+ Thrown if
+
+
+
+ Associates the author's name, email address and homepage with the test component annotated
+ by this attribute.
+
+ Thrown if
+
+
+
+
+
+ Gets or sets the author's name.
+
+
+
+
+ Gets or sets the author's email address or an empty string if none.
+
+
+
+
+ Gets or sets the author's homepage or an empty string if none.
+
+
+
+
+ Associates a category name with a test fixture, test method, test parameter
+ or other test component.
+
+
+
+ The category name can be used to classify tests and build test suites of related tests.
+
+
+
+
+
+ Associates a category with the test component annotated by this attribute.
+
+ Thrown if
+
+
+
+
+
+ Gets the name of the category.
+
+
+
+
+ Associates a description with a test fixture, test method, test parameter
+ or other test component.
+
+
+
+ The description provides documentation to users when browsing the tests.
+ However, it is not the only way. If the test has associated XML documentation
+ comments and the compiler is generating an XML documentation file for the
+ test assembly, then MbUnit will automatically import the documentation and
+ make it available to the user as metadata.
+
+
+
+
+
+ Associates a description with the test component annotated by this attribute.
+
+ Thrown if
+
+
+
+
+
+ Gets or sets the description.
+
+
+
+
+ Declares that the associated test is expected to throw an
+
+
+ The expected contents of the exception message may optionally be specified.
+
+
+
+
+
+ Declares that the associated test is expected to throw an exception of
+ a particular type.
+
+
+
+ The expected contents of the exception message may optionally be specified.
+
+
+
+
+
+ Declares that the associated test is expected to throw an exception of
+ a particular type.
+
+ Thrown if
+
+
+
+ Declares that the associated test is expected to throw an exception of
+ a particular type.
+
+
+
+ The expected contents of the exception message may also optionally be specified.
+
+
+ Thrown if
+
+
+
+
+
+ Gets the expected exception type.
+
+
+
+
+ Gets or sets the expected exception message, or null if none specified.
+ May be a substring of the actual exception message.
+
+
+
+
+ Declares that the associated test is expected to throw an
+
+
+
+ Declares that the associated test is expected to throw an
+
+
+ The expected contents of the exception message may also optionally be specified.
+
+
+
+
+
+ Declares that the associated test is expected to throw an
+
+
+ The expected contents of the exception message may optionally be specified.
+
+
+
+
+
+ Declares that the associated test is expected to throw an
+
+
+
+ Declares that the associated test is expected to throw an
+
+
+ The expected contents of the exception message may also optionally be specified.
+
+
+
+
+
+ Declares that the associated test is expected to throw an
+
+
+ The expected contents of the exception message may optionally be specified.
+
+
+
+
+
+ Declares that the associated test is expected to throw an
+
+
+
+ Declares that the associated test is expected to throw an
+
+
+ The expected contents of the exception message may also optionally be specified.
+
+
+
+
+
+ Indicates that a test is to be ignored by the framework and will not be run.
+
+
+
+ The test will still appear in test reports along with the reason that it
+ was ignored, if provided.
+
+
+ This attribute can be used to disable tests that are broken or expensive
+ without commenting them out or removing them from the source code.
+
+
+
+
+
+ Indicates that this test is to be ignored without providing a reason.
+
+
+
+
+ Indicates that this test is to be ignored and provides a reason.
+
+ Thrown if
+
+
+
+
+
+ Gets the reason that the test has been ignored, or an empty string if none.
+
+
+
+
+ Associates a
+
+
+
+ Associates a
+
+
+
+
+
+ Gets or sets the importance.
+
+
+
+
+ Associates custom metadata with a test fixture, test method, test parameter
+ or other test component. The metadata can be used for documentation, classification
+ or dynamic customization of tests.
+
+
+
+ Metadata appears in the test reports and can be used for filtering. It is also
+ accessible at runtime by inspecting the properties of the current test in the
+
+
+
+
+
+ Associates custom metadata with a test component.
+
+ Thrown if
+
+
+
+
+
+ Gets the metadata key.
+
+
+
+
+ Gets the metadata value.
+
+
+
+
+ Declares that a property, field, method parameter, constructor parameter,
+ generic type parameter or generic method parameter represents a test parameter.
+
+
+
+ This attribute is optional for a method parameter, constructor parameter,
+ generic type parameter or generic method parameter. For a property or field,
+ this attribute is required unless the property or field has at least one associated data
+ source, in which case the attribute can be omitted.
+
+
+ In other words, this attribute only needs to be specified on a property
+ or field that does not have an associated explicit data binding attribute.
+ This is typically the case when the parameter obtains its values from a
+ data source defined by the test fixture.
+
+
+
+
+
+
+
+ The type of exception thrown when a
+
+
+
+ Creates an exception.
+
+
+
+
+ Creates an exception.
+
+
+
+
+ Creates an exception.
+
+
+
+
+ Creates an exception from serialization info.
+
+
+
+
+ Sets the join strategy of a test to be sequential.
+
+
+
+ The test will be executed using values drawn from each data source and combined sequentially
+ with elements from each data source chosen in order.
+
+
+ If there are two data sources, A and B with values A1, A2, B1 and B2, then the test will be
+ run twice with inputs: (A1, B1) and (A2, B2).
+
+
+
+
+
+
+
+ Specifies a method that is to be invoked before each test in a fixture executes
+ to set up the state of the test.
+
+
+
+ The method will run once for each test.
+
+
+ The attribute may be applied to multiple methods within a fixture, however
+ the order in which they are processed is undefined.
+
+
+ The method to which this attribute is applied must be declared by the
+ fixture class and must not have any parameters. The method may be static.
+
+
+
+
+
+
+
+ Specifies a method that is to be invoked after each test in a fixture executes
+ to tear down the state of the test.
+
+
+
+ The method will run once for each test.
+
+
+ The attribute may be applied to multiple methods within a fixture, however
+ the order in which they are processed is undefined.
+
+
+ The method to which this attribute is applied must be declared by the
+ fixture class and must not have any parameters. The method may be static.
+
+
+
+
+
+
+
+ Specifies that a method represents a single test case within a fixture.
+
+
+
+ By default, if the method throws an unexpected exception,
+ the test will be deemed to have failed. Otherwise, the test will pass.
+
+
+ The default behavior may be modified by test decorator attributes that
+ may alter the execution environment of the test, catch and reinterpret
+ any exceptions it throws, or impose additional constraints upon its execution.
+
+
+ Output from the test, such as text written to the console, is captured
+ by the framework and will be included in the test report. Additional
+ information can also be logged during test execution using the
+
+ A test method has a timeout of 10 minutes by default. This may be changed
+ using the
+
+ The method to which this attribute is applied must be declared by the
+ fixture class. The method may be static. If it has parameters, then the
+ test is considered to be data-driven.
+
+
+
+
+
+
+
+ An abstract base class for implementing new test decorator behaviors.
+
+
+
+ A test decorator applies actions to be performed around the initialization, setup,
+ execution, teardown and disposal lifecycle of a test (in that order).
+
+
+ This abstract class provides a convenient way to implement new test decorators
+ of your own. To add new behavior to the decorator, override the appropriate
+ lifecycle methods, such as
+
+ If you need more control over how the test is decorated, you may
+ prefer subclassing
+
+ When multiple test decorators are applied to a test, they are installed
+ in order according to the
+
+
+
+
+ Initializes the test.
+
+
+
+ Override this method to add your own behavior around the default actions.
+
+
+
+
+
+ Sets up the test.
+
+
+
+ Override this method to add your own behavior around the default actions.
+
+
+
+
+
+ Executes the test.
+
+
+
+ Override this method to add your own behavior around the default actions.
+
+
+
+
+
+ Tears down the test.
+
+
+
+ Override this method to add your own behavior around the default actions.
+
+
+
+
+
+ Disposes the test.
+
+
+
+ Override this method to add your own behavior around the default actions.
+
+
+
+
+
+
+
+ Specifies that a class represents a test fixture. This attribute is optional.
+
+
+
+ The test fixture attribute is applied to a class that contains a suite
+ of related test cases. If an error occurs while initializing the fixture
+ or if at least one of the test cases within the fixture fails,
+ then the fixture itself will be deemed to have failed. Otherwise the
+ fixture will pass.
+ Output from the fixture, such as text written to the console, is captured
+ by the framework and will be included in the test report.
+
+
+ A test fixture has no timeout by default. This may be changed
+ using the
+
+ This attribute may be omitted whenever a test fixture class contains at least
+ one test method or test parameter or when other MbUnit attributes are applied
+ to the test fixture class. This is almost always the case unless for some reason
+ you have an empty fixture.
+
+
+ The class must have a public default constructor. The class may not be static.
+
+
+
+
+
+ Specifies a method that is to be invoked to set up the state of a fixture
+ before any of its tests are executed.
+
+
+
+ The attribute may be applied to multiple methods within a fixture, however
+ the order in which they are processed is undefined.
+
+
+ The method to which this attribute is applied must be declared by the
+ fixture class and must not have any parameters. The method may be static.
+
+
+
+
+
+
+
+
+
+ Specifies a method that is to be invoked to tear down the state of a fixture
+ after all of its tests have been executed.
+
+
+
+ The attribute may be applied to multiple methods within a fixture, however
+ the order in which they are processed is undefined.
+
+
+ The method to which this attribute is applied must be declared by the
+ fixture class and must not have any parameters. The method may be static.
+
+
+
+
+
+
+
+
+
+ Specifies the test's relative importance which can be used for classifying tests
+ to be executed.
+
+
+
+ In MbUnit v2 this enum had the
+
+ In MbUnit v3, to indicate that a test belongs to multiple importance classes, decorate it with
+ multiple occurrences of the
+
+
+
+
+ Critical importance.
+
+
+
+
+ Severe importance. Less important than
+
+
+
+ Serious importance. Less important than
+
+
+
+ Default importance.
+
+
+
+
+ Not important.
+
+
+
+
+ Associates the name of the type under test with a test fixture, test method,
+ test parameter or other test component.
+
+
+
+ Specifying the type under test helps to describe which type is primarily being exercised
+ by the test. This way we can quickly identify which tests to run after making
+ changes to a given type. We can also use the TestsOn metadata as a filter so
+ that we can tell the test runner to only run tests about a particular type.
+
+
+ This attribute can be repeated multiple times if there are multiple types.
+
+
+
+
+
+ Associates the type under test with the test component annotated by this attribute.
+
+ Thrown if
+
+
+
+ Associates the full name or assembly qualified name of the type under test
+ with the test component annotated by this attribute.
+
+ Thrown if
+
+
+
+
+
+ Gets the full name or assembly qualified name of the type under test.
+
+
+ The name of the type under test as obtained by
+
+
+
+ Decorates a test method and causes it to be invoked repeatedly
+ on multiple concurrent threads.
+
+
+
+ Each repetition of the test method will occur within its own individually labeled
+ test step so that it can be identified in the test report.
+
+
+ The initialize, setup, teardown and dispose methods will are invoked around each
+ repetition of the test. Be aware that this means that these invocations may
+ occur concurrently!
+
+
+
+
+
+ Executes the test method on the specified number of concurrent threads.
+
+
+
+ Thrown if
+
+
+
+
+
+ Sets the maximum amount of time in seconds that a test or fixture is permitted to run.
+
+
+
+ The default timeout is unlimited for test fixtures and 10 minutes for test methods.
+
+
+
+
+
+ Sets the test timeout in seconds, or zero if none.
+
+ Thrown if
+
+
+
+
+
+ Gets the test timeout in seconds, or zero if none.
+
+
+
+
+ Gets the timeout, or null if none.
+
+
+
+
+ A strongly-typed resource class, for looking up localized strings, etc.
+
+
+
+
+ Returns the cached ResourceManager instance used by this class.
+
+
+
+
+ Overrides the current thread's CurrentUICulture property for all
+ resource lookups using this strongly typed resource class.
+
+
+
+
+ Looks up a localized string similar to <?xml version="1.0" encoding="utf-8"?>
+ <Database xmlns="Gallio.Framework.Data.Generation">
+ <!-- Reference: Countries or areas, codes and abbreviations (04/15/2009)
+ [http://unstats.un.org/unsd/methods/m49/m49alpha.htm] -->
+ <Item>James</Item>
+ <Item>Afghanistan</Item>
+ <Item>Åland Island</Item>
+ <Item>Albania</Item>
+ <Item>Algeria</Item>
+ <Item>American Samoa</Item>
+ <Item>Andorra</Item>
+ <Item>Angola</Item>
+ <Item>Anguilla</Item>
+ <Item>Antigua and Barbuda</Item>
+ <Item>Argentin [rest of string was truncated]";.
+
+
+
+
+ Looks up a localized string similar to <?xml version="1.0" encoding="utf-8"?>
+ <Database xmlns="Gallio.Framework.Data.Generation">
+ <Item>James</Item>
+ <Item>John</Item>
+ <Item>Robert</Item>
+ <Item>Michael</Item>
+ <Item>William</Item>
+ <Item>David</Item>
+ <Item>Richard</Item>
+ <Item>Charles</Item>
+ <Item>Joseph</Item>
+ <Item>Thomas</Item>
+ <Item>Christopher</Item>
+ <Item>Daniel</Item>
+ <Item>Paul</Item>
+ <Item>Mark</Item>
+ <Item>Donald</Item>
+ <Item>George</Item>
+ <Item>Kenneth</Item>
+ <Item>Steven</Item>
+ < [rest of string was truncated]";.
+
+
+
+
+ Looks up a localized string similar to <?xml version="1.0" encoding="utf-8"?>
+ <xs:schema
+ elementFormDefault="qualified"
+ targetNamespace="Gallio.Framework.Data.Generation"
+ xmlns:xs="http://www.w3.org/2001/XMLSchema">
+ <xs:element name="Database">
+ <xs:complexType>
+ <xs:sequence>
+ <xs:element maxOccurs="unbounded" name="Item" type="xs:string" />
+ </xs:sequence>
+ </xs:complexType>
+ </xs:element>
+ </xs:schema>.
+
+
+
+
+ Looks up a localized string similar to MbUnit v{0}.
+
+
+
+
+ Looks up a localized string similar to MbUnit v3.
+
+
+
+
+ The MbUnit test framework.
+
+
+
+
+
+
+ Gets the MbUnit version label.
+
+ A string similar to "MbUnit v3.1 build 200".
+
+
+
+ The MbUnit.Core namespace contains types used internally by MbUnit.
+
+
+
+
+ Contract for verifying the implementation of public type accessors, usually the getter and the setter of a particular property.
+
+
+
+ Built-in verifications:
+
+ -
+
SetValidValues : The setter accepts the values specified in the
+ -
+
SetInvalidValues : The setter rejects the values specified in the
+ -
+
SetNullValue : The setter rejects or accepts a null reference value according to the state of the
+
+
+
+
+
+ The following examples shows a simple class that contains a property, and a test fixture which declares an accessor
+ contract to verify the expected behavior of the subject property.
+
+ {
+ PropertyName = "Name",
+ AcceptNullValue = false,
+ ValidValues = { "Value1", "Value2" },
+ InvalidValues =
+ {
+ { typeof(ArgumentException), String.Empty }
+ }
+ };
+ }
+ ]]>
+
+ The type of the tested object which contain the accessors.
+ The type of the value handled by the accessors.
+
+
+
+ Default constructor.
+
+
+
+ Use the named parameters
+
+
+
+
+
+
+ Provides a default instance of the tested type.
+
+
+
+ By default, the contract verifier attempts to invoke the default constructor to get an valid instance.
+ Overwrite the default provider if the type has no default constructor, or if you want to use a particular instance.
+
+
+
+
+ {
+ DefaultInstance = () => new Foo("Hello")
+ // Other initialization stuff...
+ };
+ ]]>
+
+
+
+
+ Specifies an explicit way to set a value to the tested accessors.
+
+
+
+ Identify the tested accessors by using one of the following methods:
+
+ -
+
Explicitly invoke the getter and the setter. : Specify how to invoke to getter and
+ the setter by providing appropriate delegates to the
+ -
+
Specify the name of a property. : Set the name of the tested property by feeding the
+
+
+
+
+
+ The following example shows how to specify explicitely a getter and a setter.
+
+ {
+ Setter = (target, value) => target.Name = value,
+ Getter = (target) => target.Name,
+ ValidValues = { "Value1", "Value2" },
+ };
+ }
+ ]]>
+
+
+
+
+ Specifies an explicit way to get a value from the tested accessors.
+
+
+
+
+ Specifies the name of tested property.
+
+
+
+ Identify the tested accessors with one of the following methods:
+
+ -
+
Explicitly invoke the getter and the setter. : Specify how to invoke to getter and
+ the setter by providing appropriate delegates to the
+ -
+
Specify the name of a property. : Set the name of the tested property by feeding the
+
+
+
+
+
+ The following example shows how to specify the name of the property.
+
+ {
+ PropertyName = "Name",
+ ValidValues = { "Value1", "Value2" },
+ };
+ }
+ ]]>
+
+
+
+
+ Determines whether the tested accessors are expected to accept a null reference as a valid input.
+
+
+
+ If set to true , the setter is expected to accept a null reference as a valid value, and the getter
+ to return a null reference as well. If set to false , the setter is expected to reject a null reference assignment by
+ throwing a
+
+ The use of that contract property is optional, and its default state is true .
+
+
+
+
+
+ Defines a collection of distinct object instances that are expected to be inconditionally accepted as
+ valid input by the tested setter. Feeding that contract property with at least one value is mandatory.
+
+
+ The following example shows how to specify some valid values for the contract verifier:
+
+ {
+ PropertyName = "MyProperty",
+ ValidValues = { 123, 456, 789 },
+ };
+ }
+ ]]>
+
+
+
+
+ Defines a collection of incompetence classes which identify object instances that are expected to be not accepted
+ by the tested setter. Each incompetence class contains a collection of distinct object instance associated
+ with an expected exception type.
+
+
+
+ Specifying incompetent values is entirely optional. By default, the entire collection is empty; which causes the
+ test 'SetInvalidValues' to not be run.
+
+
+
+ The following example shows how to specify some incompetent values for the contract verifier. The example
+ assumes that the hypothetical 'Foo.MyProperty' property accepts any integer between 0 and 999, except 666
+ which is expected to throw a
+ {
+ PropertyName = "MyProperty",
+ ValidValues = { 123, 456, 789 },
+ IncompetentValues =
+ {
+ { typeof(ArgumentOutOfRangeException), -100, -999, 1000, 99999 },
+ { typeof(ArgumentException), 666 }
+ }
+ };
+ }
+ ]]>
+
+
+
+
+ The MbUnit.Framework.ContractVerifiers.Core namespace contains types that are used
+ as part of the internal implementation of contract verifiers.
+
+
+
+
+ A collection of distinct object instances associated with a particular exception type.
+
+
+
+ Every element represents an instance which is different from all the other
+ elements in the collection (object equality), and which is expected to be
+ the primary cause of an exception thrown when it is set or passed to
+ the tested method or property.
+
+
+ Distinct invalid instances are used by some contract verifiers such as
+
+
+
+ -
+ Use the single-parameter constructor to create an empty collection, which can be then
+ populated by calling explicitely the
(typeof(ArgumentException));
+ collection.Add(new Foo(1));
+ collection.Add(new Foo(2));
+ collection.Add(new Foo(3));
+ ]]>
+
+ -
+ Use the list initializer syntax, to create a collection initialized with some content.
+
(typeof(ArgumentException))
+ {
+ new Foo(1)
+ new Foo(2),
+ new Foo(3),
+ };
+ ]]>
+
+ -
+ Use the two-parameters constructor to create a collection from an pre-existing enumeration..
+
(typeof(ArgumentException), Foo.GetThemAll());
+ ]]>
+
+
+
+
+ The type of the object instances in the collection.
+
+
+
+ A collection of distinct object instances. Every element represents a valid instance
+ which is different from all the other elements in the collection (object equality).
+
+
+
+ Distinct instances are used by some contract verifiers such as
+
+
+ Use the default constructor followed by a list initializer.
+
+ {
+ new Foo(1)
+ new Foo(2),
+ new Foo(3),
+ };
+ ]]>
+
+
+ Or, use the single-parameter constructor to create a collection from an pre-existing enumeration.
+ (Foo.GetThemAll());
+ ]]>
+
+
+ The type of the object instances in the collection.
+
+
+
+ Constructs an empty collection of distinct object instances.
+
+
+
+ All the elements of the collection should be different (object equality).
+
+
+
+
+
+ Constructs acollection of distinct object instances from the specified
+ enumeration of elements.
+
+
+
+
+ Adds the specified instance to the collection.
+
+
+
+
+ Returns a strongly-typed enumerator that iterates through the collection.
+
+ A strongly-typed enumerator.
+
+
+
+ Gets all the instances.
+
+
+
+
+ Constructs an empty collection of distinct object instances associated with an exception type.
+
+
+
+ Use this constructor in conjunction with the (typeof(ArgumentException));
+ collection.Add(new Foo(1));
+ collection.Add(new Foo(2));
+ collection.Add(new Foo(3));
+ ]]>
+ Or by using the list initializer syntax.
+ (typeof(ArgumentException))
+ {
+ new Foo(1)
+ new Foo(2),
+ new Foo(3),
+ };
+ ]]>
+
+
+
+
+
+ Constructs a collection of distinct object instances associated with an exception type.
+
+
+
+ Every element represents an instance which is different from all the other
+ elements in the collection (object equality), and which is expected to be
+ the primary cause of an exception thrown when it is set or passed to
+ the tested method or property.
+
+
+
+
+
+ The type of the exception associated with the object instances in the collection.
+
+
+
+
+ A collection of classes of distinct object instances gathered by the type
+ of the exception which is expected to be raised when the subject instances are passed
+ to a tested method or property.
+
+
+
+ Distinct invalid instances are used by some contract verifiers such as
+
+
+ Use the default constructor to create an empty collection, then use the
+ ();
+ collection.Add(typeof(ArgumentException), new Foo(1), new Foo(2));
+ collection.Add(typeof(ArgumentOutOfRangeException), new Foo(3));
+ ]]>
+ Or by using the list initializer syntax, to feed the collection with classes of objects:
+
+ {
+ { typeof(ArgumentException), new Foo(1), new Foo(2) },
+ { typeof(ArgumentOutOfRangeException), new Foo(3) }
+ };
+ ]]>
+
+
+ The type of the object instances in the inner class collections.
+
+
+
+ Constructs an empty collection of classes of distinct object instances.
+
+
+
+ Each class identifies a collection of distinct object instances and the type
+ of the exception which is expected to be raised when the subject instances are passed
+ to the tested method or property.
+
+
+ Once the collection is created, populate it by using the ();
+ collection.Add(typeof(ArgumentException), new Foo(1), new Foo(2));
+ collection.Add(typeof(ArgumentOutOfRangeException), new Foo(3));
+ ]]>
+
+ {
+ { typeof(ArgumentException), new Foo(1), new Foo(2) },
+ { typeof(ArgumentOutOfRangeException), new Foo(3) }
+ };
+ ]]>
+
+
+
+
+
+ Adds the specified class of distinct object instance to the collection.
+
+
+
+
+ Adds a new class of distinct object instances to the collection.
+
+
+
+ The new class is created with the specified arguments.
+
+
+
+
+
+ Returns a strongly-typed enumerator that iterates through the collection.
+
+ A strongly-typed enumerator.
+
+
+
+ Gets the number of invalid classes in the collection.
+
+
+
+
+ Execution context of a contract verification test.
+
+
+
+
+ Constructs an execution context for the verification tests of a contract verifier.
+
+ Thrown if
+
+
+
+ Gets an artificial stack trace data that points to
+ the contract read-only field.
+
+ An artificial stack trace data that points to the contract read-only field.
+
+
+
+ Gets the code element for the contract read-only field.
+
+
+
+
+ Contract for verifying the implementation of the generic
+
+
+ Built-in verifications:
+
+ -
+
VerifyReadOnlyProperty : The
+ -
+
AddShouldThrowException : The read-only collection throws an exception when the method
+ false .
+
+ -
+
RemoveShouldThrowException : The read-only collection throws an exception when the method
+ false .
+
+ -
+
ClearShouldThrowException : The read-only collection throws an exception when the method
+ false .
+
+ -
+
AddNullArgument : The collection throwns a true .
+
+ -
+
RemoveNullArgument : The collection throwns a true .
+
+ -
+
ContainsNullArgument : The collection throws a true .
+
+ -
+
AddItems : The collection handles correctly with the addition of new items. The method
+ true .
+
+ -
+
RemoveItems : The collection handles correctly with the removal of items. The method
+ true .
+
+ -
+
ClearItems : The collection is cleared as expected when the method true .
+
+ -
+
CopyTo : The collection performs a copy of the items in an output array. The implementation is expected to
+ handle properly with null arguments, and a valid or an invalid index argument.
+
+
+
+
+ The type of the collection implementing
+ The type of items contained in the collection.
+
+
+
+ Default constructor.
+
+
+
+
+
+
+ Asserts that the collection of distinct instances specified by the user is not empty.
+
+
+
+
+ Creates a test that invokes an action over the collection, which
+ is supposed to not be supported. The test expects that an exception be thrown.
+
+
+
+
+ Creates a test which runs an action over the collection with
+ a null argument. The test expects that an exception be thrown.
+
+
+
+
+ Returns safely a default instance of the tested type.
+
+
+
+ An assertion failure is generated if the instance cannot be created.
+
+
+ A new instance of the tested type as specified in the contract.
+ Thrown if the instance cannot be generated.
+
+
+
+ Provides a default instance of the collection to test.
+
+
+
+ By default, the contract verifier attempts to invoke the default constructor to get an valid instance.
+ Overwrite the default provider if the collection has no default constructor, or if you want
+ the contract verifier to use a particular instance.
+
+
+
+
+ {
+ DefaultInstance = () => new MyCollection(1, 2, 3)
+ };
+ ]]>
+
+
+
+
+ Determines whether the tested collection is expected to be read-only.
+
+
+
+ The default value is false .
+
+
+
+
+
+ Determines whether the collection is expected to accept null references as valid items.
+
+
+
+ The default value is false .
+
+
+
+
+
+ Determines whether the collection is expected to accept several identical items (object equality).
+ The default value is true.
+
+
+
+ The default value is true .
+
+
+
+
+
+ Gets a collection of distinct object instances that feeds the different tests.
+
+
+
+ In order to optimize the tests, consider to provide:
+
+ -
+ items which are not in the default collection instance yet.
+
+ -
+ items which are in the default collection instance already (if not empty).
+
+
+
+
+
+
+
+ Contract for verifying the implementation of the generic
+
+
+ Since the generic
+ -
+
InsertShouldThrowException : The read-only collection throws an exception when the method
+ false .
+
+ -
+
RemoveAtShouldThrowException : The read-only collection throws an exception when the
+ method false .
+
+ -
+
IndexerSetShouldThrowException : The read-only collection throws an exception when the
+ setter of the indexer false .
+
+ -
+
InsertNullArgument : The collection throwns a true .
+
+ -
+
IndexOfNullArgument : The collection throwns a true .
+
+ -
+
IndexerSetNullArgument : The collection throwns a true .
+
+ -
+
InsertItems : The collection handles correctly with the insertion of new items. The method
+ true .
+
+ -
+
InsertItemsAtInvalidIndex : The collection handles correctly with the insertion of new
+ items at an invalid index. The method should throw an true .
+
+ -
+
RemoveItemsAt : The collection handles correctly with the removal of items at specific indexes.
+ The method true .
+
+ -
+
RemoveItemsAtInvalidIndex : The collection handles correctly with the removal of items at an
+ invalid index. The method should throw an true .
+
+ -
+
GetItemsAtInvalidIndex : The collection handles correctly with the retrieval of items at
+ an invalid index. The indexer should throw an
+ -
+
GetSetItemsWithIndexer : Setting and getting items by using the indexer property works as expected.
+ The test is not run when the contract property true .
+
+ -
+
IndexOfItem : The retrieval of the index of an item in the collection works as expected,
+ and the index can be used effectively to get the item with the getter of the indexer property.
+
+
+
+
+ The type of the collection implementing
+ The type of items contained by the list.
+
+
+
+
+
+ The MbUnit.Framework.ContractVerifiers namespace contains contracts (
+
+
+ For example the
+
+
+
+
+ Verifies that a contract has been satisfied.
+
+
+
+ This attribute is applied to a field of type
+
+ Contract verifiers can be incorporated into test fixtures in two ways.
+
+ - Contract stored in a readonly instance field. The contract verifier tests
+ will be generated dynamically at test execution time similarly to a
+
+ - Contract stored in a readonly
static instance field. The
+ contract verifier tests will be generated statically at test exploration time similarly to a
+
+
+
+
+
+ ();
+
+ // "static" contract verifier (similar to a StaticTestFactory)
+ [VerifyContract]
+ public readonly static IContract Contract2 = new ListContract, int>();
+ }
+ ]]>
+
+
+
+
+
+
+
+
+ Verifies that the attribute is being used correctly.
+
+ Thrown if the attribute is being used incorrectly.
+
+
+
+ Initializes a test for a contract verifier field after it has been added to the test model.
+
+
+
+
+ Generates static or dynamic tests from the contract.
+
+
+
+
+
+
+ Decorates a test method and causes a screenshot to be automatically embeded when a trigger event occurs.
+
+
+
+ If screenshots cannot be captured, the attribute will embed a warning message to that effect.
+
+
+
+
+
+ Automatically embeds a screenshot when a trigger event occurs.
+
+
+
+ If screenshots cannot be captured, the method will embed a warning message to that effect.
+
+
+
+
+
+
+
+
+
+ Gets the trigger event.
+
+
+
+
+ Gets the capture parameters.
+
+
+
+
+ Gets or sets the name to give to the image attachment.
+ (default is null)
+
+
+
+ The property is null by default, which causes the name of the attachment to be assigned automatically.
+
+
+
+
+
+ Gets or sets the zoom factor.
+
+
+
+ The zoom factor specifies the degree of magnification or reduction desired.
+ For example, a zoom factor of 1.0 (the default) is normal size, 0.25 reduces to one quarter the
+ original size and 2.0 magnifies to twice the original size.
+
+
+ Thrown if
+
+
+
+ Decorates a test method and causes a video of the test run to be automatically embeded when a trigger event occurs.
+
+
+
+ If screenshots cannot be captured, the attribute will embed a warning message to that effect.
+
+
+
+
+
+ Automatically embeds a video of the test run from this point forward when a trigger event occurs.
+
+
+
+ Recording a screen capture video can be very CPU and space intensive particularly
+ when running tests on a single-core CPU. We recommend specifying a zoom with of 0.25 or
+ less and a frame rate of no more than 5 to 10 frames per second.
+
+
+ If screenshots cannot be captured, the method will embed a warning message to that effect.
+
+
+
+
+
+
+
+
+
+ Gets or sets the number of frames per second to capture (default is 5).
+
+
+
+
+ An abstract base class for custom comparer attributes.
+
+
+
+ The custom comparer attributes expose an extension point of
+
+
+
+
+ Constructor.
+
+
+
+
+
+
+ Registers a custom comparison operation for the specified type.
+
+
+
+
+ Registers the custom comparison operation for the specified type.
+
+
+
+
+ Gets the entry point for the registration of
+ custom actions that extend the framework.
+
+
+
+
+ Declares a custom type converter.
+
+
+
+ That attribute must be used on a static method taking one single parameter of the source type, and returning a value of the target type.
+
+
+
+
+
+
+
+
+
+
+
+ Provides binary data from resource contents.
+
+
+
+ This example reads data from an Embedded Resource called Data.bin within the
+ same namespace as the test fixture.
+
+
+
+
+
+
+
+
+
+ Provides text data from resource contents.
+
+
+
+ This example reads data from an Embedded Resource called Data.txt within the
+ same namespace as the test fixture.
+
+
+
+
+
+
+
+
+
+ Declares a custom type formatter.
+
+
+
+ That attribute must be used on a static method taking one single parameter of the source type, and returning a string describing the object.
+
+
+
+
+
+
+
+
+
+
+
+ Declares a custom type equality comparer.
+
+
+
+ That attribute must be used on a static method which takes 2 parameters of the same type, and return a
+
+
+
+
+
+
+
+
+
+
+
+
+ Declares a custom type comparer.
+
+
+
+ That attribute must be used on a static method which takes 2 parameters of the same type, and return a
+
+
+
+
+
+
+
+
+
+
+
+
+ Optional settings for the XML equality assertions.
+
+
+
+
+
+
+
+
+
+ The default settings for the XML equality assertions.
+
+
+
+ Those settings specify to ignore the order of the elements and the attributes located
+ in the same parent element, and to ignore the comment tags as well.
+
+
+
+ Peary Caribou"
+ string actual = "Peary Caribou "
+ Assert.Xml.AreEqual(expected, actual, XmlOptions.Default); // Pass!
+ }
+ ]]>
+
+
+
+
+ The strictest settings for the XML equality assertions.
+
+
+
+ The strictest settings expect the elements and the attributes to be in the same order as
+ in the expected XML data, and makes case sensitive string comparisons for the name and the
+ value of the elements and the attributes. Comment tags are included in the comparison
+ process as well.
+
+
+
+ " +
+ "
+ " " +
+ "
+ " "
+ Assert.Xml.AreEqual(expected, actual, XmlOptions.Strict); // Pass!
+ }
+ ]]>
+
+
+
+
+ The loosest settings for the XML equality assertions.
+
+
+
+ The settings ignored the order of the elements and the attributes located in the
+ same parent element. It makes case insensitive string comparisons for the name and
+ the value of the attributes and the elements. It ignored the comment tags as well.
+
+
+
+ " +
+ "
+ " " +
+ " "
+ Assert.Xml.AreEqual(expected, actual, XmlOptions.Loose); // Pass!
+ }
+ ]]>
+
+
+
+
+ Custom settings for the XML equality assertions.
+
+
+
+ Lets you define your own equality settings. Combine the different available options together
+ to specify how the equality between 2 provided XML fragments must be done.
+
+
+
+ Peary Caribou"
+ string actual = "Peary Caribou "
+ Assert.Xml.AreEqual(expected, actual, XmlOptions.Custom.IgnoreComments.IgnoreElementsCaseName.IgnoreAttributesOrder); // Pass!
+ }
+ ]]>
+
+
+
+
+ Gets the inner value.
+
+
+
+
+ Customizable optional settings for the XML equality assertions.
+
+
+
+
+ Indicates that the name of the XML elements must be compared with case insensitivity.
+
+
+ Peary Caribou"
+ string actual = "Peary Caribou "
+ Assert.Xml.AreEqual(expected, actual, XmlOptions.Custom.IgnoreElementsNameCase); // Pass!
+ }
+ ]]>
+
+
+
+
+ Indicates that the value of the XML elements must be compared with case insensitivity.
+
+
+ Peary Caribou"
+ string actual = "PEaRY CaRiboU "
+ Assert.Xml.AreEqual(expected, actual, XmlOptions.Custom.IgnoreElementsValueCase); // Pass!
+ }
+ ]]>
+
+
+
+
+ Indicates that the name of the XML attributes must be compared with case insensitivity.
+
+
+ "
+ string actual = "
+
+
+
+
+ Indicates that the value of the XML attributes must be compared with case insensitivity.
+
+
+ "
+ string actual = "
+
+
+
+
+ Indicates that the order of the child elements within a given parent element must be ignored.
+
+
+ " +
+ " " +
+ " "
+ Assert.Xml.AreEqual(expected, actual, XmlOptions.Custom.IgnoreElementsOrder); // Pass!
+ }
+ ]]>
+
+
+
+
+ Indicates that the order of the attributes within the same element must be ignored.
+
+
+ " + // 3rd
+ string actual = " 1st!
+ " species='tarandus'" + // 3rd -> 2nd!
+ " name='Peary Caribou' />" + // 1st -> 3rd!
+ Assert.Xml.AreEqual(expected, actual, XmlOptions.Custom.IgnoreAttributesOrder); // Pass!
+ }
+ ]]>
+
+
+
+
+ Indicates that the comment tags should be ignored during the comparison.
+
+
+ " +;
+ string actual = "
+
+
+
+
+ Combines the options
+
+
+
+ Combines the options
+
+
+
+ Combines the options
+
+
+
+ Combines the options
+
+
+
+ Run a test or a test fixture under another user account.
+
+
+
+ PrincipalAttribute is an abstract class. You must derive your own attribute from this class,
+ and implement
+
+
+
+
+
+
+ Creates a principal object which represents the security context
+ of the user on whose behalf the test is running.
+
+ A principal object.
+
+
+
+
+
+ Run a test or a test fixture under different cultures.
+
+
+ The following example demonstrates a simple test run under multiple cultures.
+ It will pass under en-US culture but fail under en-GB.
+
+
+
+
+ Initializes a new instance of the
+ Thrown if
+
+
+
+
+
+ Run a test or a test fixture under another user account.
+
+
+
+
+
+
+
+
+ Gets or sets the user name.
+
+
+
+
+ Gets or sets the password.
+
+
+
+
+ Gets or sets the domain where the user is defined.
+
+
+
+ If not specified, the domain is supposed to be the local machine.
+
+
+
+
+
+ The MbUnit.Framework namespace provides the MbUnit Test Framework, an extensible
+ attribute-based test framework for .Net.
+
+
+
+
+ Identifies a stock of predefined string values for the random strings generator.
+
+
+
+
+ A predefined collection of random US male names.
+
+
+
+
+ A predefined collection of random country names.
+
+
+
+ Reference: Countries or areas, codes and abbreviations .
+
+
+
+
+
+ Provides a column of random
+
+
+ Initialize the random string generator by setting the named parameter
+
+ The
+ -
+
Logical Grouping : Group a part of the expression ((...) ).
+
+ -
+
Explicit Set : Define a set of possible characters ([...] ).
+ Ranges defined with a tiret are accepted.
+
+ -
+
Explicit Quantifier : Specify the number of times the previous expression must be repeated.
+ 'Constant' ({N} ) or 'Range' ({N,M} ) syntax are both accepted.
+
+ -
+
Zero Or One Quantifier Metacharacter : 0 or 1 of the previous expression (? ).
+ Same effect as {0,1} .
+
+ -
+
Escape Character : Makes the next character literal instead of a special character (\ ).
+
+
+
+
+ The
+
+
+
+
+
+
+ Provides a column of sequential values as a data source.
+
+
+
+
+ Default constructor.
+
+
+
+
+
+
+ Returns a generator of random values.
+
+ A generator.
+
+
+
+ Adds a column of random
+
+
+
+
+
+ Gets or sets a regular expression pattern to generate random string from.
+
+
+
+
+ Gets or sets the stock of predefined strings from which to draw random values.
+
+
+
+
+ Gets or sets the number of random values that are going to be generated.
+
+
+
+
+ Gets or sets the name of a method present in the test fixture
+ whose purpose is to prevent some specific values to be generated.
+
+
+
+ The method must accepts one argument of the type
+
+
+
+
+
+
+
+
+ Provides a column of sequential
+
+
+ The sequence is initialized by setting 3 of the 4 available named properties.
+ The following combinations are possible:
+
+
+
+
+
+
+
+
+
+ Adds a column of sequential
+
+
+
+
+
+ Gets or sets the starting value of the sequence.
+
+
+
+ That property is used to define the sequence, when used with other properties:
+
+
+
+
+
+
+
+ Gets or sets the ending value of the sequence.
+
+
+
+ That property is used to define the sequence, when used with 2 other properties:
+
+
+
+
+
+
+
+ Gets or sets the increment between each value of the sequence.
+
+
+
+ That property is used to define the sequence, when used with 2 other properties:
+
+
+
+
+
+
+
+ Gets or sets the length of the sequence.
+
+
+
+ That property is used to define the sequence, when used with 2 other properties:
+
+
+
+
+
+
+
+ Gets or sets the name of a method present in the test fixture
+ whose purpose is to prevent some specific values to be generated.
+
+
+
+ The method must accepts one argument of a type that represents a number, such as
+
+
+
+
+
+
+ Provides a column of random
+
+
+ Initialize the random number generator by setting the 3 named parameters
+
+
+
+
+
+
+ Adds a column of random
+
+
+
+
+
+ Gets or sets the lower bound of the numeric range where random values are going to be generated.
+
+
+
+
+ Gets or sets the upper bound of the numeric range where random values are going to be generated.
+
+
+
+
+ Gets or sets the number of random values that are going to be generated.
+
+
+
+
+ Gets or sets the name of a method present in the test fixture
+ whose purpose is to prevent some specific values to be generated.
+
+
+
+ The method must accepts one argument of a type that represents a number, such as
+
+
+
+
+
+
+ Specifies the scope to which certain attributes apply.
+
+
+
+
+ Applies to this test only.
+
+
+
+
+ Applies to the descendants of this test only.
+
+
+
+
+ Applies to this test and its descendants.
+
+
+
+
+ Provides a column of enumeration values as a data source.
+
+
+
+ Each value from the specified enumeration type is used as input for the
+ data-driven test method.
+
+
+ It is possible to exclude some specific values of the enumeration from the column.
+ Use
+
+
+
+
+
+
+ Adds a column of enumeration values.
+
+ The specified type is null.
+ The specified type is not an enumeration type.
+
+
+
+
+
+ Gets the type of the enumeration.
+
+
+
+
+ Sets or gets the single enumeration value that must be excluded from the column.
+
+
+
+ If you want to exclude several values at once, use
+
+
+
+
+ Sets or gets an array of values that must be excluded from the column.
+
+
+
+ If you want to exclude one value only, use
+
+
+
+
+ Specifies the default test case timeout for all tests in the test assembly.
+
+
+
+ Defaults to 10 minutes.
+
+
+
+
+
+ Sets the default timeout in seconds, or zero if none.
+
+ Thrown if
+
+
+
+
+
+ Gets the default timeout in seconds, or zero if none.
+
+
+
+
+ Gets the timeout, or null if none.
+
+
+
+
+ Specifies the maximum number of concurrent threads to use when tests are run in parallel
+ for all tests in the test assembly.
+
+
+
+ Defaults to
+
+
+
+
+ Specifies the maximum number of concurrent threads to use when tests are run in parallel.
+
+ Thrown if
+
+
+
+
+
+ Gets the degree of parallelism.
+
+
+
+
+ Expected sorting order for the
+
+
+
+ Each value is expected to be greater than or equal to the previous value.
+
+
+
+
+ Each value is expected to be strictly greater than the previous value.
+
+
+
+
+ Each value is expected to be less than or equal to the previous value.
+
+
+
+
+ Each value is expected to be strictly less than the previous value.
+
+
+
+
+ A general-purpose structural equality comparer that defines a fully customizable equality operation without the
+ need to implement
+
+
+ That equality comparer can be used in any MbUnit assertion that takes an
+
+ The comparer must be initialized with a list of one or several matching criteria. Two instances are considered
+ equal by the comparer if and only if all the criteria are true for that pair of instances.
+
+
+
+ The following example shows a test fixture that checks for the equality between two Foo
+ objects by using the well known Foo objects equal when the Value
+ fields have the same parity, and when the Text fields are equal (case insensitive):
+
+ {
+ { x => x.Value, (x, y) => x % 2 == y % 2 },
+ { x => x.Text, (x, y) => String.Compare(x, y, true) == 0 }
+ });
+ }
+ }
+ ]]>
+
+ The type of the objects. to compare.
+
+
+
+ Adds a matching criterion to the structural equality comparer.
+
+
+
+ The values returned by the accessor are compared by using a default comparison evaluator.
+
+
+
+
+ {
+ { x => x.Value },
+ });
+ }
+ }
+ ]]>
+
+ The type of the value returned by the accessor.
+ The specified accessor argument is a null reference.
+
+
+
+ Adds a matching criterion to the structural equality comparer.
+
+
+
+ The values returned by the accessor are compared by using the specified comparer object.
+
+
+
+
+ {
+ public bool Equals(int x, int y)
+ {
+ return x == y;
+ }
+
+ public int GetHashCode(int obj)
+ {
+ return obj;
+ }
+ }
+
+ [TestFixture]
+ public class FooTest
+ {
+ [Test]
+ public void MyTest()
+ {
+ var foo1 = new Foo() { Value = 123 };
+ var foo2 = new Foo() { Value = 123 };
+
+ Assert.AreEqual(foo1, foo2, new StructuralEqualityComparer
+ {
+ { x => x.Value, new MyComparer() },
+ });
+ }
+ }
+ ]]>
+
+ The type of the value returned by the accessor.
+ The specified accessor argument is a null reference.
+
+
+
+ Adds a matching criterion to the structural equality comparer.
+
+
+
+ The values returned by the accessor are compared by using the specified comparison delegate.
+
+
+
+
+ {
+ { x => x.Value, (x, y) => x == y },
+ });
+ }
+ }
+ ]]>
+
+ The type of the value returned by the accessor.
+ The specified accessor argument is a null reference.
+
+
+
+ Adds a matching criterion to the structural equality comparer.
+
+
+
+ The evaluation process is done through the specified comparison delegate.
+
+
+
+
+ {
+ { (x, y) => x.Value == y.Value },
+ });
+ }
+ }
+ ]]>
+
+
+
+
+ Adds a matching criterion to the structural equality comparer.
+
+
+
+ The evaluation process is done through the specified comparer object.
+
+
+
+
+ {
+ public bool Equals(Foo x, Foo y)
+ {
+ return x.Value == y.Value;
+ }
+
+ public int GetHashCode(int obj)
+ {
+ return obj;
+ }
+ }
+
+ [TestFixture]
+ public class FooTest
+ {
+ [Test]
+ public void MyTest()
+ {
+ var foo1 = new Foo() { Value = 123 };
+ var foo2 = new Foo() { Value = 123 };
+
+ Assert.AreEqual(foo1, foo2, new StructuralEqualityComparer
+ {
+ { new MyComparer() },
+ });
+ }
+ }
+ ]]>
+
+
+
+
+ Adds a matching criterion to the structural equality comparer.
+
+
+
+ The enumerations of values returned by the accessor are compared one by one,
+ by using the specified comparer.
+
+
+
+
+ {
+ { x => x.Values,
+ new StructuralEqualityComparer { { x => x } }
+ },
+ });
+ }
+ }
+ ]]>
+
+ The type of the value returned by the accessor.
+ The specified accessor argument is a null reference.
+
+
+
+ Adds a matching criterion to the structural equality comparer.
+
+
+
+ The enumerations of values returned by the accessor are compared by using the specified comparer.
+
+
+
+
+ {
+ { x => x.Values,
+ new StructuralEqualityComparer { { x => x } },
+ StructuralEqualityComparerOptions.IgnoreEnumerableOrder
+ },
+ });
+ }
+ }
+ ]]>
+
+ The type of the value returned by the accessor.
+ The specified accessor argument is a null reference.
+
+
+
+ Adds a matching criterion to the structural equality comparer.
+
+
+
+ The enumerations of values returned by the accessor are compared by using the specified comparer.
+
+
+
+
+ {
+ { x => x.Values,
+ new StructuralEqualityComparer { { x => x } },
+ StructuralEqualityComparerOptions.IgnoreEnumerableOrder
+ },
+ });
+ }
+ }
+ ]]>
+
+ The type of the value returned by the accessor.
+ The specified accessor argument is a null reference.
+
+
+
+ Determines whether the specified objects are equal.
+
+ true if the specified objects are equal; otherwise, false.
+
+
+
+ Returns a hash code for the specified object.
+
+ A hash code for the specified object.
+ The type of obj is a reference type and obj is null.
+
+
+
+ Returns a strongly-typed enumerator that iterates through the collection.
+
+ A strongly-typed enumerator that iterates through the collection.
+
+
+
+ Gets a default neutral structural equality comparer for the tested type.
+
+
+
+ The default comparer uses
+
+
+
+
+ Comparison options for the structural equality comparer.
+
+
+
+
+ Default options.
+
+
+
+
+ Compares the two child sequences by ignoring the order of the elements.
+
+
+
+
+ Provides data from XML contents.
+
+
+
+ An XML data set selects nodes from an XML document using XPath
+ expressions. The selected nodes are returned as
+
+ Two XPath expressions are used.
+
+ -
+
Item Path : An XPath expression that selects a set of nodes that are used to
+ uniquely identify records. For example, the item path might be used to select
+ the containing element of each Book element in an XML document of Books.
+ The item path is specified in the constructor.
+
+ -
+
Binding Path : An XPath expression that selects a node relative to the item path
+ that contains a particular data value of interest. For example, the binding path
+ might be used to select the Author attribute of a Book element in an XML document of Books.
+ The binding path is specified by the
+
+
+
+
+
+ The XML may contain metadata at the row level by adding metadata elements in the
+ http://www.gallio.org/ namespace containing metadata entries. In the following example,
+ the row values would be selected using an Item Path of "//row" and a Binding Path of "@value".
+ Additionally, some rows would have metadata as specified.
+
+
+
+
+
+ |
+
+ ]]>
+
+
+ This example reads data from an Embedded Resource called Data.xml within the
+ same namespace as the test fixture. Notice that the binding xpath expressions
+ are specified for each parameter using the
+
+ Data files:
+
+ -
+
0.85
+ 3
+
+ -
+
0.10
+ 10
+
+ <-- Comment: mmm! -->
+ -
+
2.25
+ 1
+
+
+ ]]>
+
+
+ A simple test.
+
+
+
+
+
+ Specifies a XML-based data source.
+
+ Thrown if
+
+
+
+
+
+ Contract for verifying the implementation of the generic
+
+
+ Built-in verifications:
+
+ -
+
ComparableCompareTo : The type implements the method
+ -
+
OperatorGreaterThan : The type has a static "Greater Than" operator overload which behaves
+ correctly against the provided equivalence classes. Disable that test by setting
+ the false .
+
+ -
+
OperatorGreaterThanOrEqual : The type has a static "Greater Than Or Equal" operator
+ overload which behaves correctly against the provided equivalence classes. Disable that test by setting
+ the false .
+
+ -
+
OperatorLessThan : The type has a static "Less Than" operator overload which behaves
+ correctly against the provided equivalence classes. Disable that test by setting
+ the false .
+
+ -
+
OperatorLessThanOrEqual : The type has a static "Less Than Or Equal" operator
+ overload which behaves correctly against the provided equivalence classes. Disable that test by setting
+ the false .
+
+
+
+
+
+ The following example shows a simple class implementing the
+
+ {
+ private int value;
+
+ public SampleComparable(int value)
+ {
+ this.value = value;
+ }
+
+ public int CompareTo(SampleComparable other)
+ {
+ return Object.ReferenceEquals(other, null)
+ ? Int32.MaxValue
+ : value.CompareTo(other.value);
+ }
+
+ public static bool operator >=(SampleComparable left, SampleComparable right)
+ {
+ return (Object.ReferenceEquals(left, null)
+ && Object.ReferenceEquals(right, null))
+ || (!Object.ReferenceEquals(left, null)
+ && (left.CompareTo(right) >= 0));
+ }
+
+ public static bool operator <=(SampleComparable left, SampleComparable right)
+ {
+ return Object.ReferenceEquals(left, null)
+ || (left.CompareTo(right) <= 0);
+ }
+
+ public static bool operator >(SampleComparable left, SampleComparable right)
+ {
+ return !Object.ReferenceEquals(left, null)
+ && (left.CompareTo(right) > 0);
+ }
+
+ public static bool operator <(SampleComparable left, SampleComparable right)
+ {
+ return (!Object.ReferenceEquals(left, null)
+ || !Object.ReferenceEquals(right, null))
+ && (Object.ReferenceEquals(left, null)
+ || (left.CompareTo(right) < 0));
+ }
+
+ public class SampleComparableTest
+ {
+ [VerifyContract]
+ public readonly IContract EqualityTests = new ComparisonContract
+ {
+ ImplementsOperatorOverloads = true, // Optional (default is true)
+ EquivalenceClasses =
+ {
+ { new SampleComparable(1) },
+ { new SampleComparable(2) },
+ { new SampleComparable(3) },
+ { new SampleComparable(4) },
+ { new SampleComparable(5) }
+ }
+ };
+ }
+ ]]>
+
+ The type of the object to evaluate.
+
+
+
+ Default constructor.
+
+
+
+
+
+
+ Determines whether the verifier will evaluate the presence and the
+ behavior of the 4 operator overloads "Greater Than", "Greater Than
+ Or Equal", "Less Than", and "Less Than Or Equal".
+
+
+
+ The default value is true .
+
+
+
+
+
+ Gets or sets the collection of equivalence classes of instances
+ to feed the contract verifier.
+
+
+
+
+ Contract for verifying the implementation of the generic
+
+
+ Built-in verifications:
+
+ -
+
ObjectEquals : The
+ -
+
ObjectGetHashCode : The
+ -
+
EquatableEquals : The
+ -
+
OperatorEquals : The type has a static equality operator (==) overload which behaves
+ correctly against the provided equivalence classes. Disable that test by setting
+ the false .
+
+ -
+
OperatorNotEquals : The type has a static inequality operator (!=) overload which
+ behaves correctly against the provided equivalence classes. Disable that test by
+ setting the false .
+
+
+
+
+
+ The following example shows a simple class implementing the
+
+ {
+ private int value;
+
+ public SampleEquatable(int value)
+ {
+ this.value = value;
+ }
+
+ public override int GetHashCode()
+ {
+ return value.GetHashCode();
+ }
+
+ public override bool Equals(object obj)
+ {
+ return Equals(obj as SampleEquatable);
+ }
+
+ public bool Equals(SampleEquatable other)
+ {
+ return !Object.ReferenceEquals(other, null)
+ && (value == other.value);
+ }
+
+ public static bool operator ==(SampleEquatable left, SampleEquatable right)
+ {
+ return (Object.ReferenceEquals(left, null)
+ && Object.ReferenceEquals(right, null))
+ || (!Object.ReferenceEquals(left, null)
+ && left.Equals(right));
+ }
+
+ public static bool operator !=(SampleEquatable left, SampleEquatable right)
+ {
+ return !(left == right);
+ }
+ }
+
+ public class SampleEquatableTest
+ {
+ [VerifyContract]
+ public readonly IContract EqualityTests = new EqualityContract
+ {
+ ImplementsOperatorOverloads = true, // Optional (default is true)
+ EquivalenceClasses =
+ {
+ { new SampleEquatable(1) },
+ { new SampleEquatable(2) },
+ { new SampleEquatable(3) },
+ { new SampleEquatable(4) },
+ { new SampleEquatable(5) }
+ }
+ };
+ }
+ ]]>
+
+ The target tested type which implements the generic
+
+
+
+ Default constructor.
+
+
+
+
+
+
+ Determines whether the verifier will evaluate the presence and the
+ behavior of the equality and the inequality operator overloads.
+
+
+
+ The default value is true .
+
+
+ Built-in verifications:
+
+ - The type has a static equality operator (==) overload which
+ behaves correctly against the provided equivalence classes.
+ - The type has a static inequality operator (!=) overload which
+ behaves correctly against the provided equivalence classes.
+
+
+
+
+
+
+ Gets or sets the collection of equivalence classes of instances
+ to feed the contract verifier.
+
+
+
+
+ Contract for verifying the implementation of a custom exception type.
+
+
+
+ Built-in verifications:
+
+ -
+
HasSerializableAttribute : The exception type has the false .
+
+ -
+
HasSerializationConstructor : The exception type has a protected serialization
+ constructor similar to false .
+
+ -
+
IsDefaultConstructorWellDefined : The exception type has a default parameter-less
+ constructor. When the true as well, the method verifies that the properties of
+ the exception are preserved during a roundtrip serialization. Disable the test
+ by settings the false .
+
+ -
+
IsMessageConstructorWellDefined : The exception type has single argument constructor
+ for the message. When the true as well, the method verifies that the properties of
+ the exception are preserved during a roundtrip serialization. Disable the test
+ by settings the false .
+
+ -
+
IsMessageAndInnerExceptionConstructorWellDefined : The exception type has two
+ parameters constructor for the message and an inner exception.
+ When the true as well, the method verifies that the properties of
+ the exception are preserved during a roundtrip serialization. Disable the test
+ by settings the false .
+
+
+
+
+
+ The following example shows a simple custom exception class with some
+ basic serialization support, and a test fixture which uses the
+ exception contract to test it.
+ ()
+ {
+ ImplementsSerialization = true, // Optional (default is true)
+ ImplementsStandardConstructors = true // Optional (default is true)
+ };
+ }
+ ]]>
+
+ The target custom exception type.
+
+
+
+ Default constructor.
+
+
+
+
+
+
+ Verifies that the
+
+
+
+ Performs round-trip serialization of the exception and returns the result.
+
+ The instance produced after serialization and deserialization.
+
+
+
+ Determines whether the verifier will check for the serialization support.
+
+
+
+ The default value is true .
+
+
+ Built-in verifications:
+
+ - The exception implements the
+ - The exception has the
+ - The exception type has a protected serialization constructor similar to
+
+
+
+
+
+
+
+ Determines whether the verifier will check for the presence of
+ the recommended standard constructors.
+
+
+
+ The default value is true .
+
+
+ Built-in verifications:
+
+ - The exception has a default parameter-less constructor.
+ - The exception has a single parameter constructor for the message.
+ - The exception two parameters constructor for the message and an inner exception.
+
+
+
+
+
+
+ Contract for verifying the implementation of an immutable type.
+
+
+
+ Built-in verifications:
+
+ -
+
AreReadOnlyFields : All the public and non-public instance fields are marked
+ as read only. The evaluation is made recursively on the field types too.
+
+ -
+
HasNoPublicPropertySetter : The type does not have any public property setter.
+ The evaluation is made recursively on the property types too.
+
+
+
+
+
+ The following example shows a simple immutable class with all the
+ instance fields marked as read only, and a test fixture which invokes the
+ immutability contract to test the class.
+ ();
+ }
+ ]]>
+
+ The target immutable type.
+
+
+
+ Default constructor.
+
+
+
+
+
+
+ Specifies that a test can be run in parallel with other parallelizable tests.
+
+
+
+ If this attribute is not specified, then the test will be run with Process-level
+ isolation. That is, it will not run concurrently with any other test within the
+ given process (notwithstanding any use of
+
+ Parallelizable tests are run in batches subject to the hierarchical structure of
+ the tests, any explicit ordering specifications, and test dependencies.
+
+
+ If two tests must be run exclusively of one another but are otherwise parallelizable,
+ then a simple expedient is to assign a different test order to each one. Later editions
+ of the framework may introduce additional controls over test isolation, mutual exclusion,
+ access to shared resources, and degree of paralleism.
+
+
+ To make all tests within a fixture parallelizable, apply this attribute to
+ the fixture class with a scope of
+
+
+
+ This C# example shows a fixture with a few tests, two of which are parallelizable.
+
+
+ This C# example shows a fixture all of whose tests are parallelizable.
+
+
+ This C# example shows a test assembly all of whose tests are parallelizable.
+
+
+
+
+
+ Specifies that this test is parallelizable.
+
+
+
+
+ Specifies that the tests in the specified scope are parallelizable.
+
+
+
+
+
+
+ Gets the scope to which the parallelizable attribute applies.
+
+
+
+
+ Specifies a method that is used to generate tests statically at
+ test exploration time.
+
+
+
+ The tests created by the static test factory are considered to be children
+ of the fixture that contains the factory method that generated them.
+ Because the tests are created statically, they will appear in the test
+ runner and they can be filtered as usual. However, this means that the
+ tests will be generated only when the fixture is being explored rather
+ than each time the fixture is executed. It also means that the factory
+ method must be static and cannot be parameterized.
+
+
+ Contrast with
+
+ The method to which this attribute is applied must be declared by the
+ fixture class. It must be static and must not have any parameters.
+ It must return an enumeration of values of type
+
+ Tests built by a
+
+
+
+ A simple static test factory that reads some data from a file and generates
+ a number of static tests. The file is read at test exploration time,
+ so if the file changes, the test package must be reloaded to obtain the new
+ contents.
+ CreateStaticTests()
+ {
+ foreach (string searchTerm in File.ReadAllLines("SearchTerms.txt"))
+ {
+ yield return new TestCase("Search Term: " + searchTerm, () => {
+ var searchEngine = new SearchEngine();
+ Assert.IsNotEmpty(searchEngine.GetSearchResults(searchTerm));
+ });
+ }
+ }
+ ]]>
+
+
+
+
+
+
+
+
+
+ Describes a test generated either at test exploration time or at test
+ execution time by a test factory.
+
+
+
+ Tests can be nested to form test suites and other aggregates.
+
+
+
+
+ Produces a suite of static tests as part of a containing test fixture.
+ The suite includes some custom set-up and tear-down behavior, metadata,
+ a timeout, an order relative to the other tests in the fixture, and a list
+ of children. There are two test cases defined in line, and one reference
+ to another statically defined test elsewhere.
+ TestSuite()
+ {
+ yield return new TestSuite("My Suite")
+ {
+ Description = "An example test suite.",
+ Metadata =
+ {
+ { MetadataKeys.AuthorName, "Me" },
+ { MetadataKeys.AuthorEmail, "me@mycompany.com" }
+ },
+ SuiteSetUp = () => DatabaseUtils.SetUpDatabase(),
+ SuiteTearDown = () => DatabaseUtils.TearDownDatabase(),
+ Timeout = TimeSpan.FromMinutes(2),
+ Children =
+ {
+ new TestCase("Test 1", () => {
+ // first test in suite
+ }),
+ new TestCase("Test 2", () => {
+ // second test in suite
+ }),
+ new TestFixtureReference(typeof(OtherFixtureToIncludeInSuite))
+ }
+ };
+ }
+ ]]>
+
+
+
+
+
+ Builds a collection of static tests during test exploration.
+
+ Thrown if
+
+
+
+ Runs a collection of dynamic tests during test execution.
+
+ Thrown if
+
+
+
+ Builds a static test during test exploration.
+
+
+
+ Subclasses may override this behavior to change how the static test
+ gets added to the test model.
+
+
+
+
+
+ Runs a dynamic test during test execution.
+
+
+
+ Subclasses may override this behavior to change how the dynamic test
+ is executed as a test step.
+
+
+
+
+
+ Describes a test case generated either at test exploration time or at test
+ execution time by a test factory.
+
+
+
+ A test case has a timeout of 10 minutes by default. This may be changed
+ setting the
+
+ Refer to the examples on the
+
+
+
+
+ Abstract class for custom test definitions such as generated test cases
+ and test suites.
+
+
+
+
+ Creates a test.
+
+ Thrown if
+
+
+
+
+
+
+
+ Gets the children of this test.
+
+
+
+ The default implementation returns an empty array. Subclasses may
+ override this behavior as appropriate.
+
+
+
+
+
+ Runs set-up code before execute and before all children.
+
+
+
+ The default implementation does nothing. Subclasses may override this
+ behavior.
+
+
+
+
+
+ Runs tear-down code after execute and after all children.
+
+
+
+ The default implementation does nothing. Subclasses may override this
+ behavior.
+
+
+
+
+
+ Executes the main body of the test, excluding its children (which will
+ run afterwards).
+
+
+
+ The default implementation does nothing. Subclasses may override this
+ behavior.
+
+
+
+
+
+ Runs set-up code before each child.
+
+
+
+ The default implementation does nothing. Subclasses may override this
+ behavior.
+
+
+
+
+
+ Runs tear-down code after each child.
+
+
+
+ The default implementation does nothing. Subclasses may override this
+ behavior.
+
+
+
+
+
+ Gets the test name.
+
+
+
+
+ Gets or sets the description metadata of the test, or null if none.
+
+
+
+ This is a convenience method that accesses the
+
+
+
+
+ Gets a mutable table of metadata entries associated with the test.
+
+
+
+ Add any extra metadata to this map.
+
+
+
+
+
+ Gets or sets the maximum amount of time the whole test including
+ its setup, teardown and body should be permitted to run.
+
+
+
+ If the test runs any longer than this, it will be aborted by the framework.
+ The timeout may be null to indicate the absence of a timeout.
+
+
+ Thrown if
+ The timeout. Default value is null.
+
+
+
+ Gets or sets the code element associated with the test, or null if none.
+
+
+
+
+ Gets the test kind.
+
+
+
+ A test suite will return
+
+ Subclasses must override this behavior.
+
+
+
+
+
+ Returns true if the test represents an individual test case.
+
+
+
+ A test suite will return true .
+ A test case will return false .
+ Custom tests may return an appropriate result.
+
+
+ Subclasses must override this behavior.
+
+
+
+
+
+ Creates a test case with a delegate to execute as its main body.
+
+ Thrown if
+
+
+
+
+
+ Gets or sets a set-up action to be executed before the test case.
+
+
+
+ If set to null (default), no action is performed.
+
+
+
+
+
+ Gets or sets a tear-down action to be executed after the test case.
+
+
+
+ If set to null (default), no action is performed.
+
+
+
+
+
+ Gets the delegate to run as the main body of the test case.
+
+
+
+
+
+
+
+
+ Specifies a method that is used to generate tests dynamically at runtime.
+
+
+
+ The tests created by the dynamic test factory are considered to be children
+ of the factory method that generated them. Because the tests are created
+ dynamically, they will not appear in the test tree (so most test runners will
+ not find them) and they are not directly affected by test filters. However,
+ the dynamic test factory is represented as a test so it will be visible in
+ the test tree.
+
+
+ Contrast with
+
+ The method to which this attribute is applied must be declared by the
+ fixture class. It may have parameters and be data-driven just like an ordinary
+ test method! The method may be static. It must return an enumeration of
+ values of type
+
+
+
+ A simple dynamic test factory that reads some data from a file and generates
+ a number of dynamic tests.
+ CreateDynamicTests()
+ {
+ foreach (string searchTerm in File.ReadAllLines("SearchTerms.txt"))
+ {
+ yield return new TestCase("Search Term: " + searchTerm, () => {
+ var searchEngine = new SearchEngine();
+ Assert.IsNotEmpty(searchEngine.GetSearchResults(searchTerm));
+ });
+ }
+ }
+ ]]>
+
+
+ A data-driven test factory that reads some data from a file and generates
+ a number of dynamic tests repeatedly in multiple configurations.
+ CreateDynamicTests(string searchProvider)
+ {
+ foreach (string searchTerm in File.ReadAllLines("SearchTerms.txt"))
+ {
+ yield return new TestCase("Search Term: " + searchTerm, () => {
+ var searchEngine = new SearchEngine(searchProvider);
+ Assert.IsNotEmpty(searchEngine.GetSearchResults(searchTerm));
+ });
+ }
+ }
+ ]]>
+
+
+
+
+
+
+
+ Decorates a test method whose database operation must be executed within a transaction and rolled
+ back when it has finished executing.
+
+
+
+ By default, the attribute does not rollback changes performed during SetUp and TearDown.
+ Set the true to change this.
+
+
+ The attribute uses a
+
+ Unfortunately there are a few caveats from this approach, the subject under test might use
+ its own transaction manager and ignore the ambient transaction set up here. Likewise,
+ it is possible that the presence of an enclosing transaction scope can interfere with the
+ normal operation of the subject under test.
+
+
+ If this attribute does not work for a particular application, we recommend that you
+ create your own custom rollback decorator attribute with the appropriate application-specific
+ semantics. Just create a new subclass of
+
+ Here are a few troubleshooting tips in case Rollback is not working properly for
+ your application:
+
+ - Ensure that the subject under test enlists its work in the current "ambient"
+ transaction managed by the
+ - Ensure that the Distributed Transaction Coordinator service is enabled and
+ running if you are using COM+ transactions.
+ - Ensure that the database is configured to enable distributed transactions.
+ This feature is sometimes disabled for performance reasons to prevent long-running
+ distributed transactions from locking database resources.
+
+
+
+
+
+ The following example shows the
+
+
+
+
+ Tags a test method whose database operation must be executed within a transaction and rolled
+ back when it has finished executing.
+
+
+
+
+
+
+ When set to true, includes setup and teardown in the rollback. Otherwise
+ only transactions performed during the test itself are affected.
+
+
+
+ The fixture setup and teardown is not included regardless unless this
+ attribute is applied to the fixture class itself instead of the test method.
+
+
+
+
+
+ Describes a reference to another test fixture.
+
+
+
+ This is used to enable test suites to include tests that are defined using attributes.
+
+
+ Refer to the examples on the
+
+ Running referenced test fixtures dynamically is not supported at this time. Run it
+ statically instead using
+
+
+
+
+ Creates a reference to a test fixture.
+
+ Thrown if
+
+
+
+
+
+
+
+ Gets the referenced test fixture type, or null if the reference is on a
+ test method of the containing test fixture.
+
+
+
+
+ Describes a test suite generated either at test exploration time or at test
+ execution time by a test factory.
+
+
+
+ A test suite has no timeout by default. This may be changed
+ setting the
+
+ Refer to the examples on the
+
+
+
+
+ Creates a test suite.
+
+ Thrown if
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Gets a mutable list of the children of this test.
+
+
+
+ Add test cases to this collection to include them in the test suite.
+
+
+
+
+
+ Gets or sets a delegate to run before each test case in the suite, or null if none.
+
+
+
+
+ Gets or sets a delegate to run after each test case in the suite, or null if none.
+
+
+
+
+ Gets or sets a delegate to run before all test cases in the suite, or null if none.
+
+
+
+
+ Gets or sets a delegate to run after all test cases in the suite, or null if none.
+
+
+
+
+
+
+
+
+ Represents the path to an element or an attribute in a XML fragment.
+
+
+ Consider the following XML fragment:
+
+
+
+
+ ]]>
+ The path to the attribute value of the element Child is specified as follows:
+
+
+
+
+ Starts the construction of a path.
+
+ A path that can be further extended.
+
+
+
diff --git a/lib/Gallio_3.2.517.0/MbUnit35.dll b/lib/Gallio_3.2.517.0/MbUnit35.dll
new file mode 100644
index 00000000..f55850e9
Binary files /dev/null and b/lib/Gallio_3.2.517.0/MbUnit35.dll differ
diff --git a/lib/Gallio_3.2.517.0/MbUnit35.pdb b/lib/Gallio_3.2.517.0/MbUnit35.pdb
new file mode 100644
index 00000000..a4a2c53f
Binary files /dev/null and b/lib/Gallio_3.2.517.0/MbUnit35.pdb differ
diff --git a/lib/Gallio_3.2.517.0/MbUnit35.plugin b/lib/Gallio_3.2.517.0/MbUnit35.plugin
new file mode 100644
index 00000000..1fb954ec
--- /dev/null
+++ b/lib/Gallio_3.2.517.0/MbUnit35.plugin
@@ -0,0 +1,30 @@
+
+
+
+ MbUnit v3 Extensions for .Net 3.5
+ 3.2.0.0
+ Provides additional MbUnit v3 features for use with .Net 3.5.
+ plugin://MbUnit/Resources/MbUnit.ico
+
+
+
+
+
+
+
+
+
+
+
\ No newline at end of file
diff --git a/lib/Gallio_3.2.517.0/MbUnit35.xml b/lib/Gallio_3.2.517.0/MbUnit35.xml
new file mode 100644
index 00000000..5e61a2d2
--- /dev/null
+++ b/lib/Gallio_3.2.517.0/MbUnit35.xml
@@ -0,0 +1,47 @@
+
+
+
+ MbUnit35
+
+
+
+
+ Provides extended assertions for .Net 3.5.
+
+
+
+
+ Verifies that a particular condition holds true.
+
+
+
+ If the condition evaluates to false, the assertion failure message will
+ describe in detail the intermediate value of relevant sub-expressions within
+ the condition. Consequently the assertion failure will include more diagnostic
+ information than if
+
+ Thrown if
+ Thrown if the verification failed unless the current
+
+
+
+ Verifies that a particular condition holds true.
+
+
+
+ If the condition evaluates to false, the assertion failure message will
+ describe in detail the intermediate value of relevant sub-expressions within
+ the condition. Consequently the assertion failure will include more diagnostic
+ information than if
+
+ Thrown if
+ Thrown if the verification failed unless the current
+
+
+
diff --git a/lib/Gallio_3.2.517.0/MbUnit40.dll b/lib/Gallio_3.2.517.0/MbUnit40.dll
new file mode 100644
index 00000000..e76641a8
Binary files /dev/null and b/lib/Gallio_3.2.517.0/MbUnit40.dll differ
diff --git a/lib/Gallio_3.2.517.0/MbUnit40.pdb b/lib/Gallio_3.2.517.0/MbUnit40.pdb
new file mode 100644
index 00000000..106013b4
Binary files /dev/null and b/lib/Gallio_3.2.517.0/MbUnit40.pdb differ
diff --git a/lib/Gallio_3.2.517.0/MbUnit40.plugin b/lib/Gallio_3.2.517.0/MbUnit40.plugin
new file mode 100644
index 00000000..8b7e5d01
--- /dev/null
+++ b/lib/Gallio_3.2.517.0/MbUnit40.plugin
@@ -0,0 +1,30 @@
+
+
+
+ MbUnit v3 Extensions for .Net 4.0
+ 3.2.0.0
+ Provides additional MbUnit v3 features for use with .Net 4.0.
+ plugin://MbUnit/Resources/MbUnit.ico
+
+
+
+
+
+
+
+
+
+
+
diff --git a/lib/Gallio_3.2.517.0/MbUnit40.xml b/lib/Gallio_3.2.517.0/MbUnit40.xml
new file mode 100644
index 00000000..dff68d4d
--- /dev/null
+++ b/lib/Gallio_3.2.517.0/MbUnit40.xml
@@ -0,0 +1,8 @@
+
+
+
+ MbUnit40
+
+
+
+
diff --git a/lib/Gallio_3.2.517.0/Sources.txt b/lib/Gallio_3.2.517.0/Sources.txt
new file mode 100644
index 00000000..a478a1ca
--- /dev/null
+++ b/lib/Gallio_3.2.517.0/Sources.txt
@@ -0,0 +1,10 @@
+Gallio v3.2.517.0 was generated from the following sources.
+
+Subversion Repository: http://mb-unit.googlecode.com/svn/trunk/v3
+ Revision: 2742
+
+Please visit the following Url for checkout instructions.
+ http://code.google.com/p/mb-unit/source/checkout
+
+Also refer to the wiki for information about how to debug with symbols and source code.
+ http://www.gallio.org/wiki/gallio:debugging_with_symbols_and_source_code
diff --git a/lib/Gallio_3.2.517.0/WeifenLuo.WinFormsUI.Docking.dll b/lib/Gallio_3.2.517.0/WeifenLuo.WinFormsUI.Docking.dll
new file mode 100644
index 00000000..96507f7f
Binary files /dev/null and b/lib/Gallio_3.2.517.0/WeifenLuo.WinFormsUI.Docking.dll differ
diff --git a/lib/Gallio_3.2.517.0/licenses/CciMetadata.License.txt b/lib/Gallio_3.2.517.0/licenses/CciMetadata.License.txt
new file mode 100644
index 00000000..da3dc935
--- /dev/null
+++ b/lib/Gallio_3.2.517.0/licenses/CciMetadata.License.txt
@@ -0,0 +1,31 @@
+Microsoft Public License (Ms-PL)
+
+This license governs use of the accompanying software. If you use the software, you accept this license. If you do not accept the license, do not use the software.
+
+1. Definitions
+
+The terms "reproduce," "reproduction," "derivative works," and "distribution" have the same meaning here as under U.S. copyright law.
+
+A "contribution" is the original software, or any additions or changes to the software.
+
+A "contributor" is any person that distributes its contribution under this license.
+
+"Licensed patents" are a contributor's patent claims that read directly on its contribution.
+
+2. Grant of Rights
+
+(A) Copyright Grant- Subject to the terms of this license, including the license conditions and limitations in section 3, each contributor grants you a non-exclusive, worldwide, royalty-free copyright license to reproduce its contribution, prepare derivative works of its contribution, and distribute its contribution or any derivative works that you create.
+
+(B) Patent Grant- Subject to the terms of this license, including the license conditions and limitations in section 3, each contributor grants you a non-exclusive, worldwide, royalty-free license under its licensed patents to make, have made, use, sell, offer for sale, import, and/or otherwise dispose of its contribution in the software or derivative works of the contribution in the software.
+
+3. Conditions and Limitations
+
+(A) No Trademark License- This license does not grant you rights to use any contributors' name, logo, or trademarks.
+
+(B) If you bring a patent claim against any contributor over patents that you claim are infringed by the software, your patent license from such contributor to the software ends automatically.
+
+(C) If you distribute any portion of the software, you must retain all copyright, patent, trademark, and attribution notices that are present in the software.
+
+(D) If you distribute any portion of the software in source code form, you may do so only under this license by including a complete copy of this license with your distribution. If you distribute any portion of the software in compiled or object code form, you may only do so under a license that complies with this license.
+
+(E) The software is licensed "as-is." You bear the risk of using it. The contributors give no express warranties, guarantees or conditions. You may have additional consumer rights under your local laws which this license cannot change. To the extent permitted under your local laws, the contributors exclude the implied warranties of merchantability, fitness for a particular purpose and non-infringement.
\ No newline at end of file
diff --git a/lib/Gallio_3.2.517.0/licenses/Mono.Cecil.license.html b/lib/Gallio_3.2.517.0/licenses/Mono.Cecil.license.html
new file mode 100644
index 00000000..8025bbaf
--- /dev/null
+++ b/lib/Gallio_3.2.517.0/licenses/Mono.Cecil.license.html
@@ -0,0 +1,36 @@
+
+
+Mono.Cecil.license
+
+
+
+
+ (C) 2004-2006 Jb Evain
+
+
+ Permission is hereby granted, free of charge, to any person obtaining a copy of
+ this software and associated documentation files (the "Software"), to deal in the
+ Software without restriction, including without limitation the rights to use, copy,
+ modify, merge, publish, distribute, sublicense, and/or sell copies of the Software,
+ and to permit persons to whom the Software is furnished to do so, subject to the
+ following conditions:
+
+
+ The above copyright notice and this permission notice shall be included in all copies
+ or substantial portions of the Software.
+
+
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED,
+ INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR
+ PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS
+ BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
+ TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE
+ USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+
\ No newline at end of file
diff --git a/src/MathNet.Numerics.5.1.ReSharper b/src/MathNet.Numerics.5.1.ReSharper
index bce082e6..af262d7c 100644
--- a/src/MathNet.Numerics.5.1.ReSharper
+++ b/src/MathNet.Numerics.5.1.ReSharper
@@ -3,6 +3,743 @@
SOLUTION
+
+
+
+
+
+ en-US
+ false
+ Wishart
+Wikipedia
+
+
+
+ en-US
+ en-US
+ en-US
+
+ en-US
+
+
+ Public Protected ProtectedInternal
+ Any
+ Maybe
+ Maybe
+ Any
+
+
+ false
+ 80
+
+
+
+
+ false
+
+
+ Any
+ Class
+ Maybe
+ Maybe
+ Any
+
+
+ Any
+ Enum
+ Maybe
+ Maybe
+ Any
+
+
+ Any
+ EnumerationMember
+ Maybe
+ Maybe
+ Any
+
+
+ Classes, Enumerations, Enumeration values should be named in Pascal
+
+ _
+ m_
+
+ Pascal
+
+
+ false
+
+
+ Public Internal Protected ProtectedInternal
+ Property
+ Maybe
+ Maybe
+ Any
+
+
+ Public Internal Protected ProtectedInternal
+ Method
+ Maybe
+ Maybe
+ Any
+
+
+ Public Internal Protected ProtectedInternal
+ Event
+ Maybe
+ Maybe
+ Any
+
+
+ Non private properties, methods, events should be in pascal.
+
+ _
+ m_
+
+ Pascal
+
+
+ false
+
+
+ Private
+ Property
+ Maybe
+ Maybe
+ Any
+
+
+ Private
+ Method
+ Maybe
+ Maybe
+ Any
+
+
+ Private
+ Event
+ Maybe
+ Maybe
+ Any
+
+
+ Private properties, methods, events should be in camel.
+
+ _
+ m_
+
+ Camel
+
+
+ false
+
+
+ Any
+ Field
+ Maybe
+ Maybe
+ Any
+
+
+ Fields should be underscore camel.
+
+ _
+
+
+ m_
+
+ Camel
+
+
+ false
+
+
+ Any
+ Variable
+ Maybe
+ Maybe
+ Any
+
+
+ Variable should be declared in camel.
+
+ _
+ m_
+
+ Camel
+
+
+ false
+
+
+ Any
+ Parameter
+ Maybe
+ Maybe
+ Any
+
+
+ Function parameters should be in camel.
+
+ _
+ m_
+
+ Camel
+
+
+ false
+
+
+ Any
+ Namespace
+ Maybe
+ Maybe
+ Any
+
+
+ Namespaces should be in Pascal.
+
+ _
+ m_
+
+ Pascal
+
+
+ false
+
+
+ Any
+ Constant
+ Maybe
+ Maybe
+ Any
+
+
+ Constants should be in capital.
+ UpperCase
+
+
+ false
+
+
+ Any
+ Any
+ Maybe
+ Maybe
+ Any
+
+
+
+
+ Any
+ Constant
+ Maybe
+ Maybe
+ Any
+
+
+ Acronyms should not have more than 2 characters.
+ MatchesRegex
+ ^(?>(XML|SQL|[A-Z]{0,2})[A-Z]?([^A-Z]|$)|[^A-Z]+)*$
+
+
+ false
+
+
+ Any
+ Any
+ Maybe
+ Maybe
+ Any
+
+
+
+
+ Any
+ Constant
+ Maybe
+ Maybe
+ Any
+
+
+ Any
+ Field
+ Maybe
+ Maybe
+ Any
+
+
+ Private
+ Method
+ Maybe
+ Maybe
+ Any
+
+
+ None
+ Namespace
+ Maybe
+ Maybe
+ Any
+
+
+ Names should not have underscore character
+ NotMatchesRegex
+ (?<remove>_)
+
+
+ false
+
+
+ Any
+ Class
+ NUnit.Framework.TestFixtureAttribute
+ Maybe
+ Maybe
+ Any
+
+
+ TestFixtures should end with Test.
+
+ Test
+
+ None
+
+ Test
+
+
+
+ false
+
+
+ Any
+ Method
+ NUnit.Framework.TestAttribute
+ Maybe
+ Maybe
+ Any
+
+
+ Test methods should start with Test.
+
+ Test
+
+ None
+
+ Test
+
+
+
+ false
+
+
+ Any
+ Enum
+ Maybe
+ Maybe
+ Any
+
+
+ Enumerations should not end with Enum.
+ None
+
+ Enum
+
+
+
+ false
+
+
+ Any
+ EnumerationMember
+ Maybe
+ Maybe
+ Any
+
+
+ Do not name enumerations reserved.
+ NotMatchesRegex
+ (?<remove>(reserved|Reserved))
+
+
+ false
+
+
+ Any
+ Event
+ Maybe
+ Maybe
+ Any
+
+
+ Event should not have Before or After prefix.
+
+ Before
+ After
+
+ None
+
+
+ false
+
+
+ Any
+ Enum
+ System.FlagsAttribute
+ Maybe
+ Maybe
+ Any
+
+
+ Flags enums should have plural names
+ None
+
+ s
+
+
+
+ true
+
+
+ Any
+ Enum
+ Maybe
+ Maybe
+ Any
+
+
+
+
+ Any
+ Enum
+ System.FlagsAttribute
+ Maybe
+ Maybe
+ Any
+
+
+ Enums that are not flags should not have plural names
+ None
+
+ s
+
+
+
+ false
+
+
+ Any
+ Class
+ System.Attribute
+ Maybe
+ Maybe
+ Any
+
+
+ Attribute should end with Attribute.
+ None
+
+ Attribute
+
+
+
+ false
+
+
+ Any
+ Class
+ System.EventArgs
+ Maybe
+ Maybe
+ Any
+
+
+ EventArgs should end with EventArgs.
+ None
+
+ EventArgs
+
+
+
+ false
+
+
+ Any
+ Class
+ System.Exception
+ Maybe
+ Maybe
+ Any
+
+
+ Exceptions should end with Exception.
+ None
+
+ Exception
+
+
+
+ false
+
+
+ Any
+ Class
+ System.Collections.Stack
+ Maybe
+ Maybe
+ Any
+
+
+ Any
+ Class
+ System.Collections.Generic.Stack
+ Maybe
+ Maybe
+ Any
+
+
+ Stack should end with Collection or Stack.
+ None
+
+ Collection
+ Stack
+
+
+
+ false
+
+
+ Any
+ Class
+ System.Collections.ICollection
+ Maybe
+ Maybe
+ Any
+
+
+ Any
+ Class
+ System.Collections.IEnumerable
+ Maybe
+ Maybe
+ Any
+
+
+ Any
+ Class
+ System.Collections.Generic.ICollection
+ Maybe
+ Maybe
+ Any
+
+
+
+
+ Any
+ Class
+ System.Collections.Stack
+ Maybe
+ Maybe
+ Any
+
+
+ Any
+ Class
+ System.Collections.Queue
+ Maybe
+ Maybe
+ Any
+
+
+ Any
+ Class
+ System.Collections.Generic.Stack
+ Maybe
+ Maybe
+ Any
+
+
+ Collections should end with Collection.
+ None
+
+ Collection
+
+
+
+ false
+
+
+ Any
+ Class
+ System.Collections.IDictionary
+ Maybe
+ Maybe
+ Any
+
+
+ Any
+ Class
+ System.Collections.Generic.IDictionary
+ Maybe
+ Maybe
+ Any
+
+
+ Dictionary should end with Dictionary.
+ None
+
+ Dictionary
+
+
+
+ false
+
+
+ Any
+ Class
+ System.Collections.Queue
+ Maybe
+ Maybe
+ Any
+
+
+ Queue should end with Collection or Queue.
+ None
+
+ Collection
+ Queue
+
+
+
+ false
+
+
+ Any
+ Interface
+ Maybe
+ Maybe
+ Any
+
+
+ Interfaces should be in Pascal and start with I.
+
+ I
+
+ Pascal
+
+
+
+
+
+ Public Protected ProtectedInternal
+ Any
+ Maybe
+ Maybe
+ Any
+
+
+
+ (?#email)\w+([-+.']\w+)*@\w+([-.]\w+)*\.\w+([-.]\w+)*
+ (?#url)http(s)?://([\w-]+\.)+[\w-]+(/[\w- ./?%&=]*)?
+
+
+
NEXT_LINE
diff --git a/src/Numerics/Distributions/Continuous/Beta.cs b/src/Numerics/Distributions/Continuous/Beta.cs
index e6617e5b..b4374570 100644
--- a/src/Numerics/Distributions/Continuous/Beta.cs
+++ b/src/Numerics/Distributions/Continuous/Beta.cs
@@ -3,9 +3,7 @@
// http://numerics.mathdotnet.com
// http://github.com/mathnet/mathnet-numerics
// http://mathnetnumerics.codeplex.com
-//
// Copyright (c) 2009-2010 Math.NET
-//
// Permission is hereby granted, free of charge, to any person
// obtaining a copy of this software and associated documentation
// files (the "Software"), to deal in the Software without
@@ -14,10 +12,8 @@
// copies of the Software, and to permit persons to whom the
// Software is furnished to do so, subject to the following
// conditions:
-//
// The above copyright notice and this permission notice shall be
// included in all copies or substantial portions of the Software.
-//
// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
@@ -49,7 +45,7 @@ namespace MathNet.Numerics.Distributions
/// Users can get/set the random number generator by using the The statistics classes will check all the incoming parameters whether they are in the allowed
/// range. This might involve heavy computation. Optionally, by setting Control.CheckDistributionParameters
- /// to false, all parameter checks can be turned off.
+ /// to false , all parameter checks can be turned off.
public class Beta : IContinuousDistribution
{
///
@@ -93,7 +89,7 @@ namespace MathNet.Numerics.Distributions
///
/// True when the parameters are valid, false otherwise.
+ /// true when the parameters are valid, false otherwise.
@@ -135,8 +138,15 @@ namespace MathNet.Numerics.Distributions
///
public double B
{
- get { return _shapeB; }
- set { SetParameters(_shapeA, value); }
+ get
+ {
+ return _shapeB;
+ }
+
+ set
+ {
+ SetParameters(_shapeA, value);
+ }
}
#region IDistribution implementation
@@ -169,34 +179,37 @@ namespace MathNet.Numerics.Distributions
{
get
{
- if(_shapeA == 0.0 && _shapeB == 0.0)
+ if (_shapeA == 0.0 && _shapeB == 0.0)
{
return 0.5;
}
- else if(_shapeA == 0.0)
+
+ if (_shapeA == 0.0)
{
return 0.0;
}
- else if(_shapeB == 0.0)
+
+ if (_shapeB == 0.0)
{
return 1.0;
}
- else if(Double.IsPositiveInfinity(_shapeA) && Double.IsPositiveInfinity(_shapeB))
+
+ if (Double.IsPositiveInfinity(_shapeA) && Double.IsPositiveInfinity(_shapeB))
{
return 0.5;
}
- else if (Double.IsPositiveInfinity(_shapeA))
+
+ if (Double.IsPositiveInfinity(_shapeA))
{
return 1.0;
}
- else if (Double.IsPositiveInfinity(_shapeB))
+
+ if (Double.IsPositiveInfinity(_shapeB))
{
return 0.0;
}
- else
- {
- return _shapeA / (_shapeA + _shapeB);
- }
+
+ return _shapeA / (_shapeA + _shapeB);
}
}
@@ -216,7 +229,10 @@ namespace MathNet.Numerics.Distributions
///
public double StdDev
{
- get { return Math.Sqrt((_shapeA * _shapeB) / ((_shapeA + _shapeB) * (_shapeA + _shapeB) * (_shapeA + _shapeB + 1.0))); }
+ get
+ {
+ return Math.Sqrt((_shapeA * _shapeB) / ((_shapeA + _shapeB) * (_shapeA + _shapeB) * (_shapeA + _shapeB + 1.0)));
+ }
}
///
@@ -230,21 +246,21 @@ namespace MathNet.Numerics.Distributions
{
return 0.0;
}
- else if (_shapeA == 0.0 && _shapeB == 0.0)
+
+ if (_shapeA == 0.0 && _shapeB == 0.0)
{
return -Math.Log(0.5);
}
- else if (_shapeA == 0.0 || _shapeB == 0.0)
+
+ if (_shapeA == 0.0 || _shapeB == 0.0)
{
return 0.0;
}
- else
- {
- return SpecialFunctions.BetaLn(_shapeA, _shapeB)
- - ((_shapeA - 1.0) * SpecialFunctions.DiGamma(_shapeA))
- - ((_shapeB - 1.0) * SpecialFunctions.DiGamma(_shapeB))
- + ((_shapeA + _shapeB - 2.0) * SpecialFunctions.DiGamma(_shapeA + _shapeB));
- }
+
+ return SpecialFunctions.BetaLn(_shapeA, _shapeB)
+ - ((_shapeA - 1.0) * SpecialFunctions.DiGamma(_shapeA))
+ - ((_shapeB - 1.0) * SpecialFunctions.DiGamma(_shapeB))
+ + ((_shapeA + _shapeB - 2.0) * SpecialFunctions.DiGamma(_shapeA + _shapeB));
}
}
@@ -259,33 +275,37 @@ namespace MathNet.Numerics.Distributions
{
return 0.0;
}
- else if (Double.IsPositiveInfinity(_shapeA))
+
+ if (Double.IsPositiveInfinity(_shapeA))
{
return -2.0;
}
- else if (Double.IsPositiveInfinity(_shapeB))
+
+ if (Double.IsPositiveInfinity(_shapeB))
{
return 2.0;
}
- else if (_shapeA == 0.0 && _shapeB == 0.0)
+
+ if (_shapeA == 0.0 && _shapeB == 0.0)
{
return 0.0;
}
- else if (_shapeA == 0.0)
+
+ if (_shapeA == 0.0)
{
return 2.0;
}
- else if (_shapeB == 0.0)
+
+ if (_shapeB == 0.0)
{
return -2.0;
}
- else
- {
- return 2.0 * (_shapeB - _shapeA) * Math.Sqrt(_shapeA + _shapeB + 1.0)
+
+ return 2.0 * (_shapeB - _shapeA) * Math.Sqrt(_shapeA + _shapeB + 1.0)
/ ((_shapeA + _shapeB + 2.0) * Math.Sqrt(_shapeA * _shapeB));
- }
}
}
+
#endregion
#region IContinuousDistribution implementation
@@ -301,34 +321,38 @@ namespace MathNet.Numerics.Distributions
{
return 0.5;
}
- else if (_shapeA == 0.0)
+
+ if (_shapeA == 0.0)
{
return 0.0;
}
- else if (_shapeB == 0.0)
+
+ if (_shapeB == 0.0)
{
return 1.0;
}
- else if (Double.IsPositiveInfinity(_shapeA) && Double.IsPositiveInfinity(_shapeB))
+
+ if (Double.IsPositiveInfinity(_shapeA) && Double.IsPositiveInfinity(_shapeB))
{
return 0.5;
}
- else if (Double.IsPositiveInfinity(_shapeA))
+
+ if (Double.IsPositiveInfinity(_shapeA))
{
return 1.0;
}
- else if (Double.IsPositiveInfinity(_shapeB))
+
+ if (Double.IsPositiveInfinity(_shapeB))
{
return 0.0;
}
- else if(_shapeA == 1.0 && _shapeB == 1.0)
+
+ if (_shapeA == 1.0 && _shapeB == 1.0)
{
return 0.5;
}
- else
- {
- return (_shapeA - 1) / (_shapeA + _shapeB - 2);
- }
+
+ return (_shapeA - 1) / (_shapeA + _shapeB - 2);
}
}
@@ -337,7 +361,10 @@ namespace MathNet.Numerics.Distributions
///
public double Median
{
- get { throw new NotImplementedException(); }
+ get
+ {
+ throw new NotImplementedException();
+ }
}
///
@@ -345,7 +372,10 @@ namespace MathNet.Numerics.Distributions
///
public double Minimum
{
- get { return 0.0; }
+ get
+ {
+ return 0.0;
+ }
}
///
@@ -353,7 +383,10 @@ namespace MathNet.Numerics.Distributions
///
public double Maximum
{
- get { return 1.0; }
+ get
+ {
+ return 1.0;
+ }
}
///
@@ -367,81 +400,49 @@ namespace MathNet.Numerics.Distributions
{
return 0.0;
}
- else if (Double.IsPositiveInfinity(_shapeA) && Double.IsPositiveInfinity(_shapeB))
+
+ if (Double.IsPositiveInfinity(_shapeA) && Double.IsPositiveInfinity(_shapeB))
{
- if (x == 0.5)
- {
- return Double.PositiveInfinity;
- }
- else
- {
- return 0.0;
- }
+ return x == 0.5 ? Double.PositiveInfinity : 0.0;
}
- else if (Double.IsPositiveInfinity(_shapeA))
+
+ if (Double.IsPositiveInfinity(_shapeA))
{
- if (x == 1.0)
- {
- return Double.PositiveInfinity;
- }
- else
- {
- return 0.0;
- }
+ return x == 1.0 ? Double.PositiveInfinity : 0.0;
}
- else if (Double.IsPositiveInfinity(_shapeB))
+
+ if (Double.IsPositiveInfinity(_shapeB))
{
- if (x == 0.0)
- {
- return Double.PositiveInfinity;
- }
- else
- {
- return 0.0;
- }
+ return x == 0.0 ? Double.PositiveInfinity : 0.0;
}
- else if (_shapeA == 0.0 && _shapeB == 0.0)
+
+ if (_shapeA == 0.0 && _shapeB == 0.0)
{
if (x == 0.0 || x == 1.0)
{
return Double.PositiveInfinity;
}
- else
- {
- return 0.0;
- }
+
+ return 0.0;
}
- else if (_shapeA == 0.0)
+
+ if (_shapeA == 0.0)
{
- if (x == 0.0)
- {
- return Double.PositiveInfinity;
- }
- else
- {
- return 0.0;
- }
+ return x == 0.0 ? Double.PositiveInfinity : 0.0;
}
- else if (_shapeB == 0.0)
+
+ if (_shapeB == 0.0)
{
- if (x == 1.0)
- {
- return Double.PositiveInfinity;
- }
- else
- {
- return 0.0;
- }
+ return x == 1.0 ? Double.PositiveInfinity : 0.0;
}
- else if (_shapeA == 1.0 && _shapeB == 1.0)
+
+ if (_shapeA == 1.0 && _shapeB == 1.0)
{
return 1.0;
}
- else
- {
- double b = SpecialFunctions.Gamma(_shapeA + _shapeB) / (SpecialFunctions.Gamma(_shapeA) * SpecialFunctions.Gamma(_shapeB));
- return b * Math.Pow(x, _shapeA - 1.0) * Math.Pow(1.0 - x, _shapeB - 1.0);
- }
+
+ var b = SpecialFunctions.Gamma(_shapeA + _shapeB) / (SpecialFunctions.Gamma(_shapeA) * SpecialFunctions.Gamma(_shapeB));
+ return b * Math.Pow(x, _shapeA - 1.0) * Math.Pow(1.0 - x, _shapeB - 1.0);
}
///
@@ -455,83 +456,52 @@ namespace MathNet.Numerics.Distributions
{
return Double.NegativeInfinity;
}
- else if (Double.IsPositiveInfinity(_shapeA) && Double.IsPositiveInfinity(_shapeB))
+
+ if (Double.IsPositiveInfinity(_shapeA) && Double.IsPositiveInfinity(_shapeB))
{
- if (x == 0.5)
- {
- return Double.PositiveInfinity;
- }
- else
- {
- return Double.NegativeInfinity;
- }
+ return x == 0.5 ? Double.PositiveInfinity : Double.NegativeInfinity;
}
- else if (Double.IsPositiveInfinity(_shapeA))
+
+ if (Double.IsPositiveInfinity(_shapeA))
{
- if (x == 1.0)
- {
- return Double.PositiveInfinity;
- }
- else
- {
- return Double.NegativeInfinity;
- }
+ return x == 1.0 ? Double.PositiveInfinity : Double.NegativeInfinity;
}
- else if (Double.IsPositiveInfinity(_shapeB))
+
+ if (Double.IsPositiveInfinity(_shapeB))
{
- if (x == 0.0)
- {
- return Double.PositiveInfinity;
- }
- else
- {
- return Double.NegativeInfinity;
- }
+ return x == 0.0 ? Double.PositiveInfinity : Double.NegativeInfinity;
}
- else if (_shapeA == 0.0 && _shapeB == 0.0)
+
+ if (_shapeA == 0.0 && _shapeB == 0.0)
{
if (x == 0.0 || x == 1.0)
{
return Double.PositiveInfinity;
}
- else
- {
- return Double.NegativeInfinity;
- }
+
+ return Double.NegativeInfinity;
}
- else if (_shapeA == 0.0)
+
+ if (_shapeA == 0.0)
{
- if (x == 0.0)
- {
- return Double.PositiveInfinity;
- }
- else
- {
- return Double.NegativeInfinity;
- }
+ return x == 0.0 ? Double.PositiveInfinity : Double.NegativeInfinity;
}
- else if (_shapeB == 0.0)
+
+ if (_shapeB == 0.0)
{
- if (x == 1.0)
- {
- return Double.PositiveInfinity;
- }
- else
- {
- return Double.NegativeInfinity;
- }
+ return x == 1.0 ? Double.PositiveInfinity : Double.NegativeInfinity;
}
- else if (_shapeA == 1.0 && _shapeB == 1.0)
+
+ if (_shapeA == 1.0 && _shapeB == 1.0)
{
return 0.0;
}
- else
- {
- double a = SpecialFunctions.GammaLn(_shapeA + _shapeB) - SpecialFunctions.GammaLn(_shapeA) - SpecialFunctions.GammaLn(_shapeB);
- double b = x == 0.0 ? (_shapeA == 1.0 ? 0.0 : Double.NegativeInfinity) : (_shapeA - 1.0) * Math.Log(x);
- double c = x == 1.0 ? (_shapeB == 1.0 ? 0.0 : Double.NegativeInfinity) : (_shapeB - 1.0) * Math.Log(1.0 - x);
- return a + b + c;
- }
+
+ var a = SpecialFunctions.GammaLn(_shapeA + _shapeB) - SpecialFunctions.GammaLn(_shapeA) - SpecialFunctions.GammaLn(_shapeB);
+ var b = x == 0.0 ? (_shapeA == 1.0 ? 0.0 : Double.NegativeInfinity) : (_shapeA - 1.0) * Math.Log(x);
+ var c = x == 1.0 ? (_shapeB == 1.0 ? 0.0 : Double.NegativeInfinity) : (_shapeB - 1.0) * Math.Log(1.0 - x);
+
+ return a + b + c;
}
///
@@ -545,77 +515,53 @@ namespace MathNet.Numerics.Distributions
{
return 0.0;
}
- else if (x >= 1.0)
+
+ if (x >= 1.0)
{
return 1.0;
}
- else if (Double.IsPositiveInfinity(_shapeA) && Double.IsPositiveInfinity(_shapeB))
+
+ if (Double.IsPositiveInfinity(_shapeA) && Double.IsPositiveInfinity(_shapeB))
{
- if (x < 0.5)
- {
- return 0.0;
- }
- else
- {
- return 1.0;
- }
+ return x < 0.5 ? 0.0 : 1.0;
}
- else if (Double.IsPositiveInfinity(_shapeA))
+
+ if (Double.IsPositiveInfinity(_shapeA))
{
- if (x < 1.0)
- {
- return 0.0;
- }
- else
- {
- return 1.0;
- }
+ return x < 1.0 ? 0.0 : 1.0;
}
- else if (Double.IsPositiveInfinity(_shapeB))
+
+ if (Double.IsPositiveInfinity(_shapeB))
{
- if (x >= 0.0)
- {
- return 1.0;
- }
- else
- {
- return 0.0;
- }
+ return x >= 0.0 ? 1.0 : 0.0;
}
- else if (_shapeA == 0.0 && _shapeB == 0.0)
+
+ if (_shapeA == 0.0 && _shapeB == 0.0)
{
if (x >= 0.0 && x < 1.0)
{
return 0.5;
}
- else
- {
- return 1.0;
- }
+
+ return 1.0;
}
- else if (_shapeA == 0.0)
+
+ if (_shapeA == 0.0)
{
return 1.0;
}
- else if (_shapeB == 0.0)
+
+ if (_shapeB == 0.0)
{
- if (x >= 1.0)
- {
- return 1.0;
- }
- else
- {
- return 0.0;
- }
+ return x >= 1.0 ? 1.0 : 0.0;
}
- else if (_shapeA == 1.0 && _shapeB == 1.0)
+
+ if (_shapeA == 1.0 && _shapeB == 1.0)
{
return x;
}
- else
- {
- return SpecialFunctions.BetaRegularized(_shapeA, _shapeB, x);
- }
+
+ return SpecialFunctions.BetaRegularized(_shapeA, _shapeB, x);
}
///
@@ -638,6 +584,7 @@ namespace MathNet.Numerics.Distributions
yield return SampleBeta(RandomSource, _shapeA, _shapeB);
}
}
+
#endregion
///
@@ -686,8 +633,8 @@ namespace MathNet.Numerics.Distributions
/// a random number from the Beta distribution.
internal static double SampleBeta(Random rnd, double a, double b)
{
- double x = Gamma.SampleGamma(rnd, a, 1.0);
- double y = Gamma.SampleGamma(rnd, b, 1.0);
+ var x = Gamma.SampleGamma(rnd, a, 1.0);
+ var y = Gamma.SampleGamma(rnd, b, 1.0);
return x / (x + y);
}
}
diff --git a/src/Numerics/Distributions/Continuous/Cauchy.cs b/src/Numerics/Distributions/Continuous/Cauchy.cs
new file mode 100644
index 00000000..531b6163
--- /dev/null
+++ b/src/Numerics/Distributions/Continuous/Cauchy.cs
@@ -0,0 +1,348 @@
+//
+// Math.NET Numerics, part of the Math.NET Project
+// http://numerics.mathdotnet.com
+// http://github.com/mathnet/mathnet-numerics
+// http://mathnetnumerics.codeplex.com
+// Copyright (c) 2009-2010 Math.NET
+// Permission is hereby granted, free of charge, to any person
+// obtaining a copy of this software and associated documentation
+// files (the "Software"), to deal in the Software without
+// restriction, including without limitation the rights to use,
+// copy, modify, merge, publish, distribute, sublicense, and/or sell
+// copies of the Software, and to permit persons to whom the
+// Software is furnished to do so, subject to the following
+// conditions:
+// The above copyright notice and this permission notice shall be
+// included in all copies or substantial portions of the Software.
+// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
+// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
+// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+// OTHER DEALINGS IN THE SOFTWARE.
+//
+
+namespace MathNet.Numerics.Distributions
+{
+ using System;
+ using System.Collections.Generic;
+ using Properties;
+
+ ///
+ /// The Cauchy distribution is a symmetric continuous probability distribution. For details about this distribution, see
+ /// Wikipedia - Cauchy distribution .
+ ///
+ /// The distribution will use the
+ /// The statistics classes will check all the incoming parameters whether they are in the allowed
+ /// range. This might involve heavy computation. Optionally, by setting Control.CheckDistributionParameters
+ /// to false , all parameter checks can be turned off.
+ /// The scale of the Cauchy distribution.
+ ///
+ private double _scale;
+
+ ///
+ /// The distribution's random number generator.
+ ///
+ private Random _random;
+
+ ///
+ /// Initializes a new instance of the
+ public Cauchy() : this(0, 1)
+ {
+ }
+
+ ///
+ /// Initializes a new instance of the
+ ///
+ /// If
+ public Cauchy(double location, double scale)
+ {
+ SetParameters(location, scale);
+ RandomSource = new Random();
+ }
+
+ ///
+ /// Sets the parameters of the distribution after checking their validity.
+ ///
+ /// When the parameters don't pass the
+ private void SetParameters(double location, double scale)
+ {
+ if (Control.CheckDistributionParameters && !IsValidParameterSet(location, scale))
+ {
+ throw new ArgumentOutOfRangeException(Resources.InvalidDistributionParameters);
+ }
+
+ Median = location;
+ _scale = scale;
+ }
+
+ ///
+ /// Checks whether the parameters of the distribution are valid.
+ ///
+ /// True when the parameters are valid, false otherwise.
+ private static bool IsValidParameterSet(double location, double scale)
+ {
+ if (scale <= 0)
+ {
+ return false;
+ }
+
+ if (Double.IsNaN(location) || Double.IsNaN(scale))
+ {
+ return false;
+ }
+
+ return true;
+ }
+
+ ///
+ /// Gets or sets the location parameter of the distribution.
+ ///
+ public double Location
+ {
+ get
+ {
+ return Median;
+ }
+
+ set
+ {
+ SetParameters(value, _scale);
+ }
+ }
+
+ ///
+ /// Gets or sets the scale parameter of the distribution.
+ ///
+ public double Scale
+ {
+ get
+ {
+ return _scale;
+ }
+
+ set
+ {
+ SetParameters(Median, value);
+ }
+ }
+
+ ///
+ /// A string representation of the distribution.
+ ///
+ /// a string representation of the distribution.
+ public override string ToString()
+ {
+ return "Cauchy(Location = " + Median + ", Scale = " + _scale + ")";
+ }
+
+ #region IDistribution Members
+
+ ///
+ /// Gets or sets the random number generator which is used to draw random samples.
+ ///
+ public Random RandomSource
+ {
+ get
+ {
+ return _random;
+ }
+
+ set
+ {
+ if (value == null)
+ {
+ throw new ArgumentNullException();
+ }
+
+ _random = value;
+ }
+ }
+
+ ///
+ /// Gets the mean of the distribution.
+ ///
+ public double Mean
+ {
+ get
+ {
+ throw new NotSupportedException();
+ }
+ }
+
+ ///
+ /// Gets the variance of the distribution.
+ ///
+ public double Variance
+ {
+ get
+ {
+ throw new NotSupportedException();
+ }
+ }
+
+ ///
+ /// Gets the standard deviation of the distribution.
+ ///
+ public double StdDev
+ {
+ get
+ {
+ throw new NotSupportedException();
+ }
+ }
+
+ ///
+ /// Gets the entropy of the distribution.
+ ///
+ public double Entropy
+ {
+ get
+ {
+ return Math.Log(4.0 * Constants.Pi * _scale);
+ }
+ }
+
+ ///
+ /// Gets the skewness of the distribution.
+ ///
+ public double Skewness
+ {
+ get
+ {
+ throw new NotSupportedException();
+ }
+ }
+
+ ///
+ /// Computes the cumulative distribution function of the distribution.
+ ///
+ /// the cumulative density at
+ public double CumulativeDistribution(double x)
+ {
+ return ((1.0 / Constants.Pi) * Math.Atan((x - Median) / _scale)) + 0.5;
+ }
+
+ #endregion
+
+ #region IContinuousDistribution Members
+
+ ///
+ /// Gets the mode of the distribution.
+ ///
+ public double Mode
+ {
+ get
+ {
+ return Median;
+ }
+ }
+
+ ///
+ /// Gets the median of the distribution.
+ ///
+ public double Median
+ {
+ get;
+ private set;
+ }
+
+ ///
+ /// Gets the minimum of the distribution.
+ ///
+ public double Minimum
+ {
+ get
+ {
+ return Double.NegativeInfinity;
+ }
+ }
+
+ ///
+ /// Gets the maximum of the distribution.
+ ///
+ public double Maximum
+ {
+ get
+ {
+ return Double.PositiveInfinity;
+ }
+ }
+
+ ///
+ /// Computes the density of the distribution.
+ ///
+ /// the density at
+ public double Density(double x)
+ {
+ return 1.0 / (Constants.Pi * _scale * (1.0 + (((x - Median) / _scale) * ((x - Median) / _scale))));
+ }
+
+ ///
+ /// Computes the log density of the distribution.
+ ///
+ /// the log density at
+ public double DensityLn(double x)
+ {
+ return -Math.Log(Constants.Pi * _scale * (1.0 + (((x - Median) / _scale) * ((x - Median) / _scale))));
+ }
+
+ ///
+ /// Draws a random sample from the distribution.
+ ///
+ /// A random number from this distribution.
+ public double Sample()
+ {
+ return DoSample(RandomSource, Median, _scale);
+ }
+
+ ///
+ /// Generates a sequence of samples from the Cauchy distribution.
+ ///
+ /// a sequence of samples from the distribution.
+ public IEnumerable Samples()
+ {
+ while (true)
+ {
+ yield return DoSample(RandomSource, Median, _scale);
+ }
+ }
+
+ #endregion
+
+ ///
+ /// Samples the distribution.
+ ///
+ /// a random number from the distribution.
+ private static double DoSample(Random rnd, double location, double scale)
+ {
+ var u = rnd.NextDouble();
+ return location + (scale * Math.Tan(Constants.Pi * (u - 0.5)));
+ }
+ }
+}
diff --git a/src/Numerics/Distributions/Continuous/Chi.cs b/src/Numerics/Distributions/Continuous/Chi.cs
new file mode 100644
index 00000000..5bd6d011
--- /dev/null
+++ b/src/Numerics/Distributions/Continuous/Chi.cs
@@ -0,0 +1,326 @@
+//
+// Math.NET Numerics, part of the Math.NET Project
+// http://numerics.mathdotnet.com
+// http://github.com/mathnet/mathnet-numerics
+// http://mathnetnumerics.codeplex.com
+// Copyright (c) 2009-2010 Math.NET
+// Permission is hereby granted, free of charge, to any person
+// obtaining a copy of this software and associated documentation
+// files (the "Software"), to deal in the Software without
+// restriction, including without limitation the rights to use,
+// copy, modify, merge, publish, distribute, sublicense, and/or sell
+// copies of the Software, and to permit persons to whom the
+// Software is furnished to do so, subject to the following
+// conditions:
+// The above copyright notice and this permission notice shall be
+// included in all copies or substantial portions of the Software.
+// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
+// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
+// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+// OTHER DEALINGS IN THE SOFTWARE.
+//
+
+namespace MathNet.Numerics.Distributions
+{
+ using System;
+ using System.Collections.Generic;
+ using Properties;
+
+ ///
+ /// This class implements functionality for the Chi distribution. This distribution is
+ /// a continuous probability distribution. The distribution usually arises when a k-dimensional vector's orthogonal
+ /// components are independent and each follow a standard normal distribution. The length of the vector will
+ /// then have a chi distribution.
+ /// Wikipedia - Chi distribution .
+ ///
+ /// The distribution will use the
+ /// The statistics classes will check all the incoming parameters whether they are in the allowed
+ /// range. This might involve heavy computation. Optionally, by setting Control.CheckDistributionParameters
+ /// to false , all parameter checks can be turned off.
+ /// Keeps track of the degrees of freedom for the Chi distribution.
+ ///
+ private double _dof;
+
+ ///
+ /// The distribution's random number generator.
+ ///
+ private Random _random;
+
+ ///
+ /// Initializes a new instance of the
+ ///
+ /// Sets the parameters of the distribution after checking their validity.
+ ///
+ /// When the parameters don't pass the
+ private void SetParameters(double dof)
+ {
+ if (Control.CheckDistributionParameters && !IsValidParameterSet(dof))
+ {
+ throw new ArgumentOutOfRangeException(Resources.InvalidDistributionParameters);
+ }
+
+ _dof = dof;
+ }
+
+ ///
+ /// Checks whether the parameters of the distribution are valid.
+ ///
+ /// true when the parameters are valid, false otherwise.
+ /// Gets or sets the degrees of freedom of the Chi distribution.
+ ///
+ public double DegreesOfFreedom
+ {
+ get
+ {
+ return _dof;
+ }
+
+ set
+ {
+ SetParameters(value);
+ }
+ }
+
+ ///
+ /// A string representation of the distribution.
+ ///
+ /// a string representation of the distribution.
+ public override string ToString()
+ {
+ return "Chi(DoF = " + _dof + ")";
+ }
+
+ #region IDistribution Members
+
+ ///
+ /// Gets or sets the distribution's random number generator.
+ ///
+ public Random RandomSource
+ {
+ get
+ {
+ return _random;
+ }
+
+ set
+ {
+ if (value == null)
+ {
+ throw new ArgumentNullException();
+ }
+
+ _random = value;
+ }
+ }
+
+ ///
+ /// Gets the mean of the distribution.
+ ///
+ public double Mean
+ {
+ get
+ {
+ return Math.Sqrt(2) * (SpecialFunctions.Gamma((_dof + 1.0) / 2.0) / SpecialFunctions.Gamma(_dof / 2.0));
+ }
+ }
+
+ ///
+ /// Gets the variance of the distribution.
+ ///
+ public double Variance
+ {
+ get
+ {
+ return _dof - (Mean * Mean);
+ }
+ }
+
+ ///
+ /// Gets the standard deviation of the distribution.
+ ///
+ public double StdDev
+ {
+ get
+ {
+ return Math.Sqrt(Variance);
+ }
+ }
+
+ ///
+ /// Gets the entropy of the distribution.
+ ///
+ public double Entropy
+ {
+ get
+ {
+ return SpecialFunctions.GammaLn(_dof / 2.0) + ((_dof - Math.Log(2) - ((_dof - 1.0) * SpecialFunctions.DiGamma(_dof / 2.0))) / 2.0);
+ }
+ }
+
+ ///
+ /// Gets the skewness of the distribution.
+ ///
+ public double Skewness
+ {
+ get
+ {
+ var sigma = StdDev;
+ return (Mean * (1.0 - (2.0 * (sigma * sigma)))) / (sigma * sigma * sigma);
+ }
+ }
+
+ ///
+ /// Computes the cumulative distribution function of the distribution.
+ ///
+ /// the cumulative density at
+ public double CumulativeDistribution(double x)
+ {
+ return SpecialFunctions.GammaLowerIncomplete(_dof / 2.0, x * x / 2.0) / SpecialFunctions.Gamma(_dof / 2.0);
+ }
+
+ #endregion
+
+ #region IContinuousDistribution Members
+
+ ///
+ /// Gets the mode of the distribution.
+ ///
+ public double Mode
+ {
+ get
+ {
+ if (_dof < 1)
+ {
+ throw new NotSupportedException();
+ }
+
+ return Math.Sqrt(_dof - 1.0);
+ }
+ }
+
+ ///
+ /// Gets the median of the distribution.
+ ///
+ public double Median
+ {
+ get
+ {
+ throw new NotSupportedException();
+ }
+ }
+
+ ///
+ /// Gets the minimum of the distribution.
+ ///
+ public double Minimum
+ {
+ get
+ {
+ return 0.0;
+ }
+ }
+
+ ///
+ /// Gets the maximum of the distribution.
+ ///
+ public double Maximum
+ {
+ get
+ {
+ return Double.PositiveInfinity;
+ }
+ }
+
+ ///
+ /// Computes the density of the distribution.
+ ///
+ /// the density at
+ public double Density(double x)
+ {
+ return (Math.Pow(2.0, 1.0 - (_dof / 2.0)) * Math.Pow(x, _dof - 1.0) * Math.Exp(-x * x / 2.0)) / SpecialFunctions.Gamma(_dof / 2.0);
+ }
+
+ ///
+ /// Computes the log density of the distribution.
+ ///
+ /// the log density at
+ public double DensityLn(double x)
+ {
+ return ((1.0 - (_dof / 2.0)) * Math.Log(2.0)) + ((_dof - 1.0) * Math.Log(x)) - (x * x / 2.0) - SpecialFunctions.GammaLn(_dof / 2.0);
+ }
+
+ ///
+ /// Generates a sample from the Chi distribution.
+ ///
+ /// a sample from the distribution.
+ public double Sample()
+ {
+ return DoSample(RandomSource);
+ }
+
+ ///
+ /// Generates a sequence of samples from the Chi distribution.
+ ///
+ /// a sequence of samples from the distribution.
+ public IEnumerable Samples()
+ {
+ while (true)
+ {
+ yield return DoSample(RandomSource);
+ }
+ }
+
+ #endregion
+
+ ///
+ /// Samples the distribution.
+ ///
+ /// a random number from the distribution.
+ private double DoSample(Random rnd)
+ {
+ double sum = 0;
+ var n = (int)_dof;
+ for (var i = 0; i < n; i++)
+ {
+ sum += Normal.Sample(rnd, 0.0, 1.0);
+ }
+
+ return Math.Sqrt(sum);
+ }
+ }
+}
diff --git a/src/Numerics/Distributions/Continuous/ChiSquare.cs b/src/Numerics/Distributions/Continuous/ChiSquare.cs
new file mode 100644
index 00000000..bdba56bf
--- /dev/null
+++ b/src/Numerics/Distributions/Continuous/ChiSquare.cs
@@ -0,0 +1,303 @@
+//
+// Math.NET Numerics, part of the Math.NET Project
+// http://numerics.mathdotnet.com
+// http://github.com/mathnet/mathnet-numerics
+// http://mathnetnumerics.codeplex.com
+//
+// Copyright (c) 2009-2010 Math.NET
+//
+// Permission is hereby granted, free of charge, to any person
+// obtaining a copy of this software and associated documentation
+// files (the "Software"), to deal in the Software without
+// restriction, including without limitation the rights to use,
+// copy, modify, merge, publish, distribute, sublicense, and/or sell
+// copies of the Software, and to permit persons to whom the
+// Software is furnished to do so, subject to the following
+// conditions:
+//
+// The above copyright notice and this permission notice shall be
+// included in all copies or substantial portions of the Software.
+//
+// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
+// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
+// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+// OTHER DEALINGS IN THE SOFTWARE.
+//
+
+namespace MathNet.Numerics.Distributions
+{
+ using System;
+ using System.Collections.Generic;
+ using Properties;
+
+ ///
+ /// This class implements functionality for the ChiSquare distribution. This distribution is
+ /// a sum of the squares of k independent standard normal random variables.
+ /// Wikipedia - ChiSquare distribution .
+ ///
+ /// The distribution will use the
+ /// The statistics classes will check all the incoming parameters whether they are in the allowed
+ /// range. This might involve heavy computation. Optionally, by setting Control.CheckDistributionParameters
+ /// to false , all parameter checks can be turned off.
+ /// The distribution's random number generator.
+ ///
+ private Random _random;
+
+ ///
+ /// Initializes a new instance of the
+ ///
+ /// Sets the parameters of the distribution after checking their validity.
+ ///
+ /// ChiSquare distribution.
+ /// When the parameters don't pass the
+ private void SetParameters(double dof)
+ {
+ if (Control.CheckDistributionParameters && !IsValidParameterSet(dof))
+ {
+ throw new ArgumentOutOfRangeException(Resources.InvalidDistributionParameters);
+ }
+
+ Mean = dof;
+ }
+
+ ///
+ /// Checks whether the parameters of the distribution are valid.
+ ///
+ /// ChiSquare distribution.
+ /// true when the parameters are valid, false otherwise.
+ /// Gets or sets the degrees of freedom of the ChiSquare distribution.
+ ///
+ public double DegreesOfFreedom
+ {
+ get
+ {
+ return Mean;
+ }
+
+ set
+ {
+ SetParameters(value);
+ }
+ }
+
+ ///
+ /// A string representation of the distribution.
+ ///
+ /// a string representation of the distribution.
+ public override string ToString()
+ {
+ return "ChiSquare(DoF = " + Mean + ")";
+ }
+
+ #region IDistribution Members
+
+ ///
+ /// Gets or sets the distribution's random number generator.
+ ///
+ public Random RandomSource
+ {
+ get
+ {
+ return _random;
+ }
+
+ set
+ {
+ if (value == null)
+ {
+ throw new ArgumentNullException();
+ }
+
+ _random = value;
+ }
+ }
+
+ ///
+ /// Gets the mean of the distribution.
+ ///
+ public double Mean
+ {
+ get;
+ private set;
+ }
+
+ ///
+ /// Gets the variance of the distribution.
+ ///
+ public double Variance
+ {
+ get { return 2.0 * Mean; }
+ }
+
+ ///
+ /// Gets the standard deviation of the distribution.
+ ///
+ public double StdDev
+ {
+ get { return Math.Sqrt(2.0 * Mean); }
+ }
+
+ ///
+ /// Gets the entropy of the distribution.
+ ///
+ public double Entropy
+ {
+ get { return (Mean / 2.0) + Math.Log(2.0 * SpecialFunctions.Gamma(Mean / 2.0)) + ((1.0 - (Mean / 2.0)) * SpecialFunctions.DiGamma(Mean / 2.0)); }
+ }
+
+ ///
+ /// Gets the skewness of the distribution.
+ ///
+ public double Skewness
+ {
+ get { return Math.Sqrt(8.0 / Mean); }
+ }
+
+ ///
+ /// Computes the cumulative distribution function of the distribution.
+ ///
+ /// the cumulative density at
+ public double CumulativeDistribution(double x)
+ {
+ return SpecialFunctions.GammaUpperIncomplete(Mean / 2.0, x / 2.0) / SpecialFunctions.Gamma(Mean / 2.0);
+ }
+
+ #endregion
+
+ #region IContinuousDistribution Members
+
+ ///
+ /// Gets the mode of the distribution.
+ ///
+ public double Mode
+ {
+ get { return Mean - 2.0; }
+ }
+
+ ///
+ /// Gets the median of the distribution.
+ ///
+ public double Median
+ {
+ get { return Mean - (2.0 / 3.0); }
+ }
+
+ ///
+ /// Gets the minimum of the distribution.
+ ///
+ public double Minimum
+ {
+ get { return 0.0; }
+ }
+
+ ///
+ /// Gets the maximum of the distribution.
+ ///
+ public double Maximum
+ {
+ get { return double.PositiveInfinity; }
+ }
+
+ ///
+ /// Computes the density of the distribution.
+ ///
+ /// the density at
+ public double Density(double x)
+ {
+ return (Math.Pow(x, (Mean / 2.0) - 1.0) * Math.Exp(-x / 2.0)) / (Math.Pow(2.0, Mean / 2.0) * SpecialFunctions.Gamma(Mean / 2.0));
+ }
+
+ ///
+ /// Computes the log density of the distribution.
+ ///
+ /// the log density at
+ public double DensityLn(double x)
+ {
+ return (-x / 2.0) + (((Mean / 2.0) - 1.0) * Math.Log(x)) - ((Mean / 2.0) * Math.Log(2)) - SpecialFunctions.GammaLn(Mean / 2.0);
+ }
+
+ ///
+ /// Generates a sample from the ChiSquare distribution.
+ ///
+ /// a sample from the distribution.
+ public double Sample()
+ {
+ return DoSample(RandomSource, Mean);
+ }
+
+ ///
+ /// Generates a sequence of samples from the ChiSquare distribution.
+ ///
+ /// a sequence of samples from the distribution.
+ public IEnumerable Samples()
+ {
+ while (true)
+ {
+ yield return DoSample(RandomSource, Mean);
+ }
+ }
+
+ #endregion
+
+ ///
+ /// Samples the distribution.
+ ///
+ /// a random number from the distribution.
+ private static double DoSample(Random rnd, double dof)
+ {
+ double sum = 0;
+ var n = (int)dof;
+ for (var i = 0; i < n; i++)
+ {
+ sum += Normal.Sample(rnd, 0.0, 1.0);
+ }
+
+ return sum;
+ }
+
+ ///
+ /// Generates a sample from the ChiSquare distribution.
+ ///
+ /// a sample from the distribution.
+ public static double Sample(Random rnd, double dof)
+ {
+ if (Control.CheckDistributionParameters && !IsValidParameterSet(dof))
+ {
+ throw new ArgumentOutOfRangeException(Resources.InvalidDistributionParameters);
+ }
+
+ return DoSample(rnd, dof);
+ }
+ }
+}
diff --git a/src/Numerics/Distributions/Continuous/ContinuousUniform.cs b/src/Numerics/Distributions/Continuous/ContinuousUniform.cs
index e28011bd..25701c89 100644
--- a/src/Numerics/Distributions/Continuous/ContinuousUniform.cs
+++ b/src/Numerics/Distributions/Continuous/ContinuousUniform.cs
@@ -42,7 +42,7 @@ namespace MathNet.Numerics.Distributions
/// Users can get/set the random number generator by using the The statistics classes will check all the incoming parameters whether they are in the allowed
/// range. This might involve heavy computation. Optionally, by setting Control.CheckDistributionParameters
- /// to false, all parameter checks can be turned off.
+ /// to false , all parameter checks can be turned off.
public class ContinuousUniform : IContinuousDistribution
{
///
@@ -93,7 +93,7 @@ namespace MathNet.Numerics.Distributions
///
/// True when the parameters are valid, false otherwise.
+ /// true when the parameters are valid, false otherwise.
- /// Generates a sample from the ContinuousUniform distribution.
+ /// Generates a sample from the ContinuousUniform distribution.
///
/// a sample from the distribution.
public double Sample()
@@ -319,7 +319,7 @@ namespace MathNet.Numerics.Distributions
}
///
- /// Generates a sequence of samples from the ContinuousUniform distribution.
+ /// Generates a sequence of samples from the ContinuousUniform distribution.
///
/// a sequence of samples from the distribution.
public IEnumerable Samples()
@@ -333,7 +333,7 @@ namespace MathNet.Numerics.Distributions
#endregion
///
- /// Generates a sample from the ContinuousUniform distribution.
+ /// Generates a sample from the ContinuousUniform distribution.
///
///
- /// Generates a sequence of samples from the ContinuousUniform distribution.
+ /// Generates a sequence of samples from the ContinuousUniform distribution.
///
///
- /// Generates one sample from the ContinuousUniform distribution without parameter checking.
+ /// Generates one sample from the ContinuousUniform distribution without parameter checking.
///
///
+// Math.NET Numerics, part of the Math.NET Project
+// http://numerics.mathdotnet.com
+// http://github.com/mathnet/mathnet-numerics
+// http://mathnetnumerics.codeplex.com
+// Copyright (c) 2009-2010 Math.NET
+// Permission is hereby granted, free of charge, to any person
+// obtaining a copy of this software and associated documentation
+// files (the "Software"), to deal in the Software without
+// restriction, including without limitation the rights to use,
+// copy, modify, merge, publish, distribute, sublicense, and/or sell
+// copies of the Software, and to permit persons to whom the
+// Software is furnished to do so, subject to the following
+// conditions:
+// The above copyright notice and this permission notice shall be
+// included in all copies or substantial portions of the Software.
+// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
+// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
+// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+// OTHER DEALINGS IN THE SOFTWARE.
+//
+
+namespace MathNet.Numerics.Distributions
+{
+ using System;
+ using System.Collections.Generic;
+ using Properties;
+
+ ///
+ /// This class implements functionality for the Erlang distribution. This distribution is
+ /// is a continuous probability distribution with wide applicability primarily due to its
+ /// relation to the exponential and Gamma distributions.
+ /// Wikipedia - Erlang distribution .
+ ///
+ /// The distribution will use the
+ /// The statistics classes will check all the incoming parameters whether they are in the allowed
+ /// range. This might involve heavy computation. Optionally, by setting Control.CheckDistributionParameters
+ /// to false , all parameter checks can be turned off.
+ /// Erlang shape parameter.
+ ///
+ private double _shape;
+
+ ///
+ /// Erlang inverse scale parameter.
+ ///
+ private double _invScale;
+
+ ///
+ /// The distribution's random number generator.
+ ///
+ private Random _random;
+
+ ///
+ /// Initializes a new instance of the
+ ///
+ /// Constructs a Erlang distribution from a shape and scale parameter. The distribution will
+ /// be initialized with the default
+ /// a normal distribution.
+ public static Erlang WithShapeScale(int shape, double scale)
+ {
+ return new Erlang(shape, 1.0 / scale);
+ }
+
+ ///
+ /// Constructs a Erlang distribution from a shape and inverse scale parameter. The distribution will
+ /// be initialized with the default
+ /// a normal distribution.
+ public static Erlang WithShapeInvScale(int shape, double invScale)
+ {
+ return new Erlang(shape, invScale);
+ }
+
+ ///
+ /// Sets the parameters of the distribution after checking their validity.
+ ///
+ ///
+ /// Checks whether the parameters of the distribution are valid.
+ ///
+ /// true when the parameters are valid, false otherwise.
+ /// Gets or sets the shape of the Erlang distribution.
+ ///
+ public int Shape
+ {
+ get
+ {
+ return (int)_shape;
+ }
+
+ set
+ {
+ SetParameters(value, _invScale);
+ }
+ }
+
+ ///
+ /// Gets or sets the scale of the Erlang distribution.
+ ///
+ public double Scale
+ {
+ get
+ {
+ return 1.0 / _invScale;
+ }
+
+ set
+ {
+ var invScale = 1.0 / value;
+
+ if (Double.IsNegativeInfinity(invScale))
+ {
+ invScale = -invScale;
+ }
+
+ SetParameters(_shape, invScale);
+ }
+ }
+
+ ///
+ /// Gets or sets the inverse scale of the Erlang distribution.
+ ///
+ public double InvScale
+ {
+ get
+ {
+ return _invScale;
+ }
+
+ set
+ {
+ SetParameters(_shape, value);
+ }
+ }
+
+ ///
+ /// A string representation of the distribution.
+ ///
+ /// a string representation of the distribution.
+ public override string ToString()
+ {
+ return "Erlang(Shape = " + _shape + ", Inverse Scale = " + _invScale + ")";
+ }
+
+ #region IDistribution Members
+
+ ///
+ /// Gets or sets the random number generator which is used to draw random samples.
+ ///
+ public Random RandomSource
+ {
+ get
+ {
+ return _random;
+ }
+
+ set
+ {
+ if (value == null)
+ {
+ throw new ArgumentNullException();
+ }
+
+ _random = value;
+ }
+ }
+
+ ///
+ /// Gets the mean of the distribution.
+ ///
+ public double Mean
+ {
+ get
+ {
+ if (Double.IsPositiveInfinity(_invScale))
+ {
+ return _shape;
+ }
+
+ if (_invScale == 0.0 && _shape == 0.0)
+ {
+ return Double.NaN;
+ }
+
+ return _shape / _invScale;
+ }
+ }
+
+ ///
+ /// Gets the variance of the distribution.
+ ///
+ public double Variance
+ {
+ get
+ {
+ if (Double.IsPositiveInfinity(_invScale))
+ {
+ return 0.0;
+ }
+
+ if (_invScale == 0.0 && _shape == 0.0)
+ {
+ return Double.NaN;
+ }
+
+ return _shape / (_invScale * _invScale);
+ }
+ }
+
+ ///
+ /// Gets the standard deviation of the distribution.
+ ///
+ public double StdDev
+ {
+ get
+ {
+ if (Double.IsPositiveInfinity(_invScale))
+ {
+ return 0.0;
+ }
+
+ if (_invScale == 0.0 && _shape == 0.0)
+ {
+ return Double.NaN;
+ }
+
+ return Math.Sqrt(_shape) / _invScale;
+ }
+ }
+
+ ///
+ /// Gets the entropy of the distribution.
+ ///
+ public double Entropy
+ {
+ get
+ {
+ if (Double.IsPositiveInfinity(_invScale))
+ {
+ return 0.0;
+ }
+
+ if (_invScale == 0.0 && _shape == 0.0)
+ {
+ return Double.NaN;
+ }
+
+ return _shape - Math.Log(_invScale) + SpecialFunctions.GammaLn(_shape) + ((1.0 - _shape) * SpecialFunctions.DiGamma(_shape));
+ }
+ }
+
+ ///
+ /// Gets the skewness of the distribution.
+ ///
+ public double Skewness
+ {
+ get
+ {
+ if (Double.IsPositiveInfinity(_invScale))
+ {
+ return 0.0;
+ }
+
+ if (_invScale == 0.0 && _shape == 0.0)
+ {
+ return Double.NaN;
+ }
+
+ return 2.0 / Math.Sqrt(_shape);
+ }
+ }
+
+ ///
+ /// Computes the cumulative distribution function of the Erlang distribution.
+ ///
+ /// the cumulative density at
+ public double CumulativeDistribution(double x)
+ {
+ if (Double.IsPositiveInfinity(_invScale))
+ {
+ return x >= _shape ? 1.0 : 0.0;
+ }
+
+ if (_shape == 0.0 && _invScale == 0.0)
+ {
+ return 0.0;
+ }
+
+ return SpecialFunctions.GammaLowerRegularized(_shape, x * _invScale);
+ }
+
+ #endregion
+
+ #region IContinuousDistribution Members
+
+ ///
+ /// Gets the mode of the distribution.
+ ///
+ public double Mode
+ {
+ get
+ {
+ if (_shape < 1)
+ {
+ throw new NotSupportedException();
+ }
+
+ if (Double.IsPositiveInfinity(_invScale))
+ {
+ return _shape;
+ }
+
+ if (_invScale == 0.0 && _shape == 0.0)
+ {
+ return Double.NaN;
+ }
+
+ return (_shape - 1.0) / _invScale;
+ }
+ }
+
+ ///
+ /// Gets the median of the distribution.
+ ///
+ public double Median
+ {
+ get
+ {
+ throw new NotSupportedException();
+ }
+ }
+
+ ///
+ /// Gets the minimum value.
+ ///
+ public double Minimum
+ {
+ get
+ {
+ return 0.0;
+ }
+ }
+
+ ///
+ /// Gets the Maximum value.
+ ///
+ public double Maximum
+ {
+ get
+ {
+ return double.PositiveInfinity;
+ }
+ }
+
+ ///
+ /// Computes the density of the distribution.
+ ///
+ /// the density at
+ public double Density(double x)
+ {
+ if (Double.IsPositiveInfinity(_invScale))
+ {
+ return x == _shape ? Double.PositiveInfinity : 0.0;
+ }
+
+ if (_shape == 0.0 && _invScale == 0.0)
+ {
+ return 0.0;
+ }
+
+ if (_shape == 1.0)
+ {
+ return _invScale * Math.Exp(-_invScale * x);
+ }
+
+ return Math.Pow(_invScale, _shape) * Math.Pow(x, _shape - 1.0) * Math.Exp(-_invScale * x) / SpecialFunctions.Gamma(_shape);
+ }
+
+ ///
+ /// Computes the log density of the distribution.
+ ///
+ /// the density at
+ public double DensityLn(double x)
+ {
+ if (Double.IsPositiveInfinity(_invScale))
+ {
+ return x == _shape ? Double.PositiveInfinity : Double.NegativeInfinity;
+ }
+
+ if (_shape == 0.0 && _invScale == 0.0)
+ {
+ return Double.NegativeInfinity;
+ }
+
+ if (_shape == 1.0)
+ {
+ return Math.Log(_invScale) - (_invScale * x);
+ }
+
+ return (_shape * Math.Log(_invScale)) + ((_shape - 1.0) * Math.Log(x)) - (_invScale * x) - SpecialFunctions.GammaLn(_shape);
+ }
+
+ ///
+ /// Generates a sample from the Erlang distribution.
+ ///
+ /// a sample from the distribution.
+ public double Sample()
+ {
+ return DoSample(RandomSource, _shape, _invScale);
+ }
+
+ ///
+ /// Generates a sequence of samples from the Erlang distribution.
+ ///
+ /// a sequence of samples from the distribution.
+ public IEnumerable Samples()
+ {
+ while (true)
+ {
+ yield return DoSample(RandomSource, _shape, _invScale);
+ }
+ }
+
+ #endregion
+
+ ///
+ /// Sampling implementation based on:
+ /// "A Simple Method for Generating Erlang Variables" - Marsaglia & Tsang
+ /// ACM Transactions on Mathematical Software, Vol. 26, No. 3, September 2000, Pages 363–372.
+ /// This method performs no parameter checks.
+ ///
+ /// A sample from a Erlang distributed random variable.
+ private static double DoSample(Random rnd, double shape, double invScale)
+ {
+ if (Double.IsPositiveInfinity(invScale))
+ {
+ return shape;
+ }
+
+ var a = shape;
+ var alphafix = 1.0;
+
+ // Fix when alpha is less than one.
+ if (shape < 1.0)
+ {
+ a = shape + 1.0;
+ alphafix = Math.Pow(rnd.NextDouble(), 1.0 / shape);
+ }
+
+ var d = a - (1.0 / 3.0);
+ var c = 1.0 / Math.Sqrt(9.0 * d);
+ while (true)
+ {
+ var x = Normal.Sample(rnd, 0.0, 1.0);
+ var v = 1.0 + (c * x);
+ while (v <= 0.0)
+ {
+ x = Normal.Sample(rnd, 0.0, 1.0);
+ v = 1.0 + (c * x);
+ }
+
+ v = v * v * v;
+ var u = rnd.NextDouble();
+ x = x * x;
+ if (u < 1.0 - (0.0331 * x * x))
+ {
+ return alphafix * d * v / invScale;
+ }
+
+ if (Math.Log(u) < (0.5 * x) + (d * (1.0 - v + Math.Log(v))))
+ {
+ return alphafix * d * v / invScale;
+ }
+ }
+ }
+ }
+}
diff --git a/src/Numerics/Distributions/Continuous/Exponential.cs b/src/Numerics/Distributions/Continuous/Exponential.cs
new file mode 100644
index 00000000..19267e2c
--- /dev/null
+++ b/src/Numerics/Distributions/Continuous/Exponential.cs
@@ -0,0 +1,332 @@
+//
+// Math.NET Numerics, part of the Math.NET Project
+// http://numerics.mathdotnet.com
+// http://github.com/mathnet/mathnet-numerics
+// http://mathnetnumerics.codeplex.com
+// Copyright (c) 2009-2010 Math.NET
+// Permission is hereby granted, free of charge, to any person
+// obtaining a copy of this software and associated documentation
+// files (the "Software"), to deal in the Software without
+// restriction, including without limitation the rights to use,
+// copy, modify, merge, publish, distribute, sublicense, and/or sell
+// copies of the Software, and to permit persons to whom the
+// Software is furnished to do so, subject to the following
+// conditions:
+// The above copyright notice and this permission notice shall be
+// included in all copies or substantial portions of the Software.
+// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
+// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
+// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+// OTHER DEALINGS IN THE SOFTWARE.
+//
+
+namespace MathNet.Numerics.Distributions
+{
+ using System;
+ using System.Collections.Generic;
+ using Properties;
+
+ ///
+ /// The exponential distribution is a distribution over the real numbers parameterized by one non-negative parameter.
+ /// Wikipedia - exponential distribution .
+ ///
+ /// The distribution will use the Users can set the random number generator by using the
+ /// The statistics classes will check all the incoming parameters whether they are in the allowed
+ /// range. This might involve heavy computation. Optionally, by setting Control.CheckDistributionParameters
+ /// to false , all parameter checks can be turned off.
+ public class Exponential : IContinuousDistribution
+ {
+ ///
+ /// The lambda parameter of the Exponential distribution.
+ ///
+ private double _lambda;
+
+ ///
+ /// The distribution's random number generator.
+ ///
+ private Random _random;
+
+ ///
+ /// Initializes a new instance of the
+ ///
+ /// Sets the parameters of the distribution after checking their validity.
+ ///
+ /// When the parameters don't pass the
+ private void SetParameters(double lambda)
+ {
+ if (Control.CheckDistributionParameters && !IsValidParameterSet(lambda))
+ {
+ throw new ArgumentOutOfRangeException(Resources.InvalidDistributionParameters);
+ }
+
+ _lambda = lambda;
+ }
+
+ ///
+ /// Checks whether the parameters of the distribution are valid.
+ ///
+ /// true when the parameters are valid, false otherwise.
+ /// Gets or sets the lambda parameter of the distribution.
+ ///
+ public double Lambda
+ {
+ get
+ {
+ return _lambda;
+ }
+
+ set
+ {
+ SetParameters(value);
+ }
+ }
+
+ ///
+ /// A string representation of the distribution.
+ ///
+ /// a string representation of the distribution.
+ public override string ToString()
+ {
+ return "Exponential(Lambda = " + _lambda + ")";
+ }
+
+ #region IDistribution Members
+
+ ///
+ /// Gets or sets the random number generator which is used to draw random samples.
+ ///
+ public Random RandomSource
+ {
+ get
+ {
+ return _random;
+ }
+
+ set
+ {
+ if (value == null)
+ {
+ throw new ArgumentNullException();
+ }
+
+ _random = value;
+ }
+ }
+
+ ///
+ /// Gets the mean of the distribution.
+ ///
+ public double Mean
+ {
+ get
+ {
+ return 1.0 / _lambda;
+ }
+ }
+
+ ///
+ /// Gets the variance of the distribution.
+ ///
+ public double Variance
+ {
+ get
+ {
+ return 1.0 / (_lambda * _lambda);
+ }
+ }
+
+ ///
+ /// Gets the standard deviation of the distribution.
+ ///
+ public double StdDev
+ {
+ get
+ {
+ return 1.0 / _lambda;
+ }
+ }
+
+ ///
+ /// Gets the entropy of the distribution.
+ ///
+ public double Entropy
+ {
+ get
+ {
+ return 1.0 - Math.Log(_lambda);
+ }
+ }
+
+ ///
+ /// Gets the skewness of the distribution.
+ ///
+ public double Skewness
+ {
+ get
+ {
+ return 2.0;
+ }
+ }
+
+ ///
+ /// Computes the cumulative distribution function of the distribution.
+ ///
+ /// the cumulative density at
+ public double CumulativeDistribution(double x)
+ {
+ if (x >= 0.0)
+ {
+ return 1.0 - Math.Exp(-_lambda * x);
+ }
+
+ return 0.0;
+ }
+
+ #endregion
+
+ #region IContinuousDistribution Members
+
+ ///
+ /// Gets the mode of the distribution.
+ ///
+ public double Mode
+ {
+ get
+ {
+ return 0.0;
+ }
+ }
+
+ ///
+ /// Gets the median of the distribution.
+ ///
+ public double Median
+ {
+ get
+ {
+ return Math.Log(2.0) / _lambda;
+ }
+ }
+
+ ///
+ /// Gets the minimum of the distribution.
+ ///
+ public double Minimum
+ {
+ get
+ {
+ return 0.0;
+ }
+ }
+
+ ///
+ /// Gets the maximum of the distribution.
+ ///
+ public double Maximum
+ {
+ get
+ {
+ return Double.PositiveInfinity;
+ }
+ }
+
+ ///
+ /// Computes the density of the distribution.
+ ///
+ /// the density at
+ public double Density(double x)
+ {
+ if (x >= 0.0)
+ {
+ return _lambda * Math.Exp(-_lambda * x);
+ }
+
+ return 0.0;
+ }
+
+ ///
+ /// Computes the log density of the distribution.
+ ///
+ /// the log density at
+ public double DensityLn(double x)
+ {
+ return Math.Log(_lambda) - (_lambda * x);
+ }
+
+ ///
+ /// Draws a random sample from the distribution.
+ ///
+ /// A random number from this distribution.
+ public double Sample()
+ {
+ return DoSample(RandomSource, _lambda);
+ }
+
+ ///
+ /// Generates a sequence of samples from the Exponential distribution.
+ ///
+ /// a sequence of samples from the distribution.
+ public IEnumerable Samples()
+ {
+ while (true)
+ {
+ yield return DoSample(RandomSource, _lambda);
+ }
+ }
+
+ #endregion
+
+ ///
+ /// Samples the distribution.
+ ///
+ /// a random number from the distribution.
+ private static double DoSample(Random rnd, double lambda)
+ {
+ var r = rnd.NextDouble();
+ while (r == 0.0)
+ {
+ r = rnd.NextDouble();
+ }
+
+ return -Math.Log(r) / lambda;
+ }
+ }
+}
diff --git a/src/Numerics/Distributions/Continuous/FisherSnedecor.cs b/src/Numerics/Distributions/Continuous/FisherSnedecor.cs
new file mode 100644
index 00000000..bd7090ea
--- /dev/null
+++ b/src/Numerics/Distributions/Continuous/FisherSnedecor.cs
@@ -0,0 +1,363 @@
+//
+// Math.NET Numerics, part of the Math.NET Project
+// http://numerics.mathdotnet.com
+// http://github.com/mathnet/mathnet-numerics
+// http://mathnetnumerics.codeplex.com
+// Copyright (c) 2009-2010 Math.NET
+// Permission is hereby granted, free of charge, to any person
+// obtaining a copy of this software and associated documentation
+// files (the "Software"), to deal in the Software without
+// restriction, including without limitation the rights to use,
+// copy, modify, merge, publish, distribute, sublicense, and/or sell
+// copies of the Software, and to permit persons to whom the
+// Software is furnished to do so, subject to the following
+// conditions:
+// The above copyright notice and this permission notice shall be
+// included in all copies or substantial portions of the Software.
+// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
+// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
+// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+// OTHER DEALINGS IN THE SOFTWARE.
+//
+
+namespace MathNet.Numerics.Distributions
+{
+ using System;
+ using System.Collections.Generic;
+ using Properties;
+
+ ///
+ /// Implements the FisherSnedecor distribution. For details about this distribution, see
+ /// Wikipedia - FisherSnedecor distribution .
+ ///
+ /// The distribution will use the
+ /// The statistics classes will check all the incoming parameters whether they are in the allowed
+ /// range. This might involve heavy computation. Optionally, by setting Control.CheckDistributionParameters
+ /// to false , all parameter checks can be turned off.
+ /// The first parameter - degree of freedom.
+ ///
+ private double _d1;
+
+ ///
+ /// The second parameter - degree of freedom.
+ ///
+ private double _d2;
+
+ ///
+ /// The distribution's random number generator.
+ ///
+ private Random _random;
+
+ ///
+ /// Initializes a new instance of the
+ ///
+ /// Sets the parameters of the distribution after checking their validity.
+ ///
+ ///
+ /// Checks whether the parameters of the distribution are valid.
+ ///
+ /// true when the parameters are valid, false otherwise.
+ /// Gets or sets the first parameter - degree of freedom.
+ ///
+ public double DegreeOfFreedom1
+ {
+ get
+ {
+ return _d1;
+ }
+
+ set
+ {
+ SetParameters(value, _d2);
+ }
+ }
+
+ ///
+ /// Gets or sets the second parameter - degree of freedom.
+ ///
+ public double DegreeOfFreedom2
+ {
+ get
+ {
+ return _d2;
+ }
+
+ set
+ {
+ SetParameters(_d1, value);
+ }
+ }
+
+ ///
+ /// A string representation of the distribution.
+ ///
+ /// a string representation of the distribution.
+ public override string ToString()
+ {
+ return "FisherSnedecor(DegreeOfFreedom1 = " + _d1 + ", DegreeOfFreedom2 = " + _d2 + ")";
+ }
+
+ #region IDistribution Members
+
+ ///
+ /// Gets or sets the distribution's random number generator.
+ ///
+ public Random RandomSource
+ {
+ get
+ {
+ return _random;
+ }
+
+ set
+ {
+ if (value == null)
+ {
+ throw new ArgumentNullException(Resources.InvalidDistributionParameters);
+ }
+
+ _random = value;
+ }
+ }
+
+ ///
+ /// Gets the mean of the distribution.
+ ///
+ public double Mean
+ {
+ get
+ {
+ if (_d2 <= 2)
+ {
+ throw new NotSupportedException();
+ }
+
+ return _d2 / (_d2 - 2.0);
+ }
+ }
+
+ ///
+ /// Gets the variance of the distribution.
+ ///
+ public double Variance
+ {
+ get
+ {
+ if (_d2 <= 4)
+ {
+ throw new NotSupportedException();
+ }
+
+ return (2.0 * _d2 * _d2 * (_d1 + _d2 - 2.0)) / (_d1 * (_d2 - 2.0) * (_d2 - 2.0) * (_d2 - 4.0));
+ }
+ }
+
+ ///
+ /// Gets the standard deviation of the distribution.
+ ///
+ public double StdDev
+ {
+ get
+ {
+ return Math.Sqrt(Variance);
+ }
+ }
+
+ ///
+ /// Gets the entropy of the distribution.
+ ///
+ public double Entropy
+ {
+ get
+ {
+ throw new NotSupportedException();
+ }
+ }
+
+ ///
+ /// Gets the skewness of the distribution.
+ ///
+ public double Skewness
+ {
+ get
+ {
+ if (_d2 <= 6)
+ {
+ throw new NotSupportedException();
+ }
+
+ return (((2.0 * _d1) + _d2 - 2.0) * Math.Sqrt(8.0 * (_d2 - 4.0))) / ((_d2 - 6.0) * Math.Sqrt(_d1 * (_d1 + _d2 - 2.0)));
+ }
+ }
+
+ ///
+ /// Computes the cumulative distribution function of the distribution.
+ ///
+ /// the cumulative density at
+ public double CumulativeDistribution(double x)
+ {
+ return SpecialFunctions.BetaRegularized(_d1 / 2.0, _d2 / 2.0, _d1 * _d2 / (_d1 + (_d1 * _d2)));
+ }
+
+ #endregion
+
+ #region IContinuousDistribution Members
+
+ ///
+ /// Gets the mode of the distribution.
+ ///
+ public double Mode
+ {
+ get
+ {
+ if (_d1 <= 2)
+ {
+ throw new NotSupportedException();
+ }
+
+ return (_d2 * (_d1 - 2.0)) / (_d1 * (_d2 + 2.0));
+ }
+ }
+
+ ///
+ /// Gets the median of the distribution.
+ ///
+ public double Median
+ {
+ get
+ {
+ throw new NotSupportedException();
+ }
+ }
+
+ ///
+ /// Gets the minimum of the distribution.
+ ///
+ public double Minimum
+ {
+ get
+ {
+ return 0.0;
+ }
+ }
+
+ ///
+ /// Gets the maximum of the distribution.
+ ///
+ public double Maximum
+ {
+ get
+ {
+ return double.PositiveInfinity;
+ }
+ }
+
+ ///
+ /// Computes the density of the distribution.
+ ///
+ /// the density at
+ public double Density(double x)
+ {
+ return Math.Sqrt(Math.Pow(_d1 * x, _d1) * Math.Pow(_d2, _d2) / Math.Pow((_d1 * x) + _d2, _d1 + _d2)) / (x * SpecialFunctions.Beta(_d1 / 2.0, _d2 / 2.0));
+ }
+
+ ///
+ /// Computes the log density of the distribution.
+ ///
+ /// the log density at
+ public double DensityLn(double x)
+ {
+ return Math.Log(Density(x));
+ }
+
+ ///
+ /// Generates a sample from the FisherSnedecor distribution.
+ ///
+ /// a sample from the distribution.
+ public double Sample()
+ {
+ return DoSample(RandomSource, _d1, _d2);
+ }
+
+ ///
+ /// Generates a sequence of samples from the FisherSnedecor distribution.
+ ///
+ /// a sequence of samples from the distribution.
+ public IEnumerable Samples()
+ {
+ while (true)
+ {
+ yield return DoSample(RandomSource, _d1, _d2);
+ }
+ }
+
+ #endregion
+
+ ///
+ /// Generates one sample from the FisherSnedecor distribution without parameter checking.
+ ///
+ /// a FisherSnedecor distributed random number.
+ private static double DoSample(Random rnd, double d1, double d2)
+ {
+ return (ChiSquare.Sample(rnd, d1) / d1) / (ChiSquare.Sample(rnd, d2) / d2);
+ }
+ }
+}
diff --git a/src/Numerics/Distributions/Continuous/Gamma.cs b/src/Numerics/Distributions/Continuous/Gamma.cs
index 0c87d39e..39a11a86 100644
--- a/src/Numerics/Distributions/Continuous/Gamma.cs
+++ b/src/Numerics/Distributions/Continuous/Gamma.cs
@@ -3,9 +3,7 @@
// http://numerics.mathdotnet.com
// http://github.com/mathnet/mathnet-numerics
// http://mathnetnumerics.codeplex.com
-//
// Copyright (c) 2009-2010 Math.NET
-//
// Permission is hereby granted, free of charge, to any person
// obtaining a copy of this software and associated documentation
// files (the "Software"), to deal in the Software without
@@ -14,10 +12,8 @@
// copies of the Software, and to permit persons to whom the
// Software is furnished to do so, subject to the following
// conditions:
-//
// The above copyright notice and this permission notice shall be
// included in all copies or substantial portions of the Software.
-//
// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
@@ -50,7 +46,7 @@ namespace MathNet.Numerics.Distributions
/// Users can get/set the random number generator by using the The statistics classes will check all the incoming parameters whether they are in the allowed
/// range. This might involve heavy computation. Optionally, by setting Control.CheckDistributionParameters
- /// to false, all parameter checks can be turned off.
+ /// to false , all parameter checks can be turned off.
public class Gamma : IContinuousDistribution
{
///
@@ -88,7 +84,7 @@ namespace MathNet.Numerics.Distributions
/// a normal distribution.
public static Gamma WithShapeScale(double shape, double scale)
{
- return new Gamma(shape, 1.0/scale);
+ return new Gamma(shape, 1.0 / scale);
}
///
@@ -117,7 +113,7 @@ namespace MathNet.Numerics.Distributions
///
/// True when the parameters are valid, false otherwise.
+ /// true when the parameters are valid, false otherwise.
public double Median
{
- get { throw new NotSupportedException(); }
+ get
+ {
+ throw new NotSupportedException();
+ }
}
///
@@ -371,7 +365,10 @@ namespace MathNet.Numerics.Distributions
///
public double Minimum
{
- get { return 0.0; }
+ get
+ {
+ return 0.0;
+ }
}
///
@@ -379,7 +376,10 @@ namespace MathNet.Numerics.Distributions
///
public double Maximum
{
- get { return Double.PositiveInfinity; }
+ get
+ {
+ return Double.PositiveInfinity;
+ }
}
///
@@ -391,27 +391,20 @@ namespace MathNet.Numerics.Distributions
{
if (Double.IsPositiveInfinity(_invScale))
{
- if (x == _shape)
- {
- return Double.PositiveInfinity;
- }
- else
- {
- return 0.0;
- }
+ return x == _shape ? Double.PositiveInfinity : 0.0;
}
- else if (_shape == 0.0 && _invScale == 0.0)
+
+ if (_shape == 0.0 && _invScale == 0.0)
{
return 0.0;
}
- else if (_shape == 1.0)
+
+ if (_shape == 1.0)
{
- return _invScale * Math.Exp(- _invScale * x);
+ return _invScale * Math.Exp(-_invScale * x);
}
- else
- {
- return Math.Pow(_invScale, _shape) * Math.Pow(x, _shape - 1.0) * Math.Exp(-_invScale * x) / SpecialFunctions.Gamma(_shape);
- }
+
+ return Math.Pow(_invScale, _shape) * Math.Pow(x, _shape - 1.0) * Math.Exp(-_invScale * x) / SpecialFunctions.Gamma(_shape);
}
///
@@ -423,27 +416,20 @@ namespace MathNet.Numerics.Distributions
{
if (Double.IsPositiveInfinity(_invScale))
{
- if (x == _shape)
- {
- return Double.PositiveInfinity;
- }
- else
- {
- return Double.NegativeInfinity;
- }
+ return x == _shape ? Double.PositiveInfinity : Double.NegativeInfinity;
}
- else if(_shape == 0.0 && _invScale == 0.0)
+
+ if (_shape == 0.0 && _invScale == 0.0)
{
return Double.NegativeInfinity;
}
- else if(_shape == 1.0)
+
+ if (_shape == 1.0)
{
return Math.Log(_invScale) - (_invScale * x);
}
- else
- {
- return (_shape * Math.Log(_invScale)) + ((_shape - 1.0) * Math.Log(x)) - (_invScale * x) - SpecialFunctions.GammaLn(_shape);
- }
+
+ return (_shape * Math.Log(_invScale)) + ((_shape - 1.0) * Math.Log(x)) - (_invScale * x) - SpecialFunctions.GammaLn(_shape);
}
///
@@ -455,23 +441,15 @@ namespace MathNet.Numerics.Distributions
{
if (Double.IsPositiveInfinity(_invScale))
{
- if (x >= _shape)
- {
- return 1.0;
- }
- else
- {
- return 0.0;
- }
+ return x >= _shape ? 1.0 : 0.0;
}
- else if (_shape == 0.0 && _invScale == 0.0)
+
+ if (_shape == 0.0 && _invScale == 0.0)
{
return 0.0;
}
- else
- {
- return SpecialFunctions.GammaLowerRegularized(_shape, x * _invScale);
- }
+
+ return SpecialFunctions.GammaLowerRegularized(_shape, x * _invScale);
}
///
@@ -494,6 +472,7 @@ namespace MathNet.Numerics.Distributions
yield return SampleGamma(RandomSource, _shape, _invScale);
}
}
+
#endregion
///
@@ -543,48 +522,46 @@ namespace MathNet.Numerics.Distributions
/// A sample from a Gamma distributed random variable.
- internal static double SampleGamma(System.Random rnd, double shape, double invScale)
+ internal static double SampleGamma(Random rnd, double shape, double invScale)
{
if (Double.IsPositiveInfinity(invScale))
{
return shape;
}
- else
+
+ var a = shape;
+ var alphafix = 1.0;
+
+ // Fix when alpha is less than one.
+ if (shape < 1.0)
+ {
+ a = shape + 1.0;
+ alphafix = Math.Pow(rnd.NextDouble(), 1.0 / shape);
+ }
+
+ var d = a - (1.0 / 3.0);
+ var c = 1.0 / Math.Sqrt(9.0 * d);
+ while (true)
{
- double a = shape;
- double alphafix = 1.0;
+ var x = Normal.Sample(rnd, 0.0, 1.0);
+ var v = 1.0 + (c * x);
+ while (v <= 0.0)
+ {
+ x = Normal.Sample(rnd, 0.0, 1.0);
+ v = 1.0 + (c * x);
+ }
- // Fix when alpha is less than one.
- if (shape < 1.0)
+ v = v * v * v;
+ var u = rnd.NextDouble();
+ x = x * x;
+ if (u < 1.0 - (0.0331 * x * x))
{
- a = shape + 1.0;
- alphafix = System.Math.Pow(rnd.NextDouble(), 1.0 / shape);
+ return alphafix * d * v / invScale;
}
- double d = a - (1.0 / 3.0);
- double c = 1.0 / System.Math.Sqrt(9.0 * d);
- while (true)
+ if (Math.Log(u) < (0.5 * x) + (d * (1.0 - v + Math.Log(v))))
{
- double x = Normal.Sample(rnd, 0.0, 1.0);
- double v = 1.0 + (c * x);
- while (v <= 0.0)
- {
- x = Normal.Sample(rnd, 0.0, 1.0);
- v = 1.0 + (c * x);
- }
-
- v = v * v * v;
- double u = rnd.NextDouble();
- x = x * x;
- if (u < 1.0 - (0.0331 * x * x))
- {
- return alphafix * d * v / invScale;
- }
-
- if (System.Math.Log(u) < (0.5 * x) + (d * (1.0 - v + System.Math.Log(v))))
- {
- return alphafix * d * v / invScale;
- }
+ return alphafix * d * v / invScale;
}
}
}
diff --git a/src/Numerics/Distributions/Continuous/InverseGamma.cs b/src/Numerics/Distributions/Continuous/InverseGamma.cs
new file mode 100644
index 00000000..c4963772
--- /dev/null
+++ b/src/Numerics/Distributions/Continuous/InverseGamma.cs
@@ -0,0 +1,378 @@
+//
+// Math.NET Numerics, part of the Math.NET Project
+// http://numerics.mathdotnet.com
+// http://github.com/mathnet/mathnet-numerics
+// http://mathnetnumerics.codeplex.com
+// Copyright (c) 2009-2010 Math.NET
+// Permission is hereby granted, free of charge, to any person
+// obtaining a copy of this software and associated documentation
+// files (the "Software"), to deal in the Software without
+// restriction, including without limitation the rights to use,
+// copy, modify, merge, publish, distribute, sublicense, and/or sell
+// copies of the Software, and to permit persons to whom the
+// Software is furnished to do so, subject to the following
+// conditions:
+// The above copyright notice and this permission notice shall be
+// included in all copies or substantial portions of the Software.
+// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
+// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
+// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+// OTHER DEALINGS IN THE SOFTWARE.
+//
+
+namespace MathNet.Numerics.Distributions
+{
+ using System;
+ using System.Collections.Generic;
+ using Properties;
+
+ ///
+ /// The inverse Gamma distribution is a distribution over the positive real numbers parameterized by
+ /// two positive parameters.
+ /// Wikipedia - InverseGamma distribution .
+ ///
+ /// The distribution will use the
+ /// The statistics classes will check all the incoming parameters whether they are in the allowed
+ /// range. This might involve heavy computation. Optionally, by setting Control.CheckDistributionParameters
+ /// to false , all parameter checks can be turned off.
+ /// Inverse Gamma shape parameter.
+ ///
+ private double _shape;
+
+ ///
+ /// Inverse Gamma scale parameter scale.
+ ///
+ private double _scale;
+
+ ///
+ /// The distribution's random number generator.
+ ///
+ private Random _random;
+
+ ///
+ /// Initializes a new instance of the
+ ///
+ /// Sets the parameters of the distribution after checking their validity.
+ ///
+ /// When the parameters don't pass the
+ private void SetParameters(double shape, double scale)
+ {
+ if (Control.CheckDistributionParameters && !IsValidParameterSet(shape, scale))
+ {
+ throw new ArgumentOutOfRangeException(Resources.InvalidDistributionParameters);
+ }
+
+ _shape = shape;
+ _scale = scale;
+ }
+
+ ///
+ /// Checks whether the parameters of the distribution are valid.
+ ///
+ /// true when the parameters are valid, false otherwise.
+ /// Gets or sets the shape (alpha) parameter.
+ ///
+ public double Shape
+ {
+ get
+ {
+ return _shape;
+ }
+
+ set
+ {
+ SetParameters(value, _scale);
+ }
+ }
+
+ ///
+ /// Gets or sets The scale (beta) parameter.
+ ///
+ public double Scale
+ {
+ get
+ {
+ return _scale;
+ }
+
+ set
+ {
+ SetParameters(_shape, value);
+ }
+ }
+
+ ///
+ /// A string representation of the distribution.
+ ///
+ /// a string representation of the distribution.
+ public override string ToString()
+ {
+ return "InverseGamma(Shape = " + _shape + ", Inverse Scale = " + _scale + ")";
+ }
+
+ #region IDistribution Members
+
+ ///
+ /// Gets or sets the random number generator which is used to draw random samples.
+ ///
+ public Random RandomSource
+ {
+ get
+ {
+ return _random;
+ }
+
+ set
+ {
+ if (value == null)
+ {
+ throw new ArgumentNullException();
+ }
+
+ _random = value;
+ }
+ }
+
+ ///
+ /// Gets the mean of the distribution.
+ ///
+ public double Mean
+ {
+ get
+ {
+ if (_shape <= 1)
+ {
+ throw new NotSupportedException();
+ }
+
+ return _scale / (_shape - 1.0);
+ }
+ }
+
+ ///
+ /// Gets the variance of the distribution.
+ ///
+ public double Variance
+ {
+ get
+ {
+ if (_shape <= 2)
+ {
+ throw new NotSupportedException();
+ }
+
+ return _scale * _scale / ((_shape - 1.0) * (_shape - 1.0) * (_shape - 2.0));
+ }
+ }
+
+ ///
+ /// Gets the standard deviation of the distribution.
+ ///
+ public double StdDev
+ {
+ get
+ {
+ return _scale / (Math.Abs(_shape - 1.0) * Math.Sqrt(_shape - 2.0));
+ }
+ }
+
+ ///
+ /// Gets the entropy of the distribution.
+ ///
+ public double Entropy
+ {
+ get
+ {
+ return _shape + Math.Log(_scale) + SpecialFunctions.GammaLn(_shape) - ((1 + _shape) * SpecialFunctions.DiGamma(_shape));
+ }
+ }
+
+ ///
+ /// Gets the skewness of the distribution.
+ ///
+ public double Skewness
+ {
+ get
+ {
+ if (_shape <= 3)
+ {
+ throw new NotSupportedException();
+ }
+
+ return (4 * Math.Sqrt(_shape - 2)) / (_shape - 3);
+ }
+ }
+
+ ///
+ /// Computes the cumulative distribution function of the distribution.
+ ///
+ /// the cumulative density at
+ public double CumulativeDistribution(double x)
+ {
+ return SpecialFunctions.GammaLowerIncomplete(_shape, _scale / x);
+ }
+
+ #endregion
+
+ #region IContinuousDistribution Members
+
+ ///
+ /// Gets the mode of the distribution.
+ ///
+ public double Mode
+ {
+ get
+ {
+ return _scale / (_shape + 1.0);
+ }
+ }
+
+ ///
+ /// Gets the median of the distribution.
+ ///
+ /// Throws
+ public double Median
+ {
+ get
+ {
+ throw new NotImplementedException();
+ }
+ }
+
+ ///
+ /// Gets the minimum of the distribution.
+ ///
+ public double Minimum
+ {
+ get
+ {
+ return 0.0;
+ }
+ }
+
+ ///
+ /// Gets the maximum of the distribution.
+ ///
+ public double Maximum
+ {
+ get
+ {
+ return Double.PositiveInfinity;
+ }
+ }
+
+ ///
+ /// Computes the density of the distribution.
+ ///
+ /// the density at
+ public double Density(double x)
+ {
+ if (x >= 0.0)
+ {
+ return Math.Pow(_scale, _shape) * Math.Pow(x, -_shape - 1.0) * Math.Exp(-_scale / x) / SpecialFunctions.Gamma(_shape);
+ }
+
+ return 0.0;
+ }
+
+ ///
+ /// Computes the log density of the distribution.
+ ///
+ /// the log density at
+ public double DensityLn(double x)
+ {
+ return Math.Log(Density(x));
+ }
+
+ ///
+ /// Draws a random sample from the distribution.
+ ///
+ /// A random number from this distribution.
+ public double Sample()
+ {
+ return DoSample(RandomSource, _shape, _scale);
+ }
+
+ ///
+ /// Generates a sequence of samples from the Cauchy distribution.
+ ///
+ /// a sequence of samples from the distribution.
+ public IEnumerable Samples()
+ {
+ while (true)
+ {
+ yield return DoSample(RandomSource, _shape, _scale);
+ }
+ }
+
+ #endregion
+
+ ///
+ /// Samples the distribution.
+ ///
+ /// a random number from the distribution.
+ private static double DoSample(Random rnd, double shape, double scale)
+ {
+ return 1.0 / Gamma.Sample(rnd, shape, scale);
+ }
+ }
+}
diff --git a/src/Numerics/Distributions/Continuous/Laplace.cs b/src/Numerics/Distributions/Continuous/Laplace.cs
new file mode 100644
index 00000000..f822fbfe
--- /dev/null
+++ b/src/Numerics/Distributions/Continuous/Laplace.cs
@@ -0,0 +1,350 @@
+//
+// Math.NET Numerics, part of the Math.NET Project
+// http://numerics.mathdotnet.com
+// http://github.com/mathnet/mathnet-numerics
+// http://mathnetnumerics.codeplex.com
+// Copyright (c) 2009-2010 Math.NET
+// Permission is hereby granted, free of charge, to any person
+// obtaining a copy of this software and associated documentation
+// files (the "Software"), to deal in the Software without
+// restriction, including without limitation the rights to use,
+// copy, modify, merge, publish, distribute, sublicense, and/or sell
+// copies of the Software, and to permit persons to whom the
+// Software is furnished to do so, subject to the following
+// conditions:
+// The above copyright notice and this permission notice shall be
+// included in all copies or substantial portions of the Software.
+// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
+// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
+// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+// OTHER DEALINGS IN THE SOFTWARE.
+//
+
+namespace MathNet.Numerics.Distributions
+{
+ using System;
+ using System.Collections.Generic;
+ using Properties;
+
+ ///
+ /// The Laplace distribution is a distribution over the real numbers parameterized by a mean and
+ /// scale parameter. The PDF is:
+ /// p(x) = \frac{1}{2 * scale} \exp{- |x - mean| / scale}.
+ /// Wikipedia - Laplace distribution .
+ ///
+ /// The distribution will use the Users can set the random number generator by using the
+ /// The statistics classes will check all the incoming parameters whether they are in the allowed
+ /// range. This might involve heavy computation. Optionally, by setting Control.CheckDistributionParameters
+ /// to false , all parameter checks can be turned off.
+ public class Laplace : IContinuousDistribution
+ {
+ ///
+ /// The scale of the Laplace distribution.
+ ///
+ private double _scale;
+
+ ///
+ /// The distribution's random number generator.
+ ///
+ private Random _random;
+
+ ///
+ /// Gets or sets the location of the Laplace distribution.
+ ///
+ public double Location
+ {
+ get
+ {
+ return Mean;
+ }
+
+ set
+ {
+ SetParameters(value, _scale);
+ }
+ }
+
+ ///
+ /// Gets or sets the scale of the Laplace distribution.
+ ///
+ public double Scale
+ {
+ get
+ {
+ return _scale;
+ }
+
+ set
+ {
+ SetParameters(Mean, value);
+ }
+ }
+
+ ///
+ /// Initializes a new instance of the
+ public Laplace() : this(0.0, 1.0)
+ {
+ }
+
+ ///
+ /// Initializes a new instance of the
+ ///
+ /// If
+ public Laplace(double location, double scale)
+ {
+ SetParameters(location, scale);
+ RandomSource = new Random();
+ }
+
+ ///
+ /// Sets the parameters of the distribution after checking their validity.
+ ///
+ /// When the parameters don't pass the
+ private void SetParameters(double location, double scale)
+ {
+ if (Control.CheckDistributionParameters && !IsValidParameterSet(location, scale))
+ {
+ throw new ArgumentOutOfRangeException(Resources.InvalidDistributionParameters);
+ }
+
+ Mean = location;
+ _scale = scale;
+ }
+
+ ///
+ /// Checks whether the parameters of the distribution are valid.
+ ///
+ /// true when the parameters are valid, false otherwise.
+ /// A string representation of the distribution.
+ ///
+ /// a string representation of the distribution.
+ public override string ToString()
+ {
+ return "Laplace(Location = " + Mean + ", Scale = " + _scale + ")";
+ }
+
+ #region IDistribution Members
+
+ ///
+ /// Gets or sets the random number generator which is used to draw random samples.
+ ///
+ public Random RandomSource
+ {
+ get
+ {
+ return _random;
+ }
+
+ set
+ {
+ if (value == null)
+ {
+ throw new ArgumentNullException();
+ }
+
+ _random = value;
+ }
+ }
+
+ ///
+ /// Gets the mean of the distribution.
+ ///
+ public double Mean
+ {
+ get;
+ private set;
+ }
+
+ ///
+ /// Gets the variance of the distribution.
+ ///
+ public double Variance
+ {
+ get
+ {
+ return 2.0 * _scale * _scale;
+ }
+ }
+
+ ///
+ /// Gets the standard deviation of the distribution.
+ ///
+ public double StdDev
+ {
+ get
+ {
+ return Math.Sqrt(2.0) * _scale;
+ }
+ }
+
+ ///
+ /// Gets the entropy of the distribution.
+ ///
+ public double Entropy
+ {
+ get
+ {
+ return Math.Log(2.0 * Constants.E * _scale);
+ }
+ }
+
+ ///
+ /// Gets the skewness of the distribution.
+ ///
+ public double Skewness
+ {
+ get
+ {
+ return 0.0;
+ }
+ }
+
+ ///
+ /// Computes the cumulative distribution function of the distribution.
+ ///
+ /// the cumulative density at
+ public double CumulativeDistribution(double x)
+ {
+ return 0.5 * (1.0 + (Math.Sign(x - Mean) * (1.0 - Math.Exp(-Math.Abs(x - Mean) / _scale))));
+ }
+
+ #endregion
+
+ #region IContinuousDistribution Members
+
+ ///
+ /// Gets the mode of the distribution.
+ ///
+ public double Mode
+ {
+ get
+ {
+ return Mean;
+ }
+ }
+
+ ///
+ /// Gets the median of the distribution.
+ ///
+ public double Median
+ {
+ get
+ {
+ return Mean;
+ }
+ }
+
+ ///
+ /// Gets the minimum of the distribution.
+ ///
+ public double Minimum
+ {
+ get
+ {
+ return Double.NegativeInfinity;
+ }
+ }
+
+ ///
+ /// Gets the maximum of the distribution.
+ ///
+ public double Maximum
+ {
+ get
+ {
+ return Double.PositiveInfinity;
+ }
+ }
+
+ ///
+ /// Computes the density of the distribution.
+ ///
+ /// the density at
+ public double Density(double x)
+ {
+ return Math.Exp(-Math.Abs(x - Mean) / _scale) / (2.0 * _scale);
+ }
+
+ ///
+ /// Computes the log density of the distribution.
+ ///
+ /// the log density at
+ public double DensityLn(double x)
+ {
+ return Math.Log(Density(x));
+ }
+
+ ///
+ /// Samples a Laplace distributed random variable.
+ ///
+ /// a sample from the distribution.
+ public double Sample()
+ {
+ return DoSample(RandomSource, Mean, _scale);
+ }
+
+ ///
+ /// Generates a sample from the Laplace distribution.
+ ///
+ /// a sample from the distribution.
+ public IEnumerable Samples()
+ {
+ while (true)
+ {
+ yield return DoSample(RandomSource, Mean, _scale);
+ }
+ }
+
+ #endregion
+
+ ///
+ /// Samples the distribution.
+ ///
+ /// a random number from the distribution.
+ private static double DoSample(Random rnd, double location, double scale)
+ {
+ var u = rnd.NextDouble() - 0.5;
+ return location - (scale * Math.Sign(u) * Math.Log(1.0 - (2.0 * Math.Abs(u))));
+ }
+ }
+}
diff --git a/src/Numerics/Distributions/Continuous/LogNormal.cs b/src/Numerics/Distributions/Continuous/LogNormal.cs
index 7566a9a9..1c723281 100644
--- a/src/Numerics/Distributions/Continuous/LogNormal.cs
+++ b/src/Numerics/Distributions/Continuous/LogNormal.cs
@@ -3,9 +3,7 @@
// http://numerics.mathdotnet.com
// http://github.com/mathnet/mathnet-numerics
// http://mathnetnumerics.codeplex.com
-//
// Copyright (c) 2009-2010 Math.NET
-//
// Permission is hereby granted, free of charge, to any person
// obtaining a copy of this software and associated documentation
// files (the "Software"), to deal in the Software without
@@ -14,10 +12,8 @@
// copies of the Software, and to permit persons to whom the
// Software is furnished to do so, subject to the following
// conditions:
-//
// The above copyright notice and this permission notice shall be
// included in all copies or substantial portions of the Software.
-//
// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
@@ -42,7 +38,7 @@ namespace MathNet.Numerics.Distributions
/// Users can get/set the random number generator by using the The statistics classes will check all the incoming parameters whether they are in the allowed
/// range. This might involve heavy computation. Optionally, by setting Control.CheckDistributionParameters
- /// to false, all parameter checks can be turned off.
+ /// to false , all parameter checks can be turned off.
public class LogNormal : IContinuousDistribution
{
///
@@ -61,11 +57,16 @@ namespace MathNet.Numerics.Distributions
private Random _random;
///
- /// Initializes a new instance of the Log-Normal class. The distribution will
- /// be initialized with the default
- ///
/// True when the parameters are valid, false otherwise.
+ /// true when the parameters are valid, false otherwise.
public double Mu
{
- get { return _mu; }
+ get
+ {
+ return _mu;
+ }
- set { SetParameters(value, _sigma); }
+ set
+ {
+ SetParameters(value, _sigma);
+ }
}
///
@@ -129,9 +136,15 @@ namespace MathNet.Numerics.Distributions
///
public double Sigma
{
- get { return _sigma; }
+ get
+ {
+ return _sigma;
+ }
- set { SetParameters(_mu, value); }
+ set
+ {
+ SetParameters(_mu, value);
+ }
}
#region IDistribution implementation
@@ -162,7 +175,10 @@ namespace MathNet.Numerics.Distributions
///
public double Mean
{
- get { return Math.Exp(_mu + _sigma * _sigma / 2.0); }
+ get
+ {
+ return Math.Exp(_mu + (_sigma * _sigma / 2.0));
+ }
}
///
@@ -172,7 +188,7 @@ namespace MathNet.Numerics.Distributions
{
get
{
- double sigma2 = _sigma * _sigma;
+ var sigma2 = _sigma * _sigma;
return (Math.Exp(sigma2) - 1.0) * Math.Exp(_mu + _mu + sigma2);
}
}
@@ -184,7 +200,7 @@ namespace MathNet.Numerics.Distributions
{
get
{
- double sigma2 = _sigma * _sigma;
+ var sigma2 = _sigma * _sigma;
return Math.Sqrt((Math.Exp(sigma2) - 1.0) * Math.Exp(_mu + _mu + sigma2));
}
}
@@ -194,7 +210,10 @@ namespace MathNet.Numerics.Distributions
///
public double Entropy
{
- get { return 0.5 + Math.Log(_sigma) + _mu + Constants.LogSqrt2Pi; }
+ get
+ {
+ return 0.5 + Math.Log(_sigma) + _mu + Constants.LogSqrt2Pi;
+ }
}
///
@@ -204,10 +223,11 @@ namespace MathNet.Numerics.Distributions
{
get
{
- double expsigma2 = Math.Exp(_sigma * _sigma);
+ var expsigma2 = Math.Exp(_sigma * _sigma);
return (expsigma2 + 2.0) * Math.Sqrt(expsigma2 - 1);
}
}
+
#endregion
#region IContinuousDistribution implementation
@@ -217,7 +237,10 @@ namespace MathNet.Numerics.Distributions
///
public double Mode
{
- get { return Math.Exp(_mu - _sigma * _sigma); }
+ get
+ {
+ return Math.Exp(_mu - (_sigma * _sigma));
+ }
}
///
@@ -225,7 +248,10 @@ namespace MathNet.Numerics.Distributions
///
public double Median
{
- get { return Math.Exp(_mu); }
+ get
+ {
+ return Math.Exp(_mu);
+ }
}
///
@@ -233,7 +259,10 @@ namespace MathNet.Numerics.Distributions
///
public double Minimum
{
- get { return 0.0; }
+ get
+ {
+ return 0.0;
+ }
}
///
@@ -241,7 +270,10 @@ namespace MathNet.Numerics.Distributions
///
public double Maximum
{
- get { return Double.PositiveInfinity; }
+ get
+ {
+ return Double.PositiveInfinity;
+ }
}
///
@@ -256,7 +288,7 @@ namespace MathNet.Numerics.Distributions
return 0.0;
}
- double a = (Math.Log(x) - _mu) / _sigma;
+ var a = (Math.Log(x) - _mu) / _sigma;
return Math.Exp(-0.5 * a * a) / (x * _sigma * Constants.Sqrt2Pi);
}
@@ -272,8 +304,8 @@ namespace MathNet.Numerics.Distributions
return Double.NegativeInfinity;
}
- double a = (Math.Log(x) - _mu) / _sigma;
- return -0.5 * a * a - Math.Log(x * _sigma) - Constants.LogSqrt2Pi;
+ var a = (Math.Log(x) - _mu) / _sigma;
+ return (-0.5 * a * a) - Math.Log(x * _sigma) - Constants.LogSqrt2Pi;
}
///
@@ -297,8 +329,7 @@ namespace MathNet.Numerics.Distributions
/// a sample from the distribution.
public double Sample()
{
- double r2;
- return Math.Exp(_mu + (_sigma * Normal.SampleBoxMuller(RandomSource, out r2)));
+ return Math.Exp(_mu + (_sigma * Normal.SampleBoxMuller(RandomSource).Item1));
}
///
@@ -307,15 +338,14 @@ namespace MathNet.Numerics.Distributions
/// a sequence of samples from the distribution.
public IEnumerable Samples()
{
- double r2;
-
while (true)
{
- double r1 = Normal.SampleBoxMuller(RandomSource, out r2);
- yield return Math.Exp(_mu + (_sigma * r1));
- yield return Math.Exp(_mu + (_sigma * r2));
+ var sample = Normal.SampleBoxMuller(RandomSource);
+ yield return Math.Exp(_mu + (_sigma * sample.Item1));
+ yield return Math.Exp(_mu + (_sigma * sample.Item2));
}
}
+
#endregion
///
@@ -332,8 +362,7 @@ namespace MathNet.Numerics.Distributions
throw new ArgumentOutOfRangeException(Resources.InvalidDistributionParameters);
}
- double r2;
- return Math.Exp(mu + (sigma * Normal.SampleBoxMuller(rng, out r2)));
+ return Math.Exp(mu + (sigma * Normal.SampleBoxMuller(rng).Item1));
}
///
@@ -349,14 +378,12 @@ namespace MathNet.Numerics.Distributions
{
throw new ArgumentOutOfRangeException(Resources.InvalidDistributionParameters);
}
-
- double r2;
while (true)
{
- double r1 = Normal.SampleBoxMuller(rng, out r2);
- yield return Math.Exp(mu + (sigma * r1));
- yield return Math.Exp(mu + (sigma * r2));
+ var sample = Normal.SampleBoxMuller(rng);
+ yield return Math.Exp(mu + (sigma * sample.Item1));
+ yield return Math.Exp(mu + (sigma * sample.Item2));
}
}
}
diff --git a/src/Numerics/Distributions/Continuous/Normal.cs b/src/Numerics/Distributions/Continuous/Normal.cs
index 58dc569c..73e58ca2 100644
--- a/src/Numerics/Distributions/Continuous/Normal.cs
+++ b/src/Numerics/Distributions/Continuous/Normal.cs
@@ -3,9 +3,7 @@
// http://numerics.mathdotnet.com
// http://github.com/mathnet/mathnet-numerics
// http://mathnetnumerics.codeplex.com
-//
// Copyright (c) 2009-2010 Math.NET
-//
// Permission is hereby granted, free of charge, to any person
// obtaining a copy of this software and associated documentation
// files (the "Software"), to deal in the Software without
@@ -14,10 +12,8 @@
// copies of the Software, and to permit persons to whom the
// Software is furnished to do so, subject to the following
// conditions:
-//
// The above copyright notice and this permission notice shall be
// included in all copies or substantial portions of the Software.
-//
// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
@@ -42,7 +38,7 @@ namespace MathNet.Numerics.Distributions
/// Users can get/set the random number generator by using the The statistics classes will check all the incoming parameters whether they are in the allowed
/// range. This might involve heavy computation. Optionally, by setting Control.CheckDistributionParameters
- /// to false, all parameter checks can be turned off.
+ /// to false , all parameter checks can be turned off.
public class Normal : IContinuousDistribution
{
///
@@ -110,11 +106,11 @@ namespace MathNet.Numerics.Distributions
/// be initialized with the default
/// a normal distribution.
- public static Normal WithMeanPrecision(double mean, double prec)
+ public static Normal WithMeanPrecision(double mean, double precision)
{
- return new Normal(mean, 1.0 / Math.Sqrt(prec));
+ return new Normal(mean, 1.0 / Math.Sqrt(precision));
}
///
@@ -131,7 +127,7 @@ namespace MathNet.Numerics.Distributions
///
/// True when the parameters are valid, false otherwise.
+ /// true when the parameters are valid, false otherwise.
public double Mean
{
- get { return _mean; }
- set { SetParameters(value, _stdDev); }
+ get
+ {
+ return _mean;
+ }
+
+ set
+ {
+ SetParameters(value, _stdDev);
+ }
}
///
@@ -220,8 +223,15 @@ namespace MathNet.Numerics.Distributions
///
public double Variance
{
- get { return _stdDev * _stdDev; }
- set { SetParameters(_mean, value); }
+ get
+ {
+ return _stdDev * _stdDev;
+ }
+
+ set
+ {
+ SetParameters(_mean, value);
+ }
}
///
@@ -229,8 +239,15 @@ namespace MathNet.Numerics.Distributions
///
public double StdDev
{
- get { return _stdDev; }
- set { SetParameters(_mean, value); }
+ get
+ {
+ return _stdDev;
+ }
+
+ set
+ {
+ SetParameters(_mean, value);
+ }
}
///
@@ -238,7 +255,10 @@ namespace MathNet.Numerics.Distributions
///
public double Entropy
{
- get { return Math.Log(_stdDev) + Constants.LogSqrt2PiE; }
+ get
+ {
+ return Math.Log(_stdDev) + Constants.LogSqrt2PiE;
+ }
}
///
@@ -246,8 +266,12 @@ namespace MathNet.Numerics.Distributions
///
public double Skewness
{
- get { return 0.0; }
+ get
+ {
+ return 0.0;
+ }
}
+
#endregion
#region IContinuousDistribution implementation
@@ -257,7 +281,10 @@ namespace MathNet.Numerics.Distributions
///
public double Mode
{
- get { return _mean; }
+ get
+ {
+ return _mean;
+ }
}
///
@@ -265,7 +292,10 @@ namespace MathNet.Numerics.Distributions
///
public double Median
{
- get { return _mean; }
+ get
+ {
+ return _mean;
+ }
}
///
@@ -273,7 +303,10 @@ namespace MathNet.Numerics.Distributions
///
public double Minimum
{
- get { return Double.NegativeInfinity; }
+ get
+ {
+ return Double.NegativeInfinity;
+ }
}
///
@@ -281,7 +314,10 @@ namespace MathNet.Numerics.Distributions
///
public double Maximum
{
- get { return Double.PositiveInfinity; }
+ get
+ {
+ return Double.PositiveInfinity;
+ }
}
///
@@ -293,7 +329,7 @@ namespace MathNet.Numerics.Distributions
/// the density at
internal static double Density(double mean, double sdev, double x)
{
- double d = (x - mean) / sdev;
+ var d = (x - mean) / sdev;
return Math.Exp(-0.5 * d * d) / (Constants.Sqrt2Pi * sdev);
}
@@ -306,7 +342,7 @@ namespace MathNet.Numerics.Distributions
/// the log density at
internal static double DensityLn(double mean, double sdev, double x)
{
- double d = (x - mean) / sdev;
+ var d = (x - mean) / sdev;
return (-0.5 * d * d) - Math.Log(sdev) - Constants.LogSqrt2Pi;
}
@@ -358,8 +394,7 @@ namespace MathNet.Numerics.Distributions
/// a sample from the distribution.
public double Sample()
{
- double r2;
- return _mean + (_stdDev * SampleBoxMuller(RandomSource, out r2));
+ return _mean + (_stdDev * SampleBoxMuller(RandomSource).Item1);
}
///
@@ -368,15 +403,14 @@ namespace MathNet.Numerics.Distributions
/// a sequence of samples from the distribution.
public IEnumerable Samples()
{
- double r2;
-
while (true)
{
- double r1 = SampleBoxMuller(RandomSource, out r2);
- yield return _mean + (_stdDev * r1);
- yield return _mean + (_stdDev * r2);
+ var sample = SampleBoxMuller(RandomSource);
+ yield return _mean + (_stdDev * sample.Item1);
+ yield return _mean + (_stdDev * sample.Item2);
}
}
+
#endregion
///
@@ -403,8 +437,7 @@ namespace MathNet.Numerics.Distributions
throw new ArgumentOutOfRangeException(Resources.InvalidDistributionParameters);
}
- double r2;
- return mean + (stddev * SampleBoxMuller(rng, out r2));
+ return mean + (stddev * SampleBoxMuller(rng).Item1);
}
///
@@ -420,14 +453,12 @@ namespace MathNet.Numerics.Distributions
{
throw new ArgumentOutOfRangeException(Resources.InvalidDistributionParameters);
}
-
- double r2;
while (true)
{
- double r1 = SampleBoxMuller(rng, out r2);
- yield return mean + (stddev * r1);
- yield return mean + (stddev * r2);
+ var sample = SampleBoxMuller(rng);
+ yield return mean + (stddev * sample.Item1);
+ yield return mean + (stddev * sample.Item2);
}
}
@@ -435,13 +466,12 @@ namespace MathNet.Numerics.Distributions
/// Samples a pair of standard normal distributed random variables using the Box-Muller algorithm.
///
/// a random number from the standard normal distribution.
- internal static double SampleBoxMuller(Random rnd, out double r2)
+ /// a pair of random numbers from the standard normal distribution.
+ internal static Tuple SampleBoxMuller(Random rnd)
{
- double v1 = (2.0 * rnd.NextDouble()) - 1.0;
- double v2 = (2.0 * rnd.NextDouble()) - 1.0;
- double r = (v1 * v1) + (v2 * v2);
+ var v1 = (2.0 * rnd.NextDouble()) - 1.0;
+ var v2 = (2.0 * rnd.NextDouble()) - 1.0;
+ var r = (v1 * v1) + (v2 * v2);
while (r >= 1.0 || r == 0.0)
{
v1 = (2.0 * rnd.NextDouble()) - 1.0;
@@ -449,9 +479,8 @@ namespace MathNet.Numerics.Distributions
r = (v1 * v1) + (v2 * v2);
}
- double fac = Math.Sqrt(-2.0 * Math.Log(r) / r);
- r2 = v2 * fac;
- return v1 * fac;
+ var fac = Math.Sqrt(-2.0 * Math.Log(r) / r);
+ return new Tuple(v1 * fac, v2 * fac);
}
}
}
diff --git a/src/Numerics/Distributions/Continuous/Pareto.cs b/src/Numerics/Distributions/Continuous/Pareto.cs
new file mode 100644
index 00000000..4d8a69b6
--- /dev/null
+++ b/src/Numerics/Distributions/Continuous/Pareto.cs
@@ -0,0 +1,352 @@
+//
+// Math.NET Numerics, part of the Math.NET Project
+// http://numerics.mathdotnet.com
+// http://github.com/mathnet/mathnet-numerics
+// http://mathnetnumerics.codeplex.com
+// Copyright (c) 2009-2010 Math.NET
+// Permission is hereby granted, free of charge, to any person
+// obtaining a copy of this software and associated documentation
+// files (the "Software"), to deal in the Software without
+// restriction, including without limitation the rights to use,
+// copy, modify, merge, publish, distribute, sublicense, and/or sell
+// copies of the Software, and to permit persons to whom the
+// Software is furnished to do so, subject to the following
+// conditions:
+// The above copyright notice and this permission notice shall be
+// included in all copies or substantial portions of the Software.
+// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
+// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
+// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+// OTHER DEALINGS IN THE SOFTWARE.
+//
+
+namespace MathNet.Numerics.Distributions
+{
+ using System;
+ using System.Collections.Generic;
+ using Properties;
+
+ ///
+ /// The Pareto distribution is a power law probability distribution that coincides with social,
+ /// scientific, geophysical, actuarial, and many other types of observable phenomena.
+ /// For details about this distribution, see
+ /// Wikipedia - Pareto distribution .
+ ///
+ /// The distribution will use the
+ /// The statistics classes will check all the incoming parameters whether they are in the allowed
+ /// range. This might involve heavy computation. Optionally, by setting Control.CheckDistributionParameters
+ /// to false , all parameter checks can be turned off.
+ /// The scale parameter of the distribution.
+ ///
+ private double _scale;
+
+ ///
+ /// The shape parameter of the distribution.
+ ///
+ private double _shape;
+
+ ///
+ /// The distribution's random number generator.
+ ///
+ private Random _random;
+
+ ///
+ /// Initializes a new instance of the
+ ///
+ /// If
+ public Pareto(double scale, double shape)
+ {
+ SetParameters(scale, shape);
+ RandomSource = new Random();
+ }
+
+ ///
+ /// Sets the parameters of the distribution after checking their validity.
+ ///
+ /// When the parameters don't pass the
+ private void SetParameters(double scale, double shape)
+ {
+ if (Control.CheckDistributionParameters && !IsValidParameterSet(scale, shape))
+ {
+ throw new ArgumentOutOfRangeException(Resources.InvalidDistributionParameters);
+ }
+
+ _scale = scale;
+ _shape = shape;
+ }
+
+ ///
+ /// Checks whether the parameters of the distribution are valid.
+ ///
+ /// true when the parameters are valid, false otherwise.
+ /// Gets or sets the scale parameter of the distribution.
+ ///
+ public double Scale
+ {
+ get
+ {
+ return _scale;
+ }
+
+ set
+ {
+ SetParameters(value, _shape);
+ }
+ }
+
+ ///
+ /// Gets or sets the shape parameter of the distribution.
+ ///
+ public double Shape
+ {
+ get
+ {
+ return _shape;
+ }
+
+ set
+ {
+ SetParameters(_scale, value);
+ }
+ }
+
+ ///
+ /// A string representation of the distribution.
+ ///
+ /// a string representation of the distribution.
+ public override string ToString()
+ {
+ return "Pareto(Scale = " + _scale + ", Shape = " + _shape + ")";
+ }
+
+ #region IDistribution Members
+
+ ///
+ /// Gets or sets the random number generator which is used to draw random samples.
+ ///
+ public Random RandomSource
+ {
+ get
+ {
+ return _random;
+ }
+
+ set
+ {
+ if (value == null)
+ {
+ throw new ArgumentNullException();
+ }
+
+ _random = value;
+ }
+ }
+
+ ///
+ /// Gets the mean of the distribution.
+ ///
+ public double Mean
+ {
+ get
+ {
+ if (_shape <= 1)
+ {
+ throw new NotSupportedException();
+ }
+
+ return _shape * _scale / (_shape - 1.0);
+ }
+ }
+
+ ///
+ /// Gets the variance of the distribution.
+ ///
+ public double Variance
+ {
+ get
+ {
+ return _scale * _scale * _shape / ((_shape - 1.0) * (_shape - 1.0) * (_scale - 2.0));
+ }
+ }
+
+ ///
+ /// Gets the standard deviation of the distribution.
+ ///
+ public double StdDev
+ {
+ get
+ {
+ return (_scale * Math.Sqrt(_shape)) / (Math.Abs(_shape - 1.0) * Math.Sqrt(_shape - 2.0));
+ }
+ }
+
+ ///
+ /// Gets the entropy of the distribution.
+ ///
+ public double Entropy
+ {
+ get
+ {
+ return Math.Log(_shape / _scale) - (1.0 / _shape) - 1.0;
+ }
+ }
+
+ ///
+ /// Gets the skewness of the distribution.
+ ///
+ public double Skewness
+ {
+ get
+ {
+ return (2.0 * (_shape + 1.0) / (_shape - 3.0)) * Math.Sqrt((_shape - 2.0) / _shape);
+ }
+ }
+
+ ///
+ /// Computes the cumulative distribution function of the distribution.
+ ///
+ /// the cumulative density at
+ public double CumulativeDistribution(double x)
+ {
+ return 1.0 - Math.Pow(_scale / x, _shape);
+ }
+
+ #endregion
+
+ #region IContinuousDistribution Members
+
+ ///
+ /// Gets the mode of the distribution.
+ ///
+ public double Mode
+ {
+ get
+ {
+ return _scale;
+ }
+ }
+
+ ///
+ /// Gets the median of the distribution.
+ ///
+ public double Median
+ {
+ get
+ {
+ return _scale * Math.Pow(2.0, 1.0 / _shape);
+ }
+ }
+
+ ///
+ /// Gets the minimum of the distribution.
+ ///
+ public double Minimum
+ {
+ get
+ {
+ return _scale;
+ }
+ }
+
+ ///
+ /// Gets the maximum of the distribution.
+ ///
+ public double Maximum
+ {
+ get
+ {
+ return Double.PositiveInfinity;
+ }
+ }
+
+ ///
+ /// Computes the density of the distribution.
+ ///
+ /// the density at
+ public double Density(double x)
+ {
+ return _shape * Math.Pow(_scale, _shape) / Math.Pow(x, _shape + 1.0);
+ }
+
+ ///
+ /// Computes the log density of the distribution.
+ ///
+ /// the log density at
+ public double DensityLn(double x)
+ {
+ return Math.Log(Density(x));
+ }
+
+ ///
+ /// Draws a random sample from the distribution.
+ ///
+ /// A random number from this distribution.
+ public double Sample()
+ {
+ return DoSample(RandomSource);
+ }
+
+ ///
+ /// Generates a sequence of samples from the Pareto distribution.
+ ///
+ /// a sequence of samples from the distribution.
+ public IEnumerable Samples()
+ {
+ while (true)
+ {
+ yield return DoSample(RandomSource);
+ }
+ }
+
+ #endregion
+
+ ///
+ /// Generates a sample from the Pareto distribution without doing parameter checking.
+ ///
+ /// a random number from the Pareto distribution.
+ private double DoSample(Random rnd)
+ {
+ return _scale * Math.Pow(rnd.NextDouble(), -1.0 / _shape);
+ }
+ }
+}
diff --git a/src/Numerics/Distributions/Continuous/Rayleigh.cs b/src/Numerics/Distributions/Continuous/Rayleigh.cs
new file mode 100644
index 00000000..6713305a
--- /dev/null
+++ b/src/Numerics/Distributions/Continuous/Rayleigh.cs
@@ -0,0 +1,321 @@
+//
+// Math.NET Numerics, part of the Math.NET Project
+// http://numerics.mathdotnet.com
+// http://github.com/mathnet/mathnet-numerics
+// http://mathnetnumerics.codeplex.com
+// Copyright (c) 2009-2010 Math.NET
+// Permission is hereby granted, free of charge, to any person
+// obtaining a copy of this software and associated documentation
+// files (the "Software"), to deal in the Software without
+// restriction, including without limitation the rights to use,
+// copy, modify, merge, publish, distribute, sublicense, and/or sell
+// copies of the Software, and to permit persons to whom the
+// Software is furnished to do so, subject to the following
+// conditions:
+// The above copyright notice and this permission notice shall be
+// included in all copies or substantial portions of the Software.
+// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
+// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
+// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+// OTHER DEALINGS IN THE SOFTWARE.
+//
+
+namespace MathNet.Numerics.Distributions
+{
+ using System;
+ using System.Collections.Generic;
+ using Properties;
+
+ ///
+ /// The Rayleigh distribution (pronounced /ˈreɪli/) is a continuous probability distribution. As an
+ /// example of how it arises, the wind speed will have a Rayleigh distribution if the components of
+ /// the two-dimensional wind velocity vector are uncorrelated and normally distributed with equal variance.
+ /// For details about this distribution, see
+ /// Wikipedia - Rayleigh distribution .
+ ///
+ /// The distribution will use the
+ /// The statistics classes will check all the incoming parameters whether they are in the allowed
+ /// range. This might involve heavy computation. Optionally, by setting Control.CheckDistributionParameters
+ /// to false , all parameter checks can be turned off.
+ /// The scale parameter of the distribution.
+ ///
+ private double _scale;
+
+ ///
+ /// The distribution's random number generator.
+ ///
+ private Random _random;
+
+ ///
+ /// Initializes a new instance of the
+ ///
+ /// If
+ public Rayleigh(double scale)
+ {
+ SetParameters(scale);
+ RandomSource = new Random();
+ }
+
+ ///
+ /// Sets the parameters of the distribution after checking their validity.
+ ///
+ /// When the parameters don't pass the
+ private void SetParameters(double scale)
+ {
+ if (Control.CheckDistributionParameters && !IsValidParameterSet(scale))
+ {
+ throw new ArgumentOutOfRangeException(Resources.InvalidDistributionParameters);
+ }
+
+ _scale = scale;
+ }
+
+ ///
+ /// Checks whether the parameters of the distribution are valid.
+ ///
+ /// true when the parameters are valid, false otherwise.
+ /// Gets or sets the scale parameter of the distribution.
+ ///
+ public double Scale
+ {
+ get
+ {
+ return _scale;
+ }
+
+ set
+ {
+ SetParameters(value);
+ }
+ }
+
+ ///
+ /// A string representation of the distribution.
+ ///
+ /// a string representation of the distribution.
+ public override string ToString()
+ {
+ return "Rayleigh(Scale = " + _scale + ")";
+ }
+
+ #region IDistribution Members
+
+ ///
+ /// Gets or sets the random number generator which is used to draw random samples.
+ ///
+ public Random RandomSource
+ {
+ get
+ {
+ return _random;
+ }
+
+ set
+ {
+ if (value == null)
+ {
+ throw new ArgumentNullException();
+ }
+
+ _random = value;
+ }
+ }
+
+ ///
+ /// Gets the mean of the distribution.
+ ///
+ public double Mean
+ {
+ get
+ {
+ return _scale * Math.Sqrt(Constants.PiOver2);
+ }
+ }
+
+ ///
+ /// Gets the variance of the distribution.
+ ///
+ public double Variance
+ {
+ get
+ {
+ return (2.0 - Constants.PiOver2) * _scale * _scale;
+ }
+ }
+
+ ///
+ /// Gets the standard deviation of the distribution.
+ ///
+ public double StdDev
+ {
+ get
+ {
+ return Math.Sqrt(2.0 - Constants.PiOver2) * _scale;
+ }
+ }
+
+ ///
+ /// Gets the entropy of the distribution.
+ ///
+ public double Entropy
+ {
+ get
+ {
+ return 1.0 + Math.Log(_scale / Math.Sqrt(2)) + (Constants.EulerMascheroni / 2.0);
+ }
+ }
+
+ ///
+ /// Gets the skewness of the distribution.
+ ///
+ public double Skewness
+ {
+ get
+ {
+ return (2.0 * Math.Sqrt(Constants.Pi) * (Constants.Pi - 3.0)) / Math.Pow(4.0 - Constants.Pi, 1.5);
+ }
+ }
+
+ ///
+ /// Computes the cumulative distribution function of the distribution.
+ ///
+ /// the cumulative density at
+ public double CumulativeDistribution(double x)
+ {
+ return 1.0 - Math.Exp(-x * x / (2.0 * _scale * _scale));
+ }
+
+ #endregion
+
+ #region IContinuousDistribution Members
+
+ ///
+ /// Gets the mode of the distribution.
+ ///
+ public double Mode
+ {
+ get
+ {
+ return _scale;
+ }
+ }
+
+ ///
+ /// Gets the median of the distribution.
+ ///
+ public double Median
+ {
+ get
+ {
+ return _scale * Math.Sqrt(Math.Log(4.0));
+ }
+ }
+
+ ///
+ /// Gets the minimum of the distribution.
+ ///
+ public double Minimum
+ {
+ get
+ {
+ return 0.0;
+ }
+ }
+
+ ///
+ /// Gets the maximum of the distribution.
+ ///
+ public double Maximum
+ {
+ get
+ {
+ return Double.PositiveInfinity;
+ }
+ }
+
+ ///
+ /// Computes the density of the distribution.
+ ///
+ /// the density at
+ public double Density(double x)
+ {
+ return (x / (_scale * _scale)) * Math.Exp(-x * x / (2.0 * _scale * _scale));
+ }
+
+ ///
+ /// Computes the log density of the distribution.
+ ///
+ /// the log density at
+ public double DensityLn(double x)
+ {
+ return Math.Log(x / (_scale * _scale)) - (x * x / (2.0 * _scale * _scale));
+ }
+
+ ///
+ /// Draws a random sample from the distribution.
+ ///
+ /// A random number from this distribution.
+ public double Sample()
+ {
+ return DoSample(RandomSource);
+ }
+
+ ///
+ /// Generates a sequence of samples from the Rayleigh distribution.
+ ///
+ /// a sequence of samples from the distribution.
+ public IEnumerable Samples()
+ {
+ while (true)
+ {
+ yield return DoSample(RandomSource);
+ }
+ }
+
+ #endregion
+
+ ///
+ /// Generates a sample from the Rayleigh distribution without doing parameter checking.
+ ///
+ /// a random number from the Rayleigh distribution.
+ private double DoSample(Random rnd)
+ {
+ return _scale * Math.Sqrt(-2.0 * Math.Log(rnd.NextDouble()));
+ }
+ }
+}
diff --git a/src/Numerics/Distributions/Continuous/Stable.cs b/src/Numerics/Distributions/Continuous/Stable.cs
new file mode 100644
index 00000000..7721b11e
--- /dev/null
+++ b/src/Numerics/Distributions/Continuous/Stable.cs
@@ -0,0 +1,498 @@
+//
+// Math.NET Numerics, part of the Math.NET Project
+// http://numerics.mathdotnet.com
+// http://github.com/mathnet/mathnet-numerics
+// http://mathnetnumerics.codeplex.com
+// Copyright (c) 2009-2010 Math.NET
+// Permission is hereby granted, free of charge, to any person
+// obtaining a copy of this software and associated documentation
+// files (the "Software"), to deal in the Software without
+// restriction, including without limitation the rights to use,
+// copy, modify, merge, publish, distribute, sublicense, and/or sell
+// copies of the Software, and to permit persons to whom the
+// Software is furnished to do so, subject to the following
+// conditions:
+// The above copyright notice and this permission notice shall be
+// included in all copies or substantial portions of the Software.
+// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
+// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
+// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+// OTHER DEALINGS IN THE SOFTWARE.
+//
+
+namespace MathNet.Numerics.Distributions
+{
+ using System;
+ using System.Collections.Generic;
+ using Properties;
+
+ ///
+ /// A random variable is said to be stable (or to have a stable distribution) if it has
+ /// the property that a linear combination of two independent copies of the variable has
+ /// the same distribution, up to location and scale parameters.
+ /// For details about this distribution, see
+ /// Wikipedia - Stable distribution .
+ ///
+ /// The distribution will use the
+ /// The statistics classes will check all the incoming parameters whether they are in the allowed
+ /// range. This might involve heavy computation. Optionally, by setting Control.CheckDistributionParameters
+ /// to false , all parameter checks can be turned off.
+ /// The stability parameter of the distribution.
+ ///
+ private double _alpha;
+
+ ///
+ /// The skewness parameter of the distribution.
+ ///
+ private double _beta;
+
+ ///
+ /// The scale parameter of the distribution.
+ ///
+ private double _scale;
+
+ ///
+ /// The location parameter of the distribution.
+ ///
+ private double _location;
+
+ ///
+ /// The distribution's random number generator.
+ ///
+ private Random _random;
+
+ ///
+ /// Initializes a new instance of the
+ ///
+ /// Sets the parameters of the distribution after checking their validity.
+ ///
+ ///
+ /// Checks whether the parameters of the distribution are valid.
+ ///
+ /// true when the parameters are valid, false otherwise.
+ /// Gets or sets the stability parameter of the distribution.
+ ///
+ public double Alpha
+ {
+ get
+ {
+ return _alpha;
+ }
+
+ set
+ {
+ SetParameters(value, _beta, _scale, _location);
+ }
+ }
+
+ ///
+ /// Gets or sets The skewness parameter of the distribution.
+ ///
+ public double Beta
+ {
+ get
+ {
+ return _beta;
+ }
+
+ set
+ {
+ SetParameters(_alpha, value, _scale, _location);
+ }
+ }
+
+ ///
+ /// Gets or sets the scale parameter of the distribution.
+ ///
+ public double Scale
+ {
+ get
+ {
+ return _scale;
+ }
+
+ set
+ {
+ SetParameters(_alpha, _beta, value, _location);
+ }
+ }
+
+ ///
+ /// Gets or sets the location parameter of the distribution.
+ ///
+ public double Location
+ {
+ get
+ {
+ return _location;
+ }
+
+ set
+ {
+ SetParameters(_alpha, _beta, _scale, value);
+ }
+ }
+
+ ///
+ /// A string representation of the distribution.
+ ///
+ /// a string representation of the distribution.
+ public override string ToString()
+ {
+ return "Stable(" + "Stability = " + _alpha + ", Skewness = " + _beta + ", Scale = " + _scale + ", Location = " + _location + ")";
+ }
+
+ #region IDistribution Members
+
+ ///
+ /// Gets or sets the random number generator which is used to draw random samples.
+ ///
+ public Random RandomSource
+ {
+ get
+ {
+ return _random;
+ }
+
+ set
+ {
+ if (value == null)
+ {
+ throw new ArgumentNullException();
+ }
+
+ _random = value;
+ }
+ }
+
+ ///
+ /// Gets the mean of the distribution.
+ ///
+ public double Mean
+ {
+ get
+ {
+ if (_alpha <= 1)
+ {
+ throw new NotSupportedException();
+ }
+
+ return _location;
+ }
+ }
+
+ ///
+ /// Gets the variance of the distribution.
+ ///
+ public double Variance
+ {
+ get
+ {
+ if (_alpha == 2)
+ {
+ return 2.0 * _scale * _scale;
+ }
+
+ return Double.PositiveInfinity;
+ }
+ }
+
+ ///
+ /// Gets the standard deviation of the distribution.
+ ///
+ public double StdDev
+ {
+ get
+ {
+ if (_alpha == 2)
+ {
+ return Math.Sqrt(2.0) * _scale;
+ }
+
+ return Double.PositiveInfinity;
+ }
+ }
+
+ ///
+ /// Gets he entropy of the distribution.
+ ///
+ /// Always throws a not supported exception.
+ public double Entropy
+ {
+ get
+ {
+ throw new NotSupportedException();
+ }
+ }
+
+ ///
+ /// Gets the skewness of the distribution.
+ ///
+ /// Throws a not supported exception of Alpha != 2.
+ public double Skewness
+ {
+ get
+ {
+ if (_alpha != 2)
+ {
+ throw new NotSupportedException();
+ }
+
+ return 0.0;
+ }
+ }
+
+ ///
+ /// Computes the cumulative distribution function of the distribution.
+ ///
+ /// the cumulative density at
+ /// Throws a not supported exception if Alpha != 2 , (Alpha != 1 and Beta !=0) , or (Alpha != 0.5 and Beta != 1)
+ public double CumulativeDistribution(double x)
+ {
+ if (_alpha == 2)
+ {
+ return (new Normal(_location, StdDev)).CumulativeDistribution(x);
+ }
+
+ if (_alpha == 1 && _beta == 0)
+ {
+ return (new Cauchy(_location, _scale)).CumulativeDistribution(x);
+ }
+
+ if (_alpha == 0.5 && _beta == 1)
+ {
+ return LevyCumulativeDistribution(_scale, _location, x);
+ }
+
+ throw new NotSupportedException();
+ }
+
+ ///
+ /// Computes the cumulative distribution function of the Levy distribution.
+ ///
+ ///
+ /// the cumulative density at
+ private static double LevyCumulativeDistribution(double scale, double location, double x)
+ {
+ // The parameters scale and location must be correct
+ return SpecialFunctions.Erfc(Math.Sqrt(scale / (2 * (x - location))));
+ }
+
+ #endregion
+
+ #region IContinuousDistribution Members
+
+ ///
+ /// Gets the mode of the distribution.
+ ///
+ /// Throws a not supported exception if Beta != 0 .
+ public double Mode
+ {
+ get
+ {
+ if (_beta != 0)
+ {
+ throw new NotSupportedException();
+ }
+
+ return _location;
+ }
+ }
+
+ ///
+ /// Gets the median of the distribution.
+ ///
+ /// Throws a not supported exception if Beta != 0 .
+ public double Median
+ {
+ get
+ {
+ if (_beta != 0)
+ {
+ throw new NotSupportedException();
+ }
+
+ return _location;
+ }
+ }
+
+ ///
+ /// Gets the minimum of the distribution.
+ ///
+ public double Minimum
+ {
+ get
+ {
+ if (Math.Abs(_beta) == 1)
+ {
+ return 0.0;
+ }
+
+ return Double.NegativeInfinity;
+ }
+ }
+
+ ///
+ /// Gets the maximum of the distribution.
+ ///
+ public double Maximum
+ {
+ get
+ {
+ return Double.PositiveInfinity;
+ }
+ }
+
+ ///
+ /// Computes the density of the distribution.
+ ///
+ /// the density at
+ public double Density(double x)
+ {
+ if (_alpha == 2)
+ {
+ return (new Normal(_location, StdDev)).Density(x);
+ }
+
+ if (_alpha == 1 && _beta == 0)
+ {
+ return (new Cauchy(_location, _scale)).Density(x);
+ }
+
+ if (_alpha == 0.5 && _beta == 1)
+ {
+ return LevyDensity(_scale, _location, x);
+ }
+
+ throw new NotSupportedException();
+ }
+
+ ///
+ /// Computes the density of the Levy distribution.
+ ///
+ /// the density at
+ private static double LevyDensity(double scale, double location, double x)
+ {
+ // The parameters scale and location must be correct
+ if (x < location)
+ {
+ throw new NotSupportedException();
+ }
+
+ return (Math.Sqrt(scale / Constants.Pi2) * Math.Exp(-scale / (2 * (x - location)))) / Math.Pow(x - location, 1.5);
+ }
+
+ ///
+ /// Computes the log density of the distribution.
+ ///
+ /// the log density at
+ public double DensityLn(double x)
+ {
+ return Math.Log(Density(x));
+ }
+
+ ///
+ /// Draws a random sample from the distribution.
+ ///
+ /// A random number from this distribution.
+ public double Sample()
+ {
+ throw new NotImplementedException();
+ }
+
+ ///
+ /// Generates a sequence of samples from the Stable distribution.
+ ///
+ /// a sequence of samples from the distribution.
+ public IEnumerable Samples()
+ {
+ throw new NotImplementedException();
+ }
+
+ #endregion
+ }
+}
diff --git a/src/Numerics/Distributions/Continuous/StudentT.cs b/src/Numerics/Distributions/Continuous/StudentT.cs
index e9f53f7d..072050a1 100644
--- a/src/Numerics/Distributions/Continuous/StudentT.cs
+++ b/src/Numerics/Distributions/Continuous/StudentT.cs
@@ -3,9 +3,7 @@
// http://numerics.mathdotnet.com
// http://github.com/mathnet/mathnet-numerics
// http://mathnetnumerics.codeplex.com
-//
// Copyright (c) 2009-2010 Math.NET
-//
// Permission is hereby granted, free of charge, to any person
// obtaining a copy of this software and associated documentation
// files (the "Software"), to deal in the Software without
@@ -14,10 +12,8 @@
// copies of the Software, and to permit persons to whom the
// Software is furnished to do so, subject to the following
// conditions:
-//
// The above copyright notice and this permission notice shall be
// included in all copies or substantial portions of the Software.
-//
// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
@@ -35,19 +31,25 @@ namespace MathNet.Numerics.Distributions
using Properties;
///
- /// Implements the univariate Student t-distribution. For details about this distribution, see
- /// Wikipedia - Student's t-distribution .
+ /// Implements the univariate Student t-distribution. For details about this
+ /// distribution, see
+ ///
+ /// Wikipedia - Student's t-distribution .
///
- /// We use a slightly generalized version (compared to Wikipedia) of the Student t-distribution.
- /// Namely, one which also parameterizes the location and scale. See the book "Bayesian Data Analysis" by Gelman
- /// et al. for more details.
- /// The density of the Student t-distribution
- /// p(x|mu,scale,dof) = Gamma((dof+1)/2) (1 + (x - mu)^2 / (scale * scale * dof))^(-(dof+1)/2) / (Gamma(dof/2)*Sqrt(dof*pi*scale)).
- /// The distribution will use the
- /// The statistics classes will check all the incoming parameters whether they are in the allowed
- /// range. This might involve heavy computation. Optionally, by setting Control.CheckDistributionParameters
- /// to false, all parameter checks can be turned off. We use a slightly generalized version (compared to
+ /// Wikipedia) of the Student t-distribution. Namely, one which also
+ /// parameterizes the location and scale. See the book "Bayesian Data
+ /// Analysis" by Gelman et al. for more details.
+ /// The density of the Student t-distribution p(x|mu,scale,dof) =
+ /// Gamma((dof+1)/2) (1 + (x - mu)^2 / (scale * scale * dof))^(-(dof+1)/2) /
+ /// (Gamma(dof/2)*Sqrt(dof*pi*scale)).
+ /// The distribution will use the
+ /// The statistics classes will check all the incoming parameters
+ /// whether they are in the allowed range. This might involve heavy
+ /// computation. Optionally, by setting Control.CheckDistributionParameters
+ /// to false , all parameter checks can be turned off.
@@ -108,7 +110,7 @@ namespace MathNet.Numerics.Distributions
/// True when the parameters are valid, false otherwise.
+ /// true when the parameters are valid, false otherwise.
- /// Gets or sets the mean of the Student t-distribution.
+ /// Gets the mean of the Student t-distribution.
///
public double Mean
{
get
{
- if (_dof > 1.0)
- {
- return _location;
- }
- else
- {
- return Double.NaN;
- }
+ return _dof > 1.0 ? _location : Double.NaN;
}
}
///
- /// Gets or sets the variance of the Student t-distribution.
+ /// Gets the variance of the Student t-distribution.
///
public double Variance
{
@@ -238,23 +233,18 @@ namespace MathNet.Numerics.Distributions
{
return _scale * _scale;
}
- else if (_dof > 2.0)
+
+ if (_dof > 2.0)
{
return _dof * _scale * _scale / (_dof - 2.0);
}
- else if (_dof > 1.0)
- {
- return Double.PositiveInfinity;
- }
- else
- {
- return Double.NaN;
- }
+
+ return _dof > 1.0 ? Double.PositiveInfinity : Double.NaN;
}
}
///
- /// Gets or sets the standard deviation of the Student t-distribution.
+ /// Gets the standard deviation of the Student t-distribution.
///
public double StdDev
{
@@ -264,18 +254,13 @@ namespace MathNet.Numerics.Distributions
{
return Math.Sqrt(_scale * _scale);
}
- else if (_dof > 2.0)
+
+ if (_dof > 2.0)
{
return Math.Sqrt(_dof * _scale * _scale / (_dof - 2.0));
}
- else if (_dof > 1.0)
- {
- return Double.PositiveInfinity;
- }
- else
- {
- return Double.NaN;
- }
+
+ return _dof > 1.0 ? Double.PositiveInfinity : Double.NaN;
}
}
@@ -284,7 +269,15 @@ namespace MathNet.Numerics.Distributions
///
public double Entropy
{
- get { throw new NotImplementedException(); }
+ get
+ {
+ if (_location != 0 || _scale != 1.0)
+ {
+ throw new NotSupportedException();
+ }
+
+ return (((_dof + 1.0) / 2.0) * (SpecialFunctions.DiGamma((1.0 + _dof) / 2.0) - SpecialFunctions.DiGamma(_dof / 2.0))) + Math.Log(Math.Sqrt(_dof) * SpecialFunctions.Beta(_dof / 2.0, 1.0 / 2.0));
+ }
}
///
@@ -292,8 +285,17 @@ namespace MathNet.Numerics.Distributions
///
public double Skewness
{
- get { throw new NotImplementedException(); }
+ get
+ {
+ if (_dof <= 3)
+ {
+ throw new NotSupportedException();
+ }
+
+ return 0.0;
+ }
}
+
#endregion
#region IContinuousDistribution implementation
@@ -303,7 +305,10 @@ namespace MathNet.Numerics.Distributions
///
public double Mode
{
- get { return _location; }
+ get
+ {
+ return _location;
+ }
}
///
@@ -311,7 +316,10 @@ namespace MathNet.Numerics.Distributions
///
public double Median
{
- get { return _location; }
+ get
+ {
+ return _location;
+ }
}
///
@@ -319,7 +327,10 @@ namespace MathNet.Numerics.Distributions
///
public double Minimum
{
- get { return Double.NegativeInfinity; }
+ get
+ {
+ return Double.NegativeInfinity;
+ }
}
///
@@ -327,7 +338,10 @@ namespace MathNet.Numerics.Distributions
///
public double Maximum
{
- get { return Double.PositiveInfinity; }
+ get
+ {
+ return Double.PositiveInfinity;
+ }
}
///
@@ -342,15 +356,13 @@ namespace MathNet.Numerics.Distributions
{
return Normal.Density(_location, _scale, x);
}
- else
- {
- double d = (x - _location) / _scale;
- return SpecialFunctions.Gamma((_dof + 1.0) / 2.0)
- * Math.Pow(1.0 + d * d / _dof, -0.5 * (_dof + 1.0))
- / SpecialFunctions.Gamma(_dof / 2.0)
- / Math.Sqrt(_dof * Math.PI)
- / _scale;
- }
+
+ var d = (x - _location) / _scale;
+ return SpecialFunctions.Gamma((_dof + 1.0) / 2.0)
+ * Math.Pow(1.0 + (d * d / _dof), -0.5 * (_dof + 1.0))
+ / SpecialFunctions.Gamma(_dof / 2.0)
+ / Math.Sqrt(_dof * Math.PI)
+ / _scale;
}
///
@@ -365,15 +377,12 @@ namespace MathNet.Numerics.Distributions
{
return Normal.DensityLn(_location, _scale, x);
}
- else
- {
- double d = (x - _location) / _scale;
- return SpecialFunctions.GammaLn((_dof + 1.0) / 2.0)
- - 0.5 * (_dof + 1.0) * Math.Log(1.0 + d * d / _dof)
- - SpecialFunctions.GammaLn(_dof / 2.0)
- - 0.5 * Math.Log(_dof * Math.PI)
- - Math.Log(_scale);
- }
+
+ var d = (x - _location) / _scale;
+ return SpecialFunctions.GammaLn((_dof + 1.0) / 2.0)
+ - (0.5 * ((_dof + 1.0) * Math.Log(1.0 + (d * d / _dof))))
+ - SpecialFunctions.GammaLn(_dof / 2.0)
+ - (0.5 * Math.Log(_dof * Math.PI)) - Math.Log(_scale);
}
///
@@ -388,20 +397,11 @@ namespace MathNet.Numerics.Distributions
{
return Normal.CumulativeDistribution(_location, _scale, x);
}
- else
- {
- double k = (x - _location) / _scale;
- double h = _dof / (_dof + k * k);
- double ib = 0.5 * SpecialFunctions.BetaRegularized(_dof / 2.0, 0.5, h);
- if (x <= _location)
- {
- return ib;
- }
- else
- {
- return 1.0 - ib;
- }
- }
+
+ var k = (x - _location) / _scale;
+ var h = _dof / (_dof + (k * k));
+ var ib = 0.5 * SpecialFunctions.BetaRegularized(_dof / 2.0, 0.5, h);
+ return x <= _location ? ib : 1.0 - ib;
}
///
@@ -410,7 +410,7 @@ namespace MathNet.Numerics.Distributions
/// a sample from the distribution.
public double Sample()
{
- return _location + _scale * Sample(RandomSource, _dof);
+ return _location + (_scale * Sample(RandomSource, _dof));
}
///
@@ -421,9 +421,10 @@ namespace MathNet.Numerics.Distributions
{
while (true)
{
- yield return _location + _scale * Sample(RandomSource, _dof);
+ yield return _location + (_scale * Sample(RandomSource, _dof));
}
}
+
#endregion
///
@@ -441,7 +442,7 @@ namespace MathNet.Numerics.Distributions
throw new ArgumentOutOfRangeException(Resources.InvalidDistributionParameters);
}
- return location + scale * Sample(rng, dof);
+ return location + (scale * Sample(rng, dof));
}
///
@@ -461,7 +462,7 @@ namespace MathNet.Numerics.Distributions
while (true)
{
- yield return location + scale * Sample(rng, dof);
+ yield return location + (scale * Sample(rng, dof));
}
}
@@ -475,10 +476,8 @@ namespace MathNet.Numerics.Distributions
/// a random number from the standard student-t distribution.
internal static double Sample(Random rnd, double dof)
{
- double dummy = 0.0;
- var n = Normal.SampleBoxMuller(rnd, out dummy);
+ var n = Normal.SampleBoxMuller(rnd).Item1;
var g = Gamma.Sample(rnd, 0.5 * dof, 0.5);
-
return Math.Sqrt(dof / g) * n;
}
}
diff --git a/src/Numerics/Distributions/Continuous/Weibull.cs b/src/Numerics/Distributions/Continuous/Weibull.cs
index 32d3502f..695be956 100644
--- a/src/Numerics/Distributions/Continuous/Weibull.cs
+++ b/src/Numerics/Distributions/Continuous/Weibull.cs
@@ -44,7 +44,7 @@ namespace MathNet.Numerics.Distributions
/// Users can get/set the random number generator by using the The statistics classes will check all the incoming parameters whether they are in the allowed
/// range. This might involve heavy computation. Optionally, by setting Control.CheckDistributionParameters
- /// to false, all parameter checks can be turned off.
+ /// to false , all parameter checks can be turned off.
public class Weibull : IContinuousDistribution
{
///
@@ -96,7 +96,7 @@ namespace MathNet.Numerics.Distributions
///
/// True when the parameters positive valid floating point numbers, false otherwise.
+ /// true when the parameters positive valid floating point numbers, false otherwise.
/// Gets the entropy of the Weibull distribution.
///
+ /// Throws a not supported exception.
public double Entropy
{
get
{
- throw new NotImplementedException();
+ throw new NotSupportedException();
}
}
@@ -232,12 +232,11 @@ namespace MathNet.Numerics.Distributions
{
get
{
- double mu = this.Mean;
- double sigma = this.StdDev;
+ double mu = Mean;
+ double sigma = StdDev;
double sigma2 = sigma * sigma;
double sigma3 = sigma2 * sigma;
- return (_scale * _scale * _scale * SpecialFunctions.Gamma(1.0 + 3.0 / _shape)
- - 3.0 * sigma2 * mu - mu * mu * mu) / sigma3;
+ return ((_scale * _scale * _scale * SpecialFunctions.Gamma(1.0 + (3.0 / _shape))) - (3.0 * sigma2 * mu) - (mu * mu * mu)) / sigma3;
}
}
#endregion
@@ -321,7 +320,7 @@ namespace MathNet.Numerics.Distributions
return Math.Log(_shape) - Math.Log(_scale);
}
- return Math.Log(_shape) + (_shape - 1.0) * Math.Log(x / _scale) - (Math.Pow(x, _shape) * _scalePowShapeInv) - Math.Log(_scale);
+ return Math.Log(_shape) + ((_shape - 1.0) * Math.Log(x / _scale)) - (Math.Pow(x, _shape) * _scalePowShapeInv) - Math.Log(_scale);
}
return double.NegativeInfinity;
@@ -410,9 +409,9 @@ namespace MathNet.Numerics.Distributions
/// A sample from a Weibull distributed random variable.
- internal static double SampleWeibull(System.Random rnd, double shape, double scale)
+ internal static double SampleWeibull(Random rnd, double shape, double scale)
{
- double x = rnd.NextDouble();
+ var x = rnd.NextDouble();
return scale * Math.Pow(-Math.Log(x), 1.0 / shape);
}
}
diff --git a/src/Numerics/Distributions/Discrete/Bernoulli.cs b/src/Numerics/Distributions/Discrete/Bernoulli.cs
index 51843064..5862049d 100644
--- a/src/Numerics/Distributions/Discrete/Bernoulli.cs
+++ b/src/Numerics/Distributions/Discrete/Bernoulli.cs
@@ -3,9 +3,7 @@
// http://numerics.mathdotnet.com
// http://github.com/mathnet/mathnet-numerics
// http://mathnetnumerics.codeplex.com
-//
// Copyright (c) 2009-2010 Math.NET
-//
// Permission is hereby granted, free of charge, to any person
// obtaining a copy of this software and associated documentation
// files (the "Software"), to deal in the Software without
@@ -14,10 +12,8 @@
// copies of the Software, and to permit persons to whom the
// Software is furnished to do so, subject to the following
// conditions:
-//
// The above copyright notice and this permission notice shall be
// included in all copies or substantial portions of the Software.
-//
// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
@@ -42,7 +38,7 @@ namespace MathNet.Numerics.Distributions
/// Users can set the random number generator by using the The statistics classes will check all the incoming parameters whether they are in the allowed
/// range. This might involve heavy computation. Optionally, by setting Control.CheckDistributionParameters
- /// to false, all parameter checks can be turned off.
+ /// to false , all parameter checks can be turned off.
public class Bernoulli : IDiscreteDistribution
{
///
@@ -63,12 +59,13 @@ namespace MathNet.Numerics.Distributions
public Bernoulli(double p)
{
SetParameters(p);
- RandomSource = new System.Random();
+ RandomSource = new Random();
}
///
/// A string representation of the distribution.
///
+ /// a string representation of the distribution.
public override string ToString()
{
return "Bernoulli(P = " + _p + ")";
@@ -78,7 +75,7 @@ namespace MathNet.Numerics.Distributions
/// Checks whether the parameters of the distribution are valid.
///
/// True when the parameters are valid, false otherwise.
+ /// true when the parameters are valid, false otherwise.
public double Mean
{
- get { return _p; }
+ get
+ {
+ return _p;
+ }
}
///
@@ -156,7 +156,10 @@ namespace MathNet.Numerics.Distributions
///
public double StdDev
{
- get { return Math.Sqrt(_p * (1.0 - _p)); }
+ get
+ {
+ return Math.Sqrt(_p * (1.0 - _p));
+ }
}
///
@@ -164,7 +167,10 @@ namespace MathNet.Numerics.Distributions
///
public double Variance
{
- get { return _p * (1.0 - _p); }
+ get
+ {
+ return _p * (1.0 - _p);
+ }
}
///
@@ -172,7 +178,10 @@ namespace MathNet.Numerics.Distributions
///
public double Entropy
{
- get { return -_p * Math.Log(_p) - (1.0 - _p) * Math.Log(1.0 - _p); }
+ get
+ {
+ return -(_p * Math.Log(_p)) - ((1.0 - _p) * Math.Log(1.0 - _p));
+ }
}
///
@@ -180,18 +189,33 @@ namespace MathNet.Numerics.Distributions
///
public double Skewness
{
- get { return (1.0 - 2.0 * _p) / Math.Sqrt(_p * (1.0 - _p)); }
+ get
+ {
+ return (1.0 - (2.0 * _p)) / Math.Sqrt(_p * (1.0 - _p));
+ }
}
///
/// Gets the smallest element in the domain of the distributions which can be represented by an integer.
///
- public int Minimum { get { return 0; } }
+ public int Minimum
+ {
+ get
+ {
+ return 0;
+ }
+ }
///
/// Gets the largest element in the domain of the distributions which can be represented by an integer.
///
- public int Maximum { get { return 1; } }
+ public int Maximum
+ {
+ get
+ {
+ return 1;
+ }
+ }
///
/// Computes the cumulative distribution function of the Bernoulli distribution.
@@ -204,7 +228,8 @@ namespace MathNet.Numerics.Distributions
{
return 0.0;
}
- else if (x < 1.0)
+
+ if (x < 1.0)
{
return 1.0 - _p;
}
@@ -217,32 +242,40 @@ namespace MathNet.Numerics.Distributions
#region IDiscreteDistribution Members
///
- /// The mode of the distribution.
+ /// Gets the mode of the distribution.
///
public int Mode
{
- get { return _p > 0.5 ? 1 : 0; }
+ get
+ {
+ return _p > 0.5 ? 1 : 0;
+ }
}
///
- /// The median of the distribution.
+ /// Gets the median of the distribution.
///
public int Median
{
- get { throw new Exception("The median of the Bernoulli distribution is undefined."); }
+ get
+ {
+ throw new Exception("The median of the Bernoulli distribution is undefined.");
+ }
}
///
- /// Computes the probability of a specific value.
+ /// Computes values of the probability mass function.
///
- public double Probability(int val)
+ /// the probability mass at location
+ public double Probability(int k)
{
- if (val == 0)
+ if (k == 0)
{
return 1.0 - _p;
}
- if (val == 1)
+ if (k == 1)
{
return _p;
}
@@ -251,21 +284,18 @@ namespace MathNet.Numerics.Distributions
}
///
- /// Computes the probability of a specific value.
+ /// Computes values of the log probability mass function.
///
- public double ProbabilityLn(int val)
+ /// the log probability mass at location
+ public double ProbabilityLn(int k)
{
- if (val == 0)
+ if (k == 0)
{
return Math.Log(1.0 - _p);
}
- if (val == 1)
- {
- return Math.Log(_p);
- }
-
- return Double.NegativeInfinity;
+ return k == 1 ? Math.Log(_p) : Double.NegativeInfinity;
}
///
@@ -297,7 +327,7 @@ namespace MathNet.Numerics.Distributions
/// A sample from the Bernoulli distribution.
- public static int Sample(System.Random rnd, double p)
+ public static int Sample(Random rnd, double p)
{
if (Control.CheckDistributionParameters && !IsValidParameterSet(p))
{
@@ -313,7 +343,7 @@ namespace MathNet.Numerics.Distributions
/// a sequence of samples from the distribution.
- public static IEnumerable Samples(System.Random rnd, double p)
+ public static IEnumerable Samples(Random rnd, double p)
{
if (Control.CheckDistributionParameters && !IsValidParameterSet(p))
{
@@ -332,7 +362,7 @@ namespace MathNet.Numerics.Distributions
/// A random sample from the Bernoulli distribution.
- private static int DoSample(System.Random rnd, double p)
+ private static int DoSample(Random rnd, double p)
{
if (rnd.NextDouble() < p)
{
@@ -342,4 +372,4 @@ namespace MathNet.Numerics.Distributions
return 0;
}
}
-}
\ No newline at end of file
+}
diff --git a/src/Numerics/Distributions/Discrete/Binomial.cs b/src/Numerics/Distributions/Discrete/Binomial.cs
index 0da04e97..ce31e666 100644
--- a/src/Numerics/Distributions/Discrete/Binomial.cs
+++ b/src/Numerics/Distributions/Discrete/Binomial.cs
@@ -3,9 +3,7 @@
// http://numerics.mathdotnet.com
// http://github.com/mathnet/mathnet-numerics
// http://mathnetnumerics.codeplex.com
-//
// Copyright (c) 2009-2010 Math.NET
-//
// Permission is hereby granted, free of charge, to any person
// obtaining a copy of this software and associated documentation
// files (the "Software"), to deal in the Software without
@@ -14,10 +12,8 @@
// copies of the Software, and to permit persons to whom the
// Software is furnished to do so, subject to the following
// conditions:
-//
// The above copyright notice and this permission notice shall be
// included in all copies or substantial portions of the Software.
-//
// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
@@ -34,7 +30,6 @@ namespace MathNet.Numerics.Distributions
using System.Collections.Generic;
using Properties;
-
///
/// Implements the binomial distribution. For details about this distribution, see
/// Wikipedia - Binomial distribution .
@@ -44,7 +39,7 @@ namespace MathNet.Numerics.Distributions
/// Users can set the random number generator by using the The statistics classes will check all the incoming parameters whether they are in the allowed
/// range. This might involve heavy computation. Optionally, by setting Control.CheckDistributionParameters
- /// to false, all parameter checks can be turned off.
+ /// to false , all parameter checks can be turned off.
public class Binomial : IDiscreteDistribution
{
///
@@ -72,12 +67,13 @@ namespace MathNet.Numerics.Distributions
public Binomial(double p, int n)
{
SetParameters(p, n);
- RandomSource = new System.Random();
+ RandomSource = new Random();
}
///
/// A string representation of the distribution.
///
+ /// a string representation of the distribution.
public override string ToString()
{
return "Binomial(Success Probability = " + _p + ", Number of Trials = " + _n + ")";
@@ -88,15 +84,15 @@ namespace MathNet.Numerics.Distributions
///
/// false
+ /// false true otherwise.
public double Mean
{
- get { return _p * _n; }
+ get
+ {
+ return _p * _n;
+ }
}
///
@@ -190,7 +189,10 @@ namespace MathNet.Numerics.Distributions
///
public double StdDev
{
- get { return Math.Sqrt(_p * (1.0 - _p) * _n); }
+ get
+ {
+ return Math.Sqrt(_p * (1.0 - _p) * _n);
+ }
}
///
@@ -198,7 +200,10 @@ namespace MathNet.Numerics.Distributions
///
public double Variance
{
- get { return _p * (1.0 - _p) * _n; }
+ get
+ {
+ return _p * (1.0 - _p) * _n;
+ }
}
///
@@ -213,13 +218,14 @@ namespace MathNet.Numerics.Distributions
return 0.0;
}
- double E = 0.0;
- for(int i = 0; i <= _n; i++)
+ var e = 0.0;
+ for (var i = 0; i <= _n; i++)
{
- double p = Probability(i);
- E -= p * Math.Log(p);
+ var p = Probability(i);
+ e -= p * Math.Log(p);
}
- return E;
+
+ return e;
}
}
@@ -228,18 +234,33 @@ namespace MathNet.Numerics.Distributions
///
public double Skewness
{
- get { return (1.0 - 2.0 * _p) / Math.Sqrt(_n * _p * (1.0 - _p)); }
+ get
+ {
+ return (1.0 - (2.0 * _p)) / Math.Sqrt(_n * _p * (1.0 - _p));
+ }
}
///
/// Gets the smallest element in the domain of the distributions which can be represented by an integer.
///
- public int Minimum { get { return 0; } }
+ public int Minimum
+ {
+ get
+ {
+ return 0;
+ }
+ }
///
/// Gets the largest element in the domain of the distributions which can be represented by an integer.
///
- public int Maximum { get { return _n; } }
+ public int Maximum
+ {
+ get
+ {
+ return _n;
+ }
+ }
///
/// Computes the cumulative distribution function of the Binomial distribution.
@@ -252,13 +273,14 @@ namespace MathNet.Numerics.Distributions
{
return 0.0;
}
- else if (x > _n)
+
+ if (x > _n)
{
return 1.0;
}
- double cdf = 0.0;
- for (int i = 0; i <= (int) Math.Floor(x); i++)
+ var cdf = 0.0;
+ for (var i = 0; i <= (int)Math.Floor(x); i++)
{
cdf += Combinatorics.Combinations(_n, i) * Math.Pow(_p, i) * Math.Pow(1.0 - _p, _n - i);
}
@@ -271,7 +293,7 @@ namespace MathNet.Numerics.Distributions
#region IDiscreteDistribution Members
///
- /// The mode of the distribution.
+ /// Gets the mode of the distribution.
///
public int Mode
{
@@ -281,99 +303,111 @@ namespace MathNet.Numerics.Distributions
{
return _n;
}
- else if (_p == 0.0)
+
+ if (_p == 0.0)
{
return 0;
}
- return (int) Math.Floor((_n + 1) * _p);
+ return (int)Math.Floor((_n + 1) * _p);
}
}
///
- /// The median of the distribution.
+ /// Gets the median of the distribution.
///
public int Median
{
- get { throw new NotImplementedException(); }
+ get
+ {
+ throw new NotImplementedException();
+ }
}
///
- /// Computes the probability of a specific value.
+ /// Computes values of the probability mass function.
///
- public double Probability(int val)
+ /// the probability mass at location
+ public double Probability(int k)
{
- if (val < 0)
+ if (k < 0)
{
return 0.0;
}
- if (val > _n)
+ if (k > _n)
{
return 0.0;
}
- if (_p == 0.0 && val == 0)
+ if (_p == 0.0 && k == 0)
{
return 1.0;
}
- else if (_p == 0.0)
+
+ if (_p == 0.0)
{
return 0.0;
}
- if (_p == 1.0 && val == _n)
+ if (_p == 1.0 && k == _n)
{
return 1.0;
}
- else if (_p == 1.0)
+
+ if (_p == 1.0)
{
return 0.0;
}
- return SpecialFunctions.Binomial(_n, val) * Math.Pow(_p, val) * Math.Pow(1.0 - _p, _n - val);
+ return SpecialFunctions.Binomial(_n, k) * Math.Pow(_p, k) * Math.Pow(1.0 - _p, _n - k);
}
///
- /// Computes the log probability of a specific value.
+ /// Computes values of the log probability mass function.
///
- public double ProbabilityLn(int val)
+ /// the log probability mass at location
+ public double ProbabilityLn(int k)
{
- if (val < 0)
+ if (k < 0)
{
return Double.NegativeInfinity;
}
- if (val > _n)
+ if (k > _n)
{
return Double.NegativeInfinity;
}
- if (_p == 0.0 && val == 0)
+ if (_p == 0.0 && k == 0)
{
return 0.0;
}
- else if (_p == 0.0)
+
+ if (_p == 0.0)
{
return Double.NegativeInfinity;
}
- if (_p == 1.0 && val == _n)
+ if (_p == 1.0 && k == _n)
{
return 0.0;
}
- else if (_p == 1.0)
+
+ if (_p == 1.0)
{
return Double.NegativeInfinity;
}
- return SpecialFunctions.BinomialLn(_n, val) + val * Math.Log(_p) + (_n - val) * Math.Log(1.0 - _p);
+ return SpecialFunctions.BinomialLn(_n, k) + (k * Math.Log(_p)) + ((_n - k) * Math.Log(1.0 - _p));
}
///
/// Samples a Binomially distributed random variable.
///
- /// The number of successes in
+ /// The number of successes in N trials.
public int Sample()
{
return DoSample(RandomSource, _p, _n);
@@ -382,7 +416,7 @@ namespace MathNet.Numerics.Distributions
///
/// Samples an array of Bernoulli distributed random variables.
///
- /// a sequence of successes in
+ /// a sequence of successes in N trials.
public IEnumerable Samples()
{
while (true)
@@ -400,7 +434,7 @@ namespace MathNet.Numerics.Distributions
/// The number of successes in
- public static int Sample(System.Random rnd, double p, int n)
+ public static int Sample(Random rnd, double p, int n)
{
if (Control.CheckDistributionParameters && !IsValidParameterSet(p, n))
{
@@ -417,7 +451,7 @@ namespace MathNet.Numerics.Distributions
/// a sequence of successes in
- public static IEnumerable Samples(System.Random rnd, double p, int n)
+ public static IEnumerable Samples(Random rnd, double p, int n)
{
if (Control.CheckDistributionParameters && !IsValidParameterSet(p, n))
{
@@ -437,15 +471,15 @@ namespace MathNet.Numerics.Distributions
/// The number of successful trials.
- private static int DoSample(System.Random rnd, double p, int n)
+ private static int DoSample(Random rnd, double p, int n)
{
- int k = 0;
- for (int i = 0; i < n; i++)
+ var k = 0;
+ for (var i = 0; i < n; i++)
{
- k += (rnd.NextDouble() < p ? 1 : 0);
+ k += rnd.NextDouble() < p ? 1 : 0;
}
return k;
}
}
-}
\ No newline at end of file
+}
diff --git a/src/Numerics/Distributions/Discrete/Categorical.cs b/src/Numerics/Distributions/Discrete/Categorical.cs
index 8fb1ba6d..9d02f83d 100644
--- a/src/Numerics/Distributions/Discrete/Categorical.cs
+++ b/src/Numerics/Distributions/Discrete/Categorical.cs
@@ -3,9 +3,7 @@
// http://numerics.mathdotnet.com
// http://github.com/mathnet/mathnet-numerics
// http://mathnetnumerics.codeplex.com
-//
// Copyright (c) 2009-2010 Math.NET
-//
// Permission is hereby granted, free of charge, to any person
// obtaining a copy of this software and associated documentation
// files (the "Software"), to deal in the Software without
@@ -14,10 +12,8 @@
// copies of the Software, and to permit persons to whom the
// Software is furnished to do so, subject to the following
// conditions:
-//
// The above copyright notice and this permission notice shall be
// included in all copies or substantial portions of the Software.
-//
// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
@@ -32,9 +28,9 @@ namespace MathNet.Numerics.Distributions
{
using System;
using System.Collections.Generic;
+ using System.Linq;
using Properties;
- using MathNet.Numerics.Statistics;
-
+ using Statistics;
///
/// Implements the categorical distribution. For details about this distribution, see
@@ -48,7 +44,7 @@ namespace MathNet.Numerics.Distributions
/// Users can set the random number generator by using the The statistics classes will check all the incoming parameters whether they are in the allowed
/// range. This might involve heavy computation. Optionally, by setting Control.CheckDistributionParameters
- /// to false, all parameter checks can be turned off.
+ /// to false , all parameter checks can be turned off.
public class Categorical : IDiscreteDistribution
{
///
@@ -70,11 +66,11 @@ namespace MathNet.Numerics.Distributions
public Categorical(double[] p)
{
SetParameters(p);
- RandomSource = new System.Random();
+ RandomSource = new Random();
}
///
- /// Initializes a new instance of the Categorical class from a histogram
@@ -83,25 +79,26 @@ namespace MathNet.Numerics.Distributions
{
if (histogram == null)
{
- throw new ArgumentNullException("Cannot create a categorical variable from a null histogram.");
+ throw new ArgumentNullException("histogram");
}
// The probability distribution vector.
- double[] p = new double[histogram.BucketCount];
+ var p = new double[histogram.BucketCount];
// Fill in the distribution vector.
- for (int i = 0; i < histogram.BucketCount; i++)
+ for (var i = 0; i < histogram.BucketCount; i++)
{
p[i] = histogram[i].Count;
}
SetParameters(p);
- RandomSource = new System.Random();
+ RandomSource = new Random();
}
///
/// A string representation of the distribution.
///
+ /// a string representation of the distribution.
public override string ToString()
{
return "Categorical(Dimension = " + _p.Length + ")";
@@ -112,28 +109,21 @@ namespace MathNet.Numerics.Distributions
///
/// If any of the probabilities are negative returns false, or if the sum of parameters is 0.0; otherwise true
- private static bool IsValidParameterSet(double[] p)
+ /// If any of the probabilities are negative returns false , or if the sum of parameters is 0.0; otherwise true
+ private static bool IsValidParameterSet(IEnumerable p)
{
- double sum = 0.0;
- for (int i = 0; i < p.Length; i++)
+ var sum = 0.0;
+ foreach (double t in p)
{
- if (p[i] < 0.0 || Double.IsNaN(p[i]))
+ if (t < 0.0 || Double.IsNaN(t))
{
return false;
}
- else
- {
- sum += p[i];
- }
- }
-
- if (sum == 0.0)
- {
- return false;
+
+ sum += t;
}
- return true;
+ return sum != 0.0;
}
///
@@ -155,21 +145,17 @@ namespace MathNet.Numerics.Distributions
///
/// Gets or sets the normalized probability vector of the multinomial.
///
- /// Note that sometimes the normalized probability vector cannot be represented
+ /// Sometimes the normalized probability vector cannot be represented
/// exactly in a floating point representation.
public double[] P
{
get
{
- double[] p = (double[]) _p.Clone();
+ var p = (double[])_p.Clone();
- double sum = 0.0;
- for (int i = 0; i < p.Length; i++)
- {
- sum += p[i];
- }
+ var sum = p.Sum();
- for (int i = 0; i < p.Length; i++)
+ for (var i = 0; i < p.Length; i++)
{
p[i] /= sum;
}
@@ -211,7 +197,10 @@ namespace MathNet.Numerics.Distributions
///
public double Mean
{
- get { return _p.Mean(); }
+ get
+ {
+ return _p.Mean();
+ }
}
///
@@ -219,7 +208,10 @@ namespace MathNet.Numerics.Distributions
///
public double StdDev
{
- get { return _p.StandardDeviation(); }
+ get
+ {
+ return _p.StandardDeviation();
+ }
}
///
@@ -227,7 +219,10 @@ namespace MathNet.Numerics.Distributions
///
public double Variance
{
- get { return _p.Variance(); }
+ get
+ {
+ return _p.Variance();
+ }
}
///
@@ -235,34 +230,45 @@ namespace MathNet.Numerics.Distributions
///
public double Entropy
{
- get {
- double E = 0.0;
- for (int i = 0; i < _p.Length; i++)
- {
- double p = _p[i];
- E += p * Math.Log(p);
- }
- return E;
+ get
+ {
+ return _p.Sum(p => p * Math.Log(p));
}
}
///
/// Gets the skewness of the distribution.
///
+ /// Throws a
public double Skewness
{
- get { throw new NotImplementedException(); }
+ get
+ {
+ throw new NotSupportedException();
+ }
}
///
/// Gets the smallest element in the domain of the distributions which can be represented by an integer.
///
- public int Minimum { get { return 0; } }
+ public int Minimum
+ {
+ get
+ {
+ return 0;
+ }
+ }
///
/// Gets the largest element in the domain of the distributions which can be represented by an integer.
///
- public int Maximum { get { return _p.Length-1; } }
+ public int Maximum
+ {
+ get
+ {
+ return _p.Length - 1;
+ }
+ }
///
/// Computes the cumulative distribution function of the Binomial distribution.
@@ -275,13 +281,14 @@ namespace MathNet.Numerics.Distributions
{
return 0.0;
}
- else if (x >= _p.Length)
+
+ if (x >= _p.Length)
{
return 1.0;
}
- var cdf = UnnormalizedCDF(_p);
- return cdf[(int) Math.Floor(x)] / cdf[_p.Length - 1];
+ var cdf = UnnormalizedCdf(_p);
+ return cdf[(int)Math.Floor(x)] / cdf[_p.Length - 1];
}
#endregion
@@ -289,55 +296,66 @@ namespace MathNet.Numerics.Distributions
#region IDiscreteDistribution Members
///
- /// The mode of the distribution.
+ /// Gets he mode of the distribution.
///
+ /// Throws a
public int Mode
{
- get { throw new NotImplementedException(); }
+ get
+ {
+ throw new NotSupportedException();
+ }
}
///
- /// The median of the distribution.
+ /// Gets the median of the distribution.
///
public int Median
{
- get { return (int) _p.Median(); }
+ get
+ {
+ return (int)_p.Median();
+ }
}
///
- /// Computes the probability of a specific value.
+ /// Computes values of the probability mass function.
///
- public double Probability(int val)
+ /// the probability mass at location
+ public double Probability(int k)
{
- if (val < 0)
+ if (k < 0)
{
return 0.0;
}
- if (val >= _p.Length)
+ if (k >= _p.Length)
{
return 0.0;
}
- return _p[val];
+ return _p[k];
}
///
- /// Computes the probability of a specific value.
+ /// Computes values of the log probability mass function.
///
- public double ProbabilityLn(int val)
+ /// the log probability mass at location
+ public double ProbabilityLn(int k)
{
- if (val < 0)
+ if (k < 0)
{
return 0.0;
}
- if (val >= _p.Length)
+ if (k >= _p.Length)
{
return 0.0;
}
- return Math.Log(_p[val]);
+ return Math.Log(_p[k]);
}
///
@@ -367,7 +385,7 @@ namespace MathNet.Numerics.Distributions
/// One random integer between 0 and the size of the categorical (exclusive).
- public static int Sample(System.Random rnd, double[] p)
+ public static int Sample(Random rnd, double[] p)
{
if (Control.CheckDistributionParameters && !IsValidParameterSet(p))
{
@@ -375,7 +393,7 @@ namespace MathNet.Numerics.Distributions
}
// The cumulative density of p.
- double[] cp = UnnormalizedCDF(p);
+ var cp = UnnormalizedCdf(p);
return DoSample(rnd, cp);
}
@@ -386,8 +404,8 @@ namespace MathNet.Numerics.Distributions
/// Samples(System.Random rnd, double[] p)
+ /// random integers between 0 and the size of the categorical (exclusive).
+ public static IEnumerable Samples(Random rnd, double[] p)
{
if (Control.CheckDistributionParameters && !IsValidParameterSet(p))
{
@@ -395,7 +413,7 @@ namespace MathNet.Numerics.Distributions
}
// The cumulative density of p.
- double[] cp = UnnormalizedCDF(p);
+ var cp = UnnormalizedCdf(p);
while (true)
{
@@ -410,11 +428,11 @@ namespace MathNet.Numerics.Distributions
/// An array representing the unnormalized cumulative distribution function.
- internal static double[] UnnormalizedCDF(double[] p)
+ internal static double[] UnnormalizedCdf(double[] p)
{
- double[] cp = (double[]) p.Clone();
+ var cp = (double[])p.Clone();
- for (int i = 1; i < p.Length; i++)
+ for (var i = 1; i < p.Length; i++)
{
cp[i] += cp[i - 1];
}
@@ -428,16 +446,18 @@ namespace MathNet.Numerics.Distributions
/// One sample from the categorical distribution implied by
- internal static int DoSample(System.Random rnd, double[] cdf)
+ internal static int DoSample(Random rnd, double[] cdf)
{
// TODO : use binary search to speed up this procedure.
- double u = rnd.NextDouble() * cdf[cdf.Length - 1];
- int idx = 0;
+ var u = rnd.NextDouble() * cdf[cdf.Length - 1];
+
+ var idx = 0;
while (u > cdf[idx])
{
idx++;
}
+
return idx;
}
}
-}
\ No newline at end of file
+}
diff --git a/src/Numerics/Distributions/Discrete/ConwayMaxwellPoisson.cs b/src/Numerics/Distributions/Discrete/ConwayMaxwellPoisson.cs
new file mode 100644
index 00000000..98618b47
--- /dev/null
+++ b/src/Numerics/Distributions/Discrete/ConwayMaxwellPoisson.cs
@@ -0,0 +1,562 @@
+//
+// Math.NET Numerics, part of the Math.NET Project
+// http://numerics.mathdotnet.com
+// http://github.com/mathnet/mathnet-numerics
+// http://mathnetnumerics.codeplex.com
+// Copyright (c) 2009-2010 Math.NET
+// Permission is hereby granted, free of charge, to any person
+// obtaining a copy of this software and associated documentation
+// files (the "Software"), to deal in the Software without
+// restriction, including without limitation the rights to use,
+// copy, modify, merge, publish, distribute, sublicense, and/or sell
+// copies of the Software, and to permit persons to whom the
+// Software is furnished to do so, subject to the following
+// conditions:
+// The above copyright notice and this permission notice shall be
+// included in all copies or substantial portions of the Software.
+// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
+// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
+// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+// OTHER DEALINGS IN THE SOFTWARE.
+//
+
+namespace MathNet.Numerics.Distributions
+{
+ using System;
+ using System.Collections.Generic;
+ using Properties;
+
+ ///
+ /// The Conway-Maxwell-Poisson distribution is a generalization of the Poisson, Geometric and Bernoulli
+ /// distributions. It is parameterized by two real numbers "lambda" and "nu". For
+ ///
+ /// - nu = 0 the distribution reverts to a Geometric distribution
+ /// - nu = 1 the distribution reverts to the Poisson distribution
+ /// - nu -> infinity the distribution converges to a Bernoulli distribution
+ ///
+ /// This implementation will cache the value of the normalization constant.
+ /// Wikipedia - ConwayMaxwellPoisson distribution .
+ ///
+ /// The distribution will use the
+ /// The statistics classes will check all the incoming parameters whether they are in the allowed
+ /// range. This might involve heavy computation. Optionally, by setting Control.CheckDistributionParameters
+ /// to false , all parameter checks can be turned off.
+ /// Since many properties of the distribution can only be computed approximately, the tolerance
+ /// level specifies how much error we accept.
+ ///
+ private const double Tolerance = 1e-12;
+
+ ///
+ /// The mean of the distribution.
+ ///
+ private double _mean = double.MinValue;
+
+ ///
+ /// The variance of the distribution.
+ ///
+ private double _variance = double.MinValue;
+
+ ///
+ /// Caches the value of the normalization constant.
+ ///
+ private double _z = double.MinValue;
+
+ ///
+ /// The lambda parameter.
+ ///
+ private double _lambda;
+
+ ///
+ /// The nu parameter.
+ ///
+ private double _nu;
+
+ ///
+ /// The distribution's random number generator.
+ ///
+ private Random _random;
+
+ ///
+ /// Initializes a new instance of the
+ ///
+ /// Sets the parameters of the distribution after checking their validity.
+ ///
+ /// When the parameters don't pass the
+ private void SetParameters(double lambda, double nu)
+ {
+ if (Control.CheckDistributionParameters && !IsValidParameterSet(lambda, nu))
+ {
+ throw new ArgumentOutOfRangeException(Resources.InvalidDistributionParameters);
+ }
+
+ _lambda = lambda;
+ _nu = nu;
+ }
+
+ ///
+ /// Checks whether the parameters of the distribution are valid.
+ ///
+ /// true when the parameters are valid, false otherwise.
+ /// Gets or sets the lambda parameter.
+ ///
+ /// The value of the lambda parameter.
+ public double Lambda
+ {
+ get
+ {
+ return _lambda;
+ }
+
+ set
+ {
+ SetParameters(value, _nu);
+ }
+ }
+
+ ///
+ /// Gets or sets the Nu parameter.
+ ///
+ /// The value of the Nu parameter.
+ public double Nu
+ {
+ get
+ {
+ return _nu;
+ }
+
+ set
+ {
+ SetParameters(_lambda, value);
+ }
+ }
+
+ ///
+ /// Returns a
+ ///
+ /// A
+ public override string ToString()
+ {
+ return "ConwayMaxwellPoisson(Lambda = " + _lambda + ", Nu = " + _nu + ")";
+ }
+
+ #region IDistribution Members
+
+ ///
+ /// Gets or sets the random number generator which is used to draw random samples.
+ ///
+ public Random RandomSource
+ {
+ get
+ {
+ return _random;
+ }
+
+ set
+ {
+ if (value == null)
+ {
+ throw new ArgumentNullException();
+ }
+
+ _random = value;
+ }
+ }
+
+ ///
+ /// Gets the mean of the distribution.
+ ///
+ public double Mean
+ {
+ get
+ {
+ // Special case requiring no computation.
+ if (_lambda == 0)
+ {
+ return 0.0;
+ }
+
+ if (_mean != double.MinValue)
+ {
+ return _mean;
+ }
+
+ // The normalization constant for the distribution.
+ var z = 1 + _lambda;
+
+ // The probability of the next term.
+ var a1 = _lambda * _lambda / Math.Pow(2, _nu);
+
+ // The unnormalized mean.
+ var zx = _lambda;
+
+ // The contribution of the next term to the mean.
+ var ax1 = 2 * a1;
+
+ for (var i = 3; i < 1000; i++)
+ {
+ var e = _lambda / Math.Pow(i, _nu);
+ var ex = _lambda / Math.Pow(i, _nu - 1) / (i - 1);
+ var a2 = a1 * e;
+ var ax2 = ax1 * ex;
+
+ var m = zx / z;
+ var upper = (zx + (ax1 / (1 - (ax2 / ax1)))) / z;
+ var lower = zx / (z + (a1 / (1 - (a2 / a1))));
+
+ if ((ax2 < ax1) && (a2 < a1))
+ {
+ var r = (upper - lower) / m;
+ if (r < Tolerance)
+ {
+ break;
+ }
+ }
+
+ z = z + a1;
+ zx = zx + ax1;
+ a1 = a2;
+ ax1 = ax2;
+ }
+
+ _mean = zx / z;
+ return _mean;
+ }
+ }
+
+ ///
+ /// Gets the variance of the distribution.
+ ///
+ public double Variance
+ {
+ get
+ {
+ // Special case requiring no computation.
+ if (_lambda == 0)
+ {
+ return 0.0;
+ }
+
+ if (_variance != double.MinValue)
+ {
+ return _variance;
+ }
+
+ // The normalization constant for the distribution.
+ var z = 1 + _lambda;
+
+ // The probability of the next term.
+ var a1 = _lambda * _lambda / Math.Pow(2, _nu);
+
+ // The unnormalized second moment.
+ var zxx = _lambda;
+
+ // The contribution of the next term to the second moment.
+ var axx1 = 4 * a1;
+
+ for (var i = 3; i < 1000; i++)
+ {
+ var e = _lambda / Math.Pow(i, _nu);
+ var exx = _lambda / Math.Pow(i, _nu - 2) / (i - 1) / (i - 1);
+ var a2 = a1 * e;
+ var axx2 = axx1 * exx;
+
+ var m = zxx / z;
+ var upper = (zxx + (axx1 / (1 - (axx2 / axx1)))) / z;
+ var lower = zxx / (z + (a1 / (1 - (a2 / a1))));
+
+ if ((axx2 < axx1) && (a2 < a1))
+ {
+ var r = (upper - lower) / m;
+ if (r < Tolerance)
+ {
+ break;
+ }
+ }
+
+ z = z + a1;
+ zxx = zxx + axx1;
+ a1 = a2;
+ axx1 = axx2;
+ }
+
+ var mean = Mean;
+ _variance = (zxx / z) - (mean * mean);
+ return _variance;
+ }
+ }
+
+ ///
+ /// Gets the standard deviation of the distribution.
+ ///
+ public double StdDev
+ {
+ get
+ {
+ return Math.Sqrt(Variance);
+ }
+ }
+
+ ///
+ /// Gets the entropy of the distribution.
+ ///
+ public double Entropy
+ {
+ get
+ {
+ throw new NotImplementedException();
+ }
+ }
+
+ ///
+ /// Gets the skewness of the distribution.
+ ///
+ public double Skewness
+ {
+ get
+ {
+ throw new NotImplementedException();
+ }
+ }
+
+ ///
+ /// Computes the cumulative distribution function of the ConwayMaxwellPoisson distribution.
+ ///
+ /// the cumulative density at
+ public double CumulativeDistribution(double x)
+ {
+ double sum = 0;
+ for (var i = 0; i < x + 1; i++)
+ {
+ sum += Probability(i);
+ }
+
+ return sum;
+ }
+
+ #endregion
+
+ #region IDiscreteDistribution Members
+
+ ///
+ /// Gets the mode of the distribution
+ ///
+ public int Mode
+ {
+ get
+ {
+ throw new NotImplementedException();
+ }
+ }
+
+ ///
+ /// Gets the median of the distribution.
+ ///
+ public int Median
+ {
+ get
+ {
+ throw new NotImplementedException();
+ }
+ }
+
+ ///
+ /// Gets the smallest element in the domain of the distributions which can be represented by an integer.
+ ///
+ public int Minimum
+ {
+ get
+ {
+ return 0;
+ }
+ }
+
+ ///
+ /// Gets the largest element in the domain of the distributions which can be represented by an integer.
+ ///
+ public int Maximum
+ {
+ get
+ {
+ throw new NotImplementedException();
+ }
+ }
+
+ ///
+ /// Computes the probability of a specific value.
+ ///
+ ///
+ /// the probability mass at location
+ public double Probability(int k)
+ {
+ return Math.Pow(_lambda, k) / Math.Pow(SpecialFunctions.Factorial(k), _nu) / Z;
+ }
+
+ ///
+ /// Computes the log probability of a specific value.
+ ///
+ ///
+ /// the log probability mass at location
+ public double ProbabilityLn(int k)
+ {
+ return Math.Log(Probability(k));
+ }
+
+ ///
+ /// Samples a Conway-Maxwell-Poisson distributed random variable.
+ ///
+ /// a sample from the distribution.
+ public int Sample()
+ {
+ return DoSample(RandomSource, _lambda, _nu, Z);
+ }
+
+ ///
+ /// Samples a sequence of a Conway-Maxwell-Poisson distributed random variables.
+ ///
+ ///
+ /// a sequence of samples from a Conway-Maxwell-Poisson distribution.
+ ///
+ public IEnumerable Samples()
+ {
+ while (true)
+ {
+ yield return DoSample(RandomSource, _lambda, _nu, Z);
+ }
+ }
+
+ #endregion
+
+ ///
+ /// Gets the normalization constant of the Conway-Maxwell-Poisson distribution.
+ ///
+ private double Z
+ {
+ get
+ {
+ if (_z != double.MinValue)
+ {
+ return _z;
+ }
+
+ _z = Normalization(_lambda, _nu);
+ return _z;
+ }
+ }
+
+ ///
+ /// Computes an approximate normalization constant for the CMP distribution.
+ ///
+ ///
+ /// an approximate normalization constant for the CMP distribution.
+ ///
+ private static double Normalization(double lambda, double nu)
+ {
+ // Initialize Z with the first two terms.
+ var z = 1.0 + lambda;
+
+ // Remembers the last term added.
+ var t = lambda;
+
+ // Start adding more terms until convergence.
+ for (var i = 2; i < 1000; i++)
+ {
+ // The new addition for term i.
+ var e = lambda / Math.Pow(i, nu);
+
+ // The new term.
+ t = t * e;
+
+ // The updated normalization constant.
+ z = z + t;
+
+ // The stopping criterion.
+ if (e < 1)
+ {
+ if (t / (1 - e) / z < Tolerance)
+ {
+ break;
+ }
+ }
+ }
+
+ return z;
+ }
+
+ ///
+ /// Returns one trials from the distribution.
+ ///
+ ///
+ /// One sample from the distribution implied by
+ private static int DoSample(Random rnd, double lambda, double nu, double z)
+ {
+ var u = rnd.NextDouble();
+ var p = 1.0 / z;
+ var cdf = p;
+ var i = 0;
+
+ while (u > cdf)
+ {
+ i++;
+ p = p * lambda / Math.Pow(i, nu);
+ cdf += p;
+ }
+
+ return i;
+ }
+ }
+}
diff --git a/src/Numerics/Distributions/Discrete/DiscreteUniform.cs b/src/Numerics/Distributions/Discrete/DiscreteUniform.cs
index 69828e3d..a29ccb38 100644
--- a/src/Numerics/Distributions/Discrete/DiscreteUniform.cs
+++ b/src/Numerics/Distributions/Discrete/DiscreteUniform.cs
@@ -3,9 +3,7 @@
// http://numerics.mathdotnet.com
// http://github.com/mathnet/mathnet-numerics
// http://mathnetnumerics.codeplex.com
-//
// Copyright (c) 2009-2010 Math.NET
-//
// Permission is hereby granted, free of charge, to any person
// obtaining a copy of this software and associated documentation
// files (the "Software"), to deal in the Software without
@@ -14,10 +12,8 @@
// copies of the Software, and to permit persons to whom the
// Software is furnished to do so, subject to the following
// conditions:
-//
// The above copyright notice and this permission notice shall be
// included in all copies or substantial portions of the Software.
-//
// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
@@ -42,7 +38,7 @@ namespace MathNet.Numerics.Distributions
/// Users can set the random number generator by using the The statistics classes will check all the incoming parameters whether they are in the allowed
/// range. This might involve heavy computation. Optionally, by setting Control.CheckDistributionParameters
- /// to false, all parameter checks can be turned off.
+ /// to false , all parameter checks can be turned off.
public class DiscreteUniform : IDiscreteDistribution
{
///
@@ -66,14 +62,17 @@ namespace MathNet.Numerics.Distributions
///
- /// A string representation of the distribution.
+ /// Returns a
+ ///
+ /// A
public override string ToString()
{
return "DiscreteUniform(Lower = " + _lower + ", Upper = " + _upper + ")";
@@ -84,7 +83,7 @@ namespace MathNet.Numerics.Distributions
///
/// True when the parameters are valid, false otherwise.
+ /// true when the parameters are valid, false otherwise.
public double Mean
{
- get { return (_lower + _upper) / 2.0; }
+ get
+ {
+ return (_lower + _upper) / 2.0;
+ }
}
///
@@ -180,7 +182,10 @@ namespace MathNet.Numerics.Distributions
///
public double StdDev
{
- get { return System.Math.Sqrt(((_upper - _lower + 1.0) * (_upper - _lower + 1.0) - 1.0) / 12.0); }
+ get
+ {
+ return Math.Sqrt((((_upper - _lower + 1.0) * (_upper - _lower + 1.0)) - 1.0) / 12.0);
+ }
}
///
@@ -188,7 +193,10 @@ namespace MathNet.Numerics.Distributions
///
public double Variance
{
- get { return ((_upper - _lower + 1.0) * (_upper - _lower + 1.0) - 1.0) / 12.0; }
+ get
+ {
+ return (((_upper - _lower + 1.0) * (_upper - _lower + 1.0)) - 1.0) / 12.0;
+ }
}
///
@@ -196,7 +204,10 @@ namespace MathNet.Numerics.Distributions
///
public double Entropy
{
- get { return System.Math.Log(_upper - _lower + 1.0); }
+ get
+ {
+ return Math.Log(_upper - _lower + 1.0);
+ }
}
///
@@ -204,18 +215,33 @@ namespace MathNet.Numerics.Distributions
///
public double Skewness
{
- get { return 0.0; }
+ get
+ {
+ return 0.0;
+ }
}
///
/// Gets the smallest element in the domain of the distributions which can be represented by an integer.
///
- public int Minimum { get { return _lower; } }
+ public int Minimum
+ {
+ get
+ {
+ return _lower;
+ }
+ }
///
/// Gets the largest element in the domain of the distributions which can be represented by an integer.
///
- public int Maximum { get { return _upper; } }
+ public int Maximum
+ {
+ get
+ {
+ return _upper;
+ }
+ }
///
/// Computes the cumulative distribution function of the Bernoulli distribution.
@@ -228,7 +254,8 @@ namespace MathNet.Numerics.Distributions
{
return 0.0;
}
- else if (x >= _upper)
+
+ if (x >= _upper)
{
return 1.0;
}
@@ -241,27 +268,37 @@ namespace MathNet.Numerics.Distributions
#region IDiscreteDistribution Members
///
- /// The mode of the distribution; since every element in the domain has the same probability this method returns the middle one.
+ /// Gets the mode of the distribution; since every element in the domain has the same probability this method returns the middle one.
///
public int Mode
{
- get { return (int) Math.Floor((_lower + _upper) / 2.0); }
+ get
+ {
+ return (int)Math.Floor((_lower + _upper) / 2.0);
+ }
}
///
- /// The median of the distribution.
+ /// Gets the median of the distribution.
///
public int Median
{
- get { return (int)Math.Floor((_lower + _upper) / 2.0); }
+ get
+ {
+ return (int)Math.Floor((_lower + _upper) / 2.0);
+ }
}
///
- /// Computes the probability of a specific value.
+ /// Computes values of the probability mass function.
///
- public double Probability(int val)
+ ///
+ /// the probability mass at location
+ public double Probability(int k)
{
- if (val >= _lower && val <= _upper)
+ if (k >= _lower && k <= _upper)
{
return 1.0 / (_upper - _lower + 1);
}
@@ -272,19 +309,24 @@ namespace MathNet.Numerics.Distributions
///
/// Computes the probability of a specific value.
///
- public double ProbabilityLn(int val)
+ ///
+ /// the log probability mass at location
+ public double ProbabilityLn(int k)
{
- if (val >= _lower && val <= _upper)
+ if (k >= _lower && k <= _upper)
{
- return - Math.Log(_upper - _lower + 1);
+ return -Math.Log(_upper - _lower + 1);
}
return Double.NegativeInfinity;
}
///
- /// Samples a uniformly distributed random variable.
+ /// Draws a random sample from the distribution.
///
+ /// a sample from the distribution.
public int Sample()
{
return DoSample(RandomSource, _lower, _upper);
@@ -311,7 +353,7 @@ namespace MathNet.Numerics.Distributions
/// A sample from the discrete uniform distribution.
- public static int Sample(System.Random rnd, int lower, int upper)
+ public static int Sample(Random rnd, int lower, int upper)
{
if (Control.CheckDistributionParameters && !IsValidParameterSet(lower, upper))
{
@@ -328,7 +370,7 @@ namespace MathNet.Numerics.Distributions
/// a sequence of samples from the discrete uniform distribution.
- public static IEnumerable Samples(System.Random rnd, int lower, int upper)
+ public static IEnumerable Samples(Random rnd, int lower, int upper)
{
if (Control.CheckDistributionParameters && !IsValidParameterSet(lower, upper))
{
@@ -348,9 +390,9 @@ namespace MathNet.Numerics.Distributions
/// A random sample from the discrete uniform distribution.
- private static int DoSample(System.Random rnd, int lower, int upper)
+ private static int DoSample(Random rnd, int lower, int upper)
{
- return rnd.Next() % (upper - lower + 1) + lower;
+ return (rnd.Next() % (upper - lower + 1)) + lower;
}
}
-}
\ No newline at end of file
+}
diff --git a/src/Numerics/Distributions/Discrete/Geometric.cs b/src/Numerics/Distributions/Discrete/Geometric.cs
new file mode 100644
index 00000000..b8348349
--- /dev/null
+++ b/src/Numerics/Distributions/Discrete/Geometric.cs
@@ -0,0 +1,330 @@
+//
+// Math.NET Numerics, part of the Math.NET Project
+// http://numerics.mathdotnet.com
+// http://github.com/mathnet/mathnet-numerics
+// http://mathnetnumerics.codeplex.com
+// Copyright (c) 2009-2010 Math.NET
+// Permission is hereby granted, free of charge, to any person
+// obtaining a copy of this software and associated documentation
+// files (the "Software"), to deal in the Software without
+// restriction, including without limitation the rights to use,
+// copy, modify, merge, publish, distribute, sublicense, and/or sell
+// copies of the Software, and to permit persons to whom the
+// Software is furnished to do so, subject to the following
+// conditions:
+// The above copyright notice and this permission notice shall be
+// included in all copies or substantial portions of the Software.
+// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
+// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
+// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+// OTHER DEALINGS IN THE SOFTWARE.
+//
+
+namespace MathNet.Numerics.Distributions
+{
+ using System;
+ using System.Collections.Generic;
+ using Properties;
+
+ ///
+ /// The Geometric distribution is a distribution over positive integers parameterized by one positive real number.
+ /// This implementation of the Geometric distribution will never generate 0's.
+ /// Wikipedia - geometric distribution .
+ ///
+ /// The distribution will use the
+ /// The statistics classes will check all the incoming parameters whether they are in the allowed
+ /// range. This might involve heavy computation. Optionally, by setting Control.CheckDistributionParameters
+ /// to false , all parameter checks can be turned off.
+ /// The geometric distribution parameter.
+ ///
+ private double _p;
+
+ ///
+ /// The distribution's random number generator.
+ ///
+ private Random _random;
+
+ ///
+ /// Initializes a new instance of the Geometric class.
+ ///
+ /// If the Geometric parameter is not in the range [0,1].
+ public Geometric(double p)
+ {
+ SetParameters(p);
+ RandomSource = new Random();
+ }
+
+ ///
+ /// Sets the parameters of the distribution after checking their validity.
+ ///
+ /// When the parameters don't pass the
+ private void SetParameters(double p)
+ {
+ if (Control.CheckDistributionParameters && !IsValidParameterSet(p))
+ {
+ throw new ArgumentOutOfRangeException(Resources.InvalidDistributionParameters);
+ }
+
+ _p = p;
+ }
+
+ ///
+ /// Checks whether the parameters of the distribution are valid.
+ ///
+ /// true when the parameters are valid, false otherwise.
+ /// Gets or sets the probability of generating a one.
+ ///
+ public double P
+ {
+ get
+ {
+ return _p;
+ }
+
+ set
+ {
+ SetParameters(value);
+ }
+ }
+
+ ///
+ /// Returns a
+ ///
+ /// A
+ public override string ToString()
+ {
+ return "Geometric(P = " + _p + ")";
+ }
+
+ #region IDistribution Members
+
+ ///
+ /// Gets or sets the random number generator which is used to draw random samples.
+ ///
+ public Random RandomSource
+ {
+ get
+ {
+ return _random;
+ }
+
+ set
+ {
+ if (value == null)
+ {
+ throw new ArgumentNullException();
+ }
+
+ _random = value;
+ }
+ }
+
+ ///
+ /// Gets the mean of the distribution.
+ ///
+ public double Mean
+ {
+ get
+ {
+ return 1.0 / _p;
+ }
+ }
+
+ ///
+ /// Gets the variance of the distribution.
+ ///
+ public double Variance
+ {
+ get
+ {
+ return (1.0 - _p) / (_p * _p);
+ }
+ }
+
+ ///
+ /// Gets the standard deviation of the distribution.
+ ///
+ public double StdDev
+ {
+ get
+ {
+ return Math.Sqrt(1.0 - _p) / _p;
+ }
+ }
+
+ ///
+ /// Gets the entropy of the distribution.
+ ///
+ public double Entropy
+ {
+ get
+ {
+ return ((-_p * Math.Log(_p, 2.0)) - ((1.0 - _p) * Math.Log(1.0 - _p, 2.0))) / _p;
+ }
+ }
+
+ ///
+ /// Gets the skewness of the distribution.
+ ///
+ /// Throws a not supported exception.
+ public double Skewness
+ {
+ get
+ {
+ throw new NotSupportedException();
+ }
+ }
+
+ ///
+ /// Computes the cumulative distribution function of the Bernoulli distribution.
+ ///
+ /// the cumulative density at
+ public double CumulativeDistribution(double x)
+ {
+ return 1.0 - Math.Pow(1.0 - _p, x);
+ }
+
+ #endregion
+
+ #region IDiscreteDistribution Members
+
+ ///
+ /// Gets the mode of the distribution.
+ ///
+ public int Mode
+ {
+ get
+ {
+ return 1;
+ }
+ }
+
+ ///
+ /// Gets the median of the distribution.
+ ///
+ public int Median
+ {
+ get
+ {
+ return (int)Math.Ceiling(-Math.Log(2.0) / Math.Log(1 - _p));
+ }
+ }
+
+ ///
+ /// Gets the smallest element in the domain of the distributions which can be represented by an integer.
+ ///
+ public int Minimum
+ {
+ get
+ {
+ return 1;
+ }
+ }
+
+ ///
+ /// Gets the largest element in the domain of the distributions which can be represented by an integer.
+ ///
+ public int Maximum
+ {
+ get
+ {
+ throw new NotSupportedException();
+ }
+ }
+
+ ///
+ /// Computes values of the probability mass function.
+ ///
+ ///
+ /// the probability mass at location
+ public double Probability(int k)
+ {
+ if (k <= 0)
+ {
+ return 0.0;
+ }
+
+ return Math.Pow(1.0 - _p, k - 1) * _p;
+ }
+
+ ///
+ /// Computes values of the log probability mass function.
+ ///
+ ///
+ /// the log probability mass at location
+ public double ProbabilityLn(int k)
+ {
+ if (k <= 0)
+ {
+ return Double.NegativeInfinity;
+ }
+
+ return ((k - 1) * Math.Log(1.0 - _p)) + Math.Log(_p);
+ }
+
+ ///
+ /// Samples a Geometric distributed random variable.
+ ///
+ /// A sample from the Geometric distribution.
+ public int Sample()
+ {
+ return DoSample(RandomSource, _p);
+ }
+
+ ///
+ /// Samples an array of Geometric distributed random variables.
+ ///
+ /// a sequence of samples from the distribution.
+ public IEnumerable Samples()
+ {
+ while (true)
+ {
+ yield return DoSample(RandomSource, _p);
+ }
+ }
+
+ #endregion
+
+ ///
+ /// Returns one sample from the distribution.
+ ///
+ ///
+ /// One sample from the distribution implied by
+ private static int DoSample(Random rnd, double p)
+ {
+ return (int)Math.Ceiling(-Math.Log(rnd.NextDouble()) / p);
+ }
+ }
+}
diff --git a/src/Numerics/Distributions/Discrete/Hypergeometric.cs b/src/Numerics/Distributions/Discrete/Hypergeometric.cs
new file mode 100644
index 00000000..209e7abc
--- /dev/null
+++ b/src/Numerics/Distributions/Discrete/Hypergeometric.cs
@@ -0,0 +1,375 @@
+//
+// Math.NET Numerics, part of the Math.NET Project
+// http://numerics.mathdotnet.com
+// http://github.com/mathnet/mathnet-numerics
+// http://mathnetnumerics.codeplex.com
+//
+// Copyright (c) 2009-2010 Math.NET
+//
+// Permission is hereby granted, free of charge, to any person
+// obtaining a copy of this software and associated documentation
+// files (the "Software"), to deal in the Software without
+// restriction, including without limitation the rights to use,
+// copy, modify, merge, publish, distribute, sublicense, and/or sell
+// copies of the Software, and to permit persons to whom the
+// Software is furnished to do so, subject to the following
+// conditions:
+//
+// The above copyright notice and this permission notice shall be
+// included in all copies or substantial portions of the Software.
+//
+// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
+// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
+// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+// OTHER DEALINGS IN THE SOFTWARE.
+//
+
+namespace MathNet.Numerics.Distributions
+{
+ using System;
+ using System.Collections.Generic;
+ using Properties;
+
+ ///
+ /// This class implements functionality for the Hypergeometric distribution. This distribution is
+ /// a discrete probability distribution that describes the number of successes in a sequence
+ /// of n draws from a finite population without replacement, just as the binomial distribution
+ /// describes the number of successes for draws with replacement
+ /// Wikipedia - Hypergeometric distribution .
+ ///
+ /// The distribution will use the .
+ ///
+ /// The statistics classes will check all the incoming parameters whether they are in the allowed
+ /// range. This might involve heavy computation. Optionally, by setting Control.CheckDistributionParameters
+ /// to false , all parameter checks can be turned off.
+ /// The size of the population.
+ ///
+ private int _populationSize;
+
+ ///
+ /// The m parameter of the distribution.
+ ///
+ private int _m;
+
+ ///
+ /// The n parameter (number to draw) of the distribution.
+ ///
+ private int _n;
+
+ ///
+ /// The distribution's random number generator.
+ ///
+ private Random _random;
+
+ ///
+ /// Initializes a new instance of the Hypergeometric class.
+ ///
+ ///
+ /// Sets the parameters of the distribution after checking their validity.
+ ///
+ ///
+ /// Checks whether the parameters of the distribution are valid.
+ ///
+ /// true when the parameters are valid, false otherwise.
+ /// Gets or sets the population size.
+ ///
+ public int PopulationSize
+ {
+ get { return _populationSize; }
+ set { SetParameters(value, _m, _n); }
+ }
+
+ ///
+ /// Gets or sets the n parameter of the distribution.
+ ///
+ public int N
+ {
+ get { return _n; }
+ set { SetParameters(_populationSize, value, _n); }
+ }
+
+ ///
+ /// Gets or sets the m parameter of the distribution.
+ ///
+ public int M
+ {
+ get { return _m; }
+ set { SetParameters(_populationSize, _m, value); }
+ }
+
+ ///
+ /// Returns a
+ ///
+ /// A
+ public override string ToString()
+ {
+ return "Hypergeometric(N = " + _populationSize + ", m = " + _m + ", n = " + _n + ")";
+ }
+
+ #region IDistribution Members
+
+ ///
+ /// Gets or sets the random number generator which is used to draw random samples.
+ ///
+ public Random RandomSource
+ {
+ get
+ {
+ return _random;
+ }
+
+ set
+ {
+ if (value == null)
+ {
+ throw new ArgumentNullException();
+ }
+
+ _random = value;
+ }
+ }
+
+ ///
+ /// Gets the mean of the distribution.
+ ///
+ public double Mean
+ {
+ get
+ {
+ return (double)_m * _n / _populationSize;
+ }
+ }
+
+ ///
+ /// Gets the variance of the distribution.
+ ///
+ public double Variance
+ {
+ get
+ {
+ return _n * _m * (_populationSize - _n) * (_populationSize - _m) / (_populationSize * _populationSize * (_populationSize - 1.0));
+ }
+ }
+
+ ///
+ /// Gets the standard deviation of the distribution.
+ ///
+ public double StdDev
+ {
+ get { return Math.Sqrt(Variance); }
+ }
+
+ ///
+ /// Gets the entropy of the distribution.
+ ///
+ public double Entropy
+ {
+ get { throw new NotSupportedException(); }
+ }
+
+ ///
+ /// Gets the skewness of the distribution.
+ ///
+ public double Skewness
+ {
+ get
+ {
+ return (Math.Sqrt(_populationSize - 1.0) * (_populationSize - (2 * _n)) * (_populationSize - (2 * _m))) / (Math.Sqrt(_n * _m * (_populationSize - _m) * (_populationSize - _n)) * (_populationSize - 2.0));
+ }
+ }
+
+ ///
+ /// Computes the cumulative distribution function of the distribution.
+ ///
+ /// the cumulative density at
+ public double CumulativeDistribution(double x)
+ {
+ int alpha = Minimum;
+ int beta = Maximum;
+ if (x <= alpha)
+ {
+ return 0.0;
+ }
+
+ if (x > beta)
+ {
+ return 1.0;
+ }
+
+ var sum = 0.0;
+ var k = (int)Math.Ceiling(x - alpha) - 1;
+ for (var i = alpha; i <= alpha + k; i++)
+ {
+ sum += SpecialFunctions.Binomial(_m, i) * SpecialFunctions.Binomial(_populationSize - _m, _n - i);
+ }
+
+ return sum / SpecialFunctions.Binomial(_populationSize, _n);
+ }
+
+ #endregion
+
+ #region IDiscreteDistribution Members
+
+ ///
+ /// Gets the mode of the distribution.
+ ///
+ public int Mode
+ {
+ get { return (_n + 1) * (_m + 1) / (_populationSize + 2); }
+ }
+
+ ///
+ /// Gets the median of the distribution.
+ ///
+ public int Median
+ {
+ get { throw new NotSupportedException(); }
+ }
+
+ ///
+ /// Gets the minimum of the distribution.
+ ///
+ public int Minimum
+ {
+ get { return Math.Max(0, _n + _m - _populationSize); }
+ }
+
+ ///
+ /// Gets the maximum of the distribution.
+ ///
+ public int Maximum
+ {
+ get { return Math.Min(_m, _n); }
+ }
+
+ ///
+ /// Computes values of the probability mass function.
+ ///
+ ///
+ /// the probability mass at location
+ public double Probability(int k)
+ {
+ return SpecialFunctions.Binomial(_m, k) * SpecialFunctions.Binomial(_populationSize - _m, _n - k) / SpecialFunctions.Binomial(_populationSize, _n);
+ }
+
+ ///
+ /// Computes values of the log probability mass function.
+ ///
+ ///
+ /// the log probability mass at location
+ public double ProbabilityLn(int k)
+ {
+ return Math.Log(Probability(k));
+ }
+
+ ///
+ /// Samples a Hypergeometric distributed random variable.
+ ///
+ /// The number of successes in n trials.
+ public int Sample()
+ {
+ return DoSample(RandomSource, _populationSize, _m, _n);
+ }
+
+ ///
+ /// Samples an array of Hypergeometric distributed random variables.
+ ///
+ /// a sequence of successes in n trials.
+ public IEnumerable Samples()
+ {
+ while (true)
+ {
+ yield return DoSample(RandomSource, _populationSize, _m, _n);
+ }
+ }
+
+ #endregion
+
+ ///
+ /// Generates a sample from the Hypergeometric distribution without doing parameter checking.
+ ///
+ /// a random number from the Hypergeometric distribution.
+ private static int DoSample(Random rnd, int size, int m, int n)
+ {
+ var x = 0;
+
+ do
+ {
+ var p = (double)m / size;
+ var r = rnd.NextDouble();
+ if (r < p)
+ {
+ x++;
+ m--;
+ }
+
+ size--;
+ }
+ while (1 < n);
+
+ return x;
+ }
+ }
+}
diff --git a/src/Numerics/Distributions/Discrete/NegativeBinomial.cs b/src/Numerics/Distributions/Discrete/NegativeBinomial.cs
new file mode 100644
index 00000000..2d6633d9
--- /dev/null
+++ b/src/Numerics/Distributions/Discrete/NegativeBinomial.cs
@@ -0,0 +1,383 @@
+//
+// Math.NET Numerics, part of the Math.NET Project
+// http://numerics.mathdotnet.com
+// http://github.com/mathnet/mathnet-numerics
+// http://mathnetnumerics.codeplex.com
+// Copyright (c) 2009-2010 Math.NET
+// Permission is hereby granted, free of charge, to any person
+// obtaining a copy of this software and associated documentation
+// files (the "Software"), to deal in the Software without
+// restriction, including without limitation the rights to use,
+// copy, modify, merge, publish, distribute, sublicense, and/or sell
+// copies of the Software, and to permit persons to whom the
+// Software is furnished to do so, subject to the following
+// conditions:
+// The above copyright notice and this permission notice shall be
+// included in all copies or substantial portions of the Software.
+// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
+// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
+// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+// OTHER DEALINGS IN THE SOFTWARE.
+//
+
+namespace MathNet.Numerics.Distributions
+{
+ using System;
+ using System.Collections.Generic;
+ using Properties;
+
+ ///
+ /// The negative binomial is a distribution over the natural numbers with two parameters r,p. For the special
+ /// case that r is an integer one can interpret the distribution as the number of tails before the r'th head
+ /// when the probability of head is p.
+ /// Wikipedia - NegativeBinomial distribution .
+ ///
+ /// The distribution will use the
+ /// The statistics classes will check all the incoming parameters whether they are in the allowed
+ /// range. This might involve heavy computation. Optionally, by setting Control.CheckDistributionParameters
+ /// to false , all parameter checks can be turned off.
+ /// The r parameter of the distribution.
+ ///
+ private double _r;
+
+ ///
+ /// The p parameter of the distribution.
+ ///
+ private double _p;
+
+ ///
+ /// The distribution's random number generator.
+ ///
+ private Random _random;
+
+ ///
+ /// Gets or sets the r parameter.
+ ///
+ public double R
+ {
+ get
+ {
+ return _r;
+ }
+
+ set
+ {
+ SetParameters(value, _p);
+ }
+ }
+
+ ///
+ /// Gets or sets the p parameter.
+ ///
+ public double P
+ {
+ get
+ {
+ return _p;
+ }
+
+ set
+ {
+ SetParameters(_r, value);
+ }
+ }
+
+ ///
+ /// Initializes a new instance of the
+ ///
+ /// Sets the parameters of the distribution after checking their validity.
+ ///
+ /// When the parameters don't pass the
+ private void SetParameters(double r, double p)
+ {
+ if (Control.CheckDistributionParameters && !IsValidParameterSet(r, p))
+ {
+ throw new ArgumentOutOfRangeException(Resources.InvalidDistributionParameters);
+ }
+
+ _p = p;
+ _r = r;
+ }
+
+ ///
+ /// Checks whether the parameters of the distribution are valid.
+ ///
+ /// true when the parameters are valid, false otherwise.
+ /// Returns a
+ ///
+ /// A
+ public override string ToString()
+ {
+ return "NegativeBinomial(R = " + _r + ", P = " + _p + ")";
+ }
+
+ #region IDistribution Members
+
+ ///
+ /// Gets or sets the distribution's random number generator.
+ ///
+ public Random RandomSource
+ {
+ get
+ {
+ return _random;
+ }
+
+ set
+ {
+ if (value == null)
+ {
+ throw new ArgumentNullException();
+ }
+
+ _random = value;
+ }
+ }
+
+ ///
+ /// Gets the mean of the distribution.
+ ///
+ public double Mean
+ {
+ get
+ {
+ return _r * (1.0 - _p) / _p;
+ }
+ }
+
+ ///
+ /// Gets the variance of the distribution.
+ ///
+ public double Variance
+ {
+ get
+ {
+ return _r * (1.0 - _p) / (_p * _p);
+ }
+ }
+
+ ///
+ /// Gets the standard deviation of the distribution.
+ ///
+ public double StdDev
+ {
+ get
+ {
+ return Math.Sqrt(_r * (1.0 - _p)) / _p;
+ }
+ }
+
+ ///
+ /// Gets the entropy of the distribution.
+ ///
+ public double Entropy
+ {
+ get
+ {
+ throw new Exception("Not implemented yet.");
+ }
+ }
+
+ ///
+ /// Gets the skewness of the distribution.
+ ///
+ public double Skewness
+ {
+ get
+ {
+ return (2.0 - _p) / Math.Sqrt(_r * (1.0 - _p));
+ }
+ }
+
+ ///
+ /// Computes the cumulative distribution function of the NegativeBinomial distribution.
+ ///
+ /// the cumulative density at
+ public double CumulativeDistribution(double x)
+ {
+ throw new NotImplementedException();
+ }
+
+ #endregion
+
+ #region IDiscreteDistribution Members
+
+ ///
+ /// Gets the mode of the distribution
+ ///
+ public int Mode
+ {
+ get
+ {
+ return _r > 1.0 ? (int)Math.Floor((_r - 1.0) * (1.0 - _p) / _p) : 0;
+ }
+ }
+
+ ///
+ /// Gets the median of the distribution.
+ ///
+ public int Median
+ {
+ get
+ {
+ throw new Exception("Not implemented yet.");
+ }
+ }
+
+ ///
+ /// Gets the smallest element in the domain of the distributions which can be represented by an integer.
+ ///
+ public int Minimum
+ {
+ get
+ {
+ return 0;
+ }
+ }
+
+ ///
+ /// Gets the largest element in the domain of the distributions which can be represented by an integer.
+ ///
+ public int Maximum
+ {
+ get
+ {
+ throw new NotImplementedException();
+ }
+ }
+
+ ///
+ /// Computes values of the probability mass function.
+ ///
+ ///
+ /// the probability mass at location
+ public double Probability(int k)
+ {
+ var ln = SpecialFunctions.GammaLn(_r + k)
+ - SpecialFunctions.GammaLn(_r)
+ - SpecialFunctions.GammaLn(k + 1.0)
+ + (_r * Math.Log(_p))
+ + (k * Math.Log(1.0 - _p));
+ return Math.Exp(ln);
+ }
+
+ ///
+ /// Computes values of the log probability mass function.
+ ///
+ ///
+ /// the log probability mass at location
+ public double ProbabilityLn(int k)
+ {
+ var ln = SpecialFunctions.GammaLn(_r + k)
+ - SpecialFunctions.GammaLn(_r)
+ - SpecialFunctions.GammaLn(k + 1.0)
+ + (_r * Math.Log(_p))
+ + (k * Math.Log(1.0 - _p));
+ return ln;
+ }
+
+ ///
+ /// Samples a NegativeBinomial distributed random variable.
+ ///
+ /// a sample from the distribution.
+ public int Sample()
+ {
+ return DoSample(RandomSource, _r, _p);
+ }
+
+ ///
+ /// Samples an array of NegativeBinomial distributed random variables.
+ ///
+ /// a sequence of samples from the distribution.
+ public IEnumerable Samples()
+ {
+ while (true)
+ {
+ yield return DoSample(RandomSource, _r, _p);
+ }
+ }
+
+ #endregion
+
+ ///
+ /// Samples a negative binomial distributed random variable.
+ ///
+ /// a sample from the distribution.
+ private static int DoSample(Random rnd, double r, double p)
+ {
+ var lambda = Gamma.Sample(rnd, r, p);
+ return DoPoissonSample(rnd, lambda);
+ }
+
+ ///
+ /// Use Knuth's method to generate Poisson distributed random variables.
+ ///
+ /// a Poisson distributed random number.
+ private static int DoPoissonSample(Random rnd, double lambda)
+ {
+ var c = Math.Exp(-lambda);
+ var p = 1.0;
+ var k = 0;
+ do
+ {
+ k = k + 1;
+ p = p * rnd.NextDouble();
+ }
+ while (p >= c);
+ return k - 1;
+ }
+ }
+}
diff --git a/src/Numerics/Distributions/Discrete/Zipf.cs b/src/Numerics/Distributions/Discrete/Zipf.cs
new file mode 100644
index 00000000..54232f75
--- /dev/null
+++ b/src/Numerics/Distributions/Discrete/Zipf.cs
@@ -0,0 +1,387 @@
+//
+// Math.NET Numerics, part of the Math.NET Project
+// http://numerics.mathdotnet.com
+// http://github.com/mathnet/mathnet-numerics
+// http://mathnetnumerics.codeplex.com
+// Copyright (c) 2009-2010 Math.NET
+// Permission is hereby granted, free of charge, to any person
+// obtaining a copy of this software and associated documentation
+// files (the "Software"), to deal in the Software without
+// restriction, including without limitation the rights to use,
+// copy, modify, merge, publish, distribute, sublicense, and/or sell
+// copies of the Software, and to permit persons to whom the
+// Software is furnished to do so, subject to the following
+// conditions:
+// The above copyright notice and this permission notice shall be
+// included in all copies or substantial portions of the Software.
+// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
+// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
+// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+// OTHER DEALINGS IN THE SOFTWARE.
+//
+
+namespace MathNet.Numerics.Distributions
+{
+ using System;
+ using System.Collections.Generic;
+ using Properties;
+
+ ///
+ /// Zipf's law, an empirical law formulated using mathematical statistics, refers to the fact
+ /// that many types of data studied in the physical and social sciences can be approximated with
+ /// a Zipfian distribution, one of a family of related discrete power law probability distributions.
+ /// For details about this distribution, see
+ /// Wikipedia - Zipf distribution .
+ ///
+ /// The distribution will use the
+ /// The statistics classes will check all the incoming parameters whether they are in the allowed
+ /// range. This might involve heavy computation. Optionally, by setting Control.CheckDistributionParameters
+ /// to false , all parameter checks can be turned off.
+ /// The s parameter of the distribution.
+ ///
+ private double _s;
+
+ ///
+ /// The n parameter of the distribution.
+ ///
+ private int _n;
+
+ ///
+ /// The distribution's random number generator.
+ ///
+ private Random _random;
+
+ ///
+ /// Initializes a new instance of the
+ ///
+ /// Sets the parameters of the distribution after checking their validity.
+ ///
+ ///
+ /// Checks whether the parameters of the distribution are valid.
+ ///
+ /// true when the parameters are valid, false otherwise.
+ /// Gets or sets the s parameter of the distribution.
+ ///
+ public double S
+ {
+ get
+ {
+ return _s;
+ }
+
+ set
+ {
+ SetParameters(value, _n);
+ }
+ }
+
+ ///
+ /// Gets or sets the n parameter of the distribution.
+ ///
+ public int N
+ {
+ get
+ {
+ return _n;
+ }
+
+ set
+ {
+ SetParameters(_s, value);
+ }
+ }
+
+ ///
+ /// A string representation of the distribution.
+ ///
+ /// a string representation of the distribution.
+ public override string ToString()
+ {
+ return "Zipf(S = " + _s + ", N = " + _n + ")";
+ }
+
+ #region IDistribution Members
+
+ ///
+ /// Gets or sets the random number generator which is used to draw random samples.
+ ///
+ public Random RandomSource
+ {
+ get
+ {
+ return _random;
+ }
+
+ set
+ {
+ if (value == null)
+ {
+ throw new ArgumentNullException();
+ }
+
+ _random = value;
+ }
+ }
+
+ ///
+ /// Gets the mean of the distribution.
+ ///
+ public double Mean
+ {
+ get
+ {
+ return SpecialFunctions.GeneralHarmonic(_n, _s - 1.0) / SpecialFunctions.GeneralHarmonic(_n, _s);
+ }
+ }
+
+ ///
+ /// Gets the variance of the distribution.
+ ///
+ public double Variance
+ {
+ get
+ {
+ if (_s <= 3)
+ {
+ throw new NotSupportedException();
+ }
+
+ var generalHarmonicsNS = SpecialFunctions.GeneralHarmonic(_n, _s);
+ return (SpecialFunctions.GeneralHarmonic(_n, _s - 2) * SpecialFunctions.GeneralHarmonic(_n, _s)) - (Math.Pow(SpecialFunctions.GeneralHarmonic(_n, _s - 1), 2) / (generalHarmonicsNS * generalHarmonicsNS));
+ }
+ }
+
+ ///
+ /// Gets the standard deviation of the distribution.
+ ///
+ public double StdDev
+ {
+ get
+ {
+ return Math.Sqrt(Variance);
+ }
+ }
+
+ ///
+ /// Gets the entropy of the distribution.
+ ///
+ public double Entropy
+ {
+ get
+ {
+ double sum = 0;
+ for (var i = 0; i < _n; i++)
+ {
+ sum += Math.Log(i + 1) / Math.Pow(i + 1, _s);
+ }
+
+ return ((_s / SpecialFunctions.GeneralHarmonic(_n, _s)) * sum) + Math.Log(SpecialFunctions.GeneralHarmonic(_n, _s));
+ }
+ }
+
+ ///
+ /// Gets the skewness of the distribution.
+ ///
+ public double Skewness
+ {
+ get
+ {
+ if (_s <= 4)
+ {
+ throw new NotSupportedException();
+ }
+
+ return (SpecialFunctions.GeneralHarmonic(_n, _s - 3) * Math.Pow(SpecialFunctions.GeneralHarmonic(_n, _s), 2) - SpecialFunctions.GeneralHarmonic(_n, _s - 1) * (3 * SpecialFunctions.GeneralHarmonic(_n, _s - 2) * SpecialFunctions.GeneralHarmonic(_n, _s) - Math.Pow(SpecialFunctions.GeneralHarmonic(_n, _s - 1), 2))) / Math.Pow(SpecialFunctions.GeneralHarmonic(_n, _s - 2) * SpecialFunctions.GeneralHarmonic(_n, _s) - Math.Pow(SpecialFunctions.GeneralHarmonic(_n, _s - 1), 2), 1.5);
+ }
+ }
+
+ ///
+ /// Computes the cumulative distribution function of the distribution.
+ ///
+ /// the cumulative density at
+ public double CumulativeDistribution(double x)
+ {
+ if (x <= 1)
+ {
+ return 0.0;
+ }
+
+ var sum = 0.0;
+ var k = (int)Math.Ceiling(x) - 1;
+ for (var i = 0; i < k; i++)
+ {
+ sum += Math.Pow(i + 1, -_s);
+ }
+
+ return sum / SpecialFunctions.GeneralHarmonic(_n, _s);
+ }
+
+ #endregion
+
+ #region IDiscreteDistribution Members
+
+ ///
+ /// Gets the mode of the distribution.
+ ///
+ public int Mode
+ {
+ get
+ {
+ return 1;
+ }
+ }
+
+ ///
+ /// Gets the median of the distribution.
+ ///
+ public int Median
+ {
+ get
+ {
+ throw new NotImplementedException();
+ }
+ }
+
+ ///
+ /// Gets the smallest element in the domain of the distributions which can be represented by an integer.
+ ///
+ public int Minimum
+ {
+ get
+ {
+ return 1;
+ }
+ }
+
+ ///
+ /// Gets the largest element in the domain of the distributions which can be represented by an integer.
+ ///
+ public int Maximum
+ {
+ get
+ {
+ return _n;
+ }
+ }
+
+ ///
+ /// Computes values of the probability mass function.
+ ///
+ ///
+ /// the probability mass at location
+ public double Probability(int k)
+ {
+ return (1.0 / Math.Pow(k, _s)) / SpecialFunctions.GeneralHarmonic(_n, _s);
+ }
+
+ ///
+ /// Computes values of the log probability mass function.
+ ///
+ ///
+ /// the log probability mass at location
+ public double ProbabilityLn(int k)
+ {
+ return Math.Log(Probability(k));
+ }
+
+ ///
+ /// Draws a random sample from the distribution.
+ ///
+ /// a sample from the distribution.
+ public int Sample()
+ {
+ return DoSample(RandomSource, _s, _n);
+ }
+
+ ///
+ /// Samples an array of zipf distributed random variables.
+ ///
+ /// a sequence of samples from the distribution.
+ public IEnumerable Samples()
+ {
+ while (true)
+ {
+ yield return DoSample(RandomSource, _s, _n);
+ }
+ }
+
+ #endregion
+
+ ///
+ /// Generates a sample from the Zipf distribution without doing parameter checking.
+ ///
+ /// a random number from the Zipf distribution.
+ private static int DoSample(Random rnd, double s, int n)
+ {
+ var r = rnd.NextDouble();
+ var x = 1;
+ var p = 1.0 / SpecialFunctions.GeneralHarmonic(n, s);
+ do
+ {
+ r -= p;
+ if (r >= 0)
+ {
+ x++;
+ p = p / Math.Pow((double)(x - 1) / x, s - 1);
+ }
+ }
+ while (r >= 0);
+ return x;
+ }
+ }
+}
diff --git a/src/Numerics/Distributions/Multivariate/Dirichlet.cs b/src/Numerics/Distributions/Multivariate/Dirichlet.cs
index b63b1493..7b468e45 100644
--- a/src/Numerics/Distributions/Multivariate/Dirichlet.cs
+++ b/src/Numerics/Distributions/Multivariate/Dirichlet.cs
@@ -3,9 +3,7 @@
// http://numerics.mathdotnet.com
// http://github.com/mathnet/mathnet-numerics
// http://mathnetnumerics.codeplex.com
-//
// Copyright (c) 2009-2010 Math.NET
-//
// Permission is hereby granted, free of charge, to any person
// obtaining a copy of this software and associated documentation
// files (the "Software"), to deal in the Software without
@@ -14,10 +12,8 @@
// copies of the Software, and to permit persons to whom the
// Software is furnished to do so, subject to the following
// conditions:
-//
// The above copyright notice and this permission notice shall be
// included in all copies or substantial portions of the Software.
-//
// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
@@ -31,6 +27,7 @@
namespace MathNet.Numerics.Distributions
{
using System;
+ using System.Linq;
using Properties;
///
@@ -41,10 +38,12 @@ namespace MathNet.Numerics.Distributions
/// Users can get/set the random number generator by using the The statistics classes will check all the incoming parameters whether they are in the allowed
/// range. This might involve heavy computation. Optionally, by setting Control.CheckDistributionParameters
- /// to false, all parameter checks can be turned off.
+ /// to false , all parameter checks can be turned off.
public class Dirichlet
{
- // The Dirichlet distribution parameters.
+ ///
+ /// The Dirichlet distribution parameters.
+ ///
private double[] _alpha;
///
@@ -64,16 +63,21 @@ namespace MathNet.Numerics.Distributions
}
///
- /// Constructs a new symmetric Dirichlet distribution. The distribution will
- /// be initialized with the default
- ///
- /// Checks whether the parameters of the distribution are valid: no parameter can be less than zero and
- /// at least one parameter should be larger than zero.
+ /// Checks whether the parameters of the distribution are valid: no
+ /// parameter can be less than zero and at least one parameter should be
+ /// larger than zero.
///
- /// True when the parameters are valid, false otherwise.
+ /// true when the parameters are valid, false
+ /// otherwise.
@@ -124,15 +127,18 @@ namespace MathNet.Numerics.Distributions
throw new ArgumentOutOfRangeException(Resources.InvalidDistributionParameters);
}
- _alpha = (double[]) alpha.Clone();
+ _alpha = (double[])alpha.Clone();
}
///
- /// A string representation of the distribution.
+ /// Returns a
+ ///
+ /// A
public override string ToString()
{
- return "Dirichlet(Dimension = " + this.Dimension + ")";
+ return "Dirichlet(Dimension = " + Dimension + ")";
}
///
@@ -140,7 +146,10 @@ namespace MathNet.Numerics.Distributions
///
public int Dimension
{
- get { return _alpha.Length; }
+ get
+ {
+ return _alpha.Length;
+ }
}
///
@@ -152,6 +161,7 @@ namespace MathNet.Numerics.Distributions
{
return _alpha;
}
+
set
{
SetParameters(value);
@@ -159,18 +169,13 @@ namespace MathNet.Numerics.Distributions
}
///
- /// The sum of the Dirichlet parameters.
+ /// Gets the sum of the Dirichlet parameters.
///
private double AlphaSum
{
get
{
- double s = 0.0;
- for (int i = 0; i < _alpha.Length; i++)
- {
- s += _alpha[i];
- }
- return s;
+ return _alpha.Sum();
}
}
@@ -181,9 +186,9 @@ namespace MathNet.Numerics.Distributions
{
get
{
- double sum = AlphaSum;
- double[] parm = new double[Dimension];
- for (int i = 0; i < Dimension; i++)
+ var sum = AlphaSum;
+ var parm = new double[Dimension];
+ for (var i = 0; i < Dimension; i++)
{
parm[i] = _alpha[i] / sum;
}
@@ -199,12 +204,13 @@ namespace MathNet.Numerics.Distributions
{
get
{
- double s = this.AlphaSum;
- double[] v = new double[_alpha.Length];
- for (int i = 0; i < _alpha.Length; i++)
+ var s = AlphaSum;
+ var v = new double[_alpha.Length];
+ for (var i = 0; i < _alpha.Length; i++)
{
- v[i] = _alpha[i]*(s - _alpha[i])/(s*s*(s + 1.0));
+ v[i] = _alpha[i] * (s - _alpha[i]) / (s * s * (s + 1.0));
}
+
return v;
}
}
@@ -233,6 +239,7 @@ namespace MathNet.Numerics.Distributions
///
/// Samples a Dirichlet distributed random vector.
///
+ /// A sample from this distribution.
public double[] Sample()
{
return Sample(RandomSource, _alpha);
@@ -243,17 +250,18 @@ namespace MathNet.Numerics.Distributions
///
/// a sample from the distribution.
+ public static double[] Sample(Random rnd, double[] alpha)
{
if (Control.CheckDistributionParameters && ! IsValidParameterSet(alpha))
{
throw new ArgumentOutOfRangeException(Resources.InvalidDistributionParameters);
}
- int n = alpha.Length;
- double[] gv = new double[n];
- double sum = 0.0;
- for (int i = 0; i < n; i++)
+ var n = alpha.Length;
+ var gv = new double[n];
+ var sum = 0.0;
+ for (var i = 0; i < n; i++)
{
if (alpha[i] == 0.0)
{
@@ -267,7 +275,7 @@ namespace MathNet.Numerics.Distributions
sum += gv[i];
}
- for (int i = 0; i < n; i++)
+ for (var i = 0; i < n; i++)
{
gv[i] /= sum;
}
@@ -275,4 +283,4 @@ namespace MathNet.Numerics.Distributions
return gv;
}
}
-}
\ No newline at end of file
+}
diff --git a/src/Numerics/Distributions/Multivariate/InverseWishart.cs b/src/Numerics/Distributions/Multivariate/InverseWishart.cs
new file mode 100644
index 00000000..2fa00128
--- /dev/null
+++ b/src/Numerics/Distributions/Multivariate/InverseWishart.cs
@@ -0,0 +1,265 @@
+//
+// Math.NET Numerics, part of the Math.NET Project
+// http://numerics.mathdotnet.com
+// http://github.com/mathnet/mathnet-numerics
+// http://mathnetnumerics.codeplex.com
+// Copyright (c) 2009-2010 Math.NET
+// Permission is hereby granted, free of charge, to any person
+// obtaining a copy of this software and associated documentation
+// files (the "Software"), to deal in the Software without
+// restriction, including without limitation the rights to use,
+// copy, modify, merge, publish, distribute, sublicense, and/or sell
+// copies of the Software, and to permit persons to whom the
+// Software is furnished to do so, subject to the following
+// conditions:
+// The above copyright notice and this permission notice shall be
+// included in all copies or substantial portions of the Software.
+// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
+// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
+// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+// OTHER DEALINGS IN THE SOFTWARE.
+//
+
+namespace MathNet.Numerics.Distributions
+{
+ using System;
+ using LinearAlgebra.Generic;
+ using LinearAlgebra.Generic.Factorization;
+ using Properties;
+
+ ///
+ /// This class implements functionality for the inverse Wishart distribution. This distribution is
+ /// parameterized by the degrees of freedom nu and the scale matrix S. The inverse Wishart distribution
+ /// is the conjugate prior for the covariance matrix of a multivariate normal distribution.
+ /// Wikipedia - Inverse-Wishart distribution .
+ ///
+ /// The distribution will use the
+ /// The statistics classes will check all the incoming parameters whether they are in the allowed
+ /// range. This might involve heavy computation. Optionally, by setting Control.CheckDistributionParameters
+ /// to false , all parameter checks can be turned off.
+ /// The degrees of freedom for the inverse Wishart distribution.
+ ///
+ private double _nu;
+
+ ///
+ /// The scale matrix for the inverse Wishart distribution.
+ ///
+ private Matrix _s;
+
+ ///
+ /// Caches the Cholesky factorization of the scale matrix.
+ ///
+ private Cholesky _chol;
+
+ ///
+ /// The distribution's random number generator.
+ ///
+ private Random _random;
+
+ ///
+ /// Initializes a new instance of the
+ /// s)
+ {
+ SetParameters(nu, s);
+ RandomSource = new Random();
+ }
+
+ ///
+ /// A string representation of the distribution.
+ ///
+ /// a string representation of the distribution.
+ public override string ToString()
+ {
+ return "InverseWishart(Nu = " + _nu + ", Rows = " + _s.RowCount + ", Columns = " + _s.ColumnCount + ")";
+ }
+
+ ///
+ /// Sets the parameters of the distribution after checking their validity.
+ ///
+ /// When the parameters don't pass the
+ private void SetParameters(double nu, Matrix s)
+ {
+ if (Control.CheckDistributionParameters && !IsValidParameterSet(nu, s))
+ {
+ throw new ArgumentOutOfRangeException(Resources.InvalidDistributionParameters);
+ }
+
+ _nu = nu;
+ _s = s;
+ _chol = Cholesky.Create(_s);
+ }
+
+ ///
+ /// Checks whether the parameters of the distribution are valid.
+ ///
+ /// true when the parameters are valid, false otherwise. s)
+ {
+ if (s.RowCount != s.ColumnCount)
+ {
+ return false;
+ }
+
+ for (var i = 0; i < s.RowCount; i++)
+ {
+ if (s[i, i] <= 0.0)
+ {
+ return false;
+ }
+ }
+
+ if (nu <= 0.0 || Double.IsNaN(nu))
+ {
+ return false;
+ }
+
+ return true;
+ }
+
+ ///
+ /// Gets or sets the degrees of freedom for the inverse Wishart distribution.
+ ///
+ public double Nu
+ {
+ get
+ {
+ return _nu;
+ }
+
+ set
+ {
+ SetParameters(value, _s);
+ }
+ }
+
+ ///
+ /// Gets or sets the scale matrix for the inverse Wishart distribution.
+ ///
+ public Matrix S
+ {
+ get
+ {
+ return _s;
+ }
+
+ set
+ {
+ SetParameters(_nu, value);
+ }
+ }
+
+ ///
+ /// Gets or sets the random number generator which is used to draw random samples.
+ ///
+ public Random RandomSource
+ {
+ get
+ {
+ return _random;
+ }
+
+ set
+ {
+ if (value == null)
+ {
+ throw new ArgumentNullException();
+ }
+
+ _random = value;
+ }
+ }
+
+ ///
+ /// Gets the mean.
+ ///
+ /// The mean of the distribution.
+ public Matrix Mean
+ {
+ get
+ {
+ return _s * (1.0 / (_nu - _s.RowCount - 1.0));
+ }
+ }
+
+ ///
+ /// Evaluates the probability density function for the inverse Wishart distribution.
+ ///
+ /// If the argument does not have the same dimensions as the scale matrix.
+ /// the density at
+ public double Density(Matrix x)
+ {
+ var p = _s.RowCount;
+
+ if (x.RowCount != p || x.ColumnCount != p)
+ {
+ throw new ArgumentOutOfRangeException("x", Resources.ArgumentMatrixDimensions);
+ }
+
+ var chol = Cholesky.Create(x);
+ var dX = chol.Determinant;
+ var sXi = chol.Solve(S);
+
+ // Compute the multivariate Gamma function.
+ var gp = Math.Pow(Constants.Pi, p * (p - 1.0) / 4.0);
+ for (var j = 1; j <= p; j++)
+ {
+ gp *= SpecialFunctions.Gamma((_nu + 1.0 - j) / 2.0);
+ }
+
+ return Math.Pow(dX, -(_nu + p + 1.0) / 2.0)
+ * Math.Exp(-0.5 * sXi.Trace())
+ * Math.Pow(_chol.Determinant, _nu / 2.0)
+ / Math.Pow(2.0, _nu * p / 2.0)
+ / gp;
+ }
+
+ ///
+ /// Samples an inverse Wishart distributed random variable by sampling
+ /// a Wishart random variable and inverting the matrix.
+ ///
+ /// a sample from the distribution.
+ public Matrix Sample()
+ {
+ return Sample(RandomSource, _nu, _s);
+ }
+
+ ///
+ /// Samples an inverse Wishart distributed random variable by sampling
+ /// a Wishart random variable and inverting the matrix.
+ ///
+ /// a sample from the distribution.
+ public static Matrix Sample(Random rnd, double nu, Matrix s)
+ {
+ if (Control.CheckDistributionParameters && !IsValidParameterSet(nu, s))
+ {
+ throw new ArgumentOutOfRangeException(Resources.InvalidDistributionParameters);
+ }
+
+ var r = Wishart.Sample(rnd, nu, s.Inverse());
+ return r.Inverse();
+ }
+ }
+}
diff --git a/src/Numerics/Distributions/Multivariate/MatrixNormal.cs b/src/Numerics/Distributions/Multivariate/MatrixNormal.cs
new file mode 100644
index 00000000..638fc761
--- /dev/null
+++ b/src/Numerics/Distributions/Multivariate/MatrixNormal.cs
@@ -0,0 +1,341 @@
+//
+// Math.NET Numerics, part of the Math.NET Project
+// http://numerics.mathdotnet.com
+// http://github.com/mathnet/mathnet-numerics
+// http://mathnetnumerics.codeplex.com
+// Copyright (c) 2009-2010 Math.NET
+// Permission is hereby granted, free of charge, to any person
+// obtaining a copy of this software and associated documentation
+// files (the "Software"), to deal in the Software without
+// restriction, including without limitation the rights to use,
+// copy, modify, merge, publish, distribute, sublicense, and/or sell
+// copies of the Software, and to permit persons to whom the
+// Software is furnished to do so, subject to the following
+// conditions:
+// The above copyright notice and this permission notice shall be
+// included in all copies or substantial portions of the Software.
+// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
+// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
+// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+// OTHER DEALINGS IN THE SOFTWARE.
+//
+
+namespace MathNet.Numerics.Distributions
+{
+ using System;
+ using LinearAlgebra.Double;
+ using LinearAlgebra.Generic;
+ using LinearAlgebra.Generic.Factorization;
+ using Properties;
+
+ ///
+ /// This class implements functionality for matrix valued normal distributions. The distribution
+ /// is parameterized by a mean matrix (M), a covariance matrix for the rows (V) and a covariance matrix
+ /// for the columns (K). If the dimension of M is d-by-m then V is d-by-d and K is m-by-m.
+ /// Wikipedia - MatrixNormal distribution .
+ ///
+ /// The distribution will use the
+ /// The statistics classes will check all the incoming parameters whether they are in the allowed
+ /// range. This might involve heavy computation. Optionally, by setting Control.CheckDistributionParameters
+ /// to false , all parameter checks can be turned off.
+ /// The mean of the matrix normal distribution.
+ ///
+ private Matrix _m;
+
+ ///
+ /// The covariance matrix for the rows.
+ ///
+ private Matrix _v;
+
+ ///
+ /// The covariance matrix for the columns.
+ ///
+ private Matrix _k;
+
+ ///
+ /// The distribution's random number generator.
+ ///
+ private Random _random;
+
+ ///
+ /// Initializes a new instance of the
+ ///
+ /// If the dimensions of the mean and two covariance matrices don't match.
+ ///
+ public MatrixNormal(Matrix m, Matrix v, Matrix k)
+ {
+ SetParameters(m, v, k);
+ RandomSource = new Random();
+ }
+
+ ///
+ /// Returns a
+ ///
+ /// A
+ public override string ToString()
+ {
+ return "MatrixNormal(Rows = " + _m.RowCount + ", Columns = " + _m.ColumnCount + ")";
+ }
+
+ ///
+ /// Gets or sets the mean. (M)
+ ///
+ /// The mean of the distribution.
+ public Matrix Mean
+ {
+ get
+ {
+ return _m;
+ }
+
+ set
+ {
+ SetParameters(value, _v, _k);
+ }
+ }
+
+ ///
+ /// Gets or sets the row covariance. (V)
+ ///
+ /// The row covariance.
+ public Matrix RowCovariance
+ {
+ get
+ {
+ return _v;
+ }
+
+ set
+ {
+ SetParameters(_m, value, _k);
+ }
+ }
+
+ ///
+ /// Gets or sets the column covariance. (K)
+ ///
+ /// The column covariance.
+ public Matrix ColumnCovariance
+ {
+ get
+ {
+ return _k;
+ }
+
+ set
+ {
+ SetParameters(_m, _v, value);
+ }
+ }
+
+ ///
+ /// Sets the parameters of the distribution after checking their validity.
+ ///
+ /// When the parameters don't pass the
+ private void SetParameters(Matrix m, Matrix v, Matrix k)
+ {
+ if (Control.CheckDistributionParameters && !IsValidParameterSet(m, v, k))
+ {
+ throw new ArgumentOutOfRangeException(Resources.InvalidDistributionParameters);
+ }
+
+ _m = m;
+ _v = v;
+ _k = k;
+ }
+
+ ///
+ /// Checks whether the parameters of the distribution are valid.
+ ///
+ /// true when the parameters are valid, false otherwise. m, Matrix v, Matrix k)
+ {
+ var n = m.RowCount;
+ var p = m.ColumnCount;
+ if (v.ColumnCount != n || v.RowCount != n)
+ {
+ return false;
+ }
+
+ if (k.ColumnCount != p || k.RowCount != p)
+ {
+ return false;
+ }
+
+ for (var i = 0; i < v.RowCount; i++)
+ {
+ if (v[i, i] <= 0)
+ {
+ return false;
+ }
+ }
+
+ for (var i = 0; i < k.RowCount; i++)
+ {
+ if (k[i, i] <= 0)
+ {
+ return false;
+ }
+ }
+
+ return true;
+ }
+
+ ///
+ /// Gets or sets the random number generator which is used to draw random samples.
+ ///
+ public Random RandomSource
+ {
+ get
+ {
+ return _random;
+ }
+
+ set
+ {
+ if (value == null)
+ {
+ throw new ArgumentNullException();
+ }
+
+ _random = value;
+ }
+ }
+
+ ///
+ /// Evaluates the probability density function for the matrix normal distribution.
+ ///
+ /// the density at
+ /// If the argument does not have the correct dimensions.
+ public double Density(Matrix x)
+ {
+ if (x.RowCount != _m.RowCount || x.ColumnCount != _m.ColumnCount)
+ {
+ throw new ArgumentOutOfRangeException("x", Resources.ArgumentMatrixDimensions);
+ }
+
+ var a = x - _m;
+ var cholV = Cholesky.Create(_v);
+ var cholK = Cholesky.Create(_k);
+
+ return Math.Exp(-0.5 * cholV.Solve(a.Transpose() * cholK.Solve(a)).Trace())
+ / Math.Pow(2.0 * Constants.Pi, x.RowCount * x.ColumnCount / 2.0)
+ / Math.Pow(cholV.Determinant, x.RowCount / 2.0)
+ / Math.Pow(cholK.Determinant, x.ColumnCount / 2.0);
+ }
+
+ ///
+ /// Samples a matrix normal distributed random variable.
+ ///
+ /// A random number from this distribution.
+ public Matrix Sample()
+ {
+ return Sample(RandomSource, _m, _v, _k);
+ }
+
+ ///
+ /// Samples a matrix normal distributed random variable.
+ ///
+ /// If the dimensions of the mean and two covariance matrices don't match.
+ /// a sequence of samples from the distribution.
+ public static Matrix Sample(Random rnd, Matrix m, Matrix v, Matrix k)
+ {
+ if (Control.CheckDistributionParameters && !IsValidParameterSet(m, v, k))
+ {
+ throw new ArgumentOutOfRangeException(Resources.InvalidDistributionParameters);
+ }
+
+ var n = m.RowCount;
+ var p = m.ColumnCount;
+
+ // Compute the Kronecker product of V and K, this is the covariance matrix for the stacked matrix.
+ var vki = v.KroneckerProduct(k.Inverse());
+
+ // Sample a vector valued random variable with VKi as the covariance.
+ var vector = SampleVectorNormal(rnd, new DenseVector(n * n, 0.0), vki);
+
+ // Unstack the vector v and add the mean.
+ var r = m.Clone();
+ for (var i = 0; i < n; i++)
+ {
+ for (var j = 0; j < p; j++)
+ {
+ r[i, j] += vector[(j * n) + i];
+ }
+ }
+
+ return r;
+ }
+
+ ///
+ /// Samples a vector normal distributed random variable.
+ ///
+ /// a sequence of samples from defined distribution.
+ private static Vector SampleVectorNormal(Random rnd, Vector mean, Matrix covariance)
+ {
+ var chol = Cholesky.Create(covariance);
+ return SampleVectorNormal(rnd, mean, chol);
+ }
+
+ ///
+ /// Samples a vector normal distributed random variable.
+ ///
+ /// a sequence of samples from defined distribution.
+ private static Vector SampleVectorNormal(Random rnd, Vector mean, Cholesky cholesky)
+ {
+ var count = mean.Count;
+
+ // Sample a standard normal variable.
+ var v = new DenseVector(count, 0.0);
+ for (var d = 0; d < count; d += 2)
+ {
+ var sample = Normal.SampleBoxMuller(rnd);
+ v[d] = sample.Item1;
+ if (d + 1 < count)
+ {
+ v[d + 1] = sample.Item2;
+ }
+ }
+
+ // Return the transformed variable.
+ return mean + (cholesky.Factor * v);
+ }
+ }
+}
diff --git a/src/Numerics/Distributions/Multivariate/Multinomial.cs b/src/Numerics/Distributions/Multivariate/Multinomial.cs
index 00f95a54..73d3a934 100644
--- a/src/Numerics/Distributions/Multivariate/Multinomial.cs
+++ b/src/Numerics/Distributions/Multivariate/Multinomial.cs
@@ -3,9 +3,7 @@
// http://numerics.mathdotnet.com
// http://github.com/mathnet/mathnet-numerics
// http://mathnetnumerics.codeplex.com
-//
// Copyright (c) 2009-2010 Math.NET
-//
// Permission is hereby granted, free of charge, to any person
// obtaining a copy of this software and associated documentation
// files (the "Software"), to deal in the Software without
@@ -14,10 +12,8 @@
// copies of the Software, and to permit persons to whom the
// Software is furnished to do so, subject to the following
// conditions:
-//
// The above copyright notice and this permission notice shall be
// included in all copies or substantial portions of the Software.
-//
// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
@@ -34,7 +30,6 @@ namespace MathNet.Numerics.Distributions
using System.Collections.Generic;
using Properties;
-
///
/// Implements the multinomial distribution. For details about this distribution, see
/// Wikipedia - Multinomial distribution .
@@ -46,7 +41,7 @@ namespace MathNet.Numerics.Distributions
/// Users can set the random number generator by using the The statistics classes will check all the incoming parameters whether they are in the allowed
/// range. This might involve heavy computation. Optionally, by setting Control.CheckDistributionParameters
- /// to false, all parameter checks can be turned off.
+ /// to false , all parameter checks can be turned off.
public class Multinomial
{
///
@@ -75,7 +70,7 @@ namespace MathNet.Numerics.Distributions
public Multinomial(double[] p, int n)
{
SetParameters(p, n);
- RandomSource = new System.Random();
+ RandomSource = new Random();
}
/* TODO
@@ -100,6 +95,7 @@ namespace MathNet.Numerics.Distributions
///
/// A string representation of the distribution.
///
+ /// a string representation of the distribution.
public override string ToString()
{
return "Multinomial(Dimension = " + _p.Length + ", Number of Trails = " + _n + ")";
@@ -111,34 +107,27 @@ namespace MathNet.Numerics.Distributions
/// If any of the probabilities are negative returns false,
- /// if the sum of parameters is 0.0, or if the number of trials is negative; otherwise true
- private static bool IsValidParameterSet(double[] p, int n)
+ /// If any of the probabilities are negative returns false ,
+ /// if the sum of parameters is 0.0, or if the number of trials is negative; otherwise true .
+ private static bool IsValidParameterSet(IEnumerable p, int n)
{
- double sum = 0.0;
- for (int i = 0; i < p.Length; i++)
+ var sum = 0.0;
+ foreach (var t in p)
{
- if (p[i] < 0.0 || Double.IsNaN(p[i]))
+ if (t < 0.0 || Double.IsNaN(t))
{
return false;
}
- else
- {
- sum += p[i];
- }
- }
- if (sum == 0.0)
- {
- return false;
+ sum += t;
}
- if (n < 0)
+ if (sum == 0.0)
{
return false;
}
- return true;
+ return n >= 0;
}
///
@@ -166,7 +155,7 @@ namespace MathNet.Numerics.Distributions
{
get
{
- return (double[]) _p.Clone();
+ return (double[])_p.Clone();
}
set
@@ -241,7 +230,7 @@ namespace MathNet.Numerics.Distributions
/// as this is often impossible using floating point arithmetic.
/// the counts for each of the different possible values.
- public static int[] Sample(System.Random rnd, double[] p, int n)
+ public static int[] Sample(Random rnd, double[] p, int n)
{
if (Control.CheckDistributionParameters && !IsValidParameterSet(p, n))
{
@@ -249,11 +238,12 @@ namespace MathNet.Numerics.Distributions
}
// The cumulative density of p.
- double[] cp = Categorical.UnnormalizedCDF(p);
- // The variable that stores the counts.
- int[] ret = new int[p.Length];
+ var cp = Categorical.UnnormalizedCdf(p);
+
+// The variable that stores the counts.
+ var ret = new int[p.Length];
- for (int i = 0; i < n; i++)
+ for (var i = 0; i < n; i++)
{
ret[Categorical.DoSample(rnd, cp)]++;
}
@@ -269,7 +259,7 @@ namespace MathNet.Numerics.Distributions
/// as this is often impossible using floating point arithmetic.
/// a sequence of counts for each of the different possible values.
- public static IEnumerable Samples(System.Random rnd, double[] p, int n)
+ public static IEnumerable Samples(Random rnd, double[] p, int n)
{
if (Control.CheckDistributionParameters && !IsValidParameterSet(p, n))
{
@@ -277,14 +267,14 @@ namespace MathNet.Numerics.Distributions
}
// The cumulative density of p.
- double[] cp = Categorical.UnnormalizedCDF(p);
+ var cp = Categorical.UnnormalizedCdf(p);
while (true)
{
// The variable that stores the counts.
- int[] ret = new int[p.Length];
+ var ret = new int[p.Length];
- for (int i = 0; i < n; i++)
+ for (var i = 0; i < n; i++)
{
ret[Categorical.DoSample(rnd, cp)]++;
}
@@ -293,4 +283,4 @@ namespace MathNet.Numerics.Distributions
}
}
}
-}
\ No newline at end of file
+}
diff --git a/src/Numerics/Distributions/Multivariate/NormalGamma.cs b/src/Numerics/Distributions/Multivariate/NormalGamma.cs
index 4c40ddc0..46a9585a 100644
--- a/src/Numerics/Distributions/Multivariate/NormalGamma.cs
+++ b/src/Numerics/Distributions/Multivariate/NormalGamma.cs
@@ -3,9 +3,7 @@
// http://numerics.mathdotnet.com
// http://github.com/mathnet/mathnet-numerics
// http://mathnetnumerics.codeplex.com
-//
// Copyright (c) 2009-2010 Math.NET
-//
// Permission is hereby granted, free of charge, to any person
// obtaining a copy of this software and associated documentation
// files (the "Software"), to deal in the Software without
@@ -14,10 +12,8 @@
// copies of the Software, and to permit persons to whom the
// Software is furnished to do so, subject to the following
// conditions:
-//
// The above copyright notice and this permission notice shall be
// included in all copies or substantial portions of the Software.
-//
// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
@@ -40,36 +36,61 @@ namespace MathNet.Numerics.Distributions
///
public struct MeanPrecisionPair
{
- private double mMean;
- private double mPrecision;
+ ///
+ /// The mean value.
+ ///
+ private double _mean;
+
+ ///
+ /// The precision value.
+ ///
+ private double _precision;
///
- /// Constructs a new mean precision pair.
+ /// Initializes a new instance of the
- ///
- /// Gets/sets the mean of the pair.
+ /// Gets or sets the mean of the pair.
///
public double Mean
{
- get { return mMean; }
- set { mMean = value; }
+ get
+ {
+ return _mean;
+ }
+
+ set
+ {
+ _mean = value;
+ }
}
///
- /// Gets/sets the precision of the pair.
+ /// Gets or sets the precision of the pair.
///
public double Precision
{
- get { return mPrecision; }
- set { mPrecision = value; }
+ get
+ {
+ return _precision;
+ }
+
+ set
+ {
+ _precision = value;
+ }
}
}
@@ -84,11 +105,11 @@ namespace MathNet.Numerics.Distributions
/// infinity. When the mean is known, the mean location will encode the value of the mean while the scale
/// will be positive infinity. A completely degenerate NormalGamma distribution with known mean and precision is possible as well.
///
- /// The distribution will use the The distribution will use the
/// The statistics classes will check all the incoming parameters whether they are in the allowed
/// range. This might involve heavy computation. Optionally, by setting Control.CheckDistributionParameters
- /// to false, all parameter checks can be turned off. false , all parameter checks can be turned off.
public class NormalGamma
{
///
@@ -117,18 +138,26 @@ namespace MathNet.Numerics.Distributions
private Random _random;
///
- /// Constructs a NormalGamma distribution.
+ /// Initializes a new instance of the
- ///
/// Checks whether the parameters of the distribution are valid.
///
@@ -136,11 +165,11 @@ namespace MathNet.Numerics.Distributions
/// True when the parameters are valid, false otherwise.
+ /// true when the parameters are valid, false otherwise.
/// A string representation of the distribution.
///
+ /// a string representation of the distribution.
public override string ToString()
{
return "NormalGamma(Mean Location = " + _meanLocation + ", Mean Scale = " + _meanScale +
- ", Precision Shape = " + _precisionShape + ", Precision Inverse Scale = " + _precisionInvScale + ")";
+ ", Precision Shape = " + _precisionShape + ", Precision Inverse Scale = " + _precisionInvScale + ")";
}
///
- /// Gets the location of the mean.
+ /// Gets or sets the location of the mean.
///
public double MeanLocation
{
- get { return _meanLocation; }
- set { SetParameters(value, _meanScale, _precisionShape, _precisionInvScale); }
+ get
+ {
+ return _meanLocation;
+ }
+
+ set
+ {
+ SetParameters(value, _meanScale, _precisionShape, _precisionInvScale);
+ }
}
///
- /// Gets the scale of the mean.
+ /// Gets or sets the scale of the mean.
///
public double MeanScale
{
- get { return _meanScale; }
- set { SetParameters(_meanLocation, value, _precisionShape, _precisionInvScale); }
+ get
+ {
+ return _meanScale;
+ }
+
+ set
+ {
+ SetParameters(_meanLocation, value, _precisionShape, _precisionInvScale);
+ }
}
///
- /// Gets the shape of the precision.
+ /// Gets or sets the shape of the precision.
///
public double PrecisionShape
{
- get { return _precisionShape; }
- set { SetParameters(_meanLocation, _meanScale, value, _precisionInvScale); }
+ get
+ {
+ return _precisionShape;
+ }
+
+ set
+ {
+ SetParameters(_meanLocation, _meanScale, value, _precisionInvScale);
+ }
}
///
- /// Gets the inverse scale of the precision.
+ /// Gets or sets the inverse scale of the precision.
///
public double PrecisionInverseScale
{
- get { return _precisionInvScale; }
- set { SetParameters(_meanLocation, _meanScale, _precisionShape, value); }
+ get
+ {
+ return _precisionInvScale;
+ }
+
+ set
+ {
+ SetParameters(_meanLocation, _meanScale, _precisionShape, value);
+ }
}
///
@@ -237,25 +295,23 @@ namespace MathNet.Numerics.Distributions
}
///
- /// Returns the marginal distribution for the mean of the NormalGamma distribution.
///
- /// the marginal distribution for the mean of the NormalGamma distribution.
public StudentT MeanMarginal()
{
if (Double.IsPositiveInfinity(_precisionInvScale))
{
return new StudentT(_meanLocation, 1.0 / (_meanScale * _precisionShape), Double.PositiveInfinity);
}
- else
- {
- return new StudentT(_meanLocation, Math.Sqrt(_precisionInvScale / (_meanScale * _precisionShape)), 2.0 * _precisionShape);
- }
+
+ return new StudentT(_meanLocation, Math.Sqrt(_precisionInvScale / (_meanScale * _precisionShape)), 2.0 * _precisionShape);
}
///
/// Returns the marginal distribution for the precision of the
- /// The marginal distribution for the precision of the
public Gamma PrecisionMarginal()
{
return new Gamma(_precisionShape, _precisionInvScale);
@@ -269,14 +325,7 @@ namespace MathNet.Numerics.Distributions
{
get
{
- if (Double.IsPositiveInfinity(_precisionInvScale))
- {
- return new MeanPrecisionPair(_meanLocation, _precisionShape);
- }
- else
- {
- return new MeanPrecisionPair(_meanLocation, _precisionShape / _precisionInvScale);
- }
+ return Double.IsPositiveInfinity(_precisionInvScale) ? new MeanPrecisionPair(_meanLocation, _precisionShape) : new MeanPrecisionPair(_meanLocation, _precisionShape / _precisionInvScale);
}
}
@@ -349,63 +398,49 @@ namespace MathNet.Numerics.Distributions
}*/
///
- /// Generates a sample from the NormalGamma distribution.
+ /// Generates a sample from the NormalGamma distribution.
///
/// a sample from the distribution.
public MeanPrecisionPair Sample()
{
- return NormalGamma.Sample(RandomSource, _meanLocation, _meanScale, _precisionShape, _precisionInvScale);
+ return Sample(RandomSource, _meanLocation, _meanScale, _precisionShape, _precisionInvScale);
}
///
- /// Generates a sequence of samples from the NormalGamma distribution
+ /// Generates a sequence of samples from the NormalGamma distribution
///
/// a sequence of samples from the distribution.
public IEnumerable Samples()
{
while (true)
{
- yield return NormalGamma.Sample(RandomSource, _meanLocation, _meanScale, _precisionShape, _precisionInvScale);
+ yield return Sample(RandomSource, _meanLocation, _meanScale, _precisionShape, _precisionInvScale);
}
}
///
- /// Generates a sample from the NormalGamma distribution.
+ /// Generates a sample from the NormalGamma distribution.
///
/// a sample from the distribution.
- public static MeanPrecisionPair Sample(System.Random rnd, double meanLocation, double meanScale, double precShape, double precInvScale)
+ public static MeanPrecisionPair Sample(Random rnd, double meanLocation, double meanScale, double precisionShape, double precisionInverseScale)
{
- if (Control.CheckDistributionParameters && !IsValidParameterSet(meanLocation, meanScale, precShape, precInvScale))
+ if (Control.CheckDistributionParameters && !IsValidParameterSet(meanLocation, meanScale, precisionShape, precisionInverseScale))
{
throw new ArgumentOutOfRangeException(Resources.InvalidDistributionParameters);
}
- MeanPrecisionPair mp = new MeanPrecisionPair();
+ var mp = new MeanPrecisionPair();
// Sample the precision.
- if(Double.IsPositiveInfinity(precInvScale))
- {
- mp.Precision = precShape;
- }
- else
- {
- mp.Precision = Gamma.Sample(rnd, precShape, precInvScale);
- }
+ mp.Precision = Double.IsPositiveInfinity(precisionInverseScale) ? precisionShape : Gamma.Sample(rnd, precisionShape, precisionInverseScale);
// Sample the mean.
- if (meanScale == 0.0)
- {
- mp.Mean = meanLocation;
- }
- else
- {
- mp.Mean = Normal.Sample(rnd, meanLocation, System.Math.Sqrt(1.0 / (meanScale * mp.Precision)));
- }
+ mp.Mean = meanScale == 0.0 ? meanLocation : Normal.Sample(rnd, meanLocation, Math.Sqrt(1.0 / (meanScale * mp.Precision)));
return mp;
}
@@ -416,42 +451,28 @@ namespace MathNet.Numerics.Distributions
/// a sequence of samples from the distribution.
- public static IEnumerable Samples(System.Random rnd, double meanLocation, double meanScale, double precShape, double precInvScale)
+ public static IEnumerable Samples(Random rnd, double meanLocation, double meanScale, double precisionShape, double precisionInvScale)
{
- if (Control.CheckDistributionParameters && !IsValidParameterSet(meanLocation, meanScale, precShape, precInvScale))
+ if (Control.CheckDistributionParameters && !IsValidParameterSet(meanLocation, meanScale, precisionShape, precisionInvScale))
{
throw new ArgumentOutOfRangeException(Resources.InvalidDistributionParameters);
}
while (true)
{
- MeanPrecisionPair mp = new MeanPrecisionPair();
+ var mp = new MeanPrecisionPair();
// Sample the precision.
- if (Double.IsPositiveInfinity(precInvScale))
- {
- mp.Precision = precShape;
- }
- else
- {
- mp.Precision = Gamma.Sample(rnd, precShape, precInvScale);
- }
+ mp.Precision = Double.IsPositiveInfinity(precisionInvScale) ? precisionShape : Gamma.Sample(rnd, precisionShape, precisionInvScale);
// Sample the mean.
- if (meanScale == 0.0)
- {
- mp.Mean = meanLocation;
- }
- else
- {
- mp.Mean = Normal.Sample(rnd, meanLocation, System.Math.Sqrt(1.0 / (meanScale * mp.Precision)));
- }
+ mp.Mean = meanScale == 0.0 ? meanLocation : Normal.Sample(rnd, meanLocation, Math.Sqrt(1.0 / (meanScale * mp.Precision)));
yield return mp;
}
}
}
-}
\ No newline at end of file
+}
diff --git a/src/Numerics/Distributions/Multivariate/Wishart.cs b/src/Numerics/Distributions/Multivariate/Wishart.cs
new file mode 100644
index 00000000..71aa39b3
--- /dev/null
+++ b/src/Numerics/Distributions/Multivariate/Wishart.cs
@@ -0,0 +1,313 @@
+//
+// Math.NET Numerics, part of the Math.NET Project
+// http://numerics.mathdotnet.com
+// http://github.com/mathnet/mathnet-numerics
+// http://mathnetnumerics.codeplex.com
+// Copyright (c) 2009-2010 Math.NET
+// Permission is hereby granted, free of charge, to any person
+// obtaining a copy of this software and associated documentation
+// files (the "Software"), to deal in the Software without
+// restriction, including without limitation the rights to use,
+// copy, modify, merge, publish, distribute, sublicense, and/or sell
+// copies of the Software, and to permit persons to whom the
+// Software is furnished to do so, subject to the following
+// conditions:
+// The above copyright notice and this permission notice shall be
+// included in all copies or substantial portions of the Software.
+// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
+// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
+// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+// OTHER DEALINGS IN THE SOFTWARE.
+//
+
+namespace MathNet.Numerics.Distributions
+{
+ using System;
+ using LinearAlgebra.Double;
+ using LinearAlgebra.Generic;
+ using LinearAlgebra.Generic.Factorization;
+ using Properties;
+
+ ///
+ /// This class implements functionality for the Wishart distribution. This distribution is
+ /// parameterized by the degrees of freedom nu and the scale matrix S. The Wishart distribution
+ /// is the conjugate prior for the precision (inverse covariance) matrix of the multivariate
+ /// normal distribution.
+ /// Wikipedia - Wishart distribution .
+ ///
+ /// The distribution will use the
+ /// The statistics classes will check all the incoming parameters whether they are in the allowed
+ /// range. This might involve heavy computation. Optionally, by setting Control.CheckDistributionParameters
+ /// to false , all parameter checks can be turned off.
+ /// The degrees of freedom for the Wishart distribution.
+ ///
+ private double _nu;
+
+ ///
+ /// The scale matrix for the Wishart distribution.
+ ///
+ private Matrix _s;
+
+ ///
+ /// Caches the Cholesky factorization of the scale matrix.
+ ///
+ private Cholesky _chol;
+
+ ///
+ /// The distribution's random number generator.
+ ///
+ private Random _random;
+
+ ///
+ /// Initializes a new instance of the
+ /// s)
+ {
+ SetParameters(nu, s);
+ RandomSource = new Random();
+ }
+
+ ///
+ /// Sets the parameters of the distribution after checking their validity.
+ ///
+ /// When the parameters don't pass the
+ private void SetParameters(double nu, Matrix s)
+ {
+ if (Control.CheckDistributionParameters && !IsValidParameterSet(nu, s))
+ {
+ throw new ArgumentOutOfRangeException(Resources.InvalidDistributionParameters);
+ }
+
+ _nu = nu;
+ _s = s;
+ _chol = Cholesky.Create(_s);
+ }
+
+ ///
+ /// Checks whether the parameters of the distribution are valid.
+ ///
+ /// true when the parameters are valid, false otherwise. s)
+ {
+ if (s.RowCount != s.ColumnCount)
+ {
+ return false;
+ }
+
+ for (var i = 0; i < s.RowCount; i++)
+ {
+ if (s[i, i] <= 0.0)
+ {
+ return false;
+ }
+ }
+
+ if (nu <= 0.0 || Double.IsNaN(nu))
+ {
+ return false;
+ }
+
+ return true;
+ }
+
+ ///
+ /// Gets or sets the degrees of freedom for the Wishart distribution.
+ ///
+ public double Nu
+ {
+ get
+ {
+ return _nu;
+ }
+
+ set
+ {
+ SetParameters(value, _s);
+ }
+ }
+
+ ///
+ /// Gets or sets the scale matrix for the Wishart distribution.
+ ///
+ public Matrix S
+ {
+ get
+ {
+ return _s;
+ }
+
+ set
+ {
+ SetParameters(_nu, value);
+ }
+ }
+
+ ///
+ /// A string representation of the distribution.
+ ///
+ /// a string representation of the distribution.
+ public override string ToString()
+ {
+ return "Wishart(Nu = " + _nu + ", Rows = " + _s.RowCount + ", Columns = " + _s.ColumnCount + ")";
+ }
+
+ ///
+ /// Gets or sets the random number generator which is used to draw random samples.
+ ///
+ public Random RandomSource
+ {
+ get
+ {
+ return _random;
+ }
+
+ set
+ {
+ if (value == null)
+ {
+ throw new ArgumentNullException();
+ }
+
+ _random = value;
+ }
+ }
+
+ ///
+ /// Gets the mean of the distribution.
+ ///
+ /// The mean of the distribution.
+ public Matrix Mean
+ {
+ get
+ {
+ return _nu * _s;
+ }
+ }
+
+ ///
+ /// Gets the mode of the distribution.
+ ///
+ /// The mode of the distribution.
+ public Matrix Mode
+ {
+ get
+ {
+ return (_nu - _s.RowCount - 1.0) * _s;
+ }
+ }
+
+ ///
+ /// Evaluates the probability density function for the Wishart distribution.
+ ///
+ /// If the argument does not have the same dimensions as the scale matrix.
+ /// the density at
+ public double Density(Matrix x)
+ {
+ var p = _s.RowCount;
+
+ if (x.RowCount != p || x.ColumnCount != p)
+ {
+ throw new ArgumentOutOfRangeException("x", Resources.ArgumentMatrixDimensions);
+ }
+
+ var dX = x.Determinant();
+ var siX = _chol.Solve(x);
+
+ // Compute the multivariate Gamma function.
+ var gp = Math.Pow(Constants.Pi, p * (p - 1.0) / 4.0);
+ for (var j = 1; j <= p; j++)
+ {
+ gp *= SpecialFunctions.Gamma((_nu + 1.0 - j) / 2.0);
+ }
+
+ return Math.Pow(dX, (_nu - p - 1.0) / 2.0)
+ * Math.Exp(-0.5 * siX.Trace())
+ / Math.Pow(2.0, _nu * p / 2.0)
+ / Math.Pow(_chol.Determinant, _nu / 2.0)
+ / gp;
+ }
+
+ ///
+ /// Samples a Wishart distributed random variable using the method
+ /// Algorithm AS 53: Wishart Variate Generator
+ /// W. B. Smith and R. R. Hocking
+ /// Applied Statistics, Vol. 21, No. 3 (1972), pp. 341-345
+ ///
+ /// A random number from this distribution.
+ public Matrix Sample()
+ {
+ return DoSample(RandomSource, _nu, _s, _chol);
+ }
+
+ ///
+ /// Samples a Wishart distributed random variable using the method
+ /// Algorithm AS 53: Wishart Variate Generator
+ /// W. B. Smith and R. R. Hocking
+ /// Applied Statistics, Vol. 21, No. 3 (1972), pp. 341-345
+ ///
+ /// a sequence of samples from the distribution.
+ public static Matrix Sample(Random rnd, double nu, Matrix s)
+ {
+ if (Control.CheckDistributionParameters && !IsValidParameterSet(nu, s))
+ {
+ throw new ArgumentOutOfRangeException(Resources.InvalidDistributionParameters);
+ }
+
+ return DoSample(rnd, nu, s, Cholesky.Create(s));
+ }
+
+ ///
+ /// Samples the distribution.
+ ///
+ /// a random number from the distribution.
+ private static Matrix DoSample(Random rnd, double nu, Matrix s, Cholesky chol)
+ {
+ var count = s.RowCount;
+
+ // First generate a lower triangular matrix with Sqrt(Chi-Squares) on the diagonal
+ // and normal distributed variables in the lower triangle.
+ var a = new DenseMatrix(count, count, 0.0);
+ for (var d = 0; d < count; d++)
+ {
+ a[d, d] = Math.Sqrt(Gamma.Sample(rnd, (nu - d) / 2.0, 0.5));
+ }
+
+ for (var i = 1; i < count; i++)
+ {
+ for (var j = 0; j < i; j++)
+ {
+ a[i, j] = Normal.Sample(rnd, 0.0, 1.0);
+ }
+ }
+
+ var factor = chol.Factor;
+ return factor * a * a.Transpose() * factor.Transpose();
+ }
+ }
+}
diff --git a/src/Numerics/Numerics.csproj b/src/Numerics/Numerics.csproj
index 5cba634b..cb70bbc9 100644
--- a/src/Numerics/Numerics.csproj
+++ b/src/Numerics/Numerics.csproj
@@ -104,6 +104,25 @@
+ /// Compute the generalized harmonic number of order n of m. (1 + 1/2^m + 1/3^m + ... + 1/n^m)
+ ///
+ /// General Harmonic number.
+ public static double GeneralHarmonic(int n, double m)
+ {
+ double sum = 0;
+ for (int i = 0; i < n; i++)
+ {
+ sum += Math.Pow(i + 1, -m);
+ }
+ return sum;
+ }
+
///
/// Computes the logarithm of the Euler Beta function.
///
diff --git a/src/Silverlight/Silverlight.csproj b/src/Silverlight/Silverlight.csproj
index cb19f88e..e0190c7e 100644
--- a/src/Silverlight/Silverlight.csproj
+++ b/src/Silverlight/Silverlight.csproj
@@ -83,18 +83,51 @@
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
@@ -110,9 +143,24 @@
+
+
+
+
+
+
+
+
+
+
@@ -125,12 +173,21 @@
+
+
+
+
+
+
diff --git a/src/UnitTests/ComplexTests/Complex32Test.cs b/src/UnitTests/ComplexTests/Complex32Test.cs
index 4d149cc9..30582dda 100644
--- a/src/UnitTests/ComplexTests/Complex32Test.cs
+++ b/src/UnitTests/ComplexTests/Complex32Test.cs
@@ -34,6 +34,7 @@ namespace MathNet.Numerics.UnitTests.ComplexTests
using System.Numerics;
using MbUnit.Framework;
+
[TestFixture]
public class Complex32Test
{
diff --git a/src/UnitTests/DistributionTests/Continuous/BetaTests.cs b/src/UnitTests/DistributionTests/Continuous/BetaTests.cs
index a73885f9..50b9f800 100644
--- a/src/UnitTests/DistributionTests/Continuous/BetaTests.cs
+++ b/src/UnitTests/DistributionTests/Continuous/BetaTests.cs
@@ -58,8 +58,8 @@ namespace MathNet.Numerics.UnitTests.DistributionTests.Continuous
public void CanCreateBeta(double a, double b)
{
var n = new Beta(a, b);
- AssertEx.AreEqual(a, n.A);
- AssertEx.AreEqual(b, n.B);
+ Assert.AreEqual(a, n.A);
+ Assert.AreEqual(b, n.B);
}
[Test]
@@ -79,7 +79,7 @@ namespace MathNet.Numerics.UnitTests.DistributionTests.Continuous
public void ValidateToString()
{
var n = new Beta(1.0, 2.0);
- AssertEx.AreEqual("Beta(A = 1, B = 2)", n.ToString());
+ Assert.AreEqual("Beta(A = 1, B = 2)", n.ToString());
}
[Test]
@@ -138,7 +138,7 @@ namespace MathNet.Numerics.UnitTests.DistributionTests.Continuous
public void ValidateMean(double a, double b, double mean)
{
var n = new Beta(a, b);
- AssertEx.AreEqual(mean, n.Mean);
+ Assert.AreEqual(mean, n.Mean);
}
[Test]
@@ -189,7 +189,7 @@ namespace MathNet.Numerics.UnitTests.DistributionTests.Continuous
public void ValidateMode(double a, double b, double mode)
{
var n = new Beta(a, b);
- AssertEx.AreEqual(mode, n.Mode);
+ Assert.AreEqual(mode, n.Mode);
}
[Test]
@@ -214,14 +214,14 @@ namespace MathNet.Numerics.UnitTests.DistributionTests.Continuous
public void ValidateMinimum()
{
var n = new Beta(1.0, 1.0);
- AssertEx.AreEqual(0.0, n.Minimum);
+ Assert.AreEqual(0.0, n.Minimum);
}
[Test]
public void ValidateMaximum()
{
var n = new Beta(1.0, 1.0);
- AssertEx.AreEqual(1.0, n.Maximum);
+ Assert.AreEqual(1.0, n.Maximum);
}
[Test]
diff --git a/src/UnitTests/DistributionTests/Continuous/CauchyTests.cs b/src/UnitTests/DistributionTests/Continuous/CauchyTests.cs
new file mode 100644
index 00000000..5a03ca7b
--- /dev/null
+++ b/src/UnitTests/DistributionTests/Continuous/CauchyTests.cs
@@ -0,0 +1,268 @@
+//
+// Math.NET Numerics, part of the Math.NET Project
+// http://numerics.mathdotnet.com
+// http://github.com/mathnet/mathnet-numerics
+// http://mathnetnumerics.codeplex.com
+//
+// Copyright (c) 2009-2010 Math.NET
+//
+// Permission is hereby granted, free of charge, to any person
+// obtaining a copy of this software and associated documentation
+// files (the "Software"), to deal in the Software without
+// restriction, including without limitation the rights to use,
+// copy, modify, merge, publish, distribute, sublicense, and/or sell
+// copies of the Software, and to permit persons to whom the
+// Software is furnished to do so, subject to the following
+// conditions:
+//
+// The above copyright notice and this permission notice shall be
+// included in all copies or substantial portions of the Software.
+//
+// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
+// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
+// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+// OTHER DEALINGS IN THE SOFTWARE.
+//
+
+namespace MathNet.Numerics.UnitTests.DistributionTests.Continuous
+{
+ using System;
+ using System.Linq;
+ using MbUnit.Framework;
+ using Distributions;
+
+ [TestFixture]
+ public class CauchyTests
+ {
+ [SetUp]
+ public void SetUp()
+ {
+ Control.CheckDistributionParameters = true;
+ }
+
+ [Test, MultipleAsserts]
+ public void CanCreateCauchy()
+ {
+ var n = new Cauchy();
+ Assert.AreEqual(0.0, n.Location);
+ Assert.AreEqual(1.0, n.Scale);
+ }
+
+ [Test, MultipleAsserts]
+ [Row(0.0, 0.1)]
+ [Row(0.0, 1.0)]
+ [Row(0.0, 10.0)]
+ [Row(10.0, 11.0)]
+ [Row(-5.0, 100.0)]
+ [Row(0.0, Double.PositiveInfinity)]
+ public void CanCreateCauchy(double location, double scale)
+ {
+ var n = new Cauchy(location, scale);
+ Assert.AreEqual(location, n.Location);
+ Assert.AreEqual(scale, n.Scale);
+ }
+
+ [Test]
+ [ExpectedException(typeof(ArgumentOutOfRangeException))]
+ [Row(Double.NaN, 1.0)]
+ [Row(1.0, Double.NaN)]
+ [Row(Double.NaN, Double.NaN)]
+ [Row(1.0, 0.0)]
+ public void CauchyCreateFailsWithBadParameters(double location, double scale)
+ {
+ var n = new Cauchy(location, scale);
+ }
+
+ [Test]
+ public void ValidateToString()
+ {
+ var n = new Cauchy(1.0, 2.0);
+ Assert.AreEqual("Cauchy(Location = 1, Scale = 2)", n.ToString());
+ }
+
+ [Test]
+ [Row(-10.0)]
+ [Row(-0.0)]
+ [Row(0.0)]
+ [Row(0.1)]
+ [Row(1.0)]
+ public void CanSetLocation(double location)
+ {
+ var n = new Cauchy();
+ n.Location = location;
+ }
+
+ [Test]
+ [ExpectedException(typeof(ArgumentOutOfRangeException))]
+ public void SetLocationFail()
+ {
+ var n = new Cauchy();
+ n.Location = Double.NaN;
+ }
+
+ [Test]
+ [Row(1.0)]
+ [Row(2.0)]
+ [Row(12.0)]
+ public void CanSetScale(double scale)
+ {
+ var n = new Cauchy();
+ n.Scale = scale;
+ }
+
+ [Test]
+ [ExpectedException(typeof(ArgumentOutOfRangeException))]
+ public void SetScaleFail()
+ {
+ var n = new Cauchy();
+ n.Scale = -1.0;
+ }
+
+ [Test]
+ [Row(-0.0, 2.0)]
+ [Row(0.0, 2.0)]
+ [Row(0.1, 4.0)]
+ [Row(1.0, 10.0)]
+ [Row(10.0, 11.0)]
+ public void ValidateEntropy(double location, double scale)
+ {
+ var n = new Cauchy(location, scale);
+ Assert.AreEqual(Math.Log(4.0 * Constants.Pi * scale), n.Entropy);
+ }
+
+ [Test]
+ [ExpectedException(typeof(NotSupportedException))]
+ [Row(-0.0, 2.0)]
+ [Row(0.0, 2.0)]
+ [Row(0.1, 4.0)]
+ [Row(1.0, 10.0)]
+ [Row(10.0, 11.0)]
+ [Row(0.0, Double.PositiveInfinity)]
+ public void ValidateSkewness(double location, double scale)
+ {
+ var n = new Cauchy(location, scale);
+ Assert.AreEqual(0.0, n.Skewness);
+ }
+
+ [Test]
+ [Row(-0.0, 2.0)]
+ [Row(0.0, 2.0)]
+ [Row(0.1, 4.0)]
+ [Row(1.0, 10.0)]
+ [Row(10.0, 11.0)]
+ [Row(0.0, Double.PositiveInfinity)]
+ public void ValidateMode(double location, double scale)
+ {
+ var n = new Cauchy(location, scale);
+ Assert.AreEqual(location, n.Mode);
+ }
+
+ [Test]
+ [Row(-0.0, 2.0)]
+ [Row(0.0, 2.0)]
+ [Row(0.1, 4.0)]
+ [Row(1.0, 10.0)]
+ [Row(10.0, 11.0)]
+ [Row(0.0, Double.PositiveInfinity)]
+ public void ValidateMedian(double location, double scale)
+ {
+ var n = new Cauchy(location, scale);
+ Assert.AreEqual(location, n.Median);
+ }
+
+ [Test]
+ [Row(-0.0, 2.0)]
+ [Row(0.0, 2.0)]
+ [Row(0.1, 4.0)]
+ [Row(1.0, 10.0)]
+ [Row(10.0, 11.0)]
+ [Row(0.0, Double.PositiveInfinity)]
+ public void ValidateMinimum(double location, double scale)
+ {
+ var n = new Cauchy(location, scale);
+ Assert.AreEqual(Double.NegativeInfinity, n.Minimum);
+ }
+
+ [Test]
+ [Row(-0.0, 2.0)]
+ [Row(0.0, 2.0)]
+ [Row(0.1, 4.0)]
+ [Row(1.0, 10.0)]
+ [Row(10.0, 11.0)]
+ [Row(0.0, Double.PositiveInfinity)]
+ public void ValidateMaximum(double location, double scale)
+ {
+ var n = new Cauchy(location, scale);
+ Assert.AreEqual(Double.PositiveInfinity, n.Maximum);
+ }
+
+ [Test]
+ [Row(0.0, 0.1)]
+ [Row(0.0, 1.0)]
+ [Row(0.0, 10.0)]
+ [Row(-5.0, 100.0)]
+ [Row(0.0, Double.PositiveInfinity)]
+ [Row(Double.PositiveInfinity, 1.0)]
+ public void ValidateDensity(double location, double scale)
+ {
+ var n = new Cauchy(location, scale);
+ for (int i = 0; i < 11; i++)
+ {
+ double x = i - 5.0;
+ Assert.AreEqual(1.0 / (Constants.Pi * scale * (1.0 + ((x - location) / scale) * ((x - location) / scale))), n.Density(x));
+ }
+ }
+
+ [Test]
+ [Row(0.0, 0.1)]
+ [Row(0.0, 1.0)]
+ [Row(0.0, 10.0)]
+ [Row(-5.0, 100.0)]
+ [Row(0.0, Double.PositiveInfinity)]
+ [Row(Double.PositiveInfinity, 1.0)]
+ public void ValidateDensityLn(double location, double scale)
+ {
+ var n = new Cauchy(location, scale);
+ for (int i = 0; i < 11; i++)
+ {
+ double x = i - 5.0;
+ Assert.AreEqual(-Math.Log(Constants.Pi * scale * (1.0 + ((x - location) / scale) * ((x - location) / scale))), n.DensityLn(x));
+ }
+ }
+
+ [Test]
+ public void CanSample()
+ {
+ var n = new Cauchy();
+ var d = n.Sample();
+ }
+
+ [Test]
+ public void CanSampleSequence()
+ {
+ var n = new Cauchy();
+ var ied = n.Samples();
+ var e = ied.Take(5).ToArray();
+ }
+
+ [Test]
+ [Row(0.0, 0.1)]
+ [Row(0.0, 1.0)]
+ [Row(0.0, 10.0)]
+ [Row(-5.0, 100.0)]
+ [Row(0.0, Double.PositiveInfinity)]
+ public void ValidateCumulativeDistribution(double location, double scale)
+ {
+ var n = new Cauchy(location, scale);
+ for (int i = 0; i < 11; i++)
+ {
+ double x = i - 5.0;
+ Assert.AreEqual((1.0 / Constants.Pi) * Math.Atan((x - location) / scale) + 0.5, n.CumulativeDistribution(x));
+ }
+ }
+ }
+}
diff --git a/src/UnitTests/DistributionTests/Continuous/ChiSquareTests.cs b/src/UnitTests/DistributionTests/Continuous/ChiSquareTests.cs
new file mode 100644
index 00000000..82220efc
--- /dev/null
+++ b/src/UnitTests/DistributionTests/Continuous/ChiSquareTests.cs
@@ -0,0 +1,295 @@
+//
+// Math.NET Numerics, part of the Math.NET Project
+// http://numerics.mathdotnet.com
+// http://github.com/mathnet/mathnet-numerics
+// http://mathnetnumerics.codeplex.com
+//
+// Copyright (c) 2009-2010 Math.NET
+//
+// Permission is hereby granted, free of charge, to any person
+// obtaining a copy of this software and associated documentation
+// files (the "Software"), to deal in the Software without
+// restriction, including without limitation the rights to use,
+// copy, modify, merge, publish, distribute, sublicense, and/or sell
+// copies of the Software, and to permit persons to whom the
+// Software is furnished to do so, subject to the following
+// conditions:
+//
+// The above copyright notice and this permission notice shall be
+// included in all copies or substantial portions of the Software.
+//
+// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
+// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
+// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+// OTHER DEALINGS IN THE SOFTWARE.
+//
+
+namespace MathNet.Numerics.UnitTests.DistributionTests.Continuous
+{
+ using System;
+ using System.Linq;
+ using MbUnit.Framework;
+ using Distributions;
+
+ [TestFixture]
+ public class ChiSquareTests
+ {
+ [SetUp]
+ public void SetUp()
+ {
+ Control.CheckDistributionParameters = true;
+ }
+
+ [Test, MultipleAsserts]
+ [Row(1.0)]
+ [Row(3.0)]
+ [Row(Double.PositiveInfinity)]
+ public void CanCreateChiSquare(double dof)
+ {
+ var n = new ChiSquare(dof);
+ Assert.AreEqual(dof, n.DegreesOfFreedom);
+ }
+
+ [Test]
+ [ExpectedException(typeof(ArgumentOutOfRangeException))]
+ [Row(0.0)]
+ [Row(-1.0)]
+ [Row(-100.0)]
+ [Row(Double.NegativeInfinity)]
+ [Row(Double.NaN)]
+ public void ChiSquareCreateFailsWithBadParameters(double dof)
+ {
+ var n = new ChiSquare(dof);
+ }
+
+ [Test]
+ public void ValidateToString()
+ {
+ var n = new ChiSquare(1.0);
+ Assert.AreEqual("ChiSquare(DoF = 1)", n.ToString());
+ }
+
+ [Test]
+ [Row(0.1)]
+ [Row(1.0)]
+ [Row(10.0)]
+ [Row(Double.PositiveInfinity)]
+ public void CanSetDoF(double dof)
+ {
+ var n = new ChiSquare(1.0);
+ n.DegreesOfFreedom = dof;
+ }
+
+ [Test]
+ [ExpectedException(typeof(ArgumentOutOfRangeException))]
+ [Row(-1.0)]
+ [Row(-0.0)]
+ [Row(0.0)]
+ public void SetDofFailsWithNonPositiveDoF(double dof)
+ {
+ {
+ var n = new ChiSquare(1.0);
+ n.DegreesOfFreedom = dof;
+ }
+ }
+
+ [Test]
+ [Row(1.0)]
+ [Row(2.0)]
+ [Row(2.5)]
+ [Row(5.0)]
+ [Row(Double.PositiveInfinity)]
+ public void ValidateMean(double dof)
+ {
+ var n = new ChiSquare(dof);
+ Assert.AreEqual(dof, n.Mean);
+ }
+
+ [Test]
+ [Row(1.0)]
+ [Row(2.0)]
+ [Row(2.5)]
+ [Row(3.0)]
+ [Row(Double.PositiveInfinity)]
+ public void ValidateVariance(double dof)
+ {
+ var n = new ChiSquare(dof);
+ Assert.AreEqual(2 * dof, n.Variance);
+ }
+
+ [Test]
+ [Row(1.0)]
+ [Row(2.0)]
+ [Row(2.5)]
+ [Row(3.0)]
+ [Row(Double.PositiveInfinity)]
+ public void ValidateStdDev(double dof)
+ {
+ var n = new ChiSquare(dof);
+ Assert.AreEqual(Math.Sqrt(n.Variance), n.StdDev);
+ }
+
+ [Test]
+ [Row(1.0)]
+ [Row(1.5)]
+ [Row(2.5)]
+ [Row(3.0)]
+ [Row(Double.PositiveInfinity)]
+ public void ValidateMode(double dof)
+ {
+ var n = new ChiSquare(dof);
+ Assert.AreEqual(dof - 2, n.Mode);
+ }
+
+ [Test]
+ [Row(1.0)]
+ [Row(1.5)]
+ [Row(2.5)]
+ [Row(3.0)]
+ [Row(Double.PositiveInfinity)]
+ public void ValidateMedian(double dof)
+ {
+ var n = new ChiSquare(dof);
+ Assert.AreEqual(dof - 2.0 / 3.0, n.Median);
+ }
+
+ [Test]
+ public void ValidateMinimum()
+ {
+ var n = new ChiSquare(1.0);
+ Assert.AreEqual(0.0, n.Minimum);
+ }
+
+ [Test]
+ public void ValidateMaximum()
+ {
+ var n = new ChiSquare(1.0);
+ Assert.AreEqual(Double.PositiveInfinity, n.Maximum);
+ }
+
+ [Test]
+ [Row(1.0, 0.0)]
+ [Row(1.0, 0.1)]
+ [Row(1.0, 1.0)]
+ [Row(1.0, 5.5)]
+ [Row(1.0, 110.1)]
+ [Row(1.0, Double.PositiveInfinity)]
+ [Row(2.0, 0.0)]
+ [Row(2.0, 0.1)]
+ [Row(2.0, 1.0)]
+ [Row(2.0, 5.5)]
+ [Row(2.0, 110.1)]
+ [Row(2.0, Double.PositiveInfinity)]
+ [Row(2.5, 0.0)]
+ [Row(2.5, 0.1)]
+ [Row(2.5, 1.0)]
+ [Row(2.5, 5.5)]
+ [Row(2.5, 110.1)]
+ [Row(2.5, Double.PositiveInfinity)]
+ [Row(Double.PositiveInfinity, 0.0)]
+ [Row(Double.PositiveInfinity, 0.1)]
+ [Row(Double.PositiveInfinity, 1.0)]
+ [Row(Double.PositiveInfinity, 5.5)]
+ [Row(Double.PositiveInfinity, 110.1)]
+ [Row(Double.PositiveInfinity, Double.PositiveInfinity)]
+ public void ValidateDensity(double dof, double x)
+ {
+ var n = new ChiSquare(dof);
+ Assert.AreEqual((Math.Pow(x, dof / 2.0 - 1.0) * Math.Exp(-x / 2.0)) / (Math.Pow(2.0, dof / 2.0) * SpecialFunctions.Gamma(dof / 2.0)), n.Density(x));
+ }
+
+ [Test]
+ [Row(1.0, 0.0)]
+ [Row(1.0, 0.1)]
+ [Row(1.0, 1.0)]
+ [Row(1.0, 5.5)]
+ [Row(1.0, 110.1)]
+ [Row(1.0, Double.PositiveInfinity)]
+ [Row(2.0, 0.0)]
+ [Row(2.0, 0.1)]
+ [Row(2.0, 1.0)]
+ [Row(2.0, 5.5)]
+ [Row(2.0, 110.1)]
+ [Row(2.0, Double.PositiveInfinity)]
+ [Row(2.5, 0.0)]
+ [Row(2.5, 0.1)]
+ [Row(2.5, 1.0)]
+ [Row(2.5, 5.5)]
+ [Row(2.5, 110.1)]
+ [Row(2.5, Double.PositiveInfinity)]
+ [Row(Double.PositiveInfinity, 0.0)]
+ [Row(Double.PositiveInfinity, 0.1)]
+ [Row(Double.PositiveInfinity, 1.0)]
+ [Row(Double.PositiveInfinity, 5.5)]
+ [Row(Double.PositiveInfinity, 110.1)]
+ [Row(Double.PositiveInfinity, Double.PositiveInfinity)]
+ public void ValidateDensityLn(double dof, double x)
+ {
+ var n = new ChiSquare(dof);
+ Assert.AreEqual(-x / 2.0 + (dof / 2.0 - 1.0) * Math.Log(x) - (dof / 2.0) * Math.Log(2) - SpecialFunctions.GammaLn(dof / 2.0), n.DensityLn(x));
+ }
+
+ [Test]
+ public void CanSampleStatic()
+ {
+ var d = ChiSquare.Sample(new Random(), 2.0);
+ }
+
+ [Test]
+ [ExpectedException(typeof(ArgumentOutOfRangeException))]
+ public void FailSampleStatic()
+ {
+ var d = ChiSquare.Sample(new Random(), -1.0);
+ }
+
+ [Test]
+ public void CanSample()
+ {
+ var n = new ChiSquare(1.0);
+ var d = n.Sample();
+ }
+
+ [Test]
+ public void CanSampleSequence()
+ {
+ var n = new ChiSquare(1.0);
+ var ied = n.Samples();
+ var e = ied.Take(5).ToArray();
+ }
+
+ [Test]
+ [Row(1.0, 0.0)]
+ [Row(1.0, 0.1)]
+ [Row(1.0, 1.0)]
+ [Row(1.0, 5.5)]
+ [Row(1.0, 110.1)]
+ [Row(1.0, Double.PositiveInfinity)]
+ [Row(2.0, 0.0)]
+ [Row(2.0, 0.1)]
+ [Row(2.0, 1.0)]
+ [Row(2.0, 5.5)]
+ [Row(2.0, 110.1)]
+ [Row(2.0, Double.PositiveInfinity)]
+ [Row(2.5, 0.0)]
+ [Row(2.5, 0.1)]
+ [Row(2.5, 1.0)]
+ [Row(2.5, 5.5)]
+ [Row(2.5, 110.1)]
+ [Row(2.5, Double.PositiveInfinity)]
+ [Row(Double.PositiveInfinity, 0.0)]
+ [Row(Double.PositiveInfinity, 0.1)]
+ [Row(Double.PositiveInfinity, 1.0)]
+ [Row(Double.PositiveInfinity, 5.5)]
+ [Row(Double.PositiveInfinity, 110.1)]
+ [Row(Double.PositiveInfinity, Double.PositiveInfinity)]
+ public void ValidateCumulativeDistribution(double dof, double x)
+ {
+ var n = new ChiSquare(dof);
+ Assert.AreEqual(SpecialFunctions.GammaUpperIncomplete(dof / 2.0, x / 2.0) / SpecialFunctions.Gamma(dof / 2.0), n.CumulativeDistribution(x));
+ }
+ }
+}
diff --git a/src/UnitTests/DistributionTests/Continuous/ChiTests.cs b/src/UnitTests/DistributionTests/Continuous/ChiTests.cs
new file mode 100644
index 00000000..76fc2c3d
--- /dev/null
+++ b/src/UnitTests/DistributionTests/Continuous/ChiTests.cs
@@ -0,0 +1,281 @@
+//
+// Math.NET Numerics, part of the Math.NET Project
+// http://numerics.mathdotnet.com
+// http://github.com/mathnet/mathnet-numerics
+// http://mathnetnumerics.codeplex.com
+//
+// Copyright (c) 2009-2010 Math.NET
+//
+// Permission is hereby granted, free of charge, to any person
+// obtaining a copy of this software and associated documentation
+// files (the "Software"), to deal in the Software without
+// restriction, including without limitation the rights to use,
+// copy, modify, merge, publish, distribute, sublicense, and/or sell
+// copies of the Software, and to permit persons to whom the
+// Software is furnished to do so, subject to the following
+// conditions:
+//
+// The above copyright notice and this permission notice shall be
+// included in all copies or substantial portions of the Software.
+//
+// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
+// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
+// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+// OTHER DEALINGS IN THE SOFTWARE.
+//
+
+namespace MathNet.Numerics.UnitTests.DistributionTests.Continuous
+{
+ using System;
+ using System.Linq;
+ using MbUnit.Framework;
+ using Distributions;
+
+ [TestFixture]
+ public class ChiTests
+ {
+ [SetUp]
+ public void SetUp()
+ {
+ Control.CheckDistributionParameters = true;
+ }
+
+ [Test, MultipleAsserts]
+ [Row(1.0)]
+ [Row(3.0)]
+ [Row(Double.PositiveInfinity)]
+ public void CanCreateChi(double dof)
+ {
+ var n = new Chi(dof);
+ Assert.AreEqual(dof, n.DegreesOfFreedom);
+ }
+
+ [Test]
+ [ExpectedException(typeof(ArgumentOutOfRangeException))]
+ [Row(0.0)]
+ [Row(-1.0)]
+ [Row(-100.0)]
+ [Row(Double.NegativeInfinity)]
+ [Row(Double.NaN)]
+ public void ChiCreateFailsWithBadParameters(double dof)
+ {
+ var n = new Chi(dof);
+ }
+
+ [Test]
+ public void ValidateToString()
+ {
+ var n = new Chi(1.0);
+ Assert.AreEqual("Chi(DoF = 1)", n.ToString());
+ }
+
+ [Test]
+ [Row(0.1)]
+ [Row(1.0)]
+ [Row(10.0)]
+ [Row(Double.PositiveInfinity)]
+ public void CanSetDoF(double dof)
+ {
+ var n = new Chi(1.0);
+ n.DegreesOfFreedom = dof;
+ }
+
+ [Test]
+ [ExpectedException(typeof(ArgumentOutOfRangeException))]
+ [Row(-1.0)]
+ [Row(-0.0)]
+ [Row(0.0)]
+ public void SetDofFailsWithNonPositiveDoF(double dof)
+ {
+ {
+ var n = new Chi(1.0);
+ n.DegreesOfFreedom = dof;
+ }
+ }
+
+ [Test]
+ [Row(1.0)]
+ [Row(2.0)]
+ [Row(2.5)]
+ [Row(5.0)]
+ [Row(Double.PositiveInfinity)]
+ public void ValidateMean(double dof)
+ {
+ var n = new Chi(dof);
+ Assert.AreEqual(Math.Sqrt(2) * (SpecialFunctions.Gamma((dof + 1.0) / 2.0) / SpecialFunctions.Gamma(dof / 2.0)), n.Mean);
+ }
+
+ [Test]
+ [Row(1.0)]
+ [Row(2.0)]
+ [Row(2.5)]
+ [Row(3.0)]
+ [Row(Double.PositiveInfinity)]
+ public void ValidateVariance(double dof)
+ {
+ var n = new Chi(dof);
+ Assert.AreEqual(dof - n.Mean * n.Mean, n.Variance);
+ }
+
+ [Test]
+ [Row(1.0)]
+ [Row(2.0)]
+ [Row(2.5)]
+ [Row(3.0)]
+ [Row(Double.PositiveInfinity)]
+ public void ValidateStdDev(double dof)
+ {
+ var n = new Chi(dof);
+ Assert.AreEqual(Math.Sqrt(n.Variance), n.StdDev);
+ }
+
+ [Test]
+ [Row(1.0)]
+ [Row(1.5)]
+ [Row(2.5)]
+ [Row(3.0)]
+ [Row(Double.PositiveInfinity)]
+ public void ValidateMode(double dof)
+ {
+ var n = new Chi(dof);
+ if (dof >= 1)
+ {
+ Assert.AreEqual(Math.Sqrt(dof - 1), n.Mode);
+ }
+ }
+
+ [Test]
+ [ExpectedException(typeof(NotSupportedException))]
+ public void ValidateMedian()
+ {
+ var n = new Chi(1.0);
+ var median = n.Median;
+ }
+
+ [Test]
+ public void ValidateMinimum()
+ {
+ var n = new Chi(1.0);
+ Assert.AreEqual(0.0, n.Minimum);
+ }
+
+ [Test]
+ public void ValidateMaximum()
+ {
+ var n = new Chi(1.0);
+ Assert.AreEqual(Double.PositiveInfinity, n.Maximum);
+ }
+
+ [Test]
+ [Row(1.0, 0.0)]
+ [Row(1.0, 0.1)]
+ [Row(1.0, 1.0)]
+ [Row(1.0, 5.5)]
+ [Row(1.0, 110.1)]
+ [Row(1.0, Double.PositiveInfinity)]
+ [Row(2.0, 0.0)]
+ [Row(2.0, 0.1)]
+ [Row(2.0, 1.0)]
+ [Row(2.0, 5.5)]
+ [Row(2.0, 110.1)]
+ [Row(2.0, Double.PositiveInfinity)]
+ [Row(2.5, 0.0)]
+ [Row(2.5, 0.1)]
+ [Row(2.5, 1.0)]
+ [Row(2.5, 5.5)]
+ [Row(2.5, 110.1)]
+ [Row(2.5, Double.PositiveInfinity)]
+ [Row(Double.PositiveInfinity, 0.0)]
+ [Row(Double.PositiveInfinity, 0.1)]
+ [Row(Double.PositiveInfinity, 1.0)]
+ [Row(Double.PositiveInfinity, 5.5)]
+ [Row(Double.PositiveInfinity, 110.1)]
+ [Row(Double.PositiveInfinity, Double.PositiveInfinity)]
+ public void ValidateDensity(double dof, double x)
+ {
+ var n = new Chi(dof);
+ Assert.AreEqual((Math.Pow(2.0, 1.0 - dof / 2.0) * Math.Pow(x, dof - 1.0) * Math.Exp(-x * x / 2.0)) / SpecialFunctions.Gamma(dof / 2.0), n.Density(x));
+ }
+
+ [Test]
+ [Row(1.0, 0.0)]
+ [Row(1.0, 0.1)]
+ [Row(1.0, 1.0)]
+ [Row(1.0, 5.5)]
+ [Row(1.0, 110.1)]
+ [Row(1.0, Double.PositiveInfinity)]
+ [Row(2.0, 0.0)]
+ [Row(2.0, 0.1)]
+ [Row(2.0, 1.0)]
+ [Row(2.0, 5.5)]
+ [Row(2.0, 110.1)]
+ [Row(2.0, Double.PositiveInfinity)]
+ [Row(2.5, 0.0)]
+ [Row(2.5, 0.1)]
+ [Row(2.5, 1.0)]
+ [Row(2.5, 5.5)]
+ [Row(2.5, 110.1)]
+ [Row(2.5, Double.PositiveInfinity)]
+ [Row(Double.PositiveInfinity, 0.0)]
+ [Row(Double.PositiveInfinity, 0.1)]
+ [Row(Double.PositiveInfinity, 1.0)]
+ [Row(Double.PositiveInfinity, 5.5)]
+ [Row(Double.PositiveInfinity, 110.1)]
+ [Row(Double.PositiveInfinity, Double.PositiveInfinity)]
+ public void ValidateDensityLn(double dof, double x)
+ {
+ var n = new Chi(dof);
+ Assert.AreEqual((1.0 - dof / 2.0) * Math.Log(2.0) + (dof - 1.0) * Math.Log(x) - x * x / 2.0 - SpecialFunctions.GammaLn(dof / 2.0), n.DensityLn(x));
+ }
+
+ [Test]
+ public void CanSample()
+ {
+ var n = new Chi(1.0);
+ var d = n.Sample();
+ }
+
+ [Test]
+ public void CanSampleSequence()
+ {
+ var n = new Chi(1.0);
+ var ied = n.Samples();
+ var e = ied.Take(5).ToArray();
+ }
+
+ [Test]
+ [Row(1.0, 0.0)]
+ [Row(1.0, 0.1)]
+ [Row(1.0, 1.0)]
+ [Row(1.0, 5.5)]
+ [Row(1.0, 110.1)]
+ [Row(1.0, Double.PositiveInfinity)]
+ [Row(2.0, 0.0)]
+ [Row(2.0, 0.1)]
+ [Row(2.0, 1.0)]
+ [Row(2.0, 5.5)]
+ [Row(2.0, 110.1)]
+ [Row(2.0, Double.PositiveInfinity)]
+ [Row(2.5, 0.0)]
+ [Row(2.5, 0.1)]
+ [Row(2.5, 1.0)]
+ [Row(2.5, 5.5)]
+ [Row(2.5, 110.1)]
+ [Row(2.5, Double.PositiveInfinity)]
+ [Row(Double.PositiveInfinity, 0.0)]
+ [Row(Double.PositiveInfinity, 0.1)]
+ [Row(Double.PositiveInfinity, 1.0)]
+ [Row(Double.PositiveInfinity, 5.5)]
+ [Row(Double.PositiveInfinity, 110.1)]
+ [Row(Double.PositiveInfinity, Double.PositiveInfinity)]
+ public void ValidateCumulativeDistribution(double dof, double x)
+ {
+ var n = new Chi(dof);
+ Assert.AreEqual(SpecialFunctions.GammaLowerIncomplete(dof / 2.0, x * x / 2.0) / SpecialFunctions.Gamma(dof / 2.0), n.CumulativeDistribution(x));
+ }
+ }
+}
diff --git a/src/UnitTests/DistributionTests/Continuous/ContinuousUniformTests.cs b/src/UnitTests/DistributionTests/Continuous/ContinuousUniformTests.cs
index df083c3f..28cb1cfb 100644
--- a/src/UnitTests/DistributionTests/Continuous/ContinuousUniformTests.cs
+++ b/src/UnitTests/DistributionTests/Continuous/ContinuousUniformTests.cs
@@ -48,8 +48,8 @@ namespace MathNet.Numerics.UnitTests.DistributionTests.Continuous
public void CanCreateContinuousUniform()
{
var n = new ContinuousUniform();
- AssertEx.AreEqual(0.0, n.Lower);
- AssertEx.AreEqual(1.0, n.Upper);
+ Assert.AreEqual(0.0, n.Lower);
+ Assert.AreEqual(1.0, n.Upper);
}
[Test, MultipleAsserts]
@@ -63,8 +63,8 @@ namespace MathNet.Numerics.UnitTests.DistributionTests.Continuous
public void CanCreateContinuousUniform(double lower, double upper)
{
var n = new ContinuousUniform(lower, upper);
- AssertEx.AreEqual(lower, n.Lower);
- AssertEx.AreEqual(upper, n.Upper);
+ Assert.AreEqual(lower, n.Lower);
+ Assert.AreEqual(upper, n.Upper);
}
[Test]
@@ -82,7 +82,7 @@ namespace MathNet.Numerics.UnitTests.DistributionTests.Continuous
public void ValidateToString()
{
var n = new ContinuousUniform(1.0, 2.0);
- AssertEx.AreEqual("ContinuousUniform(Lower = 1, Upper = 2)", n.ToString());
+ Assert.AreEqual("ContinuousUniform(Lower = 1, Upper = 2)", n.ToString());
}
[Test]
@@ -133,7 +133,7 @@ namespace MathNet.Numerics.UnitTests.DistributionTests.Continuous
public void ValidateEntropy(double lower, double upper)
{
var n = new ContinuousUniform(lower, upper);
- AssertEx.AreEqual(Math.Log(upper - lower), n.Entropy);
+ Assert.AreEqual(Math.Log(upper - lower), n.Entropy);
}
[Test]
@@ -146,7 +146,7 @@ namespace MathNet.Numerics.UnitTests.DistributionTests.Continuous
public void ValidateSkewness(double lower, double upper)
{
var n = new ContinuousUniform(lower, upper);
- AssertEx.AreEqual(0.0, n.Skewness);
+ Assert.AreEqual(0.0, n.Skewness);
}
[Test]
@@ -159,7 +159,7 @@ namespace MathNet.Numerics.UnitTests.DistributionTests.Continuous
public void ValidateMode(double lower, double upper)
{
var n = new ContinuousUniform(lower, upper);
- AssertEx.AreEqual( (lower + upper) / 2.0 , n.Mode);
+ Assert.AreEqual( (lower + upper) / 2.0 , n.Mode);
}
[Test]
@@ -172,7 +172,7 @@ namespace MathNet.Numerics.UnitTests.DistributionTests.Continuous
public void ValidateMedian(double lower, double upper)
{
var n = new ContinuousUniform(lower, upper);
- AssertEx.AreEqual((lower + upper) / 2.0, n.Median);
+ Assert.AreEqual((lower + upper) / 2.0, n.Median);
}
[Test]
@@ -185,7 +185,7 @@ namespace MathNet.Numerics.UnitTests.DistributionTests.Continuous
public void ValidateMinimum(double lower, double upper)
{
var n = new ContinuousUniform(lower, upper);
- AssertEx.AreEqual(lower, n.Minimum);
+ Assert.AreEqual(lower, n.Minimum);
}
[Test]
@@ -198,7 +198,7 @@ namespace MathNet.Numerics.UnitTests.DistributionTests.Continuous
public void ValidateMaximum(double lower, double upper)
{
var n = new ContinuousUniform(lower, upper);
- AssertEx.AreEqual(upper, n.Maximum);
+ Assert.AreEqual(upper, n.Maximum);
}
[Test]
@@ -216,11 +216,11 @@ namespace MathNet.Numerics.UnitTests.DistributionTests.Continuous
double x = i - 5.0;
if(x >= lower && x <= upper)
{
- AssertEx.AreEqual(1.0 / (upper - lower), n.Density(x));
+ Assert.AreEqual(1.0 / (upper - lower), n.Density(x));
}
else
{
- AssertEx.AreEqual(0.0, n.Density(x));
+ Assert.AreEqual(0.0, n.Density(x));
}
}
}
@@ -240,11 +240,11 @@ namespace MathNet.Numerics.UnitTests.DistributionTests.Continuous
double x = i - 5.0;
if (x >= lower && x <= upper)
{
- AssertEx.AreEqual(-Math.Log(upper - lower), n.DensityLn(x));
+ Assert.AreEqual(-Math.Log(upper - lower), n.DensityLn(x));
}
else
{
- AssertEx.AreEqual(double.NegativeInfinity, n.DensityLn(x));
+ Assert.AreEqual(double.NegativeInfinity, n.DensityLn(x));
}
}
}
@@ -306,15 +306,15 @@ namespace MathNet.Numerics.UnitTests.DistributionTests.Continuous
double x = i - 5.0;
if (x <= lower)
{
- AssertEx.AreEqual(0.0, n.CumulativeDistribution(x));
+ Assert.AreEqual(0.0, n.CumulativeDistribution(x));
}
else if (x >= upper)
{
- AssertEx.AreEqual(1.0, n.CumulativeDistribution(x));
+ Assert.AreEqual(1.0, n.CumulativeDistribution(x));
}
else
{
- AssertEx.AreEqual((x - lower) / (upper - lower), n.CumulativeDistribution(x));
+ Assert.AreEqual((x - lower) / (upper - lower), n.CumulativeDistribution(x));
}
}
}
diff --git a/src/UnitTests/DistributionTests/Continuous/ErlangTests.cs b/src/UnitTests/DistributionTests/Continuous/ErlangTests.cs
new file mode 100644
index 00000000..e6315202
--- /dev/null
+++ b/src/UnitTests/DistributionTests/Continuous/ErlangTests.cs
@@ -0,0 +1,364 @@
+//
+// Math.NET Numerics, part of the Math.NET Project
+// http://numerics.mathdotnet.com
+// http://github.com/mathnet/mathnet-numerics
+// http://mathnetnumerics.codeplex.com
+//
+// Copyright (c) 2009-2010 Math.NET
+//
+// Permission is hereby granted, free of charge, to any person
+// obtaining a copy of this software and associated documentation
+// files (the "Software"), to deal in the Software without
+// restriction, including without limitation the rights to use,
+// copy, modify, merge, publish, distribute, sublicense, and/or sell
+// copies of the Software, and to permit persons to whom the
+// Software is furnished to do so, subject to the following
+// conditions:
+//
+// The above copyright notice and this permission notice shall be
+// included in all copies or substantial portions of the Software.
+//
+// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
+// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
+// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+// OTHER DEALINGS IN THE SOFTWARE.
+//
+
+namespace MathNet.Numerics.UnitTests.DistributionTests.Continuous
+{
+ using System;
+ using System.Linq;
+ using MbUnit.Framework;
+ using Distributions;
+
+ [TestFixture]
+ public class ErlangTests
+ {
+ [SetUp]
+ public void SetUp()
+ {
+ Control.CheckDistributionParameters = true;
+ }
+
+ [Test, MultipleAsserts]
+ [Row(0, 0.0)]
+ [Row(1, 0.1)]
+ [Row(1, 1.0)]
+ [Row(10, 10.0)]
+ [Row(10, 1.0)]
+ [Row(10, Double.PositiveInfinity)]
+ public void CanCreateErlang(int shape, double invScale)
+ {
+ var n = new Erlang(shape, invScale);
+ Assert.AreEqual(shape, n.Shape);
+ Assert.AreEqual(invScale, n.InvScale);
+ }
+
+ [Test]
+ [ExpectedException(typeof(ArgumentOutOfRangeException))]
+ [Row(1, Double.NaN)]
+ [Row(1, -1.0)]
+ [Row(-1, 1.0)]
+ [Row(-1, -1.0)]
+ [Row(-1, Double.NaN)]
+ public void ErlangCreateFailsWithBadParameters(int shape, double invScale)
+ {
+ var n = new Erlang(shape, invScale);
+ }
+
+ [Test, MultipleAsserts]
+ [Row(0, 0.0)]
+ [Row(1, 0.1)]
+ [Row(1, 1.0)]
+ [Row(10, 10.0)]
+ [Row(10, 1.0)]
+ [Row(10, Double.PositiveInfinity)]
+ public void CanCreateErlangWithShapeInvScale(int shape, double invScale)
+ {
+ var n = Erlang.WithShapeInvScale(shape, invScale);
+ Assert.AreEqual(shape, n.Shape);
+ Assert.AreEqual(invScale, n.InvScale);
+ }
+
+ [Test, MultipleAsserts]
+ [Row(0, 0.0)]
+ [Row(1, 0.1)]
+ [Row(1, 1.0)]
+ [Row(10, 10.0)]
+ [Row(10, 1.0)]
+ [Row(10, Double.PositiveInfinity)]
+ public void CanCreateGammaWithShapeScale(int shape, double scale)
+ {
+ var n = Erlang.WithShapeScale(shape, scale);
+ Assert.AreEqual(shape, n.Shape);
+ Assert.AreEqual(scale, n.Scale);
+ }
+
+ [Test]
+ public void ValidateToString()
+ {
+ var n = new Erlang(1, 2.0);
+ Assert.AreEqual("Erlang(Shape = 1, Inverse Scale = 2)", n.ToString());
+ }
+
+ [Test]
+ [Row(-0)]
+ [Row(0)]
+ [Row(1)]
+ [Row(10)]
+ public void CanSetShape(int shape)
+ {
+ var n = new Erlang(1, 1.0);
+ n.Shape = shape;
+ }
+
+ [Test]
+ [ExpectedException(typeof(ArgumentOutOfRangeException))]
+ public void SetShapeFailsWithNegativeShape()
+ {
+ var n = new Erlang(1, 1.0);
+ n.Shape = -1;
+ }
+
+ [Test]
+ [Row(-0.0)]
+ [Row(0.0)]
+ [Row(0.1)]
+ [Row(1.0)]
+ [Row(10.0)]
+ [Row(Double.PositiveInfinity)]
+ public void CanSetScale(double scale)
+ {
+ var n = new Erlang(1, 1.0);
+ n.Scale = scale;
+ }
+
+ [Test]
+ [ExpectedException(typeof(ArgumentOutOfRangeException))]
+ public void SetScaleFailsWithNegativeScale()
+ {
+ var n = new Erlang(1, 1.0);
+ n.Scale = -1.0;
+ }
+
+ [Test]
+ [Row(-0.0)]
+ [Row(0.0)]
+ [Row(0.1)]
+ [Row(1.0)]
+ [Row(10.0)]
+ [Row(Double.PositiveInfinity)]
+ public void CanSetInvScale(double invScale)
+ {
+ var n = new Erlang(1, 1.0);
+ n.InvScale = invScale;
+ }
+
+ [Test]
+ [ExpectedException(typeof(ArgumentOutOfRangeException))]
+ public void SetInvScaleFailsWithNegativeInvScale()
+ {
+ var n = new Erlang(1, 1.0);
+ n.InvScale = -1.0;
+ }
+
+ [Test]
+ [Row(0, 0.0, Double.NaN)]
+ [Row(1, 0.1, 10.0)]
+ [Row(1, 1.0, 1.0)]
+ [Row(10, 10.0, 1.0)]
+ [Row(10, 1.0, 10.0)]
+ [Row(10, Double.PositiveInfinity, 10.0)]
+ public void ValidateMean(int shape, double invScale, double mean)
+ {
+ var n = new Erlang(shape, invScale);
+ Assert.AreEqual(mean, n.Mean);
+ }
+
+ [Test]
+ [Row(0, 0.0, Double.NaN)]
+ [Row(1, 0.1, 100.0)]
+ [Row(1, 1.0, 1.0)]
+ [Row(10, 10.0, 0.1)]
+ [Row(10, 1.0, 10.0)]
+ [Row(10, Double.PositiveInfinity, 0.0)]
+ public void ValidateVariance(int shape, double invScale, double var)
+ {
+ var n = new Erlang(shape, invScale);
+ AssertHelpers.AlmostEqual(var, n.Variance, 15);
+ }
+
+ [Test]
+ [Row(0, 0.0, Double.NaN)]
+ [Row(1, 0.1, 10.0)]
+ [Row(1, 1.0, 1.0)]
+ [Row(10, 10.0, 0.31622776601683794197697302588502426416723164097476643)]
+ [Row(10, 1.0, 3.1622776601683793319988935444327185337195551393252168)]
+ [Row(10, Double.PositiveInfinity, 0.0)]
+ public void ValidateStdDev(int shape, double invScale, double sdev)
+ {
+ var n = new Erlang(shape, invScale);
+ AssertHelpers.AlmostEqual(sdev, n.StdDev, 15);
+ }
+
+ [Test]
+ [Row(0, 0.0, Double.NaN)]
+ [Row(1, 0.1, 3.3025850929940456285068402234265387271634735938763824)]
+ [Row(1, 1.0, 1.0)]
+ [Row(10, 10.0, 0.23346908548693395836262094490967812177376750477943892)]
+ [Row(10, 1.0, 2.5360541784809796423806123995940423293748689934081866)]
+ [Row(10, Double.PositiveInfinity, 0.0)]
+ public void ValidateEntropy(int shape, double invScale, double entropy)
+ {
+ var n = new Erlang(shape, invScale);
+ AssertHelpers.AlmostEqual(entropy, n.Entropy, 13);
+ }
+
+ [Test]
+ [Row(0, 0.0, Double.NaN)]
+ [Row(1, 0.1, 2.0)]
+ [Row(1, 1.0, 2.0)]
+ [Row(10, 10.0, 0.63245553203367586639977870888654370674391102786504337)]
+ [Row(10, 1.0, 0.63245553203367586639977870888654370674391102786504337)]
+ [Row(10, Double.PositiveInfinity, 0.0)]
+ public void ValidateSkewness(int shape, double invScale, double skewness)
+ {
+ var n = new Erlang(shape, invScale);
+ AssertHelpers.AlmostEqual(skewness, n.Skewness, 15);
+ }
+
+ [Test]
+ [Row(1, 0.1, 0.0)]
+ [Row(1, 1.0, 0.0)]
+ [Row(10, 10.0, 0.9)]
+ [Row(10, 1.0, 9.0)]
+ [Row(10, Double.PositiveInfinity, 10.0)]
+ public void ValidateMode(int shape, double invScale, double mode)
+ {
+ var n = new Erlang(shape, invScale);
+ Assert.AreEqual(mode, n.Mode);
+ }
+
+ [Test]
+ [ExpectedException(typeof(NotSupportedException))]
+ [Row(0, 0.0)]
+ [Row(1, 0.1)]
+ [Row(1, 1.0)]
+ [Row(10, 10.0)]
+ [Row(10, 1.0)]
+ [Row(10, Double.PositiveInfinity)]
+ public void ValidateMedian(int shape, double invScale)
+ {
+ var n = new Erlang(shape, invScale);
+ var median = n.Median;
+ }
+
+ [Test]
+ public void ValidateMinimum()
+ {
+ var n = new Erlang(1, 1.0);
+ Assert.AreEqual(0.0, n.Minimum);
+ }
+
+ [Test]
+ public void ValidateMaximum()
+ {
+ var n = new Erlang(1, 1.0);
+ Assert.AreEqual(System.Double.PositiveInfinity, n.Maximum);
+ }
+
+ [Test]
+ [Row(0, 0.0, 0.0, 0.0)]
+ [Row(0, 0.0, 1.0, 0.0)]
+ [Row(0, 0.0, 10.0, 0.0)]
+ [Row(1, 0.1, 0.0, 0.10000000000000000555111512312578270211815834045410156)]
+ [Row(1, 0.1, 1.0, 0.090483741803595961836995913651194571475319347018875963)]
+ [Row(1, 0.1, 10.0, 0.036787944117144234201693506390001264039984687455876246)]
+ [Row(1, 1.0, 0.0, 1.0)]
+ [Row(1, 1.0, 1.0, 0.36787944117144232159552377016146086744581113103176804)]
+ [Row(1, 1.0, 10.0, 0.000045399929762484851535591515560550610237918088866564953)]
+ [Row(10, 10.0, 0.0, 0.0)]
+ [Row(10, 10.0, 1.0, 1.2511003572113329898476497894772544708420990097708588)]
+ [Row(10, 10.0, 10.0, 1.0251532120868705806216092933926141802686541811003037e-30)]
+ [Row(10, 1.0, 0.0, 0.0)]
+ [Row(10, 1.0, 1.0, 0.0000010137771196302974029859010421116095333052555418644397)]
+ [Row(10, 1.0, 10.0, 0.12511003572113329898476497894772544708420990097708601)]
+ [Row(10, Double.PositiveInfinity, 0.0, 0.0)]
+ [Row(10, Double.PositiveInfinity, 1.0, 0.0)]
+ [Row(10, Double.PositiveInfinity, 10.0, Double.PositiveInfinity)]
+ public void ValidateDensity(int shape, double invScale, double x, double pdf)
+ {
+ var n = new Erlang(shape, invScale);
+ AssertHelpers.AlmostEqual(pdf, n.Density(x), 14);
+ }
+
+ [Test]
+ [Row(0, 0.0, 0.0, Double.NegativeInfinity)]
+ [Row(0, 0.0, 1.0, Double.NegativeInfinity)]
+ [Row(0, 0.0, 10.0, Double.NegativeInfinity)]
+ [Row(1, 0.1, 0.0, -2.3025850929940456285068402234265387271634735938763824)]
+ [Row(1, 0.1, 1.0, -2.402585092994045634057955346552321429281631934330484)]
+ [Row(1, 0.1, 10.0, -3.3025850929940456285068402234265387271634735938763824)]
+ [Row(1, 1.0, 0.0, 0.0)]
+ [Row(1, 1.0, 1.0, -1.0)]
+ [Row(1, 1.0, 10.0, -10.0)]
+ [Row(10, 10.0, 0.0, Double.NegativeInfinity)]
+ [Row(10, 10.0, 1.0, 0.22402344985898722897219667227693591172986563062456522)]
+ [Row(10, 10.0, 10.0, -69.052710713194601614865880235563786219860220971716511)]
+ [Row(10, 1.0, 0.0, Double.NegativeInfinity)]
+ [Row(10, 1.0, 1.0, -13.801827480081469611207717874566706164281149255663166)]
+ [Row(10, 1.0, 10.0, -2.0785616431350584550457947824074282958712358580042068)]
+ [Row(10, Double.PositiveInfinity, 0.0, Double.NegativeInfinity)]
+ [Row(10, Double.PositiveInfinity, 1.0, Double.NegativeInfinity)]
+ [Row(10, Double.PositiveInfinity, 10.0, Double.PositiveInfinity)]
+ public void ValidateDensityLn(int shape, double invScale, double x, double pdfln)
+ {
+ var n = new Erlang(shape, invScale);
+ AssertHelpers.AlmostEqual(pdfln, n.DensityLn(x), 14);
+ }
+
+ [Test]
+ public void CanSample()
+ {
+ var n = new Erlang(1, 2.0);
+ var d = n.Sample();
+ }
+
+ [Test]
+ public void CanSampleSequence()
+ {
+ var n = new Erlang(1, 2.0);
+ var ied = n.Samples();
+ var e = ied.Take(5).ToArray();
+ }
+
+ [Test]
+ [Row(0, 0.0, 0.0, 0.0)]
+ [Row(0, 0.0, 1.0, 0.0)]
+ [Row(0, 0.0, 10.0, 0.0)]
+ [Row(1, 0.1, 0.0, 0.0)]
+ [Row(1, 0.1, 1.0, 0.095162581964040431858607615783064404690935346242622848)]
+ [Row(1, 0.1, 10.0, 0.63212055882855767840447622983853913255418886896823196)]
+ [Row(1, 1.0, 0.0, 0.0)]
+ [Row(1, 1.0, 1.0, 0.63212055882855767840447622983853913255418886896823196)]
+ [Row(1, 1.0, 10.0, 0.99995460007023751514846440848443944938976208191113396)]
+ [Row(10, 10.0, 0.0, 0.0)]
+ [Row(10, 10.0, 1.0, 0.54207028552814779168583514294066541824736464003242184)]
+ [Row(10, 10.0, 10.0, 0.99999999999999999999999999999988746526039157266114706)]
+ [Row(10, 1.0, 0.0, 0.0)]
+ [Row(10, 1.0, 1.0, 0.00000011142547833872067735305068724025236288094949815466035)]
+ [Row(10, 1.0, 10.0, 0.54207028552814779168583514294066541824736464003242184)]
+ [Row(10, Double.PositiveInfinity, 0.0, 0.0)]
+ [Row(10, Double.PositiveInfinity, 1.0, 0.0)]
+ [Row(10, Double.PositiveInfinity, 10.0, 1.0)]
+ public void ValidateCumulativeDistribution(int shape, double invScale, double x, double cdf)
+ {
+ var n = new Erlang(shape, invScale);
+ AssertHelpers.AlmostEqual(cdf, n.CumulativeDistribution(x), 14);
+ }
+ }
+}
diff --git a/src/UnitTests/DistributionTests/Continuous/ExponentialTests.cs b/src/UnitTests/DistributionTests/Continuous/ExponentialTests.cs
new file mode 100644
index 00000000..eafbfdb9
--- /dev/null
+++ b/src/UnitTests/DistributionTests/Continuous/ExponentialTests.cs
@@ -0,0 +1,305 @@
+//
+// Math.NET Numerics, part of the Math.NET Project
+// http://numerics.mathdotnet.com
+// http://github.com/mathnet/mathnet-numerics
+// http://mathnetnumerics.codeplex.com
+//
+// Copyright (c) 2009-2010 Math.NET
+//
+// Permission is hereby granted, free of charge, to any person
+// obtaining a copy of this software and associated documentation
+// files (the "Software"), to deal in the Software without
+// restriction, including without limitation the rights to use,
+// copy, modify, merge, publish, distribute, sublicense, and/or sell
+// copies of the Software, and to permit persons to whom the
+// Software is furnished to do so, subject to the following
+// conditions:
+//
+// The above copyright notice and this permission notice shall be
+// included in all copies or substantial portions of the Software.
+//
+// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
+// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
+// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+// OTHER DEALINGS IN THE SOFTWARE.
+//
+
+namespace MathNet.Numerics.UnitTests.DistributionTests.Continuous
+{
+ using System;
+ using System.Linq;
+ using MbUnit.Framework;
+ using Distributions;
+
+ [TestFixture]
+ public class ExponentialTests
+ {
+ [SetUp]
+ public void SetUp()
+ {
+ Control.CheckDistributionParameters = true;
+ }
+
+ [Test, MultipleAsserts]
+ [Row(0.0)]
+ [Row(0.1)]
+ [Row(1.0)]
+ [Row(10.0)]
+ [Row(Double.PositiveInfinity)]
+ public void CanCreateExponential(double lambda)
+ {
+ var n = new Exponential(lambda);
+ Assert.AreEqual(lambda, n.Lambda);
+ }
+
+ [Test]
+ [ExpectedException(typeof(ArgumentOutOfRangeException))]
+ [Row(Double.NaN)]
+ [Row(-1.0)]
+ [Row(-10.0)]
+ public void ExponentialCreateFailsWithBadParameters(double lambda)
+ {
+ var n = new Exponential(lambda);
+ }
+
+ [Test]
+ public void ValidateToString()
+ {
+ var n = new Exponential(2.0);
+ Assert.AreEqual("Exponential(Lambda = 2)", n.ToString());
+ }
+
+ [Test]
+ [Row(-0.0)]
+ [Row(0.0)]
+ [Row(0.1)]
+ [Row(1.0)]
+ [Row(10.0)]
+ [Row(Double.PositiveInfinity)]
+ public void CanSetLambda(double lambda)
+ {
+ var n = new Exponential(1.0);
+ n.Lambda = lambda;
+ }
+
+ [Test]
+ [ExpectedException(typeof(ArgumentOutOfRangeException))]
+ public void SetLambdaFailsWithNegativeLambda()
+ {
+ var n = new Exponential(1.0);
+ n.Lambda = -1.0;
+ }
+
+ [Test]
+ [Row(0.0)]
+ [Row(0.1)]
+ [Row(1.0)]
+ [Row(10.0)]
+ [Row(Double.PositiveInfinity)]
+ public void ValidateMean(double lambda)
+ {
+ var n = new Exponential(lambda);
+ Assert.AreEqual(1.0 / lambda, n.Mean);
+ }
+
+ [Test]
+ [Row(0.0)]
+ [Row(0.1)]
+ [Row(1.0)]
+ [Row(10.0)]
+ [Row(Double.PositiveInfinity)]
+ public void ValidateVariance(double lambda)
+ {
+ var n = new Exponential(lambda);
+ Assert.AreEqual(1.0 / (lambda * lambda), n.Variance);
+ }
+
+ [Test]
+ [Row(0.0)]
+ [Row(0.1)]
+ [Row(1.0)]
+ [Row(10.0)]
+ [Row(Double.PositiveInfinity)]
+ public void ValidateStdDev(double lambda)
+ {
+ var n = new Exponential(lambda);
+ Assert.AreEqual(1.0 / lambda, n.StdDev);
+ }
+
+ [Test]
+ [Row(0.0)]
+ [Row(0.1)]
+ [Row(1.0)]
+ [Row(10.0)]
+ [Row(Double.PositiveInfinity)]
+ public void ValidateEntropy(double lambda)
+ {
+ var n = new Exponential(lambda);
+ Assert.AreEqual(1.0 - Math.Log(lambda), n.Entropy);
+ }
+
+ [Test]
+ [Row(0.0)]
+ [Row(0.1)]
+ [Row(1.0)]
+ [Row(10.0)]
+ [Row(Double.PositiveInfinity)]
+ public void ValidateSkewness(double lambda)
+ {
+ var n = new Exponential(lambda);
+ Assert.AreEqual(2.0, n.Skewness);
+ }
+
+ [Test]
+ [Row(0.0)]
+ [Row(0.1)]
+ [Row(1.0)]
+ [Row(10.0)]
+ [Row(Double.PositiveInfinity)]
+ public void ValidateMode(double lambda)
+ {
+ var n = new Exponential(lambda);
+ Assert.AreEqual(0.0, n.Mode);
+ }
+
+ [Test]
+ [Row(0.0)]
+ [Row(0.1)]
+ [Row(1.0)]
+ [Row(10.0)]
+ [Row(Double.PositiveInfinity)]
+ public void ValidateMedian(double lambda)
+ {
+ var n = new Exponential(lambda);
+ Assert.AreEqual(Math.Log(2.0) / lambda, n.Median);
+ }
+
+ [Test]
+ public void ValidateMinimum()
+ {
+ var n = new Exponential(1.0);
+ Assert.AreEqual(0.0, n.Minimum);
+ }
+
+ [Test]
+ public void ValidateMaximum()
+ {
+ var n = new Exponential(1.0);
+ Assert.AreEqual(Double.PositiveInfinity, n.Maximum);
+ }
+
+ [Test]
+ [Row(0.0, 0.0)]
+ [Row(0.1, 0.0)]
+ [Row(1.0, 0.0)]
+ [Row(10.0, 0.0)]
+ [Row(Double.PositiveInfinity, 0.0)]
+ [Row(0.0, 0.1)]
+ [Row(0.1, 0.1)]
+ [Row(1.0, 0.1)]
+ [Row(10.0, 0.1)]
+ [Row(Double.PositiveInfinity, 0.1)]
+ [Row(0.0, 1.0)]
+ [Row(0.1, 1.0)]
+ [Row(1.0, 1.0)]
+ [Row(10.0, 1.0)]
+ [Row(Double.PositiveInfinity, 1.0)]
+ [Row(0.0, Double.PositiveInfinity)]
+ [Row(0.1, Double.PositiveInfinity)]
+ [Row(1.0, Double.PositiveInfinity)]
+ [Row(10.0, Double.PositiveInfinity)]
+ [Row(Double.PositiveInfinity, Double.PositiveInfinity)]
+ public void ValidateDensity(double lambda, double x)
+ {
+ var n = new Exponential(lambda);
+ if (x >= 0)
+ {
+ Assert.AreEqual(lambda * Math.Exp(-lambda * x), n.Density(x));
+ }
+ else
+ {
+ Assert.AreEqual(0.0, n.Density(lambda));
+ }
+ }
+
+ [Test]
+ [Row(0.0, 0.0)]
+ [Row(0.1, 0.0)]
+ [Row(1.0, 0.0)]
+ [Row(10.0, 0.0)]
+ [Row(Double.PositiveInfinity, 0.0)]
+ [Row(0.0, 0.1)]
+ [Row(0.1, 0.1)]
+ [Row(1.0, 0.1)]
+ [Row(10.0, 0.1)]
+ [Row(Double.PositiveInfinity, 0.1)]
+ [Row(0.0, 1.0)]
+ [Row(0.1, 1.0)]
+ [Row(1.0, 1.0)]
+ [Row(10.0, 1.0)]
+ [Row(Double.PositiveInfinity, 1.0)]
+ [Row(0.0, Double.PositiveInfinity)]
+ [Row(0.1, Double.PositiveInfinity)]
+ [Row(1.0, Double.PositiveInfinity)]
+ [Row(10.0, Double.PositiveInfinity)]
+ [Row(Double.PositiveInfinity, Double.PositiveInfinity)]
+ public void ValidateDensityLn(double lambda, double x)
+ {
+ var n = new Exponential(lambda);
+ Assert.AreEqual(Math.Log(lambda) - lambda * x, n.DensityLn(x));
+ }
+
+ [Test]
+ public void CanSample()
+ {
+ var n = new Exponential(1.0);
+ var d = n.Sample();
+ }
+
+ [Test]
+ public void CanSampleSequence()
+ {
+ var n = new Exponential(1.0);
+ var ied = n.Samples();
+ var e = ied.Take(5).ToArray();
+ }
+
+ [Test]
+ [Row(0.0, 0.0)]
+ [Row(0.1, 0.0)]
+ [Row(1.0, 0.0)]
+ [Row(10.0, 0.0)]
+ [Row(Double.PositiveInfinity, 0.0)]
+ [Row(0.0, 0.1)]
+ [Row(0.1, 0.1)]
+ [Row(1.0, 0.1)]
+ [Row(10.0, 0.1)]
+ [Row(Double.PositiveInfinity, 0.1)]
+ [Row(0.0, 1.0)]
+ [Row(0.1, 1.0)]
+ [Row(1.0, 1.0)]
+ [Row(10.0, 1.0)]
+ [Row(Double.PositiveInfinity, 1.0)]
+ [Row(0.0, Double.PositiveInfinity)]
+ [Row(0.1, Double.PositiveInfinity)]
+ [Row(1.0, Double.PositiveInfinity)]
+ [Row(10.0, Double.PositiveInfinity)]
+ [Row(Double.PositiveInfinity, Double.PositiveInfinity)]
+ public void ValidateCumulativeDistribution(double lambda, double x)
+ {
+ var n = new Exponential(lambda);
+ if (x >= 0.0)
+ {
+ Assert.AreEqual(1.0 - Math.Exp(-lambda * x), n.CumulativeDistribution(x));
+ }
+ else
+ {
+ Assert.AreEqual(0.0, n.CumulativeDistribution(x));
+ }
+ }
+ }
+}
diff --git a/src/UnitTests/DistributionTests/Continuous/FisherSnedecorTests.cs b/src/UnitTests/DistributionTests/Continuous/FisherSnedecorTests.cs
new file mode 100644
index 00000000..0c67e276
--- /dev/null
+++ b/src/UnitTests/DistributionTests/Continuous/FisherSnedecorTests.cs
@@ -0,0 +1,371 @@
+//
+// Math.NET Numerics, part of the Math.NET Project
+// http://numerics.mathdotnet.com
+// http://github.com/mathnet/mathnet-numerics
+// http://mathnetnumerics.codeplex.com
+//
+// Copyright (c) 2009-2010 Math.NET
+//
+// Permission is hereby granted, free of charge, to any person
+// obtaining a copy of this software and associated documentation
+// files (the "Software"), to deal in the Software without
+// restriction, including without limitation the rights to use,
+// copy, modify, merge, publish, distribute, sublicense, and/or sell
+// copies of the Software, and to permit persons to whom the
+// Software is furnished to do so, subject to the following
+// conditions:
+//
+// The above copyright notice and this permission notice shall be
+// included in all copies or substantial portions of the Software.
+//
+// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
+// OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
+// HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+// WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+// FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+// OTHER DEALINGS IN THE SOFTWARE.
+//
+
+namespace MathNet.Numerics.UnitTests.DistributionTests.Continuous
+{
+ using System;
+ using System.Linq;
+ using MbUnit.Framework;
+ using Distributions;
+
+ [TestFixture]
+ public class FisherSnedecorTests
+ {
+ [SetUp]
+ public void SetUp()
+ {
+ Control.CheckDistributionParameters = true;
+ }
+
+ [Test, MultipleAsserts]
+ [Row(0.1, 0.1)]
+ [Row(1.0, 0.1)]
+ [Row(10.0, 0.1)]
+ [Row(Double.PositiveInfinity, 0.1)]
+ [Row(0.1, 1.0)]
+ [Row(1.0, 1.0)]
+ [Row(10.0, 1.0)]
+ [Row(Double.PositiveInfinity, 1.0)]
+ [Row(0.1, Double.PositiveInfinity)]
+ [Row(1.0, Double.PositiveInfinity)]
+ [Row(10.0, Double.PositiveInfinity)]
+ [Row(Double.PositiveInfinity, Double.PositiveInfinity)]
+ public void CanCreateFisherSnedecor(double d1, double d2)
+ {
+ var n = new FisherSnedecor(d1, d2);
+ Assert.AreEqual(d1, n.DegreeOfFreedom1);
+ Assert.AreEqual(d2, n.DegreeOfFreedom2);
+ }
+
+ [Test]
+ [ExpectedException(typeof(ArgumentOutOfRangeException))]
+ [Row(Double.NaN, Double.NaN)]
+ [Row(0.0, Double.NaN)]
+ [Row(-1.0, Double.NaN)]
+ [Row(-10.0, Double.NaN)]
+ [Row(Double.NaN, 0.0)]
+ [Row(0.0, 0.0)]
+ [Row(-1.0, 0.0)]
+ [Row(-10.0, 0.0)]
+ [Row(Double.NaN, -1.0)]
+ [Row(0.0, -1.0)]
+ [Row(-1.0, -1.0)]
+ [Row(-10.0, -1.0)]
+ [Row(Double.NaN, -10.0)]
+ [Row(0.0, -10.0)]
+ [Row(-1.0, -10.0)]
+ [Row(-10.0, -10.0)]
+ public void FisherSnedecorCreateFailsWithBadParameters(double d1, double d2)
+ {
+ var n = new FisherSnedecor(d1, d2);
+ }
+
+ [Test]
+ public void ValidateToString()
+ {
+ var n = new FisherSnedecor(2.0, 1.0);
+ Assert.AreEqual("FisherSnedecor(DegreeOfFreedom1 = 2, DegreeOfFreedom2 = 1)", n.ToString());
+ }
+
+ [Test]
+ [Row(0.1)]
+ [Row(1.0)]
+ [Row(10.0)]
+ [Row(Double.PositiveInfinity)]
+ public void CanSetDegreeOfFreedom1(double d1)
+ {
+ var n = new FisherSnedecor(1.0, 2.0);
+ n.DegreeOfFreedom1 = d1;
+ }
+
+ [Test]
+ [ExpectedException(typeof(ArgumentOutOfRangeException))]
+ public void SetDegreeOfFreedom1FailsWithNegativeDegreeOfFreedom()
+ {
+ var n = new FisherSnedecor(1.0, 2.0);
+ n.DegreeOfFreedom1 = -1.0;
+ }
+
+ [Test]
+ [Row(0.1)]
+ [Row(1.0)]
+ [Row(10.0)]
+ [Row(Double.PositiveInfinity)]
+ public void CanSetDegreeOfFreedom2(double d2)
+ {
+ var n = new FisherSnedecor(1.0, 2.0);
+ n.DegreeOfFreedom2 = d2;
+ }
+
+ [Test]
+ [ExpectedException(typeof(ArgumentOutOfRangeException))]
+ public void SetDegreeOfFreedom2FailsWithNegativeDegreeOfFreedom()
+ {
+ var n = new FisherSnedecor(1.0, 2.0);
+ n.DegreeOfFreedom2 = -1.0;
+ }
+
+ [Test]
+ [Row(0.1, 0.1)]
+ [Row(1.0, 0.1)]
+ [Row(10.0, 0.1)]
+ [Row(Double.PositiveInfinity, 0.1)]
+ [Row(0.1, 1.0)]
+ [Row(1.0, 1.0)]
+ [Row(10.0, 1.0)]
+ [Row(Double.PositiveInfinity, 1.0)]
+ [Row(0.1, Double.PositiveInfinity)]
+ [Row(1.0, Double.PositiveInfinity)]
+ [Row(10.0, Double.PositiveInfinity)]
+ [Row(Double.PositiveInfinity, Double.PositiveInfinity)]
+ public void ValidateMean(double d1, double d2)
+ {
+ var n = new FisherSnedecor(d1, d2);
+ if (d2 > 2)
+ {
+ Assert.AreEqual(d2 / (d2 - 2.0), n.Mean);
+ }
+ }
+
+ [Test]
+ [Row(0.1, 0.1)]
+ [Row(1.0, 0.1)]
+ [Row(10.0, 0.1)]
+ [Row(Double.PositiveInfinity, 0.1)]
+ [Row(0.1, 1.0)]
+ [Row(1.0, 1.0)]
+ [Row(10.0, 1.0)]
+ [Row(Double.PositiveInfinity, 1.0)]
+ [Row(0.1, Double.PositiveInfinity)]
+ [Row(1.0, Double.PositiveInfinity)]
+ [Row(10.0, Double.PositiveInfinity)]
+ [Row(Double.PositiveInfinity, Double.PositiveInfinity)]
+ public void ValidateVariance(double d1, double d2)
+ {
+ var n = new FisherSnedecor(d1, d2);
+ if (d2 > 4)
+ {
+ Assert.AreEqual((2.0 * d2 * d2 * (d1 + d2 - 2.0)) / (d1 * (d2 - 2.0) * (d2 - 2.0) * (d2 - 4.0)), n.Variance);
+ }
+ }
+
+ [Test]
+ [Row(0.1, 0.1)]
+ [Row(1.0, 0.1)]
+ [Row(10.0, 0.1)]
+ [Row(Double.PositiveInfinity, 0.1)]
+ [Row(0.1, 1.0)]
+ [Row(1.0, 1.0)]
+ [Row(10.0, 1.0)]
+ [Row(Double.PositiveInfinity, 1.0)]
+ [Row(0.1, Double.PositiveInfinity)]
+ [Row(1.0, Double.PositiveInfinity)]
+ [Row(10.0, Double.PositiveInfinity)]
+ [Row(Double.PositiveInfinity, Double.PositiveInfinity)]
+ public void ValidateStdDev(double d1, double d2)
+ {
+ var n = new FisherSnedecor(d1, d2);
+ if (d2 > 4)
+ {
+ Assert.AreEqual(Math.Sqrt(n.Variance), n.StdDev);
+ }
+ }
+
+ [Test]
+ [ExpectedException(typeof(NotSupportedException))]
+ public void ValidateEntropy()
+ {
+ var n = new FisherSnedecor(1.0, 2.0);
+ var ent = n.Entropy;
+ }
+
+ [Test]
+ [Row(0.1, 0.1)]
+ [Row(1.0, 0.1)]
+ [Row(10.0, 0.1)]
+ [Row(Double.PositiveInfinity, 0.1)]
+ [Row(0.1, 1.0)]
+ [Row(1.0, 1.0)]
+ [Row(10.0, 1.0)]
+ [Row(Double.PositiveInfinity, 1.0)]
+ [Row(0.1, Double.PositiveInfinity)]
+ [Row(1.0, Double.PositiveInfinity)]
+ [Row(10.0, Double.PositiveInfinity)]
+ [Row(Double.PositiveInfinity, Double.PositiveInfinity)]
+ public void ValidateSkewness(double d1, double d2)
+ {
+ var n = new FisherSnedecor(d1, d2);
+ if (d2 > 6)
+ {
+ Assert.AreEqual(((2.0 * d1 + d2 - 2.0) * Math.Sqrt(8.0 * (d2 - 4.0))) / ((d2 - 6.0) * Math.Sqrt(d1 * (d1 + d2 - 2.0))), n.Skewness);
+ }
+ }
+
+ [Test]
+ [Row(0.1, 0.1)]
+ [Row(1.0, 0.1)]
+ [Row(10.0, 0.1)]
+ [Row(100.0, 0.1)]
+ [Row(0.1, 1.0)]
+ [Row(1.0, 1.0)]
+ [Row(10.0, 1.0)]
+ [Row(100.0, 1.0)]
+ [Row(0.1, 100.0)]
+ [Row(1.0, 100.0)]
+ [Row(10.0, 100.0)]
+ [Row(100.0, 100.0)]
+ public void ValidateMode(double d1, double d2)
+ {
+ var n = new FisherSnedecor(d1, d2);
+ if (d1 > 2)
+ {
+ Assert.AreEqual((d2 * (d1 - 2.0)) / (d1 * (d2 + 2.0)), n.Mode);
+ }
+ }
+
+ [Test]
+ [ExpectedException(typeof(NotSupportedException))]
+ public void ValidateMedian()
+ {
+ var n = new FisherSnedecor(1.0, 2.0);
+ var m = n.Median;
+ }
+
+ [Test]
+ public void ValidateMinimum()
+ {
+ var n = new FisherSnedecor(1.0, 2.0);
+ Assert.AreEqual(0.0, n.Minimum);
+ }
+
+ [Test]
+ public void ValidateMaximum()
+ {
+ var n = new FisherSnedecor(1.0, 2.0);
+ Assert.AreEqual(Double.PositiveInfinity, n.Maximum);
+ }
+
+ [Test]
+ [Row(0.1, 0.1, 1.0)]
+ [Row(1.0, 0.1, 1.0)]
+ [Row(10.0, 0.1, 1.0)]
+ [Row(100.0, 0.1, 1.0)]
+ [Row(0.1, 1.0, 1.0)]
+ [Row(1.0, 1.0, 1.0)]
+ [Row(10.0, 1.0, 1.0)]
+ [Row(100.0, 1.0, 1.0)]
+ [Row(0.1, 100.0, 1.0)]
+ [Row(1.0, 100.0, 1.0)]
+ [Row(10.0, 100.0, 1.0)]
+ [Row(100.0, 100.0, 1.0)]
+ [Row(0.1, 0.1, 10.0)]
+ [Row(1.0, 0.1, 10.0)]
+ [Row(10.0, 0.1, 10.0)]
+ [Row(100.0, 0.1, 10.0)]
+ [Row(0.1, 1.0, 10.0)]
+ [Row(1.0, 1.0, 10.0)]
+ [Row(10.0, 1.0, 10.0)]
+ [Row(100.0, 1.0, 10.0)]
+ [Row(0.1, 100.0, 10.0)]
+ [Row(1.0, 100.0, 10.0)]
+ [Row(10.0, 100.0, 10.0)]
+ [Row(100.0, 100.0, 10.0)]
+ public void ValidateDensity(double d1, double d2, double x)
+ {
+ var n = new FisherSnedecor(d1, d2);
+ Assert.AreEqual(Math.Sqrt(Math.Pow(d1 * x, d1) * Math.Pow(d2, d2) / (Math.Pow(d1 * x + d2, d1 + d2))) / (x * SpecialFunctions.Beta(d1 / 2.0, d2 / 2.0)), n.Density(x));
+ }
+
+ [Test]
+ [Row(0.1, 0.1, 1.0)]
+ [Row(1.0, 0.1, 1.0)]
+ [Row(10.0, 0.1, 1.0)]
+ [Row(100.0, 0.1, 1.0)]
+ [Row(0.1, 1.0, 1.0)]
+ [Row(1.0, 1.0, 1.0)]
+ [Row(10.0, 1.0, 1.0)]
+ [Row(100.0, 1.0, 1.0)]
+ [Row(0.1, 100.0, 1.0)]
+ [Row(1.0, 100.0, 1.0)]
+ [Row(10.0, 100.0, 1.0)]
+ [Row(100.0, 100.0, 1.0)]
+ [Row(0.1, 0.1, 10.0)]
+ [Row(1.0, 0.1, 10.0)]
+ [Row(10.0, 0.1, 10.0)]
+ [Row(100.0, 0.1, 10.0)]
+ [Row(0.1, 1.0, 10.0)]
+ [Row(1.0, 1.0, 10.0)]
+ [Row(10.0, 1.0, 10.0)]
+ [Row(100.0, 1.0, 10.0)]
+ [Row(0.1, 100.0, 10.0)]
+ [Row(1.0, 100.0, 10.0)]
+ [Row(10.0, 100.0, 10.0)]
+ [Row(100.0, 100.0, 10.0)]
+ public void ValidateDensityLn(double d1, double d2, double x)
+ {
+ var n = new FisherSnedecor(d1, d2);
+ Assert.AreEqual(Math.Log(n.Density(x)), n.DensityLn(x));
+ }
+
+ [Test]
+ public void CanSample()
+ {
+ var n = new FisherSnedecor(1.0, 2.0);
+ var d = n.Sample();
+ }
+
+ [Test]
+ public void CanSampleSequence()
+ {
+ var n = new FisherSnedecor(1.0, 2.0);
+ var ied = n.Samples();
+ var e = ied.Take(5).ToArray();
+ }
+
+ [Test]
+ [Row(0.1, 0.1, 1.0)]
+ [Row(1.0, 0.1, 1.0)]
+ [Row(10.0, 0.1, 1.0)]
+ [Row(0.1, 1.0, 1.0)]
+ [Row(1.0, 1.0, 1.0)]
+ [Row(10.0, 1.0, 1.0)]
+ [Row(0.1, 0.1, 10.0)]
+ [Row(1.0, 0.1, 10.0)]
+ [Row(10.0, 0.1, 10.0)]
+ [Row(0.1, 1.0, 10.0)]
+ [Row(1.0, 1.0, 10.0)]
+ [Row(10.0, 1.0, 10.0)]
+ public void ValidateCumulativeDistribution(double d1, double d2, double x)
+ {
+ var n = new FisherSnedecor(d1, d2);
+ Assert.AreEqual(SpecialFunctions.BetaRegularized(d1 / 2.0, d2 / 2.0, d1 * d2 / (d1 + d1 * d2)), n.CumulativeDistribution(x));
+ }
+ }
+}
diff --git a/src/UnitTests/DistributionTests/Continuous/GammaTests.cs b/src/UnitTests/DistributionTests/Continuous/GammaTests.cs
index 013fe9ce..4bb6c6cc 100644
--- a/src/UnitTests/DistributionTests/Continuous/GammaTests.cs
+++ b/src/UnitTests/DistributionTests/Continuous/GammaTests.cs
@@ -54,8 +54,8 @@ namespace MathNet.Numerics.UnitTests.DistributionTests.Continuous
public void CanCreateGamma(double shape, double invScale)
{
var n = new Gamma(shape, invScale);
- AssertEx.AreEqual(shape, n.Shape);
- AssertEx.AreEqual(invScale, n.InvScale);
+ Assert.AreEqual(shape, n.Shape);
+ Assert.AreEqual(invScale, n.InvScale);
}
[Test]
@@ -81,8 +81,8 @@ namespace MathNet.Numerics.UnitTests.DistributionTests.Continuous
public void CanCreateGammaWithShapeInvScale(double shape, double invScale)
{
var n = Gamma.WithShapeInvScale(shape, invScale);
- AssertEx.AreEqual