重构：使用 GraphQL 获取 Github APIs

[zjp-CN]

https://docs.github.com/en/graphql/overview/about-the-graphql-api

https://lib.rs/crates/graphql_client

https://github.com/graphql-rust/graphql-client/blob/main/examples/github/examples/github.rs

原因：

• 官方文档建议：要创建集成、检索数据和自动化工作流程，请使用 GitHub GraphQL API。 GitHub GraphQL API 提供比 GitHub REST API 更精确、更灵活的查询。
• 示例 0：REST API 一次只能查询一个仓库的一个维度的数据，而 GraghQL 一次查询多个仓库的多个维度的数据。
• 示例 1：当前 REST API 查询一个仓库的某分支的总提交数，需要某些技巧 https://stackoverflow.com/questions/27931139/how-to-use-github-v3-api-to-get-commit-count-for-a-repo ，而 GraphQL 可以直接查询这个数量。
• 示例 2：REST API 可以被认为是固定死的结构化的查询结果，如果抽取自己的部分字段，则需要定义与原结构类似的结构，这可能导致不必要的嵌套结构 —— 而 GraphQL 让使用者直接定义所需的数据结构。

// REST API
struct Info {
    owner: Owner,
    license: Option<License>,
}
struct Owner {
    /// user name
    login: String,
    /// Organization, User, Bot or something
    r#type: String,
}
struct License {
    spdx_id: String,
}

// GraphQL: 只需要定义 scheme 来描述如何查询
struct Info {
    owner: String,
    owner_type: String,
    license: Option<String>,
}

[zjp-CN]

查看 os-checker 组织的仓库和是否产生自 fork 的情况

{
  organization(login: "os-checker") {
    repositories(last: 10) {
      nodes {
        name
        isFork
        parent {
          owner {
            login
          }
          name
        }
      }
    }
  }
}

{
  "data": {
    "organization": {
      "repositories": {
        "nodes": [
          {
            "name": "plugin-cargo",
            "isFork": false,
            "parent": null
          },
          {
            "name": "charon",
            "isFork": true,
            "parent": {
              "owner": {
                "login": "AeneasVerif"
              },
              "name": "charon"
            }
          },
          {
            "name": "Rudra",
            "isFork": true,
            "parent": {
              "owner": {
                "login": "sslab-gatech"
              },
              "name": "Rudra"
            }
          },
          {
            "name": "Starry",
            "isFork": true,
            "parent": {
              "owner": {
                "login": "Starry-OS"
              },
              "name": "Starry"
            }
          },
          {
            "name": "docs",
            "isFork": false,
            "parent": null
          },
          {
            "name": "lkmodel",
            "isFork": true,
            "parent": {
              "owner": {
                "login": "shilei-massclouds"
              },
              "name": "lkmodel"
            }
          },
          {
            "name": "MWE-feature-selection-in-workspace",
            "isFork": false,
            "parent": null
          },
          {
            "name": "plugin",
            "isFork": false,
            "parent": null
          },
          {
            "name": "test-database",
            "isFork": false,
            "parent": null
          },
          {
            "name": "os-checker-action",
            "isFork": false,
            "parent": null
          }
        ]
      }
    }
  }
}

筛选 os-checker 组织中被 fork 仓库的父仓库

{
  organization(login: "os-checker") {
    repositories(last: 10, isFork: true) {
      nodes {
        name
        parent {
          owner {
            login
          }
          name
        }
      }
    }
  }
}

{
  "data": {
    "organization": {
      "repositories": {
        "nodes": [
          {
            "name": "MIRAI",
            "parent": {
              "owner": {
                "login": "endorlabs"
              },
              "name": "MIRAI"
            }
          },
          {
            "name": "kern-crates.github",
            "parent": {
              "owner": {
                "login": "kern-crates"
              },
              "name": ".github"
            }
          },
          {
            "name": "cargo_metadata",
            "parent": {
              "owner": {
                "login": "oli-obk"
              },
              "name": "cargo_metadata"
            }
          },
          {
            "name": "jsonxf",
            "parent": {
              "owner": {
                "login": "gamache"
              },
              "name": "jsonxf"
            }
          },
          {
            "name": "RAP",
            "parent": {
              "owner": {
                "login": "Artisan-Lab"
              },
              "name": "RAP"
            }
          },
          {
            "name": "fork-cargo-geiger",
            "parent": {
              "owner": {
                "login": "mleonhard"
              },
              "name": "fork-cargo-geiger"
            }
          },
          {
            "name": "charon",
            "parent": {
              "owner": {
                "login": "AeneasVerif"
              },
              "name": "charon"
            }
          },
          {
            "name": "Rudra",
            "parent": {
              "owner": {
                "login": "sslab-gatech"
              },
              "name": "Rudra"
            }
          },
          {
            "name": "Starry",
            "parent": {
              "owner": {
                "login": "Starry-OS"
              },
              "name": "Starry"
            }
          },
          {
            "name": "lkmodel",
            "parent": {
              "owner": {
                "login": "shilei-massclouds"
              },
              "name": "lkmodel"
            }
          }
        ]
      }
    }
  }
}