Class: Pantograph::Actions::SonarAction
- Inherits:
-
Pantograph::Action
- Object
- Pantograph::Action
- Pantograph::Actions::SonarAction
- Defined in:
- pantograph/lib/pantograph/actions/sonar.rb
Constant Summary
Constants inherited from Pantograph::Action
Pantograph::Action::AVAILABLE_CATEGORIES, Pantograph::Action::RETURN_TYPES
Documentation collapse
- .authors ⇒ Object
- .available_options ⇒ Object
- .category ⇒ Object
- .description ⇒ Object
- .details ⇒ Object
- .example_code ⇒ Object
- .is_supported?(platform) ⇒ Boolean
- .return_value ⇒ Object
Class Method Summary collapse
Methods inherited from Pantograph::Action
action_name, author, deprecated_notes, lane_context, method_missing, other_action, output, return_type, sample_return_value, shell_out_should_use_bundle_exec?, step_text
Class Method Details
.authors ⇒ Object
129 130 131 |
# File 'pantograph/lib/pantograph/actions/sonar.rb', line 129 def self. ['c_gretzki'] end |
.available_options ⇒ Object
54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 |
# File 'pantograph/lib/pantograph/actions/sonar.rb', line 54 def self. [ PantographCore::ConfigItem.new(key: :project_configuration_path, env_name: 'SONAR_RUNNER_PROPERTIES_PATH', description: 'The path to your sonar project configuration file; defaults to `sonar-project.properties`', # default is enforced by sonar-scanner binary optional: true, verify_block: proc do |value| UI.user_error!("Couldn't find file at path '#{value}'") unless value.nil? || File.exist?(value) end), PantographCore::ConfigItem.new(key: :project_key, env_name: 'SONAR_RUNNER_PROJECT_KEY', description: 'The key sonar uses to identify the project, e.g. `name.gretzki.awesomeApp`. Must either be specified here or inside the sonar project configuration file', optional: true), PantographCore::ConfigItem.new(key: :project_name, env_name: 'SONAR_RUNNER_PROJECT_NAME', description: 'The name of the project that gets displayed on the sonar report page. Must either be specified here or inside the sonar project configuration file', optional: true), PantographCore::ConfigItem.new(key: :project_version, env_name: 'SONAR_RUNNER_PROJECT_VERSION', description: "The project's version that gets displayed on the sonar report page. Must either be specified here or inside the sonar project configuration file", optional: true), PantographCore::ConfigItem.new(key: :sources_path, env_name: 'SONAR_RUNNER_SOURCES_PATH', description: 'Comma-separated paths to directories containing source files. Must either be specified here or inside the sonar project configuration file', optional: true), PantographCore::ConfigItem.new(key: :project_language, env_name: 'SONAR_RUNNER_PROJECT_LANGUAGE', description: 'Language key, e.g. objc', optional: true), PantographCore::ConfigItem.new(key: :source_encoding, env_name: 'SONAR_RUNNER_SOURCE_ENCODING', description: 'Used encoding of source files, e.g., UTF-8', optional: true), PantographCore::ConfigItem.new(key: :sonar_runner_args, env_name: 'SONAR_RUNNER_ARGS', description: 'Pass additional arguments to sonar-scanner. Be sure to provide the arguments with a leading `-D` e.g. SONAR_RUNNER_ARGS=\"-Dsonar.verbose=true\"', optional: true), PantographCore::ConfigItem.new(key: :sonar_login, env_name: 'SONAR_LOGIN', description: 'Pass the Sonar Login token (e.g: xxxxxxprivate_token_XXXXbXX7e)', optional: true, type: String, sensitive: true), PantographCore::ConfigItem.new(key: :sonar_url, env_name: 'SONAR_URL', description: 'Pass the url of the Sonar server', optional: true, type: String), PantographCore::ConfigItem.new(key: :branch_name, env_name: 'SONAR_RUNNER_BRANCH_NAME', description: 'Pass the branch name which is getting scanned', optional: true, type: String), PantographCore::ConfigItem.new(key: :pull_request_branch, env_name: 'SONAR_RUNNER_PULL_REQUEST_BRANCH', description: 'The name of the branch that contains the changes to be merged', optional: true, type: String), PantographCore::ConfigItem.new(key: :pull_request_base, env_name: 'SONAR_RUNNER_PULL_REQUEST_BASE', description: 'The long-lived branch into which the PR will be merged', optional: true, type: String), PantographCore::ConfigItem.new(key: :pull_request_key, env_name: 'SONAR_RUNNER_PULL_REQUEST_KEY', description: 'Unique identifier of your PR. Must correspond to the key of the PR in GitHub or TFS', optional: true, type: String) ] end |
.category ⇒ Object
148 149 150 |
# File 'pantograph/lib/pantograph/actions/sonar.rb', line 148 def self.category :testing end |
.description ⇒ Object
46 47 48 |
# File 'pantograph/lib/pantograph/actions/sonar.rb', line 46 def self.description 'Invokes sonar-scanner to programmatically run SonarQube analysis' end |
.details ⇒ Object
50 51 52 |
# File 'pantograph/lib/pantograph/actions/sonar.rb', line 50 def self.details 'See [http://docs.sonarqube.org/display/SCAN/Analyzing+with+SonarQube+Scanner](http://docs.sonarqube.org/display/SCAN/Analyzing+with+SonarQube+Scanner) for details.' end |
.example_code ⇒ Object
137 138 139 140 141 142 143 144 145 146 |
# File 'pantograph/lib/pantograph/actions/sonar.rb', line 137 def self.example_code [ 'sonar( project_key: "name.gretzki.awesomeApp", project_version: "1.0", project_name: "AwesomeApp", sources_path: File.expand_path("../AwesomeApp") )' ] end |
.is_supported?(platform) ⇒ Boolean
133 134 135 |
# File 'pantograph/lib/pantograph/actions/sonar.rb', line 133 def self.is_supported?(platform) true end |
.return_value ⇒ Object
125 126 127 |
# File 'pantograph/lib/pantograph/actions/sonar.rb', line 125 def self.return_value 'The exit code of the sonar-scanner binary' end |
.run(params) ⇒ Object
4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 |
# File 'pantograph/lib/pantograph/actions/sonar.rb', line 4 def self.run(params) verify_sonar_scanner_binary command_prefix = [ 'cd', File.('.').shellescape, '&&' ].join(' ') sonar_scanner_args = [] sonar_scanner_args << "-Dproject.settings=\"#{params[:project_configuration_path]}\"" if params[:project_configuration_path] sonar_scanner_args << "-Dsonar.projectKey=\"#{params[:project_key]}\"" if params[:project_key] sonar_scanner_args << "-Dsonar.projectName=\"#{params[:project_name]}\"" if params[:project_name] sonar_scanner_args << "-Dsonar.projectVersion=\"#{params[:project_version]}\"" if params[:project_version] sonar_scanner_args << "-Dsonar.sources=\"#{params[:sources_path]}\"" if params[:sources_path] sonar_scanner_args << "-Dsonar.language=\"#{params[:project_language]}\"" if params[:project_language] sonar_scanner_args << "-Dsonar.sourceEncoding=\"#{params[:source_encoding]}\"" if params[:source_encoding] sonar_scanner_args << "-Dsonar.login=\"#{params[:sonar_login]}\"" if params[:sonar_login] sonar_scanner_args << "-Dsonar.host.url=\"#{params[:sonar_url]}\"" if params[:sonar_url] sonar_scanner_args << "-Dsonar.branch.name=\"#{params[:branch_name]}\"" if params[:branch_name] sonar_scanner_args << "-Dsonar.pullrequest.branch=\"#{params[:pull_request_branch]}\"" if params[:pull_request_branch] sonar_scanner_args << "-Dsonar.pullrequest.base=\"#{params[:pull_request_base]}\"" if params[:pull_request_base] sonar_scanner_args << "-Dsonar.pullrequest.key=\"#{params[:pull_request_key]}\"" if params[:pull_request_key] sonar_scanner_args << params[:sonar_runner_args] if params[:sonar_runner_args] command = [ command_prefix, 'sonar-scanner', sonar_scanner_args ].join(' ') # hide command, as it may contain credentials Pantograph::Actions.sh_control_output(command, print_command: false, print_command_output: true) end |
.verify_sonar_scanner_binary ⇒ Object
38 39 40 |
# File 'pantograph/lib/pantograph/actions/sonar.rb', line 38 def self.verify_sonar_scanner_binary UI.user_error!("You have to install sonar-scanner using `brew install sonar-scanner`") unless `which sonar-scanner`.to_s.length > 0 end |