{"id":28282,"library":"spring","title":"spring","description":"Simple Couchbase workload generator built on pylibcouchbase. Version 5.8.7; release cadence is irregular.","status":"active","version":"5.8.7","language":"python","source_language":"en","source_url":"https://github.com/couchbaselabs/spring","tags":["couchbase","workload-generator","testing","pylibcouchbase"],"install":[{"cmd":"pip install spring","lang":"bash","label":"pip installation"}],"dependencies":[{"reason":"Required runtime dependency for Couchbase operations.","package":"pylibcouchbase","optional":false}],"imports":[{"note":"Class name is CamelCase; lowercase leads to ImportError.","wrong":"from spring import spring","symbol":"Spring","correct":"from spring import Spring"}],"quickstart":{"code":"import os\nfrom spring import Spring\n\nconn_str = os.environ.get('COUCHBASE_CONNECTION_STRING', '')\nspring = Spring(connection_string=conn_str)\nspring.run()","lang":"python","description":"Instantiate and run a Spring workload generator against a Couchbase cluster."},"warnings":[{"fix":"Use Python 3.6 or later.","message":"Python 2 support dropped after version 4.x.","severity":"breaking","affected_versions":">=5.0.0"},{"fix":"Use `collection='your_collection'` instead.","message":"The `bucket` parameter is deprecated in favor of `collection`.","severity":"deprecated","affected_versions":">=5.0.0"},{"fix":"Always set the environment variable to avoid accidental localhost connections.","message":"Default connection attempts to local Couchbase unless `COUCHBASE_CONNECTION_STRING` env var is set.","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":"Use `from spring import Spring`.","cause":"Using incorrect import path or case; class is `Spring` not `spring`.","error":"ImportError: cannot import name 'Spring'"},{"fix":"Set `COUCHBASE_CONNECTION_STRING` to `couchbase://user:password@host/bucket`.","cause":"Invalid credentials or connection string; missing env variable or wrong format.","error":"pylibcouchbase.exceptions.AuthError: Authentication failure (LCB_ERR_AUTHENTICATION_FAILURE)"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}