{"id":28397,"library":"tobiko-cloud-helpers","title":"Tobiko Cloud Helpers","description":"Tobiko Cloud Helpers is a Python SDK for interacting with Tobiko Cloud services, including authentication, API calls, and data pipeline management. Version 202616.4.0 supports Python 3.9-3.12. Released frequently (weekly), with breaking changes tied to version bumps.","status":"active","version":"202616.4.0","language":"python","source_language":"en","source_url":"https://github.com/tobikodata/tobiko-cloud-helpers","tags":["cloud","sdk","tobiko","data-pipelines"],"install":[{"cmd":"pip install tobiko-cloud-helpers","lang":"bash","label":"Install from PyPI"}],"dependencies":[{"reason":"HTTP client for API calls","package":"requests","optional":false},{"reason":"Data validation and settings management","package":"pydantic","optional":false}],"imports":[{"note":"Package uses underscores, not dots.","wrong":"from tobiko.cloud.helpers import TobikoClient","symbol":"TobikoClient","correct":"from tobiko_cloud_helpers import TobikoClient"},{"note":"Auth is in .auth module.","wrong":"from tobiko_cloud import Auth","symbol":"Auth","correct":"from tobiko_cloud_helpers.auth import Auth"}],"quickstart":{"code":"import os\nfrom tobiko_cloud_helpers import TobikoClient\n\n# Set your API key via environment variable or directly\nclient = TobikoClient(api_key=os.environ.get('TOBIKO_API_KEY', ''))\nresult = client.list_projects()\nprint(result)","lang":"python","description":"Initialize the Tobiko client and list projects."},"warnings":[{"fix":"Pin version in requirements.txt: tobiko-cloud-helpers==202616.4.0","message":"Major version bumps (e.g., 202xxxx.xx) may introduce breaking API changes. Always pin your version and test upgrades in a staging environment.","severity":"breaking","affected_versions":"All"},{"fix":"Update to: TobikoClient(api_key=..., base_url='...')","message":"The `TobikoClient` constructor no longer accepts a `region` parameter as of 202605.0.0. Use `base_url` instead.","severity":"deprecated","affected_versions":">=202605.0.0"},{"fix":"projects = list(client.list_projects())","message":"The `list_projects()` method returns a generator; you must convert it to a list to access indexes or iterate multiple times.","severity":"gotcha","affected_versions":"All"},{"fix":"Do not prepend 'Bearer '; just provide the raw key.","message":"API keys are passed as a parameter without the 'Bearer ' prefix; the SDK automatically adds it.","severity":"gotcha","affected_versions":"All"}],"env_vars":null,"last_verified":"2026-05-09T00:00:00.000Z","next_check":"2026-08-07T00:00:00.000Z","problems":[{"fix":"Upgrade to latest version: pip install --upgrade tobiko-cloud-helpers\nCheck import: from tobiko_cloud_helpers import TobikoClient","cause":"The package might be outdated or the import path has changed.","error":"ImportError: cannot import name 'TobikoClient' from 'tobiko_cloud_helpers'"},{"fix":"Set TOBIKO_API_KEY environment variable or pass key directly to TobikoClient(api_key='...').","cause":"API key is missing, invalid, or not set in environment variable.","error":"tobiko_cloud_helpers.exceptions.UnauthorizedError: 401 - Invalid API key"},{"fix":"Use list(client.list_projects()) to get a list.","cause":"Calling list_projects() returns a generator; trying to index it fails.","error":"TypeError: 'generator' object is not subscriptable"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}