@0xproject/sra-report 中文文档教程

发布于 3年前 浏览 25 项目主页 更新于 3年前

SRA Report

此工具允许您生成报告,详细说明端点的标准中继器 API HTTP 规范合规性。 该工具将执行 Postman collection 运行并将报告打印到控制台或将其保存到磁盘作为 json 文件。 SRA报告还可以输出一个Postman集合文件和Postman环境文件,方便复制和调试使用 Postman 本机应用程序 运行收集。

该工具当前对每个端点执行以下检查:

  • application/json Content-Type header validation
  • JSON schema validation
  • Correct filtering when a query paramater is provided (ex. when querying for a specific maker address, all orders returned have the same maker address that was provided by the query)

即将推出的功能:

  • Correct sorting (ex. the /orderbook endpoint should return orders in order of price)
  • Tests for pagination
  • Tests for the POST /order endpoint
  • Tests for failure cases and errors

Installation

yarn add -g @0xproject/sra-report

Options

sra-report
Options:
  --help                      Show help                                [boolean]
  --version                   Show version number                      [boolean]
  --endpoint-url, -e          API endpoint url to test for standard relayer API
                              compliance                     [string] [required]
  --output, -o, --out         The relative path to write the report generated by
                              the collection run, prints to console by default
                                                                        [string]
  --network-id, -n            ID of the network that the API is serving orders
                              from                         [number] [default: 1]
  --environment, --env        The relative path to a postman environment file
                              for the collection run                    [string]
  --export-collection, --ec   The relative path to write the postman collection
                              file used by the collection run           [string]
  --export-environment, --ee  The relative path to write the postman environment
                              file used by the collection run           [string]

Example Usage

Print report to console

sra-report --endpoint-url 'http://api.example.com'

Save a report to disk

sra-report --endpoint-url 'http://api.example.com' --output 'path/to/report.json'

Generate report for an endpoint that serves kovan testnet orders

sra-report --endpoint-url 'http://kovan.api.example.com' --network-id 42

Write Postman collection and environment files for use in the Postman native app

sra-report --endpoint-url 'http://.api.example.com' --export-collection 'path/to/collection.json' --export-environment 'path/to/environment.json'

Run the report using a custom environment

sra-report --endpoint-url 'http://.api.example.com' --environment 'path/to/custom/environment.json'

Custom environments

在开发中测试标准中继 API 端点时,修改 Postman 可能会有用此工具生成的环境文件,以便在收集运行期间使用特定的查询参数。 例如,默认情况下,此工具将从 /orders 端点获取第一个订单,并将该订单的属性用作其余运行的查询参数。 另一个例子是该工具将默认为 WETH

为了向该工具提供自定义环境,请执行以下步骤:

  1. Export a Postman environment file using the tool: example
  2. Open the Postman environment file using your favorite text editor or in the Postman native app
  3. Modify the specific values you want
  4. Save the environment file and export it if using the Postman native app
  5. Run the tool and supply a path to your modified environment file: example

Contributing

我们欢迎来自更广泛社区的改进和修复! 要报告此包中的错误,请在此存储库中创建一个问题。

请在开始之前阅读我们的贡献指南

Install dependencies

如果您没有启用 yarn workspaces (Yarn < v1.0) - 启用它们:

yarn config set workspaces-experimental true

然后安装依赖

yarn install

Build

项 要构建此包和它所依赖的所有其他 monorepo 包,请从 monorepo 根目录运行以下命令:

PKG=@0xproject/sra-report yarn build

或持续重建关于改变:

PKG=@0xproject/sra-report yarn watch

Clean

yarn clean

Lint

yarn lint

Run Tests

yarn test

SRA Report

This tool allows you to generate reports that detail an endpoint's standard relayer API HTTP specification compliance. The tool will perform a Postman collection run and either print a report to the console or save it to disk as a json file. SRA report can also output a Postman collection file and Postman environment file in order to facilitate replication and debugging of collection runs using the Postman native app.

The tool currently performs the following checks for each endpoint:

  • application/json Content-Type header validation
  • JSON schema validation
  • Correct filtering when a query paramater is provided (ex. when querying for a specific maker address, all orders returned have the same maker address that was provided by the query)

Features to come:

  • Correct sorting (ex. the /orderbook endpoint should return orders in order of price)
  • Tests for pagination
  • Tests for the POST /order endpoint
  • Tests for failure cases and errors

Installation

yarn add -g @0xproject/sra-report

Options

sra-report
Options:
  --help                      Show help                                [boolean]
  --version                   Show version number                      [boolean]
  --endpoint-url, -e          API endpoint url to test for standard relayer API
                              compliance                     [string] [required]
  --output, -o, --out         The relative path to write the report generated by
                              the collection run, prints to console by default
                                                                        [string]
  --network-id, -n            ID of the network that the API is serving orders
                              from                         [number] [default: 1]
  --environment, --env        The relative path to a postman environment file
                              for the collection run                    [string]
  --export-collection, --ec   The relative path to write the postman collection
                              file used by the collection run           [string]
  --export-environment, --ee  The relative path to write the postman environment
                              file used by the collection run           [string]

Example Usage

Print report to console

sra-report --endpoint-url 'http://api.example.com'

Save a report to disk

sra-report --endpoint-url 'http://api.example.com' --output 'path/to/report.json'

Generate report for an endpoint that serves kovan testnet orders

sra-report --endpoint-url 'http://kovan.api.example.com' --network-id 42

Write Postman collection and environment files for use in the Postman native app

sra-report --endpoint-url 'http://.api.example.com' --export-collection 'path/to/collection.json' --export-environment 'path/to/environment.json'

Run the report using a custom environment

sra-report --endpoint-url 'http://.api.example.com' --environment 'path/to/custom/environment.json'

Custom environments

When testing your standard relayer API endpoint in development, it may be useful to modify the Postman environment file generated by this tool such that specific query parameters are used during the collection run. For example, by default, this tool will grab the first order it can from the /orders endpoint and use properties from that order as query parameters for the rest of the run. Another example is the tool will default to the WETH and ZRX token contracts when querying some endpoints but you may want to specify these.

In order to provide a custom environment to the tool, perform the following steps:

  1. Export a Postman environment file using the tool: example
  2. Open the Postman environment file using your favorite text editor or in the Postman native app
  3. Modify the specific values you want
  4. Save the environment file and export it if using the Postman native app
  5. Run the tool and supply a path to your modified environment file: example

Contributing

We welcome improvements and fixes from the wider community! To report bugs within this package, please create an issue in this repository.

Please read our contribution guidelines before getting started.

Install dependencies

If you don't have yarn workspaces enabled (Yarn < v1.0) - enable them:

yarn config set workspaces-experimental true

Then install dependencies

yarn install

Build

To build this package and all other monorepo packages that it depends on, run the following from the monorepo root directory:

PKG=@0xproject/sra-report yarn build

Or continuously rebuild on change:

PKG=@0xproject/sra-report yarn watch

Clean

yarn clean

Lint

yarn lint

Run Tests

yarn test
    我们使用 Cookies 和其他技术来定制您的体验包括您的登录状态等。通过阅读我们的 隐私政策 了解更多相关信息。 单击 接受 或继续使用网站,即表示您同意使用 Cookies 和您的相关数据。
    原文