Title: Docs cleanup: fix Client constructor examples and document new SDK features · Issue #27 · lightdash/python-sdk · GitHub
Open Graph Title: Docs cleanup: fix Client constructor examples and document new SDK features · Issue #27 · lightdash/python-sdk
X Title: Docs cleanup: fix Client constructor examples and document new SDK features · Issue #27 · lightdash/python-sdk
Description: Tracking issue for a docs pass (to be bundled with the upcoming bulk docs update). Kept separate from the feature PRs to keep those small. Bugs to fix docs/SDK_GUIDE.md uses the wrong Client(...) signature. Lines 10 and ~383 show Client(...
Open Graph Description: Tracking issue for a docs pass (to be bundled with the upcoming bulk docs update). Kept separate from the feature PRs to keep those small. Bugs to fix docs/SDK_GUIDE.md uses the wrong Client(...) s...
X Description: Tracking issue for a docs pass (to be bundled with the upcoming bulk docs update). Kept separate from the feature PRs to keep those small. Bugs to fix docs/SDK_GUIDE.md uses the wrong Client(...) s...
Opengraph URL: https://github.com/lightdash/python-sdk/issues/27
X: @github
Domain: github.com
{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"Docs cleanup: fix Client constructor examples and document new SDK features","articleBody":"Tracking issue for a docs pass (to be bundled with the upcoming bulk docs update). Kept separate from the feature PRs to keep those small.\n\n## Bugs to fix\n- **`docs/SDK_GUIDE.md` uses the wrong `Client(...)` signature.** Lines [10](https://github.com/lightdash/python-sdk/blob/main/docs/SDK_GUIDE.md#L10) and ~383 show `Client(base_url=..., token=...)`, but the real constructor is `Client(instance_url=..., access_token=..., project_uuid=...)` (the README is correct). Copy-pasting the guide snippet currently fails.\n\n## Features to document (landing via open/merged PRs)\n- **Multiple filters on the same dimension field** — e.g. date ranges `(dim \u003e= a) \u0026 (dim \u003c= b)` (#20, merged in #22). *(SDK_GUIDE already updated in that PR — verify it reads well.)*\n- **Filtering on table calculations** — `TableCalculation` + `.table_calculations(...)` + filtering on calc values (#21, PR #24).\n- **Fetching results beyond 50k** — limits are now validated against the instance's `query.maxLimit` instead of a fixed cap; large fetches page at `maxPageSize` (#19, PR #25). Note the CSV-export path for \u003e`maxLimit` extracts is still tracked in #19.\n- **Service account tokens** — `ldsvc_` tokens now authenticate via `Bearer` automatically (#17, PR #18). A short README note was added in that PR; consider mirroring it in the SDK guide / any auth section.\n\n## Nice-to-have\n- Align the `SDK_GUIDE.md` Quick Start with the README (same constructor, same auth guidance).","author":{"url":"https://github.com/jpetey75","@type":"Person","name":"jpetey75"},"datePublished":"2026-06-26T19:27:40.000Z","interactionStatistic":{"@type":"InteractionCounter","interactionType":"https://schema.org/CommentAction","userInteractionCount":1},"url":"https://github.com/27/python-sdk/issues/27"}
| route-pattern | /_view_fragments/issues/show/:user_id/:repository/:id/issue_layout(.:format) |
| route-controller | voltron_issues_fragments |
| route-action | issue_layout |
| fetch-nonce | v2:f09c7baa-7076-390a-1fe9-2606baa0db2d |
| current-catalog-service-hash | 81bb79d38c15960b92d99bca9288a9108c7a47b18f2423d0f6438c5b7bcd2114 |
| request-id | D7BE:232221:B81587:BC1B5C:6A4DB7D0 |
| html-safe-nonce | 5bd716c3925ba968fb9136c99416a69b63280e8dd3aaf2793c1ab977a066501a |
| visitor-payload | eyJyZWZlcnJlciI6IiIsInJlcXVlc3RfaWQiOiJEN0JFOjIzMjIyMTpCODE1ODc6QkMxQjVDOjZBNERCN0QwIiwidmlzaXRvcl9pZCI6IjcyOTUzMzE1MTExNzUwNjc2MDEiLCJyZWdpb25fZWRnZSI6InNlYSIsInJlZ2lvbl9yZW5kZXIiOiJzZWEifQ== |
| visitor-hmac | 94644fc50e44a0ee3cfbd834ba3f0e95fe4a432607d47df13c2665c1846cc87a |
| hovercard-subject-tag | issue:4754602006 |
| github-keyboard-shortcuts | repository,issues,copilot |
| google-site-verification | Apib7-x98H0j5cPqHWwSMm6dNU4GmODRoqxLiDzdx9I |
| octolytics-url | https://collector.github.com/github/collect |
| analytics-location | / |
| fb:app_id | 1401488693436528 |
| apple-itunes-app | app-id=1477376905, app-argument=https://github.com/_view_fragments/issues/show/lightdash/python-sdk/27/issue_layout |
| twitter:image | https://opengraph.githubassets.com/f391332d6c9a0aea3eb40f783c7dcbe07a88c4ea72576f342dd97ee87c1aa5c8/lightdash/python-sdk/issues/27 |
| twitter:card | summary_large_image |
| og:image | https://opengraph.githubassets.com/f391332d6c9a0aea3eb40f783c7dcbe07a88c4ea72576f342dd97ee87c1aa5c8/lightdash/python-sdk/issues/27 |
| og:image:alt | Tracking issue for a docs pass (to be bundled with the upcoming bulk docs update). Kept separate from the feature PRs to keep those small. Bugs to fix docs/SDK_GUIDE.md uses the wrong Client(...) s... |
| og:image:width | 1200 |
| og:image:height | 600 |
| og:site_name | GitHub |
| og:type | object |
| og:author:username | jpetey75 |
| hostname | github.com |
| expected-hostname | github.com |
| None | 06b8a6144231bf3a234f1c2e9993861e07ce98a905912b114aa386c2d7e84b33 |
| turbo-cache-control | no-preview |
| go-import | github.com/lightdash/python-sdk git https://github.com/lightdash/python-sdk.git |
| octolytics-dimension-user_id | 65912827 |
| octolytics-dimension-user_login | lightdash |
| octolytics-dimension-repository_id | 932695849 |
| octolytics-dimension-repository_nwo | lightdash/python-sdk |
| octolytics-dimension-repository_public | true |
| octolytics-dimension-repository_is_fork | false |
| octolytics-dimension-repository_network_root_id | 932695849 |
| octolytics-dimension-repository_network_root_nwo | lightdash/python-sdk |
| turbo-body-classes | logged-out env-production page-responsive |
| disable-turbo | false |
| browser-stats-url | https://api.github.com/_private/browser/stats |
| browser-errors-url | https://api.github.com/_private/browser/errors |
| release | 32f7b614aca06e6bbd89842b1370df1328264f68 |
| ui-target | full |
| theme-color | #1e2327 |
| color-scheme | light dark |
Links:
Viewport: width=device-width