JetBrains.TemplateEngine

Defines the kind of file change done during template creation.

The file is created.

The file is removed.

The file is overwritten.

The file is modified.

The component provides values which may be bound to "bind" symbol. The priority order is determined by .

The user friendly name of the component.

Prefix that is used in binding to refernece the component.

If set to true, the component required exact prefix match to be used.

Gets the value corresponding to .

template engine environment settings. the value to retrieve (without prefix). cancellation token.

Provider of SDK installation info.

Current SDK installation semver version string.

SDK version.

All installed SDK installations semver version strings.

SDK version strings.

Provides localized suggestion on action to be taken so that constraints requiring specified workloads can be met. This should be specific for current host (e.g. action to be taken for VS will differ from CLI host action.) This method should not perform any heavy processing (external services or file system queries) - as it's being synchronously executed as part of constraint evaluation.

SDK versions required by a constraint (in an 'OR' relationship). SDK versions installed, that can meet the constraint - instructions should be provided to switch to any of those. Localized string with remedy suggestion specific to current host.

Provider of descriptors of SDK workloads available to particular host (that is usually providing this component).

Fetches set of installed workloads.

Set of installed workloads.

Workloads required by a constraint (in an 'OR' relationship). Localized string with remedy suggestion specific to current host.

SDK workload descriptor. Analogous to SDK type Microsoft.NET.Sdk.WorkloadManifestReader.WorkloadResolver.WorkloadInfo (https://github.com/dotnet/sdk/blob/main/src/Resolvers/Microsoft.NET.Sdk.WorkloadManifestReader/WorkloadResolver.cs#L645).

Creates new instance of .

Workload identifier. Workload description string - expected to be localized.

Workload identifier (from manifest).

Workload description string - expected to be localized.

Constraint that can be used to filter out from further processing.

Gets the constraint type. Should be unique and match the definition in `template.json` and type given in .

Gets the user friendly constraint name, that can be used in UI.

Evaluates if the constraint is met based on .

Template constraint factory used to create and initialize the instance of . The template constraint should be initialized after creation to be able to evaluate in constraint is met performant enough.

Gets the constraint type. Should be unique and match the definition in `template.json`.

Creates and initializes new based on current .

Represents information about template constraint defintion in template cache .

Creates instance of the clase.

Constraint type, matches the type defined in implementation and template.json. Arguments for constraint evaluation. when is null or whitespace.

Gets the constraint type.

Gets the constraint argumens.

Result of constraint evaluation.

Gets the executed .

Gets the executed constraint type.

Determines if the conditions are met.

Localized message explaining why the constraint is not met.

Localized message explaining what should be done by user in order the constraint is met. Optional.

Creates for allowed evaluation result.

The executed constraint.

Creates for restricted evaluation result.

The executed constraint. The reason of the restriction. Call to action to fulfill the restriction (optional).

Creates for the case when the evaluation has failed.

The executed constraint. The reason of the failure. Call to action to resolve the problem (optional).

Creates for the case when the constraint initialization has failed. If constraint was intiialized, use instead.

The executed constraint type. The reason of the failure. Call to action to resolve the problem (optional).

Indicates resulting precedence of a parameter (after considering and conditions results).

Parameter value is required to be supplied by the host.

Parameter is optional.

Parameter value is implicitly populated.

Parameter is disabled - it's value is not required and will not be used.

Defines baseline configuration information. Baseline configuration is a set of predefined template parameters and their values.

Gets baseline description.

Gets collection of parameters to be set with given baseline.

Defines the representation of a parameter in template cache. This doesn't include parameters with choices which are represented by .

Gets the type of the parameter.

Gets the default value to be used if the user did not provide a value.

Gets the friendly name of the parameter to be displayed to the user. This property is localized if localizations are provided.

Gets the detailed description of the parameter to be displayed to the user. This property is localized if localizations are provided.

Represents a tag or a parameter symbol with choices in template cache file.

Gets the friendly name of the choice parameter symbol to be displayed to the user.

Gets the description of the choice parameter symbol to be displayed to the user.

Gets the dictionary containing the possible choices for this tag or parameter symbol. Keys represents the identifiers of the choices.

Gets the identifier of the default choice to be used when no choice was explicitly selected.

Custom composition manager that allows mapping between and components that implement . Used for generators, post actions, different implementations of installers, providers...

Gets specific component via . E.g: to lookup implementation of "Restore NuGet packages" post action, pass in {210D431B-A78B-4D2F-B762-4ED3E3EA9025} .

If and mismatch, false is returned. type to lookup. that is defined in . singleton instance of requested component. true if component was found.

Returns all components of specified type.

type of component. singleton component instances of requested type.

Adds component to manager, which can be looked up later via or .

type that implements .

Adds list of components to manager, which can be looked up later via or .

Adds component to manager, which can be looked up later via or .

Interface type that added component implements. Instance of type that implements .

The interface represents the effects of template instantiation: the file changes applied and template creation result. Creation effects are evaluated during template dry-run (see . The interface is outdated, new version is .

Gets file changes done on template instantiation.

Gets template creation result: primary outputs and post actions.

The interface represents the effects of template instantiation: the file changes applied and template creation result. Creation effects are evaluated during template dry-run (see .

Gets the file changes done on template instantiation.

Gets the template creation result: primary outputs and post actions.

Contains information about primary output on template instantiation.

The relative path to primary output. The path is relative to output directory.

Stores info about template creation, to be returned to the host as the result of template instantiation or dry run.

Gets post actions to be done by the host.

Gets the primary outputs of template instantiation. These are the files that post actions should be applied on.

Represents template engine environment settings.

Manages template cache and template engine settings.

Gets host-specific properties, loggers and provides access to file system.

Provides access to environment settings, such as environment variables.

Gets main file paths used by template engine.

Component manager for this instance of settings.

Provides access to environment settings, such as environment variables and constants.

The newline character(s).

The width of the console buffer. This is typically the value of .

Replaces the name of each environment variable embedded in the specified string with the string equivalent of the value of the variable, then returns the resulting string. Equivalent to .

Gets the value of environment variable with the .

Name of the environment variable to get. The value of environment variable or null if environment variable doesn't exist.

Gets all environment variables and their values.

The dictionary with environment variable names and their values.

Represents file change occurred during template instantiation. The new version of the interface .

Gets the file target path. The path is relative to output directory.

Gets the change kind.

Gets the file content.

Represents file change occurred during template instantiation.

Gets the file source path in template definition. The path is relative to template root directory.

Defines template generator supported by template engine. This interface should be implemented to create generator loadable by template engine infrastructure.

Generates the with given parameters.

template engine environment settings. template to generate. template parameters. target output directory to generate template to. The token to monitor for cancellation requests. containing post actions and primary outputs after template generation.

Dry runs the with given parameters.

template engine environment settings. template to dry run. template parameters. target output directory to generate template to. The token to monitor for cancellation requests. containing file changes, post actions and primary outputs that would have been done after template generation.

Converts the given to the type of .

template engine environment settings. template parameter defining the type. the value to be converted to parameter type. true if value could not be converted, false otherwise. the converted value to the type of or null if the value cannot be converted.

Attempts to evaluate expression string with the provided variables and returns the result.

Dictionary of variables to be substituted within the expression. The evaluation result (false in case evaluation failed). Evaluation error message in case evaluation failed. Keys of variables that have been substituted within the expression. If passed as null, the referenced variable keys are not obtained and stored anywhere.

Scans the given mount point for templates and returns the list of s that are found.

the mount point to load templates from. The token to monitor for cancellation requests. the list of templates found in mount point.

Attempts to load from the given location .

template engine environment settings. the locator defining the location of the template. the baseline to load. The token to monitor for cancellation requests. The default value is . , if the template can be loaded from , otherwise.

Scans the given mount point for templates and returns the list of s that are found.

the mount point to load templates from. localization information for templates. the list of templates found in mount point.

Gets an from the given configuration entry.

configuration file. loaded template. localization configuration file. host template configuration file. baseline to load. true if can be read, false otherwise.

Generates the with given parameters.

template engine environment settings. template to generate. template parameters. target output directory to generate template to. cancellation token. containing post actions and primary outputs after template generation.

Dry runs the with given parameters.

template engine environment settings. template to dry run. template parameters. target output directory to generate template to. cancellation token. containing file changes, post actions and primary outputs that would have been done after template generation.

Returns a for the given . This method returns the list of input parameters that can be set by the host / Edge before running the template. After setting the values the host should pass to or methods. Host may use to convert input value to required parameter type.

template engine environment settings. template to get parameters from. with parameters available in .

Defines a component loadable by .

Gets the identifier of the component. Should be unique.

Represents a localization file for a template.

Gets the locale of the localizations.

Gets the location on disk where the localization file resides.

Gets the identity of the template that the localizations in this object belong to.

Gets the localized author name.

Gets the localized template name.

Gets the localized template description.

Gets the localization models for the parameter symbols defined in this template.

Represents the result of checking the latest version of template package using .

The latest version for the template package identified as the result of update check.

True when the template package is already at the latest version.

In some cases the version installed can be higher then identified during update check. Since only installer can correctly compare the versions, the installer returns the result if the version is latest rather than letting the caller determine it using string comparison.

Gets vulnerabilities from checked package.

Creates successful result for the operation.

the package that was checked for update. the latest version of the package. indication if installed version is latest or higher.

Creates failure result for the operation.

the package that was checked for update. error code, see for details. detailed error message. detected package vulnerabilities.

Template package installer interface. To implement installer compatible with built-in template package providers, implement this interface.

Gets the that created this installer.

Determines if the installer can install specific .

Ideally it should go as far as calling backend server to determine if such identifier exists.

Gets latest versions for .

the template packages to get latest versions for. requesting latest version. list of containing latest versions for the sources.

Installs the template package defined by .

the template package to be installed. installing the package. containing installation results and installed if installation was successful.

Uninstalls the .

the template package to uninstall. uninstalling the template package. containing the result for operation.

Updates the template package defined by .

defining the template package to update and target version. updating the package. containing the result for operation and installed if update was successful.

Template package installer factory interface. Implement this interface to register installer supported by built-in providers.

The factory name.

Creates the managed by this factory.

environment settings of the template engine host. path to install the template packages to. created .

Defines constants used for installer implementation.

Defines the key for to specify additional NuGet sources to be used on installation. Supported by NuGet installer.

defines the separator to use when multiple sources are required.

Defines the separator to be used when specifying multiple additional NuGet sources to be used on installation. Supported by NuGet installer.

Used together with .

Defines the key for to specify that interactive mode should be used on installation. Supported by NuGet installer.

Defines possible error codes for operations.

The operation completed successfully.

The template package is not found.

The installation source (e.g. NuGet feed) is invalid.

The download from remote source (e.g. NuGet feed) has failed.

The request is not supported by the installer.

Generic error.

The template package is already installed.

The update has failed due to uninstallation of previous template package version has failed.

The requested package is invalid and cannot be processed.

The requested package has vulnerabilities and can only be processed with --force.

Represents operation result.

Gets result error code. if the operation completed successfully.

Error message for failed operation. Not set if the operation completed successfully.

processed by the operation.

Indicates if the operation completed successfully.

The template package installation request to be processed by .

Name to be used when display the request.

Installer to be used to install the request.

This can be null, but if multiple installers return true from installation will fail. The application should select the installer to be used in this case.

The identifier for template package to be installed. The format of identifier is defined by implementation.

Could be folder name, NuGet PackageId, path to .nupkg...

Specific version to be installed or null to install latest.

Additional details, like NuGet Server(Source), that specific installer uses.

The keys supported by default installers are defined in .

Allows installation even if the package with same version is already installed. Such package will be re-installed.

Represents the result of template package installation using .

processed by operation.

Gets vulnerabilities from installed package.

Creates successful result for the operation.

the processed installation request. the installed . Package vulnerabilities associated with the installation request.

Creates failure result for the operation.

the processed installation request. error code, see for details. detailed error message. Package vulnerabilities associated with the check request.

Installer needs to implement this interface if installations to be done using built-in providers. is used to store information about installed template packages.

Deserializes to that can be processed by .

The provider that provides the data. Data to serialize. deserialized .

Serializes to .

template package to serialize. serialized .

Represents serialized data for . Used to store information about template packages managed by built in providers.

Used in methods for serialization purposes.

Details for the template package. Applicable for only.

Additional properties required for certain implementations should be stored in this collection.

The ID of that installed the template package. Applicable for only.

The last time was changed.

Represents the result of template package uninstallation using .

Creates successful result for the operation.

the uninstalled .

Creates failure result for the operation.

the template package attempted to be uninstalled. error code, see for details. detailed error message.

The template package update request to be processed by .

Creates the instance of .

template package to update. target version.

to be updated.

Target version for the update.

Represents the result of template package update using .

processed by operation.

Gets vulnerabilities from installed package.

Creates successful result for the operation.

the processed . the updated . Package vulnerabilities associated with the update request.

Creates failure result for the operation.

the processed . error code, see for details. detailed error message. Package vulnerabilities associated with the update request.

Creates from .

the processed . to be converted to .

Provides information about detected vulnerabilities for a particular severity.

Represents level of detected vulnerability: 3 stands for critical, 0 for low. Link to vulnerability info.

Provides information about detected vulnerabilities for a particular severity.

Represents level of detected vulnerability: 3 stands for critical, 0 for low. Link to vulnerability info.

Represents level of detected vulnerability: 3 stands for critical, 0 for low.

Link to vulnerability info.

Defines a set of template parameters.

Gets an enumerator iterating through the parameter definitions of the template.

Gets a collection of template parameters and their values.

Gets a parameter definition with the specified .

Parameter name to get. Retrieved parameter or null if the parameter is not found. true if the parameter was retrieved, false otherwise.

Defines a parameter localization model.

Gets the parameter name.

Gets the localized friendly name of the symbol to be displayed to the user.

Gets the localized description of the symbol.

Gets the localization models for choices of this symbol.

Contains common folder paths used by TemplateEngine.

The user profile folder. E.g: "/home/userName/" on Unix and "C:\Users\userName\" on Windows.

Gets the path of template engine global settings directory. The directory should be used for settings shared between all template engine hosts. Usually at "C:\Users\userName\.templateengine\".

Gets the path of template engine host settings directory. The directory should be used for settings shared between all template engine host versions. E.g.: "C:\Users\userName\.templateengine\dotnet\".

Gets the path of template engine host version settings directory. The directory should be used for settings specific to certain host version. E.g.: "C:\Users\userName\.templateengine\dotnet\v1.0.0.0\".

Defines post action supported by the template.

Gets the description of the post action.

Gets the identifier of the action that will be performed. Note that this is not an identifier for the post action itself.

Gets a value indicating whether the template instantiation should continue in case of an error with this post action.

Gets the arguments for this post action.

Gets the instructions that should be manually performed by the user as part of this post action. Manual instructions are used when the host does not have the associated post action processor implemented.

Allows component to set its own priority compared to other components of same type. It is up to caller of to order and respect this.

Default priority is 0. Components of same type that don't implement this interface are considered as priority 0. Notice that negative priority can be used, which places component below default. Example order of execution will be: 1) a component with priority 100 2) a component without priority(defaults to 0) 3) a component with priority -100.

The information about the template obtained as the result of scanning .

Gets all localizations available for the template. The key is locale name.

Gets all host files available for the template. The key is host identifier, the value is a relative path to the host file inside the mount point .

Defines the template that can be run by .

Gets generator that runs the template.

Gets configuration file system entry.

Gets localization file system entry.

Gets host configuration file system entry.

Gets directory with template source files.

Indicates whether he template should be created in a subdirectory under the output directory.

Gets localization information set for the template.

Gets host-specific properties, loggers and provides access to file system.

Gets the list of built-in components provided by the host.

Provides access to file system. Depending on the settings, the file system can be physical or in-memory or both depending on the file path. To virtualize certain file path, use .

Gets the identifier of the host.

Gets the fallback names that will be probed to locate the host specific template settings file. The primary host template config name is .

Gets default logger for given template engine host.

Gets logger factory for given template engine host.

Gets the version of the host.

Tries to get default host parameter by its name.

Name of the parameter. Default value of the parameter provided by the host. true - if default value was provided; false otherwise.

Virtualizes access to the . After the location is virtualized, the file read/writes will be done from/to memory instead of physical file system. All subfolders in the location will be also virtualized.

Action to be done when potentially destructive changes on template instantiation are detected. The host can implement it as needed: prompt user, show error, etc. In case template instantiation should proceed, the method should return true. In case template instantiation should be aborted, the method should return false.

the list of file changes to be done on template instantiation. the list of destructive file changes (modify/remove) to be performed on template instantiation. true - in case template engine should proceed with template instantiation and perform destructive changes; false - if the template instantiation should be aborted.

Template information, used to be stored in the template cache. This information is common for all templates that can be managed by different s.

Gets the list of template parameters.

Defines the location of a template.

Gets generator ID the template should be processed by.

Gets template mount point URI.

Gets the path to template configuration inside mount point.

Gets the path to the localization configuration inside the mount point.

Gets the path to the host configuration inside the mount point.

Common template metadata.

Gets template author.

Gets template description.

Gets template classifications.

"Common", "Library", "Windows", "Tests", "Web".

Gets default name.

It is used as source name, in case name and fallback name passed to TemplateCreator is null.

Gets template identity.

Gets template group identity.

Gets template precedence. The precedence is used to prioritized templates inside template groups: the template with the higher value will be prioritized over the template with lower value.

Gets template name.

Gets template tags.

Gets the list of template parameters.

Gets third party notices.

Gets the collection of baselines defined in the template.

Gets the list of short names defined for the template.

Gets the list of post actions IDs defined in the template.

Gets the information about constraints defined in the template.

Gets template's preference for using the default name on creation.

Template parameter definition.

Gets parameter description.

Gets parameter name.

Gets parameter priority.

Indicates the precedence of the parameter.

Gets parameter type. In Orchestrator.RunnableProjects the type is always 'parameter'.

Returns true when parameter is default name symbol.

Gets the default value to be used if the parameter is not passed for template instantiation.

Gets data type of parameter (boolean, string, choice, etc).

Gets collection of choices for choice . null for other s.

Gets the friendly name of the parameter to be displayed to the user. This property is localized if localizations are provided. May contain accelerator key (_) which should be processed or removed.

Indicates whether parameter arity is allowed to be > 1.

Gets the default value to be used if the parameter is passed without value for template instantiation.

Represents a validation error when loading the template.

Error severity.

Gets the error severity.

Gets the code of the error.

Gets the error message (localized when available).

Gets the details about error location.

Details of the error location.

Gets the filename where the error occurred.

when the template is valid to be used.

Gets the results of template validation.

Defines an interface for generic variable collection. The variable collection may have a parent. The parent collection is used when the value is not found in current collection.

Gets the parent collection for the instance.

Defines the kind of a entry.

Entry is a file.

Entry is a directory.

Defines directory entry.

Enumerates the entries in the directory.

Matching pattern for the entries, see for more details. Matching pattern for the entries, see for more details. The enumerator to entries in the directory.

Enumerates the entries in the directory.

Matching pattern for the entries, see for more details. Matching pattern for the entries, see for more details. The enumerator to entries in the directory.

Enumerates the entries in the directory.

Matching pattern for the entries, see for more details. Matching pattern for the entries, see for more details. The enumerator to entries in the directory.

Defines a file entry.

Opens the file stream for reading.

that can be used for reading the file.

Defines a file system entry.

Returns true if file system entry exists, false otherwise.

Gets the path to file system entry inside mount point .

Gets file system entry kind.

Gets parent directory of file system entry.

Gets file system entry name.

Gets mount point for file system entry.

Represents abstract directory. This could be regular folder on file system, zip file, HTTP server or anything else that can present files in file system hierarchy.

Returns mount point URI (as received from template package provider = not normalized).

Returns root directory of the mount point.

used to create this instance.

Gets the file info for the file in the mount point.

The path to the file relative to mount point root.

Gets the directory info for the directory in the mount point.

The path to the directory relative to mount point root.

Gets the file system entry (file or directory) info for the entry in the mount point.

The path to the file system entry relative to mount point root.

Implement this factory and register it with . Template engine calls with Uri as parameter on all factories and use mount point from first successful factory.

Tries to mount specified Uri.

Environment to be used. Mount points can be mounted inside each other. Pass in parent or null. Valid that represents mount point. Resulting mount point. true if mount point was successfully mounted.

Represents a choice that can be assigned to a parameter.

Gets or sets the friendly name of the choice to be displayed to the user.

Gets or sets the description of the choice to be displayed to the user.

Localizes the choice with the given localization model.

Represents the data necessary for the localization of a .

Gets the friendly name of the choice to be displayed to the user.

Gets the description of the choice to be displayed to the user.

Value was not set.

Those are values supplied by the host. This usually means value(s) was/were set by user.

Value obtained via .

Value obtained via ITemplateEngineHost.OnParameterError.

Value from template - .

This corresponds to Name implicit parameter value.

To be used in case host uses advanced object model to supply values to TemplateCreator or Generator and wants to indicate that it used some custom logic of inferring value for parameter (e.g. custom Host calculated value of parameter based on current context and supplied the value to template engine).

The set of descriptors of template parameters extracted from the template.

Gets an enumerable collection that contains the keys in the read-only dictionary.

An enumerable collection that contains the keys in the read-only dictionary.

Gets an enumerable collection that contains the values in the read-only dictionary.

An enumerable collection that contains the values in the read-only dictionary.

Gets the element that has the specified key in the read-only dictionary.

The key to locate. The element that has the specified key in the read-only dictionary. key is null. The property is retrieved and key is not found.

Determines whether the read-only dictionary contains an element that has the specified key.

The key to locate. true if the read-only dictionary contains an element that has the specified key; otherwise, false. key is null.

Gets the value that is associated with the specified key.

The key to locate. When this method returns, the value associated with the specified key, if the key is found; otherwise, the default value for the type of the value parameter. This parameter is passed uninitialized. true if the object that implements the interface contains an element that has the specified key; otherwise, false. key is null.

Casts the Parameter set to IReadOnlyDictionary.

Data model for bound and merged dataset to be used to substitute and evaluate active sections within templates. Data are possibly merged from multiple sources (default values in definition, values supplied by host, user, etc.).

Descriptors for the parameters - inferred from the template.

Data model for template parameter instance data. Mainly used as input for .

Creates new instance of class.

Descriptor of the parameter inferred from the template. The value of the parameter derived from the instantiation context. Source of value for template instantiation in the current context. Indicates whether the parameter is enabled or disabled (and hence completely ignored).

Descriptor of the parameter inferred from the template.

The value of the parameter derived from the instantiation context (actual source of value indicated in ).

Source of value for template instantiation in the current context.

Indicates whether the parameter is enabled or disabled (and hence completely ignored). Disabling of parameter can be achieved via condition or constant for IsEnabled property in Template.

Empty descriptor set.

Initializes new instance of the type.

Instance to be cloned.

Creates new instance of the data type.

Creates new instance of the data type, not initialized with any actual instantiation data. To be used for compatibility purposes in places where old dictionary parameter set was used.

Creates new instance of the data type. To be used for compatibility purposes in places where old dictionary parameter set was used.

Empty instance.

Fetches the value of parameter from the set, based on the name of the parameter.

Attempts to fetch the value of parameter from the set, based on the name of the parameter.

True if parameter data was found. False otherwise.

Abstraction of FileSystem APIs, this allows unit tests to execute without touching hard drive. But also allows host to not store anything on physical file system, instead everything can be kept in memory and discarded after running.

Same behavior as .

Opens a binary file, reads the contents of the file into a byte array, and then closes the file. Same behavior as .

Same behavior as .

Creates new which monitors specified path and on any changes calls callback. To stop watching dispose returned object.

Gets the last write time for the in UTC. Same behavior as .

The file to get last write time for.

Sets the last write time for the in UTC. Same behavior as .

The file to set last write time for. the time to set.

If target is a subpath of relativeTo a relative bath from relativeTo to subpath will be returned.

Path to be converted to relative if possible. Base of the relative path to be returned.

Indicates parameter defined precedence.

Parameter value is unconditionally required.

Set if and only if only the IsRequiredCondition is set.

Parameter value is not required from user.

Parameter value is implicitly populated.

Parameter might become disabled - value would not be needed nor used in such case.

Parameter is disabled - it's value is not required and will not be used.

Template with information about matching the filters.

Gets the template the filters applied to.

Gets match information for the filters applied to template.

Adds the match information.

Represents match information for the filter applied to template.

Creates instance.

the name for the match. See default names in . the value matched for. the match kind between value and .

Defines the match status.

Gets the name of the match. For default filter names, see ).

Gets the value provided to match for.

Frequently used filter names. They are also used by Utils.WellKnownSearchFilters.

Template name .

Template short names .

Template classifications .

Template language ( named "language").

Template type ( named "type").

Template baseline names .

Template author .

Prefix used for matching. The full name is 'Constraint.<constraint type>'.

Defines the match kind: how the filter with its input values matches the property(ies) of .

The filter exactly matches the value of .

The filter partially matches the value of . For example, contains the value of the filter but not equal to it.

The filter does not match the value of . Example: the filter is checking and the parameter name is not defined in .

The input passed to the filter is incorrect, impossible to identify property of to check. Example: the filter is checking and the parameter name is not defined in .

The input passed to the filter is incorrect: the value is different format that is supported by property. Example: the filter is checking and the parameter is boolean but value to match with is string.

Represents the package that can be managed by . can additionally install, update and uninstall template package.

Gets the name to be used when displaying template package in UI.

Gets the identifier of template package. Identifier should be unique in scope of that manages the .

This can be NuGet PackageId, path to .nupkg, folder name, depends on implementation.

Gets that installed the template package. This serves as helper for grouping template package by installer so caller doesn't need to keep track of installer->template package relation.

Gets that manages the template package. This serves as helper for grouping packages by so caller doesn't need to keep track of "managed provider"->"managed package" relation.

Gets the version of the template package.

Indicates whether package was installed from local source (e.g. local extracted folder, local nuget etc.).

Gets additional details about template package. The details depend on implementation.

The provider is responsible for managing s. Besides base functionality of , it adds ability to install, update and uninstall template packages.

The keeps track of template packages managed by the provider. The actual installation is done by implementations.

Gets the latest version for the template packages.

List of to get latest version for. List of containing the check results.

Updates the template packages given in to specified version.

List of to be processed. List of with update results.

Uninstalls the template packages.

list of s to be uninstalled. List of with uninstall results.

Installs new based on data. All s are considered via and if only 1 returns . is executed and result is returned.

Contains the list of to perform. List of with installation results.

Represents the template package. Template package is a folder, .nupkg or other container that can contain single or multiple templates. See for more information.

Gets the last changed time for the template package. To avoid scanning for changes every time, template engine is caching templates from template packages, this timestamp is used to invalidate content and re-scan this template package.

Gets mount point URI - unique location of template package. This can be full URI like file://, http:// or simply file path.

Supported mount points are defined in implementations.

Gets the that created the template package. This is mostly helper for grouping packages by provider so caller doesn't need to keep track of provider->package relation.

Provides set of s available to the host.

Raised when template packages have been changed. Indicates that caller should refresh the list of template packages in use.

Gets that created the provider.

Gets the list of template packages available for the provider.

The list of s.

Factory responsible for creating or . This is registered with either via or .

Gets the readable name of the factory. This is used for two reasons: 1) To show user which provider is source of template packages (when debug/verbose flag is set) 2) To allow the user to pick specific provider to install templates to.

Creates new provider with specified environment, the provider may also implement .

Basic implementation so each doesn't need to re-implement it.

Indication of template parameter precedence and conditions that could influence it.

Default optional precedence.

Initializes a new instance of the class.

Actual precedence definition - can be used to sort parameters (e.g. for tab completion purposes).

IsRequiredCondition value - if it was specified in template.

IsEnabledCondition value - if it was specified in template.

Indicates whether parameter is unconditionally required.

Indicates whether parameter might be required (depending on values of other parameters).

Converts legacy parameter priority to the PrecedenceDefinition.

Converts legacy parameter priority to the TemplateParameterPrecedence.

Converts the PrecedenceDefinition to legacy TemplateParameterPriority.

Defines the priority of a template parameter.

The parameter is mandatory.

The parameter is optional.

The parameter is implicit (built-in).

Gets the buffer containing the chunk of source stream that is being processed.

Gets the length of useful data in .

Gets the current position in .

Gets the current position in source stream.

Advances source stream to position .

Seeks source stream until is found.

The token to find. The length of the buffer after the token is found. The position in the buffer after the token is found. True if token should be seeked through.

Seeks source stream while is found.

Seeks target stream backwards until is found.

The token to find. True if token should be seeked through.

Seeks target stream backwards while is found.

Writes to target stream.

The buffer to write. The start position in the buffer to write. The count of bytes to write.

The value to match.

Start of actual token. May be not 0, when look arounds are used.

Start of actual token. May be not Value.Length, when look arounds are used.

The length of the actual token.

Extends with the events raised when collection is being read or changed.

Traverses the given buffer position and creates an evaluable expression. If non-null bag for variable references is passed, it will be populated with references of variables used within the evaluable expression.

If passed (if not null) it will be populated with references to variables used within the inspected expression.

Inspect the passed string, creates the expression, substitutes parameters within expression, evaluates substituted expression and returns result. If non-null bag for variable references is passed, it will be populated with references of variables used within the evaluable expression.

The logger to be used to log the messages during evaluation. The string to be inspected and turned into expression. Variables to be substituted within the expression. A boolean value indicating the result of the evaluation.

The logger to be used to log the messages during evaluation. The string to be inspected and turned into expression. Variables to be substituted within the expression. Error message detailing failing evaluation, should it fail. If passed (if not null) it will be populated with references to variables used within the inspected expression. A boolean value indicating the result of the evaluation.

Creates the evaluable expression based on passed string, collects used symbols in the expression and reports if any errors occurs on expression creation.

The logger to be used to log the messages during building the evaluable expression. The string to be inspected and turned into expression. Variables to be substituted within the expression. Error message detailing failing building evaluable expression. If passed (if not null) it will be populated with references to variables used within the inspected expression. Evaluable expression that represents decomposed .

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 Encountered following error when parsing and evaluating expression:.

Looks up a localized string similar to Unexpected substring after parsed expression:.

Operation to perform. The tokens that operation matches are part of itself.

This is not an actual token to match, but index of token defined in .

Start position of the token.

End position of the token.

Length of the token.

Start position of the terminal. Relative location of matching token is defined in .

Returns the numner of elements in the longest of the token variant lists.

Returns true if the tokenIndex indicates the token is a variant of its base type, false otherwise.

Puts the tokensOfType into the tokenMasterList at indexes which are congruent to typeRemainder mod TokenTypeModulus.

Detects encoding of the stream.

http://www.unicode.org/faq/utf_bom.html.

Simple implementation of stream proxy to be used in case where destination stream is being re-read and adjusted in place multiple times. Direct I/O usage is unnecessarily costly in those situations (even with BCL buffered streams). This implementation flips to destination stream as soon as the cumulative size of the stream exceeds fixed threshold.

Upper limit of a sane size of a source file of good factored new codebase.

Used just to serialize/deserilize data to/from settings.json file.

when has duplicate identifiers for given installer.

We want to have higher priority than SDK/OptionalWorkload providers. So user installed templates(from this provider) override those.

Interface that represents loading/storing data into settings.json file. That is shared between multiple different hosts of TemplateEngine.

Triggered every time when settings change.

Returns uncached list of the template packages.

Stores list of the template packages.

This method must be called before making any modifications to settings to ensure other processes on system don't override or lose changes done by this process.

object that needs to be disposed once modifying of settings is finished.

The component allows to bind environment variables.

The component allows custom host parameters.

Exception occurred when parsing configuration for .

Attempts to parse input configuration string (presumably string or json array of strings) into enumeration of strings.

Input configuration string. Enumeration of parsed tokens. Thrown on unexpected input - not a valid json string or array of string or an empty array.

Attempts to parse input configuration string (presumably string or json array of strings) into enumeration of JObjects.

Input configuration string. Enumeration of parsed Jobject tokens. Thrown on unexpected input - not a valid json array or an empty array.

Attempts to parse given string and return the version specification (throws if unsuccessful). checks version in the following order: NuGet exact version NuGet floating version NuGet version range Legacy template engine exact version Legacy template engine version range.

Version string to be parsed. IVersionSpecification instance representing the given string representation of the version. Thrown if given string is not recognized as any valid version format.

Default implementation of . Gets environment variables from .

Default implementation of . If custom settings location are not passed, the following locations to be used:
- global settings: [user profile directory]/.templateengine
- host settings: [user profile directory]/.templateengine/[]
- host version settings: [user profile directory]/.templateengine/[]/[].

Creates the instance.

implementation to be used to get location of user profile directory. implementation. If specified, the directory will be used for storing global settings. Default location: [user profile directory]/.templateengine. If specified, the directory will be used for storing host settings. Default location: host settings: [user profile directory]/.templateengine/[]. If specified, the directory will be used for storing host version settings. Default location: host settings: [user profile directory]/.templateengine/[]/[].

Gets global settings directory. If not specified via constructor, the default location is []/.templateengine.

Gets host settings directory. If not specified via constructor, the default location is []/[host identifier].

Gets host version settings directory. If not specified via constructor, the default location is []/[host identifier]/[host version].

Default implementation of .

Creates the instance.

template engine host creating the instance. if true, the settings directory will be virtualized, so the settings will be stored in memory only. the base location of settings. If specified, the following settings paths will be used:
- - []
- - []/[]
- - []/[]/[].
If is specified, do not provide . implementation of to use. If not specified, will be used. implementation of to use. If not specified, built-in implementation will be used. implememtation of to use. If not specified, will be used (if is used, settings location will be overriden as mentioned in description).
If is specified, do not provide .

Downloads the package from configured NuGet package feeds. NuGet feeds to use are read for current directory, if additional feeds are specified in installation request, they are checked as well.

path to download to. NuGet package identifier. The version to download. If empty, the latest stable version will be downloaded. If stable version is not available, the latest preview will be downloaded. Additional NuGet feeds to use (in addition to default feeds configured for current directory). If true, overwriting existing package is allowed. containing full path to downloaded package and package details. when sources passed to install request are not valid NuGet sources or failed to read default NuGet configuration. when the download of the package failed. when the package cannot be find in default or passed to install request NuGet feeds. when the package has any vulnerabilities.

Gets the latest stable version for the package. If the package has preview version installed, returns the latest preview. Uses NuGet feeds configured for current directory and the source if specified from .

NuGet package identifier. current version of NuGet package. additional NuGet feeds to check from. the latest version for the and indication if installed version is latest. when sources passed to install request are not valid NuGet feeds or failed to read default NuGet configuration. when the package cannot be find in default or source NuGet feeds.

Default logger to be used with NuGet API. It forwards all the messages to different methods of ITemplateEngineHost depending on the log level.

Private constructor used for de-serialization only.

Tries to parse given string and return provided there is an existing floating range behavior in the provided string. null or empty string are regarded to be requests to any release version (behavior identical to '*').

Input string to be parsed. Output parameter, populated in case function returned true.

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 Parameter conditions contain cyclic dependency: [{0}] that is preventing deterministic evaluation..

Looks up a localized string similar to Failed to evaluate condition {0} on parameter {1} (condition text: {2}, evaluation error: {3}) - condition might be malformed or referenced parameters do not have default nor explicit values..

Looks up a localized string similar to Unexpected internal error - unable to perform topological sort of parameter dependencies that do not appear to have a cyclic dependencies..

Looks up a localized string similar to Parameter conditions contain cyclic dependency: [{0}]. With current values of parameters it's possible to deterministically evaluate parameters - so proceeding further. However template should be reviewed as instantiation with different parameters can lead to error..

Looks up a localized string similar to '{0}' should not contain empty items.

Looks up a localized string similar to Argument(s) were not specified. At least one argument should be specified..

Looks up a localized string similar to '{0}' does not contain valid items..

Looks up a localized string similar to '{0}' is not a valid JSON..

Looks up a localized string similar to '{0}' should be an array of objects..

Looks up a localized string similar to '{0}' is not a valid JSON array..

Looks up a localized string similar to '{0}' is not a valid JSON string or array..

Looks up a localized string similar to '{0}' is not a valid version or version range..

Looks up a localized string similar to Check the constraint configuration in template.json..

Looks up a localized string similar to Environment variables.

Looks up a localized string similar to Attempt to pass result of external evaluation of parameters conditions for parameter(s) that do not have appropriate condition set in template (IsEnabled or IsRequired attributes not populated with condition) or a failure to pass the condition results for parameters with condition(s) in template. Offending parameters: {0}..

Looks up a localized string similar to The folder {0} doesn't exist..

Looks up a localized string similar to Check the constraint configuration in template.json..

Looks up a localized string similar to latest version.

Looks up a localized string similar to version {0}.

Looks up a localized string similar to Failed to read installed template packages list at {0}. It might be due to the file is corrupted. Please review this file manually and fix the errors in JSON structure, or remove the file to clear up the list of list installed packages and reinstall them again. Details of the error: {1}..

Looks up a localized string similar to {0} can be installed by several installers. Specify the installer name to be used..

Looks up a localized string similar to {0} is already installed..

Looks up a localized string similar to {0} cannot be installed..

Looks up a localized string similar to {0} is already installed, it will be replaced with {1}..

Looks up a localized string similar to {0} was successfully uninstalled..

Looks up a localized string similar to '{0}' does not have mandatory property '{1}'..

Looks up a localized string similar to Running template on {0} (version: {1}) is not supported, supported hosts is/are: {2}..

Looks up a localized string similar to Template engine host.

Looks up a localized string similar to Host defined parameters.

Looks up a localized string similar to Found package is vulnerable source: {0}.

Looks up a localized string similar to Failed to load the NuGet source {0}..

Looks up a localized string similar to Failed to load NuGet sources configured for the folder {0}..

Looks up a localized string similar to Failed to read package information from NuGet source {0}..

Looks up a localized string similar to File {0} already exists..

Looks up a localized string similar to No NuGet sources are defined or enabled..

Looks up a localized string similar to The checked package {0} is vulnerable..

Looks up a localized string similar to Failed to remove {0} after failed download. Remove the file manually if it exists..

Looks up a localized string similar to Failed to download {0} from NuGet feed {1}..

Looks up a localized string similar to Failed to load NuGet source {0}: the source is not valid. It will be skipped in further processing..

Looks up a localized string similar to The NuGet sources {0} are insecure and will not be searched. If you want to include those sources for search, use --force..

Looks up a localized string similar to {0} is not found in NuGet feeds {1}..

Looks up a localized string similar to Failed to copy package {0} to {1}..

Looks up a localized string similar to Failed to read content of package {0}..

Looks up a localized string similar to File {0} already exists..

Looks up a localized string similar to The requested package {0} has vulnerabilities..

Looks up a localized string similar to Failed to download {0} from {1}..

Looks up a localized string similar to Failed to install the package {0}. Details: {1}..

Looks up a localized string similar to The install request {0} cannot be processed by installer {1}..

Looks up a localized string similar to The NuGet package {0} is invalid..

Looks up a localized string similar to The configured NuGet sources are invalid: {0}..

Looks up a localized string similar to No NuGet sources are configured..

Looks up a localized string similar to The operation was cancelled..

Looks up a localized string similar to {0} was not found in NuGet feeds {1}..

Looks up a localized string similar to The package {0} is not supported by installer {1}..

Looks up a localized string similar to Failed to uninstall the package {0}. Details: {1}..

Looks up a localized string similar to Failed to check the update for the package {0}. Details: {1}..

Looks up a localized string similar to The checked package {0} has vulnerabilities..

Looks up a localized string similar to '{0}' is not a valid operating system name. Allowed values are: {1}..

Looks up a localized string similar to Running template on {0} is not supported, supported OS is/are: {1}..

Looks up a localized string similar to Operating System.

Looks up a localized string similar to Template package location {0} is not supported, or doesn't exist..

Looks up a localized string similar to '{0}' is not a valid semver version..

Looks up a localized string similar to Multiple 'ISdkInfoProvider' components provided by host ({0}), therefore 'SdkVersionConstraint' cannot be properly initialized..

Looks up a localized string similar to No 'ISdkInfoProvider' component provided by host. 'SdkVersionConstraint' cannot be properly initialized..

Looks up a localized string similar to Running template on current .NET SDK version ({0}) is unsupported. Supported version(s): {1}.

Looks up a localized string similar to .NET SDK version.

Looks up a localized string similar to The constraint '{0}' failed to be evaluated for the args '{1}', details: {2}.

Looks up a localized string similar to The constraint '{0}' failed to initialize: {1}.

Looks up a localized string similar to The constraint '{0}' is unknown..

Looks up a localized string similar to Could not load template..

Looks up a localized string similar to Failed to create template. Details: {0}.

Looks up a localized string similar to Destructive changes detected..

Looks up a localized string similar to The template is invalid and cannot be instantiated..

Looks up a localized string similar to Failed to create template: the template name is not specified. Template configuration does not configure a default name that can be used when name is not specified. Specify the name for the template when instantiating or configure a default name in the template configuration..

Looks up a localized string similar to Failed to load host data in {0} at {1}..

Looks up a localized string similar to Failed to retrieve package with identifier '{0}'..

Looks up a localized string similar to Failed to retrieve template packages from provider '{0}'. Details: {1}.

Looks up a localized string similar to Failed to scan {0}. Details: {1}.

Looks up a localized string similar to Failed to store template cache, details: {0} Template cache will be recreated on the next run..

Looks up a localized string similar to The following templates use the same identity '{0}': {1} The template from '{2}' will be used. To resolve this conflict, uninstall the conflicting template packages..

Looks up a localized string similar to {0} '{1}' from '{2}'.

Looks up a localized string similar to The template {0} has the following validation errors:.

Looks up a localized string similar to The template {0} has the following validation messages:.

Looks up a localized string similar to Failed to load the template {0}: the template is not valid..

Looks up a localized string similar to Failed to load the '{0}' localization the template {1}: the localization file is not valid. The localization will be skipped..

Looks up a localized string similar to The template {0} has the following validation errors in '{1}' localization:.

Looks up a localized string similar to The template {0} has the following validation messages in '{1}' localization:.

Looks up a localized string similar to The template {0} has the following validation warnings in '{1}' localization:.

Looks up a localized string similar to The template {0} has the following validation warnings:.

Looks up a localized string similar to Multiple 'IWorkloadsInfoProvider' components provided by host ({0}), therefore 'WorkloadConstraint' cannot be properly initialized..

Looks up a localized string similar to No 'IWorkloadsInfoProvider' component provided by host. 'WorkloadConstraint' cannot be properly initialized..

Looks up a localized string similar to Running template is not supported - required optional workload(s) not installed. Supported workload(s): {0}. Currently installed optional workloads: {1}.

Looks up a localized string similar to Workload.

Looks up a localized string similar to 'IWorkloadsInfoProvider' component provided by host provided some duplicated workloads (duplicates: {0}). Duplicates will be skipped..

Mount point implementation for zip file. NuGet packages are zip files, so they are handled by this mount point.

Mount point implementation for file system directory.

Returns full path of the mounted directory.

Helper class to work with in async method, since await can switch to different thread and must be called from same thread. Hence this helper class.

Returns true if the mutex is acquired.

Creates the and task for waiting until underlying is acquired.

The mutex name. The name is case-sensitive. The to observe. created .

Disposes the . If disposed, the underlying is released.

Defines the scope that managed by built-in providers.

Template packages are visible to all template hosts.

Extension interface of which stores .host.json data in cache so host doesn't need to re-load it from .nupkg every time.

Full content of .host.json file in JSON format.

Makes an ordinal, case insensitive comparison with the two strings of the given tuples.

Utility for scanning for templates, localizations and components.

Scans mount point for templates, localizations and components.

The mount point will not be disposed by the . Use to dispose mount point.

Same as , however allows to enable or disable components scanning via .

The mount point will not be disposed by the . Use to dispose mount point.

Scans mount point for templates.

The mount point will not be disposed by the . Use to dispose mount point.

Scans mount point for templates.

The mount point will not be disposed by the . Use to dispose mount point.

Loads assemblies for components from the given .

Errors happened when loading assemblies. The path to load assemblies from. Filename pattern to use when searching for files. to use when searching for files. The list of loaded assemblies in format (filename, loaded assembly).

Returned by .

Gets the mount point that was scanned.

All components found inside mountpoint. AssemblyPath is full path inside . InterfaceType is type of interface that is implemented by component. Instance is object that implements InterfaceType.

All template localizations found inside mountpoint.

All templates found inside mountpoint.

Disposes that was scanned.

see https://source.dot.net/#System.Private.CoreLib/ResourceFallbackManager.cs.

Localization copy-constructor.

unlocalized template. localization information. host config information.

Parses from .

This class is overload on controlling JSON serialization for template parameters in cache. Not all the members are required to be serialized.

Manages all s available to the host. Use this class to get all template packages and templates installed.

Creates the instance.

template engine environment settings.

Triggered every time when the list of s changes, this is triggered by .

Returns with specified name.

Name from . For default built-in providers use method instead.

Returns with specified .

from of . For default built-in providers use method instead.

Same as but filters only packages.

Useful when doesn't trigger event. A cancellation token to cancel the asynchronous operation. The list of .

Returns combined list of s that all s and s return. caches the responses from s, to get non-cached response should be set to true. Note that specifying will only return responses from already loaded providers. To reload providers, instantiate new instance of the .

Useful when doesn't trigger event. A cancellation token to cancel the asynchronous operation. The list of s.

Returns built-in of specified .

scope managed by built-in provider. which manages packages of .

Gets all templates based on current settings.

This call is cached. And can be invalidated by .

Gets the templates filtered using and .

The criteria for to be included to result collection. The list of filters to be applied to templates. A cancellation token to cancel the asynchronous operation. The filtered list of templates with match information. GetTemplatesAsync(WellKnownSearchFilters.MatchesAllCriteria, new [] { WellKnownSearchFilters.NameFilter("myname") } - returns the templates which name or short name contains "myname".
GetTemplatesAsync(TemplateListFilter.MatchesAtLeastOneCriteria, new [] { WellKnownSearchFilters.NameFilter("myname"), WellKnownSearchFilters.NameFilter("othername") }) - returns the templates which name or short name contains "myname" or "othername".

Deletes templates cache and rebuilds it. Useful if user suspects cache is corrupted and wants to rebuild it.

Helper method that returns that contains .

Returns all contained by .

The template package to get template from. A cancellation token to cancel the asynchronous operation. The enumerator to templates of the .

Returns managed template package matching and containing templates .

The template package identifier. The template package version, if null package version is not checked. A cancellation token to cancel the asynchronous operation. The managed template package and the containing templates. Throws an exception when package .

Manages evaluation of constraints for the templates.

Returns the list of initialized s. Only returns the list of that were initialized successfully. The constraints which failed to be initialized are skipped and warning is logged.

if given, only returns the list of constraints defined in the templates. The list of successfully initialized s.

Evaluates the constraints with given for given args .

constraint type to evaluate. arguments to use for evaluation. indicating if constraint is met, or details why the constraint is not met.

Evaluates the constraints with given . The method doesn't throw when the constraint is failed to be evaluated, returns with status instead.

the list of templates to evaluate constraints for given templates. indicating if constraint is met, or details why the constraint is not met.

Exact match criteria - the templates should match all filters.

Partial match criteria - the templates should match at least one of the filters.

Gets matching information for templates for provided filters.

The templates to be filtered. The criteria of template to be filtered. The list of filters to be applied. The filtered list of templates with matches information. GetTemplateMatchInfo(templates, TemplateListFilter.ExactMatchFilter, WellKnownSearchFilters.NameFilter("myname") - returns the templates which name or short name contains "myname".
GetTemplateMatchInfo(templates, TemplateListFilter.PartialMatchFilter, WellKnownSearchFilters.NameFilter("myname"), WellKnownSearchFilters.NameFilter("othername") - returns the templates which name or short name contains "myname" or "othername".

Status of the template instantiation.

The template was instantiated successfully.

The template instantiation failed.

The mandatory parameters for template are missing.

The values passed for template parameters are invalid.

The template is not found.

The operation is cancelled.

The operation is cancelled due to destructive changes to existing files are detected.

The host supplied conditions evaluation results did not match internal evaluation.

Type representing input data into that are able to hold information about externally evaluated conditions on template parameters.

Constructor for type, that allows specification of results of external evaluation of conditions.

A stringified value of parameter or null for explicit unset. It's possible to indicate missing of parameter on input via argument. InputDataState.Unset indicates a situation that parameter was not specified on input (distinct situation from explicit null). This would normally be achieved by not passing the parameter at all into the , however then it would not be possible to specify the results of conditions calculations.

Externally (by the host) supplied result of the IsEnabledCondition on the template parameter.

Externally (by the host) supplied result of the IsRequiredCondition on the template parameter.

Datamodel for passing data into the .

Creates new instance of the type.

Creates new instance of the type. To be used to convert legacy parameters dictionaries into this datamodel.

Indicates whether template creator should ignore evaluation results that does not match validation evaluation. Warning will be logged and external evaluation results will be used.

Descriptors of the parameters.

Enumeration indicating how should the engine treat incoming value (as ignored, explicitly unset or standard value).

Parameter is represented in input with nonempty value.

Parameter is not represented in input.

Parameter is represented in input data with a null or empty value - this can e.g. indicate multichoice with no option selected. In CLI this is represented by option with explicit null string ('dotnet new mytemplate --myoptionA ""'). In TemplateCreator this is represented by explicit null value.

Tags the input value with based on it's definition.

Type representing input data into .

Creates new instance of the type.

Descriptor of the parameter.

Value of the parameter.

Source of the parameter value. If supplied by the host - leave the default value of .

Input data state - indicates how the actual value should be treated (ignored, regarded as explicitly unset value, etc.).

Represents result of template instantiation / dry run via . />.

Result of template dry run. Template dry run always performed prior to instantiation.

Error message, null if operation is successful. Should be localized.

The output directory used for template instantiation.

The result of template instantiation. Null in case of dry run.

Status of template instantiation.

Processed template name.

stores canonical parameter name.

stores parameter value.

stores the exception message if there is an args parse error.

stores the option for parameter as used in the host for example dotnet CLI offers two options for Framework parameter: -f and --framework if the user uses -f when executing command, contains -f.

Creates .

status of template creation. template name. localized error message. Should be set when is not . results of template creation. output directory. results of template dry run. when is null or empty and is not .

The class instantiates and dry run given template with given parameters.

Instantiates or dry runs the template.

The template to run. The name to use. Will be also used as in case it is empty and for is set to true. Fallback name in case is null. The output directory for instantiate template to. The input parameters for the template. If true, create the template even it overwrites existing files. baseline configuration to use. If true, only dry run will be performed - no actual actions will be done.

Instantiates or dry runs the template.

Fully load template from . usually comes from cache and is missing some information. Calling this methods returns full information about template needed to instantiate template.

Information about template. Defines which baseline of template to load. The cancellation token. Fully loaded template or null if it fails to load template.

Fully load template from . usually comes from cache and is missing some information. Calling this methods returns full information about template needed to instantiate template.

Information about template. Defines which baseline of template to load. Fully loaded template or null if it fails to load template.

Reads the parameters from the template and the host and setup their values in the return IParameterSet. Host param values override template defaults.

The template params for which there are same-named input parameters have their values set to the corresponding input parameters value. input parameters that do not have corresponding template params are ignored.

This class is to be used solely to hold backward compatibility of method. Hence only the base and are implemented - no other methods are called in scope of .

Creates predicate for matching the template and given tag value. If the template contains the tag , it is exact match, otherwise mismatch. If the template has no tags defined, it is a mismatch. If is null or empty the method returns null.

tag to filter by. A predicate that returns if the given template matches .

Creates predicate for matching the template and given author value.

author to use for match. A predicate that returns if the given template matches defined author.

Virtualized implementation of . Allows to overwrite and/or add environment variables not defined in physical environment.

Creates new instance of .

Variables to be considered as environment variables. They have precedence over physical environment variables. If set to true - variables from are added.

An interface for macros created that can create the config from other config (deffered config).

Creates from .

Deprecated as can process only own configuration.

A macro that supports deterministic mode (for test purposes).

Evaluates the macro based on . The result is modification of variable collection . The evaluation is performed deterministically, i.e. different external factors cannot impact the result and the recurrent evaluation is guaranteed to provide same result.

A macro that supports deterministic mode (for test purposes).

Represents the configuration of .

Gets data type of the variable to be created.

Gets the collection of additional macro parameters, where key is a parameter name, and value is a JSON value serialized to string.

An interface for a macro created via generated symbols.

Creates a macro configuration based on the provided engine environment settings and generated symbol configuration. This method allows to instantiate generated macro during population.

The engine environment settings. The generated symbol configuration. The macro configuration.

An interface for a typed macro created via generated symbols.

The type of macro configuration.

Creates a macro configuration based on the provided engine environment settings and generated symbol configuration. Method is needed for supporting invocation.

The engine environment settings. The generated symbol configuration. The typed macro configuration .

Represents a macro that can modify variable collection before template instantiation.

Gets macro type. The type identifies the macro and should be unique.

Evaluates the macro based on . The result is modification of variable collection .

Represents a macro that can modify variable collection before template instantiation.

Evaluates the macro based on . The result is modification of variable collection .

Base interface for configurations.

Gets the variable name for this .

Gets type.

Represents a configuration for the macro that configures dependencies on other symbols.

Gets the set of symbol names required by the macro. ResolveSymbolDependencies method should be called prior to accessing the property. Before it the property won't be populated.

when is not called for the property population.

Resolves the macro dependencies out of the provided list of symbols. As the result of method execution, should be populated.

The list of symbols that exist in configuration. The method should identify which of those symbols are the dependencies for given macro.

Evaluates bind symbols from external sources. Sets the evaluated symbols to .

The symbols to evaluate. The variable collection to set results to. The cancellation token that allows cancelling the operation.

Gets the text that should be replaced by the value of this symbol. Corresponds to "replaces" JSON property.

Gets the replacement contexts that determine when this symbol is allowed to do replacement operations.

Gets the part of the file name that should be replaced with the value of this symbol. Corresponds to "fileRename" JSON property.

Gets the name of the symbol. Corresponds to key that defines the symbol in "symbols" JSON object.

Gets the type of the symbol. Corresponds to "type" JSON property.

Indicates that the symbol is implicit and was created by generator itself. Those symbols are not part of JSON.

Initializes this instance with given JSON data.

Gets default value of the symbol. Corresponds to "defaultValue" JSON property.

Gets the forms defined for the symbol Corresponds to "forms" JSON property.

Specifies if the symbol is required. Corresponds to "isRequired" JSON property.

Gets the data type of the symbol. Corresponds to "datatype" JSON property.

Defines the symbol of type "bind".

Gets the name of the host property or the environment variable which will provide the value of this symbol.

Gets default value of the symbol. Corresponds to "defaultValue" JSON property.

Gets the data type of the symbol. Corresponds to "datatype" JSON property.

Defines the symbol of type "computed".

Defines the value of the computed symbol. Corresponds to "value" JSON property.

Defines the evaluator to be used when computing the symbol value. Corresponds to "evaluator" JSON property.

Stores the result of the condition evaluation. If the condition was not evaluated before, the value is null.

Gets the condition string to be evaluated so that configuration element is applied. Usually corresponds to "condition" JSON property.

Stores the result of condition evaluation. should be done before accessting this property.

when the property is accessed prior to method is called.

Evaluates the condition .

the logger to be used to log the messages during evaluation. the variable collection that will be used to evaluate the condition. true if condition evaluates to true or not specified, otherwise false.

Defines operation for specific files.

Gets the glob which defines the files that operations should be applied to.

Gets the collection of operations to apply.

Gets the prefix that is used in flags.

Gets the variable configuration format.

Defines the operation configuration.

Gets the operation type.

Gets the operation raw configuration in JSON format.

Defines the symbol of type "derived".

Defines the transformation to be applied to (value form).

Defines the variable to be transformed.

Defines the sources. Corresponds to the element of "sources" JSON array.

Defines the files to be just copied when instantiating template. Operations will not be applied to them. Can be glob. If single value is given, it can be also a filename where from to read this configuration.

Defines the files to be include when instantiating template. Operations will be applied to them. Can be glob. If single value is given, it can be also a filename where from to read this configuration.

Defines the files to be excluded when instantiating template. These files will not be processed during template instantiation. Can be glob. If single value is given, it can be also a filename where from to read this configuration.

Defines the files to be renamed when instantiating the template. The key is a source file name, the value is the final file name.

Defines the path to the source files to apply the settings to. The path is relative to the directory containing the .template.config folder. Default value: "./".

Defines the path the content should be written to. The path is relative to the directory the user has specified to instantiate the template to. Default value: "./".

A list of additional source information which gets added to the top-level source information, based on evaluation the corresponding "source.modifiers.condition".

Defines the symbol of type "generated".

Defines the data type of generated value.

Refers to the Type property value of a concrete IMacro.

Defines the parameters to be used for generating the value. - the key is a parameter name - the value is a JSON value.

Represents an instruction that should be manually performed by the user as part of a post action.

Gets the string identifying this instruction within the post action. This property can be null if the author has not provided one. In that case this manual instruction cannot be referenced in a context where an id is required, such as in templatestrings.json files.

Gets the text explaining the steps the user should take.

Localizes this manual instruction by replacing the value of the property the given text.

Localized .

Defines the symbol of type "parameter".

Creates an instance of using the provided JSON Data.

JSON to initialize the symbol with.

Creates a clone of the given .

The symbol to copy the values from. The value to be used for in the case that the does not specify a value for .

Creates a default instance of .

Gets the friendly name of the symbol to be displayed to the user.

Gets the description of the parameter.

If this is set, the option can be provided without a value. It will be given this value.

If this is set, it's allowed to specify multiple values of that parameter.

If this is set, it's allowed to specify choice literals without quotation within conditions.

Default id to be used when post action contains only one manual instruction and the author has not explicitly specified an id.

Gets a string that uniquely identifies this post action within a template.

Gets the description of the post action.

Gets the identifier of the action that will be performed. Note that this is not an identifier for the post action itself.

Gets a value indicating whether the template instantiation should continue in case of an error with this post action.

Gets the arguments for this post action.

Gets the list of arguments to which file renames should be applied.

Gets a value indicating whether the file renames should be applied to manual instructions.

Gets the list of instructions that should be manually performed by the user. "instruction" contains the text that explains the steps to be taken by the user. An instruction is only considered if the "condition" evaluates to true.

Defines the primary output. Corresponds to the element of "primaryOutputs" JSON array. Primary outputs define the list of template files for further processing.

Defines the relative path to the file after the template is instantiated.

Defines the replacement context for the symbol.

Gets the context that should be present before the symbol, in order to replacement to be applied. Corresponds to "onlyIf.before" JSON property.

Gets the context that should be present after the symbol, in order to replacement to be applied. Corresponds to "onlyIf.after" JSON property.

Defines the source modifier, these settings are applied to in addition to the top-level source information, in case is met.

Defines the files to be renamed when instantiating the template. The key is a source file name, the value is the final file name.

The class represents model of template.json.

Gets the template author ("author" JSON property).

Gets the default name for the template ("defaultName" JSON property).

Gets the description of the template ("description" JSON property).

Gets the group identity of the template ("groupIdentity" JSON property). This allows multiple templates to be displayed as one, with the the decision for which one to use based on and other parameters added by user for the instantiation.

Gets the precedence of the template in a group ("precedence" JSON property).

Gets the template name ("name" JSON property).

Gets the link to 3rd party notices ("thirdPartyNotices" JSON property).

Indicates whether to create a directory for the template if name is specified but an output directory is not set (instead of creating the content directly in the current directory) ("preferNameDirectory" JSON property).

Indicates whether to use the template's default name or parent folder's name for template name ("preferDefaultName: JSON property).

Gets the collection of template tags ("tags" JSON property).

Gets the list of template short names ("shortName" JSON property).

Gets the list of post actions defined for the template ("postActions" JSON property).

Gets the list of template primary outputs ("primaryOutputs" JSON property).

Gets version expression which defines which generator versions is supported by the template ("generatorVersions" JSON property).

Gets the list of baselines defined for the template ("baselines" JSON property).

Gets the template identity ("identity" JSON property) - a unique name for this template.

Gets the list of classifications of the template ("classifications" JSON property).

Gets the list of guids defined in the template ("guids" JSON property).

Gets the source name defined in the template ("sourceName" JSON property).

Gets the list of sources defined in the template ("sources" JSON property).

Gets the list of constraints defined in the template ("constraints" JSON property).

Gets the list of symbols defined in the template ("symbols" JSON property).

Gets the list of forms defined in the template ("forms" JSON property).

Gets the placeholder filename defined in the template ("placeholderFilename" JSON property).

Gets the list of global custom operations defined for the template ("globalCustomOperations" JSON property).

Gets the list of custom operations defined for the template for specific files ("specialCustomOperations" JSON property).

Gets the list of validation errors for template.

Creates from stream .

The stream containing template configuration in JSON format. The logger to use for reporting errors/messages. The filepath of template configuration (optional, used for logging).

Creates from string .

The string containing template configuration in JSON format. The logger to use for reporting errors/messages. The filepath of template configuration (optional, used for logging).

Localizes this with given localization model.

Localization model containing the localized strings. This method works on a best-effort basis. If the given model is invalid or incompatible, erroneous data will be skipped. No errors will be logged. Use to validate localization models before calling this method.

Extracts parameters from the model.

The class represents the template loaded from directory. The configuration can be loaded from file (production scenario) or loaded from (test scenario). In both cases the template should be available from .

Creates the instance of the class based on configuration from .

when template configuration is invalid. when template identity is null. when the template is not supported by current generator version.

Test constructor. Do not use in production. This constructor does not set the location of configuration file.

Gets the configuration model. For test purposes, preloaded model can be used.

Gets the directory with source files for the template.

Gets configuration . when the template is created from the model built from code.

Gets the configuration directory. when the template is created from the model built from code.

Gets the template parameters.

Parses host file name to get host identifier.

Parses localization file name to get locale.

localization file.

Checks the for additional configuration files. If found, merges them all together. Returns the merged JObject (or the original if there was nothing to merge). Additional files must be in the same folder as the template file.

when additional files configuration is invalid.

Checks if the template is supported by current generator version.

when the template is not supported by current generator version. when check for the version leads to unexpected result.

C++ V2 style evaluator, see for more details.

C++ style evaluator, see for more details.

MSBuild style evaluator, see for more details.

VB style evaluator, see for more details.

Gets based on selected .

The evaluator type to use. See for more info. . when is not supported (unknown).

Parses to .

the string value to parse. default to use, when the is null or empty. The parameter is optional. In case it is not passed or is passed, is used. Parsed . when cannot is unknown and cannot be parsed.

Gets based on selected .

The evaluator type to use. See for more info. . when is not supported (unknown).

Creates the complete file rename mapping for the template invocation being processed. Renames are based on: - parameters with a FileRename specified - the source and target names. Any input fileRenames will be applied before the parameter symbol renames.

Applies configured renames to .

Creates and returns the processor used to create the file rename mapping for source based file renames.

Creates and returns the processor used to create the file rename mapping based on the symbols with fileRename defined. Also sets up rename for the target directory.

Sets up a rename based on the "name" parameter.

Extends the contract with the metadata about data from template parameters.

Bound and merged parameter data and their metadata.

Gets the list of to be applied to specific files included in glob.

Gets the to be applied to all template files.

Gets the list of evaluated sources based on configuration. method should be called first before accessing it.

Gets the list of enabled post actions. method should be called first before accessing it.

Gets the list of enabled primary outputs. method should be called first before accessing it.

Evaluates conditional elements based on .

Removes parameter from template.

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 Id of the post action '{0}' at index '{1}' is not unique. Only the first post action that uses this id will be localized..

Looks up a localized string similar to Post action at index '{0}' should have an 'actionId' to declare the action to be executed..

Looks up a localized string similar to 'id' of the manual instruction '{0}' at index {1} is not unique. Only the first manual instruction that uses this id will be localized..

Looks up a localized string similar to The argument '{0}' configured in '{1}' is not listed in '{2}' and will be skipped for processing..

Looks up a localized string similar to Parameter conditions contain cyclic dependency: [{0}] that is preventing deterministic evaluation..

Looks up a localized string similar to Localization file should only contain elements with type 'string'. Remove elements that are not strings..

Looks up a localized string similar to In localization file under the post action with id '{1}', there are localized strings for manual instruction(s) with ids '{0}'. These manual instructions do not exist in the template.json file and should be removed from localization file..

Looks up a localized string similar to Choice parameter '{0}' is invalid. It allows multiple values ('AllowMultipleValues=true'), while some of the configured choices contain separator characters ({1}). Invalid choices: {2}.

Looks up a localized string similar to Post action(s) with id(s) '{0}' specified in the localization file do not exist in the template.json file. Remove the localized strings from the localization file..

Looks up a localized string similar to '{0}' could not be parsed as a regular expression.

Looks up a localized string similar to One or more postActions have a malformed or missing manualInstructions value..

Looks up a localized string similar to Missing '{0}'..

Looks up a localized string similar to A non-bool DataType was specified for a regexMatch type symbol.

Looks up a localized string similar to Source '{0}' in template does not exist..

Looks up a localized string similar to Source location '{0}' is outside the specified install source location..

Looks up a localized string similar to Source must be a directory, but '{0}' is a file..

Looks up a localized string similar to The template configuration {0} is missing common information:.

Looks up a localized string similar to Failed to load template from {0}:.

Looks up a localized string similar to Failed to load template from {0}. Details: {1}.

Looks up a localized string similar to The template root is outside the specified install source location..

Looks up a localized string similar to Bind symbol '{0}': failed to convert value '{1}' to datatype '{2}'. The symbol processing is skipped..

Looks up a localized string similar to Bind symbol '{0}': failed to convert default value '{1}' to datatype '{2}'. The default value is skipped..

Looks up a localized string similar to Failed to evaluate bind symbol '{0}', it will be skipped..

Looks up a localized string similar to Failed to evaluate binding '{0}', its value is available from multiple sources: {1}. Use the prefixed value ({2}) in template configuration instead..

Looks up a localized string similar to Template authoring error encountered while processing macro '{0}': Variable '{1}'. Neither source nor fallback variable was found..

Looks up a localized string similar to Unrecognized evaluator: '{0}'..

Looks up a localized string similar to The high port bound '{0}' is greater than the maximum allowed, '{1}' will be used instead..

Looks up a localized string similar to The low port bound '{0}' is less than the minimum allowed, '{1}' will be used instead..

Looks up a localized string similar to The low port bound '{0}' is greater the high port bound '{1}', the default range [{2}-{3}] will be used instead..

Looks up a localized string similar to Generated symbol '{0}': array '{1}' should contain JSON objects with property non-empty '{2}' when '{3}' is '{4}'..

Looks up a localized string similar to Failed to read or parse localization file {0}, it will be skipped from further processing..

Looks up a localized string similar to Locale '{0}' does not match any known cultures..

Looks up a localized string similar to The method '{0}' must be called prior '{1}' property reading..

Looks up a localized string similar to Generated symbol '{0}': array '{1}' should contain JSON objects..

Looks up a localized string similar to Generated symbol '{0}': '{1}' is not a valid JSON..

Looks up a localized string similar to Generated symbol '{0}': the regex pattern '{1}' is invalid..

Looks up a localized string similar to Generated symbol '{0}' of type '{1}' should have '{2}' property defined..

Looks up a localized string similar to Generated symbol '{0}': array '{1}' should contain JSON objects with property '{2}'..

Looks up a localized string similar to Generated symbol '{0}': '{1}' should be a valid JSON array..

Looks up a localized string similar to Generated symbol '{0}': '{1}' should be a boolean value..

Looks up a localized string similar to Generated symbol '{0}': '{1}' should be an integer value..

Looks up a localized string similar to Generated symbol '{0}': '{1}' should be a string value..

Looks up a localized string similar to '{0}' was not processed due to the next issues in dependencises: '{1}'..

Looks up a localized string similar to Failed to process macro '{0}' of type '{1}'..

Looks up a localized string similar to Generated symbol '{0}': type '{1}' is unknown, processing is skipped..

Looks up a localized string similar to The symbol '{0}': unable to find a form '{1}', the further processing of the symbol will be skipped..

Looks up a localized string similar to Variable [{0}] already added with value [{1}]. Cannot add it as implicit variable with value of self..

Looks up a localized string similar to Template configuration must be a file, but {0} is not a file..

Looks up a localized string similar to Template localization configuration must be a file, but {0} is not a file..

Looks up a localized string similar to The template configuration {0} is not valid..

Looks up a localized string similar to The template is not compatible with generator version: allowed versions: {0}, generator version: {1}..

Looks up a localized string similar to Localization file {0} is not compatible with base configuration {1}, and will be skipped..

Looks up a localized string similar to Failed to load additional configuration file {0}, the file does not exist..

Looks up a localized string similar to Failed to load additional configuration file {0}. Additional configuration file names must end with '.{1}'..

Looks up a localized string similar to '{0}' should contain objects..

Looks up a localized string similar to Constraint definition '{0}' does not contain mandatory property '{1}'..

Looks up a localized string similar to Found disallowed value for IsRequired property: [{0}], expected boolean value..

Looks up a localized string similar to Found disallowed value for IsRequired property: [{0}], expected boolean or string (condition) value.

Looks up a localized string similar to The symbol '{0}' of type '{1}' is incorrect: mandatory property '{2}' is not set. The symbol will be skipped..

Character to be used when separating a key into parts.

Deserializes the given localization file into an .

File to be deserialized. loaded localization model. is null. The file does not contain valid JSON data, JSON data contains element other than strings.

Generates parameter symbol localization models from the given localized strings.

Generates post action localization models. The given parts should begin with the choice name as shown below (prior parts of the name such as "symbols" and parameter name shouldn't be included). net5.0/displayName net5.0/description netstandard2.0/description

Generates post action localization models from the given localized strings.

Generates manual instruction localization models. The given parts should begin with the manual instruction id. instructionToRestore/text instructionToRestart/text

The localized manual instructions where each key represents the instruction id.

Represents the data model that contains the localized strings for a template.

Gets the localized author name.

Gets the localized template name.

Gets the localized template description.

Gets the localization models for the parameter symbols defined in this template.

Gets the localization models for the post actions defined in this template. The keys represent the id of the post actions.

Localized description of the post action.

Gets or sets the localized manual instructions of the post action. The keys represent the manual instruction ids.

Processes the macros defined in .

when config is invalid. when the error occurs when macro is processed.

Base class for the macro defined via generated symbol.

The macro config.

Base class for the macro defined via generated symbol, that may run undeterministially and implements deterministic mode for the macro. Note: this class only implements deterministic mode for the macro as . To implement deterministic mode for direct generated symbol evaluation, use .

The macro config.

Base class for the macro defined via generated symbol, that may run undeterministially and implements deterministic mode for the macro as generated symbol.

The macro config.

Gets default operation config.

Gets default global operation config.

Gets default special operation config.

Gets the files the config applies to. Empty string means that the config is applied to all files.

Gets the evaluator to use for the applicable files.

Gets the prefix for flags to use for the applicable files.

Gets conditional type to use for the applicable files.

The class represent the template ready to be run. The class is disposable, as it holds the mount point to template sources.

Instantiation constructor - loads template with specific localization.

Test constructor. Loads the template based on instead of reading it from file.

Gets the mount point where template sources are located.

Evaluates the conditions in template configurations: conditions in special custom operations, in sources and primary outputs. File renames are also applied at this step.

Evaluates the bind symbols. The evaluated bind symbols are written to .

Converts the raw, string version of a parameter to a strongly typed value. If the parameter has a datatype specified, use that. Otherwise attempt to infer the type. Throws a TemplateParamException if the conversion fails for any reason.

Scans the for the available templates.

the mount point to scan for the templates. found localization definitions. the list of found templates and list of found localizations via .

Attempts to load template configuration from .

the template configuration entry, should be a file. loaded template. the template localization configuration entry, should be a file. the template host configuration entry, should be a file. the baseline to load. true when template can be loaded, false otherwise. The loaded template is returned in .

Wrapper class: ScannedTemplateInfo -> ITemplate.

This class represent the template discovered during scanning. It is not ready to be run. It also returns information about all the localizations available for the template and all host files avaialble for the template. Before running the template the caller should select localization and host file to use. Use to load template for running.

Creates instance of the class based on configuration from .

Attempts to find the host configuration files.

Defines a set of helper methods to classify Unicode characters.

Returns true if the Unicode character can be a part of an identifier.

The Unicode character.

Check that the name is a valid Unicode identifier.

Returns true if the Unicode character is a formatting character (Unicode class Cf).

The Unicode character.

Returns true if the Unicode character is a formatting character (Unicode class Cf).

The Unicode character.

Information available for template validation.

Gets template configuration.

Gets source template directory.

Gets template configuration file.

Gets localizations available for the template.

Gets host files available for the template.

Gets the list of validation errors for template.

Adds validation error to the list.

The check is run when scanning the mount point for templates, typically installation or scanning scenario. This set is more exhaustive then , and should be used to avoid installing invalid templates.

The check is run when the template is being instantiated. This set should be normally less exhaustive then , and should be used to check for failures that may affect the template instantiation result.

Base implementation for a for a that doesn't have a configuration.

Base implementation of . When implementing a value form inherit from or or instead.

Base implementation for a for a that has a configuration of type .

Base implementation for a for a that has a configuration of type and needs to know all the forms defined to process a value form.

Defines an interface for value form.

Gets value form identifier. Identifier determines the transformation to be run.

Gets value form name.

True is the form is a default implicit form. See for more details.

Transforms .

other forms defined in the template. transformed value.

Gets form identifier.

Creates the form with default configuration.

Creates the form from JSON configuration.

Tries to convert to data type defined in . Supported types are: choice, bool, int, float, hex, string, text.

the parameter to convert value to. the value to convert. the converted value, if the conversion was successful. True if the conversion was successful.

Converts to closest data type. Supported types are: bool, null, float, int, hex, string/text (in order of attempting).

the string value to convert. Converted value.

Tries to convert to . If is null or empty, the type to be inferred. See for more details.

Provides support for asynchronous lazy initialization.

The type to be lazily initialized.

Creates a lazy type that performs the value construction asynchronously on a first access.

Synchronous value factory that will be executed asynchronously on first access in separate task.

Creates a lazy type that performs the value construction asynchronously on a first access.

Asynchronous value factory that will be executed on a first access.

The awaiter to be awaited in order to trigger asynchronous value creation.

Generic provider that can be used by different factories that have a fixed list of ".nupkgs" or folders.

Updates list of packages and triggers event.

List of "*.nupkg" files. List of folders.

Way of resolving keys conflicts.

Force overwrite values in original dictionary in case of conflict.

Preserve original values in case of conflict.

Throw in case of conflict.

Adds a content of given dictionary to current dictionary.

Dictionary to receive another values. Dictionary to be merged into current. Way of resolving keys conflicts. Thrown if key is already present in current dictionary and strategy was requested.

Adds a to given dictionary if satisfies .

Type of keys of . Type of values of . A dictionary to add and to. A key for new . A value with . If condition is , then will be added to . Thrown if key is already present in current dictionary and strategy was requested.

Initializes a new instance of the class.

Lookup of child nodes for all nodes (or at lest nodes that have children).

Attempts to perform a topological sort of a given acyclic graph.

True if topological sort can be performed, false otherwise (means graph contains cycle(s)).

Gets the subset of the graph that contains all the dependencies mapping depending on given vertices. This is useful when we want to determine a subset of the graph that needs to be reevaluated if given nodes change value.

Indication whether the given vertices should be included in the output graph. If set to false, (some of) the given nodes may still be part of output graph, in case they transitively depend on any node from input set.

Detects a cycle in directed (possibly disconnected) graph and returns first found cycle in cycle variable.

First cycle if any found. True if cycle found, false otherwise.

Tries to mount a from specified . Using all in .

Detects whether given sequence has any duplicate elements.

Sequence to be tested for duplicates. Comparer to be used to evaluate equality. Default comparer is being used if null is passed. true if sequence contains duplicates, false otherwise.

Detects whether given sequence has any duplicate elements and return those.

Sequence to be tested for duplicates. Comparer to be used to evaluate equality. Default comparer is being used if null is passed. Sequence of elements being duplicated in input. Each item is returned just once, even if located multiple times in original sequence. Empty sequence returned if input has no duplicates.

Concatenates items of input sequence into csv string.

Sequence to be turned into csv string. Indicates whether space should be inserted between comas and following items. Csv string.

Enqueue elements of given sequence to a queue.

Performs an action for each element in given sequence.

Instance of Matcher satisfying all patterns tests.

Returns full path to including mount point URI in a format that is suitable for displaying in the CLI or printing to logs. This method wraps the path with quotes if it contains spaces.

the file system info to get full path for. Full path to including mount point URI. If mount point is not a directory, the path is returned as 'mount point URI(path inside mount point)'.

In-memory file system implementation of .

Currently not implemented in . Just returns object, but never calls callback.

Helper class which expands request like "*.nupkg" into multiple ".nupkg" files in folder. And returns absolute path to files or folders.

Returns absolute path to files or folders resolved from or unchanged when path cannot be resolved.

Example of would be "C:\Users\username\packages\*.nupkg".
Wildcards are supported only in file name. Supported wildcards and rules are identical as for searchPattern for . This parameter can contain a wildcard (*) character in the filename. List of absolute paths to files or folders that match or unchanged when path cannot be resolved.

Interface for pattern matchers.

Evaluates the test path against the pattern and returns whether the path is a match.

Converts to .

to converr. the path to localization file to use in . the path to host config file to use in .

Defines a version specification used in a template definition.

Checks if the specified version is valid.

the version to check.

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 Key [{0}] is already present..

Container type holding the values for parameters with multiple values.

Separator of multi valued parameters (currently applicable only to choices).

Initializes a new instance of the class.

Set of characters that can be used for separating multi valued parameters (currently applicable only to choices).

The actual atomic values specified for the parameter.

Creates instance of from the legacy .

Legacy parameterset to be converted.

extension that try to parse first in current culture, then in invariant culture.

The value to parse. Parsed double value if can be parsed. true when can be parsed in current or invariant culture. false when cannot be parsed in current or invariant culture.

extension that try to parse first in current culture, then in invariant culture.

The value to parse. Parsed double value if can be parsed. is not in an appropriate format for a type.

Local file system implementation of .

The class provides ITemplateInfo extension methods.

Gets the language defined in .

template definition. The language defined in the template or null if no language is defined.

Gets the type defined in .

template definition. The type defined in the template or null if no type is defined.

Gets the possible values for the tag in .

template definition. tag name. The value of tag defined in the template or null if the tag is not defined in the template.

Gets the template parameter by .

template. parameter name. first with or null if the parameter with such name does not exist.

Gets the choice template parameter by .

template. parameter name. first choice with or null if the parameter with such name does not exist.

Set of useful extensions when working with .

Returns true when has or match on .