diff --git a/augur/routes/util.py b/augur/routes/util.py index 69a733193d..54ecb6cbd4 100644 --- a/augur/routes/util.py +++ b/augur/routes/util.py @@ -94,7 +94,7 @@ def get_repos_in_repo_group(repo_group_id): status=200, mimetype="application/json") - @server.app.route('/{}/owner//name/'.format(server.api_version)) + @server.app.route('/{}/owner//repo/'.format(server.api_version)) def get_repo_by_git_name(owner, repo): get_repo_by_git_name_sql = s.sql.text(""" @@ -191,7 +191,7 @@ def get_issues(repo_group_id, repo_id=None): repo_name FROM issues JOIN repo ON issues.repo_id = repo.repo_id, issue_events WHERE issues.repo_id = :repo_id - AND issues.pull_request IS NULL + AND issues.pull_request IS NULL AND issues.issue_id = issue_events.issue_id GROUP BY issues.issue_id, repo_name ORDER by OPEN_DAY DESC diff --git a/docs/source/rest-api/spec.yml b/docs/source/rest-api/spec.yml index 2778e9ea78..3eef959f61 100644 --- a/docs/source/rest-api/spec.yml +++ b/docs/source/rest-api/spec.yml @@ -9,10 +9,97 @@ info: version: 0.12.0 openapi: 3.0.0 paths: + #utility endpoints + /repo-groups: + get: + description: Get all the downloaded repo groups. + operationId: Get All Repo Groups + responses: + '200': + description: OK + schema: + items: + properties: + data_collection_date: + description: 'Example: 2019-06-05T13:36:25.000Z' + type: string + data_source: + description: 'Example: git' + type: string + repo_group_id: + description: 'Example: 20' + type: integer + rg_description: + description: 'Example: Rails Ecosystem.' + type: string + rg_last_modified: + description: 'Example: 2019-06-03T15:55:20.000Z' + type: string + rg_name: + description: 'Example: Rails' + type: string + rg_recache: + description: 'Example: 0' + type: integer + rg_type: + description: 'Example: GitHub Organization' + type: string + rg_website: + description: 'Example: ' + type: string + tool_source: + description: 'Example: load' + type: string + tool_version: + description: 'Example: one' + type: string + type: array + tags: + - utility + /repos: + get: + description: Get all the downloaded repos. + operationId: Get All Repos + responses: + '200': + description: OK + schema: + items: + properties: + base64_url: + description: 'Example: Z2l0aHViLmNvbS9hcGFjaGUvaW5jdWJhdG9yLWFyZ3VzLmdpdA==' + type: string + commits_all_time: + description: 'Example: None' + type: string + description: + description: 'Example: None' + type: string + issues_all_time: + description: 'Example: None' + type: string + repo_id: + description: 'Example: 21996' + type: integer + repo_name: + description: 'Example: incubator-argus' + type: string + repo_status: + description: 'Example: Update' + type: string + rg_name: + description: 'Example: Apache' + type: string + url: + description: 'Example: github.com/apache/incubator-argus.git' + type: string + type: array + tags: + - utility /owner/:owner/repo/:repo: get: description: Get the repo_group_id and repo_id of a particular repo. - operationId: Get Repo + operationId: Get Repo by Owner and Repo Name responses: '200': description: OK @@ -28,10 +115,85 @@ paths: type: array tags: - utility - /repo-groups: + /rg-name/:rg_name/repo-name/:repo_name: + get: + description: Get the repo_group_id and repo_id of a particular repo. + operationId: Get Repo by Repo Group Name and Repo Name + responses: + '200': + description: OK + schema: + items: + properties: + repo_git: + description: 'Example: https://github.com/rails/rails.git' + type: string + repo_group_id: + description: 'Example: 20' + type: integer + repo_id: + description: 'Example: 21000' + type: integer + type: array + tags: + - utility + /rg-name/:rg_name: + get: + description: Get the repo_id of a particular repo group. + operationId: Get Repo by Repo Name + responses: + '200': + description: OK + schema: + items: + properties: + repo_group_id: + description: 'Example: 20' + type: integer + rg_name: + description: 'Example: Rails' + type: string + type: array + tags: + - utility + /repo-groups/:repo_group_id/repos: + get: + description: Get all the repos in a repo group. + operationId: Get Repos in Repo Group + responses: + '200': + description: OK + schema: + items: + properties: + commits_all_time: + description: 'Example: 6874' + type: integer + description: + description: 'Example: None' + type: string + issues_all_time: + description: 'Example: 81' + type: integer + repo_id: + description: 'Example: 21326' + type: integer + repo_name: + description: 'Example: graphql-js' + type: string + repo_status: + description: 'Example: Complete' + type: string + url: + description: 'Example: https://github.com/graphql/graphql-js.git' + type: string + type: array + tags: + - utility + /repo-groups/:repo_group_id/top-insights: get: description: Get all the downloaded repo groups. - operationId: Repo Groups + operationId: Get Top Insights responses: '200': description: OK @@ -74,13 +236,17 @@ paths: type: array tags: - utility - /repo-groups/:repo_group_id/committers: + + + + #risk endpoints + /repo-groups/:repo_group_id/average-issue-resolution-time: get: - description: 'Number of persons opening an issue for the first time. ' + description: 'The average issue resolution time. ' externalDocs: description: CHAOSS Metric Definition - url: https://github.com/chaoss/wg-risk/blob/master/metrics/Committers.md - operationId: (Repo Group) + url: https://github.com/chaoss/wg-risk/blob/master/focus-areas/business-risk.md + operationId: Average Issue Resolution Time (Repo Group) parameters: - description: Repository Group ID in: path @@ -88,53 +254,32 @@ paths: schema: type: string type: string - - description: Periodicity specification. - in: path - name: period - schema: - type: string - type: string - - description: 'Beginning date specification. E.g. values: 2018, 2018-05, 2019-05-01' - in: path - name: begin_date - schema: - type: string - type: string - - description: 'Ending date specification. E.g. values: 2018, 2018-05, 2019-05-01' - in: path - name: end_date - schema: - type: string - type: string responses: '200': description: OK schema: items: properties: - count: - description: 'Example: 372' - type: integer - date: - description: 'Example: 2007-01-01T00:00:00.000Z' + avg_issue_resolution_time: + description: 'Example: 1413 days 15:39:48' type: string - rg_name: - description: 'Example: Comcast' + repo_id: + description: 'Example: 21353' + type: integer + repo_name: + description: 'Example: open_id_authentication' type: string type: array tags: - risk - /repo-groups/:repo_group_id/abandoned_issues: + /repos/:repo_id/average-issue-resolution-time: get: - description: List of abandoned issues (last updated >= 1 year ago) - operationId: Abandoned Issues (Repo) + description: 'The average issue resolution time. ' + externalDocs: + description: CHAOSS Metric Definition + url: https://github.com/chaoss/wg-risk/blob/master/focus-areas/business-risk.md + operationId: Average Issue Resolution Time (Repo) parameters: - - description: Repository Group ID - in: path - name: repo_group_id - schema: - type: string - type: string - description: Repository ID. in: path name: repo_id @@ -147,85 +292,87 @@ paths: schema: items: properties: - issue_id: - description: 'Example: 125071' - type: integer - repo_id: - description: 'Example: 22004' - type: integer - updated_at: - description: 'Example: 2017-10-30T06:52:19.000Z' + avg_issue_resolution_time: + description: 'Example: 276 days 13:54:13.2' + type: string + repo_name: + description: 'Example: maven-release' type: string type: array tags: - - experimental - /repo-groups/:repo_group_id/aggregate-summary: + - risk + /repo-groups/:repo_group_id/cii-best-practices-badge: get: - description: Returns the current count of watchers, stars, and forks and the - counts of all commits, committers, and pull requests merged between a given - beginning and end date (default between now and 365 days ago). - operationId: Aggregate Summary (Repo Group) + description: 'The CII Best Practices Badge level. ' + externalDocs: + description: CHAOSS Metric Definition + url: https://github.com/chaoss/wg-risk/blob/master/focus-areas/security.md + operationId: CII Best Practices Badge (Repo Group) parameters: - - description: Repository Group ID. + - description: Repository Group ID in: path name: repo_group_id schema: type: string type: string - - description: 'Beginning date specification. E.g. values: 2018, 2018-05, 2019-05-01' - in: path - name: begin_date - schema: - type: string - type: string - - description: 'Ending date specification. E.g. values: 2018, 2018-05, 2019-05-01' - in: path - name: end_date - schema: - type: string - type: string responses: '200': description: OK schema: items: properties: - commit_count: - description: 'Example: 7890143' - type: integer - committer_count: - description: 'Example: 8553' - type: integer - fork_count: - description: 'Example: 226841' - type: integer - merged_count: - description: 'Example: 3883' - type: integer - star_count: - description: 'Example: 460447' - type: integer - watcher_count: - description: 'Example: 69106' + badge_level: + description: 'Example: in_progress' + type: string + repo_id: + description: 'Example: 21252' type: integer + repo_name: + description: 'Example: php-legal-licenses' + type: string type: array tags: - - experimental - /repo-groups/:repo_group_id/annual-commit-count-ranked-by-new-repo-in-repo-group: + - risk + /repos/:repo_id/cii-best-practices-badge: get: - description: 'This is an Augur-specific metric. We are currently working to - define these more formally. ' - operationId: Annual Commit Count Ranked by New Repo in Repo Group(Repo) + description: 'The CII Best Practices Badge level. ' + externalDocs: + description: CHAOSS Metric Definition + url: https://github.com/chaoss/wg-risk/blob/master/focus-areas/security.md + operationId: CII Best Practices Badge (Repo) parameters: - - description: Repository Group ID. + - description: Repository ID. in: path - name: repo_group_id + name: repo_id schema: type: string type: string - - description: Repository ID. + responses: + '200': + description: OK + schema: + items: + properties: + badge_level: + description: 'Example: passing' + type: string + repo_name: + description: 'Example: trickster' + type: string + type: array + tags: + - risk + /repo-groups/:repo_group_id/committers: + get: + description: 'Number of persons opening an issue for the first time. ' + externalDocs: + description: CHAOSS Metric Definition + url: https://github.com/chaoss/wg-risk/blob/master/metrics/Committers.md + operationId: Committers (Repo Group) + parameters: + - description: Repository Group ID in: path - name: repo_id + name: repo_group_id schema: type: string type: string @@ -253,133 +400,140 @@ paths: schema: items: properties: - commits: - description: 'Example: 289' - type: integer - net: - description: 'Example: 21996' - type: integer - repo_id: - description: 'Example: 21000' + count: + description: 'Example: 372' type: integer - repo_name: - description: 'Example: rails' + date: + description: 'Example: 2007-01-01T00:00:00.000Z' + type: string + rg_name: + description: 'Example: Comcast' type: string - year: - description: 'Example: 2004' - type: integer type: array tags: - - experimental - /repo-groups/:repo_group_id/annual-commit-count-ranked-by-repo-in-repo-group: + - risk + /repos/:repo_id/committers: get: - description: 'This is an Augur-specific metric. We are currently working to - define these more formally. ' - operationId: Annual Commit Count Ranked by Repo in Repo Group(Repo) + description: 'Number of persons contributing with an accepted commit for the + first time. ' + externalDocs: + description: CHAOSS Metric Definition + url: https://github.com/chaoss/wg-risk/blob/master/metrics/Committers.md + operationId: Committers (Repo) parameters: - - description: Base64 version of the URL of the GitHub repository as it appears - in the Facade DB + - description: Repository ID. in: path - name: repo_url_base + name: repo_id schema: - type: String - type: String + type: string + type: string + - description: Periodicity specification. + in: path + name: period + schema: + type: string + type: string + - description: 'Beginning date specification. E.g. values: 2018, 2018-05, 2019-05-01' + in: path + name: begin_date + schema: + type: string + type: string + - description: 'Ending date specification. E.g. values: 2018, 2018-05, 2019-05-01' + in: path + name: end_date + schema: + type: string + type: string responses: '200': description: OK schema: items: properties: - name: - description: 'Example: twemoji' - type: string - net: - description: 'Example: 2479124' - type: integer - patches: - description: 'Example: 1' - type: integer - repos_id: + count: description: 'Example: 1' type: integer + date: + description: 'Example: 2018-10-25T00:00:00.000Z' + type: string + repo_name: + description: 'Example: weasel' + type: string + rg_name: + description: 'Example: Comcast' + type: string type: array tags: - - experimental - /repo-groups/:repo_group_id/annual-lines-of-code-count-ranked-by-new-repo-in-repo-group: + - risk + /repo-groups/:repo_group_id/fork-count: get: - description: 'This is an Augur-specific metric. We are currently working to - define these more formally. ' - operationId: Annual Lines of Code Ranked by New Repo in Repo Group(Repo) + description: 'Fork count. ' + externalDocs: + description: CHAOSS Metric Definition + url: https://github.com/chaoss/wg-risk/blob/master/focus-areas/business-risk.md + operationId: Fork Count (Repo Group) parameters: - - description: Base64 version of the URL of the GitHub repository as it appears - in the Facade DB + - description: Repository Group ID in: path - name: repo_url_base + name: repo_group_id schema: - type: String - type: String + type: string + type: string responses: '200': description: OK schema: items: properties: - net: - description: 'Example: 2479124' + forks: + description: 'Example: 4' type: integer - patches: - description: 'Example: 1' + repo_id: + description: 'Example: 21364' type: integer repo_name: - description: 'Example: twemoji' + description: 'Example: irs_process_scripts' type: string - repos_id: - description: 'Example: 1' - type: integer type: array tags: - - experimental - /repo-groups/:repo_group_id/annual-lines-of-code-count-ranked-by-repo-in-repo-group: + - risk + /repos/:repo_id/fork-count: get: - description: 'This is an Augur-specific metric. We are currently working to - define these more formally. ' - operationId: Annual Lines of Code Ranked by Repo in Repo Group(Repo) + description: 'Fork count. ' + externalDocs: + description: CHAOSS Metric Definition + url: https://github.com/chaoss/wg-risk/blob/master/focus-areas/business-risk.md + operationId: Fork Count (Repo) parameters: - - description: Base64 version of the URL of the GitHub repository as it appears - in the Facade DB + - description: Repository ID. in: path - name: repo_url_base + name: repo_id schema: - type: String - type: String + type: string + type: string responses: '200': description: OK schema: items: properties: - name: - description: 'Example: twemoji' - type: string - net: - description: 'Example: 2479124' - type: integer - patches: - description: 'Example: 1' - type: integer - repos_id: - description: 'Example: 1' + forks: + description: 'Example: 844' type: integer + repo_name: + description: 'Example: graphiql' + type: string type: array tags: - - experimental - /repo-groups/:repo_group_id/avgerage-issue-resolution-time: + - risk + /repo-groups/:repo_group_id/forks: get: - description: 'The average issue resolution time. ' + description: 'A time series of fork count. ' externalDocs: description: CHAOSS Metric Definition url: https://github.com/chaoss/wg-risk/blob/master/focus-areas/business-risk.md - operationId: Average Issue Resolution Time (Repo Group) + operationId: Forks (Repo Group) parameters: - description: Repository Group ID in: path @@ -393,29 +547,32 @@ paths: schema: items: properties: - avg_issue_resolution_time: - description: 'Example: 1413 days 15:39:48' + date: + description: 'Example: 2019-07-03T23:26:42.000Z' type: string + forks: + description: 'Example: 519' + type: integer repo_id: - description: 'Example: 21353' + description: 'Example: 21036' type: integer repo_name: - description: 'Example: open_id_authentication' + description: 'Example: jquery-ujs' type: string type: array tags: - risk - /repo-groups/:repo_group_id/cii-best-practices-badge: + /repos/:repo_id/forks: get: - description: 'The CII Best Practices Badge level. ' + description: 'A time series of fork count. ' externalDocs: description: CHAOSS Metric Definition - url: https://github.com/chaoss/wg-risk/blob/master/focus-areas/security.md - operationId: CII Best Practices Badge (Repo Group) + url: https://github.com/chaoss/wg-risk/blob/master/focus-areas/business-risk.md + operationId: Forks (Repo) parameters: - - description: Repository Group ID + - description: Repository ID. in: path - name: repo_group_id + name: repo_id schema: type: string type: string @@ -425,25 +582,25 @@ paths: schema: items: properties: - badge_level: - description: 'Example: in_progress' + date: + description: 'Example: 2019-07-03T23:27:42.000Z' type: string - repo_id: - description: 'Example: 21252' + forks: + description: 'Example: 843' type: integer repo_name: - description: 'Example: php-legal-licenses' + description: 'Example: graphiql' type: string type: array tags: - risk - /repo-groups/:repo_group_id/closed-issues-count: + /repo-groups/:repo_group_id/license-coverage: get: - description: 'Count of closed issues. ' + description: 'Number of persons opening an issue for the first time. ' externalDocs: description: CHAOSS Metric Definition - url: https://github.com/chaoss/wg-evolution/blob/master/metrics/contributors-new.md - operationId: Closed Issues Count (Repo) + url: https://github.com/chaoss/wg-risk/blob/master/metrics/License_Coverage.md + operationId: License Coverage (Repo Group) parameters: - description: Repository Group ID in: path @@ -451,59 +608,39 @@ paths: schema: type: string type: string - - description: Repository ID. - in: path - name: repo_id - schema: - type: string - type: string responses: '200': description: OK schema: items: properties: - closed_count: - description: 'Example: 26' + coverage: + description: 'Example: 0.373' + type: string + license_declared_files: + description: 'Example: 19' type: integer - date: - description: 'Example: 2018-11-26T00:00:00.000Z' + name: + description: 'Example: ActorServiceRegistry' type: string - repo_id: - description: 'Example: 21681' + total_files: + description: 'Example: 51' type: integer type: array tags: - - evolution - /repo-groups/:repo_group_id/code-changes: + - risk + /repos/:repo_id/license-coverage: get: - description: 'Time series of number of commits during a certain period. ' + description: 'Number of persons contributing with an accepted commit for the + first time. ' externalDocs: description: CHAOSS Metric Definition - url: https://github.com/chaoss/wg-evolution/blob/master/metrics/Code_Changes.md - operationId: Code Changes (Repo Group) + url: https://github.com/chaoss/wg-risk/blob/master/metrics/License_Coverage.md + operationId: License Coverage (Repo) parameters: - - description: Repository Group ID - in: path - name: repo_group_id - schema: - type: string - type: string - - description: Periodicity specification. - in: path - name: period - schema: - type: string - type: string - - description: 'Beginning date specification. E.g. values: 2018, 2018-05, 2019-05-01' - in: path - name: begin_date - schema: - type: string - type: string - - description: 'Ending date specification. E.g. values: 2018, 2018-05, 2019-05-01' + - description: Repository ID. in: path - name: end_date + name: repo_id schema: type: string type: string @@ -513,28 +650,28 @@ paths: schema: items: properties: - commit_count: - description: 'Example: 173' - type: integer - date: - description: 'Example: 2018-01-01T00:00:00.000Z' + coverage: + description: 'Example: 0.347' type: string - repo_id: - description: 'Example: 21337' + license_declared_file: + description: 'Example: 33' type: integer repo_name: - description: 'Example: graphql-wg' + description: 'Example: zucchini' type: string + total_files: + description: 'Example: 95' + type: integer type: array tags: - - evolution - /repo-groups/:repo_group_id/code-changes-lines: + - risk + /repo-groups/:repo_group_id/license-declared: get: - description: 'Time series of lines added and removed during a certain period. ' + description: 'Number of persons opening an issue for the first time. ' externalDocs: description: CHAOSS Metric Definition - url: https://github.com/chaoss/wg-evolution/blob/master/metrics/Code_Changes_Lines.md - operationId: Code Changes Lines (Repo Group) + url: https://github.com/chaoss/wg-risk/blob/master/metrics/License_Coverage.md + operationId: License Declared (Repo Group) parameters: - description: Repository Group ID in: path @@ -542,71 +679,36 @@ paths: schema: type: string type: string - - description: Periodicity specification. - in: path - name: period - schema: - type: string - type: string - - description: 'Beginning date specification. E.g. values: 2018, 2018-05, 2019-05-01' - in: path - name: begin_date - schema: - type: string - type: string - - description: 'Ending date specification. E.g. values: 2018, 2018-05, 2019-05-01' - in: path - name: end_date - schema: - type: string - type: string responses: '200': description: OK schema: items: properties: - added: - description: 'Example: 1135' - type: integer - date: - description: 'Example: 2018-01-01T00:00:00.000Z' + name: + description: 'Example: trickster' type: string - removed: - description: 'Example: 101' - type: integer - repo_id: - description: 'Example: 21337' - type: integer - repo_name: - description: 'Example: graphql-wg' + note: + description: 'Example: ' + type: string + short_name: + description: 'Example: Apache-2.0' type: string type: array tags: - - evolution - /repo-groups/:repo_group_id/contributors: + - risk + /repos/:repo_id/license-declared: get: - description: 'List of contributors and their contributions. ' + description: 'Number of persons contributing with an accepted commit for the + first time. ' externalDocs: description: CHAOSS Metric Definition - url: https://github.com/chaoss/wg-evolution/blob/master/metrics/contributors.md - operationId: Contributors (Repo Group) + url: https://github.com/chaoss/wg-risk/blob/master/metrics/License_Coverage.md + operationId: License Declared (Repo) parameters: - - description: Repository Group ID - in: path - name: repo_group_id - schema: - type: string - type: string - - description: 'Beginning date specification. E.g. values: 2018, 2018-05, 2019-05-01' - in: path - name: begin_date - schema: - type: string - type: string - - description: 'Ending date specification. E.g. values: 2018, 2018-05, 2019-05-01' + - description: Repository ID. in: path - name: end_date + name: repo_id schema: type: string type: string @@ -616,46 +718,25 @@ paths: schema: items: properties: - commit_comments: - description: 'Example: 0' - type: integer - commits: - description: 'Example: 0' - type: integer - issue_comments: - description: 'Example: 0' - type: integer - issues: - description: 'Example: 2' - type: integer - pull_request_comments: - description: 'Example: 0' - type: integer - pull_requests: - description: 'Example: 0' - type: integer - repo_id: - description: 'Example: 21000' - type: integer - repo_name: - description: 'Example: rails' + name: + description: 'Example: trickster' + type: string + note: + description: 'Example: ' + type: string + short_name: + description: 'Example: Apache-2.0' type: string - total: - description: 'Example: 2' - type: integer - user_id: - description: 'Example: 1' - type: integer type: array tags: - - evolution - /repo-groups/:repo_group_id/contributors-new: + - risk + /repo-groups/:repo_group_id/languages: get: - description: 'Time series of number of new contributors during a certain period. ' + description: 'The primary language of the repository. ' externalDocs: description: CHAOSS Metric Definition - url: https://github.com/chaoss/wg-evolution/blob/master/metrics/contributors-new.md - operationId: New Contributors (Repo Group) + url: https://github.com/chaoss/wg-risk/blob/master/focus-areas/security.md + operationId: Languages (Repo Group) parameters: - description: Repository Group ID in: path @@ -663,56 +744,32 @@ paths: schema: type: string type: string - - description: Periodicity specification. - in: path - name: period - schema: - type: string - type: string - - description: 'Beginning date specification. E.g. values: 2018, 2018-05, 2019-05-01' - in: path - name: begin_date - schema: - type: string - type: string - - description: 'Ending date specification. E.g. values: 2018, 2018-05, 2019-05-01' - in: path - name: end_date - schema: - type: string - type: string responses: '200': description: OK schema: items: properties: - date: - description: 'Example: 2018-05-20T00:00:00.000Z' + primary_language: + description: 'Example: Go' type: string - new_contributors: - description: 'Example: 3' - type: integer repo_id: - description: 'Example: 21000' + description: 'Example: 21277' type: integer - repo_name: - description: 'Example: rails' - type: string type: array tags: - - evolution - /repo-groups/:repo_group_id/fork-count: + - risk + /repo-groups/:repo_id/languages: get: - description: 'Fork count. ' + description: 'The primary language of the repository. ' externalDocs: description: CHAOSS Metric Definition - url: https://github.com/chaoss/wg-risk/blob/master/focus-areas/business-risk.md - operationId: Fork Count (Repo Group) + url: https://github.com/chaoss/wg-risk/blob/master/focus-areas/security.md + operationId: Languages (Repo) parameters: - - description: Repository Group ID + - description: Repository ID. in: path - name: repo_group_id + name: repo_id schema: type: string type: string @@ -722,25 +779,23 @@ paths: schema: items: properties: - forks: - description: 'Example: 4' - type: integer + primary_language: + description: 'Example: Go' + type: string repo_id: - description: 'Example: 21364' + description: 'Example: 21277' type: integer - repo_name: - description: 'Example: irs_process_scripts' - type: string type: array tags: - risk - /repo-groups/:repo_group_id/forks: + /repo-groups/:repo_group_id/license-count: get: - description: 'A time series of fork count. ' + description: 'The declared software package license (fetched from CII Best Practices + badging data). ' externalDocs: description: CHAOSS Metric Definition - url: https://github.com/chaoss/wg-risk/blob/master/focus-areas/business-risk.md - operationId: Forks (Repo Group) + url: https://github.com/chaoss/wg-risk/blob/master/focus-areas/licensing.md + operationId: License Count (Repo Group) parameters: - description: Repository Group ID in: path @@ -754,32 +809,30 @@ paths: schema: items: properties: - date: - description: 'Example: 2019-07-03T23:26:42.000Z' + file_without_licenses: + description: 'Example: True' type: string - forks: - description: 'Example: 519' - type: integer - repo_id: - description: 'Example: 21036' - type: integer - repo_name: - description: 'Example: jquery-ujs' + name: + description: 'Example: ActorServiceRegistry' type: string + number_of_license: + description: 'Example: 2' + type: integer type: array tags: - risk - /repo-groups/:repo_group_id/issue-backlog: + /repo-groups/:repo_id/license-count: get: - description: 'Number of issues currently open. ' + description: 'The declared software package license (fetched from CII Best Practices + badging data). ' externalDocs: description: CHAOSS Metric Definition - url: https://github.com/chaoss/wg-evolution/blob/master/focus_areas/code_development.md - operationId: Issue Backlog (Repo Group) + url: https://github.com/chaoss/wg-risk/blob/master/focus-areas/licensing.md + operationId: License Count (Repo) parameters: - - description: Repository Group ID + - description: Repository ID. in: path - name: repo_group_id + name: repo_id schema: type: string type: string @@ -789,22 +842,28 @@ paths: schema: items: properties: - issue_backlog: - description: 'Example: 21' - type: integer - repo_id: - description: 'Example: 21055' - type: integer - repo_name: - description: 'Example: cache_digests' + file_without_licenses: + description: 'Example: True' type: string + name: + description: 'Example: ActorServiceRegistry' + type: string + number_of_license: + description: 'Example: 2' + type: integer type: array tags: - - evolution - /repo-groups/:repo_group_id/issue-comments-mean: + - risk + + + + #experimental endpoints + /repo-groups/:repo_group_id/aggregate-summary: get: - description: Mean(Average) of issue comments per day. - operationId: Issue Comments Mean (Repo Group) + description: Returns the current count of watchers, stars, and forks and the + counts of all commits, committers, and pull requests merged between a given + beginning and end date (default between now and 365 days ago). + operationId: Aggregate Summary (Repo Group) parameters: - description: Repository Group ID. in: path @@ -812,10 +871,15 @@ paths: schema: type: string type: string - - description: 'Allows for results to be grouped by day, week, month, or year. - E.g. values: year, day, month' + - description: 'Beginning date specification. E.g. values: 2018, 2018-05, 2019-05-01' in: path - name: group_by + name: begin_date + schema: + type: string + type: string + - description: 'Ending date specification. E.g. values: 2018, 2018-05, 2019-05-01' + in: path + name: end_date schema: type: string type: string @@ -825,33 +889,49 @@ paths: schema: items: properties: - date: - description: 'Example: 2018-01-01T00:00:00.000Z' - type: string - mean: - description: 'Example: 0.6191780822' - type: string - repo_id: - description: 'Example: 21326' + commit_count: + description: 'Example: 7890143' + type: integer + committer_count: + description: 'Example: 8553' + type: integer + fork_count: + description: 'Example: 226841' + type: integer + merged_count: + description: 'Example: 3883' + type: integer + star_count: + description: 'Example: 460447' + type: integer + watcher_count: + description: 'Example: 69106' type: integer type: array tags: - experimental - /repo-groups/:repo_group_id/issue-comments-mean-std: + /repos/:repo_id/aggregate-summary: get: - description: Mean(Average) and Standard Deviation of issue comments per day. - operationId: Issue Comments Mean Std (Repo Group) + description: Returns the current count of watchers, stars, and forks and the + counts of all commits, committers, and pull requests merged between a given + beginning and end date (default between now and 365 days ago). + operationId: Aggregate Summary (Repo) parameters: - - description: Repository Group ID. + - description: Repository ID. in: path - name: repo_group_id + name: repo_id schema: type: string type: string - - description: 'Allows for results to be grouped by day, week, month, or year. - E.g. values: year, day, month' + - description: 'Beginning date specification. E.g. values: 2018, 2018-05, 2019-05-01' in: path - name: group_by + name: begin_date + schema: + type: string + type: string + - description: 'Ending date specification. E.g. values: 2018, 2018-05, 2019-05-01' + in: path + name: end_date schema: type: string type: string @@ -861,32 +941,51 @@ paths: schema: items: properties: - date: - description: 'Example: 2018-01-01T00:00:00.000Z' - type: string - mean: - description: 'Example: 0.6191780822' - type: string - repo_id: - description: 'Example: 21326' + commit_count: + description: 'Example: 133' + type: integer + committer_count: + description: 'Example: 5' + type: integer + fork_count: + description: 'Example: 449' + type: integer + merged_count: + description: 'Example: 0' + type: integer + star_count: + description: 'Example: 581' + type: integer + watcher_count: + description: 'Example: 83' type: integer type: array tags: - experimental - /repo-groups/:repo_group_id/issue-duration: + /repo-groups/:repo_group_id/annual-commit-count-ranked-by-new-repo-in-repo-group: get: - description: 'Time since an issue is proposed until it is closed. ' - externalDocs: - description: CHAOSS Metric Definition - url: https://github.com/chaoss/wg-evolution/blob/master/focus_areas/code_development.md - operationId: Issue Duration (Repo Group) + description: 'This is an Augur-specific metric. We are currently working to + define these more formally. ' + operationId: Annual Commit Count Ranked by New Repo in Repo Group (Repo Group) parameters: - - description: Repository Group ID + - description: Repository Group ID. in: path name: repo_group_id schema: type: string type: string + - description: Repository ID. + in: path + name: repo_id + schema: + type: string + type: string + - description: Periodicity specification. + in: path + name: period + schema: + type: string + type: string - description: 'Beginning date specification. E.g. values: 2018, 2018-05, 2019-05-01' in: path name: begin_date @@ -905,192 +1004,141 @@ paths: schema: items: properties: - closed_at: - description: 'Example: 2011-05-06T20:21:47.000Z' - type: string - created_at: - description: 'Example: 2011-05-06T20:20:05.000Z' - type: string - duration: - description: 'Example: 0 days 00:01:42.000000000' - type: string - issue_id: - description: 'Example: 50320' + commits: + description: 'Example: 289' + type: integer + net: + description: 'Example: 21996' type: integer repo_id: - description: 'Example: 21017' + description: 'Example: 21000' type: integer repo_name: - description: 'Example: ssl_requirement' + description: 'Example: rails' type: string + year: + description: 'Example: 2004' + type: integer type: array tags: - - evolution - /repo-groups/:repo_group_id/issue-participants: + - experimental + /repo-groups/:repo_group_id/annual-commit-count-ranked-by-repo-in-repo-group: get: - description: 'How many persons participated in the discussion of issues. ' - externalDocs: - description: CHAOSS Metric Definition - url: https://github.com/chaoss/wg-evolution/blob/master/focus_areas/code_development.md - operationId: Issue Participants (Repo Group) + description: 'This is an Augur-specific metric. We are currently working to + define these more formally. ' + operationId: Annual Commit Count Ranked by Repo in Repo Group (Repo Group) parameters: - - description: Repository Group ID. - in: path - name: repo_group_id - schema: - type: string - type: string - - description: 'Beginning date specification. E.g. values: 2018, 2018-05, 2019-05-01' - in: path - name: begin_date - schema: - type: string - type: string - - description: 'Ending date specification. E.g. values: 2018, 2018-05, 2019-05-01' + - description: Base64 version of the URL of the GitHub repository as it appears + in the Facade DB in: path - name: end_date + name: repo_url_base schema: - type: string - type: string + type: String + type: String responses: '200': description: OK schema: items: properties: - created_at: - description: 'Example: 2019-06-20T22:56:38.000Z' + name: + description: 'Example: twemoji' type: string - issue_id: - description: 'Example: 50328' + net: + description: 'Example: 2479124' type: integer - participants: + patches: description: 'Example: 1' type: integer - repo_id: - description: 'Example: 21027' + repos_id: + description: 'Example: 1' type: integer - repo_name: - description: 'Example: rails-contributors' - type: string type: array tags: - - evolution - /repo-groups/:repo_group_id/issue-throughput: + - experimental + /repo-groups/:repo_group_id/annual-lines-of-code-count-ranked-by-new-repo-in-repo-group: get: - description: 'Ratio of issues closed to total issues. ' - externalDocs: - description: CHAOSS Metric Definition - url: https://github.com/chaoss/wg-evolution/blob/master/focus_areas/code_development.md - operationId: Issue Throughput (Repo Group) + description: 'This is an Augur-specific metric. We are currently working to + define these more formally. ' + operationId: Annual Lines of Code Ranked by New Repo in Repo Group (Repo Group) parameters: - - description: Repository Group ID + - description: Base64 version of the URL of the GitHub repository as it appears + in the Facade DB in: path - name: repo_group_id + name: repo_url_base schema: - type: string - type: string + type: String + type: String responses: '200': description: OK schema: items: properties: - repo_id: - description: 'Example: 21681' + net: + description: 'Example: 2479124' + type: integer + patches: + description: 'Example: 1' type: integer repo_name: - description: 'Example: incubator-zipkin' - type: string - throughput: - description: 'Example: 0.819125' + description: 'Example: twemoji' type: string + repos_id: + description: 'Example: 1' + type: integer type: array tags: - - evolution - /repo-groups/:repo_group_id/issues-active: + - experimental + /repo-groups/:repo_group_id/annual-lines-of-code-count-ranked-by-repo-in-repo-group: get: - description: 'Time series of number of issues that showed some activity during - a certain period. ' - externalDocs: - description: CHAOSS Metric Definition - url: https://github.com/chaoss/wg-evolution/blob/master/metrics/Issues_Active.md - operationId: Issues Active (Repo Group) + description: 'This is an Augur-specific metric. We are currently working to + define these more formally. ' + operationId: Annual Lines of Code Ranked by Repo in Repo Group (Repo Group) parameters: - - description: Repository Group ID - in: path - name: repo_group_id - schema: - type: string - type: string - - description: Periodicity specification. - in: path - name: period - schema: - type: string - type: string - - description: 'Beginning date specification. E.g. values: 2018, 2018-05, 2019-05-01' - in: path - name: begin_date - schema: - type: string - type: string - - description: 'Ending date specification. E.g. values: 2018, 2018-05, 2019-05-01' + - description: Base64 version of the URL of the GitHub repository as it appears + in the Facade DB in: path - name: end_date + name: repo_url_base schema: - type: string - type: string + type: String + type: String responses: '200': description: OK schema: items: properties: - date: - description: 'Example: 2019-01-01T00:00:00.000Z' + name: + description: 'Example: twemoji' type: string - issues: - description: 'Example: 18' + net: + description: 'Example: 2479124' type: integer - repo_id: - description: 'Example: 21039' + patches: + description: 'Example: 1' + type: integer + repos_id: + description: 'Example: 1' type: integer - repo_name: - description: 'Example: rails_xss' - type: string type: array tags: - - evolution - /repo-groups/:repo_group_id/issues-closed: + - experimental + /repo-groups/:repo_group_id/issue-comments-mean: get: - description: 'Time series of number of issues closed during a certain period. ' - externalDocs: - description: CHAOSS Metric Definition - url: https://github.com/chaoss/wg-evolution/blob/master/metrics/Issues_Closed.md - operationId: Issues Closed (Repo Group) + description: Mean(Average) of issue comments per day. + operationId: Issue Comments Mean (Repo Group) parameters: - - description: Repository Group ID + - description: Repository Group ID. in: path name: repo_group_id schema: type: string type: string - - description: Periodicity specification. - in: path - name: period - schema: - type: string - type: string - - description: 'Beginning date specification. E.g. values: 2018, 2018-05, 2019-05-01' - in: path - name: begin_date - schema: - type: string - type: string - - description: 'Ending date specification. E.g. values: 2018, 2018-05, 2019-05-01' + - description: 'Allows for results to be grouped by day, week, month, or year. + E.g. values: year, day, month' in: path - name: end_date + name: group_by schema: type: string type: string @@ -1101,31 +1149,25 @@ paths: items: properties: date: - description: 'Example: 2019-01-01T00:00:00.000Z' + description: 'Example: 2018-01-01T00:00:00.000Z' + type: string + mean: + description: 'Example: 0.6191780822' type: string - issues: - description: 'Example: 425' - type: integer repo_id: - description: 'Example: 21681' + description: 'Example: 21326' type: integer - repo_name: - description: 'Example: incubator-zipkin' - type: string type: array tags: - - evolution - /repo-groups/:repo_group_id/issues-closed-resolution-duration: + - experimental + /repos/:repo_id/issue-comments-mean: get: - description: 'Duration of time for issues to be resolved. ' - externalDocs: - description: CHAOSS Metric Definition - url: https://github.com/chaoss/wg-evolution/blob/master/metrics/issues-closed-resolution-duration.md - operationId: Closed Issue Resolution Duration (Repo Group) + description: Mean(Average) of issue comments per day. + operationId: Issue Comments Mean (Repo) parameters: - - description: Repository Group ID + - description: Repository ID. in: path - name: repo_group_id + name: repo_id schema: type: string type: string @@ -1135,56 +1177,62 @@ paths: schema: items: properties: - closed_at: - description: 'Example: 2019-05-22T05:27:29.000Z' - type: string - created_at: - description: 'Example: 2019-05-22T03:18:13.000Z' + date: + description: 'Example: 2018-01-01T00:00:00.000Z' type: string - diffdate: - description: 'Example: 0.0' + mean: + description: 'Example: 0.6191780822' type: string - gh_issue_number: - description: 'Example: 4110' + repo_id: + description: 'Example: 21326' type: integer - issue_title: - description: 'Example: rm incubating word' - type: string - repo_name: - description: 'Example: incubator-dubbo' - type: string type: array tags: - - evolution - /repo-groups/:repo_group_id/issues-first-time-closed: + - experimental + /repo-groups/:repo_group_id/issue-comments-mean-std: get: - description: 'Number of persons closing an issue for the first time. ' - externalDocs: - description: CHAOSS Metric Definition - url: https://github.com/chaoss/wg-evolution/blob/master/metrics/issues-first-time-closed.md - operationId: Closed Issues New Contributor (Repo Group) + description: Mean(Average) and Standard Deviation of issue comments per day. + operationId: Issue Comments Mean Std (Repo Group) parameters: - - description: Repository Group ID + - description: Repository Group ID. in: path name: repo_group_id schema: type: string type: string - - description: Periodicity specification. - in: path - name: period - schema: - type: string - type: string - - description: 'Beginning date specification. E.g. values: 2018, 2018-05, 2019-05-01' + - description: 'Allows for results to be grouped by day, week, month, or year. + E.g. values: year, day, month' in: path - name: begin_date + name: group_by schema: type: string type: string - - description: 'Ending date specification. E.g. values: 2018, 2018-05, 2019-05-01' + responses: + '200': + description: OK + schema: + items: + properties: + date: + description: 'Example: 2018-01-01T00:00:00.000Z' + type: string + mean: + description: 'Example: 0.6191780822' + type: string + repo_id: + description: 'Example: 21326' + type: integer + type: array + tags: + - experimental + /repos/:repo_id/issue-comments-mean-std: + get: + description: Mean(Average) and Standard Deviation of issue comments per day. + operationId: Issue Comments Mean Std (Repo) + parameters: + - description: Repository ID. in: path - name: end_date + name: repo_id schema: type: string type: string @@ -1194,41 +1242,34 @@ paths: schema: items: properties: - count: - description: 'Example: 3' - type: integer - issue_date: - description: 'Example: 2018-05-20T00:00:00.000Z' + average: + description: 'Example: 2.5' + type: string + date: + description: 'Example: 2011-01-01T00:00:00.000Z' type: string repo_id: description: 'Example: 21000' type: integer - repo_name: - description: 'Example: rails' + standard_deviation: + description: 'Example: 1.7159383568' type: string type: array tags: - - evolution - /repo-groups/:repo_group_id/issues-first-time-opened: + - experimental + /repo-groups/:repo_group_id/pull-request-acceptance-rate: get: - description: 'Number of persons opening an issue for the first time. ' - externalDocs: - description: CHAOSS Metric Definition - url: https://github.com/chaoss/wg-evolution/blob/master/metrics/issues-first-time-opened.md - operationId: New Contributors of Issues (Repo Group) + description: Timeseries of pull request acceptance rate (expressed as the ratio + of pull requests merged on a date to the count of pull requests opened on + a date) + operationId: Pull Request Acceptance Rate (Repo Group) parameters: - - description: Repository Group ID + - description: Repository Group ID. in: path name: repo_group_id schema: type: string type: string - - description: Periodicity specification. - in: path - name: period - schema: - type: string - type: string - description: 'Beginning date specification. E.g. values: 2018, 2018-05, 2019-05-01' in: path name: begin_date @@ -1241,38 +1282,38 @@ paths: schema: type: string type: string + - description: 'Allows for results to be grouped by day, week, month, or year. + E.g. values: year, day, month' + in: path + name: group_by + schema: + type: string + type: string responses: '200': description: OK schema: items: properties: - count: - description: 'Example: 3' - type: integer - issue_date: - description: 'Example: 2018-05-20T00:00:00.000Z' + date: + description: 'Example: 2019-02-11T00:00:00.000Z' type: string - repo_id: - description: 'Example: 21000' - type: integer - repo_name: - description: 'Example: rails' + rate: + description: 'Example: 120.5' type: string type: array tags: - - evolution - /repo-groups/:repo_group_id/issues-maintainer-response-duration: + - experimental + /repos/:repo_id/pull-request-acceptance-rate: get: - description: 'Duration of time for issues to be resolved. ' - externalDocs: - description: CHAOSS Metric Definition - url: https://github.com/chaoss/wg-evolution/blob/master/metrics/issues-maintainer-response-duration.md - operationId: Issue Response Time (Repo Group) + description: Timeseries of pull request acceptance rate (expressed as the ratio + of pull requests merged on a date to the count of pull requests opened on + a date) + operationId: Pull Request Acceptance Rate (Repo) parameters: - - description: Repository Group ID + - description: Repository ID. in: path - name: repo_group_id + name: repo_id schema: type: string type: string @@ -1294,38 +1335,26 @@ paths: schema: items: properties: - average_days_comment: - description: 'Example: 27.1111111111' + date: + description: 'Example: 2019-01-01T00:00:00.000Z' type: string - repo_id: - description: 'Example: 21987' - type: integer - repo_name: - description: 'Example: qpid-proton' + rate: + description: 'Example: 5.3333333333' type: string type: array tags: - - evolution - /repo-groups/:repo_group_id/issues-new: + - experimental + /repo-groups/:repo_group_id/pull-requests-closed-no-merge: get: - description: 'Time series of number of new issues opened during a certain period. ' - externalDocs: - description: CHAOSS Metric Definition - url: https://github.com/chaoss/wg-evolution/blob/master/metrics/Issues_New.md - operationId: Issues New (Repo Group) + description: Timeseries of pull request which were closed but not merged + operationId: Pull Request Closed but Not Merged (Repo Group) parameters: - - description: Repository Group ID + - description: Repository Group ID. in: path name: repo_group_id schema: type: string type: string - - description: Periodicity specification. - in: path - name: period - schema: - type: string - type: string - description: 'Beginning date specification. E.g. values: 2018, 2018-05, 2019-05-01' in: path name: begin_date @@ -1347,29 +1376,33 @@ paths: date: description: 'Example: 2019-01-01T00:00:00.000Z' type: string - issues: - description: 'Example: 318' - type: integer - repo_id: - description: 'Example: 21000' + pr_count: + description: 'Example: 3' type: integer - repo_name: - description: 'Example: rails' - type: string type: array tags: - - evolution - /repo-groups/:repo_group_id/issues-open-age: + - experimental + /repos/:repo_id/pull-requests-closed-no-merge: get: - description: 'Age of open issues. ' - externalDocs: - description: CHAOSS Metric Definition - url: https://github.com/chaoss/wg-evolution/blob/master/metrics/issues-open-age.md - operationId: Open Issue Age (Repo Group) + description: '' + operationId: Pull Request Closed but Not Merged (Repo) parameters: - - description: Repository Group ID + - description: Repository ID. in: path - name: repo_group_id + name: repo_id + schema: + type: string + type: string + - description: 'Beginning date specification. E.g. values: 2018, 2018-05, 2019-05-01' + in: path + name: begin_date + schema: + type: string + type: string + - description: 'Ending date specification. E.g. values: 2018, 2018-05, 2019-05-01 + ___' + in: path + name: end_date schema: type: string type: string @@ -1379,31 +1412,19 @@ paths: schema: items: properties: - date: - description: 'Example: 2009-05-15T19:48:43.000Z' - type: string - issue_id: - description: 'Example: 38318' - type: integer - open_date: - description: 'Example: 3696' - type: integer - repo_id: - description: 'Example: 21000' - type: integer - repo_name: - description: 'Example: rails' + date: + description: 'Example: 2019-01-01T00:00:00.000Z' type: string + pr_count: + description: 'Example: 3' + type: integer type: array tags: - - evolution - /repo-groups/:repo_group_id/languages: + - experimental + /repo-groups/:repo_group_id/top-committers: get: - description: 'The primary language of the repository. ' - externalDocs: - description: CHAOSS Metric Definition - url: https://github.com/chaoss/wg-risk/blob/master/focus-areas/security.md - operationId: Languages (Repo Group) + description: Returns a list of contributors contributing N% of all commits. + operationId: Top Committers (Repo Group) parameters: - description: Repository Group ID in: path @@ -1411,33 +1432,63 @@ paths: schema: type: string type: string + - description: 'Specify the year to return the results for. Default value: current + year' + in: path + name: year + schema: + type: string + type: string + - description: Specify N%. Accepts a value between 0 & 1 where 0 specifies + 0% and 1 specifies 100%. + in: path + name: threshold + schema: + type: string + type: string responses: '200': description: OK schema: items: properties: - primary_language: - description: 'Example: Go' + commits: + description: 'Example: 502' + type: integer + email: + description: 'Example: kamipo@gmail.com' type: string - repo_id: - description: 'Example: 21277' + repo_group_id: + description: 'Example: 20' type: integer + repo_group_name: + description: 'Example: Rails' + type: string type: array tags: - - risk - /repo-groups/:repo_group_id/license-count: + - experimental + /repos/:repo_id/top-committers: get: - description: 'The declared software package license (fetched from CII Best Practices - badging data). ' - externalDocs: - description: CHAOSS Metric Definition - url: https://github.com/chaoss/wg-risk/blob/master/focus-areas/licensing.md - operationId: License Count (Repo Group) + description: Returns a list of contributors contributing N% of all commits. + operationId: Top Committers (Repo) parameters: - - description: Repository Group ID + - description: Repository ID. in: path - name: repo_group_id + name: repo_id + schema: + type: string + type: string + - description: 'Specify the year to return the results for. Default value: current + year' + in: path + name: year + schema: + type: string + type: string + - description: Specify N%. Accepts a value between 0 & 1 where 0 specifies + 0% and 1 specifies 100%. + in: path + name: threshold schema: type: string type: string @@ -1447,25 +1498,25 @@ paths: schema: items: properties: - file_without_licenses: - description: 'Example: True' - type: string - name: - description: 'Example: ActorServiceRegistry' + commits: + description: 'Example: 4' + type: integer + email: + description: 'Example: caniszczyk@gmail.com' type: string - number_of_license: - description: 'Example: 2' + repo_id: + description: 'Example: 21334' type: integer + repo_name: + description: 'Example: graphql' + type: string type: array tags: - - risk - /repo-groups/:repo_group_id/license-coverage: + - experimental + /repo-groups/:repo_group_id/abandoned-issues: get: - description: 'Number of persons opening an issue for the first time. ' - externalDocs: - description: CHAOSS Metric Definition - url: https://github.com/chaoss/wg-risk/blob/master/metrics/License_Coverage.md - operationId: License Coverage(Repo Group) + description: List of abandoned issues (last updated >= 1 year ago) + operationId: Abandoned Issues (Repo Group) parameters: - description: Repository Group ID in: path @@ -1479,32 +1530,26 @@ paths: schema: items: properties: - coverage: - description: 'Example: 0.373' - type: string - license_declared_files: - description: 'Example: 19' + issue_id: + description: 'Example: 125071' type: integer - name: - description: 'Example: ActorServiceRegistry' - type: string - total_files: - description: 'Example: 51' + repo_id: + description: 'Example: 22004' type: integer + updated_at: + description: 'Example: 2017-10-30T06:52:19.000Z' + type: string type: array tags: - - risk - /repo-groups/:repo_group_id/license-declared: + - experimental + /repo-groups/:repo_id/abandoned-issues: get: - description: 'Number of persons opening an issue for the first time. ' - externalDocs: - description: CHAOSS Metric Definition - url: https://github.com/chaoss/wg-risk/blob/master/metrics/License_Coverage.md - operationId: License Declared(Repo Group) + description: List of abandoned issues (last updated >= 1 year ago) + operationId: Abandoned Issues (Repo) parameters: - - description: Repository Group ID + - description: Repository ID. in: path - name: repo_group_id + name: repo_id schema: type: string type: string @@ -1514,25 +1559,25 @@ paths: schema: items: properties: - name: - description: 'Example: trickster' - type: string - note: - description: 'Example: ' - type: string - short_name: - description: 'Example: Apache-2.0' + issue_id: + description: 'Example: 125071' + type: integer + repo_id: + description: 'Example: 22004' + type: integer + updated_at: + description: 'Example: 2017-10-30T06:52:19.000Z' type: string type: array tags: - - risk + - experimental /repo-groups/:repo_group_id/lines-changed-by-author: get: description: 'Count of closed issues. ' externalDocs: description: CHAOSS Metric Definition url: https://github.com/chaoss/wg-evolution/blob/master/metrics/contributors-new.md - operationId: Lines Changed by Author(Repo) + operationId: Lines Changed by Author (Repo Group) parameters: - description: Repository Group ID in: path @@ -1540,12 +1585,6 @@ paths: schema: type: string type: string - - description: Repository ID. - in: path - name: repo_id - schema: - type: string - type: string responses: '200': description: OK @@ -1573,17 +1612,17 @@ paths: type: array tags: - experimental - /repo-groups/:repo_group_id/open-issues-count: + /repo-groups/:repo_id/lines-changed-by-author: get: - description: 'Count of open issues. ' + description: 'Count of closed issues. ' externalDocs: description: CHAOSS Metric Definition - url: https://github.com/chaoss/wg-evolution/blob/master/metrics/Issues_New.md - operationId: Open Issues Count (Repo Group) + url: https://github.com/chaoss/wg-evolution/blob/master/metrics/contributors-new.md + operationId: Lines Changed by Author (Repo) parameters: - - description: Repository Group ID + - description: Repository ID. in: path - name: repo_group_id + name: repo_id schema: type: string type: string @@ -1593,111 +1632,38 @@ paths: schema: items: properties: - date: - description: 'Example: 2017-09-11T00:00:00.000Z' - type: string - open_count: - description: 'Example: 1' + additions: + description: 'Example: 25611' type: integer - rg_name: - description: 'Example: Netflix' - type: string - type: array - tags: - - evolution - /repo-groups/:repo_group_id/pull-request-acceptance-rate: - get: - description: Timeseries of pull request acceptance rate (expressed as the ratio - of pull requests merged on a date to the count of pull requests opened on - a date) - operationId: Pull Request Acceptance Rate (Repo Group) - parameters: - - description: Repository Group ID. - in: path - name: repo_group_id - schema: - type: string - type: string - - description: 'Beginning date specification. E.g. values: 2018, 2018-05, 2019-05-01' - in: path - name: begin_date - schema: - type: string - type: string - - description: 'Ending date specification. E.g. values: 2018, 2018-05, 2019-05-01' - in: path - name: end_date - schema: - type: string - type: string - - description: 'Allows for results to be grouped by day, week, month, or year. - E.g. values: year, day, month' - in: path - name: group_by - schema: - type: string - type: string - responses: - '200': - description: OK - schema: - items: - properties: - date: - description: 'Example: 2019-02-11T00:00:00.000Z' + affiliation: + description: 'Example: NULL' type: string - rate: - description: 'Example: 120.5' + cmt_author_date: + description: 'Example: 2004-11-24' type: string - type: array - tags: - - experimental - /repo-groups/:repo_group_id/pull-request-closed-no-merge: - get: - description: Timeseries of pull request which were closed but not merged - operationId: Pull Request Closed but not merged(Repo) - parameters: - - description: Repository Group ID. - in: path - name: repo_group_id - schema: - type: string - type: string - - description: 'Beginning date specification. E.g. values: 2018, 2018-05, 2019-05-01' - in: path - name: begin_date - schema: - type: string - type: string - - description: 'Ending date specification. E.g. values: 2018, 2018-05, 2019-05-01' - in: path - name: end_date - schema: - type: string - type: string - responses: - '200': - description: OK - schema: - items: - properties: - date: - description: 'Example: 2019-01-01T00:00:00.000Z' + cmt_author_email: + description: 'Example: david@loudthinking.com' type: string - pr_count: - description: 'Example: 3' + deletions: + description: 'Example: 296' + type: integer + whitespace: + description: 'Example: 5279' type: integer type: array tags: - experimental - /repo-groups/:repo_group_id/pull-requests-merge-contributor-new: + + + + #evolution endpoints + /repo-groups/:repo_group_id/code-changes: get: - description: 'Number of persons contributing with an accepted commit for the - first time. ' + description: 'Time series of number of commits during a certain period. ' externalDocs: description: CHAOSS Metric Definition - url: https://github.com/chaoss/wg-evolution/blob/master/metrics/pull-requests-merge-contributor-new.md - operationId: New Contributors of Commits (Repo Group) + url: https://github.com/chaoss/wg-evolution/blob/master/metrics/Code_Changes.md + operationId: Code Changes (Repo Group) parameters: - description: Repository Group ID in: path @@ -1730,65 +1696,37 @@ paths: items: properties: commit_count: - description: 'Example: 711' + description: 'Example: 173' type: integer - commit_date: + date: description: 'Example: 2018-01-01T00:00:00.000Z' type: string - count: - description: 'Example: 5140' - type: integer - repo_name: - description: 'Example: rails' - type: string - type: array - tags: - - evolution - /repo-groups/:repo_group_id/repos: - get: - description: Get all the repos in a repo group. - operationId: Repos in Repo Group - responses: - '200': - description: OK - schema: - items: - properties: - commits_all_time: - description: 'Example: 6874' - type: integer - description: - description: 'Example: None' - type: string - issues_all_time: - description: 'Example: 81' - type: integer repo_id: - description: 'Example: 21326' + description: 'Example: 21337' type: integer repo_name: - description: 'Example: graphql-js' - type: string - repo_status: - description: 'Example: Complete' - type: string - url: - description: 'Example: https://github.com/graphql/graphql-js.git' + description: 'Example: graphql-wg' type: string type: array tags: - - utility - /repo-groups/:repo_group_id/review-duration: + - evolution + /repos/:repo_id/code-changes: get: - description: 'Time since an review/pull request is proposed until it is accepted. ' + description: 'Time series number of commits during a certain period. ' externalDocs: description: CHAOSS Metric Definition - url: https://github.com/chaoss/wg-evolution/blob/master/metrics/Reviews_Duration.md - operationId: Review Duration (Repo Group) + url: https://github.com/chaoss/wg-evolution/blob/master/metrics/Code_Changes.md + operationId: Code Changes (Repo) parameters: - - description: Repository Group ID + - description: Repository ID. in: path - name: repo_group_id + name: repo_id + schema: + type: string + type: string + - description: Periodicity specification. + in: path + name: period schema: type: string type: string @@ -1810,35 +1748,25 @@ paths: schema: items: properties: - created_at: - description: 'Example: 2010-09-28T19:07:15.000Z' - type: string - duration: - description: 'Example: 0 days 22:39:44.000000000' - type: string - merged_at: - description: 'Example: 2010-09-29T17:46:59.000Z' - type: string - pull_request_id: - description: 'Example: 25386' - type: integer - repo_id: - description: 'Example: 21035' + commit_count: + description: 'Example: 90' type: integer + date: + description: 'Example: 2015-01-01T00:00:00.000Z' + type: string repo_name: - description: 'Example: prototype-ujs' + description: 'Example: graphql' type: string type: array tags: - evolution - /repo-groups/:repo_group_id/reviews: + /repo-groups/:repo_group_id/code-changes-lines: get: - description: 'Time series of number of new reviews / pull requests opened within - a certain period. ' + description: 'Time series of lines added and removed during a certain period. ' externalDocs: description: CHAOSS Metric Definition - url: https://github.com/chaoss/wg-evolution/blob/master/metrics/reviews.md - operationId: Reviews (Repo Group) + url: https://github.com/chaoss/wg-evolution/blob/master/metrics/Code_Changes_Lines.md + operationId: Code Changes Lines (Repo Group) parameters: - description: Repository Group ID in: path @@ -1870,33 +1798,35 @@ paths: schema: items: properties: + added: + description: 'Example: 1135' + type: integer date: - description: 'Example: 2010-01-01T00:00:00.000Z' + description: 'Example: 2018-01-01T00:00:00.000Z' type: string - pull_requests: - description: 'Example: 1' + removed: + description: 'Example: 101' type: integer repo_id: - description: 'Example: 21035' + description: 'Example: 21337' type: integer repo_name: - description: 'Example: prototype-ujs' + description: 'Example: graphql-wg' type: string type: array tags: - evolution - /repo-groups/:repo_group_id/reviews-accepted: + /repos/:repo_id/code-changes-lines: get: - description: 'Time series of number of accepted reviews / pull requests opened - within a certain period. ' + description: 'Time series of lines added and removed during a certain period. ' externalDocs: description: CHAOSS Metric Definition - url: https://github.com/chaoss/wg-evolution/blob/master/metrics/Reviews_Accepted.md - operationId: Reviews Accepted (Repo Group) + url: https://github.com/chaoss/wg-evolution/blob/master/metrics/Code_Changes_Lines.md + operationId: Code Changes Lines (Repo) parameters: - - description: Repository Group ID + - description: Repository ID. in: path - name: repo_group_id + name: repo_id schema: type: string type: string @@ -1924,29 +1854,28 @@ paths: schema: items: properties: + added: + description: 'Example: 17613' + type: integer date: - description: 'Example: 2010-01-01T00:00:00.000Z' + description: 'Example: 2015-06-01T00:00:00.000Z' type: string - pull_requests: - description: 'Example: 1' - type: integer - repo_id: - description: 'Example: 21035' + removed: + description: 'Example: 106' type: integer repo_name: - description: 'Example: prototype-ujs' + description: 'Example: graphql-js' type: string type: array tags: - evolution - /repo-groups/:repo_group_id/reviews-declined: + /repo-groups/:repo_group_id/contributors: get: - description: 'Time series of number of declined reviews / pull requests opened - within a certain period. ' + description: 'List of contributors and their contributions. ' externalDocs: description: CHAOSS Metric Definition - url: https://github.com/chaoss/wg-evolution/blob/master/metrics/Reviews_Accepted.md - operationId: Reviews Declined (Repo Group) + url: https://github.com/chaoss/wg-evolution/blob/master/metrics/contributors.md + operationId: Contributors (Repo Group) parameters: - description: Repository Group ID in: path @@ -1954,12 +1883,6 @@ paths: schema: type: string type: string - - description: Periodicity specification. - in: path - name: period - schema: - type: string - type: string - description: 'Beginning date specification. E.g. values: 2018, 2018-05, 2019-05-01' in: path name: begin_date @@ -1978,93 +1901,50 @@ paths: schema: items: properties: - date: - description: 'Example: 2010-01-01T00:00:00.000Z' - type: string - pull_requests: - description: 'Example: 1' + commit_comments: + description: 'Example: 0' type: integer - repo_id: - description: 'Example: 21035' + commits: + description: 'Example: 0' type: integer - repo_name: - description: 'Example: prototype-ujs' - type: string - type: array - tags: - - evolution - /repo-groups/:repo_group_id/stars: - get: - description: A time series of stars count. - operationId: Stars (Repo Group) - parameters: - - description: Repository Group ID - in: path - name: repo_group_id - schema: - type: string - type: string - responses: - '200': - description: OK - schema: - items: - properties: - date: - description: 'Example: 2019-07-03T23:23:36.000Z' - type: string - repo_id: - description: 'Example: 21491' + issue_comments: + description: 'Example: 0' type: integer - repo_name: - description: 'Example: commons-io' - type: string - stars: - description: 'Example: 600' + issues: + description: 'Example: 2' + type: integer + pull_request_comments: + description: 'Example: 0' + type: integer + pull_requests: + description: 'Example: 0' type: integer - type: array - tags: - - value - /repo-groups/:repo_group_id/stars-count: - get: - description: Stars count. - operationId: Stars Count (Repo Group) - parameters: - - description: Repository Group ID - in: path - name: repo_group_id - schema: - type: string - type: string - responses: - '200': - description: OK - schema: - items: - properties: repo_id: - description: 'Example: 21364' + description: 'Example: 21000' type: integer repo_name: - description: 'Example: irs_process_scripts' + description: 'Example: rails' type: string - stars: - description: 'Example: 20' + total: + description: 'Example: 2' + type: integer + user_id: + description: 'Example: 1' type: integer type: array tags: - - value - /repo-groups/:repo_group_id/sub-projects: + - evolution + /repos/:repo_id/contributors: get: - description: 'Number of sub-projects. ' + description: 'List of contributors and their contributions. ' externalDocs: description: CHAOSS Metric Definition - url: https://github.com/chaoss/wg-evolution/blob/master/metrics/sub-projects.md - operationId: Sub-Projects (Repo Group) + url: https://github.com/chaoss/wg-evolution/blob/master/metrics/contributors.md + operationId: Contributors (Repo) parameters: - - description: Repository Group ID + - description: Repository ID. in: path - name: repo_group_id + name: repo_id schema: type: string type: string @@ -2086,16 +1966,40 @@ paths: schema: items: properties: - sub_protject_count: + commit_comments: + description: 'Example: 0' + type: integer + commits: + description: 'Example: 0' + type: integer + issue_comments: + description: 'Example: 0' + type: integer + issues: description: 'Example: 2' type: integer + pull_request_comments: + description: 'Example: 0' + type: integer + pull_requests: + description: 'Example: 0' + type: integer + total: + description: 'Example: 2' + type: integer + user: + description: 'Example: 1' + type: integer type: array tags: - evolution - /repo-groups/:repo_group_id/top-committers: + /repo-groups/:repo_group_id/contributors-new: get: - description: Returns a list of contributors contributing N% of all commits. - operationId: Top Committers (Repo Group) + description: 'Time series of number of new contributors during a certain period. ' + externalDocs: + description: CHAOSS Metric Definition + url: https://github.com/chaoss/wg-evolution/blob/master/metrics/contributors-new.md + operationId: New Contributors (Repo Group) parameters: - description: Repository Group ID in: path @@ -2103,17 +2007,21 @@ paths: schema: type: string type: string - - description: 'Specify the year to return the results for. Default value: current - year' + - description: Periodicity specification. in: path - name: year + name: period schema: type: string type: string - - description: Specify N%. Accepts a value between 0 & 1 where 0 specifies - 0% and 1 specifies 100%. + - description: 'Beginning date specification. E.g. values: 2018, 2018-05, 2019-05-01' in: path - name: threshold + name: begin_date + schema: + type: string + type: string + - description: 'Ending date specification. E.g. values: 2018, 2018-05, 2019-05-01' + in: path + name: end_date schema: type: string type: string @@ -2123,29 +2031,50 @@ paths: schema: items: properties: - commits: - description: 'Example: 502' - type: integer - email: - description: 'Example: kamipo@gmail.com' + date: + description: 'Example: 2018-05-20T00:00:00.000Z' type: string - repo_group_id: - description: 'Example: 20' + new_contributors: + description: 'Example: 3' type: integer - repo_group_name: - description: 'Example: Rails' + repo_id: + description: 'Example: 21000' + type: integer + repo_name: + description: 'Example: rails' type: string type: array tags: - - experimental - /repo-groups/:repo_group_id/watchers: + - evolution + /repos/:repo_id/contributors-new: get: - description: A time series of watchers count. - operationId: Watchers (Repo Group) + description: 'Time series of number of new contributors during a certain period. ' + externalDocs: + description: CHAOSS Metric Definition + url: https://github.com/chaoss/wg-evolution/blob/master/metrics/contributors-new.md + operationId: New Contributors (Repo) parameters: - - description: Repository Group ID + - description: Repository ID. in: path - name: repo_group_id + name: repo_id + schema: + type: string + type: string + - description: Periodicity specification. + in: path + name: period + schema: + type: string + type: string + - description: 'Beginning date specification. E.g. values: 2018, 2018-05, 2019-05-01' + in: path + name: begin_date + schema: + type: string + type: string + - description: 'Ending date specification. E.g. values: 2018, 2018-05, 2019-05-01' + in: path + name: end_date schema: type: string type: string @@ -2156,24 +2085,27 @@ paths: items: properties: date: - description: 'Example: 2019-07-03T23:26:42.000Z' + description: 'Example: 2018-05-20T00:00:00.000Z' type: string + new_contributors: + description: 'Example: 3' + type: integer repo_id: - description: 'Example: 21036' + description: 'Example: 21000' type: integer repo_name: - description: 'Example: jquery-ujs' + description: 'Example: rails' type: string - watchers: - description: 'Example: 60' - type: integer type: array tags: - - value - /repo-groups/:repo_group_id/watchers-count: + - evolution + /repo-groups/:repo_group_id/issue-backlog: get: - description: Watchers count. - operationId: Watchers Count (Repo Group) + description: 'Number of issues currently open. ' + externalDocs: + description: CHAOSS Metric Definition + url: https://github.com/chaoss/wg-evolution/blob/master/focus_areas/code_development.md + operationId: Issue Backlog (Repo Group) parameters: - description: Repository Group ID in: path @@ -2187,64 +2119,75 @@ paths: schema: items: properties: + issue_backlog: + description: 'Example: 21' + type: integer repo_id: - description: 'Example: 21039' + description: 'Example: 21055' type: integer repo_name: - description: 'Example: rails_xss' + description: 'Example: cache_digests' type: string - watchers: - description: 'Example: 20' - type: integer type: array tags: - - value - /repos: + - evolution + /repos/:repo_id/issue-backlog: get: - description: Get all the downloaded repos. - operationId: Repos + description: 'Time since an issue is proposed until it is closed. ' + externalDocs: + description: CHAOSS Metric Definition + url: https://github.com/chaoss/wg-evolution/blob/master/focus_areas/code_development.md + operationId: Issue Duration (Repo) + parameters: + - description: Repository ID. + in: path + name: repo_id + schema: + type: string + type: string + - description: 'Beginning date specification. E.g. values: 2018, 2018-05, 2019-05-01' + in: path + name: begin_date + schema: + type: string + type: string + - description: 'Ending date specification. E.g. values: 2018, 2018-05, 2019-05-01' + in: path + name: end_date + schema: + type: string + type: string responses: '200': description: OK schema: items: properties: - base64_url: - description: 'Example: Z2l0aHViLmNvbS9hcGFjaGUvaW5jdWJhdG9yLWFyZ3VzLmdpdA==' - type: string - commits_all_time: - description: 'Example: None' + closed_at: + description: 'Example: 2011-04-14T23:27:33.000Z' type: string - description: - description: 'Example: None' + created_at: + description: 'Example: 2011-02-13T03:46:06.000Z' type: string - issues_all_time: - description: 'Example: None' + duration: + description: 'Example: 60 days 19:41:27.000000000' type: string - repo_id: - description: 'Example: 21996' + issue_id: + description: 'Example: 50306' type: integer repo_name: - description: 'Example: incubator-argus' - type: string - repo_status: - description: 'Example: Update' - type: string - rg_name: - description: 'Example: Apache' - type: string - url: - description: 'Example: github.com/apache/incubator-argus.git' + description: 'Example: exception_notification' type: string type: array tags: - - utility - /repos/:repo_id/aggregate-summary: + - evolution + /repo-groups/:repo_group_id/issue-participants: get: - description: Returns the current count of watchers, stars, and forks and the - counts of all commits, committers, and pull requests merged between a given - beginning and end date (default between now and 365 days ago). - operationId: Aggregate Summary (Repo) + description: 'How many persons participated in the discussion of issues. ' + externalDocs: + description: CHAOSS Metric Definition + url: https://github.com/chaoss/wg-evolution/blob/master/focus_areas/code_development.md + operationId: Issue Participants (Repo Group) parameters: - description: Repository Group ID. in: path @@ -2252,12 +2195,6 @@ paths: schema: type: string type: string - - description: Repository ID. - in: path - name: repo_id - schema: - type: string - type: string - description: 'Beginning date specification. E.g. values: 2018, 2018-05, 2019-05-01' in: path name: begin_date @@ -2276,44 +2213,47 @@ paths: schema: items: properties: - commit_count: - description: 'Example: 133' - type: integer - committer_count: - description: 'Example: 5' - type: integer - fork_count: - description: 'Example: 449' - type: integer - merged_count: - description: 'Example: 0' + created_at: + description: 'Example: 2019-06-20T22:56:38.000Z' + type: string + issue_id: + description: 'Example: 50328' type: integer - star_count: - description: 'Example: 581' + participants: + description: 'Example: 1' type: integer - watcher_count: - description: 'Example: 83' + repo_id: + description: 'Example: 21027' type: integer + repo_name: + description: 'Example: rails-contributors' + type: string type: array tags: - - experimental - /repos/:repo_id/average-issue-resolution-time: + - evolution + /repos/:repo_id/issue-participants: get: - description: 'The average issue resolution time. ' + description: 'How many persons participated in the discussion of issues. ' externalDocs: description: CHAOSS Metric Definition - url: https://github.com/chaoss/wg-risk/blob/master/focus-areas/business-risk.md - operationId: Average Issue Resolution Time (Repo) + url: https://github.com/chaoss/wg-evolution/blob/master/focus_areas/code_development.md + operationId: Issue Participants (Repo) parameters: - - description: Repository Group ID. + - description: Repository ID. + in: path + name: repo_id + schema: + type: string + type: string + - description: 'Beginning date specification. E.g. values: 2018, 2018-05, 2019-05-01' in: path - name: repo_group_id + name: begin_date schema: type: string type: string - - description: Repository ID. + - description: 'Ending date specification. E.g. values: 2018, 2018-05, 2019-05-01' in: path - name: repo_id + name: end_date schema: type: string type: string @@ -2323,61 +2263,64 @@ paths: schema: items: properties: - avg_issue_resolution_time: - description: 'Example: 276 days 13:54:13.2' + created_at: + description: 'Example: 2017-03-02T21:14:46.000Z' type: string + issue_id: + description: 'Example: 50796' + type: integer + participants: + description: 'Example: 1' + type: integer repo_name: - description: 'Example: maven-release' + description: 'Example: arel' type: string type: array tags: - - risk - /repos/:repo_id/cii-best-practices-badge: + - evolution + /repo-groups/:repo_group_id/issue-throughput: get: - description: 'The CII Best Practices Badge level. ' + description: 'Ratio of issues closed to total issues. ' externalDocs: description: CHAOSS Metric Definition - url: https://github.com/chaoss/wg-risk/blob/master/focus-areas/security.md - operationId: CII Best Practices Badge (Repo) + url: https://github.com/chaoss/wg-evolution/blob/master/focus_areas/code_development.md + operationId: Issue Throughput (Repo Group) parameters: - - description: Repository Group ID. + - description: Repository Group ID in: path name: repo_group_id schema: type: string type: string - - description: Repository ID. - in: path - name: repo_id - schema: - type: string - type: string responses: '200': description: OK schema: items: properties: - badge_level: - description: 'Example: passing' - type: string + repo_id: + description: 'Example: 21681' + type: integer repo_name: - description: 'Example: trickster' + description: 'Example: incubator-zipkin' + type: string + throughput: + description: 'Example: 0.819125' type: string type: array tags: - - risk - /repos/:repo_id/closed-issues-count: + - evolution + /repos/:repo_id/issue-throughput: get: - description: 'Count of closed issues. ' + description: 'Ratio of issues closed to total issues. ' externalDocs: description: CHAOSS Metric Definition - url: https://github.com/chaoss/wg-evolution/blob/master/metrics/contributors-new.md - operationId: Closed Issues Count (Repo Group) + url: https://github.com/chaoss/wg-evolution/blob/master/focus_areas/code_development.md + operationId: Issue Throughput (Repo) parameters: - - description: Repository Group ID + - description: Repository ID. in: path - name: repo_group_id + name: repo_id schema: type: string type: string @@ -2387,38 +2330,30 @@ paths: schema: items: properties: - closed_count: - description: 'Example: 4' - type: integer - date: - description: 'Example: 2014-06-02T00:00:00.000Z' + repo_name: + description: 'Example: rails-contributors' type: string - rg_name: - description: 'Example: Apache' + throughput: + description: 'Example: 0.997531' type: string type: array tags: - evolution - /repos/:repo_id/code-changes: + /repo-groups/:repo_group_id/issues-active: get: - description: 'Time series number of commits during a certain period. ' + description: 'Time series of number of issues that showed some activity during + a certain period. ' externalDocs: description: CHAOSS Metric Definition - url: https://github.com/chaoss/wg-evolution/blob/master/metrics/Code_Changes.md - operationId: Code Changes (Repo) + url: https://github.com/chaoss/wg-evolution/blob/master/metrics/Issues_Active.md + operationId: Issues Active (Repo Group) parameters: - - description: Repository Group ID. + - description: Repository Group ID in: path name: repo_group_id schema: type: string type: string - - description: Repository ID. - in: path - name: repo_id - schema: - type: string - type: string - description: Periodicity specification. in: path name: period @@ -2443,32 +2378,30 @@ paths: schema: items: properties: - commit_count: - description: 'Example: 90' - type: integer date: - description: 'Example: 2015-01-01T00:00:00.000Z' + description: 'Example: 2019-01-01T00:00:00.000Z' type: string + issues: + description: 'Example: 18' + type: integer + repo_id: + description: 'Example: 21039' + type: integer repo_name: - description: 'Example: graphql' + description: 'Example: rails_xss' type: string type: array tags: - evolution - /repos/:repo_id/code-changes-lines: + /repos/:repo_id/issues-active: get: - description: 'Time series of lines added and removed during a certain period. ' + description: 'Time series of number of issues that showed some activity during + a certain period. ' externalDocs: description: CHAOSS Metric Definition - url: https://github.com/chaoss/wg-evolution/blob/master/metrics/Code_Changes_Lines.md - operationId: Code Changes Lines (Repo) + url: https://github.com/chaoss/wg-evolution/blob/master/metrics/Issues_Active.md + operationId: Issues Active (Repo) parameters: - - description: Repository Group ID. - in: path - name: repo_group_id - schema: - type: string - type: string - description: Repository ID. in: path name: repo_id @@ -2499,42 +2432,32 @@ paths: schema: items: properties: - added: - description: 'Example: 17613' - type: integer date: - description: 'Example: 2015-06-01T00:00:00.000Z' + description: 'Example: 2011-01-01T00:00:00.000Z' type: string - removed: - description: 'Example: 106' + issues: + description: 'Example: 30' type: integer repo_name: - description: 'Example: graphql-js' + description: 'Example: rails' type: string type: array tags: - evolution - /repos/:repo_id/committers: + /repo-groups/:repo_group_id/issues-closed: get: - description: 'Number of persons contributing with an accepted commit for the - first time. ' + description: 'Time series of number of issues closed during a certain period. ' externalDocs: description: CHAOSS Metric Definition - url: https://github.com/chaoss/wg-risk/blob/master/metrics/Committers.md - operationId: Committers(Repo) + url: https://github.com/chaoss/wg-evolution/blob/master/metrics/Issues_Closed.md + operationId: Issues Closed (Repo Group) parameters: - - description: Repository Group ID. + - description: Repository Group ID in: path name: repo_group_id schema: type: string type: string - - description: Repository ID. - in: path - name: repo_id - schema: - type: string - type: string - description: Periodicity specification. in: path name: period @@ -2559,38 +2482,38 @@ paths: schema: items: properties: - count: - description: 'Example: 1' - type: integer date: - description: 'Example: 2018-10-25T00:00:00.000Z' + description: 'Example: 2019-01-01T00:00:00.000Z' type: string + issues: + description: 'Example: 425' + type: integer + repo_id: + description: 'Example: 21681' + type: integer repo_name: - description: 'Example: weasel' - type: string - rg_name: - description: 'Example: Comcast' + description: 'Example: incubator-zipkin' type: string type: array tags: - - risk - /repos/:repo_id/contributors: + - evolution + /repos/:repo_id/issues-closed: get: - description: 'List of contributors and their contributions. ' + description: 'Time series of number of issues closed during a certain period. ' externalDocs: description: CHAOSS Metric Definition - url: https://github.com/chaoss/wg-evolution/blob/master/metrics/contributors.md - operationId: Contributors (Repo) + url: https://github.com/chaoss/wg-evolution/blob/master/metrics/Issues_New.md + operationId: Issues Closed (Repo) parameters: - - description: Repository Group ID. + - description: Repository ID. in: path - name: repo_group_id + name: repo_id schema: type: string type: string - - description: Repository ID. + - description: Periodicity specification. in: path - name: repo_id + name: period schema: type: string type: string @@ -2612,53 +2535,117 @@ paths: schema: items: properties: - commit_comments: - description: 'Example: 0' - type: integer - commits: - description: 'Example: 0' - type: integer - issue_comments: - description: 'Example: 0' - type: integer + date: + description: 'Example: 2012-01-01T00:00:00.000Z' + type: string issues: - description: 'Example: 2' - type: integer - pull_request_comments: - description: 'Example: 0' + description: 'Example: 97' type: integer - pull_requests: - description: 'Example: 0' + repo_name: + description: 'Example: incubator-pagespeed-ngx' + type: string + type: array + tags: + - evolution + /repo-groups/:repo_group_id/issues-closed-resolution-duration: + get: + description: 'Duration of time for issues to be resolved. ' + externalDocs: + description: CHAOSS Metric Definition + url: https://github.com/chaoss/wg-evolution/blob/master/metrics/issues-closed-resolution-duration.md + operationId: Closed Issue Resolution Duration (Repo Group) + parameters: + - description: Repository Group ID + in: path + name: repo_group_id + schema: + type: string + type: string + responses: + '200': + description: OK + schema: + items: + properties: + closed_at: + description: 'Example: 2019-05-22T05:27:29.000Z' + type: string + created_at: + description: 'Example: 2019-05-22T03:18:13.000Z' + type: string + diffdate: + description: 'Example: 0.0' + type: string + gh_issue_number: + description: 'Example: 4110' type: integer - total: - description: 'Example: 2' + issue_title: + description: 'Example: rm incubating word' + type: string + repo_name: + description: 'Example: incubator-dubbo' + type: string + type: array + tags: + - evolution + /repos/:repo_id/issues-closed-resolution-duration: + get: + description: 'Duration of time for issues to be resolved. ' + externalDocs: + description: CHAOSS Metric Definition + url: https://github.com/chaoss/wg-evolution/blob/master/metrics/issues-closed-resolution-duration.md + operationId: Closed Issue Resolution Duration (Repo) + parameters: + - description: Repository ID. + in: path + name: repo_id + schema: + type: string + type: string + responses: + '200': + description: OK + schema: + items: + properties: + closed_at: + description: 'Example: 2019-06-17T03:12:48.000Z' + type: string + created_at: + description: 'Example: 2019-05-31T07:55:44.000Z' + type: string + diffdate: + description: 'Example: 16.0' + type: string + gh_issue_number: + description: 'Example: 4223' type: integer - user: - description: 'Example: 1' + issue_title: + description: 'Example: Cloud Native PR' + type: string + repo_id: + description: 'Example: 21682' type: integer + repo_name: + description: 'Example: incubator-dubbo' + type: string type: array tags: - evolution - /repos/:repo_id/contributors-new: + /repo-groups/:repo_group_id/issues-first-time-closed: get: - description: 'Time series of number of new contributors during a certain period. ' + description: 'Number of persons closing an issue for the first time. ' externalDocs: description: CHAOSS Metric Definition - url: https://github.com/chaoss/wg-evolution/blob/master/metrics/contributors-new.md - operationId: New Contributors (Repo) + url: https://github.com/chaoss/wg-evolution/blob/master/metrics/issues-first-time-closed.md + operationId: Closed Issues New Contributor (Repo Group) parameters: - - description: Repository Group ID. + - description: Repository Group ID in: path name: repo_group_id schema: type: string type: string - - description: Repository ID. - in: path - name: repo_id - schema: - type: string - type: string - description: Periodicity specification. in: path name: period @@ -2683,12 +2670,12 @@ paths: schema: items: properties: - date: - description: 'Example: 2018-05-20T00:00:00.000Z' - type: string - new_contributors: + count: description: 'Example: 3' type: integer + issue_date: + description: 'Example: 2018-05-20T00:00:00.000Z' + type: string repo_id: description: 'Example: 21000' type: integer @@ -2698,58 +2685,35 @@ paths: type: array tags: - evolution - /repos/:repo_id/fork-count: + /repos/:repo_id/issues-first-time-closed: get: - description: 'Fork count. ' + description: 'Number of persons closing an issue for the first time. ' externalDocs: description: CHAOSS Metric Definition - url: https://github.com/chaoss/wg-risk/blob/master/focus-areas/business-risk.md - operationId: Fork Count (Repo) + url: https://github.com/chaoss/wg-evolution/blob/master/metrics/issues-first-time-closed.md + operationId: Closed Issues New Contributors (Repo) parameters: - - description: Repository Group ID. + - description: Repository ID. in: path - name: repo_group_id + name: repo_id schema: type: string type: string - - description: Repository ID. + - description: Periodicity specification. in: path - name: repo_id + name: period schema: type: string type: string - responses: - '200': - description: OK - schema: - items: - properties: - forks: - description: 'Example: 844' - type: integer - repo_name: - description: 'Example: graphiql' - type: string - type: array - tags: - - risk - /repos/:repo_id/forks: - get: - description: 'A time series of fork count. ' - externalDocs: - description: CHAOSS Metric Definition - url: https://github.com/chaoss/wg-risk/blob/master/focus-areas/business-risk.md - operationId: Forks (Repo) - parameters: - - description: Repository Group ID. + - description: 'Beginning date specification. E.g. values: 2018, 2018-05, 2019-05-01' in: path - name: repo_group_id + name: begin_date schema: type: string type: string - - description: Repository ID. + - description: 'Ending date specification. E.g. values: 2018, 2018-05, 2019-05-01' in: path - name: repo_id + name: end_date schema: type: string type: string @@ -2759,35 +2723,35 @@ paths: schema: items: properties: - date: - description: 'Example: 2019-07-03T23:27:42.000Z' - type: string - forks: - description: 'Example: 843' + count: + description: 'Example: 3' type: integer + issue_date: + description: 'Example: 2018-05-20T00:00:00.000Z' + type: string repo_name: - description: 'Example: graphiql' + description: 'Example: rails' type: string type: array tags: - - risk - /repos/:repo_id/issue-backlog: + - evolution + /repo-groups/:repo_group_id/issues-first-time-opened: get: - description: 'Time since an issue is proposed until it is closed. ' + description: 'Number of persons opening an issue for the first time. ' externalDocs: description: CHAOSS Metric Definition - url: https://github.com/chaoss/wg-evolution/blob/master/focus_areas/code_development.md - operationId: Issue Duration (Repo) + url: https://github.com/chaoss/wg-evolution/blob/master/metrics/issues-first-time-opened.md + operationId: New Contributors of Issues (Repo Group) parameters: - - description: Repository Group ID. + - description: Repository Group ID in: path name: repo_group_id schema: type: string type: string - - description: Repository ID. + - description: Periodicity specification. in: path - name: repo_id + name: period schema: type: string type: string @@ -2809,73 +2773,50 @@ paths: schema: items: properties: - closed_at: - description: 'Example: 2011-04-14T23:27:33.000Z' - type: string - created_at: - description: 'Example: 2011-02-13T03:46:06.000Z' - type: string - duration: - description: 'Example: 60 days 19:41:27.000000000' + count: + description: 'Example: 3' + type: integer + issue_date: + description: 'Example: 2018-05-20T00:00:00.000Z' type: string - issue_id: - description: 'Example: 50306' + repo_id: + description: 'Example: 21000' type: integer repo_name: - description: 'Example: exception_notification' + description: 'Example: rails' type: string type: array tags: - evolution - /repos/:repo_id/issue-comments-mean: + /repos/:repo_id/issues-first-time-opened: get: - description: Mean(Average) of issue comments per day. - operationId: Issue Comments Mean (Repo) + description: 'Number of persons opening an issue for the first time. ' + externalDocs: + description: CHAOSS Metric Definition + url: https://github.com/chaoss/wg-evolution/blob/master/metrics/issues-first-time-opened.md + operationId: New Contributors of Issues (Repo) parameters: - - description: Repository Group ID. + - description: Repository ID. in: path - name: repo_group_id + name: repo_id schema: type: string type: string - - description: Repository ID. + - description: Periodicity specification. in: path - name: repo_id + name: period schema: type: string type: string - responses: - '200': - description: OK - schema: - items: - properties: - date: - description: 'Example: 2018-01-01T00:00:00.000Z' - type: string - mean: - description: 'Example: 0.6191780822' - type: string - repo_id: - description: 'Example: 21326' - type: integer - type: array - tags: - - experimental - /repos/:repo_id/issue-comments-mean-std: - get: - description: Mean(Average) and Standard Deviation of issue comments per day. - operationId: Issue Comments Mean Std (Repo) - parameters: - - description: Repository Group ID. + - description: 'Beginning date specification. E.g. values: 2018, 2018-05, 2019-05-01' in: path - name: repo_group_id + name: begin_date schema: type: string type: string - - description: Repository ID. + - description: 'Ending date specification. E.g. values: 2018, 2018-05, 2019-05-01' in: path - name: repo_id + name: end_date schema: type: string type: string @@ -2885,41 +2826,32 @@ paths: schema: items: properties: - average: - description: 'Example: 2.5' - type: string - date: - description: 'Example: 2011-01-01T00:00:00.000Z' - type: string - repo_id: - description: 'Example: 21000' + count: + description: 'Example: 3' type: integer - standard_deviation: - description: 'Example: 1.7159383568' + issue_date: + description: 'Example: 2018-05-20T00:00:00.000Z' + type: string + repo_name: + description: 'Example: rails' type: string type: array tags: - - experimental - /repos/:repo_id/issue-participants: + - evolution + /repo-groups/:repo_group_id/issues-maintainer-response-duration: get: - description: 'How many persons participated in the discussion of issues. ' + description: 'Duration of time for issues to be resolved. ' externalDocs: description: CHAOSS Metric Definition - url: https://github.com/chaoss/wg-evolution/blob/master/focus_areas/code_development.md - operationId: Issue Participants (Repo) + url: https://github.com/chaoss/wg-evolution/blob/master/metrics/issues-maintainer-response-duration.md + operationId: Issue Response Time (Repo Group) parameters: - - description: Repository Group ID. + - description: Repository Group ID in: path name: repo_group_id schema: type: string type: string - - description: Repository ID. - in: path - name: repo_id - schema: - type: string - type: string - description: 'Beginning date specification. E.g. values: 2018, 2018-05, 2019-05-01' in: path name: begin_date @@ -2938,38 +2870,41 @@ paths: schema: items: properties: - created_at: - description: 'Example: 2017-03-02T21:14:46.000Z' + average_days_comment: + description: 'Example: 27.1111111111' type: string - issue_id: - description: 'Example: 50796' - type: integer - participants: - description: 'Example: 1' + repo_id: + description: 'Example: 21987' type: integer repo_name: - description: 'Example: arel' + description: 'Example: qpid-proton' type: string type: array tags: - evolution - /repos/:repo_id/issue-throughput: + /repos/:repo_id/issues-maintainer-response-duration: get: - description: 'Ratio of issues closed to total issues. ' + description: 'Duration of time for issues to be resolved. ' externalDocs: description: CHAOSS Metric Definition - url: https://github.com/chaoss/wg-evolution/blob/master/focus_areas/code_development.md - operationId: Issue Throughput (Repo) + url: https://github.com/chaoss/wg-evolution/blob/master/metrics/issues-maintainer-response-duration.md + operationId: Issue Response Time (Repo) parameters: - - description: Repository Group ID. + - description: Repository ID. in: path - name: repo_group_id + name: repo_id schema: type: string type: string - - description: Repository ID. + - description: 'Beginning date specification. E.g. values: 2018, 2018-05, 2019-05-01' in: path - name: repo_id + name: begin_date + schema: + type: string + type: string + - description: 'Ending date specification. E.g. values: 2018, 2018-05, 2019-05-01' + in: path + name: end_date schema: type: string type: string @@ -2979,36 +2914,32 @@ paths: schema: items: properties: - repo_name: - description: 'Example: rails-contributors' + average_days_comment: + description: 'Example: 27.1111111111' type: string - throughput: - description: 'Example: 0.997531' + repo_id: + description: 'Example: 21987' + type: integer + repo_name: + description: 'Example: qpid-proton' type: string type: array tags: - evolution - /repos/:repo_id/issues-active: + /repo-groups/:repo_group_id/issues-new: get: - description: 'Time series of number of issues that showed some activity during - a certain period. ' + description: 'Time series of number of new issues opened during a certain period. ' externalDocs: description: CHAOSS Metric Definition - url: https://github.com/chaoss/wg-evolution/blob/master/metrics/Issues_Active.md - operationId: Issues Active (Repo) + url: https://github.com/chaoss/wg-evolution/blob/master/metrics/Issues_New.md + operationId: Issues New (Repo Group) parameters: - - description: Repository Group ID. + - description: Repository Group ID in: path name: repo_group_id schema: type: string type: string - - description: Repository ID. - in: path - name: repo_id - schema: - type: string - type: string - description: Periodicity specification. in: path name: period @@ -3034,10 +2965,13 @@ paths: items: properties: date: - description: 'Example: 2011-01-01T00:00:00.000Z' + description: 'Example: 2019-01-01T00:00:00.000Z' type: string issues: - description: 'Example: 30' + description: 'Example: 318' + type: integer + repo_id: + description: 'Example: 21000' type: integer repo_name: description: 'Example: rails' @@ -3045,20 +2979,14 @@ paths: type: array tags: - evolution - /repos/:repo_id/issues-closed: + /repos/:repo_id/issues-new: get: - description: 'Time series of number of issues closed during a certain period. ' + description: 'Time series of number of new issues opened during a certain period. ' externalDocs: description: CHAOSS Metric Definition url: https://github.com/chaoss/wg-evolution/blob/master/metrics/Issues_New.md - operationId: Issues Closed (Repo) + operationId: Issues New (Repo) parameters: - - description: Repository Group ID. - in: path - name: repo_group_id - schema: - type: string - type: string - description: Repository ID. in: path name: repo_id @@ -3090,31 +3018,63 @@ paths: items: properties: date: - description: 'Example: 2012-01-01T00:00:00.000Z' + description: 'Example: 2015-01-01T00:00:00.000Z' type: string issues: - description: 'Example: 97' + description: 'Example: 116' type: integer repo_name: - description: 'Example: incubator-pagespeed-ngx' + description: 'Example: rails' type: string type: array tags: - evolution - /repos/:repo_id/issues-closed-resolution-duration: + /repo-groups/:repo_group_id/issues-open-age: get: - description: 'Duration of time for issues to be resolved. ' + description: 'Age of open issues. ' externalDocs: description: CHAOSS Metric Definition - url: https://github.com/chaoss/wg-evolution/blob/master/metrics/issues-closed-resolution-duration.md - operationId: Closed Issue Resolution Duration (Repo) + url: https://github.com/chaoss/wg-evolution/blob/master/metrics/issues-open-age.md + operationId: Open Issue Age (Repo Group) parameters: - - description: Repository Group ID. + - description: Repository Group ID in: path name: repo_group_id schema: type: string type: string + responses: + '200': + description: OK + schema: + items: + properties: + date: + description: 'Example: 2009-05-15T19:48:43.000Z' + type: string + issue_id: + description: 'Example: 38318' + type: integer + open_date: + description: 'Example: 3696' + type: integer + repo_id: + description: 'Example: 21000' + type: integer + repo_name: + description: 'Example: rails' + type: string + type: array + tags: + - evolution + /repos/:repo_id/issues-open-age: + get: + description: 'Age of open issues. ' + externalDocs: + description: CHAOSS Metric Definition + url: https://github.com/chaoss/wg-evolution/blob/master/metrics/issues-open-age.md + operationId: Open Issue Age (Repo) + parameters: - description: Repository ID. in: path name: repo_id @@ -3127,44 +3087,87 @@ paths: schema: items: properties: - closed_at: - description: 'Example: 2019-06-17T03:12:48.000Z' - type: string - created_at: - description: 'Example: 2019-05-31T07:55:44.000Z' - type: string - diffdate: - description: 'Example: 16.0' + date: + description: 'Example: 2009-05-15T19:48:43.000Z' type: string - gh_issue_number: - description: 'Example: 4223' + issue_id: + description: 'Example: 38318' + type: integer + open_date: + description: 'Example: 3696' type: integer - issue_title: - description: 'Example: Cloud Native PR' - type: string repo_id: - description: 'Example: 21682' + description: 'Example: 21000' type: integer repo_name: - description: 'Example: incubator-dubbo' + description: 'Example: rails' type: string type: array tags: - evolution - /repos/:repo_id/issues-first-time-closed: + /repo-groups/:repo_group_id/pull-requests-merge-contributor-new: get: - description: 'Number of persons closing an issue for the first time. ' + description: 'Number of persons contributing with an accepted commit for the + first time. ' externalDocs: description: CHAOSS Metric Definition - url: https://github.com/chaoss/wg-evolution/blob/master/metrics/issues-first-time-closed.md - operationId: Closed Issues New Contributors (Repo) + url: https://github.com/chaoss/wg-evolution/blob/master/metrics/pull-requests-merge-contributor-new.md + operationId: New Contributors of Commits (Repo Group) parameters: - - description: Repository Group ID. + - description: Repository Group ID in: path name: repo_group_id schema: type: string type: string + - description: Periodicity specification. + in: path + name: period + schema: + type: string + type: string + - description: 'Beginning date specification. E.g. values: 2018, 2018-05, 2019-05-01' + in: path + name: begin_date + schema: + type: string + type: string + - description: 'Ending date specification. E.g. values: 2018, 2018-05, 2019-05-01' + in: path + name: end_date + schema: + type: string + type: string + responses: + '200': + description: OK + schema: + items: + properties: + commit_count: + description: 'Example: 711' + type: integer + commit_date: + description: 'Example: 2018-01-01T00:00:00.000Z' + type: string + count: + description: 'Example: 5140' + type: integer + repo_name: + description: 'Example: rails' + type: string + type: array + tags: + - evolution + /repos/:repo_id/pull-requests-merge-contributor-new: + get: + description: 'Number of persons contributing with an accepted commit for the + first time. ' + externalDocs: + description: CHAOSS Metric Definition + url: https://github.com/chaoss/wg-evolution/blob/master/metrics/pull-requests-merge-contributor-new.md + operationId: New Contributors of Commits (Repo) + parameters: - description: Repository ID. in: path name: repo_id @@ -3195,44 +3198,85 @@ paths: schema: items: properties: + commit_date: + description: 'Example: 2018-01-01T00:00:00.000Z' + type: string count: - description: 'Example: 3' + description: 'Example: 2287' type: integer - issue_date: - description: 'Example: 2018-05-20T00:00:00.000Z' - type: string repo_name: description: 'Example: rails' type: string type: array tags: - evolution - /repos/:repo_id/issues-first-time-opened: + /repo-groups/:repo_group_id/review-duration: get: - description: 'Number of persons opening an issue for the first time. ' + description: 'Time since an review/pull request is proposed until it is accepted. ' externalDocs: description: CHAOSS Metric Definition - url: https://github.com/chaoss/wg-evolution/blob/master/metrics/issues-first-time-opened.md - operationId: New Contributors of Issues (Repo) + url: https://github.com/chaoss/wg-evolution/blob/master/metrics/Reviews_Duration.md + operationId: Review Duration (Repo Group) parameters: - - description: Repository Group ID. + - description: Repository Group ID in: path name: repo_group_id schema: type: string type: string + - description: 'Beginning date specification. E.g. values: 2018, 2018-05, 2019-05-01' + in: path + name: begin_date + schema: + type: string + type: string + - description: 'Ending date specification. E.g. values: 2018, 2018-05, 2019-05-01' + in: path + name: end_date + schema: + type: string + type: string + responses: + '200': + description: OK + schema: + items: + properties: + created_at: + description: 'Example: 2010-09-28T19:07:15.000Z' + type: string + duration: + description: 'Example: 0 days 22:39:44.000000000' + type: string + merged_at: + description: 'Example: 2010-09-29T17:46:59.000Z' + type: string + pull_request_id: + description: 'Example: 25386' + type: integer + repo_id: + description: 'Example: 21035' + type: integer + repo_name: + description: 'Example: prototype-ujs' + type: string + type: array + tags: + - evolution + /repos/:repo_id/review-duration: + get: + description: 'Time since an review/pull request is proposed until it is accepted. ' + externalDocs: + description: CHAOSS Metric Definition + url: https://github.com/chaoss/wg-evolution/blob/master/metrics/Reviews_Duration.md + operationId: Review Duration (Repo) + parameters: - description: Repository ID. in: path name: repo_id schema: type: string type: string - - description: Periodicity specification. - in: path - name: period - schema: - type: string - type: string - description: 'Beginning date specification. E.g. values: 2018, 2018-05, 2019-05-01' in: path name: begin_date @@ -3251,25 +3295,32 @@ paths: schema: items: properties: - count: - description: 'Example: 3' - type: integer - issue_date: - description: 'Example: 2018-05-20T00:00:00.000Z' + created_at: + description: 'Example: 2019-01-02T11:02:08.000Z' + type: string + duration: + description: 'Example: 183 days 22:08:37.000000000' type: string + merged_at: + description: 'Example: 2019-07-05T09:10:45.000Z' + type: string + pull_request_id: + description: 'Example: 25374' + type: integer repo_name: - description: 'Example: rails' + description: 'Example: graphql-spec' type: string type: array tags: - evolution - /repos/:repo_id/issues-maintainer-response-duration: + /repo-groups/:repo_group_id/reviews: get: - description: 'Duration of time for issues to be resolved. ' + description: 'Time series of number of new reviews / pull requests opened within + a certain period. ' externalDocs: description: CHAOSS Metric Definition - url: https://github.com/chaoss/wg-evolution/blob/master/metrics/issues-maintainer-response-duration.md - operationId: Issue Response Time (Repo) + url: https://github.com/chaoss/wg-evolution/blob/master/metrics/reviews.md + operationId: Reviews (Repo Group) parameters: - description: Repository Group ID in: path @@ -3277,9 +3328,9 @@ paths: schema: type: string type: string - - description: Repository ID. + - description: Periodicity specification. in: path - name: repo_id + name: period schema: type: string type: string @@ -3301,32 +3352,30 @@ paths: schema: items: properties: - average_days_comment: - description: 'Example: 27.1111111111' + date: + description: 'Example: 2010-01-01T00:00:00.000Z' type: string + pull_requests: + description: 'Example: 1' + type: integer repo_id: - description: 'Example: 21987' + description: 'Example: 21035' type: integer repo_name: - description: 'Example: qpid-proton' + description: 'Example: prototype-ujs' type: string type: array tags: - evolution - /repos/:repo_id/issues-new: + /repos/:repo_id/reviews: get: - description: 'Time series of number of new issues opened during a certain period. ' + description: 'Time series of number of new reviews / pull requests opened within + a certain period. ' externalDocs: description: CHAOSS Metric Definition - url: https://github.com/chaoss/wg-evolution/blob/master/metrics/Issues_New.md - operationId: Issues New (Repo) + url: https://github.com/chaoss/wg-evolution/blob/master/metrics/reviews.md + operationId: Reviews (Repo) parameters: - - description: Repository Group ID. - in: path - name: repo_group_id - schema: - type: string - type: string - description: Repository ID. in: path name: repo_id @@ -3358,79 +3407,47 @@ paths: items: properties: date: - description: 'Example: 2015-01-01T00:00:00.000Z' + description: 'Example: 2016-01-01T00:00:00.000Z' type: string - issues: - description: 'Example: 116' + pull_requests: + description: 'Example: 37' type: integer repo_name: - description: 'Example: rails' + description: 'Example: graphql-spec' type: string type: array tags: - evolution - /repos/:repo_id/issues-open-age: + /repo-groups/:repo_group_id/reviews-accepted: get: - description: 'Age of open issues. ' + description: 'Time series of number of accepted reviews / pull requests opened + within a certain period. ' externalDocs: description: CHAOSS Metric Definition - url: https://github.com/chaoss/wg-evolution/blob/master/metrics/issues-open-age.md - operationId: Open Issue Age (Repo) + url: https://github.com/chaoss/wg-evolution/blob/master/metrics/Reviews_Accepted.md + operationId: Reviews Accepted (Repo Group) parameters: - - description: Repository Group ID. + - description: Repository Group ID in: path name: repo_group_id schema: type: string type: string - - description: Repository ID. + - description: Periodicity specification. in: path - name: repo_id + name: period schema: type: string type: string - responses: - '200': - description: OK - schema: - items: - properties: - date: - description: 'Example: 2009-05-15T19:48:43.000Z' - type: string - issue_id: - description: 'Example: 38318' - type: integer - open_date: - description: 'Example: 3696' - type: integer - repo_id: - description: 'Example: 21000' - type: integer - repo_name: - description: 'Example: rails' - type: string - type: array - tags: - - evolution - /repos/:repo_id/license-coverage: - get: - description: 'Number of persons contributing with an accepted commit for the - first time. ' - externalDocs: - description: CHAOSS Metric Definition - url: https://github.com/chaoss/wg-risk/blob/master/metrics/License_Coverage.md - operationId: License Coverage(Repo) - parameters: - - description: Repository Group ID. + - description: 'Beginning date specification. E.g. values: 2018, 2018-05, 2019-05-01' in: path - name: repo_group_id + name: begin_date schema: type: string type: string - - description: Repository ID. + - description: 'Ending date specification. E.g. values: 2018, 2018-05, 2019-05-01' in: path - name: repo_id + name: end_date schema: type: string type: string @@ -3440,76 +3457,39 @@ paths: schema: items: properties: - coverage: - description: 'Example: 0.347' + date: + description: 'Example: 2010-01-01T00:00:00.000Z' type: string - license_declared_file: - description: 'Example: 33' + pull_requests: + description: 'Example: 1' + type: integer + repo_id: + description: 'Example: 21035' type: integer repo_name: - description: 'Example: zucchini' + description: 'Example: prototype-ujs' type: string - total_files: - description: 'Example: 95' - type: integer type: array tags: - - risk - /repos/:repo_id/license-declared: + - evolution + /repos/:repo_id/reviews-accepted: get: - description: 'Number of persons contributing with an accepted commit for the - first time. ' + description: 'Time series of number of accepted reviews / pull requests opened + within a certain period. ' externalDocs: description: CHAOSS Metric Definition - url: https://github.com/chaoss/wg-risk/blob/master/metrics/License_Coverage.md - operationId: License Declared(Repo) + url: https://github.com/chaoss/wg-evolution/blob/master/metrics/Reviews_Accepted.md + operationId: Reviews Accepted (Repo) parameters: - - description: Repository Group ID. - in: path - name: repo_group_id - schema: - type: string - type: string - description: Repository ID. in: path name: repo_id schema: type: string type: string - responses: - '200': - description: OK - schema: - items: - properties: - name: - description: 'Example: trickster' - type: string - note: - description: 'Example: ' - type: string - short_name: - description: 'Example: Apache-2.0' - type: string - type: array - tags: - - risk - /repos/:repo_id/pull-request-acceptance-rate: - get: - description: Timeseries of pull request acceptance rate (expressed as the ratio - of pull requests merged on a date to the count of pull requests opened on - a date) - operationId: Pull Request Acceptance Rate (Repo) - parameters: - - description: Repository Group ID. - in: path - name: repo_group_id - schema: - type: string - type: string - - description: Repository ID. + - description: Periodicity specification. in: path - name: repo_id + name: period schema: type: string type: string @@ -3532,22 +3512,35 @@ paths: items: properties: date: - description: 'Example: 2019-01-01T00:00:00.000Z' + description: 'Example: 2016-01-01T00:00:00.000Z' type: string - rate: - description: 'Example: 5.3333333333' + pull_requests: + description: 'Example: 30' + type: integer + repo_name: + description: 'Example: graphql-spec' type: string type: array tags: - - experimental - /repos/:repo_id/pull-request-closed-no-merge: + - evolution + /repo-groups/:repo_group_id/reviews-declined: get: - description: '' - operationId: Pull Request Closed but not merged(Repo) + description: 'Time series of number of declined reviews / pull requests opened + within a certain period. ' + externalDocs: + description: CHAOSS Metric Definition + url: https://github.com/chaoss/wg-evolution/blob/master/metrics/Reviews_Accepted.md + operationId: Reviews Declined (Repo Group) parameters: - - description: Repository ID. + - description: Repository Group ID in: path - name: repo_id + name: repo_group_id + schema: + type: string + type: string + - description: Periodicity specification. + in: path + name: period schema: type: string type: string @@ -3557,8 +3550,7 @@ paths: schema: type: string type: string - - description: 'Ending date specification. E.g. values: 2018, 2018-05, 2019-05-01 - ___' + - description: 'Ending date specification. E.g. values: 2018, 2018-05, 2019-05-01' in: path name: end_date schema: @@ -3571,29 +3563,29 @@ paths: items: properties: date: - description: 'Example: 2019-01-01T00:00:00.000Z' + description: 'Example: 2010-01-01T00:00:00.000Z' type: string - pr_count: - description: 'Example: 3' + pull_requests: + description: 'Example: 1' type: integer + repo_id: + description: 'Example: 21035' + type: integer + repo_name: + description: 'Example: prototype-ujs' + type: string type: array tags: - - experimental - /repos/:repo_id/pull-requests-merge-contributor-new: + - evolution + /repos/:repo_id/reviews-declined: get: - description: 'Number of persons contributing with an accepted commit for the - first time. ' + description: 'Time series of number of declined reviews / pull requests opened + within a certain period. ' externalDocs: description: CHAOSS Metric Definition - url: https://github.com/chaoss/wg-evolution/blob/master/metrics/pull-requests-merge-contributor-new.md - operationId: New Contributors of Commits (Repo) - parameters: - - description: Repository Group ID. - in: path - name: repo_group_id - schema: - type: string - type: string + url: https://github.com/chaoss/wg-evolution/blob/master/metrics/Reviews_Accepted.md + operationId: Reviews Declined (Repo) + parameters: - description: Repository ID. in: path name: repo_id @@ -3624,35 +3616,41 @@ paths: schema: items: properties: - commit_date: - description: 'Example: 2018-01-01T00:00:00.000Z' + date: + description: 'Example: 2016-01-01T00:00:00.000Z' type: string - count: - description: 'Example: 2287' + pull_requests: + description: 'Example: 11' type: integer repo_name: - description: 'Example: rails' + description: 'Example: graphql-spec' type: string type: array tags: - evolution - /repos/:repo_id/releases: + /repo-groups/:repo_group_id/sub-projects: get: - description: 'Time since an review/pull request is proposed until it is accepted. ' + description: 'Number of sub-projects. ' externalDocs: description: CHAOSS Metric Definition - url: https://github.com/chaoss/wg-evolution/blob/master/metrics/Reviews_Duration.md - operationId: Number of releases (Repo) + url: https://github.com/chaoss/wg-evolution/blob/master/metrics/sub-projects.md + operationId: Sub-Projects (Repo Group) parameters: - - description: Repository Group ID. + - description: Repository Group ID in: path name: repo_group_id schema: type: string type: string - - description: Repository ID. + - description: 'Beginning date specification. E.g. values: 2018, 2018-05, 2019-05-01' in: path - name: repo_id + name: begin_date + schema: + type: string + type: string + - description: 'Ending date specification. E.g. values: 2018, 2018-05, 2019-05-01' + in: path + name: end_date schema: type: string type: string @@ -3662,35 +3660,20 @@ paths: schema: items: properties: - latest: - description: 'Example: 2019-11-02T11:02:08.000Z' - type: string - total_count: - description: 'Example: 35' - type: integer - latest_patch_release: - description: 'Example: 2019-01-02T15:20:07.000Z' - type: string - total_patch_count: - description: 'Example: 21' + sub_protject_count: + description: 'Example: 2' type: integer type: array tags: - evolution - /repos/:repo_id/review-duration: + /repos/:repo_id/sub-projects: get: - description: 'Time since an review/pull request is proposed until it is accepted. ' + description: 'Number of sub-projects. ' externalDocs: description: CHAOSS Metric Definition - url: https://github.com/chaoss/wg-evolution/blob/master/metrics/Reviews_Duration.md - operationId: review Duration (Repo) + url: https://github.com/chaoss/wg-evolution/blob/master/metrics/sub-projects.md + operationId: Sub-Projects (Repo) parameters: - - description: Repository Group ID. - in: path - name: repo_group_id - schema: - type: string - type: string - description: Repository ID. in: path name: repo_id @@ -3715,34 +3698,21 @@ paths: schema: items: properties: - created_at: - description: 'Example: 2019-01-02T11:02:08.000Z' - type: string - duration: - description: 'Example: 183 days 22:08:37.000000000' - type: string - merged_at: - description: 'Example: 2019-07-05T09:10:45.000Z' - type: string - pull_request_id: - description: 'Example: 25374' + sub_protject_count: + description: 'Example: 2' type: integer - repo_name: - description: 'Example: graphql-spec' - type: string type: array tags: - evolution - /repos/:repo_id/reviews: + /repo-groups/:repo_group_id/closed-issues-count: get: - description: 'Time series of number of new reviews / pull requests opened within - a certain period. ' + description: 'Count of closed issues. ' externalDocs: description: CHAOSS Metric Definition - url: https://github.com/chaoss/wg-evolution/blob/master/metrics/reviews.md - operationId: Reviews (Repo) + url: https://github.com/chaoss/wg-evolution/blob/master/metrics/contributors-new.md + operationId: Closed Issues Count (Repo Group) parameters: - - description: Repository Group ID. + - description: Repository Group ID in: path name: repo_group_id schema: @@ -3754,66 +3724,67 @@ paths: schema: type: string type: string - - description: Periodicity specification. - in: path - name: period - schema: - type: string - type: string - - description: 'Beginning date specification. E.g. values: 2018, 2018-05, 2019-05-01' - in: path - name: begin_date - schema: - type: string - type: string - - description: 'Ending date specification. E.g. values: 2018, 2018-05, 2019-05-01' - in: path - name: end_date - schema: - type: string - type: string responses: '200': description: OK schema: items: properties: + closed_count: + description: 'Example: 26' + type: integer date: - description: 'Example: 2016-01-01T00:00:00.000Z' + description: 'Example: 2018-11-26T00:00:00.000Z' type: string - pull_requests: - description: 'Example: 37' + repo_id: + description: 'Example: 21681' type: integer - repo_name: - description: 'Example: graphql-spec' - type: string type: array tags: - evolution - /repos/:repo_id/reviews-accepted: + /repos/:repo_id/closed-issues-count: get: - description: 'Time series of number of accepted reviews / pull requests opened - within a certain period. ' + description: 'Count of closed issues. ' externalDocs: description: CHAOSS Metric Definition - url: https://github.com/chaoss/wg-evolution/blob/master/metrics/Reviews_Accepted.md - operationId: Reviews Accepted (Repo) + url: https://github.com/chaoss/wg-evolution/blob/master/metrics/contributors-new.md + operationId: Closed Issues Count (Repo) parameters: - - description: Repository Group ID. - in: path - name: repo_group_id - schema: - type: string - type: string - - description: Repository ID. + - description: Repository ID in: path name: repo_id schema: type: string type: string - - description: Periodicity specification. + responses: + '200': + description: OK + schema: + items: + properties: + closed_count: + description: 'Example: 4' + type: integer + date: + description: 'Example: 2014-06-02T00:00:00.000Z' + type: string + rg_name: + description: 'Example: Apache' + type: string + type: array + tags: + - evolution + /repo-groups/:repo_group_id/issue-duration: + get: + description: 'Time since an issue is proposed until it is closed. ' + externalDocs: + description: CHAOSS Metric Definition + url: https://github.com/chaoss/wg-evolution/blob/master/focus_areas/code_development.md + operationId: Issue Duration (Repo Group) + parameters: + - description: Repository Group ID in: path - name: period + name: repo_group_id schema: type: string type: string @@ -3835,54 +3806,73 @@ paths: schema: items: properties: - date: - description: 'Example: 2016-01-01T00:00:00.000Z' + closed_at: + description: 'Example: 2011-05-06T20:21:47.000Z' type: string - pull_requests: - description: 'Example: 30' + created_at: + description: 'Example: 2011-05-06T20:20:05.000Z' + type: string + duration: + description: 'Example: 0 days 00:01:42.000000000' + type: string + issue_id: + description: 'Example: 50320' + type: integer + repo_id: + description: 'Example: 21017' type: integer repo_name: - description: 'Example: graphql-spec' + description: 'Example: ssl_requirement' type: string type: array tags: - evolution - /repos/:repo_id/reviews-declined: + /repos/:repo_id/releases: get: - description: 'Time series of number of declined reviews / pull requests opened - within a certain period. ' + description: 'Time since an review/pull request is proposed until it is accepted. ' externalDocs: description: CHAOSS Metric Definition - url: https://github.com/chaoss/wg-evolution/blob/master/metrics/Reviews_Accepted.md - operationId: Reviews Declined (Repo) + url: https://github.com/chaoss/wg-evolution/blob/master/metrics/Reviews_Duration.md + operationId: Number of releases (Repo) parameters: - - description: Repository Group ID. - in: path - name: repo_group_id - schema: - type: string - type: string - description: Repository ID. in: path name: repo_id schema: type: string type: string - - description: Periodicity specification. - in: path - name: period - schema: - type: string - type: string - - description: 'Beginning date specification. E.g. values: 2018, 2018-05, 2019-05-01' - in: path - name: begin_date - schema: - type: string - type: string - - description: 'Ending date specification. E.g. values: 2018, 2018-05, 2019-05-01' + responses: + '200': + description: OK + schema: + items: + properties: + latest: + description: 'Example: 2019-11-02T11:02:08.000Z' + type: string + total_count: + description: 'Example: 35' + type: integer + latest_patch_release: + description: 'Example: 2019-01-02T15:20:07.000Z' + type: string + total_patch_count: + description: 'Example: 21' + type: integer + type: array + tags: + - evolution + /repo-groups/:repo_group_id/open-issues-count: + get: + description: 'Count of open issues. ' + externalDocs: + description: CHAOSS Metric Definition + url: https://github.com/chaoss/wg-evolution/blob/master/metrics/Issues_New.md + operationId: Open Issues Count (Repo Group) + parameters: + - description: Repository Group ID in: path - name: end_date + name: repo_group_id schema: type: string type: string @@ -3893,34 +3883,32 @@ paths: items: properties: date: - description: 'Example: 2016-01-01T00:00:00.000Z' + description: 'Example: 2017-09-11T00:00:00.000Z' type: string - pull_requests: - description: 'Example: 11' + open_count: + description: 'Example: 1' type: integer - repo_name: - description: 'Example: graphql-spec' + rg_name: + description: 'Example: Netflix' type: string type: array tags: - evolution - /repos/:repo_id/stars: + + + + #value endpoints + /repo-groups/:repo_group_id/watchers: get: - description: A time series of stars count. - operationId: Stars (Repo) + description: A time series of watchers count. + operationId: Watchers (Repo Group) parameters: - - description: Repository Group ID. + - description: Repository Group ID in: path name: repo_group_id schema: type: string type: string - - description: Repository ID. - in: path - name: repo_id - schema: - type: string - type: string responses: '200': description: OK @@ -3928,28 +3916,25 @@ paths: items: properties: date: - description: 'Example: 2019-07-03T23:27:42.000Z' + description: 'Example: 2019-07-03T23:26:42.000Z' type: string + repo_id: + description: 'Example: 21036' + type: integer repo_name: - description: 'Example: graphiql' + description: 'Example: jquery-ujs' type: string - stars: - description: 'Example: 8652' + watchers: + description: 'Example: 60' type: integer type: array tags: - value - /repos/:repo_id/stars-count: + /repos/:repo_id/watchers: get: - description: Stars count. - operationId: Stars Count (Repo) + description: A time series of watchers count. + operationId: Watchers (Repo) parameters: - - description: Repository Group ID. - in: path - name: repo_group_id - schema: - type: string - type: string - description: Repository ID. in: path name: repo_id @@ -3962,128 +3947,84 @@ paths: schema: items: properties: + date: + description: 'Example: 2019-07-03T23:22:26.000Z' + type: string repo_name: - description: 'Example: graphiql' + description: 'Example: airflow' type: string - stars: - description: 'Example: 8653' + watchers: + description: 'Example: 649' type: integer type: array tags: - value - /repos/:repo_id/sub-projects: + /repo-groups/:repo_group_id/watchers-count: get: - description: 'Number of sub-projects. ' - externalDocs: - description: CHAOSS Metric Definition - url: https://github.com/chaoss/wg-evolution/blob/master/metrics/sub-projects.md - operationId: Sub-Projects (Repo) + description: Watchers count. + operationId: Watchers Count (Repo Group) parameters: - - description: Repository Group ID. + - description: Repository Group ID in: path name: repo_group_id schema: type: string type: string - - description: Repository ID. - in: path - name: repo_id - schema: - type: string - type: string - - description: 'Beginning date specification. E.g. values: 2018, 2018-05, 2019-05-01' - in: path - name: begin_date - schema: - type: string - type: string - - description: 'Ending date specification. E.g. values: 2018, 2018-05, 2019-05-01' - in: path - name: end_date - schema: - type: string - type: string responses: '200': description: OK schema: items: properties: - sub_protject_count: - description: 'Example: 2' + repo_id: + description: 'Example: 21039' + type: integer + repo_name: + description: 'Example: rails_xss' + type: string + watchers: + description: 'Example: 20' type: integer type: array tags: - - evolution - /repos/:repo_id/top-committers: + - value + /repos/:repo_id/watchers-count: get: - description: Returns a list of contributors contributing N% of all commits. - operationId: Top Committers (Repo) + description: Watchers count. + operationId: Watchers Count (Repo) parameters: - - description: Repository Group ID. - in: path - name: repo_group_id - schema: - type: string - type: string - description: Repository ID. in: path name: repo_id schema: type: string type: string - - description: 'Specify the year to return the results for. Default value: current - year' - in: path - name: year - schema: - type: string - type: string - - description: Specify N%. Accepts a value between 0 & 1 where 0 specifies - 0% and 1 specifies 100%. - in: path - name: threshold - schema: - type: string - type: string responses: '200': description: OK schema: items: properties: - commits: - description: 'Example: 4' - type: integer - email: - description: 'Example: caniszczyk@gmail.com' - type: string - repo_id: - description: 'Example: 21334' - type: integer repo_name: - description: 'Example: graphql' + description: 'Example: airflow' type: string + watchers: + description: 'Example: 649' + type: integer type: array tags: - - experimental - /repos/:repo_id/watchers: + - value + /repo-groups/:repo_group_id/stars: get: - description: A time series of watchers count. - operationId: Watchers (Repo) + description: A time series of stars count. + operationId: Stars (Repo Group) parameters: - - description: Repository Group ID. + - description: Repository Group ID in: path name: repo_group_id schema: type: string type: string - - description: Repository ID. - in: path - name: repo_id - schema: - type: string - type: string responses: '200': description: OK @@ -4091,28 +4032,25 @@ paths: items: properties: date: - description: 'Example: 2019-07-03T23:22:26.000Z' + description: 'Example: 2019-07-03T23:23:36.000Z' type: string + repo_id: + description: 'Example: 21491' + type: integer repo_name: - description: 'Example: airflow' + description: 'Example: commons-io' type: string - watchers: - description: 'Example: 649' + stars: + description: 'Example: 600' type: integer type: array tags: - value - /repos/:repo_id/watchers-count: + /repos/:repo_id/stars: get: - description: Watchers count. - operationId: watchers Count (Repo) + description: A time series of stars count. + operationId: Stars (Repo) parameters: - - description: Repository Group ID. - in: path - name: repo_group_id - schema: - type: string - type: string - description: Repository ID. in: path name: repo_id @@ -4125,102 +4063,77 @@ paths: schema: items: properties: + date: + description: 'Example: 2019-07-03T23:27:42.000Z' + type: string repo_name: - description: 'Example: airflow' + description: 'Example: graphiql' type: string - watchers: - description: 'Example: 649' + stars: + description: 'Example: 8652' type: integer type: array tags: - value - /rg-name/:rg_name/repo-name/:repo_name: + /repo-groups/:repo_group_id/stars-count: get: - description: Get the repo_group_id and repo_id of a particular repo. - operationId: Get Repo + description: Stars count. + operationId: Stars Count (Repo Group) + parameters: + - description: Repository Group ID + in: path + name: repo_group_id + schema: + type: string + type: string responses: '200': description: OK schema: items: properties: - repo_git: - description: 'Example: https://github.com/rails/rails.git' - type: string - repo_group_id: - description: 'Example: 20' - type: integer repo_id: - description: 'Example: 21000' + description: 'Example: 21364' type: integer - type: array - tags: - - utility - /rg-names/:rg_name: - get: - description: Get the repo_id of a particular repo group. - operationId: Get Repo - responses: - '200': - description: OK - schema: - items: - properties: - repo_group_id: + repo_name: + description: 'Example: irs_process_scripts' + type: string + stars: description: 'Example: 20' type: integer - rg_name: - description: 'Example: Rails' - type: string type: array tags: - - utility - /top-insights: + - value + /repos/:repo_id/stars-count: get: - description: Get all the downloaded repo groups. - operationId: Top Insights + description: Stars count. + operationId: Stars Count (Repo) + parameters: + - description: Repository ID. + in: path + name: repo_id + schema: + type: string + type: string responses: '200': description: OK schema: items: properties: - data_collection_date: - description: 'Example: 2019-06-05T13:36:25.000Z' - type: string - data_source: - description: 'Example: git' - type: string - repo_group_id: - description: 'Example: 20' - type: integer - rg_description: - description: 'Example: Rails Ecosystem.' - type: string - rg_last_modified: - description: 'Example: 2019-06-03T15:55:20.000Z' - type: string - rg_name: - description: 'Example: Rails' + repo_name: + description: 'Example: graphiql' type: string - rg_recache: - description: 'Example: 0' + stars: + description: 'Example: 8653' type: integer - rg_type: - description: 'Example: GitHub Organization' - type: string - rg_website: - description: 'Example: ' - type: string - tool_source: - description: 'Example: load' - type: string - tool_version: - description: 'Example: one' - type: string type: array tags: - - utility + - value + + + + #visualization endpoints /contributor_reports/new_contributors_bar/: get: description: Get bar chart of new contributor counts.