{"id":23799,"library":"gnocchiclient","title":"Gnocchi Python Client Library","description":"Python client library for Gnocchi, a time series data storage and indexing service. Version 7.2.0 is current; active development, release cadence irregular.","status":"active","version":"7.2.0","language":"python","source_language":"en","source_url":"https://github.com/gnocchixyz/gnocchiclient","tags":["gnocchi","time-series","client","openstack"],"install":[{"cmd":"pip install gnocchiclient","lang":"bash","label":"PyPI"}],"dependencies":[],"imports":[{"note":"Common mistake: top-level import doesn't exist; use v1 submodule.","wrong":"from gnocchiclient import Client","symbol":"Client","correct":"from gnocchiclient.v1 import Client"}],"quickstart":{"code":"from gnocchiclient.v1 import Client\nimport os\n\n# Optionally set auth token via environment variable\nos.environ.setdefault('GNOCCHI_ENDPOINT', 'http://localhost:8041')\nos.environ.setdefault('GNOCCHI_AUTH_TOKEN', '')\n\nclient = Client(\n    endpoint=os.environ['GNOCCHI_ENDPOINT'],\n    auth_token=os.environ.get('GNOCCHI_AUTH_TOKEN', '')\n)\n# List metrics\nmetrics = client.metric.list()\nprint(metrics)","lang":"python","description":"Create a client and list metrics."},"warnings":[{"fix":"Use `from gnocchiclient.v1 import Client` instead of `from gnocchiclient import Client`.","message":"In version 4.x, the API client moved from `gnocchiclient.client.Client` to `gnocchiclient.v1.Client`. Old imports will fail.","severity":"breaking","affected_versions":">=4.0.0"},{"fix":"Use `gnocchiclient.v1` for all operations.","message":"The `gnocchiclient.v2` module is deprecated and will be removed in a future release.","severity":"deprecated","affected_versions":">=6.0.0"}],"env_vars":null,"last_verified":"2026-05-01T00:00:00.000Z","next_check":"2026-07-30T00:00:00.000Z","problems":[{"fix":"Run `pip install gnocchiclient`.","cause":"Library not installed.","error":"ModuleNotFoundError: No module named 'gnocchiclient'"},{"fix":"Use `from gnocchiclient.v1 import Client`.","cause":"Using wrong import path. gnocchiclient top-level does not contain Client directly.","error":"ImportError: cannot import name 'Client' from 'gnocchiclient'"},{"fix":"Set `GNOCCHI_AUTH_TOKEN` environment variable or pass `auth_token` parameter.","cause":"Missing or invalid authentication token.","error":"gnocchiclient.exceptions.Unauthorized: Authorization failed"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}