Lib.rs

有关如何将 Pact 数据编码为二进制数据以及如何从二进制数据解码 Pact 数据的信息，请参阅 codec 文档。

我该如何创建一个 Pact？

Pact 是使用 TOML 创建的。

## An example pact.
pact = 'MyGreeter'

## Data type in this pact
## named "Request".
[data.1. Request]
message = 'string'

## Another data type in this
## pact named "Response".
[data.2. Response]
message = 'string'

## This field of a Response is a
## list of strings, instead of just
## a single string, because it is
## surrounded by `[]`.
friends = ['string']

## This field of a Response is a
## copy of the request that the
## response is for, showing how
## we can nest other data types
## within data types.
request = 'Request'

以下示例描述了一个包含两种数据（Request 和 Response）的 MyGreeter Pact。这两种数据都包含一个 message 字符串，而 Response 数据包含一个名为 friends 的字符串列表以及原始的 Request 的副本。

每个数据描述都从一个称为 序数 的数字开始。序数唯一地标识了同一 Pact 中不同类型的数据。Pact 描述的第一个数据始终具有序数 1，同一 Pact 中每个额外的数据类型都有一个序数，比上一个数据高一个。

以 ## 开头的注释，紧接在 pact 名称、data 名称或字段名称之前，将作为前述项的文档进行解析。

在您自己的项目中开始使用 TOML Pact 的一种最简单的方法是通过 pact-derive 库。

我可以修改或“进化”一个 Pact 吗？

是的！Pact 数据旨在随着系统需求的改变而进化。

• 可以向任何 Pact 中添加新的数据类型。
• 可以向任何数据类型添加新的字段。
• 可以重命名现有的字段和数据类型。

如果系统收到它不支持的新类型的数据，或者包含它不支持的新字段的数据，则新信息将被优雅地忽略。

相反，如果系统收到缺少新添加字段的 缺失 数据，则缺失的字段将使用默认值优雅地填充。

许可证

版权所有 2024 阿里科恩系统公司。

根据自由软件基金会发布的 GNU Affero 通用公共许可证版本 3 许可。有关更多信息，请参阅 许可证文件。

如果您有任何疑问，请联系 [hello@alicorn.systems].