diff --git a/docs/api/api_data.js b/docs/api/api_data.js index c88b981927..c3a4f8f9c1 100644 --- a/docs/api/api_data.js +++ b/docs/api/api_data.js @@ -1 +1 @@ -define({ "api": [ { "type": "post", "url": "/batch", "title": "Bus Factor", "description": "
Returns results of batch requests
", "name": "Batch", "group": "Batch_POST_JSON_of_api_requests", "version": "0.0.0", "filename": "../augur/server.py", "groupTitle": "Batch_POST_JSON_of_api_requests" }, { "type": "get", "url": "/:owner/:repo/committer_locations", "title": "Commits and Location by User", "name": "CommitterLocations", "description": "Metric Undefined
", "group": "Diversity_Inclusion", "parameter": { "fields": { "Parameter": [ { "group": "Parameter", "type": "String", "optional": false, "field": "owner", "description": "Username of the owner of the GitHub repository
" }, { "group": "Parameter", "type": "String", "optional": false, "field": "repo", "description": "Name of the GitHub repository
" } ] } }, "success": { "examples": [ { "title": "Success-Response:", "content": "[\n {\n \"login\": \"bonnie\",\n \"location\": \"Rowena, TX\",\n \"commits\": 12\n },\n {\n \"login\":\"clyde\",\n \"location\":\"Ellis County, TX\",\n \"commits\": 12\n }\n]", "type": "json" } ] }, "version": "0.0.0", "filename": "../augur/server.py", "groupTitle": "Diversity_Inclusion" }, { "type": "get", "url": "/:owner/:repo/linking_websites", "title": "Linking Websites", "name": "LinkingWebsites", "description": "Returns an array of websites and their rank according to http://publicwww.com/
", "group": "Experimental", "parameter": { "fields": { "Parameter": [ { "group": "Parameter", "type": "String", "optional": false, "field": "owner", "description": "Username of the owner of the GitHub repository
" }, { "group": "Parameter", "type": "String", "optional": false, "field": "repo", "description": "Name of the GitHub repository
" } ] } }, "success": { "examples": [ { "title": "Success-Response:", "content": "[\n {\n \"url\": \"missouri.edu\",\n \"rank\": \"1\"\n },\n {\n \"url\": \"unomaha.edu\",\n \"rank\": \"2\"\n }\n]", "type": "json" } ] }, "version": "0.0.0", "filename": "../augur/server.py", "groupTitle": "Experimental" }, { "type": "get", "url": "/:owner/:repo/timeseries/commits/comments", "title": "count of commit comments weekly", "name": "CommitComments", "group": "Growth_Maturity_Decline", "description": "", "parameter": { "fields": { "Parameter": [ { "group": "Parameter", "type": "String", "optional": false, "field": "owner", "description": "Username of the owner of the GitHub repository
" }, { "group": "Parameter", "type": "String", "optional": false, "field": "repo", "description": "Name of the GitHub repository
" } ] } }, "success": { "examples": [ { "title": "Success-Response:", "content": "[\n { \"date\":\"2009-02-16T00:00:00.000Z\",\n \"comments\":1.0\n },\n { \"date\":\"2009-07-12T00:00:00.000Z\",\n \"comments\":2.0\n },", "type": "json" } ] }, "version": "0.0.0", "filename": "../augur/server.py", "groupTitle": "Growth_Maturity_Decline" }, { "type": "get", "url": "/:owner/:repo/timeseries/commits?group_by=:group_by", "title": "Commits", "name": "Commits", "group": "Growth_Maturity_Decline", "description": "/github.CHAOSS Metric Definition
", "parameter": { "fields": { "Parameter": [ { "group": "Parameter", "type": "String", "optional": false, "field": "owner", "description": "Username of the owner of the GitHub repository
" }, { "group": "Parameter", "type": "String", "optional": false, "field": "repo", "description": "Name of the GitHub repository
" }, { "group": "Parameter", "type": "String", "optional": false, "field": "group_by", "description": "(Default to week) Allows for results to be grouped by day, week, month, or year
" } ] } }, "success": { "examples": [ { "title": "Success-Response:", "content": "[\n {\n \"date\": \"2015-01-01T00:00:00.000Z\",\n \"commits\": 153\n },\n {\n \"date\": \"2015-01-08T00:00:00.000Z\",\n \"commits\": 192\n }\n]", "type": "json" } ] }, "version": "0.0.0", "filename": "../augur/server.py", "groupTitle": "Growth_Maturity_Decline" }, { "type": "get", "url": "/:owner/:repo/timeseries/community_age", "title": "Timeline of events to determine the age of a community", "name": "CommunityAge", "description": "Metric Undefined
", "group": "Growth_Maturity_Decline", "parameter": { "fields": { "Parameter": [ { "group": "Parameter", "type": "String", "optional": false, "field": "owner", "description": "Username of the owner of the GitHub repository
" }, { "group": "Parameter", "type": "String", "optional": false, "field": "repo", "description": "Name of the GitHub repository
" } ] } }, "success": { "examples": [ { "title": "Success-Response:", "content": "[\n {\n \"login\": \"bonnie\",\n \"location\": \"Rowena, TX\",\n \"commits\": 12\n },\n {\n \"login\":\"clyde\",\n \"location\":\"Ellis County, TX\",\n \"commits\": 12\n }\n]", "type": "json" } ] }, "version": "0.0.0", "filename": "../augur/server.py", "groupTitle": "Growth_Maturity_Decline" }, { "type": "get", "url": "/:owner/:repo/timeseries/community_engagement", "title": "", "name": "Community_Engagement", "group": "Growth_Maturity_Decline", "description": "", "parameter": { "fields": { "Parameter": [ { "group": "Parameter", "type": "String", "optional": false, "field": "owner", "description": "Username of the owner of the GitHub repository
" }, { "group": "Parameter", "type": "String", "optional": false, "field": "repo", "description": "Name of the GitHub repository
" } ] } }, "success": { "examples": [ { "title": "Success-Response:", "content": "[\n {\n \"date\": \"2009-04-01T00:00:00.000Z\",\n \"issues_opened\": 1.0,\n \"issues_closed\": 0.0,\n \"pull_requests_opened\": 0.0,\n \"pull_requests_merged\": 0.0,\n \"pull_requests_closed\": 0.0,\n \"issues_opened_total\": 2.0,\n \"issues_closed_total\": 0.0,\n \"issues_closed_rate_this_window\": 0.0,\n \"issues_closed_rate_total\": 0.0,\n \"issues_delta\": 1.0,\n \"issues_open\": 2.0,\n \"pull_requests_opened_total\": 0.0,\n \"pull_requests_closed_total\": 0.0,\n \"pull_requests_closed_rate_this_window\": null,\n \"pull_requests_closed_rate_total\": null,\n \"pull_requests_delta\": 0.0,\n \"pull_requests_open\": 0.0\n }, \n {\n \"date\": \"2009-04-16T00:00:00.000Z\",\n \"issues_opened\": 2.0,\n \"issues_closed\": 1.0,\n \"pull_requests_opened\": 1.0,\n \"pull_requests_merged\": 1.0,\n \"pull_requests_closed\": 1.0,\n \"issues_opened_total\": 3.0,\n \"issues_closed_total\": 5.0,\n \"issues_closed_rate_this_window\": 4.0,\n \"issues_closed_rate_total\": 6.0,\n \"issues_delta\": 1.0,\n \"issues_open\": 2.0,\n \"pull_requests_opened_total\": 3.0,\n \"pull_requests_closed_total\": 5.0,\n \"pull_requests_closed_rate_this_window\": null,\n \"pull_requests_closed_rate_total\": null,\n \"pull_requests_delta\": 2.0,\n \"pull_requests_open\": 1.0\n } \n]", "type": "json" } ] }, "version": "0.0.0", "filename": "../augur/server.py", "groupTitle": "Growth_Maturity_Decline" }, { "type": "get", "url": "/:owner/:repo/dependents", "title": "List of dependants from libraries.io", "name": "Dependents", "description": "Metric Undefined
", "group": "Growth_Maturity_Decline", "parameter": { "fields": { "Parameter": [ { "group": "Parameter", "type": "String", "optional": false, "field": "owner", "description": "Username of the owner of the GitHub repository
" }, { "group": "Parameter", "type": "String", "optional": false, "field": "repo", "description": "Name of the GitHub repository
" } ] } }, "success": { "examples": [ { "title": "Success-Response:", "content": "[\n {\n \"login\": \"bonnie\",\n \"location\": \"Rowena, TX\",\n \"commits\": 12\n },\n {\n \"login\":\"clyde\",\n \"location\":\"Ellis County, TX\",\n \"commits\": 12\n }\n]", "type": "json" } ] }, "version": "0.0.0", "filename": "../augur/server.py", "groupTitle": "Growth_Maturity_Decline" }, { "type": "get", "url": "/:owner/:repo/timeseries/downloads", "title": "Number of downloads", "description": "Timeseries of downloads from package manager
", "name": "Downloads", "group": "Growth_Maturity_Decline", "parameter": { "fields": { "Parameter": [ { "group": "Parameter", "type": "String", "optional": false, "field": "owner", "description": "Username of the owner of the GitHub repository
" }, { "group": "Parameter", "type": "String", "optional": false, "field": "repo", "description": "Name of the GitHub repository
" } ] } }, "success": { "examples": [ { "title": "Success-Response:", "content": "[\n {\n \"date\": \"2015-01-01T00:00:00.000Z\",\n \"downlads\": 235\n },\n {\n \"date\": \"2015-01-08T00:00:00.000Z\",\n \"dowloads\": 327\n }\n]", "type": "json" } ] }, "version": "0.0.0", "filename": "../augur/server.py", "groupTitle": "Growth_Maturity_Decline" }, { "type": "get", "url": "/:owner/:repo/timeseries/forks?group_by=:group_by", "title": "Forks", "name": "Forks", "group": "Growth_Maturity_Decline", "parameter": { "fields": { "Parameter": [ { "group": "Parameter", "type": "String", "optional": false, "field": "group_by", "description": "(Default to week) Allows for results to be grouped by day, week, month, or year
" }, { "group": "Parameter", "type": "String", "optional": false, "field": "owner", "description": "Username of the owner of the GitHub repository
" }, { "group": "Parameter", "type": "String", "optional": false, "field": "repo", "description": "Name of the GitHub repository
" } ] } }, "description": "", "success": { "examples": [ { "title": "Success-Response:", "content": "[\n {\n \"date\": \"2015-01-01T00:00:00.000Z\",\n \"forks\": 13\n },\n {\n \"date\": \"2015-01-08T00:00:00.000Z\",\n \"forks\": 12\n }\n]", "type": "json" } ] }, "version": "0.0.0", "filename": "../augur/server.py", "groupTitle": "Growth_Maturity_Decline" }, { "type": "get", "url": "/:owner/:repo/timeseries/issues/response_time", "title": "Issue Response Time", "name": "IssueResponseTime", "group": "Growth_Maturity_Decline", "description": "", "parameter": { "fields": { "Parameter": [ { "group": "Parameter", "type": "String", "optional": false, "field": "owner", "description": "Username of the owner of the GitHub repository
" }, { "group": "Parameter", "type": "String", "optional": false, "field": "repo", "description": "Name of the GitHub repository
" } ] } }, "success": { "examples": [ { "title": "Success-Response:", "content": "[\n {\n \"created_at\": \"2013-09-16T17:00:54.000Z\",\n \"responded_at\": \"2013-09-16T17:20:58.000Z\"\n },\n {\n \"created_at\": \"2013-09-16T09:31:34.000Z\",\n \"responded_at\": \"2013-09-16T09:43:03.000Z\"\n }\n]", "type": "json" } ] }, "version": "0.0.0", "filename": "../augur/server.py", "groupTitle": "Growth_Maturity_Decline" }, { "type": "get", "url": "/:owner/:repo/timeseries/issues/activity", "title": "Issues Activity", "name": "Issues", "group": "Growth_Maturity_Decline", "description": "", "parameter": { "fields": { "Parameter": [ { "group": "Parameter", "type": "String", "optional": false, "field": "owner", "description": "Username of the owner of the GitHub repository
" }, { "group": "Parameter", "type": "String", "optional": false, "field": "repo", "description": "Name of the GitHub repository
" } ] } }, "success": { "examples": [ { "title": "Success-Response:", "content": "[\n {\n \"date\": \"2010-12-23T00:00:00.000Z\",\n \"count\": 0.0,\n \"action\": \"closed\"\n },\n {\n \"date\": \"2010-12-23T00:00:00.000Z\",\n \"count\": 2.0,\n \"action\": \"opened\"\n },\n {\n \"date\": \"2010-12-23T00:00:00.000Z\",\n \"count\": 8.0,\n \"action\": \"reopened\"\n },\n {\n \"date\": \"2010-12-23T00:00:00.000Z\",\n \"count\": 12.0,\n \"action\": \"open\"\n }\n]", "type": "json" } ] }, "version": "0.0.0", "filename": "../augur/server.py", "groupTitle": "Growth_Maturity_Decline" }, { "type": "get", "url": "/:owner/:repo/timeseries/issues", "title": "Issues", "name": "Issues", "group": "Growth_Maturity_Decline", "parameter": { "fields": { "Parameter": [ { "group": "Parameter", "type": "String", "optional": false, "field": "group_by", "description": "(Default to week) Allows for results to be grouped by day, week, month, or year
" }, { "group": "Parameter", "type": "String", "optional": false, "field": "owner", "description": "Username of the owner of the GitHub repository
" }, { "group": "Parameter", "type": "String", "optional": false, "field": "repo", "description": "Name of the GitHub repository
" } ] } }, "description": "", "success": { "examples": [ { "title": "Success-Response:", "content": "[\n {\n \"date\": \"2015-01-01T00:00:00.000Z\",\n \"issues\":13\n },\n {\n \"date\": \"2015-01-08T00:00:00.000Z\",\n \"issues\":15\n }\n]", "type": "json" } ] }, "version": "0.0.0", "filename": "../augur/server.py", "groupTitle": "Growth_Maturity_Decline" }, { "type": "get", "url": "/:owner/:repo/issue_comment_time", "title": "", "name": "Issues", "group": "Growth_Maturity_Decline", "description": "", "parameter": { "fields": { "Parameter": [ { "group": "Parameter", "type": "String", "optional": false, "field": "owner", "description": "Username of the owner of the GitHub repository
" }, { "group": "Parameter", "type": "String", "optional": false, "field": "repo", "description": "Name of the GitHub repository
" } ] } }, "success": { "examples": [ { "title": "Success-Response:", "content": "[\n {\n \"id\": 2,\n \"opened\": \"2012-01-19T05:24:55.000Z\",\n \"first_commented\": \"2012-01-19T05:30:13.000Z\",\n \"pull_request\": 0,\n \"minutes_to_comment\": 5.0\n },\n {\n \"id\": 3,\n \"opened\": \"2012-01-26T15:07:56.000Z\",\n \"first_commented\": \"2012-01-26T15:09:28.000Z\",\n \"pull_request\": 0,\n \"minutes_to_comment\": 1.0\n }\n]", "type": "json" } ] }, "version": "0.0.0", "filename": "../augur/server.py", "groupTitle": "Growth_Maturity_Decline" }, { "type": "get", "url": "/:owner/:repo/issue_close_time", "title": "Issue Close Time", "name": "Issues", "group": "Growth_Maturity_Decline", "description": "", "parameter": { "fields": { "Parameter": [ { "group": "Parameter", "type": "String", "optional": false, "field": "owner", "description": "Username of the owner of the GitHub repository
" }, { "group": "Parameter", "type": "String", "optional": false, "field": "repo", "description": "Name of the GitHub repository
" } ] } }, "success": { "examples": [ { "title": "Success-Response:", "content": "[\n {\n \"id\": 136603,\n \"repo_id\": 1334,\n \"opened\": \"2010-09-08 19:09:56\",\n \"pull_request\": 1,\n \"minutes_to_close\": 1264.0,\n \"average_minutes_to_close_as_of_close\": 1264.0,\n \"average_minutes_to_close_past_30_days\": 1264.0,\n \"z-score\": -0.3152279792\n },\n {\n \"id\": 136602,\n \"repo_id\": 1334,\n \"opened\": \"2010-09-09 04:33:23\",\n \"pull_request\": 1,\n \"minutes_to_close\": 701.0,\n \"average_minutes_to_close_as_of_close\": 982.5,\n \"average_minutes_to_close_past_30_days\": 982.5,\n \"z-score\": -0.3184596776\n }\n]", "type": "json" } ] }, "version": "0.0.0", "filename": "../augur/server.py", "groupTitle": "Growth_Maturity_Decline" }, { "type": "get", "url": "/:owner/:repo/timeseries/issues/closed", "title": "Issues Closed", "name": "Issues", "group": "Growth_Maturity_Decline", "parameter": { "fields": { "Parameter": [ { "group": "Parameter", "type": "String", "optional": false, "field": "owner", "description": "Username of the owner of the GitHub repository
" }, { "group": "Parameter", "type": "String", "optional": false, "field": "repo", "description": "Name of the GitHub repository
" } ] } }, "success": { "examples": [ { "title": "Success-Response:", "content": "[\n {\n \"date\": \"2011-03-19T00:00:00.000Z\",\n \"issues_closed\": 3\n },\n {\n \"date\": \"2011-03-20T00:00:00.000Z\",\n \"issues_closed\": 0\n }\n]", "type": "json" } ] }, "version": "0.0.0", "filename": "../augur/server.py", "groupTitle": "Growth_Maturity_Decline" }, { "type": "get", "url": "/:owner/:repo/timeseries/lines_changed", "title": "Net number of lines of code changed", "description": "", "name": "LinesChanged", "group": "Growth_Maturity_Decline", "parameter": { "fields": { "Parameter": [ { "group": "Parameter", "type": "String", "optional": false, "field": "owner", "description": "Username of the owner of the GitHub repository
" }, { "group": "Parameter", "type": "String", "optional": false, "field": "repo", "description": "Name of the GitHub repository
" } ] } }, "success": { "examples": [ { "title": "Success-Response:", "content": "[\n {\n 'date': '2015-11-01T00:00:00Z', \n 'lines_changed': 396137.0\n },\n {\n 'date': '2015-11-08T00:00:00Z', \n 'lines_changed': 3896.0\n },\n]", "type": "json" } ] }, "version": "0.0.0", "filename": "../augur/server.py", "groupTitle": "Growth_Maturity_Decline" }, { "type": "get", "url": "/:owner/:repo/timeseries/tags/major", "title": "Tags for major releases timeseries", "description": "Metric Undefined
", "name": "Major_Release_Tags", "group": "Growth_Maturity_Decline", "parameter": { "fields": { "Parameter": [ { "group": "Parameter", "type": "String", "optional": false, "field": "owner", "description": "Username of the owner of the GitHub repository
" }, { "group": "Parameter", "type": "String", "optional": false, "field": "repo", "description": "Name of the GitHub repository
" } ] } }, "success": { "examples": [ { "title": "Success-Response:", "content": "[\n {\n \"date\": \"2015-01-01T00:00:00.000Z\",\n \"release\": 1.0.0\n },\n {\n \"date\": \"2015-01-08T00:00:00.000Z\",\n \"release\": 2.0.0\n }\n]", "type": "json" } ] }, "version": "0.0.0", "filename": "../augur/server.py", "groupTitle": "Growth_Maturity_Decline" }, { "type": "get", "url": "/:owner/:repo/timeseries/pulls/acceptance_rate", "title": "Pull Request Acceptance Rate by Week", "description": "", "name": "PullRequestAcceptanceRate", "group": "Growth_Maturity_Decline", "parameter": { "fields": { "Parameter": [ { "group": "Parameter", "type": "String", "optional": false, "field": "owner", "description": "Username of the owner of the GitHub repository
" }, { "group": "Parameter", "type": "String", "optional": false, "field": "repo", "description": "Name of the GitHub repository
" } ] } }, "success": { "examples": [ { "title": "Success-Response:", "content": "[\n {\n \"date\": \"2015-01-01T00:00:00.000Z\",\n \"rate\": 0.5\n },\n {\n \"date\": \"2015-01-08T00:00:00.000Z\",\n \"rate\": 0.33\n }\n]", "type": "json" } ] }, "version": "0.0.0", "filename": "../augur/server.py", "groupTitle": "Growth_Maturity_Decline" }, { "type": "get", "url": "/:owner/:repo/timeseries/pull_request_comments", "title": "count of new pull request comments weekly", "name": "PullRequestComments", "group": "Growth_Maturity_Decline", "description": "", "parameter": { "fields": { "Parameter": [ { "group": "Parameter", "type": "String", "optional": false, "field": "owner", "description": "Username of the owner of the GitHub repository
" }, { "group": "Parameter", "type": "String", "optional": false, "field": "repo", "description": "Name of the GitHub repository
" } ] } }, "success": { "examples": [ { "title": "Success-Response:", "content": "[\n { \"date\":\"2009-02-16T00:00:00.000Z\",\n \"comments\":1.0\n },\n { \"date\":\"2009-07-12T00:00:00.000Z\",\n \"comments\":2.0\n },", "type": "json" } ] }, "version": "0.0.0", "filename": "../augur/server.py", "groupTitle": "Growth_Maturity_Decline" }, { "type": "get", "url": "/:owner/:repo/timeseries/pulls", "title": "Pull Requests by Week", "name": "PullRequestsByWeek", "group": "Growth_Maturity_Decline", "description": "", "parameter": { "fields": { "Parameter": [ { "group": "Parameter", "type": "String", "optional": false, "field": "owner", "description": "Username of the owner of the GitHub repository
" }, { "group": "Parameter", "type": "String", "optional": false, "field": "repo", "description": "Name of the GitHub repository
" } ] } }, "success": { "examples": [ { "title": "Success-Response:", "content": "[\n {\n \"date\": \"2015-01-01T00:00:00.000Z\",\n \"pull_requests\": 1\n \"comments\": 11\n },\n {\n \"date\": \"2015-01-08T00:00:00.000Z\",\n \"pull_requests\": 2\n \"comments\": 31\n }\n]", "type": "json" } ] }, "version": "0.0.0", "filename": "../augur/server.py", "groupTitle": "Growth_Maturity_Decline" }, { "type": "get", "url": "/:owner/:repo/timeseries/stargazers?group_by=:group_by", "title": "Stargazers", "name": "Stargazers", "group": "Growth_Maturity_Decline", "description": "Metric Undefined
", "parameter": { "fields": { "Parameter": [ { "group": "Parameter", "type": "String", "optional": false, "field": "owner", "description": "Username of the owner of the GitHub repository
" }, { "group": "Parameter", "type": "String", "optional": false, "field": "repo", "description": "Name of the GitHub repository
" }, { "group": "Parameter", "type": "String", "optional": false, "field": "group_by", "description": "(Default to week) Allows for results to be grouped by day, week, month, or year
" } ] } }, "success": { "examples": [ { "title": "Success-Response:", "content": "[\n {\n \"date\": \"2015-01-01T00:00:00.000Z\",\n \"watchers\": 133\n },\n {\n \"date\": \"2015-01-08T00:00:00.000Z\",\n \"watchers\": 54\n }\n]", "type": "json" } ] }, "version": "0.0.0", "filename": "../augur/server.py", "groupTitle": "Growth_Maturity_Decline" }, { "type": "get", "url": "/:owner/:repo/timeseries/tags", "title": "Tags release timeseries", "description": "Metric Undefined
", "name": "Tags", "group": "Growth_Maturity_Decline", "parameter": { "fields": { "Parameter": [ { "group": "Parameter", "type": "String", "optional": false, "field": "owner", "description": "Username of the owner of the GitHub repository
" }, { "group": "Parameter", "type": "String", "optional": false, "field": "repo", "description": "Name of the GitHub repository
" } ] } }, "success": { "examples": [ { "title": "Success-Response:", "content": "[\n {\n \"date\": \"2015-01-01T00:00:00.000Z\",\n \"release\": 0.5\n },\n {\n \"date\": \"2015-01-08T00:00:00.000Z\",\n \"release\": 0.5.1\n }\n]", "type": "json" } ] }, "version": "0.0.0", "filename": "../augur/server.py", "groupTitle": "Growth_Maturity_Decline" }, { "type": "get", "url": "/:owner/:repo/pulls/maintainer_response_time", "title": "Time to First Maintainer Response to Merge Request", "description": "", "name": "TimeToFirstMaintainerResponseToMergeRequest", "group": "Growth_Maturity_Decline", "parameter": { "fields": { "Parameter": [ { "group": "Parameter", "type": "String", "optional": false, "field": "owner", "description": "Username of the owner of the GitHub repository
" }, { "group": "Parameter", "type": "String", "optional": false, "field": "repo", "description": "Name of the GitHub repository
" } ] } }, "success": { "examples": [ { "title": "Success-Response:", "content": "[\n {\n \"response_time\":11044366.0\n },\n {\n \"response_time\":11044955.0\n },\n]", "type": "json" } ] }, "version": "0.0.0", "filename": "../augur/server.py", "groupTitle": "Growth_Maturity_Decline" }, { "type": "get", "url": "/:owner/:repo/contributors", "title": "Total Contributions by User", "name": "TotalContributions", "description": "", "group": "Growth_Maturity_Decline", "parameter": { "fields": { "Parameter": [ { "group": "Parameter", "type": "String", "optional": false, "field": "owner", "description": "Username of the owner of the GitHub repository
" }, { "group": "Parameter", "type": "String", "optional": false, "field": "repo", "description": "Name of the GitHub repository
" } ] } }, "success": { "examples": [ { "title": "Success-Response:", "content": "[\n {\n \"login\": \"foo\",\n \"location\": \"Springfield\",\n \"commits\": 1337.0,\n \"pull_requests\": 60.0,\n \"issues\": null,\n \"commit_comments\": 158.0,\n \"pull_request_comments\": 718.0,\n \"issue_comments\": 1668.0\n },\n {\n \"login\": \"bar\",\n \"location\": null,\n \"commits\": 3968.0,\n \"pull_requests\": null,\n \"issues\": 12.0,\n \"commit_comments\": 158.0,\n \"pull_request_comments\": 718.0,\n \"issue_comments\": 1568.0\n }\n ]", "type": "json" } ] }, "version": "0.0.0", "filename": "../augur/server.py", "groupTitle": "Growth_Maturity_Decline" }, { "type": "get", "url": "/:owner/:repo/timeseries/total_committers", "title": "count of new committers weekly", "name": "UniqueCommitters", "description": "Metric Undefined
", "group": "Growth_Maturity_Decline", "parameter": { "fields": { "Parameter": [ { "group": "Parameter", "type": "String", "optional": false, "field": "owner", "description": "Username of the owner of the GitHub repository
" }, { "group": "Parameter", "type": "String", "optional": false, "field": "repo", "description": "Name of the GitHub repository
" } ] } }, "success": { "examples": [ { "title": "Success-Response:", "content": "[\n { \"date\":\"2009-02-16T00:00:00.000Z\",\n \"total_total_committers\":1.0\n },\n { \"date\":\"2009-07-12T00:00:00.000Z\",\n \"total_total_committers\":2.0\n },\n]", "type": "json" } ] }, "version": "0.0.0", "filename": "../augur/server.py", "groupTitle": "Growth_Maturity_Decline" }, { "type": "get", "url": "/:owner/:repo/timeseries/issue_comments", "title": "Count of New Comments", "name": "uniqueCommenters", "group": "Growth_Maturity_Decline", "description": "", "parameter": { "fields": { "Parameter": [ { "group": "Parameter", "type": "String", "optional": false, "field": "owner", "description": "Username of the owner of the GitHub repository
" }, { "group": "Parameter", "type": "String", "optional": false, "field": "repo", "description": "Name of the GitHub repository
" } ] } }, "success": { "examples": [ { "title": "Success-Response:", "content": "[\n { \"date\":\"2009-02-16T00:00:00.000Z\",\n \"total_unique_comments\":1.0\n },\n { \"date\":\"2009-07-12T00:00:00.000Z\",\n \"total_unique_comments\":2.0\n },\n]", "type": "json" } ] }, "version": "0.0.0", "filename": "../augur/server.py", "groupTitle": "Growth_Maturity_Decline" }, { "type": "get", "url": "/:owner/:repo/dependencies", "title": "List of dependencies from libraries.io", "name": "Dependencies", "description": "Metric Undefined
", "group": "Risk", "parameter": { "fields": { "Parameter": [ { "group": "Parameter", "type": "String", "optional": false, "field": "owner", "description": "Username of the owner of the GitHub repository
" }, { "group": "Parameter", "type": "String", "optional": false, "field": "repo", "description": "Name of the GitHub repository
" } ] } }, "success": { "examples": [ { "title": "Success-Response:", "content": "[\n { \"full_name\": \"rails/rails\"\n \"description\": \"Ruby on Rails\", \n \"fork\": false, \"created_at\": \"2008-04-11T02:19:47.000Z\", \n \"updated_at\": \"2017-09-20T20:16:47.181Z\", \n \"pushed_at\": \"2017-09-20T19:39:08.000Z\", \n \"homepage\": \"http://rubyonrails.org\", \n \"size\": 155199, \"stargazers_count\": 36993, \n \"language\": \"Ruby\", \"has_issues\": true, \n \"has_wiki\": false, \n \"has_pages\": false, \n \"forks_count\": 15130, \n \"mirror_url\": null, \n \"open_issues_count\": 1157, \n \"default_branch\": \"master\", \n \"subscribers_count\": 2452,\n \"uuid\": \"8514\", \"source_name\": null, \n \"license\": \"MIT\", \"private\": false, \n \"contributions_count\": 2616, \n \"has_readme\": \"README.md\", \n \"has_changelog\": null, \n \"has_contributing\": \"CONTRIBUTING.md\", \n \"has_license\": \"MIT-LICENSE\", \n \"has_coc\": \"CODE_OF_CONDUCT.md\", \n \"has_threat_model\": null, \n \"has_audit\": null, \n \"status\": null, \n \"last_synced_at\": \"2017-09-20T20:16:47.153Z\", \n \"rank\": 28, \"host_type\": \"GitHub\", \n \"host_domain\": null, \n \"name\": null, \n \"scm\": \"git\", \n \"fork_policy\": null,\n \"github_id\": \"8514\", \n \"pull_requests_enabled\": null, \n \"logo_url\": null, \n \"github_contributions_count\": 2616, \n \"keywords\": [\"activejob\", \"activerecord\", \"html\", \"mvc\", \"rails\", \"ruby\"], \n \"dependencies\": [\n { \"project_name\": \"websocket-driver\", \n \"name\": \"websocket-driver\", \n \"platform\": \"rubygems\", \n \"requirements\": \"~> 0.6.1\", \n \"latest_stable\": \"0.7.0\", \n \"latest\": \"0.7.0\", \n \"deprecated\": false, \"outdated\": true, \n \"filepath\": \"actioncable/actioncable.gemspec\", \"\n kind\": \"runtime\"\n }\n ]", "type": "json" } ] }, "version": "0.0.0", "filename": "../augur/server.py", "groupTitle": "Risk" }, { "type": "get", "url": "/:owner/:repo/dependency_stats", "title": "List of libraries.io stats", "name": "DependencyStats", "group": "Risk", "parameter": { "fields": { "Parameter": [ { "group": "Parameter", "type": "String", "optional": false, "field": "owner", "description": "Username of the owner of the GitHub repository
" }, { "group": "Parameter", "type": "String", "optional": false, "field": "repo", "description": "Name of the GitHub repository
" } ] } }, "success": { "examples": [ { "title": "Success-Response:", "content": "[\n {\n \"dependencies\": \"10\", \n \"dependent_projects\": \"10.6K\", \n \"dependent_repositories\": \"392K\"\n }\n]", "type": "json" } ] }, "version": "0.0.0", "filename": "../augur/server.py", "groupTitle": "Risk" }, { "type": "get", "url": "/:owner/:repo/bus_factor", "title": "Bus Factor", "name": "GitHub", "description": "Returns an integer that is the number of developers that have a summed percentage of contributions higher than the threshold
", "group": "Risk", "parameter": { "fields": { "Parameter": [ { "group": "Parameter", "type": "String", "optional": false, "field": "owner", "description": "Username of the owner of the GitHub repository
" }, { "group": "Parameter", "type": "String", "optional": false, "field": "repo", "description": "Name of the GitHub repository
" } ] } }, "success": { "examples": [ { "title": "Success-Response:", "content": "[\n {\n \"best\": \"5\",\n \"worst\": \"1\"\n }\n]", "type": "json" } ] }, "version": "0.0.0", "filename": "../augur/server.py", "groupTitle": "Risk" }, { "type": "get", "url": "/:owner/:repo/watchers", "title": "", "name": "Community_Engagement", "group": "Users", "parameter": { "fields": { "Parameter": [ { "group": "Parameter", "type": "String", "optional": false, "field": "owner", "description": "Username of the owner of the GitHub repository
" }, { "group": "Parameter", "type": "String", "optional": false, "field": "repo", "description": "Name of the GitHub repository
" } ] } }, "success": { "examples": [ { "title": "Success-Response:", "content": "[\n {\n \"watchers\": 40349\n }\n]", "type": "json" } ] }, "version": "0.0.0", "filename": "../augur/server.py", "groupTitle": "Users" }, { "type": "get", "url": "/ghtorrent_range", "title": "Range of dates covered by GHTorrent", "name": "GhtorrentRange", "group": "Utility", "version": "0.0.0", "filename": "../augur/server.py", "groupTitle": "Utility" }, { "type": "get", "url": "/", "title": "API Status", "name": "Status", "group": "Utility", "version": "0.0.0", "filename": "../augur/server.py", "groupTitle": "Utility" }, { "type": "get", "url": "/:owner/:repo/timeseries/contributions", "title": "Contributions by Week", "name": "ContributionsByWeek", "parameter": { "fields": { "Parameter": [ { "group": "Parameter", "type": "String", "optional": false, "field": "owner", "description": "Username of the owner of the GitHub repository
" }, { "group": "Parameter", "type": "String", "optional": false, "field": "repo", "description": "Name of the GitHub repository
" } ], "String": [ { "group": "String", "optional": false, "field": "user", "description": "Limit results to the given user's contributions
" } ] } }, "success": { "examples": [ { "title": "Success-Response:", "content": "[\n {\n \"date\": \"2015-01-01T00:00:00.000Z\",\n \"commits\": 37.0,\n \"pull_requests\": null,\n \"issues\": null,\n \"commit_comments\": 7.0,\n \"pull_request_comments\": 8.0,\n \"issue_comments\": 17.0\n },\n {\n \"date\": \"2015-01-08T00:00:00.000Z\",\n \"commits\": 68.0,\n \"pull_requests\": null,\n \"issues\": 12.0,\n \"commit_comments\": 18.0,\n \"pull_request_comments\": 13.0,\n \"issue_comments\": 28.0\n }\n ]", "type": "json" } ] }, "version": "0.0.0", "filename": "../augur/server.py", "group": "_Users_howderek_Projects_Python_augur_augur_server_py", "groupTitle": "_Users_howderek_Projects_Python_augur_augur_server_py" } ] }); +define({ "api": [ { "type": "get", "url": "/:owner/:repo/bus_factor", "title": "Bus Factor", "name": "GitHub", "description": "Returns an integer that is the number of developers that have a summed percentage of contributions higher than the threshold
", "group": "Activity", "parameter": { "fields": { "Parameter": [ { "group": "Parameter", "type": "String", "optional": false, "field": "owner", "description": "Username of the owner of the GitHub repository
" }, { "group": "Parameter", "type": "String", "optional": false, "field": "repo", "description": "Name of the GitHub repository
" } ] } }, "success": { "examples": [ { "title": "Success-Response:", "content": "[\n {\n \"best\": \"5\",\n \"worst\": \"1\"\n }\n]", "type": "json" } ] }, "version": "0.0.0", "filename": "../augur/server.py", "groupTitle": "Activity" }, { "type": "get", "url": "/:owner/:repo/timeseries/issue_comments", "title": "Count of New Comments", "name": "uniqueCommenters", "group": "Activity", "description": "", "parameter": { "fields": { "Parameter": [ { "group": "Parameter", "type": "String", "optional": false, "field": "owner", "description": "Username of the owner of the GitHub repository
" }, { "group": "Parameter", "type": "String", "optional": false, "field": "repo", "description": "Name of the GitHub repository
" } ] } }, "success": { "examples": [ { "title": "Success-Response:", "content": "[\n { \"date\":\"2009-02-16T00:00:00.000Z\",\n \"total_unique_comments\":1.0\n },\n { \"date\":\"2009-07-12T00:00:00.000Z\",\n \"total_unique_comments\":2.0\n },\n]", "type": "json" } ] }, "version": "0.0.0", "filename": "../augur/server.py", "groupTitle": "Activity" }, { "type": "post", "url": "/batch", "title": "Bus Factor", "description": "Returns results of batch requests
", "name": "Batch", "group": "Batch_POST_JSON_of_api_requests", "version": "0.0.0", "filename": "../augur/server.py", "groupTitle": "Batch_POST_JSON_of_api_requests" }, { "type": "get", "url": "/:owner/:repo/committer_locations", "title": "Commits and Location by User", "name": "CommitterLocations", "description": "Metric Undefined
", "group": "Diversity_Inclusion", "parameter": { "fields": { "Parameter": [ { "group": "Parameter", "type": "String", "optional": false, "field": "owner", "description": "Username of the owner of the GitHub repository
" }, { "group": "Parameter", "type": "String", "optional": false, "field": "repo", "description": "Name of the GitHub repository
" } ] } }, "success": { "examples": [ { "title": "Success-Response:", "content": "[\n {\n \"login\": \"bonnie\",\n \"location\": \"Rowena, TX\",\n \"commits\": 12\n },\n {\n \"login\":\"clyde\",\n \"location\":\"Ellis County, TX\",\n \"commits\": 12\n }\n]", "type": "json" } ] }, "version": "0.0.0", "filename": "../augur/server.py", "groupTitle": "Diversity_Inclusion" }, { "type": "get", "url": "/:owner/:repo/timeseries/commits/comments", "title": "count of commit comments weekly", "name": "CommitComments", "group": "Experimental", "description": "", "parameter": { "fields": { "Parameter": [ { "group": "Parameter", "type": "String", "optional": false, "field": "owner", "description": "Username of the owner of the GitHub repository
" }, { "group": "Parameter", "type": "String", "optional": false, "field": "repo", "description": "Name of the GitHub repository
" } ] } }, "success": { "examples": [ { "title": "Success-Response:", "content": "[\n { \"date\":\"2009-02-16T00:00:00.000Z\",\n \"comments\":1.0\n },\n { \"date\":\"2009-07-12T00:00:00.000Z\",\n \"comments\":2.0\n },", "type": "json" } ] }, "version": "0.0.0", "filename": "../augur/server.py", "groupTitle": "Experimental" }, { "type": "get", "url": "/:owner/:repo/timeseries/community_age", "title": "Timeline of events to determine the age of a community", "name": "CommunityAge", "description": "Metric Undefined
", "group": "Experimental", "parameter": { "fields": { "Parameter": [ { "group": "Parameter", "type": "String", "optional": false, "field": "owner", "description": "Username of the owner of the GitHub repository
" }, { "group": "Parameter", "type": "String", "optional": false, "field": "repo", "description": "Name of the GitHub repository
" } ] } }, "success": { "examples": [ { "title": "Success-Response:", "content": "[\n {\n \"login\": \"bonnie\",\n \"location\": \"Rowena, TX\",\n \"commits\": 12\n },\n {\n \"login\":\"clyde\",\n \"location\":\"Ellis County, TX\",\n \"commits\": 12\n }\n]", "type": "json" } ] }, "version": "0.0.0", "filename": "../augur/server.py", "groupTitle": "Experimental" }, { "type": "get", "url": "/:owner/:repo/timeseries/community_engagement", "title": "", "name": "Community_Engagement", "group": "Experimental", "description": "", "parameter": { "fields": { "Parameter": [ { "group": "Parameter", "type": "String", "optional": false, "field": "owner", "description": "Username of the owner of the GitHub repository
" }, { "group": "Parameter", "type": "String", "optional": false, "field": "repo", "description": "Name of the GitHub repository
" } ] } }, "success": { "examples": [ { "title": "Success-Response:", "content": "[\n {\n \"date\": \"2009-04-01T00:00:00.000Z\",\n \"issues_opened\": 1.0,\n \"issues_closed\": 0.0,\n \"pull_requests_opened\": 0.0,\n \"pull_requests_merged\": 0.0,\n \"pull_requests_closed\": 0.0,\n \"issues_opened_total\": 2.0,\n \"issues_closed_total\": 0.0,\n \"issues_closed_rate_this_window\": 0.0,\n \"issues_closed_rate_total\": 0.0,\n \"issues_delta\": 1.0,\n \"issues_open\": 2.0,\n \"pull_requests_opened_total\": 0.0,\n \"pull_requests_closed_total\": 0.0,\n \"pull_requests_closed_rate_this_window\": null,\n \"pull_requests_closed_rate_total\": null,\n \"pull_requests_delta\": 0.0,\n \"pull_requests_open\": 0.0\n },\n {\n \"date\": \"2009-04-16T00:00:00.000Z\",\n \"issues_opened\": 2.0,\n \"issues_closed\": 1.0,\n \"pull_requests_opened\": 1.0,\n \"pull_requests_merged\": 1.0,\n \"pull_requests_closed\": 1.0,\n \"issues_opened_total\": 3.0,\n \"issues_closed_total\": 5.0,\n \"issues_closed_rate_this_window\": 4.0,\n \"issues_closed_rate_total\": 6.0,\n \"issues_delta\": 1.0,\n \"issues_open\": 2.0,\n \"pull_requests_opened_total\": 3.0,\n \"pull_requests_closed_total\": 5.0,\n \"pull_requests_closed_rate_this_window\": null,\n \"pull_requests_closed_rate_total\": null,\n \"pull_requests_delta\": 2.0,\n \"pull_requests_open\": 1.0\n }\n]", "type": "json" } ] }, "version": "0.0.0", "filename": "../augur/server.py", "groupTitle": "Experimental" }, { "type": "get", "url": "/:owner/:repo/dependents", "title": "List of dependants from libraries.io", "name": "Dependents", "description": "Metric Undefined
", "group": "Experimental", "parameter": { "fields": { "Parameter": [ { "group": "Parameter", "type": "String", "optional": false, "field": "owner", "description": "Username of the owner of the GitHub repository
" }, { "group": "Parameter", "type": "String", "optional": false, "field": "repo", "description": "Name of the GitHub repository
" } ] } }, "success": { "examples": [ { "title": "Success-Response:", "content": "[\n {\n \"login\": \"bonnie\",\n \"location\": \"Rowena, TX\",\n \"commits\": 12\n },\n {\n \"login\":\"clyde\",\n \"location\":\"Ellis County, TX\",\n \"commits\": 12\n }\n]", "type": "json" } ] }, "version": "0.0.0", "filename": "../augur/server.py", "groupTitle": "Experimental" }, { "type": "get", "url": "/:owner/:repo/timeseries/downloads", "title": "Number of downloads", "description": "Timeseries of downloads from package manager
", "name": "Downloads", "group": "Experimental", "parameter": { "fields": { "Parameter": [ { "group": "Parameter", "type": "String", "optional": false, "field": "owner", "description": "Username of the owner of the GitHub repository
" }, { "group": "Parameter", "type": "String", "optional": false, "field": "repo", "description": "Name of the GitHub repository
" } ] } }, "success": { "examples": [ { "title": "Success-Response:", "content": "[\n {\n \"date\": \"2015-01-01T00:00:00.000Z\",\n \"downlads\": 235\n },\n {\n \"date\": \"2015-01-08T00:00:00.000Z\",\n \"dowloads\": 327\n }\n]", "type": "json" } ] }, "version": "0.0.0", "filename": "../augur/server.py", "groupTitle": "Experimental" }, { "type": "get", "url": "/:owner/:repo/issue_close_time", "title": "Issue Close Time", "name": "Issues", "group": "Experimental", "description": "", "parameter": { "fields": { "Parameter": [ { "group": "Parameter", "type": "String", "optional": false, "field": "owner", "description": "Username of the owner of the GitHub repository
" }, { "group": "Parameter", "type": "String", "optional": false, "field": "repo", "description": "Name of the GitHub repository
" } ] } }, "success": { "examples": [ { "title": "Success-Response:", "content": "[\n {\n \"id\": 136603,\n \"repo_id\": 1334,\n \"opened\": \"2010-09-08 19:09:56\",\n \"pull_request\": 1,\n \"minutes_to_close\": 1264.0,\n \"average_minutes_to_close_as_of_close\": 1264.0,\n \"average_minutes_to_close_past_30_days\": 1264.0,\n \"z-score\": -0.3152279792\n },\n {\n \"id\": 136602,\n \"repo_id\": 1334,\n \"opened\": \"2010-09-09 04:33:23\",\n \"pull_request\": 1,\n \"minutes_to_close\": 701.0,\n \"average_minutes_to_close_as_of_close\": 982.5,\n \"average_minutes_to_close_past_30_days\": 982.5,\n \"z-score\": -0.3184596776\n }\n]", "type": "json" } ] }, "version": "0.0.0", "filename": "../augur/server.py", "groupTitle": "Experimental" }, { "type": "get", "url": "/:owner/:repo/timeseries/issues/activity", "title": "Issues Activity", "name": "Issues", "group": "Experimental", "description": "", "parameter": { "fields": { "Parameter": [ { "group": "Parameter", "type": "String", "optional": false, "field": "owner", "description": "Username of the owner of the GitHub repository
" }, { "group": "Parameter", "type": "String", "optional": false, "field": "repo", "description": "Name of the GitHub repository
" } ] } }, "success": { "examples": [ { "title": "Success-Response:", "content": "[\n {\n \"date\": \"2010-12-23T00:00:00.000Z\",\n \"count\": 0.0,\n \"action\": \"closed\"\n },\n {\n \"date\": \"2010-12-23T00:00:00.000Z\",\n \"count\": 2.0,\n \"action\": \"opened\"\n },\n {\n \"date\": \"2010-12-23T00:00:00.000Z\",\n \"count\": 8.0,\n \"action\": \"reopened\"\n },\n {\n \"date\": \"2010-12-23T00:00:00.000Z\",\n \"count\": 12.0,\n \"action\": \"open\"\n }\n]", "type": "json" } ] }, "version": "0.0.0", "filename": "../augur/server.py", "groupTitle": "Experimental" }, { "type": "get", "url": "/:owner/:repo/timeseries/lines_changed", "title": "Net number of lines of code changed", "description": "", "name": "LinesChanged", "group": "Experimental", "parameter": { "fields": { "Parameter": [ { "group": "Parameter", "type": "String", "optional": false, "field": "owner", "description": "Username of the owner of the GitHub repository
" }, { "group": "Parameter", "type": "String", "optional": false, "field": "repo", "description": "Name of the GitHub repository
" } ] } }, "success": { "examples": [ { "title": "Success-Response:", "content": "[\n {\n 'date': '2015-11-01T00:00:00Z',\n 'lines_changed': 396137.0\n },\n {\n 'date': '2015-11-08T00:00:00Z',\n 'lines_changed': 3896.0\n },\n]", "type": "json" } ] }, "version": "0.0.0", "filename": "../augur/server.py", "groupTitle": "Experimental" }, { "type": "get", "url": "/:owner/:repo/linking_websites", "title": "Linking Websites", "name": "LinkingWebsites", "description": "Returns an array of websites and their rank according to http://publicwww.com/
", "group": "Experimental", "parameter": { "fields": { "Parameter": [ { "group": "Parameter", "type": "String", "optional": false, "field": "owner", "description": "Username of the owner of the GitHub repository
" }, { "group": "Parameter", "type": "String", "optional": false, "field": "repo", "description": "Name of the GitHub repository
" } ] } }, "success": { "examples": [ { "title": "Success-Response:", "content": "[\n {\n \"url\": \"missouri.edu\",\n \"rank\": \"1\"\n },\n {\n \"url\": \"unomaha.edu\",\n \"rank\": \"2\"\n }\n]", "type": "json" } ] }, "version": "0.0.0", "filename": "../augur/server.py", "groupTitle": "Experimental" }, { "type": "get", "url": "/:owner/:repo/timeseries/tags/major", "title": "Tags for major releases timeseries", "description": "Metric Undefined
", "name": "Major_Release_Tags", "group": "Experimental", "parameter": { "fields": { "Parameter": [ { "group": "Parameter", "type": "String", "optional": false, "field": "owner", "description": "Username of the owner of the GitHub repository
" }, { "group": "Parameter", "type": "String", "optional": false, "field": "repo", "description": "Name of the GitHub repository
" } ] } }, "success": { "examples": [ { "title": "Success-Response:", "content": "[\n {\n \"date\": \"2015-01-01T00:00:00.000Z\",\n \"release\": 1.0.0\n },\n {\n \"date\": \"2015-01-08T00:00:00.000Z\",\n \"release\": 2.0.0\n }\n]", "type": "json" } ] }, "version": "0.0.0", "filename": "../augur/server.py", "groupTitle": "Experimental" }, { "type": "get", "url": "/:owner/:repo/timeseries/pulls/acceptance_rate", "title": "Pull Request Acceptance Rate by Week", "description": "", "name": "PullRequestAcceptanceRate", "group": "Experimental", "parameter": { "fields": { "Parameter": [ { "group": "Parameter", "type": "String", "optional": false, "field": "owner", "description": "Username of the owner of the GitHub repository
" }, { "group": "Parameter", "type": "String", "optional": false, "field": "repo", "description": "Name of the GitHub repository
" } ] } }, "success": { "examples": [ { "title": "Success-Response:", "content": "[\n {\n \"date\": \"2015-01-01T00:00:00.000Z\",\n \"rate\": 0.5\n },\n {\n \"date\": \"2015-01-08T00:00:00.000Z\",\n \"rate\": 0.33\n }\n]", "type": "json" } ] }, "version": "0.0.0", "filename": "../augur/server.py", "groupTitle": "Experimental" }, { "type": "get", "url": "/:owner/:repo/timeseries/tags", "title": "Tags release timeseries", "description": "Metric Undefined
", "name": "Tags", "group": "Experimental", "parameter": { "fields": { "Parameter": [ { "group": "Parameter", "type": "String", "optional": false, "field": "owner", "description": "Username of the owner of the GitHub repository
" }, { "group": "Parameter", "type": "String", "optional": false, "field": "repo", "description": "Name of the GitHub repository
" } ] } }, "success": { "examples": [ { "title": "Success-Response:", "content": "[\n {\n \"date\": \"2015-01-01T00:00:00.000Z\",\n \"release\": 0.5\n },\n {\n \"date\": \"2015-01-08T00:00:00.000Z\",\n \"release\": 0.5.1\n }\n]", "type": "json" } ] }, "version": "0.0.0", "filename": "../augur/server.py", "groupTitle": "Experimental" }, { "type": "get", "url": "/:owner/:repo/contributors", "title": "Total Contributions by User", "name": "TotalContributions", "description": "", "group": "Experimental", "parameter": { "fields": { "Parameter": [ { "group": "Parameter", "type": "String", "optional": false, "field": "owner", "description": "Username of the owner of the GitHub repository
" }, { "group": "Parameter", "type": "String", "optional": false, "field": "repo", "description": "Name of the GitHub repository
" } ] } }, "success": { "examples": [ { "title": "Success-Response:", "content": "[\n {\n \"login\": \"foo\",\n \"location\": \"Springfield\",\n \"commits\": 1337.0,\n \"pull_requests\": 60.0,\n \"issues\": null,\n \"commit_comments\": 158.0,\n \"pull_request_comments\": 718.0,\n \"issue_comments\": 1668.0\n },\n {\n \"login\": \"bar\",\n \"location\": null,\n \"commits\": 3968.0,\n \"pull_requests\": null,\n \"issues\": 12.0,\n \"commit_comments\": 158.0,\n \"pull_request_comments\": 718.0,\n \"issue_comments\": 1568.0\n }\n ]", "type": "json" } ] }, "version": "0.0.0", "filename": "../augur/server.py", "groupTitle": "Experimental" }, { "type": "get", "url": "/:owner/:repo/timeseries/commits?group_by=:group_by", "title": "Commits", "name": "Commits", "group": "Growth_Maturity_Decline", "description": "/github.CHAOSS Metric Definition
", "parameter": { "fields": { "Parameter": [ { "group": "Parameter", "type": "String", "optional": false, "field": "owner", "description": "Username of the owner of the GitHub repository
" }, { "group": "Parameter", "type": "String", "optional": false, "field": "repo", "description": "Name of the GitHub repository
" }, { "group": "Parameter", "type": "String", "optional": false, "field": "group_by", "description": "(Default to week) Allows for results to be grouped by day, week, month, or year
" } ] } }, "success": { "examples": [ { "title": "Success-Response:", "content": "[\n {\n \"date\": \"2015-01-01T00:00:00.000Z\",\n \"commits\": 153\n },\n {\n \"date\": \"2015-01-08T00:00:00.000Z\",\n \"commits\": 192\n }\n]", "type": "json" } ] }, "version": "0.0.0", "filename": "../augur/server.py", "groupTitle": "Growth_Maturity_Decline" }, { "type": "get", "url": "/:owner/:repo/timeseries/forks?group_by=:group_by", "title": "Forks", "name": "Forks", "group": "Growth_Maturity_Decline", "parameter": { "fields": { "Parameter": [ { "group": "Parameter", "type": "String", "optional": false, "field": "group_by", "description": "(Default to week) Allows for results to be grouped by day, week, month, or year
" }, { "group": "Parameter", "type": "String", "optional": false, "field": "owner", "description": "Username of the owner of the GitHub repository
" }, { "group": "Parameter", "type": "String", "optional": false, "field": "repo", "description": "Name of the GitHub repository
" } ] } }, "description": "", "success": { "examples": [ { "title": "Success-Response:", "content": "[\n {\n \"date\": \"2015-01-01T00:00:00.000Z\",\n \"forks\": 13\n },\n {\n \"date\": \"2015-01-08T00:00:00.000Z\",\n \"forks\": 12\n }\n]", "type": "json" } ] }, "version": "0.0.0", "filename": "../augur/server.py", "groupTitle": "Growth_Maturity_Decline" }, { "type": "get", "url": "/:owner/:repo/timeseries/issues/response_time", "title": "Issue Response Time", "name": "IssueResponseTime", "group": "Growth_Maturity_Decline", "description": "", "parameter": { "fields": { "Parameter": [ { "group": "Parameter", "type": "String", "optional": false, "field": "owner", "description": "Username of the owner of the GitHub repository
" }, { "group": "Parameter", "type": "String", "optional": false, "field": "repo", "description": "Name of the GitHub repository
" } ] } }, "success": { "examples": [ { "title": "Success-Response:", "content": "[\n {\n \"created_at\": \"2013-09-16T17:00:54.000Z\",\n \"responded_at\": \"2013-09-16T17:20:58.000Z\"\n },\n {\n \"created_at\": \"2013-09-16T09:31:34.000Z\",\n \"responded_at\": \"2013-09-16T09:43:03.000Z\"\n }\n]", "type": "json" } ] }, "version": "0.0.0", "filename": "../augur/server.py", "groupTitle": "Growth_Maturity_Decline" }, { "type": "get", "url": "/:owner/:repo/timeseries/issues", "title": "Issues", "name": "Issues", "group": "Growth_Maturity_Decline", "parameter": { "fields": { "Parameter": [ { "group": "Parameter", "type": "String", "optional": false, "field": "group_by", "description": "(Default to week) Allows for results to be grouped by day, week, month, or year
" }, { "group": "Parameter", "type": "String", "optional": false, "field": "owner", "description": "Username of the owner of the GitHub repository
" }, { "group": "Parameter", "type": "String", "optional": false, "field": "repo", "description": "Name of the GitHub repository
" } ] } }, "description": "", "success": { "examples": [ { "title": "Success-Response:", "content": "[\n {\n \"date\": \"2015-01-01T00:00:00.000Z\",\n \"issues\":13\n },\n {\n \"date\": \"2015-01-08T00:00:00.000Z\",\n \"issues\":15\n }\n]", "type": "json" } ] }, "version": "0.0.0", "filename": "../augur/server.py", "groupTitle": "Growth_Maturity_Decline" }, { "type": "get", "url": "/:owner/:repo/timeseries/issues/closed", "title": "Issues Closed", "name": "Issues", "group": "Growth_Maturity_Decline", "parameter": { "fields": { "Parameter": [ { "group": "Parameter", "type": "String", "optional": false, "field": "owner", "description": "Username of the owner of the GitHub repository
" }, { "group": "Parameter", "type": "String", "optional": false, "field": "repo", "description": "Name of the GitHub repository
" } ] } }, "success": { "examples": [ { "title": "Success-Response:", "content": "[\n {\n \"date\": \"2011-03-19T00:00:00.000Z\",\n \"issues_closed\": 3\n },\n {\n \"date\": \"2011-03-20T00:00:00.000Z\",\n \"issues_closed\": 0\n }\n]", "type": "json" } ] }, "version": "0.0.0", "filename": "../augur/server.py", "groupTitle": "Growth_Maturity_Decline" }, { "type": "get", "url": "/:owner/:repo/timeseries/pull_request_comments", "title": "count of new pull request comments weekly", "name": "PullRequestComments", "group": "Growth_Maturity_Decline", "description": "", "parameter": { "fields": { "Parameter": [ { "group": "Parameter", "type": "String", "optional": false, "field": "owner", "description": "Username of the owner of the GitHub repository
" }, { "group": "Parameter", "type": "String", "optional": false, "field": "repo", "description": "Name of the GitHub repository
" } ] } }, "success": { "examples": [ { "title": "Success-Response:", "content": "[\n { \"date\":\"2009-02-16T00:00:00.000Z\",\n \"comments\":1.0\n },\n { \"date\":\"2009-07-12T00:00:00.000Z\",\n \"comments\":2.0\n },", "type": "json" } ] }, "version": "0.0.0", "filename": "../augur/server.py", "groupTitle": "Growth_Maturity_Decline" }, { "type": "get", "url": "/:owner/:repo/timeseries/pulls", "title": "Pull Requests by Week", "name": "PullRequestsByWeek", "group": "Growth_Maturity_Decline", "description": "", "parameter": { "fields": { "Parameter": [ { "group": "Parameter", "type": "String", "optional": false, "field": "owner", "description": "Username of the owner of the GitHub repository
" }, { "group": "Parameter", "type": "String", "optional": false, "field": "repo", "description": "Name of the GitHub repository
" } ] } }, "success": { "examples": [ { "title": "Success-Response:", "content": "[\n {\n \"date\": \"2015-01-01T00:00:00.000Z\",\n \"pull_requests\": 1\n \"comments\": 11\n },\n {\n \"date\": \"2015-01-08T00:00:00.000Z\",\n \"pull_requests\": 2\n \"comments\": 31\n }\n]", "type": "json" } ] }, "version": "0.0.0", "filename": "../augur/server.py", "groupTitle": "Growth_Maturity_Decline" }, { "type": "get", "url": "/:owner/:repo/pulls/maintainer_response_time", "title": "Time to First Maintainer Response to Merge Request", "description": "", "name": "TimeToFirstMaintainerResponseToMergeRequest", "group": "Growth_Maturity_Decline", "parameter": { "fields": { "Parameter": [ { "group": "Parameter", "type": "String", "optional": false, "field": "owner", "description": "Username of the owner of the GitHub repository
" }, { "group": "Parameter", "type": "String", "optional": false, "field": "repo", "description": "Name of the GitHub repository
" } ] } }, "success": { "examples": [ { "title": "Success-Response:", "content": "[\n {\n \"response_time\":11044366.0\n },\n {\n \"response_time\":11044955.0\n },\n]", "type": "json" } ] }, "version": "0.0.0", "filename": "../augur/server.py", "groupTitle": "Growth_Maturity_Decline" }, { "type": "get", "url": "/:owner/:repo/timeseries/total_committers", "title": "count of new committers weekly", "name": "UniqueCommitters", "description": "Metric Undefined
", "group": "Growth_Maturity_Decline", "parameter": { "fields": { "Parameter": [ { "group": "Parameter", "type": "String", "optional": false, "field": "owner", "description": "Username of the owner of the GitHub repository
" }, { "group": "Parameter", "type": "String", "optional": false, "field": "repo", "description": "Name of the GitHub repository
" } ] } }, "success": { "examples": [ { "title": "Success-Response:", "content": "[\n { \"date\":\"2009-02-16T00:00:00.000Z\",\n \"total_total_committers\":1.0\n },\n { \"date\":\"2009-07-12T00:00:00.000Z\",\n \"total_total_committers\":2.0\n },\n]", "type": "json" } ] }, "version": "0.0.0", "filename": "../augur/server.py", "groupTitle": "Growth_Maturity_Decline" }, { "type": "get", "url": "/:owner/:repo/dependencies", "title": "List of dependencies from libraries.io", "name": "Dependencies", "description": "Metric Undefined
", "group": "Risk", "parameter": { "fields": { "Parameter": [ { "group": "Parameter", "type": "String", "optional": false, "field": "owner", "description": "Username of the owner of the GitHub repository
" }, { "group": "Parameter", "type": "String", "optional": false, "field": "repo", "description": "Name of the GitHub repository
" } ] } }, "success": { "examples": [ { "title": "Success-Response:", "content": "[\n { \"full_name\": \"rails/rails\"\n \"description\": \"Ruby on Rails\",\n \"fork\": false, \"created_at\": \"2008-04-11T02:19:47.000Z\",\n \"updated_at\": \"2017-09-20T20:16:47.181Z\",\n \"pushed_at\": \"2017-09-20T19:39:08.000Z\",\n \"homepage\": \"http://rubyonrails.org\",\n \"size\": 155199, \"stargazers_count\": 36993,\n \"language\": \"Ruby\", \"has_issues\": true,\n \"has_wiki\": false,\n \"has_pages\": false,\n \"forks_count\": 15130,\n \"mirror_url\": null,\n \"open_issues_count\": 1157,\n \"default_branch\": \"master\",\n \"subscribers_count\": 2452,\n \"uuid\": \"8514\", \"source_name\": null,\n \"license\": \"MIT\", \"private\": false,\n \"contributions_count\": 2616,\n \"has_readme\": \"README.md\",\n \"has_changelog\": null,\n \"has_contributing\": \"CONTRIBUTING.md\",\n \"has_license\": \"MIT-LICENSE\",\n \"has_coc\": \"CODE_OF_CONDUCT.md\",\n \"has_threat_model\": null,\n \"has_audit\": null,\n \"status\": null,\n \"last_synced_at\": \"2017-09-20T20:16:47.153Z\",\n \"rank\": 28, \"host_type\": \"GitHub\",\n \"host_domain\": null,\n \"name\": null,\n \"scm\": \"git\",\n \"fork_policy\": null,\n \"github_id\": \"8514\",\n \"pull_requests_enabled\": null,\n \"logo_url\": null,\n \"github_contributions_count\": 2616,\n \"keywords\": [\"activejob\", \"activerecord\", \"html\", \"mvc\", \"rails\", \"ruby\"],\n \"dependencies\": [\n { \"project_name\": \"websocket-driver\",\n \"name\": \"websocket-driver\",\n \"platform\": \"rubygems\",\n \"requirements\": \"~> 0.6.1\",\n \"latest_stable\": \"0.7.0\",\n \"latest\": \"0.7.0\",\n \"deprecated\": false, \"outdated\": true,\n \"filepath\": \"actioncable/actioncable.gemspec\", \"\n kind\": \"runtime\"\n }\n ]", "type": "json" } ] }, "version": "0.0.0", "filename": "../augur/server.py", "groupTitle": "Risk" }, { "type": "get", "url": "/:owner/:repo/dependency_stats", "title": "List of libraries.io stats", "name": "DependencyStats", "group": "Risk", "parameter": { "fields": { "Parameter": [ { "group": "Parameter", "type": "String", "optional": false, "field": "owner", "description": "Username of the owner of the GitHub repository
" }, { "group": "Parameter", "type": "String", "optional": false, "field": "repo", "description": "Name of the GitHub repository
" } ] } }, "success": { "examples": [ { "title": "Success-Response:", "content": "[\n {\n \"dependencies\": \"10\",\n \"dependent_projects\": \"10.6K\",\n \"dependent_repositories\": \"392K\"\n }\n]", "type": "json" } ] }, "version": "0.0.0", "filename": "../augur/server.py", "groupTitle": "Risk" }, { "type": "get", "url": "/:owner/:repo/bus_factor", "title": "Bus Factor", "name": "GitHub", "description": "Returns an integer that is the number of developers that have a summed percentage of contributions higher than the threshold
", "group": "Risk", "parameter": { "fields": { "Parameter": [ { "group": "Parameter", "type": "String", "optional": false, "field": "owner", "description": "Username of the owner of the GitHub repository
" }, { "group": "Parameter", "type": "String", "optional": false, "field": "repo", "description": "Name of the GitHub repository
" } ] } }, "success": { "examples": [ { "title": "Success-Response:", "content": "[\n {\n \"best\": \"5\",\n \"worst\": \"1\"\n }\n]", "type": "json" } ] }, "version": "0.0.0", "filename": "../augur/server.py", "groupTitle": "Risk" }, { "type": "get", "url": "/git/lines_changed/:git_repo_url", "title": "Lines Changed", "name": "Lines_Changed__no_whitespace_", "description": "Shows detailed information about each file changed by each commit
", "group": "Uncategorized", "parameter": { "fields": { "Parameter": [ { "group": "Parameter", "type": "String", "optional": false, "field": "owner", "description": "Username of the owner of the GitHub repository
" }, { "group": "Parameter", "type": "String", "optional": false, "field": "repo", "description": "Name of the GitHub repository
" } ] } }, "success": { "examples": [ { "title": "Success-Response:", "content": "[\n {\n \"additions\":2,\n \"author_date\":\"2018-05-14 10:09:57 -0500\",\n \"author_email\":\"s@goggins.com\",\n \"author_name\":\"Sean P. Goggins\",\n \"commit_date\":\"2018-05-16 10:12:22 -0500\",\n \"committer_email\":\"derek@howderek.com\",\n \"committer_name\":\"Derek Howard\",\n \"deletions\":0,\n \"hash\":\"77e603a\",\n \"message\":\"merge dev\",\n \"parents\":\"b8ec0ed\"\n }\n]", "type": "json" } ] }, "version": "0.0.0", "filename": "../augur/server.py", "groupTitle": "Uncategorized" }, { "type": "get", "url": "/git/lines_changed/:git_repo_url", "title": "Lines Changed", "name": "Lines_Changed__no_whitespace_", "description": "Shows detailed information about each file changed by each commit
", "group": "Uncategorized", "parameter": { "fields": { "Parameter": [ { "group": "Parameter", "type": "String", "optional": false, "field": "owner", "description": "Username of the owner of the GitHub repository
" }, { "group": "Parameter", "type": "String", "optional": false, "field": "repo", "description": "Name of the GitHub repository
" } ] } }, "success": { "examples": [ { "title": "Success-Response:", "content": "[\n {\n \"additions\":2,\n \"author_date\":\"2018-05-14 10:09:57 -0500\",\n \"author_email\":\"s@goggins.com\",\n \"author_name\":\"Sean P. Goggins\",\n \"commit_date\":\"2018-05-16 10:12:22 -0500\",\n \"committer_email\":\"derek@howderek.com\",\n \"committer_name\":\"Derek Howard\",\n \"deletions\":0,\"hash\":\"77e603a\",\n \"message\":\"merge dev\",\n \"parents\":\"b8ec0ed\"\n }\n]", "type": "json" } ] }, "version": "0.0.0", "filename": "../augur/server.py", "groupTitle": "Uncategorized" }, { "type": "get", "url": "/:owner/:repo/watchers", "title": "", "name": "Community_Engagement", "group": "Users", "parameter": { "fields": { "Parameter": [ { "group": "Parameter", "type": "String", "optional": false, "field": "owner", "description": "Username of the owner of the GitHub repository
" }, { "group": "Parameter", "type": "String", "optional": false, "field": "repo", "description": "Name of the GitHub repository
" } ] } }, "success": { "examples": [ { "title": "Success-Response:", "content": "[\n {\n \"watchers\": 40349\n }\n]", "type": "json" } ] }, "version": "0.0.0", "filename": "../augur/server.py", "groupTitle": "Users" }, { "type": "get", "url": "/ghtorrent_range", "title": "Range of dates covered by GHTorrent", "name": "GhtorrentRange", "group": "Utility", "version": "0.0.0", "filename": "../augur/server.py", "groupTitle": "Utility" }, { "type": "get", "url": "/:owner/:repo/timeseries/contributions", "title": "Contributions by Week", "name": "ContributionsByWeek", "parameter": { "fields": { "Parameter": [ { "group": "Parameter", "type": "String", "optional": false, "field": "owner", "description": "Username of the owner of the GitHub repository
" }, { "group": "Parameter", "type": "String", "optional": false, "field": "repo", "description": "Name of the GitHub repository
" } ], "String": [ { "group": "String", "optional": false, "field": "user", "description": "Limit results to the given user's contributions
" } ] } }, "success": { "examples": [ { "title": "Success-Response:", "content": "[\n {\n \"date\": \"2015-01-01T00:00:00.000Z\",\n \"commits\": 37.0,\n \"pull_requests\": null,\n \"issues\": null,\n \"commit_comments\": 7.0,\n \"pull_request_comments\": 8.0,\n \"issue_comments\": 17.0\n },\n {\n \"date\": \"2015-01-08T00:00:00.000Z\",\n \"commits\": 68.0,\n \"pull_requests\": null,\n \"issues\": 12.0,\n \"commit_comments\": 18.0,\n \"pull_request_comments\": 13.0,\n \"issue_comments\": 28.0\n }\n ]", "type": "json" } ] }, "version": "0.0.0", "filename": "../augur/server.py", "group": "_Volumes_SeansRAIDBaby_augur_augur_server_py", "groupTitle": "_Volumes_SeansRAIDBaby_augur_augur_server_py" } ] }); diff --git a/docs/api/api_data.json b/docs/api/api_data.json index 936db0d855..24413edb53 100644 --- a/docs/api/api_data.json +++ b/docs/api/api_data.json @@ -1 +1 @@ -[ { "type": "post", "url": "/batch", "title": "Bus Factor", "description": "Returns results of batch requests
", "name": "Batch", "group": "Batch_POST_JSON_of_api_requests", "version": "0.0.0", "filename": "../augur/server.py", "groupTitle": "Batch_POST_JSON_of_api_requests" }, { "type": "get", "url": "/:owner/:repo/committer_locations", "title": "Commits and Location by User", "name": "CommitterLocations", "description": "Metric Undefined
", "group": "Diversity_Inclusion", "parameter": { "fields": { "Parameter": [ { "group": "Parameter", "type": "String", "optional": false, "field": "owner", "description": "Username of the owner of the GitHub repository
" }, { "group": "Parameter", "type": "String", "optional": false, "field": "repo", "description": "Name of the GitHub repository
" } ] } }, "success": { "examples": [ { "title": "Success-Response:", "content": "[\n {\n \"login\": \"bonnie\",\n \"location\": \"Rowena, TX\",\n \"commits\": 12\n },\n {\n \"login\":\"clyde\",\n \"location\":\"Ellis County, TX\",\n \"commits\": 12\n }\n]", "type": "json" } ] }, "version": "0.0.0", "filename": "../augur/server.py", "groupTitle": "Diversity_Inclusion" }, { "type": "get", "url": "/:owner/:repo/linking_websites", "title": "Linking Websites", "name": "LinkingWebsites", "description": "Returns an array of websites and their rank according to http://publicwww.com/
", "group": "Experimental", "parameter": { "fields": { "Parameter": [ { "group": "Parameter", "type": "String", "optional": false, "field": "owner", "description": "Username of the owner of the GitHub repository
" }, { "group": "Parameter", "type": "String", "optional": false, "field": "repo", "description": "Name of the GitHub repository
" } ] } }, "success": { "examples": [ { "title": "Success-Response:", "content": "[\n {\n \"url\": \"missouri.edu\",\n \"rank\": \"1\"\n },\n {\n \"url\": \"unomaha.edu\",\n \"rank\": \"2\"\n }\n]", "type": "json" } ] }, "version": "0.0.0", "filename": "../augur/server.py", "groupTitle": "Experimental" }, { "type": "get", "url": "/:owner/:repo/timeseries/commits/comments", "title": "count of commit comments weekly", "name": "CommitComments", "group": "Growth_Maturity_Decline", "description": "", "parameter": { "fields": { "Parameter": [ { "group": "Parameter", "type": "String", "optional": false, "field": "owner", "description": "Username of the owner of the GitHub repository
" }, { "group": "Parameter", "type": "String", "optional": false, "field": "repo", "description": "Name of the GitHub repository
" } ] } }, "success": { "examples": [ { "title": "Success-Response:", "content": "[\n { \"date\":\"2009-02-16T00:00:00.000Z\",\n \"comments\":1.0\n },\n { \"date\":\"2009-07-12T00:00:00.000Z\",\n \"comments\":2.0\n },", "type": "json" } ] }, "version": "0.0.0", "filename": "../augur/server.py", "groupTitle": "Growth_Maturity_Decline" }, { "type": "get", "url": "/:owner/:repo/timeseries/commits?group_by=:group_by", "title": "Commits", "name": "Commits", "group": "Growth_Maturity_Decline", "description": "/github.CHAOSS Metric Definition
", "parameter": { "fields": { "Parameter": [ { "group": "Parameter", "type": "String", "optional": false, "field": "owner", "description": "Username of the owner of the GitHub repository
" }, { "group": "Parameter", "type": "String", "optional": false, "field": "repo", "description": "Name of the GitHub repository
" }, { "group": "Parameter", "type": "String", "optional": false, "field": "group_by", "description": "(Default to week) Allows for results to be grouped by day, week, month, or year
" } ] } }, "success": { "examples": [ { "title": "Success-Response:", "content": "[\n {\n \"date\": \"2015-01-01T00:00:00.000Z\",\n \"commits\": 153\n },\n {\n \"date\": \"2015-01-08T00:00:00.000Z\",\n \"commits\": 192\n }\n]", "type": "json" } ] }, "version": "0.0.0", "filename": "../augur/server.py", "groupTitle": "Growth_Maturity_Decline" }, { "type": "get", "url": "/:owner/:repo/timeseries/community_age", "title": "Timeline of events to determine the age of a community", "name": "CommunityAge", "description": "Metric Undefined
", "group": "Growth_Maturity_Decline", "parameter": { "fields": { "Parameter": [ { "group": "Parameter", "type": "String", "optional": false, "field": "owner", "description": "Username of the owner of the GitHub repository
" }, { "group": "Parameter", "type": "String", "optional": false, "field": "repo", "description": "Name of the GitHub repository
" } ] } }, "success": { "examples": [ { "title": "Success-Response:", "content": "[\n {\n \"login\": \"bonnie\",\n \"location\": \"Rowena, TX\",\n \"commits\": 12\n },\n {\n \"login\":\"clyde\",\n \"location\":\"Ellis County, TX\",\n \"commits\": 12\n }\n]", "type": "json" } ] }, "version": "0.0.0", "filename": "../augur/server.py", "groupTitle": "Growth_Maturity_Decline" }, { "type": "get", "url": "/:owner/:repo/timeseries/community_engagement", "title": "", "name": "Community_Engagement", "group": "Growth_Maturity_Decline", "description": "", "parameter": { "fields": { "Parameter": [ { "group": "Parameter", "type": "String", "optional": false, "field": "owner", "description": "Username of the owner of the GitHub repository
" }, { "group": "Parameter", "type": "String", "optional": false, "field": "repo", "description": "Name of the GitHub repository
" } ] } }, "success": { "examples": [ { "title": "Success-Response:", "content": "[\n {\n \"date\": \"2009-04-01T00:00:00.000Z\",\n \"issues_opened\": 1.0,\n \"issues_closed\": 0.0,\n \"pull_requests_opened\": 0.0,\n \"pull_requests_merged\": 0.0,\n \"pull_requests_closed\": 0.0,\n \"issues_opened_total\": 2.0,\n \"issues_closed_total\": 0.0,\n \"issues_closed_rate_this_window\": 0.0,\n \"issues_closed_rate_total\": 0.0,\n \"issues_delta\": 1.0,\n \"issues_open\": 2.0,\n \"pull_requests_opened_total\": 0.0,\n \"pull_requests_closed_total\": 0.0,\n \"pull_requests_closed_rate_this_window\": null,\n \"pull_requests_closed_rate_total\": null,\n \"pull_requests_delta\": 0.0,\n \"pull_requests_open\": 0.0\n }, \n {\n \"date\": \"2009-04-16T00:00:00.000Z\",\n \"issues_opened\": 2.0,\n \"issues_closed\": 1.0,\n \"pull_requests_opened\": 1.0,\n \"pull_requests_merged\": 1.0,\n \"pull_requests_closed\": 1.0,\n \"issues_opened_total\": 3.0,\n \"issues_closed_total\": 5.0,\n \"issues_closed_rate_this_window\": 4.0,\n \"issues_closed_rate_total\": 6.0,\n \"issues_delta\": 1.0,\n \"issues_open\": 2.0,\n \"pull_requests_opened_total\": 3.0,\n \"pull_requests_closed_total\": 5.0,\n \"pull_requests_closed_rate_this_window\": null,\n \"pull_requests_closed_rate_total\": null,\n \"pull_requests_delta\": 2.0,\n \"pull_requests_open\": 1.0\n } \n]", "type": "json" } ] }, "version": "0.0.0", "filename": "../augur/server.py", "groupTitle": "Growth_Maturity_Decline" }, { "type": "get", "url": "/:owner/:repo/dependents", "title": "List of dependants from libraries.io", "name": "Dependents", "description": "Metric Undefined
", "group": "Growth_Maturity_Decline", "parameter": { "fields": { "Parameter": [ { "group": "Parameter", "type": "String", "optional": false, "field": "owner", "description": "Username of the owner of the GitHub repository
" }, { "group": "Parameter", "type": "String", "optional": false, "field": "repo", "description": "Name of the GitHub repository
" } ] } }, "success": { "examples": [ { "title": "Success-Response:", "content": "[\n {\n \"login\": \"bonnie\",\n \"location\": \"Rowena, TX\",\n \"commits\": 12\n },\n {\n \"login\":\"clyde\",\n \"location\":\"Ellis County, TX\",\n \"commits\": 12\n }\n]", "type": "json" } ] }, "version": "0.0.0", "filename": "../augur/server.py", "groupTitle": "Growth_Maturity_Decline" }, { "type": "get", "url": "/:owner/:repo/timeseries/downloads", "title": "Number of downloads", "description": "Timeseries of downloads from package manager
", "name": "Downloads", "group": "Growth_Maturity_Decline", "parameter": { "fields": { "Parameter": [ { "group": "Parameter", "type": "String", "optional": false, "field": "owner", "description": "Username of the owner of the GitHub repository
" }, { "group": "Parameter", "type": "String", "optional": false, "field": "repo", "description": "Name of the GitHub repository
" } ] } }, "success": { "examples": [ { "title": "Success-Response:", "content": "[\n {\n \"date\": \"2015-01-01T00:00:00.000Z\",\n \"downlads\": 235\n },\n {\n \"date\": \"2015-01-08T00:00:00.000Z\",\n \"dowloads\": 327\n }\n]", "type": "json" } ] }, "version": "0.0.0", "filename": "../augur/server.py", "groupTitle": "Growth_Maturity_Decline" }, { "type": "get", "url": "/:owner/:repo/timeseries/forks?group_by=:group_by", "title": "Forks", "name": "Forks", "group": "Growth_Maturity_Decline", "parameter": { "fields": { "Parameter": [ { "group": "Parameter", "type": "String", "optional": false, "field": "group_by", "description": "(Default to week) Allows for results to be grouped by day, week, month, or year
" }, { "group": "Parameter", "type": "String", "optional": false, "field": "owner", "description": "Username of the owner of the GitHub repository
" }, { "group": "Parameter", "type": "String", "optional": false, "field": "repo", "description": "Name of the GitHub repository
" } ] } }, "description": "", "success": { "examples": [ { "title": "Success-Response:", "content": "[\n {\n \"date\": \"2015-01-01T00:00:00.000Z\",\n \"forks\": 13\n },\n {\n \"date\": \"2015-01-08T00:00:00.000Z\",\n \"forks\": 12\n }\n]", "type": "json" } ] }, "version": "0.0.0", "filename": "../augur/server.py", "groupTitle": "Growth_Maturity_Decline" }, { "type": "get", "url": "/:owner/:repo/timeseries/issues/response_time", "title": "Issue Response Time", "name": "IssueResponseTime", "group": "Growth_Maturity_Decline", "description": "", "parameter": { "fields": { "Parameter": [ { "group": "Parameter", "type": "String", "optional": false, "field": "owner", "description": "Username of the owner of the GitHub repository
" }, { "group": "Parameter", "type": "String", "optional": false, "field": "repo", "description": "Name of the GitHub repository
" } ] } }, "success": { "examples": [ { "title": "Success-Response:", "content": "[\n {\n \"created_at\": \"2013-09-16T17:00:54.000Z\",\n \"responded_at\": \"2013-09-16T17:20:58.000Z\"\n },\n {\n \"created_at\": \"2013-09-16T09:31:34.000Z\",\n \"responded_at\": \"2013-09-16T09:43:03.000Z\"\n }\n]", "type": "json" } ] }, "version": "0.0.0", "filename": "../augur/server.py", "groupTitle": "Growth_Maturity_Decline" }, { "type": "get", "url": "/:owner/:repo/timeseries/issues/activity", "title": "Issues Activity", "name": "Issues", "group": "Growth_Maturity_Decline", "description": "", "parameter": { "fields": { "Parameter": [ { "group": "Parameter", "type": "String", "optional": false, "field": "owner", "description": "Username of the owner of the GitHub repository
" }, { "group": "Parameter", "type": "String", "optional": false, "field": "repo", "description": "Name of the GitHub repository
" } ] } }, "success": { "examples": [ { "title": "Success-Response:", "content": "[\n {\n \"date\": \"2010-12-23T00:00:00.000Z\",\n \"count\": 0.0,\n \"action\": \"closed\"\n },\n {\n \"date\": \"2010-12-23T00:00:00.000Z\",\n \"count\": 2.0,\n \"action\": \"opened\"\n },\n {\n \"date\": \"2010-12-23T00:00:00.000Z\",\n \"count\": 8.0,\n \"action\": \"reopened\"\n },\n {\n \"date\": \"2010-12-23T00:00:00.000Z\",\n \"count\": 12.0,\n \"action\": \"open\"\n }\n]", "type": "json" } ] }, "version": "0.0.0", "filename": "../augur/server.py", "groupTitle": "Growth_Maturity_Decline" }, { "type": "get", "url": "/:owner/:repo/timeseries/issues", "title": "Issues", "name": "Issues", "group": "Growth_Maturity_Decline", "parameter": { "fields": { "Parameter": [ { "group": "Parameter", "type": "String", "optional": false, "field": "group_by", "description": "(Default to week) Allows for results to be grouped by day, week, month, or year
" }, { "group": "Parameter", "type": "String", "optional": false, "field": "owner", "description": "Username of the owner of the GitHub repository
" }, { "group": "Parameter", "type": "String", "optional": false, "field": "repo", "description": "Name of the GitHub repository
" } ] } }, "description": "", "success": { "examples": [ { "title": "Success-Response:", "content": "[\n {\n \"date\": \"2015-01-01T00:00:00.000Z\",\n \"issues\":13\n },\n {\n \"date\": \"2015-01-08T00:00:00.000Z\",\n \"issues\":15\n }\n]", "type": "json" } ] }, "version": "0.0.0", "filename": "../augur/server.py", "groupTitle": "Growth_Maturity_Decline" }, { "type": "get", "url": "/:owner/:repo/issue_comment_time", "title": "", "name": "Issues", "group": "Growth_Maturity_Decline", "description": "", "parameter": { "fields": { "Parameter": [ { "group": "Parameter", "type": "String", "optional": false, "field": "owner", "description": "Username of the owner of the GitHub repository
" }, { "group": "Parameter", "type": "String", "optional": false, "field": "repo", "description": "Name of the GitHub repository
" } ] } }, "success": { "examples": [ { "title": "Success-Response:", "content": "[\n {\n \"id\": 2,\n \"opened\": \"2012-01-19T05:24:55.000Z\",\n \"first_commented\": \"2012-01-19T05:30:13.000Z\",\n \"pull_request\": 0,\n \"minutes_to_comment\": 5.0\n },\n {\n \"id\": 3,\n \"opened\": \"2012-01-26T15:07:56.000Z\",\n \"first_commented\": \"2012-01-26T15:09:28.000Z\",\n \"pull_request\": 0,\n \"minutes_to_comment\": 1.0\n }\n]", "type": "json" } ] }, "version": "0.0.0", "filename": "../augur/server.py", "groupTitle": "Growth_Maturity_Decline" }, { "type": "get", "url": "/:owner/:repo/issue_close_time", "title": "Issue Close Time", "name": "Issues", "group": "Growth_Maturity_Decline", "description": "", "parameter": { "fields": { "Parameter": [ { "group": "Parameter", "type": "String", "optional": false, "field": "owner", "description": "Username of the owner of the GitHub repository
" }, { "group": "Parameter", "type": "String", "optional": false, "field": "repo", "description": "Name of the GitHub repository
" } ] } }, "success": { "examples": [ { "title": "Success-Response:", "content": "[\n {\n \"id\": 136603,\n \"repo_id\": 1334,\n \"opened\": \"2010-09-08 19:09:56\",\n \"pull_request\": 1,\n \"minutes_to_close\": 1264.0,\n \"average_minutes_to_close_as_of_close\": 1264.0,\n \"average_minutes_to_close_past_30_days\": 1264.0,\n \"z-score\": -0.3152279792\n },\n {\n \"id\": 136602,\n \"repo_id\": 1334,\n \"opened\": \"2010-09-09 04:33:23\",\n \"pull_request\": 1,\n \"minutes_to_close\": 701.0,\n \"average_minutes_to_close_as_of_close\": 982.5,\n \"average_minutes_to_close_past_30_days\": 982.5,\n \"z-score\": -0.3184596776\n }\n]", "type": "json" } ] }, "version": "0.0.0", "filename": "../augur/server.py", "groupTitle": "Growth_Maturity_Decline" }, { "type": "get", "url": "/:owner/:repo/timeseries/issues/closed", "title": "Issues Closed", "name": "Issues", "group": "Growth_Maturity_Decline", "parameter": { "fields": { "Parameter": [ { "group": "Parameter", "type": "String", "optional": false, "field": "owner", "description": "Username of the owner of the GitHub repository
" }, { "group": "Parameter", "type": "String", "optional": false, "field": "repo", "description": "Name of the GitHub repository
" } ] } }, "success": { "examples": [ { "title": "Success-Response:", "content": "[\n {\n \"date\": \"2011-03-19T00:00:00.000Z\",\n \"issues_closed\": 3\n },\n {\n \"date\": \"2011-03-20T00:00:00.000Z\",\n \"issues_closed\": 0\n }\n]", "type": "json" } ] }, "version": "0.0.0", "filename": "../augur/server.py", "groupTitle": "Growth_Maturity_Decline" }, { "type": "get", "url": "/:owner/:repo/timeseries/lines_changed", "title": "Net number of lines of code changed", "description": "", "name": "LinesChanged", "group": "Growth_Maturity_Decline", "parameter": { "fields": { "Parameter": [ { "group": "Parameter", "type": "String", "optional": false, "field": "owner", "description": "Username of the owner of the GitHub repository
" }, { "group": "Parameter", "type": "String", "optional": false, "field": "repo", "description": "Name of the GitHub repository
" } ] } }, "success": { "examples": [ { "title": "Success-Response:", "content": "[\n {\n 'date': '2015-11-01T00:00:00Z', \n 'lines_changed': 396137.0\n },\n {\n 'date': '2015-11-08T00:00:00Z', \n 'lines_changed': 3896.0\n },\n]", "type": "json" } ] }, "version": "0.0.0", "filename": "../augur/server.py", "groupTitle": "Growth_Maturity_Decline" }, { "type": "get", "url": "/:owner/:repo/timeseries/tags/major", "title": "Tags for major releases timeseries", "description": "Metric Undefined
", "name": "Major_Release_Tags", "group": "Growth_Maturity_Decline", "parameter": { "fields": { "Parameter": [ { "group": "Parameter", "type": "String", "optional": false, "field": "owner", "description": "Username of the owner of the GitHub repository
" }, { "group": "Parameter", "type": "String", "optional": false, "field": "repo", "description": "Name of the GitHub repository
" } ] } }, "success": { "examples": [ { "title": "Success-Response:", "content": "[\n {\n \"date\": \"2015-01-01T00:00:00.000Z\",\n \"release\": 1.0.0\n },\n {\n \"date\": \"2015-01-08T00:00:00.000Z\",\n \"release\": 2.0.0\n }\n]", "type": "json" } ] }, "version": "0.0.0", "filename": "../augur/server.py", "groupTitle": "Growth_Maturity_Decline" }, { "type": "get", "url": "/:owner/:repo/timeseries/pulls/acceptance_rate", "title": "Pull Request Acceptance Rate by Week", "description": "", "name": "PullRequestAcceptanceRate", "group": "Growth_Maturity_Decline", "parameter": { "fields": { "Parameter": [ { "group": "Parameter", "type": "String", "optional": false, "field": "owner", "description": "Username of the owner of the GitHub repository
" }, { "group": "Parameter", "type": "String", "optional": false, "field": "repo", "description": "Name of the GitHub repository
" } ] } }, "success": { "examples": [ { "title": "Success-Response:", "content": "[\n {\n \"date\": \"2015-01-01T00:00:00.000Z\",\n \"rate\": 0.5\n },\n {\n \"date\": \"2015-01-08T00:00:00.000Z\",\n \"rate\": 0.33\n }\n]", "type": "json" } ] }, "version": "0.0.0", "filename": "../augur/server.py", "groupTitle": "Growth_Maturity_Decline" }, { "type": "get", "url": "/:owner/:repo/timeseries/pull_request_comments", "title": "count of new pull request comments weekly", "name": "PullRequestComments", "group": "Growth_Maturity_Decline", "description": "", "parameter": { "fields": { "Parameter": [ { "group": "Parameter", "type": "String", "optional": false, "field": "owner", "description": "Username of the owner of the GitHub repository
" }, { "group": "Parameter", "type": "String", "optional": false, "field": "repo", "description": "Name of the GitHub repository
" } ] } }, "success": { "examples": [ { "title": "Success-Response:", "content": "[\n { \"date\":\"2009-02-16T00:00:00.000Z\",\n \"comments\":1.0\n },\n { \"date\":\"2009-07-12T00:00:00.000Z\",\n \"comments\":2.0\n },", "type": "json" } ] }, "version": "0.0.0", "filename": "../augur/server.py", "groupTitle": "Growth_Maturity_Decline" }, { "type": "get", "url": "/:owner/:repo/timeseries/pulls", "title": "Pull Requests by Week", "name": "PullRequestsByWeek", "group": "Growth_Maturity_Decline", "description": "", "parameter": { "fields": { "Parameter": [ { "group": "Parameter", "type": "String", "optional": false, "field": "owner", "description": "Username of the owner of the GitHub repository
" }, { "group": "Parameter", "type": "String", "optional": false, "field": "repo", "description": "Name of the GitHub repository
" } ] } }, "success": { "examples": [ { "title": "Success-Response:", "content": "[\n {\n \"date\": \"2015-01-01T00:00:00.000Z\",\n \"pull_requests\": 1\n \"comments\": 11\n },\n {\n \"date\": \"2015-01-08T00:00:00.000Z\",\n \"pull_requests\": 2\n \"comments\": 31\n }\n]", "type": "json" } ] }, "version": "0.0.0", "filename": "../augur/server.py", "groupTitle": "Growth_Maturity_Decline" }, { "type": "get", "url": "/:owner/:repo/timeseries/stargazers?group_by=:group_by", "title": "Stargazers", "name": "Stargazers", "group": "Growth_Maturity_Decline", "description": "Metric Undefined
", "parameter": { "fields": { "Parameter": [ { "group": "Parameter", "type": "String", "optional": false, "field": "owner", "description": "Username of the owner of the GitHub repository
" }, { "group": "Parameter", "type": "String", "optional": false, "field": "repo", "description": "Name of the GitHub repository
" }, { "group": "Parameter", "type": "String", "optional": false, "field": "group_by", "description": "(Default to week) Allows for results to be grouped by day, week, month, or year
" } ] } }, "success": { "examples": [ { "title": "Success-Response:", "content": "[\n {\n \"date\": \"2015-01-01T00:00:00.000Z\",\n \"watchers\": 133\n },\n {\n \"date\": \"2015-01-08T00:00:00.000Z\",\n \"watchers\": 54\n }\n]", "type": "json" } ] }, "version": "0.0.0", "filename": "../augur/server.py", "groupTitle": "Growth_Maturity_Decline" }, { "type": "get", "url": "/:owner/:repo/timeseries/tags", "title": "Tags release timeseries", "description": "Metric Undefined
", "name": "Tags", "group": "Growth_Maturity_Decline", "parameter": { "fields": { "Parameter": [ { "group": "Parameter", "type": "String", "optional": false, "field": "owner", "description": "Username of the owner of the GitHub repository
" }, { "group": "Parameter", "type": "String", "optional": false, "field": "repo", "description": "Name of the GitHub repository
" } ] } }, "success": { "examples": [ { "title": "Success-Response:", "content": "[\n {\n \"date\": \"2015-01-01T00:00:00.000Z\",\n \"release\": 0.5\n },\n {\n \"date\": \"2015-01-08T00:00:00.000Z\",\n \"release\": 0.5.1\n }\n]", "type": "json" } ] }, "version": "0.0.0", "filename": "../augur/server.py", "groupTitle": "Growth_Maturity_Decline" }, { "type": "get", "url": "/:owner/:repo/pulls/maintainer_response_time", "title": "Time to First Maintainer Response to Merge Request", "description": "", "name": "TimeToFirstMaintainerResponseToMergeRequest", "group": "Growth_Maturity_Decline", "parameter": { "fields": { "Parameter": [ { "group": "Parameter", "type": "String", "optional": false, "field": "owner", "description": "Username of the owner of the GitHub repository
" }, { "group": "Parameter", "type": "String", "optional": false, "field": "repo", "description": "Name of the GitHub repository
" } ] } }, "success": { "examples": [ { "title": "Success-Response:", "content": "[\n {\n \"response_time\":11044366.0\n },\n {\n \"response_time\":11044955.0\n },\n]", "type": "json" } ] }, "version": "0.0.0", "filename": "../augur/server.py", "groupTitle": "Growth_Maturity_Decline" }, { "type": "get", "url": "/:owner/:repo/contributors", "title": "Total Contributions by User", "name": "TotalContributions", "description": "", "group": "Growth_Maturity_Decline", "parameter": { "fields": { "Parameter": [ { "group": "Parameter", "type": "String", "optional": false, "field": "owner", "description": "Username of the owner of the GitHub repository
" }, { "group": "Parameter", "type": "String", "optional": false, "field": "repo", "description": "Name of the GitHub repository
" } ] } }, "success": { "examples": [ { "title": "Success-Response:", "content": "[\n {\n \"login\": \"foo\",\n \"location\": \"Springfield\",\n \"commits\": 1337.0,\n \"pull_requests\": 60.0,\n \"issues\": null,\n \"commit_comments\": 158.0,\n \"pull_request_comments\": 718.0,\n \"issue_comments\": 1668.0\n },\n {\n \"login\": \"bar\",\n \"location\": null,\n \"commits\": 3968.0,\n \"pull_requests\": null,\n \"issues\": 12.0,\n \"commit_comments\": 158.0,\n \"pull_request_comments\": 718.0,\n \"issue_comments\": 1568.0\n }\n ]", "type": "json" } ] }, "version": "0.0.0", "filename": "../augur/server.py", "groupTitle": "Growth_Maturity_Decline" }, { "type": "get", "url": "/:owner/:repo/timeseries/total_committers", "title": "count of new committers weekly", "name": "UniqueCommitters", "description": "Metric Undefined
", "group": "Growth_Maturity_Decline", "parameter": { "fields": { "Parameter": [ { "group": "Parameter", "type": "String", "optional": false, "field": "owner", "description": "Username of the owner of the GitHub repository
" }, { "group": "Parameter", "type": "String", "optional": false, "field": "repo", "description": "Name of the GitHub repository
" } ] } }, "success": { "examples": [ { "title": "Success-Response:", "content": "[\n { \"date\":\"2009-02-16T00:00:00.000Z\",\n \"total_total_committers\":1.0\n },\n { \"date\":\"2009-07-12T00:00:00.000Z\",\n \"total_total_committers\":2.0\n },\n]", "type": "json" } ] }, "version": "0.0.0", "filename": "../augur/server.py", "groupTitle": "Growth_Maturity_Decline" }, { "type": "get", "url": "/:owner/:repo/timeseries/issue_comments", "title": "Count of New Comments", "name": "uniqueCommenters", "group": "Growth_Maturity_Decline", "description": "", "parameter": { "fields": { "Parameter": [ { "group": "Parameter", "type": "String", "optional": false, "field": "owner", "description": "Username of the owner of the GitHub repository
" }, { "group": "Parameter", "type": "String", "optional": false, "field": "repo", "description": "Name of the GitHub repository
" } ] } }, "success": { "examples": [ { "title": "Success-Response:", "content": "[\n { \"date\":\"2009-02-16T00:00:00.000Z\",\n \"total_unique_comments\":1.0\n },\n { \"date\":\"2009-07-12T00:00:00.000Z\",\n \"total_unique_comments\":2.0\n },\n]", "type": "json" } ] }, "version": "0.0.0", "filename": "../augur/server.py", "groupTitle": "Growth_Maturity_Decline" }, { "type": "get", "url": "/:owner/:repo/dependencies", "title": "List of dependencies from libraries.io", "name": "Dependencies", "description": "Metric Undefined
", "group": "Risk", "parameter": { "fields": { "Parameter": [ { "group": "Parameter", "type": "String", "optional": false, "field": "owner", "description": "Username of the owner of the GitHub repository
" }, { "group": "Parameter", "type": "String", "optional": false, "field": "repo", "description": "Name of the GitHub repository
" } ] } }, "success": { "examples": [ { "title": "Success-Response:", "content": "[\n { \"full_name\": \"rails/rails\"\n \"description\": \"Ruby on Rails\", \n \"fork\": false, \"created_at\": \"2008-04-11T02:19:47.000Z\", \n \"updated_at\": \"2017-09-20T20:16:47.181Z\", \n \"pushed_at\": \"2017-09-20T19:39:08.000Z\", \n \"homepage\": \"http://rubyonrails.org\", \n \"size\": 155199, \"stargazers_count\": 36993, \n \"language\": \"Ruby\", \"has_issues\": true, \n \"has_wiki\": false, \n \"has_pages\": false, \n \"forks_count\": 15130, \n \"mirror_url\": null, \n \"open_issues_count\": 1157, \n \"default_branch\": \"master\", \n \"subscribers_count\": 2452,\n \"uuid\": \"8514\", \"source_name\": null, \n \"license\": \"MIT\", \"private\": false, \n \"contributions_count\": 2616, \n \"has_readme\": \"README.md\", \n \"has_changelog\": null, \n \"has_contributing\": \"CONTRIBUTING.md\", \n \"has_license\": \"MIT-LICENSE\", \n \"has_coc\": \"CODE_OF_CONDUCT.md\", \n \"has_threat_model\": null, \n \"has_audit\": null, \n \"status\": null, \n \"last_synced_at\": \"2017-09-20T20:16:47.153Z\", \n \"rank\": 28, \"host_type\": \"GitHub\", \n \"host_domain\": null, \n \"name\": null, \n \"scm\": \"git\", \n \"fork_policy\": null,\n \"github_id\": \"8514\", \n \"pull_requests_enabled\": null, \n \"logo_url\": null, \n \"github_contributions_count\": 2616, \n \"keywords\": [\"activejob\", \"activerecord\", \"html\", \"mvc\", \"rails\", \"ruby\"], \n \"dependencies\": [\n { \"project_name\": \"websocket-driver\", \n \"name\": \"websocket-driver\", \n \"platform\": \"rubygems\", \n \"requirements\": \"~> 0.6.1\", \n \"latest_stable\": \"0.7.0\", \n \"latest\": \"0.7.0\", \n \"deprecated\": false, \"outdated\": true, \n \"filepath\": \"actioncable/actioncable.gemspec\", \"\n kind\": \"runtime\"\n }\n ]", "type": "json" } ] }, "version": "0.0.0", "filename": "../augur/server.py", "groupTitle": "Risk" }, { "type": "get", "url": "/:owner/:repo/dependency_stats", "title": "List of libraries.io stats", "name": "DependencyStats", "group": "Risk", "parameter": { "fields": { "Parameter": [ { "group": "Parameter", "type": "String", "optional": false, "field": "owner", "description": "Username of the owner of the GitHub repository
" }, { "group": "Parameter", "type": "String", "optional": false, "field": "repo", "description": "Name of the GitHub repository
" } ] } }, "success": { "examples": [ { "title": "Success-Response:", "content": "[\n {\n \"dependencies\": \"10\", \n \"dependent_projects\": \"10.6K\", \n \"dependent_repositories\": \"392K\"\n }\n]", "type": "json" } ] }, "version": "0.0.0", "filename": "../augur/server.py", "groupTitle": "Risk" }, { "type": "get", "url": "/:owner/:repo/bus_factor", "title": "Bus Factor", "name": "GitHub", "description": "Returns an integer that is the number of developers that have a summed percentage of contributions higher than the threshold
", "group": "Risk", "parameter": { "fields": { "Parameter": [ { "group": "Parameter", "type": "String", "optional": false, "field": "owner", "description": "Username of the owner of the GitHub repository
" }, { "group": "Parameter", "type": "String", "optional": false, "field": "repo", "description": "Name of the GitHub repository
" } ] } }, "success": { "examples": [ { "title": "Success-Response:", "content": "[\n {\n \"best\": \"5\",\n \"worst\": \"1\"\n }\n]", "type": "json" } ] }, "version": "0.0.0", "filename": "../augur/server.py", "groupTitle": "Risk" }, { "type": "get", "url": "/:owner/:repo/watchers", "title": "", "name": "Community_Engagement", "group": "Users", "parameter": { "fields": { "Parameter": [ { "group": "Parameter", "type": "String", "optional": false, "field": "owner", "description": "Username of the owner of the GitHub repository
" }, { "group": "Parameter", "type": "String", "optional": false, "field": "repo", "description": "Name of the GitHub repository
" } ] } }, "success": { "examples": [ { "title": "Success-Response:", "content": "[\n {\n \"watchers\": 40349\n }\n]", "type": "json" } ] }, "version": "0.0.0", "filename": "../augur/server.py", "groupTitle": "Users" }, { "type": "get", "url": "/ghtorrent_range", "title": "Range of dates covered by GHTorrent", "name": "GhtorrentRange", "group": "Utility", "version": "0.0.0", "filename": "../augur/server.py", "groupTitle": "Utility" }, { "type": "get", "url": "/", "title": "API Status", "name": "Status", "group": "Utility", "version": "0.0.0", "filename": "../augur/server.py", "groupTitle": "Utility" }, { "type": "get", "url": "/:owner/:repo/timeseries/contributions", "title": "Contributions by Week", "name": "ContributionsByWeek", "parameter": { "fields": { "Parameter": [ { "group": "Parameter", "type": "String", "optional": false, "field": "owner", "description": "Username of the owner of the GitHub repository
" }, { "group": "Parameter", "type": "String", "optional": false, "field": "repo", "description": "Name of the GitHub repository
" } ], "String": [ { "group": "String", "optional": false, "field": "user", "description": "Limit results to the given user's contributions
" } ] } }, "success": { "examples": [ { "title": "Success-Response:", "content": "[\n {\n \"date\": \"2015-01-01T00:00:00.000Z\",\n \"commits\": 37.0,\n \"pull_requests\": null,\n \"issues\": null,\n \"commit_comments\": 7.0,\n \"pull_request_comments\": 8.0,\n \"issue_comments\": 17.0\n },\n {\n \"date\": \"2015-01-08T00:00:00.000Z\",\n \"commits\": 68.0,\n \"pull_requests\": null,\n \"issues\": 12.0,\n \"commit_comments\": 18.0,\n \"pull_request_comments\": 13.0,\n \"issue_comments\": 28.0\n }\n ]", "type": "json" } ] }, "version": "0.0.0", "filename": "../augur/server.py", "group": "_Users_howderek_Projects_Python_augur_augur_server_py", "groupTitle": "_Users_howderek_Projects_Python_augur_augur_server_py" } ] +[ { "type": "get", "url": "/:owner/:repo/bus_factor", "title": "Bus Factor", "name": "GitHub", "description": "Returns an integer that is the number of developers that have a summed percentage of contributions higher than the threshold
", "group": "Activity", "parameter": { "fields": { "Parameter": [ { "group": "Parameter", "type": "String", "optional": false, "field": "owner", "description": "Username of the owner of the GitHub repository
" }, { "group": "Parameter", "type": "String", "optional": false, "field": "repo", "description": "Name of the GitHub repository
" } ] } }, "success": { "examples": [ { "title": "Success-Response:", "content": "[\n {\n \"best\": \"5\",\n \"worst\": \"1\"\n }\n]", "type": "json" } ] }, "version": "0.0.0", "filename": "../augur/server.py", "groupTitle": "Activity" }, { "type": "get", "url": "/:owner/:repo/timeseries/issue_comments", "title": "Count of New Comments", "name": "uniqueCommenters", "group": "Activity", "description": "", "parameter": { "fields": { "Parameter": [ { "group": "Parameter", "type": "String", "optional": false, "field": "owner", "description": "Username of the owner of the GitHub repository
" }, { "group": "Parameter", "type": "String", "optional": false, "field": "repo", "description": "Name of the GitHub repository
" } ] } }, "success": { "examples": [ { "title": "Success-Response:", "content": "[\n { \"date\":\"2009-02-16T00:00:00.000Z\",\n \"total_unique_comments\":1.0\n },\n { \"date\":\"2009-07-12T00:00:00.000Z\",\n \"total_unique_comments\":2.0\n },\n]", "type": "json" } ] }, "version": "0.0.0", "filename": "../augur/server.py", "groupTitle": "Activity" }, { "type": "post", "url": "/batch", "title": "Bus Factor", "description": "Returns results of batch requests
", "name": "Batch", "group": "Batch_POST_JSON_of_api_requests", "version": "0.0.0", "filename": "../augur/server.py", "groupTitle": "Batch_POST_JSON_of_api_requests" }, { "type": "get", "url": "/:owner/:repo/committer_locations", "title": "Commits and Location by User", "name": "CommitterLocations", "description": "Metric Undefined
", "group": "Diversity_Inclusion", "parameter": { "fields": { "Parameter": [ { "group": "Parameter", "type": "String", "optional": false, "field": "owner", "description": "Username of the owner of the GitHub repository
" }, { "group": "Parameter", "type": "String", "optional": false, "field": "repo", "description": "Name of the GitHub repository
" } ] } }, "success": { "examples": [ { "title": "Success-Response:", "content": "[\n {\n \"login\": \"bonnie\",\n \"location\": \"Rowena, TX\",\n \"commits\": 12\n },\n {\n \"login\":\"clyde\",\n \"location\":\"Ellis County, TX\",\n \"commits\": 12\n }\n]", "type": "json" } ] }, "version": "0.0.0", "filename": "../augur/server.py", "groupTitle": "Diversity_Inclusion" }, { "type": "get", "url": "/:owner/:repo/timeseries/commits/comments", "title": "count of commit comments weekly", "name": "CommitComments", "group": "Experimental", "description": "", "parameter": { "fields": { "Parameter": [ { "group": "Parameter", "type": "String", "optional": false, "field": "owner", "description": "Username of the owner of the GitHub repository
" }, { "group": "Parameter", "type": "String", "optional": false, "field": "repo", "description": "Name of the GitHub repository
" } ] } }, "success": { "examples": [ { "title": "Success-Response:", "content": "[\n { \"date\":\"2009-02-16T00:00:00.000Z\",\n \"comments\":1.0\n },\n { \"date\":\"2009-07-12T00:00:00.000Z\",\n \"comments\":2.0\n },", "type": "json" } ] }, "version": "0.0.0", "filename": "../augur/server.py", "groupTitle": "Experimental" }, { "type": "get", "url": "/:owner/:repo/timeseries/community_age", "title": "Timeline of events to determine the age of a community", "name": "CommunityAge", "description": "Metric Undefined
", "group": "Experimental", "parameter": { "fields": { "Parameter": [ { "group": "Parameter", "type": "String", "optional": false, "field": "owner", "description": "Username of the owner of the GitHub repository
" }, { "group": "Parameter", "type": "String", "optional": false, "field": "repo", "description": "Name of the GitHub repository
" } ] } }, "success": { "examples": [ { "title": "Success-Response:", "content": "[\n {\n \"login\": \"bonnie\",\n \"location\": \"Rowena, TX\",\n \"commits\": 12\n },\n {\n \"login\":\"clyde\",\n \"location\":\"Ellis County, TX\",\n \"commits\": 12\n }\n]", "type": "json" } ] }, "version": "0.0.0", "filename": "../augur/server.py", "groupTitle": "Experimental" }, { "type": "get", "url": "/:owner/:repo/timeseries/community_engagement", "title": "", "name": "Community_Engagement", "group": "Experimental", "description": "", "parameter": { "fields": { "Parameter": [ { "group": "Parameter", "type": "String", "optional": false, "field": "owner", "description": "Username of the owner of the GitHub repository
" }, { "group": "Parameter", "type": "String", "optional": false, "field": "repo", "description": "Name of the GitHub repository
" } ] } }, "success": { "examples": [ { "title": "Success-Response:", "content": "[\n {\n \"date\": \"2009-04-01T00:00:00.000Z\",\n \"issues_opened\": 1.0,\n \"issues_closed\": 0.0,\n \"pull_requests_opened\": 0.0,\n \"pull_requests_merged\": 0.0,\n \"pull_requests_closed\": 0.0,\n \"issues_opened_total\": 2.0,\n \"issues_closed_total\": 0.0,\n \"issues_closed_rate_this_window\": 0.0,\n \"issues_closed_rate_total\": 0.0,\n \"issues_delta\": 1.0,\n \"issues_open\": 2.0,\n \"pull_requests_opened_total\": 0.0,\n \"pull_requests_closed_total\": 0.0,\n \"pull_requests_closed_rate_this_window\": null,\n \"pull_requests_closed_rate_total\": null,\n \"pull_requests_delta\": 0.0,\n \"pull_requests_open\": 0.0\n },\n {\n \"date\": \"2009-04-16T00:00:00.000Z\",\n \"issues_opened\": 2.0,\n \"issues_closed\": 1.0,\n \"pull_requests_opened\": 1.0,\n \"pull_requests_merged\": 1.0,\n \"pull_requests_closed\": 1.0,\n \"issues_opened_total\": 3.0,\n \"issues_closed_total\": 5.0,\n \"issues_closed_rate_this_window\": 4.0,\n \"issues_closed_rate_total\": 6.0,\n \"issues_delta\": 1.0,\n \"issues_open\": 2.0,\n \"pull_requests_opened_total\": 3.0,\n \"pull_requests_closed_total\": 5.0,\n \"pull_requests_closed_rate_this_window\": null,\n \"pull_requests_closed_rate_total\": null,\n \"pull_requests_delta\": 2.0,\n \"pull_requests_open\": 1.0\n }\n]", "type": "json" } ] }, "version": "0.0.0", "filename": "../augur/server.py", "groupTitle": "Experimental" }, { "type": "get", "url": "/:owner/:repo/dependents", "title": "List of dependants from libraries.io", "name": "Dependents", "description": "Metric Undefined
", "group": "Experimental", "parameter": { "fields": { "Parameter": [ { "group": "Parameter", "type": "String", "optional": false, "field": "owner", "description": "Username of the owner of the GitHub repository
" }, { "group": "Parameter", "type": "String", "optional": false, "field": "repo", "description": "Name of the GitHub repository
" } ] } }, "success": { "examples": [ { "title": "Success-Response:", "content": "[\n {\n \"login\": \"bonnie\",\n \"location\": \"Rowena, TX\",\n \"commits\": 12\n },\n {\n \"login\":\"clyde\",\n \"location\":\"Ellis County, TX\",\n \"commits\": 12\n }\n]", "type": "json" } ] }, "version": "0.0.0", "filename": "../augur/server.py", "groupTitle": "Experimental" }, { "type": "get", "url": "/:owner/:repo/timeseries/downloads", "title": "Number of downloads", "description": "Timeseries of downloads from package manager
", "name": "Downloads", "group": "Experimental", "parameter": { "fields": { "Parameter": [ { "group": "Parameter", "type": "String", "optional": false, "field": "owner", "description": "Username of the owner of the GitHub repository
" }, { "group": "Parameter", "type": "String", "optional": false, "field": "repo", "description": "Name of the GitHub repository
" } ] } }, "success": { "examples": [ { "title": "Success-Response:", "content": "[\n {\n \"date\": \"2015-01-01T00:00:00.000Z\",\n \"downlads\": 235\n },\n {\n \"date\": \"2015-01-08T00:00:00.000Z\",\n \"dowloads\": 327\n }\n]", "type": "json" } ] }, "version": "0.0.0", "filename": "../augur/server.py", "groupTitle": "Experimental" }, { "type": "get", "url": "/:owner/:repo/issue_close_time", "title": "Issue Close Time", "name": "Issues", "group": "Experimental", "description": "", "parameter": { "fields": { "Parameter": [ { "group": "Parameter", "type": "String", "optional": false, "field": "owner", "description": "Username of the owner of the GitHub repository
" }, { "group": "Parameter", "type": "String", "optional": false, "field": "repo", "description": "Name of the GitHub repository
" } ] } }, "success": { "examples": [ { "title": "Success-Response:", "content": "[\n {\n \"id\": 136603,\n \"repo_id\": 1334,\n \"opened\": \"2010-09-08 19:09:56\",\n \"pull_request\": 1,\n \"minutes_to_close\": 1264.0,\n \"average_minutes_to_close_as_of_close\": 1264.0,\n \"average_minutes_to_close_past_30_days\": 1264.0,\n \"z-score\": -0.3152279792\n },\n {\n \"id\": 136602,\n \"repo_id\": 1334,\n \"opened\": \"2010-09-09 04:33:23\",\n \"pull_request\": 1,\n \"minutes_to_close\": 701.0,\n \"average_minutes_to_close_as_of_close\": 982.5,\n \"average_minutes_to_close_past_30_days\": 982.5,\n \"z-score\": -0.3184596776\n }\n]", "type": "json" } ] }, "version": "0.0.0", "filename": "../augur/server.py", "groupTitle": "Experimental" }, { "type": "get", "url": "/:owner/:repo/timeseries/issues/activity", "title": "Issues Activity", "name": "Issues", "group": "Experimental", "description": "", "parameter": { "fields": { "Parameter": [ { "group": "Parameter", "type": "String", "optional": false, "field": "owner", "description": "Username of the owner of the GitHub repository
" }, { "group": "Parameter", "type": "String", "optional": false, "field": "repo", "description": "Name of the GitHub repository
" } ] } }, "success": { "examples": [ { "title": "Success-Response:", "content": "[\n {\n \"date\": \"2010-12-23T00:00:00.000Z\",\n \"count\": 0.0,\n \"action\": \"closed\"\n },\n {\n \"date\": \"2010-12-23T00:00:00.000Z\",\n \"count\": 2.0,\n \"action\": \"opened\"\n },\n {\n \"date\": \"2010-12-23T00:00:00.000Z\",\n \"count\": 8.0,\n \"action\": \"reopened\"\n },\n {\n \"date\": \"2010-12-23T00:00:00.000Z\",\n \"count\": 12.0,\n \"action\": \"open\"\n }\n]", "type": "json" } ] }, "version": "0.0.0", "filename": "../augur/server.py", "groupTitle": "Experimental" }, { "type": "get", "url": "/:owner/:repo/timeseries/lines_changed", "title": "Net number of lines of code changed", "description": "", "name": "LinesChanged", "group": "Experimental", "parameter": { "fields": { "Parameter": [ { "group": "Parameter", "type": "String", "optional": false, "field": "owner", "description": "Username of the owner of the GitHub repository
" }, { "group": "Parameter", "type": "String", "optional": false, "field": "repo", "description": "Name of the GitHub repository
" } ] } }, "success": { "examples": [ { "title": "Success-Response:", "content": "[\n {\n 'date': '2015-11-01T00:00:00Z',\n 'lines_changed': 396137.0\n },\n {\n 'date': '2015-11-08T00:00:00Z',\n 'lines_changed': 3896.0\n },\n]", "type": "json" } ] }, "version": "0.0.0", "filename": "../augur/server.py", "groupTitle": "Experimental" }, { "type": "get", "url": "/:owner/:repo/linking_websites", "title": "Linking Websites", "name": "LinkingWebsites", "description": "Returns an array of websites and their rank according to http://publicwww.com/
", "group": "Experimental", "parameter": { "fields": { "Parameter": [ { "group": "Parameter", "type": "String", "optional": false, "field": "owner", "description": "Username of the owner of the GitHub repository
" }, { "group": "Parameter", "type": "String", "optional": false, "field": "repo", "description": "Name of the GitHub repository
" } ] } }, "success": { "examples": [ { "title": "Success-Response:", "content": "[\n {\n \"url\": \"missouri.edu\",\n \"rank\": \"1\"\n },\n {\n \"url\": \"unomaha.edu\",\n \"rank\": \"2\"\n }\n]", "type": "json" } ] }, "version": "0.0.0", "filename": "../augur/server.py", "groupTitle": "Experimental" }, { "type": "get", "url": "/:owner/:repo/timeseries/tags/major", "title": "Tags for major releases timeseries", "description": "Metric Undefined
", "name": "Major_Release_Tags", "group": "Experimental", "parameter": { "fields": { "Parameter": [ { "group": "Parameter", "type": "String", "optional": false, "field": "owner", "description": "Username of the owner of the GitHub repository
" }, { "group": "Parameter", "type": "String", "optional": false, "field": "repo", "description": "Name of the GitHub repository
" } ] } }, "success": { "examples": [ { "title": "Success-Response:", "content": "[\n {\n \"date\": \"2015-01-01T00:00:00.000Z\",\n \"release\": 1.0.0\n },\n {\n \"date\": \"2015-01-08T00:00:00.000Z\",\n \"release\": 2.0.0\n }\n]", "type": "json" } ] }, "version": "0.0.0", "filename": "../augur/server.py", "groupTitle": "Experimental" }, { "type": "get", "url": "/:owner/:repo/timeseries/pulls/acceptance_rate", "title": "Pull Request Acceptance Rate by Week", "description": "", "name": "PullRequestAcceptanceRate", "group": "Experimental", "parameter": { "fields": { "Parameter": [ { "group": "Parameter", "type": "String", "optional": false, "field": "owner", "description": "Username of the owner of the GitHub repository
" }, { "group": "Parameter", "type": "String", "optional": false, "field": "repo", "description": "Name of the GitHub repository
" } ] } }, "success": { "examples": [ { "title": "Success-Response:", "content": "[\n {\n \"date\": \"2015-01-01T00:00:00.000Z\",\n \"rate\": 0.5\n },\n {\n \"date\": \"2015-01-08T00:00:00.000Z\",\n \"rate\": 0.33\n }\n]", "type": "json" } ] }, "version": "0.0.0", "filename": "../augur/server.py", "groupTitle": "Experimental" }, { "type": "get", "url": "/:owner/:repo/timeseries/tags", "title": "Tags release timeseries", "description": "Metric Undefined
", "name": "Tags", "group": "Experimental", "parameter": { "fields": { "Parameter": [ { "group": "Parameter", "type": "String", "optional": false, "field": "owner", "description": "Username of the owner of the GitHub repository
" }, { "group": "Parameter", "type": "String", "optional": false, "field": "repo", "description": "Name of the GitHub repository
" } ] } }, "success": { "examples": [ { "title": "Success-Response:", "content": "[\n {\n \"date\": \"2015-01-01T00:00:00.000Z\",\n \"release\": 0.5\n },\n {\n \"date\": \"2015-01-08T00:00:00.000Z\",\n \"release\": 0.5.1\n }\n]", "type": "json" } ] }, "version": "0.0.0", "filename": "../augur/server.py", "groupTitle": "Experimental" }, { "type": "get", "url": "/:owner/:repo/contributors", "title": "Total Contributions by User", "name": "TotalContributions", "description": "", "group": "Experimental", "parameter": { "fields": { "Parameter": [ { "group": "Parameter", "type": "String", "optional": false, "field": "owner", "description": "Username of the owner of the GitHub repository
" }, { "group": "Parameter", "type": "String", "optional": false, "field": "repo", "description": "Name of the GitHub repository
" } ] } }, "success": { "examples": [ { "title": "Success-Response:", "content": "[\n {\n \"login\": \"foo\",\n \"location\": \"Springfield\",\n \"commits\": 1337.0,\n \"pull_requests\": 60.0,\n \"issues\": null,\n \"commit_comments\": 158.0,\n \"pull_request_comments\": 718.0,\n \"issue_comments\": 1668.0\n },\n {\n \"login\": \"bar\",\n \"location\": null,\n \"commits\": 3968.0,\n \"pull_requests\": null,\n \"issues\": 12.0,\n \"commit_comments\": 158.0,\n \"pull_request_comments\": 718.0,\n \"issue_comments\": 1568.0\n }\n ]", "type": "json" } ] }, "version": "0.0.0", "filename": "../augur/server.py", "groupTitle": "Experimental" }, { "type": "get", "url": "/:owner/:repo/timeseries/commits?group_by=:group_by", "title": "Commits", "name": "Commits", "group": "Growth_Maturity_Decline", "description": "/github.CHAOSS Metric Definition
", "parameter": { "fields": { "Parameter": [ { "group": "Parameter", "type": "String", "optional": false, "field": "owner", "description": "Username of the owner of the GitHub repository
" }, { "group": "Parameter", "type": "String", "optional": false, "field": "repo", "description": "Name of the GitHub repository
" }, { "group": "Parameter", "type": "String", "optional": false, "field": "group_by", "description": "(Default to week) Allows for results to be grouped by day, week, month, or year
" } ] } }, "success": { "examples": [ { "title": "Success-Response:", "content": "[\n {\n \"date\": \"2015-01-01T00:00:00.000Z\",\n \"commits\": 153\n },\n {\n \"date\": \"2015-01-08T00:00:00.000Z\",\n \"commits\": 192\n }\n]", "type": "json" } ] }, "version": "0.0.0", "filename": "../augur/server.py", "groupTitle": "Growth_Maturity_Decline" }, { "type": "get", "url": "/:owner/:repo/timeseries/forks?group_by=:group_by", "title": "Forks", "name": "Forks", "group": "Growth_Maturity_Decline", "parameter": { "fields": { "Parameter": [ { "group": "Parameter", "type": "String", "optional": false, "field": "group_by", "description": "(Default to week) Allows for results to be grouped by day, week, month, or year
" }, { "group": "Parameter", "type": "String", "optional": false, "field": "owner", "description": "Username of the owner of the GitHub repository
" }, { "group": "Parameter", "type": "String", "optional": false, "field": "repo", "description": "Name of the GitHub repository
" } ] } }, "description": "", "success": { "examples": [ { "title": "Success-Response:", "content": "[\n {\n \"date\": \"2015-01-01T00:00:00.000Z\",\n \"forks\": 13\n },\n {\n \"date\": \"2015-01-08T00:00:00.000Z\",\n \"forks\": 12\n }\n]", "type": "json" } ] }, "version": "0.0.0", "filename": "../augur/server.py", "groupTitle": "Growth_Maturity_Decline" }, { "type": "get", "url": "/:owner/:repo/timeseries/issues/response_time", "title": "Issue Response Time", "name": "IssueResponseTime", "group": "Growth_Maturity_Decline", "description": "", "parameter": { "fields": { "Parameter": [ { "group": "Parameter", "type": "String", "optional": false, "field": "owner", "description": "Username of the owner of the GitHub repository
" }, { "group": "Parameter", "type": "String", "optional": false, "field": "repo", "description": "Name of the GitHub repository
" } ] } }, "success": { "examples": [ { "title": "Success-Response:", "content": "[\n {\n \"created_at\": \"2013-09-16T17:00:54.000Z\",\n \"responded_at\": \"2013-09-16T17:20:58.000Z\"\n },\n {\n \"created_at\": \"2013-09-16T09:31:34.000Z\",\n \"responded_at\": \"2013-09-16T09:43:03.000Z\"\n }\n]", "type": "json" } ] }, "version": "0.0.0", "filename": "../augur/server.py", "groupTitle": "Growth_Maturity_Decline" }, { "type": "get", "url": "/:owner/:repo/timeseries/issues", "title": "Issues", "name": "Issues", "group": "Growth_Maturity_Decline", "parameter": { "fields": { "Parameter": [ { "group": "Parameter", "type": "String", "optional": false, "field": "group_by", "description": "(Default to week) Allows for results to be grouped by day, week, month, or year
" }, { "group": "Parameter", "type": "String", "optional": false, "field": "owner", "description": "Username of the owner of the GitHub repository
" }, { "group": "Parameter", "type": "String", "optional": false, "field": "repo", "description": "Name of the GitHub repository
" } ] } }, "description": "", "success": { "examples": [ { "title": "Success-Response:", "content": "[\n {\n \"date\": \"2015-01-01T00:00:00.000Z\",\n \"issues\":13\n },\n {\n \"date\": \"2015-01-08T00:00:00.000Z\",\n \"issues\":15\n }\n]", "type": "json" } ] }, "version": "0.0.0", "filename": "../augur/server.py", "groupTitle": "Growth_Maturity_Decline" }, { "type": "get", "url": "/:owner/:repo/timeseries/issues/closed", "title": "Issues Closed", "name": "Issues", "group": "Growth_Maturity_Decline", "parameter": { "fields": { "Parameter": [ { "group": "Parameter", "type": "String", "optional": false, "field": "owner", "description": "Username of the owner of the GitHub repository
" }, { "group": "Parameter", "type": "String", "optional": false, "field": "repo", "description": "Name of the GitHub repository
" } ] } }, "success": { "examples": [ { "title": "Success-Response:", "content": "[\n {\n \"date\": \"2011-03-19T00:00:00.000Z\",\n \"issues_closed\": 3\n },\n {\n \"date\": \"2011-03-20T00:00:00.000Z\",\n \"issues_closed\": 0\n }\n]", "type": "json" } ] }, "version": "0.0.0", "filename": "../augur/server.py", "groupTitle": "Growth_Maturity_Decline" }, { "type": "get", "url": "/:owner/:repo/timeseries/pull_request_comments", "title": "count of new pull request comments weekly", "name": "PullRequestComments", "group": "Growth_Maturity_Decline", "description": "", "parameter": { "fields": { "Parameter": [ { "group": "Parameter", "type": "String", "optional": false, "field": "owner", "description": "Username of the owner of the GitHub repository
" }, { "group": "Parameter", "type": "String", "optional": false, "field": "repo", "description": "Name of the GitHub repository
" } ] } }, "success": { "examples": [ { "title": "Success-Response:", "content": "[\n { \"date\":\"2009-02-16T00:00:00.000Z\",\n \"comments\":1.0\n },\n { \"date\":\"2009-07-12T00:00:00.000Z\",\n \"comments\":2.0\n },", "type": "json" } ] }, "version": "0.0.0", "filename": "../augur/server.py", "groupTitle": "Growth_Maturity_Decline" }, { "type": "get", "url": "/:owner/:repo/timeseries/pulls", "title": "Pull Requests by Week", "name": "PullRequestsByWeek", "group": "Growth_Maturity_Decline", "description": "", "parameter": { "fields": { "Parameter": [ { "group": "Parameter", "type": "String", "optional": false, "field": "owner", "description": "Username of the owner of the GitHub repository
" }, { "group": "Parameter", "type": "String", "optional": false, "field": "repo", "description": "Name of the GitHub repository
" } ] } }, "success": { "examples": [ { "title": "Success-Response:", "content": "[\n {\n \"date\": \"2015-01-01T00:00:00.000Z\",\n \"pull_requests\": 1\n \"comments\": 11\n },\n {\n \"date\": \"2015-01-08T00:00:00.000Z\",\n \"pull_requests\": 2\n \"comments\": 31\n }\n]", "type": "json" } ] }, "version": "0.0.0", "filename": "../augur/server.py", "groupTitle": "Growth_Maturity_Decline" }, { "type": "get", "url": "/:owner/:repo/pulls/maintainer_response_time", "title": "Time to First Maintainer Response to Merge Request", "description": "", "name": "TimeToFirstMaintainerResponseToMergeRequest", "group": "Growth_Maturity_Decline", "parameter": { "fields": { "Parameter": [ { "group": "Parameter", "type": "String", "optional": false, "field": "owner", "description": "Username of the owner of the GitHub repository
" }, { "group": "Parameter", "type": "String", "optional": false, "field": "repo", "description": "Name of the GitHub repository
" } ] } }, "success": { "examples": [ { "title": "Success-Response:", "content": "[\n {\n \"response_time\":11044366.0\n },\n {\n \"response_time\":11044955.0\n },\n]", "type": "json" } ] }, "version": "0.0.0", "filename": "../augur/server.py", "groupTitle": "Growth_Maturity_Decline" }, { "type": "get", "url": "/:owner/:repo/timeseries/total_committers", "title": "count of new committers weekly", "name": "UniqueCommitters", "description": "Metric Undefined
", "group": "Growth_Maturity_Decline", "parameter": { "fields": { "Parameter": [ { "group": "Parameter", "type": "String", "optional": false, "field": "owner", "description": "Username of the owner of the GitHub repository
" }, { "group": "Parameter", "type": "String", "optional": false, "field": "repo", "description": "Name of the GitHub repository
" } ] } }, "success": { "examples": [ { "title": "Success-Response:", "content": "[\n { \"date\":\"2009-02-16T00:00:00.000Z\",\n \"total_total_committers\":1.0\n },\n { \"date\":\"2009-07-12T00:00:00.000Z\",\n \"total_total_committers\":2.0\n },\n]", "type": "json" } ] }, "version": "0.0.0", "filename": "../augur/server.py", "groupTitle": "Growth_Maturity_Decline" }, { "type": "get", "url": "/:owner/:repo/dependencies", "title": "List of dependencies from libraries.io", "name": "Dependencies", "description": "Metric Undefined
", "group": "Risk", "parameter": { "fields": { "Parameter": [ { "group": "Parameter", "type": "String", "optional": false, "field": "owner", "description": "Username of the owner of the GitHub repository
" }, { "group": "Parameter", "type": "String", "optional": false, "field": "repo", "description": "Name of the GitHub repository
" } ] } }, "success": { "examples": [ { "title": "Success-Response:", "content": "[\n { \"full_name\": \"rails/rails\"\n \"description\": \"Ruby on Rails\",\n \"fork\": false, \"created_at\": \"2008-04-11T02:19:47.000Z\",\n \"updated_at\": \"2017-09-20T20:16:47.181Z\",\n \"pushed_at\": \"2017-09-20T19:39:08.000Z\",\n \"homepage\": \"http://rubyonrails.org\",\n \"size\": 155199, \"stargazers_count\": 36993,\n \"language\": \"Ruby\", \"has_issues\": true,\n \"has_wiki\": false,\n \"has_pages\": false,\n \"forks_count\": 15130,\n \"mirror_url\": null,\n \"open_issues_count\": 1157,\n \"default_branch\": \"master\",\n \"subscribers_count\": 2452,\n \"uuid\": \"8514\", \"source_name\": null,\n \"license\": \"MIT\", \"private\": false,\n \"contributions_count\": 2616,\n \"has_readme\": \"README.md\",\n \"has_changelog\": null,\n \"has_contributing\": \"CONTRIBUTING.md\",\n \"has_license\": \"MIT-LICENSE\",\n \"has_coc\": \"CODE_OF_CONDUCT.md\",\n \"has_threat_model\": null,\n \"has_audit\": null,\n \"status\": null,\n \"last_synced_at\": \"2017-09-20T20:16:47.153Z\",\n \"rank\": 28, \"host_type\": \"GitHub\",\n \"host_domain\": null,\n \"name\": null,\n \"scm\": \"git\",\n \"fork_policy\": null,\n \"github_id\": \"8514\",\n \"pull_requests_enabled\": null,\n \"logo_url\": null,\n \"github_contributions_count\": 2616,\n \"keywords\": [\"activejob\", \"activerecord\", \"html\", \"mvc\", \"rails\", \"ruby\"],\n \"dependencies\": [\n { \"project_name\": \"websocket-driver\",\n \"name\": \"websocket-driver\",\n \"platform\": \"rubygems\",\n \"requirements\": \"~> 0.6.1\",\n \"latest_stable\": \"0.7.0\",\n \"latest\": \"0.7.0\",\n \"deprecated\": false, \"outdated\": true,\n \"filepath\": \"actioncable/actioncable.gemspec\", \"\n kind\": \"runtime\"\n }\n ]", "type": "json" } ] }, "version": "0.0.0", "filename": "../augur/server.py", "groupTitle": "Risk" }, { "type": "get", "url": "/:owner/:repo/dependency_stats", "title": "List of libraries.io stats", "name": "DependencyStats", "group": "Risk", "parameter": { "fields": { "Parameter": [ { "group": "Parameter", "type": "String", "optional": false, "field": "owner", "description": "Username of the owner of the GitHub repository
" }, { "group": "Parameter", "type": "String", "optional": false, "field": "repo", "description": "Name of the GitHub repository
" } ] } }, "success": { "examples": [ { "title": "Success-Response:", "content": "[\n {\n \"dependencies\": \"10\",\n \"dependent_projects\": \"10.6K\",\n \"dependent_repositories\": \"392K\"\n }\n]", "type": "json" } ] }, "version": "0.0.0", "filename": "../augur/server.py", "groupTitle": "Risk" }, { "type": "get", "url": "/:owner/:repo/bus_factor", "title": "Bus Factor", "name": "GitHub", "description": "Returns an integer that is the number of developers that have a summed percentage of contributions higher than the threshold
", "group": "Risk", "parameter": { "fields": { "Parameter": [ { "group": "Parameter", "type": "String", "optional": false, "field": "owner", "description": "Username of the owner of the GitHub repository
" }, { "group": "Parameter", "type": "String", "optional": false, "field": "repo", "description": "Name of the GitHub repository
" } ] } }, "success": { "examples": [ { "title": "Success-Response:", "content": "[\n {\n \"best\": \"5\",\n \"worst\": \"1\"\n }\n]", "type": "json" } ] }, "version": "0.0.0", "filename": "../augur/server.py", "groupTitle": "Risk" }, { "type": "get", "url": "/git/lines_changed/:git_repo_url", "title": "Lines Changed", "name": "Lines_Changed__no_whitespace_", "description": "Shows detailed information about each file changed by each commit
", "group": "Uncategorized", "parameter": { "fields": { "Parameter": [ { "group": "Parameter", "type": "String", "optional": false, "field": "owner", "description": "Username of the owner of the GitHub repository
" }, { "group": "Parameter", "type": "String", "optional": false, "field": "repo", "description": "Name of the GitHub repository
" } ] } }, "success": { "examples": [ { "title": "Success-Response:", "content": "[\n {\n \"additions\":2,\n \"author_date\":\"2018-05-14 10:09:57 -0500\",\n \"author_email\":\"s@goggins.com\",\n \"author_name\":\"Sean P. Goggins\",\n \"commit_date\":\"2018-05-16 10:12:22 -0500\",\n \"committer_email\":\"derek@howderek.com\",\n \"committer_name\":\"Derek Howard\",\n \"deletions\":0,\n \"hash\":\"77e603a\",\n \"message\":\"merge dev\",\n \"parents\":\"b8ec0ed\"\n }\n]", "type": "json" } ] }, "version": "0.0.0", "filename": "../augur/server.py", "groupTitle": "Uncategorized" }, { "type": "get", "url": "/git/lines_changed/:git_repo_url", "title": "Lines Changed", "name": "Lines_Changed__no_whitespace_", "description": "Shows detailed information about each file changed by each commit
", "group": "Uncategorized", "parameter": { "fields": { "Parameter": [ { "group": "Parameter", "type": "String", "optional": false, "field": "owner", "description": "Username of the owner of the GitHub repository
" }, { "group": "Parameter", "type": "String", "optional": false, "field": "repo", "description": "Name of the GitHub repository
" } ] } }, "success": { "examples": [ { "title": "Success-Response:", "content": "[\n {\n \"additions\":2,\n \"author_date\":\"2018-05-14 10:09:57 -0500\",\n \"author_email\":\"s@goggins.com\",\n \"author_name\":\"Sean P. Goggins\",\n \"commit_date\":\"2018-05-16 10:12:22 -0500\",\n \"committer_email\":\"derek@howderek.com\",\n \"committer_name\":\"Derek Howard\",\n \"deletions\":0,\"hash\":\"77e603a\",\n \"message\":\"merge dev\",\n \"parents\":\"b8ec0ed\"\n }\n]", "type": "json" } ] }, "version": "0.0.0", "filename": "../augur/server.py", "groupTitle": "Uncategorized" }, { "type": "get", "url": "/:owner/:repo/watchers", "title": "", "name": "Community_Engagement", "group": "Users", "parameter": { "fields": { "Parameter": [ { "group": "Parameter", "type": "String", "optional": false, "field": "owner", "description": "Username of the owner of the GitHub repository
" }, { "group": "Parameter", "type": "String", "optional": false, "field": "repo", "description": "Name of the GitHub repository
" } ] } }, "success": { "examples": [ { "title": "Success-Response:", "content": "[\n {\n \"watchers\": 40349\n }\n]", "type": "json" } ] }, "version": "0.0.0", "filename": "../augur/server.py", "groupTitle": "Users" }, { "type": "get", "url": "/ghtorrent_range", "title": "Range of dates covered by GHTorrent", "name": "GhtorrentRange", "group": "Utility", "version": "0.0.0", "filename": "../augur/server.py", "groupTitle": "Utility" }, { "type": "get", "url": "/:owner/:repo/timeseries/contributions", "title": "Contributions by Week", "name": "ContributionsByWeek", "parameter": { "fields": { "Parameter": [ { "group": "Parameter", "type": "String", "optional": false, "field": "owner", "description": "Username of the owner of the GitHub repository
" }, { "group": "Parameter", "type": "String", "optional": false, "field": "repo", "description": "Name of the GitHub repository
" } ], "String": [ { "group": "String", "optional": false, "field": "user", "description": "Limit results to the given user's contributions
" } ] } }, "success": { "examples": [ { "title": "Success-Response:", "content": "[\n {\n \"date\": \"2015-01-01T00:00:00.000Z\",\n \"commits\": 37.0,\n \"pull_requests\": null,\n \"issues\": null,\n \"commit_comments\": 7.0,\n \"pull_request_comments\": 8.0,\n \"issue_comments\": 17.0\n },\n {\n \"date\": \"2015-01-08T00:00:00.000Z\",\n \"commits\": 68.0,\n \"pull_requests\": null,\n \"issues\": 12.0,\n \"commit_comments\": 18.0,\n \"pull_request_comments\": 13.0,\n \"issue_comments\": 28.0\n }\n ]", "type": "json" } ] }, "version": "0.0.0", "filename": "../augur/server.py", "group": "_Volumes_SeansRAIDBaby_augur_augur_server_py", "groupTitle": "_Volumes_SeansRAIDBaby_augur_augur_server_py" } ] diff --git a/docs/api/api_project.js b/docs/api/api_project.js index e9bfd18763..94448c5477 100644 --- a/docs/api/api_project.js +++ b/docs/api/api_project.js @@ -1,14 +1 @@ -define({ - "name": "", - "version": "0.0.0", - "description": "", - "sampleUrl": false, - "defaultVersion": "0.0.0", - "apidoc": "0.3.0", - "generator": { - "name": "apidoc", - "time": "2018-05-11T19:12:21.742Z", - "url": "http://apidocjs.com", - "version": "0.17.6" - } -}); +define({ "name": "", "version": "0.0.0", "description": "", "sampleUrl": false, "defaultVersion": "0.0.0", "apidoc": "0.3.0", "generator": { "name": "apidoc", "time": "2018-06-05T16:17:32.568Z", "url": "http://apidocjs.com", "version": "0.17.6" } }); diff --git a/docs/api/api_project.json b/docs/api/api_project.json index 764dbaf121..eb059dc20b 100644 --- a/docs/api/api_project.json +++ b/docs/api/api_project.json @@ -1,14 +1 @@ -{ - "name": "", - "version": "0.0.0", - "description": "", - "sampleUrl": false, - "defaultVersion": "0.0.0", - "apidoc": "0.3.0", - "generator": { - "name": "apidoc", - "time": "2018-05-11T19:12:21.742Z", - "url": "http://apidocjs.com", - "version": "0.17.6" - } -} +{ "name": "", "version": "0.0.0", "description": "", "sampleUrl": false, "defaultVersion": "0.0.0", "apidoc": "0.3.0", "generator": { "name": "apidoc", "time": "2018-06-05T16:17:32.568Z", "url": "http://apidocjs.com", "version": "0.17.6" } } diff --git a/docs/dev-guide/dev-guide-overview.md b/docs/dev-guide/dev-guide-overview.md new file mode 100644 index 0000000000..fe3a496646 --- /dev/null +++ b/docs/dev-guide/dev-guide-overview.md @@ -0,0 +1,69 @@ +# Augur Development Guide: Making Contributions + +## Getting Started +See our [Contributing to Augur](/CONTRIBUTING.md) guide for specifics on how we review pull requests. tl;dr: Fork our repo. Make a change. Use the mailing list for [CHAOSS](https://lists.linuxfoundation.org/mailman/listinfo/oss-health-metrics), Submit a pull request. + +## Building Changes +After making your changes, run +```bash +make build +``` +to update the docs and frontend before adding them to your staging area. +``` +``` + +## Augur Development Overview + +### tl;dr + 1. [Back End Development Guide](/docs/dev-guide-pt1.md) + 2. [Front End Development Guide](/docs/dev-guide-pt2.md) +--------------------- + +### Augur's Design Value System +Augur's architecture is designed with an eye toward fulfilling its primary missions of rapid open source software metric prototyping and using data visualization to facilitate discussions among folks who manage open source communities. + +**Core aims: ** + 1. Rapid metrics prototyping + 2. Using data visualization to support discussion + +**Our visualization design follows two principles:** + 1. Allow comparisons across projects + 2. Where logical, show trends over time on a metric + +Project comparison helps people understand what a metric tells them. If I show you total commits in a month or a year, what does that tell you about the health of an open source project? If you are able to compare a project you are managing with a project or two in the same space that you are familiar with, is that helpful? In most cases the answers are yes. We aim to produce not only metrics, but enough information for consumers of Augur to construct meaning. Which then helps the CHAOSS community build better, more useful metrics. + +Time is, in effect, a project focused type of comparison. If you can see the changes in different metrics on your project over time, its easier to maintain awareness of how metrics compare with results. + +-------------------------------- + +## Augur's Architecture +In our aspiration to implement our value system for metrics in software, we seperate concerns pragmatically. Any metrics dashboard system has to do 4 things: 1) Ingest data, 2) store data, 3) reshape data for analysis and 4) present data. Of course, these "dashboard requirements" can be interpreted and circumvented. For example, if robust API's are available, like the [GitHub Version 4 API](https://developer.github.com/v4/), persistence can be considered optional. + +Right now, Augur satisfies the enumerated dashboard system requirements in concrete ways we describe in the following four sections. + +### Augur Data Ingestion +We use the GHTorrent database, or its MSR14 little brother to help you get up and running quickly. You may find this dataset insufficient for a particular metric you want to build. API's available from a number of places can be accessed from Augur. + +Inside your Augur system root directory there is another directory named Augur. This is where the python files that you can modify live. + +1. **downloads.py** : gathers download statistics for github repositories. Currently configured for npm and ruby gems download data. +2. **ghtorrent.py** : reads the ghtorrent database you installed. There are two functions at the top of this file that allow you to do counts on the GHTorrent Schema tables quickly using Python. + - def __single_table_count_by_date(self, table, repo_col='project_id', user_col='author_id', group_by="week"): Generates query string to count occurances of rows per date for a given table. + - def __sub_table_count_by_date(self, parent_table, sub_table, parent_id, sub_id, project_id): Generates query string to count occurances of rows per date for a given query sub-table. A query sub-table is a table that describes in more detail a specfic asset of another query table-for example, the table "pull_request_comments" is a sub table of "pull_request", where the query is pull requests. +3. **ghtorrentplus.py** : Accesses the aggregate tables Augur creates for GHTorrent. +4. **githubapi.py** : Pulls data from the GitHub API +5. **librariesio.py** : Pulls data from the libraries.io API (Package manager download data) +6. **localcsv.py** : Pulls data from a .csv file you persist. +7. **publicwww.py** : Pulls download data from the https://publicwww.com website. + +If you want to ingest substantial amounts of new data, you may want to contribute to the [Augur-OSSifragae](https://github.com/OSSHealth/augur-ossifragae) project, which focuses on systematic, structured ingestion of open source respository data from heterogeneous sources. (Note: an [Ossifragae](https://en.wikipedia.org/wiki/Bearded_Vulture) is a bearded vulture that is one of a handful of birds said to yield valid signs for ancient Roman Augurs (visionaries) to follow. We think the existance of "OSS" at the beginning of the birds name is a sign. We took it.) + +### Augur Data Storage +The database system that you built with GHTorrent or MSR14 is our principle data storage environment right now. We have added a few small details to the GHTorrent database in a seperate schema called GHTorrent_Plus. This schema is built on deployment, and supports aggregations of the GHTorrent Schema information so that metrics can be generated more quickly in a few cases. + +### Augur Data Reshaping for Analysis +Now that you understand the basic structure of Augur, our [Back End Development Guide](/docs/dev-guide-pt1.md) will be the place to start for reshaping data and building out analysis endpoints. The end result of new back end code is a **REST API Endpoint.** + +### Augur Data Presentation +Once you have a **REST API Endpoint**, you can stop and say, "I have built an endpoint. Here is my pull request". OR, you can build front end visualizations for those endpoints, following our [Front End Development Guide](/docs/dev-guide-pt2.md). + diff --git a/docs/dev-guide/dev-guide-pt1.md b/docs/dev-guide/dev-guide-pt1.md new file mode 100644 index 0000000000..ecfdd09c10 --- /dev/null +++ b/docs/dev-guide/dev-guide-pt1.md @@ -0,0 +1,101 @@ +# Developer Guide Part 1 - The Backend + +## Structure of the Backend + +Augur uses the Flask framework for its backend, which is stored in the directory `augur`. `augur/__init__.py`, `augur/server.py`, `augur/deploy.py`, and `augur/util.py` contain the components. The other `augur/*.py`files contain python funtions that return dataframes to be serialzed into json by the functions in `augur/server.py`. The titles of those files are the data sources the metrics use. + +## Setting up your environment + +Before you begin, make sure to activate the augur Anaconda environment by running `conda activate augur`. If this environment doesn't exist, try running `make install-dev` again and watch out for any errors. + +## Writing a Function for Augur + +### Should I create a new .py file? + +If your python function uses a new data source, create a new Python file. If you use an already implemented data source, create your new functions under that file. For instance, if you were to create a metric using data from the GitHub API, you would write a function in [`augur/githubapi.py`](https://github.com/OSSHealth/augur/blob/master/augur/githubapi.py) + +#### Adding a new .py file + +In the file, create a class to put your functions into, then in `augur/__init__.py` add a line with the following format + +```python +from .file_name import Class +``` +For example if I added a file named `augur/chaoss.py` that contains the class `Chaoss` the addition to `augur/__init__.py` would be + +```python +from .choass import Chaoss +``` + +### Writing a function + +In Augur there are metrics and timeseries metrics. For all metrics, the function should return a Dataframe that can be serialized into json. For timeseries metrics, the Dataframe needs to have a column named `date` that holds timestamps. + +#### Adding dependencies + +If you need to add a dependency to Augur for your function, simply add the import statment to the file as usual, then in `setup.py` add the dependency to the `install_requires` list. For example, if my new function uses a package called `mizzou`, I would find the `install_requires` list: + +```python +install_requires=['beautifulsoup4', 'flask', 'flask-cors', 'PyMySQL', 'requests', 'python-dateutil', 'sqlalchemy', 'pandas', 'pytest', 'PyGithub', 'pyevent', 'gunicorn'], +``` + +and add `mizzou` as such: + +```python +install_requires=['beautifulsoup4', 'flask', 'flask-cors', 'PyMySQL', 'requests', 'python-dateutil', 'sqlalchemy', 'pandas', 'pytest', 'PyGithub', 'pyevent', 'gunicorn', 'mizzou'], +``` + +#### Adding tests + +Augur uses pytest for tests. Tests are in the `test` directory. If you created a new file for your data source, you will also need to create a new file to test it. You can use pytest fixtures and environment variables to pass data to tests. + +```python +@pytest.fixture +def chaoss(): + import augur + chaossServer = os.getenv("CHAOSS_TEST_URL") + assert chaossServer is not None and len(chaossServer) > 8 + return augur.Chaoss(chaossServer) +``` + +Now any test that tests functions in the Chaoss class will be able to access an instance of the class + +```python +def test_data_source(chaoss): + assert chaoss.data_source('argument').isin(['expected_value']).any +``` + +Make sure every function you write has a test. + +## Creating an endpoint for a function + +If you created a new data source, make sure you create an instance of your class, loading any configuration you need with the `read_config` function. + +To create an endpoint for a function, in [`augur/server.py`](https://github.com/OSSHealth/augur/blob/master/augur/server.py), call `addMetric()` or `addTimeseries()` + +```python +addTimeseries(app, file_name.function_name, 'function_name') +``` +for a function `foo()` in `augur/bar.py` + +```python +addTimeseries(app, bar.foo, 'foo') +``` +If the metric is not a timeseries metric, replace `AddTimeseries()` with `AddMetric()` + +```bash + +## Using the Python Debugger + +The server in Augur has a built-in IPython debugger to make testing your functions easier during development. + +After you have added an instance of your class to server.py, you can test it by running: + +```bash +export AUGUR_INTERACTIVE=1 +augur +```` + +Augur will load configuration and create instances of all the classes, but will drop down to IPDB shell instead of running the Flask server. + +To disable the IPDB shell, simply export ```bash export AUGUR_INTERACTIVE=0``` and run `augur`. \ No newline at end of file diff --git a/docs/dev-guide/dev-guide-pt2.md b/docs/dev-guide/dev-guide-pt2.md new file mode 100644 index 0000000000..37287681a3 --- /dev/null +++ b/docs/dev-guide/dev-guide-pt2.md @@ -0,0 +1,131 @@ +# Developer Guide Part 2 - The Frontend + +## Structure +Augur uses Vue.js, MetricsGraphics, Kube for its frontend. The frontend is stored in the `frontend` directory, but the parts that are relevant to adding new metrics are in the `frontend/app/` directory, which contains the following parts: +* `frontend/app/AugurAPI.js` which interfaces with the backend +* `frontend/app/AugurStats.js` which performs statistical operations on the data +* `frontend/app/Augur.js` which renders the page +* `frontend/app/assets/` which contains the assets, such as images, for the frontend +* `frontend/app/include/` which contains the Kube and MetricsGraphics resources +* `frontend/styles/` which contains the stylesheet for Augur +* `frontend/components/` which contains the Vue.js components + * `frontend/components/charts/` contains the different chart templetes + * `frontend/components/BaseRepoActivityCard.vue` contains the repo activity time series charts + +## How to add a new timeseries metric + +### Adding an endpoint + +In `frontend/app/AugurAPI.js`, add an attribute to the repo class that holds a times eries object at the end of the file like this +```javascript +repo.status | metric |
status | metric |
- | - |
- |
- |
|
-
- | - |
- | - |
- |
- |
- |
- |