Skip to main content

Sonar API Wrapper - a Sonarqube api wrapper

Project description

Sonar API Wrapper

Sonar API Wrapper - a Sonarqube api wrapper

Install

pip install sonar-api-wrapper

How to use

api_call

Executes an API call to SonarQube. This method wraps the requests.request method.

Parameters

  • method (str): HTTP method to use (e.g., GET, POST, etc.).
  • route (str): API path that will be concatenated with base_path. For example, qualityprofiles/search.
  • parameters (dict | None): Dictionary of parameters for the API call. Default is None.
  • body (dict | None): Body of the request. Default is None.
  • files (Any): Files to be sent in the request. Default is None.
  • headers (dict | None): Headers of the request. Default is None.
  • is_json (bool): If set to True, the response will be parsed as JSON. Otherwise, it returns the decoded content. Default is True.
  • username (str | None): Username used for authentication. Default is set via the environment variable SONAR_USERNAME or "admin".
  • password (str | None): Password used for authentication. Default is set via the environment variable SONAR_PASSWORD or "admin".
  • token (str | None): Token used for authentication. It overrides username and password if present. Default value is set via the environment variable SONAR_TOKEN or None.
  • base_path (str | None): The base endpoint used to build the API call. Default is set via the environment variable DEFAULT_SONAR_ENDPOINT or "http://localhost:9000/api/".

Returns

Returns the API response as list[dict], dict, or any other type based on the response content or raises an exception.

Example

import os

from sonar_api_wrapper import api_call

# override default access config
os.environ['SONAR_PASSWORD'] = 'Username'
os.environ['SONAR_PASSWORD'] = 'YourPassword'
os.environ['DEFAULT_SONAR_ENDPOINT'] = 'https://yours.sonarqube/api/'

response = api_call('GET', 'qualityprofiles/search', parameters={
    'defaults': 'true'
})

print(f'{response["projects"] = }')

Exceptions

Exceptions are raised based on HTTP errors or other request issues.

Develop

Install - Dev

The dev install is only required if additional development is needed for this library

pip install -e '.[dev]'

Build the library

Run the command:

python -m build -w

Publish the library

python -m twine upload dist/*

Test the library

Run the test with command:

pytest

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distribution

sonar_api_wrapper-1.1.0-py3-none-any.whl (6.1 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page