Name: sonarqube-github-integration
Owner: ballerina-guides
Description: null
Created: 2018-04-11 04:47:32.0
Updated: 2018-05-01 07:15:57.0
Pushed: 2018-05-01 07:15:55.0
Homepage: null
Size: 75
Language: Ballerina
GitHub Committers
| User | Most Recent Commit | # Commits |
|---|
Other Committers
| User | Most Recent Commit | # Commits |
|---|
SonarQube is an open source platform developed by SonarSource for continuous inspection of code quality to perform automatic reviews with static analysis of code to detect bugs, code smells and security vulnerabilities. Similarly GitHub brings together the world's largest community of developers to discover, share, and build better software. From open source projects to private team repositories, GitHub is an all-in-one platform for collaborative development.
This guide walks you through the process of obtaining the test line coverage of each repository in a GitHub organization.
The following sections are covered in this guide
Let's consider a sample scenario where a user requires test line coverage of all the repositories in the organization wso2. This guide specifies how Ballerina SonarQube and GitHub endpoints can be used to get a summary of the test line coverage of all repositories in the wso2 organization.
In GitHub, there are numerous organizations that have a collection of repositories relevant to various projects, and Sonaqube contains the details regarding those projects; such as test line coverage, code duplications, and bugs.
Therefore, you need obtain the list of repositories in wso2 from GitHub and then send the repository list to Sonarqube to obtain the line coverage of each of the repositories.
The test line coverage of a repository is a significant metric that project leads require in order to get an overall understanding of the test coverage in the project.
In this example, we use the Ballerina GitHub endpoint to get a list of repositories under a specified organiztion in GitHub, and then pass that list to the Ballerina SonarQube endpoint to get the test line coverage of each repository.
Optional requirements
Ballerina is a complete programming language that can have any custom project structure that you wish. Although the language allows you to have any package structure, use the following package structure for this project to follow this guide.
-coverage-with-sonarqube-github
RepositoryLineCoverageApp
??? repository_line_coverage.bal
??? test
??? line_coverage_test.bal
README.md
Ballerina.toml
ballerina.conf
Package RepositoryLineCoverageApp contains the main Ballerina program that uses the Ballerina SonarQube and GitHub endpoints. These endpoints are used to fetch a list of repositories from a GitHub organization and then fetch the test line coverage of each of those repositories. It also contains a sub directory test that contains the tests that we write for the program.
In this section, this guide walks you through the steps in implementing the above mentioned Ballerina program.
The SonarQube and GitHub endpoints communicate with their respective APIs in order to obtain the data. Since these APIs are protected with authorization tokens, we need to configure both the SonarQube and GitHub endpoints by providing the respective access tokens.
In this guide the access tokens are read from a configuration file. So, provide the SonarQube and GitHub access tokens in the 'ballerina.conf' file under the key names SONARQUBE_TOKEN and GITHUB_TOKEN. Since the Sonarqube endpoint is dynamic, we need to specify it under the key name SONARQUBE_ENDPOINT.
UB_TOKEN=""
RQUBE_TOKEN=""
RQUBE_ENDPOINT="https://wso2.org/sonar"
First lets write the main function inside the 'repository_line_coverage.bal' file. If you are using an IDE, then this is automatically generated for you. Next define a function getLineCoverageSummary() to get the test line coverage details.
tion main(string... args) {
tion getLineCoverageSummary (int recordCount) returns json|error{
Let's start implementing the getLineCoverageSummary() function.
oint github4:Client githubEP {
clientConfig: {
auth:{
scheme:"oauth",
accessToken:config:getAsString("GITHUB_TOKEN")
}
}
Here the GitHub access token is read from the configuration file and the GitHub client is initialized.
oint sonarqube6:Client sonarqubeEP {
clientConfig: {
url:config:getAsString("SONARQUBE_ENDPOINT"),
auth:{
scheme:"basic",
username:config:getAsString("SONARQUBE_TOKEN"),
password:""
}
}
Similarly, the SonarQube token is read from the configuration file and the SonarQube client is initialized.
We need to get a specific GitHub organization in order to get all of its repositories.
github4:Organization organization;
var gitOrganizationResult = githubEP -> getOrganization("wso2");
match gitOrganizationResult {
github4:Organization org => {
organization = org;
}
github4:GitClientError err => {
return err;
}
}
github4:RepositoryList repositoryList;
var gitRepostoryResult = githubEP -> getOrganizationRepositoryList(organization, recordCount);
match gitRepostoryResult {
github4:RepositoryList repoList => {
repositoryList = repoList;
}
github4:GitClientError err => {
return err;
}
}
json summaryJson = [];
foreach i, repo in repositoryList.getAllRepositories() {
var sonarqubeProjectResult = sonarqubeEP -> getProject(repo.name);
match sonarqubeProjectResult {
sonarqube6:Project project => {
string lineCoverage = sonarqubeEP -> getLineCoverage(untaint project.key) but {error err => "0.0%"};
summaryJson[i] = {"name": repo.name, "coverage":lineCoverage};
}
error err => {
summaryJson[i] = {"name": repo.name, "coverage": "Not defined"};
}
}
}
Please refer to the repository_line_coverage.bal for the complete implementation.
After the above steps are completed, use the following command to execute the application.
<SAMPLE_ROOT_DIRECTORY>$ ballerina run RepositoryLineCoverageApp/
me":"carbon-metrics", "coverage":"85.1%"}
In Ballerina, the unit test cases should be in the same package and the naming convention should be as follows.
This guide contains the unit test case for the getLineCoverageSummary() function from the repository_line_coverage.bal.
To run the unit test, go to the sample root directory and run the following command.
SAMPLE_ROOT_DIRECTORY>$ ballerina test RepositoryLineCoverageApp/
Refer to the line_coverage_test.bal file for the implementation of the test file.
Once you are done with the development, you can deploy the service using any of the methods listed below.
You can deploy the services that you developed above in your local environment. You can create the Ballerina executable archives (.balx) first and run them in your local environment as follows.
Building
<SAMPLE_ROOT_DIRECTORY>$ ballerina build RepositoryLineCoverageApp/
After build is successful, there will be a .balx file inside the target directory. That executable can be
executed as follows.
Running
<SAMPLE_ROOT_DIRECTORY>$ ballerina run <Exec_Archive_File_Name>