# GoodData Python SDK
The `gooddata-sdk` package provides a clean and convenient Python API to interact with [GoodData](https://www.gooddata.com/).
At the moment the SDK provides services to inspect and interact with the Semantic Model and consume analytics:
* Catalog Workspaces Service
* Catalog Workspace Content Service
* Catalog Data Source Service
* Catalog User Service
* Catalog Permission Service
* Catalog Organization Service
* Visualizations Service
* Compute Service
* Table Service
See [DOCUMENTATION](https://www.gooddata.com/docs/python-sdk/1.33.0) for more details.
## Requirements
- GoodData Cloud or GoodData.CN installation
- Python 3.9 or newer
## Installation
Run the following command to install the `gooddata-sdk` package on your system:
pip install gooddata-sdk
## Example
Compute an visualization:
```python
import gooddata_sdk
# GoodData host in the form of uri
host = "http://localhost:3000"
# GoodData user token
token = "some_user_token"
sdk = gooddata_sdk.GoodDataSdk.create(host, token)
workspace_id = "demo"
visualization_id = "customers_trend"
# reads visualization from workspace
visualization = sdk.visualizations.get_visualization(workspace_id, visualization_id)
# triggers computation for the visualization. the result will be returned in a tabular form
table = sdk.tables.for_visualization(workspace_id, visualization)
# and this is how you can read data row-by-row and do something with it
for row in table.read_all():
print(row)
```
## Bugs & Requests
Please use the [GitHub issue tracker](https://github.com/gooddata/gooddata-python-sdk/issues) to submit bugs
or request features.
## Changelog
See [Github releases](https://github.com/gooddata/gooddata-python-sdk/releases) for released versions
and a list of changes.
Raw data
{
"_id": null,
"home_page": null,
"name": "gooddata-sdk",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.9.0",
"maintainer_email": null,
"keywords": "gooddata, sdk, api, analytics, headless, business, intelligence, headless-bi, cloud, native, semantic, layer, sql, metrics",
"author": "GoodData",
"author_email": "support@gooddata.com",
"download_url": "https://files.pythonhosted.org/packages/cf/c7/d1ef2f34f4368b9766b7012d6f7ca1a7cd936969fec38ebb84e65ac248b7/gooddata_sdk-1.33.0.tar.gz",
"platform": null,
"description": "# GoodData Python SDK\n\nThe `gooddata-sdk` package provides a clean and convenient Python API to interact with [GoodData](https://www.gooddata.com/).\n\nAt the moment the SDK provides services to inspect and interact with the Semantic Model and consume analytics:\n* Catalog Workspaces Service\n* Catalog Workspace Content Service\n* Catalog Data Source Service\n* Catalog User Service\n* Catalog Permission Service\n* Catalog Organization Service\n* Visualizations Service\n* Compute Service\n* Table Service\n\nSee [DOCUMENTATION](https://www.gooddata.com/docs/python-sdk/1.33.0) for more details.\n\n## Requirements\n\n- GoodData Cloud or GoodData.CN installation\n- Python 3.9 or newer\n\n## Installation\n\nRun the following command to install the `gooddata-sdk` package on your system:\n\n pip install gooddata-sdk\n\n## Example\n\nCompute an visualization:\n```python\nimport gooddata_sdk\n\n# GoodData host in the form of uri\nhost = \"http://localhost:3000\"\n# GoodData user token\ntoken = \"some_user_token\"\nsdk = gooddata_sdk.GoodDataSdk.create(host, token)\n\nworkspace_id = \"demo\"\nvisualization_id = \"customers_trend\"\n# reads visualization from workspace\nvisualization = sdk.visualizations.get_visualization(workspace_id, visualization_id)\n# triggers computation for the visualization. the result will be returned in a tabular form\ntable = sdk.tables.for_visualization(workspace_id, visualization)\n\n# and this is how you can read data row-by-row and do something with it\nfor row in table.read_all():\n print(row)\n```\n\n\n## Bugs & Requests\n\nPlease use the [GitHub issue tracker](https://github.com/gooddata/gooddata-python-sdk/issues) to submit bugs\nor request features.\n\n## Changelog\n\nSee [Github releases](https://github.com/gooddata/gooddata-python-sdk/releases) for released versions\nand a list of changes.\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "GoodData Cloud Python SDK",
"version": "1.33.0",
"project_urls": {
"Documentation": "https://www.gooddata.com/docs/python-sdk/1.33.0",
"Source": "https://github.com/gooddata/gooddata-python-sdk"
},
"split_keywords": [
"gooddata",
" sdk",
" api",
" analytics",
" headless",
" business",
" intelligence",
" headless-bi",
" cloud",
" native",
" semantic",
" layer",
" sql",
" metrics"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "4d2750f84379b2326b84a703ac1d6f02267a1233f872a228cf86dcf9336d3d22",
"md5": "7cce4f53ea6f230a61d8cd25b2d8b0fd",
"sha256": "51336b69cec1cb95725afd3d42346a3d8fe5589f6992d141703a743628782d1a"
},
"downloads": -1,
"filename": "gooddata_sdk-1.33.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "7cce4f53ea6f230a61d8cd25b2d8b0fd",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9.0",
"size": 166546,
"upload_time": "2024-12-12T12:30:40",
"upload_time_iso_8601": "2024-12-12T12:30:40.120816Z",
"url": "https://files.pythonhosted.org/packages/4d/27/50f84379b2326b84a703ac1d6f02267a1233f872a228cf86dcf9336d3d22/gooddata_sdk-1.33.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "cfc7d1ef2f34f4368b9766b7012d6f7ca1a7cd936969fec38ebb84e65ac248b7",
"md5": "f49ca6c03daf3bbeaa6938d23ba98d94",
"sha256": "890a496961e0fb1fe0b488d33ddea8d497e5d2644c3370f991ddc308a4149039"
},
"downloads": -1,
"filename": "gooddata_sdk-1.33.0.tar.gz",
"has_sig": false,
"md5_digest": "f49ca6c03daf3bbeaa6938d23ba98d94",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9.0",
"size": 122840,
"upload_time": "2024-12-12T12:30:46",
"upload_time_iso_8601": "2024-12-12T12:30:46.327472Z",
"url": "https://files.pythonhosted.org/packages/cf/c7/d1ef2f34f4368b9766b7012d6f7ca1a7cd936969fec38ebb84e65ac248b7/gooddata_sdk-1.33.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-12-12 12:30:46",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "gooddata",
"github_project": "gooddata-python-sdk",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "gooddata-sdk"
}
JSON
