Versions Compared
Key
- This line was added.
- This line was removed.
- Formatting was changed.
Google Analytics 360 is a web service for hosting IT projects and their joint development. Web service based on Git version control system. Google Analytics 360 (GA 360) source GitHub provides hosting for software development version control using Git. This plugin would allow users to get data from GitHub API. The plugin would deliver GitHub data in batch mode and would allow users to pick from a variety of data ? available under GitHub APIselect the data sets associated with the specified repository and collect raw level data.
User Expectations
- User Users would like to enable GitHub API to start retieving GitHub datacollect raw data sets associated with a specific repository so that they can perform monitoring and reporting on it
- User would like to have full flexibility in picking data for GitHub datasetperform aggregations on GitHub datasets so that they can get better understanding of the repository usage
Plugin Type
- Batch Source
- Batch Sink
- Real-time Source
- Real-time Sink
- Action
- Post-Run Action
- Aggregate
- Join
- Spark Model
- Spark Compute
User Configurations
| Option Level | User Configuration Label | Label Description | Variable | User Widget | Notes | General||||
|---|---|---|---|---|---|---|---|---|---|
| Access Token | Authorization token Authorization token to accessto be used to authenticate to GitHub API | authorizationToken | Text Box | https://developer.github.com/v3/#authentication | Data retrieval options | ? | ? | ? | ? |
Design / Implementation Tips
Plugin will be implemented using third-part The GitHub Java API library, It is part of the GitHub Mylyn Connector and aims to support the entire GitHub v3 API. Authentication| Repository name | Repository name from which the data is retrieved | repoName | Text Box | |
| Repository owner name | GitHub username who owns the repository from which the data is retrieved | repoOwner | Text Box | |
GitHub API hostname | GitHub API hostname from which the data is retrieved. | hostname | Text Box | Optional, for GitHub Enterprise only. By default, api.github.com |
| Dataset* | Dataset name that you would like to retrieve** | dataset_name | Drop down | https://developer.github.com/v3/repos/ Valid values include all the objects listed in the above link. |
* Dataset name can be one of the following: Branches, Collaborators, Comments, Commits, Contents, Deploy Keys, Deployments, Forks, Invitations, Pages, Releases, Traffic:Referrers, Webhooks)
** Retrieving GitHub data would always call list API for the associated object. For instance, if Collaborators dataset was selected, the plugin would get the list of all the collaborators on the specified repository (along with other associated fields returned by List Collaborators API)
Design / Implementation Tips
Authentication will be performed using access token.
Output schema must be automatically generated from selected data. Output schema completely based on Data items. All fields are nullable strings.
References
- GitHub API v3 documentation: https://developer.github.com/v3/
- GitHub API v4 (GraphQL) documentation: https://developer.github.com/v4/
- GitHub API v3 third-part libraries: https://developer.github.com/v3/libraries/
Table of Contents
Checklist
- User stories documented
- User stories reviewed
- Design documented
- Design reviewed
- Feature merged
- Examples and guides
- Integration tests
- Documentation for feature
- Short video demonstrating the feature