@dev-build-deploy/sarif-it

中文文档
0.2.1发布于 2023/08/03MITTypeScriptCommonJS近 30 天下载 8944

静态分析结果互换格式构建库

中文使用文档
文档目录6 节
  1. 特征
  2. 使用量
  3. 定义新的代码质量分析工具
  4. 创建代码质量分析报告
  5. 捐款
  6. 许可证

SarifIt - 静态分析结果互换格式构建器

轻量级[SARIF]构建器库,允许您的工具生成统一的代码质量报告.

特征

  • 简单使用
  • 创建 SARIF 对象的折叠器
  • 与[SARIF 2.1.0]相配

使用量

定义新的代码质量分析工具

import * as sarif from "@dev-build-deploy/sarif-it";

const tool = new sarif.Tool("code-scanner")
  .organization("dev-build-deploy")
  .version("0.0.0")
  .informationUri("https://github.com/dev-build-deploy/sarif-it#README.md");

const missingDocsRule = new sarif.Rule("MissingDocumentation")
  .name("Missing Documentation")
  .shortDescription("All repositories must contain a README.md containing basic instructions.")
  .fullDescription({
    text: "As documentation is important, we expect all repositories to contain at least a README.md file.",
    markown: "As documentation is *important*, we expect **all** repositories to contain *at least* a `README.md` file."
  })
  .helpUri("https://github.com/dev-build-deploy/sarif-it#README.md");

tool.addRule(missingDocsRule);

创建代码质量分析报告

假设我们已经定义了代码质量分析工具(这里(三);

import * as sarif from "@dev-build-deploy/sarif-it";

const log = new sarif.Log()
  .addRun(new sarif.Run(tool));  // NOTE: Example for creating a `tool` can be found in the previous chapter

const result = new sarif.Result("Missing Documentation")
  .ruleId("MissingDocumentation")
  .level("error")
  .addLocation({
    physicalLocation: {
      artifactLocation: {
        uri: "./README.md",
      },
    },    
  })

log.get("runs")[0].addResult(result);

捐款

有建议的话 sarif-it 可以改进, 或者想要报告一个错误, 打开一个问题! 我们很乐意所有的贡献.

更多,请检查 贡献指南。 。 。 .

许可证

版本与发布记录

@dev-build-deploy/sarif-it 共发布 3 个版本,首次发布于 2023/07/28;过去 12 个月发布了 0 个版本。

版本发布日期距今
0.2.1latest2023/08/033 年前
0.2.02023/08/023 年前
0.1.02023/07/283 年前

关于 @dev-build-deploy/sarif-it 的常见问题

@dev-build-deploy/sarif-it 是什么?

静态分析结果互换格式构建库

如何安装 @dev-build-deploy/sarif-it?

在项目目录运行 npm install @dev-build-deploy/sarif-it,或使用 pnpm add / yarn add / bun add。

@dev-build-deploy/sarif-it 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@dev-build-deploy/sarif-it 支持 ESM 还是 CommonJS?

以 CommonJS 形式发布,可以直接 require();在 ES Module 项目中也可以用 import 引入(Node.js 会把 module.exports 作为默认导出)。

@dev-build-deploy/sarif-it 可以商用吗?

@dev-build-deploy/sarif-it 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@dev-build-deploy/sarif-it 的下载量有多少?

根据 npm 官方下载统计,@dev-build-deploy/sarif-it 在 2026/10/12 – 2026/11/10 这 30 天内被下载 8,944 次,日均约 298 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@dev-build-deploy/sarif-it 还在维护吗?

最新版本 0.2.1 发布于 2023/08/03(3 年前);至今共发布 3 个版本,其中过去 12 个月发布了 0 个;首次发布于 2023/07/28。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。