Parcel.CoreEngine.Service.zh
Parcel.CoreEngine.Service.Ama.AmaExecutionEngine
Ama stated execution engine
Parcel.CoreEngine.Service.Ama.AmaRuntime
Amo的混合运行时助手
Parcel.CoreEngine.Service.Interpretation.AmaServiceProvider
A context-safe interpolation stated service provider;
It provides "step-wise" construction of the entire document.
返回值说明
返回构建整个文档的步骤
Parcel.CoreEngine.Service.Interpretation.AmaServiceProvider.CreateNode()
请求服务器复制一个节点。客户端将负责提供有关该节点的所有定义信息 - 这对于前端仅节点尤为重要,服务器应该只是存储而不询问其用途。
Parameters
| Name | Description | Default |
|---|---|---|
nodeName |
||
nodeType |
||
nodeData |
||
parentNode |
||
metadata |
操作结果
返回操作的结果
Parcel.CoreEngine.Service.Interpretation.AmaServiceProvider.EvaluateNode()
Remarks
前端调用此函数的期望是所有返回的对象值代表有效载荷,因此我们应该明确从该端点返回有效载荷。
Parameters
| Name | Description | Default |
|---|---|---|
|
节点的唯一标识符。 | |
|
第一个参数的描述。 | |
|
第二个参数的描述。 | |
|
包含键值对的字典。 |
有效载荷
返回值表示有效载荷。
Parcel.CoreEngine.Service.Interpretation.ActionReference
Remarks
WIP 中间类型,用于在 Callable 和 FunctionalNodeDescription 之间,持续工作以完善更多细节。处理表示、序列化和编码/解码。
这提供了对现有函数/自定义函数(Lambda、代码片段)和节点/节点图的“函数即类”的引用。
Parcel.CoreEngine.Service.Interpretation.ActionReference.GetAction()
Get the action (as delegate object)
Parameters
| Name | Description | Default |
|---|---|---|
|
type |
返回动作
返回动作
Parcel.CoreEngine.Service.Interpretation.ActionReference.TryDereference()
// 给定一个委托对象,尝试将其反引用为编码动作字符串
Parameters
| Name | Description | Default |
|---|---|---|
obj |
编码动作字符串
Parcel.CoreEngine.Service.Interpretation.GraphRuntime.NodeTargetPathStructureProtocolSyntax
Remarks
模式:
解释:
^({(.*?)})?(\\[(.*?)\\])?((.*?):)?(.*?)$解释:
○ 如果在字符串的开头匹配。
○ 可选(贪婪)。
○ 第1个捕获组。
○ 匹配 '{'。
○ 第2个捕获组。
○ 懒惰匹配除 '\n' 外的任意字符任意次数。
○ 匹配 '}'。
○ 可选(贪婪)。
○ 第3个捕获组。
○ 匹配 '['。
○ 第4个捕获组。
○ 懒惰匹配除 '\n' 外的任意字符任意次数。
○ 匹配 ']'。
○ 可选(贪婪)。
○ 第5个捕获组。
○ 第6个捕获组。
○ 懒惰匹配除 '\n' 外的任意字符任意次数。
○ 匹配 ':'。
○ 第7个捕获组。
○ 懒惰匹配除 '\n' 外的任意字符任意次数。
○ 如果在字符串的末尾匹配或在结束换行符之前匹配。
Parcel.CoreEngine.Service.Interpretation.InteroperationHelper
提供方法和参数级别的强制转换服务,
提供将字符串转换为值及其逆过程的服务,
提供将C#(Parcel)中的知名对象转换为Python的服务。
Parcel.CoreEngine.Service.Interpretation.InteroperationHelper.ShouldCoerce()
测试作为目标方法的第一个位置参数是否需要强制转换
Parameters
| Name | Description | Default |
|---|---|---|
type |
||
methodInfo |
需要强制转换的布尔值
返回一个布尔值,指示是否需要强制转换
Parcel.CoreEngine.Service.Interpretation.InterpolationServiceProvider
A context-safe interpolation service provider;
The services provided here are stateless, use Ama Service Provider for stated services.
Parcel.CoreEngine.Service.Interpretation.InterpolationServiceProvider.EvaluateSubGraph()
给定一组自包含的Parcel节点,评估它们并返回每个节点的结果。
该函数假定一个无图的松散节点集合,节点之间的相互依赖关系使用标准属性语法指定。
返回有效载荷将按照输入节点的顺序排列,并为每个节点提供一个有效载荷。
Parameters
| Name | Description | Default |
|---|---|---|
|
Parcel.CoreEngine.Document.VraNode数组 |
返回结果列表
返回结果列表
Parcel.CoreEngine.Service.Interpretation.InvokationService
注意这并不涉及状态隔离;
为了正确的状态隔离,我们应该依赖于 Parcel.NExT.Interpreter
Parcel.CoreEngine.Service.Compilation.ReflectionRuntime
A runtime using C# reflection
Parcel.CoreEngine.Service.CoreExtensions.ParcelNodeExtension
提供独立的节点作为服务的执行服务
Parcel.CoreEngine.Service.CoreExtensions.ParcelNodePayloadAccessHelper
提供用于有效载荷编组和提取的方法
Parcel.CoreEngine.Service.CoreExtensions.ParcelNodePayloadAccessHelper.ExtractNumericalValue()
从负载中提取数值,遵循一些约定 - 待定义
Parameters
| Name | Description | Default |
|---|---|---|
|
payload |
数值
提取的数值
Parcel.CoreEngine.Service.Document.DocumentProvisionService
Ama 提供的操作相当于在 GUI 中创建和编辑图形
Parcel.CoreEngine.Service.Document.DocumentProvisionService.Document
State of the document
Parcel.CoreEngine.Service.Document.DocumentProvisionService.DeleteAll
Delete all nodes and graphs, reset "Default" graph
返回的显示名称
操作成功
Parcel.CoreEngine.Service.Document.DocumentProvisionService.CreateGraph()
创建具有给定名称的新图。
Parameters
| Name | Description | Default |
|---|---|---|
|
name |
返回的图
返回创建的图对象。
Parcel.CoreEngine.Service.Document.DocumentProvisionService.ClearGraph()
清除图中的所有节点
Parameters
| Name | Description | Default |
|---|---|---|
|
graph |
返回结果
操作结果
Parcel.CoreEngine.Service.LibraryProvider.TargetEndPoint
在概念上,根据 EndPointNature,类型或方法将可用;
然而,由于 C# 中的所有方法都有类型,因此在引用 C# 端点时,类型始终可用,即使是静态方法;
而对于 Python,由于没有类型,并且没有 C# MethodInfo,仅标识符可用。
Parcel.CoreEngine.Service.LibraryProvider.TargetEndPoint.#ctor()
概念上,Type 或 Method 将根据 EndPointNature 可用;
然而,由于 C# 中所有方法都有类型,因此在引用 C# 端点时,Type 总是可用,即使是静态方法;
但是对于 Python,由于没有 Type,并且由于没有 C# MethodInfo,只有 Identifier 是可用的。
Parameters
| Name | Description | Default |
|---|---|---|
EndPointNature |
||
string |
||
Type |
||
MethodInfo |
构造函数返回值
构造函数返回值描述
Parcel.CoreEngine.Service.LibraryProvider.LibraryProviderServices
单一入口提供所有服务查询相关功能。
此处公开的方法是所有与服务查询相关的后端服务的基石。
Remarks
此处提供的方法通常对于直接的后端使用是有意义的,即返回类型通常是明确定义的可序列化基本类型、结构等。
此处的方法不需要返回字符串序列化值,可以返回任何可序列化的一般类型(虽然一般应避免复杂类型) - 序列化是后端的责任。
Parcel.CoreEngine.Service.LibraryProvider.LibraryProviderServices.GetAvailableServices
获取该类中所有适合后端使用的可用公共实例方法。
返回所有可用的公共实例方法
返回的结果不包括该方法本身和一些C#标准实例方法。
Parcel.CoreEngine.Service.LibraryProvider.LibraryProviderServices.GetAllTargetPaths
获取所有有效的端点,包括类型和(全局/静态)方法;排除特定类型的实例方法。
TODO: 提供一个方法来获取完整的 NodeTargetDescriptors,而不仅仅是名称
Remarks
可能会消耗资源
所有有效的端点列表
Parcel.CoreEngine.Service.LibraryProvider.LibraryServiceHelper.GetLoadedUserFacingAssemblies
获取当前应用程序域中所有已加载的程序集,这些程序集面向Parcel用户,即排除特定于Parcel运行时引擎的程序集
已加载的用户面向程序集列表
Parcel.CoreEngine.Service.Localization.ParcelCoreEngineServiceStringResources.LoadedTypeNames
全局加载和可识别的类型名称,从类型识别字符串到显示名称。
Remarks
在运行时,我们通常只向此字典添加内容,而不会修改或从中删除内容。
Parcel.CoreEngine.Service.Runtime.FailureReportMode
Denotes in what context is current graph being evaluated.
Parcel.CoreEngine.Service.Runtime.FailureReportMode.Benign
图形在图形编辑器中运行,在这种情况下,节点的故障通常不会造成任何伤害,并且是图形用户界面所预期的
Parcel.CoreEngine.Service.Runtime.FailureReportMode.MissionCritical
该图在自动化/应用程序/CLI中运行,在这种情况下,节点的故障应当停止程序,除非由运行者/主机另行处理
Parcel.CoreEngine.Service.Runtime.GeneralPurposeRedirectedTextWriter.OutputHandler
配置输出处理的使用
Parcel.CoreEngine.Service.Runtime.RuntimeEngine.Interpretative
Aka. Ama
Parcel.CoreEngine.Service.Runtime.RuntimeEngine.Compiled
Aka.Spark
Parcel.CoreEngine.Service.ServiceProvider.GetAvailableServices
获取此类中所有可供后台使用的公共实例方法。
返回的可用服务
返回不包括此方法本身和一些C#标准实例方法
Parcel.CoreEngine.Service.ServiceProvider.ResolveTarget()
Given a target protocol, find the matching endpoint to use.
Parameters
| Name | Description | Default |
|---|---|---|
protocol |
匹配的端点
Parcel.Neo.Base.Framework.IToolboxDefinition.ToolboxName
Name for display purpose.
Parcel.Neo.Base.Framework.IToolboxDefinition.ExportNodes
定义工具箱中可用的工具节点。
导出结果
返回导出操作的结果
Parcel.Neo.Base.Framework.ToolboxIndexer
Remarks
TODO: Rename to ToolboxManager
Parcel.Neo.Base.Framework.ToolboxIndexer.AssemblyToolboxDefinition
表示整个程序集,采用传统加载方式。这是导入函数的最“原生”方式。
Parameters
| Name | Description | Default |
|---|---|---|
ToolboxName |
如果提供,作为覆盖使用 |
返回值
无
Parcel.Neo.Base.Framework.ToolboxIndexer.AssemblyToolboxDefinition.#ctor()
表示整个程序集,使用常规加载。这是导入功能的最“原生”方式。
Parameters
| Name | Description | Default |
|---|---|---|
ToolboxName |
如果提供,则作为覆盖 |
返回值
返回程序集工具箱定义的实例。
Parcel.Neo.Base.Framework.ToolboxIndexer.AssemblyToolboxDefinition.ToolboxName
Serve as override if provided
Parcel.Neo.Base.Framework.ToolboxIndexer.TypeToolboxDefinition
表示要公开的特定类型。
Remarks
请注意,我们当前的约定规定 Type(及其类型名称)是一个“类别”。
Parameters
| Name | Description | Default |
|---|---|---|
ToolboxName |
如果提供,将作为覆盖,并且调用者必须处理本地化 |
返回类型工具箱定义
返回类型工具箱定义
Parcel.Neo.Base.Framework.ToolboxIndexer.TypeToolboxDefinition.#ctor()
表示一个特定类型以供暴露。
Remarks
请注意,我们当前的约定规定类型(及其类型名称)是一个“类别”。
Parameters
| Name | Description | Default |
|---|---|---|
ToolboxName |
如果提供,将作为覆盖,并且调用者必须处理本地化 |
返回类型工具箱定义构造函数
构造函数的返回结果
Parcel.Neo.Base.Framework.ToolboxIndexer.TypeToolboxDefinition.ToolboxName
作为重写,如果提供,并且调用者必须处理本地化
Parcel.Neo.Base.Framework.ToolboxIndexer.FrontendToolboxDefinition
表示一个工具箱,使用具有明确节点定义的框架类作为对象,具有强类型。这是最可自定义的工具箱。
Parcel.Neo.Base.Framework.ToolboxIndexer.FrontendToolboxDefinition.#ctor()
代表一个工具箱,该工具箱使用具有明确节点定义的框架类进行强类型化,这是最可定制的。
Parameters
| Name | Description | Default |
|---|---|---|
|
toolboxName | |
|
toolboxDefinition |
返回工具箱定义
返回值
Parcel.Neo.Base.Framework.ToolboxIndexer.ToolboxSorted
基于各种属性执行排序并拆分为类别
Parcel.Neo.Base.Framework.ToolboxIndexer.TryLoadTool()
(Experimental) Load a function from MiniParcel style command arguments, e.g. "RandomDatasets.GetPopulationData 100 2024-09-05"
Parameters
| Name | Description | Default |
|---|---|---|
|
||
|
||
|
返回结果
Parcel.Neo.Base.Framework.ToolboxIndexer.TryLoadTool()
从资源标识符加载工具(用于序列化)。
Parameters
| Name | Description | Default |
|---|---|---|
identifier |
加载结果
加载的工具实例
Parcel.Neo.Base.Framework.ToolboxIndexer.IndexToolboxes
Main routine to actually load ToolboxNodeExport from various registered definitions.
返回工具箱节点导出
Parcel.Neo.Base.Framework.ToolboxNodeExport.Tooltip
文档节点的可读文本
Parcel.Neo.Base.Framework.ToolboxNodeExport.DescriptorsCache
缓存的已编译/解析可调用表示
Parcel.Neo.Base.Framework.ToolboxNodeExport.GetCache
Retrieve or create cache.
返回缓存
Parcel.Neo.Base.Framework.ToolboxNodeExport.Execute
提供节点工具的独立一次性执行。
执行结果
Parcel.Neo.Base.Framework.ToolboxNodeExport.GetArgumentsListSimple
简单的逗号分隔的打印友好参数列表,以名称识别,例如 `Components, Background, Theme`
返回的参数列表
返回一个列出参数名称的字符串
Parcel.Neo.Base.Framework.ToolboxNodeExport.GetArgumentsListFull()
简单的以逗号分隔的打印友好参数列表,包含名称和类型,例如 `components:AppComponent[], background:String, theme:String`
Remarks
TODO: 合并 ArgumentsListFull 和 ArgumentsListSimple,使用单一的 MethodArgument 定义和 MethodArgument 数组作为集合引用;此外,看起来这里的预期功能可以与 FunctionalNodeDescription 合并
Parameters
| Name | Description | Default |
|---|---|---|
|
System.Collections.Generic.Dictionary{System.String,System.String} |
返回的参数列表
返回参数列表的完整字符串表示形式
System.Text.RegularExpressions.Generated.NodeTargetPathStructureProtocolSyntax_0
自定义System.Text.RegularExpressions.Regex派生类型,用于NodeTargetPathStructureProtocolSyntax方法。
System.Text.RegularExpressions.Generated.NodeTargetPathStructureProtocolSyntax_0.Instance
缓存的线程安全单例实例。
System.Text.RegularExpressions.Generated.NodeTargetPathStructureProtocolSyntax_0.#ctor
初始化实例。
System.Text.RegularExpressions.Generated.NodeTargetPathStructureProtocolSyntax_0.RunnerFactory
提供一个工厂用于创建 System.Text.RegularExpressions.RegexRunner 实例,以供 System.Text.RegularExpressions.Regex 方法使用。
System.Text.RegularExpressions.Generated.NodeTargetPathStructureProtocolSyntax_0.RunnerFactory.CreateInstance
创建一个 System.Text.RegularExpressions.RegexRunner 的实例,该实例由 System.Text.RegularExpressions.Regex 上的方法使用。
返回的实例
返回的 RegexRunner 实例。
System.Text.RegularExpressions.Generated.NodeTargetPathStructureProtocolSyntax_0.RunnerFactory.Runner
提供包含实现指定正则表达式的自定义逻辑的运行器。
System.Text.RegularExpressions.Generated.NodeTargetPathStructureProtocolSyntax_0.RunnerFactory.Runner.Scan()
扫描从 base.runtextstart 开始的 inputSpan 以查找下一个匹配项。
Parameters
| Name | Description | Default |
|---|---|---|
inputSpan |
正则表达式正在扫描的文本。 |
匹配结果
返回下一个匹配项的结果。
System.Text.RegularExpressions.Generated.NodeTargetPathStructureProtocolSyntax_0.RunnerFactory.Runner.TryFindNextPossibleStartingPosition()
搜索 inputSpan 从 base.runtextpos 开始,寻找一个匹配可能开始的下一个位置。
Parameters
| Name | Description | Default |
|---|---|---|
inputSpan |
正则表达式正在扫描的文本。 |
返回结果
如果找到可能的匹配则为真;如果没有更多可能的匹配则为假。
System.Text.RegularExpressions.Generated.NodeTargetPathStructureProtocolSyntax_0.RunnerFactory.Runner.TryMatchAtCurrentPosition()
确定在 base.runtextpos 处的 inputSpan 是否与正则表达式匹配。
Parameters
| Name | Description | Default |
|---|---|---|
inputSpan |
正则表达式正在扫描的文本。 |
匹配结果
如果正则表达式在当前位置匹配,则为 true;否则,返回 false。
System.Text.RegularExpressions.Generated.Utilities
帮助方法,由生成的 System.Text.RegularExpressions.Regex 派生实现使用。
System.Text.RegularExpressions.Generated.Utilities.s_defaultTimeout
默认超时值由 System.AppContext 设置,如果没有设置,则为 System.Text.RegularExpressions.Regex.InfiniteMatchTimeout。
System.Text.RegularExpressions.Generated.Utilities.s_hasTimeout
System.Text.RegularExpressions.Generated.Utilities.StackPop()
Pops 2 values from the backtracking stack.
Parameters
| Name | Description | Default |
|---|---|---|
|
values | |
|
val1 | |
|
val2 | |
|
val3 |
弹出值
返回弹出的值
System.Text.RegularExpressions.Generated.Utilities.StackPush()
将一个值推送到回溯栈上。
Parameters
| Name | Description | Default |
|---|---|---|
values |
要推送到栈的整数数组。 | |
value |
要推送的整数值。 |
成功
返回操作是否成功的指示。
System.Text.RegularExpressions.Generated.Utilities.StackPush()
Pushes 2 values onto the backtracking stack.
Parameters
| Name | Description | Default |
|---|---|---|
values |
要推送的值数组。 | |
value1 |
第一个要推送的值。 | |
value2 |
第二个要推送的值。 |
成功与否
返回一个指示推送操作是否成功的布尔值。