Gooddata-sdk

Release notes
These release notes summarize changes contained in the Python SDK 1.1 release. Please ensure you are using the latest version of GoodData.CN (2.1) or GoodData Cloud before trying these out.

Improvements to working with entities:

* Added support for dependent entities graph. Dependent entities graph is a directed graph containing information on entity (dataset, metric, insight) dependency. We can further utilize this object with the NetworkX package.

Support for managing declarative layouts.

* Workspace
You can receive, change, store (in your local storage), and load the workspace layout from your local storage.


Other changes:

* Documentation on pypi.org now points to the relevant documentation.
* For every imported foreign table that was imported using gooddata-fdw, a corresponding view is automatically created. This change prevents issues in some tools, such as PowerBI, that do not support foreign tables.
* GoodPandas now supports [subtotals and grandtotals](https://www.gooddata.com/developers/cloud-native/doc/2.0/create-visualizations/visualization-types/pivot-tables/#table-totals).
* GoodPandas now supports the creation of DataFrames using an ExecutionDefinition and respecting the dimensionality specified in the ExecutionDefinition.

Commits
- f36a5c1: NAS-4150 set AIO in docker compose to supported version (Pavel Cerny) [123](https://github.com/gooddata/gooddata-python-sdk/pull/123)
- 22d0f64: NAS-4150 support test-ci target against local AIO (Pavel Cerny) [123](https://github.com/gooddata/gooddata-python-sdk/pull/123)
- 87bdad6: NAS-4150 fix load and put workspaces test (Pavel Cerny) [123](https://github.com/gooddata/gooddata-python-sdk/pull/123)
- b385508: TNT-939 Update fixture for pop date item according to api specification (Petr Benes) [124](https://github.com/gooddata/gooddata-python-sdk/pull/124)
- ba3b695: TNT-940 Fix sorts in layout fixture (Petr Benes) [124](https://github.com/gooddata/gooddata-python-sdk/pull/124)
- 7b42b82: Recreate cassettes after fixture change (Petr Benes) [124](https://github.com/gooddata/gooddata-python-sdk/pull/124)
- 5a5c0ea: XSH-711 Allow building alpha-versions of the repo (Dominik Sauer) [125](https://github.com/gooddata/gooddata-python-sdk/pull/125)
- 955c52e: XSH-711 Create github workflow to publish master as alpha version (Dominik Sauer) [128](https://github.com/gooddata/gooddata-python-sdk/pull/128)
- 4b5680c: Updated the way TOC is defined for Python SDK Services page in docs (Andy Chumak) [129](https://github.com/gooddata/gooddata-python-sdk/pull/129)
- 80a5682: Fix docstring annotations for better rendering online (Andy Chumak) [131](https://github.com/gooddata/gooddata-python-sdk/pull/131)
- 9124e73: XSH-733: Enhance exec response and result (Lubo Slivka) [130](https://github.com/gooddata/gooddata-python-sdk/pull/130)
- b6d9902: XSH-733: Include totals in execution definition (Lubo Slivka) [130](https://github.com/gooddata/gooddata-python-sdk/pull/130)
- f8a5d8c: XSH-733: Add factory to create data frames from raw exec definition (Lubo Slivka) [130](https://github.com/gooddata/gooddata-python-sdk/pull/130)
- 0bb45e0: XSH-733: Regenerate afm-client to allow fetching ResultCacheMetadata (Roman Hartig) [130](https://github.com/gooddata/gooddata-python-sdk/pull/130)
- 602c159: XSH-733: Get dimension indexes from ExecutionResponse (Roman Hartig) [130](https://github.com/gooddata/gooddata-python-sdk/pull/130)
- 20e8895: XSH-733: Construct dataframe using execution result ID (Roman Hartig) [130](https://github.com/gooddata/gooddata-python-sdk/pull/130)
- 5ba5c00: XSH-733: Explain ExecutionResponse parsing TODOs (Roman Hartig) [130](https://github.com/gooddata/gooddata-python-sdk/pull/130)
- b7a8b28: XSH-733: Add dimension labels into Dataframe (Roman Hartig) [130](https://github.com/gooddata/gooddata-python-sdk/pull/130)
- 395d19e: XSH-733: Add label overrides argument to dataframe creation flow (Roman Hartig) [130](https://github.com/gooddata/gooddata-python-sdk/pull/130)
- b8af7bb: XSH-733: Polish convertor and execution codebase (Roman Hartig) [130](https://github.com/gooddata/gooddata-python-sdk/pull/130)
- b29899e: XSH-733: Use dev_latest in docker-compose (Roman Hartig) [130](https://github.com/gooddata/gooddata-python-sdk/pull/130)
- extend list of classes exported from SDK init [132](https://github.com/gooddata/gooddata-python-sdk/pull/132) ([Jacek](https://github.com/gooddata/gooddata-python-sdk/commit/585af3e1f499cf8abf7370b2aefd61d76eefd154))
- 92e6f06: NAS-4244 OAPI generator version upgrade (hkad98) [133](https://github.com/gooddata/gooddata-python-sdk/pull/133)
- e7e6238: NAS-4244 generated clients (hkad98) [133](https://github.com/gooddata/gooddata-python-sdk/pull/133)
- 0bafcea: NAS-4244 wrapper fix (hkad98) [133](https://github.com/gooddata/gooddata-python-sdk/pull/133)
- 19b965d: NAS-4244 fixtures and expected behaviour update (hkad98) [133](https://github.com/gooddata/gooddata-python-sdk/pull/133)
- 12c8ed2: NAS-4254 fixed default values for immutable attributes (hkad98) [134](https://github.com/gooddata/gooddata-python-sdk/pull/134)
- f7f1ace: NAS-4254 place CatalogWorkspaceContentService to separate file (hkad98) [134](https://github.com/gooddata/gooddata-python-sdk/pull/134)
- sonar fix [135](https://github.com/gooddata/gooddata-python-sdk/pull/135) ([hkad98](https://github.com/gooddata/gooddata-python-sdk/commit/ca518c597710d17e76c7a4b21a1ba20e847a592e))
- dual sonar setup [136](https://github.com/gooddata/gooddata-python-sdk/pull/136) ([Pavel Cerny](https://github.com/gooddata/gooddata-python-sdk/commit/7215331d57abf0a8974cd18ebcf59f8957369798))
- 2f28a79: NAS-4254 manage dependent entities graph (hkad98) [134](https://github.com/gooddata/gooddata-python-sdk/pull/134)
- 45662ae: NAS-4254 test support (hkad98) [134](https://github.com/gooddata/gooddata-python-sdk/pull/134)
- 4be0e46: NAS-4268 create view related to foreign table (hkad98) [138](https://github.com/gooddata/gooddata-python-sdk/pull/138)
- 1ecc615: NAS-4110 make documentation point to related version (hkad98) [139](https://github.com/gooddata/gooddata-python-sdk/pull/139)
- a7cbe00: XSH-752 Limit the result size before downloading whole result (Dominik Sauer) [140](https://github.com/gooddata/gooddata-python-sdk/pull/140)
- f275cb7: XSH-752 Don't use mutable defaults for label_overrides (Dominik Sauer) [140](https://github.com/gooddata/gooddata-python-sdk/pull/140)
- b34db48: regenerate_clients (hkad98) [142](https://github.com/gooddata/gooddata-python-sdk/pull/142)
- 415a122: NAS-4284 documentation update + minor changes (hkad98) [141](https://github.com/gooddata/gooddata-python-sdk/pull/141)
- 5b6455e: XSH-783 Export type for label_overrides (Dominik Sauer) [143](https://github.com/gooddata/gooddata-python-sdk/pull/143)
- 403f808: NAS-4305 fix creat VIEW custom_schema (hkad98) [144](https://github.com/gooddata/gooddata-python-sdk/pull/144)
- eaa6683: NAS-4246 tests support package (hkad98) [145](https://github.com/gooddata/gooddata-python-sdk/pull/145)
- 6bdf68c: NAS-4246 upgrade dependencies version (hkad98) [145](https://github.com/gooddata/gooddata-python-sdk/pull/145)
- e452190: NAS-4246 change (de)serialization for cassettes (hkad98) [145](https://github.com/gooddata/gooddata-python-sdk/pull/145)
- 8c68567: NAS-4246 fixtures (hkad98) [145](https://github.com/gooddata/gooddata-python-sdk/pull/145)
- 72aee3e: Regenerate clients (hkad98) [146](https://github.com/gooddata/gooddata-python-sdk/pull/146)
- f01af7e: Fix classes (hkad98) [146](https://github.com/gooddata/gooddata-python-sdk/pull/146)
- 8af11bb: Updated cassettes (hkad98) [146](https://github.com/gooddata/gooddata-python-sdk/pull/146)
- 5a5aef1: FIX documentation url (hkad98) [147](https://github.com/gooddata/gooddata-python-sdk/pull/147)
- 1cff88f: Bump to 1.1.0 (hkad98) [148](https://github.com/gooddata/gooddata-python-sdk/pull/148)

Release notes
These release notes summarize changes contained in the Python SDK 1.0 release. Please ensure you are using the latest version of GoodData.CN (2.0) or GoodData Cloud before trying these out.

Improvements to working with entities:

- Added support for CRUD operations that reproduce user and user group entity API functionality.
- Added support for the organization for managing OIDC settings and changing the organization name.

Support for managing declarative layouts.

- We have added a series of functions that let you work with:
- [Workspace data filter layout](https://gooddata-sdk.readthedocs.io/en/v1.0.0/services/catalog-workspace.html)
You can receive a workspace data filter layout, change the data filter layout, store the layout in your local storage, and load the layout from your local storage.
- [User layout](https://gooddata-sdk.readthedocs.io/en/v1.0.0/services/catalog-user.html)
You can receive user metadata, change user layout, store layout in your local storage, and load layout from your local storage.
- [User group layout](https://gooddata-sdk.readthedocs.io/en/v1.0.0/services/catalog-user.html)
You can receive user group metadata, change user group layouts, store layouts in your local storage, and load layouts from your local storage.
- [ User and user group layout](https://gooddata-sdk.readthedocs.io/en/v1.0.0/services/catalog-user.html)
For a better user experience, you can work with both user and user groups simultaneously.
- [Permission layout (related to workspaces)](https://gooddata-sdk.readthedocs.io/en/v1.0.0/services/catalog-permission.html)
You can receive permissions information, change permission layouts, store layouts in your local storage, and load layouts from your local storage.

- Other changes:

- We started using popular Python libraries `attrs` and `cattrs` for the layer between the user and generated OAPI clients. The libraries are used in declarative layouts and some entity classes at the moment. This should make for a more enjoyable and efficient development experience. We want to extend the use of third-party libraries as much as possible.
- We added support for Python 3.10.



Commits
- 5e1c227: NAS-3695 minor fixes (hkad98) [101](https://github.com/gooddata/gooddata-python-sdk/pull/101)
- 7a0172f: NAS-3695 updated test layout with short IDs and extended analytics model (hkad98) [101](https://github.com/gooddata/gooddata-python-sdk/pull/101)
- 3f5f37d: NAS-3695 updated fixtures and files for testing (hkad98) [101](https://github.com/gooddata/gooddata-python-sdk/pull/101)
- 8ef6547: NAS-3793: Bump latest python version to 3.10 (Jacek) [102](https://github.com/gooddata/gooddata-python-sdk/pull/102)
- 64939b0: NAS-3782 reimplemented declarative classes with attrs and cattrs (hkad98) [103](https://github.com/gooddata/gooddata-python-sdk/pull/103)
- cf06280: NAS-3743 extended tests-support (hkad98) [104](https://github.com/gooddata/gooddata-python-sdk/pull/104)
- 6a286ba: NAS-3743 added user service (hkad98) [104](https://github.com/gooddata/gooddata-python-sdk/pull/104)
- 5e1e572: NAS-3743 user service test support (hkad98) [104](https://github.com/gooddata/gooddata-python-sdk/pull/104)
- relax version of PyYAML library [105](https://github.com/gooddata/gooddata-python-sdk/pull/105) ([Jacek](https://github.com/gooddata/gooddata-python-sdk/commit/d464f2f5a4edbf04dff99119cb087365b0f2e8d1))
- 9443af4: NAS-3276 fixed future warning in GoodPandas (hkad98) [106](https://github.com/gooddata/gooddata-python-sdk/pull/106)
- b8c5686: NAS-2884 fixed empty dataframe (hkad98) [107](https://github.com/gooddata/gooddata-python-sdk/pull/107)
- 5fc4640: NAS-3868 extend user and organization service (hkad98) [108](https://github.com/gooddata/gooddata-python-sdk/pull/108)
- 3947909: NAS-3868 test support for implementation (hkad98) [108](https://github.com/gooddata/gooddata-python-sdk/pull/108)
- f3c8abd: NAS-3911 generator and docker image version update (hkad98) [109](https://github.com/gooddata/gooddata-python-sdk/pull/109)
- f2f60bb: NAS-3911 updated client modules (hkad98) [109](https://github.com/gooddata/gooddata-python-sdk/pull/109)
- 2140cd2: NAS-3911 updated tests-support (hkad98) [109](https://github.com/gooddata/gooddata-python-sdk/pull/109)
- e4edecb: NAS-3911 updated entity/declarative classes (hkad98) [109](https://github.com/gooddata/gooddata-python-sdk/pull/109)
- 9f3114d: NAS-3911 updated test files (hkad98) [109](https://github.com/gooddata/gooddata-python-sdk/pull/109)
- 5043d6e: NAS-3911 updated fixtures and additional files for tests (hkad98) [109](https://github.com/gooddata/gooddata-python-sdk/pull/109)
- b97bfb3: NAS-3996 control implementation (hkad98) [110](https://github.com/gooddata/gooddata-python-sdk/pull/110)
- 5a5a0de: NAS-3996 test support (hkad98) [110](https://github.com/gooddata/gooddata-python-sdk/pull/110)
- e7ee1bf: NAS-4011 update clients (hkad98) [111](https://github.com/gooddata/gooddata-python-sdk/pull/111)
- 0ead7be: NAS-3893 add permission service (hkad98) [112](https://github.com/gooddata/gooddata-python-sdk/pull/112)
- de520d0: NAS-3749 fix table_prefix ignored (hkad98) [113](https://github.com/gooddata/gooddata-python-sdk/pull/113)
- 5638e5a: NAS-4024 fix minor inconsistency (hkad98) [114](https://github.com/gooddata/gooddata-python-sdk/pull/114)
- b1da9f0: NAS-4034 add UsersAndUserGroups support (hkad98) [116](https://github.com/gooddata/gooddata-python-sdk/pull/116)
- 4d2402c: NAS-3912 fix add classes (hkad98) [115](https://github.com/gooddata/gooddata-python-sdk/pull/115)
- 35e8ef5: NAS-3912 base doc changes (hkad98) [115](https://github.com/gooddata/gooddata-python-sdk/pull/115)
- fe115dd: NAS-3912 new features + fix (hkad98) [115](https://github.com/gooddata/gooddata-python-sdk/pull/115)
- 037c4eb: NAS-3912 changed development status (hkad98) [115](https://github.com/gooddata/gooddata-python-sdk/pull/115)
- f706cb7: NAS-4076 update license files for release 1.0.0 (hkad98) [118](https://github.com/gooddata/gooddata-python-sdk/pull/118)
- 7c0168b: NAS-4105 extend import from the gooddata_sdk (hkad98) [119](https://github.com/gooddata/gooddata-python-sdk/pull/119)
- 002773b: Bump to 1.0.0 (hkad98) [120](https://github.com/gooddata/gooddata-python-sdk/pull/120)

Release notes
These release notes summarize changes contained in the Python SDK 0.8 release. Please ensure you are using the latest version of GoodData.CN (1.7) before trying these out.

Improvements to working with entities:

- Added support for CRUD operations that reproduce entity API functionality for workspace and data source entities.
- You can now get lists of workspace content such as facts, metrics, and attributes.
- Added methods for scanning data sources and generating the physical and logical data models.
- Added support for call upload notification API (invalidate caches when new ETL finishes).

Support for managing declarative layouts:

- We have added a series of functions that let you work with:
- Workspace layouts. This includes workspaces, workspace data filters, analytics models, and logical data models.
- Workspace content layouts. This includes the analytics and logical data models. You have an option to replace data source ID in an analytical data model easily.
- Data source layouts. This includes the physical data model and management of credentials, and it also contains support for testing data sources (test API).
- You are able to store declarative layouts in your local storage. Stored layouts are saved into a directory hierarchy reflecting the real hierarchy of the metadata objects.
- Added a new method for collecting organization ID, which is part of the directory structure. This enables working with multiple organizations.

Other changes:

- Added SupportService for checking if GoodData.CN metadata APIs are available.