{"id":1829,"date":"2014-12-16T17:39:36","date_gmt":"2014-12-16T17:39:35","guid":{"rendered":"https:\/\/www.couchbase.com\/blog\/?p=1829"},"modified":"2024-09-12T02:26:21","modified_gmt":"2024-09-12T09:26:21","slug":"whats-python-couchbase-sdk","status":"publish","type":"post","link":"https:\/\/www.couchbase.com\/blog\/whats-python-couchbase-sdk\/","title":{"rendered":"What’s up with the Python Couchbase SDK"},"content":{"rendered":"

Recently, there have been a few new versions of the Couchbase Python client available. It features a new API that is easier to use. As the SDK is now based on libcouchbase<\/a>,\u00a0it is also much faster. It’s also compatible with Python 3 now too!<\/p>\n

Brief history<\/h2>\n

A rewrite was necessary as the Python SDK has a long history. It originated in a Python script Dustin Sallings<\/a>\u00a0wrote, which was then used by the quality engineering team at Couchbase to write their tests. \u00a0There were a lot of great capabilites, but it wasn’t a cohesive API for a new developer.<\/p>\n

Later on it was carried forward by Benjamin Young<\/a>\u00a0to the next level to be the official Couchbase Python client. It still had the burden of being backwards compatible and hence couldn’t be as easy to use as many anticipated.<\/p>\n

With the decision to do a rewrite and base it on libcouchbase in 0.9 using Cython<\/a>, we also decided to break the API. This way you’ll get the best performance, but also a nice API. \u00a0Later, we moved to the Python C API directly in 0.10.<\/p>\n

What does it look like<\/h2>\n

The new API is heavily inspired by the one of the Ruby client.<\/span><\/p>\n

\n
\u00a0 \u00a0 import<\/span> couchbase<\/p>\n

# Connect to localhost on port 8091 by default<\/span>
\nclient =<\/span> Couchbase.connect<\/span>(<\/span>username=<\/span>‘beer-sample’<\/span>,<\/span> password=<\/span>”<\/span>,<\/span>
\nbucket=<\/span>‘beer-sample’<\/span>)<\/span><\/p>\n

beer =<\/span> client.get<\/span>(<\/span>‘aass_brewery-juleol’<\/span>)<\/span>
\nprint<\/span>(<\/span>“{0}, ABV: {1}”<\/span>.format<\/span>(<\/span>beer[<\/span>‘name’<\/span>,<\/span> beer[<\/span>‘abv’<\/span>]<\/span>)<\/span><\/p>\n

beer[<\/span>‘comment’<\/span>]<\/span> =<\/span> “Random beer from Norway”<\/span>
\nclient.replace<\/span>(<\/span>‘aass_brewery-juleol’<\/span>,<\/span> beer)<\/span><\/div>\n<\/div>\n

Get the client<\/h2>\n

Currently you need to build the module yourself, though that’s as easy as running as single command. Please install libcouchbase first, the instructions can be found on Couchbase page<\/a>. Then get the couchbase python package:<\/span><\/p>\n

\n
shell> pip install couchbase<\/div>\n<\/div>\n

And finally build it:<\/p>\n

\n
shell> python setup.py build<\/div>\n<\/div>\n

If you have libcouchbase installed at a custom path you need to set the environment variables LD_LIBRARY_PATH, CFLAGS and LDFLAGS accordingly.<\/p>\n

Future directions<\/h2>\n

The client isn’t feature complete yet, for example the support for views is still evolving and the API will change a bit. Filling those gaps will be the next steps. If you’d like to help out or have a need for a not supported feature, please get in touch with us.<\/span><\/p>\n

Contributions can range from fixing typos or making the installation process in the documentation clearer to implementing missing features.<\/p>\n

Instructions on how to contribute can be found in the couchbase-python-client repository on Github<\/a>.<\/p>\n

Get in touch with us<\/h2>\n

If you’ve any questions, just want to say hello or want to start to contribute, there are several ways to get in touch with us. Either join the Couchbase developer discussion<\/a> or meet us in the #libcouchbase IRC channel on Freenode.<\/span><\/p>\n","protected":false},"excerpt":{"rendered":"

Recently, there have been a few new versions of the Couchbase Python client available. It features a new API that is easier to use. As the SDK is now based on libcouchbase,\u00a0it is also much faster. It’s also compatible with […]<\/p>\n","protected":false},"author":32,"featured_media":13873,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"inline_featured_image":false,"footnotes":""},"categories":[1],"tags":[],"ppma_author":[8991],"class_list":["post-1829","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-uncategorized"],"acf":[],"yoast_head":"\nWhat's up with the Python Couchbase SDK - The Couchbase Blog<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/www.couchbase.com\/blog\/whats-python-couchbase-sdk\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"What's up with the Python Couchbase SDK\" \/>\n<meta property=\"og:description\" content=\"Recently, there have been a few new versions of the Couchbase Python client available. It features a new API that is easier to use. As the SDK is now based on libcouchbase,\u00a0it is also much faster. It’s also compatible with […]\" \/>\n<meta property=\"og:url\" content=\"https:\/\/www.couchbase.com\/blog\/whats-python-couchbase-sdk\/\" \/>\n<meta property=\"og:site_name\" content=\"The Couchbase Blog\" \/>\n<meta property=\"article:published_time\" content=\"2014-12-16T17:39:35+00:00\" \/>\n<meta property=\"article:modified_time\" content=\"2024-09-12T09:26:21+00:00\" \/>\n<meta name=\"author\" content=\"Volker Mische, Software Engineer, Couchbase\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Written by\" \/>\n\t<meta name=\"twitter:data1\" content=\"Volker Mische, Software Engineer, Couchbase\" \/>\n\t<meta name=\"twitter:label2\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data2\" content=\"2 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"Article\",\"@id\":\"https:\/\/www.couchbase.com\/blog\/whats-python-couchbase-sdk\/#article\",\"isPartOf\":{\"@id\":\"https:\/\/www.couchbase.com\/blog\/whats-python-couchbase-sdk\/\"},\"author\":{\"name\":\"Volker Mische, Software Engineer, Couchbase\",\"@id\":\"https:\/\/www.couchbase.com\/blog\/#\/schema\/person\/b58f2bd342f110c188a5fd7652a9154b\"},\"headline\":\"What’s up with the Python Couchbase SDK\",\"datePublished\":\"2014-12-16T17:39:35+00:00\",\"dateModified\":\"2024-09-12T09:26:21+00:00\",\"mainEntityOfPage\":{\"@id\":\"https:\/\/www.couchbase.com\/blog\/whats-python-couchbase-sdk\/\"},\"wordCount\":465,\"commentCount\":1,\"publisher\":{\"@id\":\"https:\/\/www.couchbase.com\/blog\/#organization\"},\"image\":{\"@id\":\"https:\/\/www.couchbase.com\/blog\/whats-python-couchbase-sdk\/#primaryimage\"},\"thumbnailUrl\":\"https:\/\/www.couchbase.com\/blog\/wp-content\/uploads\/sites\/1\/2022\/11\/couchbase-nosql-dbaas.png\",\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"CommentAction\",\"name\":\"Comment\",\"target\":[\"https:\/\/www.couchbase.com\/blog\/whats-python-couchbase-sdk\/#respond\"]}]},{\"@type\":\"WebPage\",\"@id\":\"https:\/\/www.couchbase.com\/blog\/whats-python-couchbase-sdk\/\",\"url\":\"https:\/\/www.couchbase.com\/blog\/whats-python-couchbase-sdk\/\",\"name\":\"What's up with the Python Couchbase SDK - The Couchbase Blog\",\"isPartOf\":{\"@id\":\"https:\/\/www.couchbase.com\/blog\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\/\/www.couchbase.com\/blog\/whats-python-couchbase-sdk\/#primaryimage\"},\"image\":{\"@id\":\"https:\/\/www.couchbase.com\/blog\/whats-python-couchbase-sdk\/#primaryimage\"},\"thumbnailUrl\":\"https:\/\/www.couchbase.com\/blog\/wp-content\/uploads\/sites\/1\/2022\/11\/couchbase-nosql-dbaas.png\",\"datePublished\":\"2014-12-16T17:39:35+00:00\",\"dateModified\":\"2024-09-12T09:26:21+00:00\",\"breadcrumb\":{\"@id\":\"https:\/\/www.couchbase.com\/blog\/whats-python-couchbase-sdk\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/www.couchbase.com\/blog\/whats-python-couchbase-sdk\/\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/www.couchbase.com\/blog\/whats-python-couchbase-sdk\/#primaryimage\",\"url\":\"https:\/\/www.couchbase.com\/blog\/wp-content\/uploads\/sites\/1\/2022\/11\/couchbase-nosql-dbaas.png\",\"contentUrl\":\"https:\/\/www.couchbase.com\/blog\/wp-content\/uploads\/sites\/1\/2022\/11\/couchbase-nosql-dbaas.png\",\"width\":1800,\"height\":630},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/www.couchbase.com\/blog\/whats-python-couchbase-sdk\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\/\/www.couchbase.com\/blog\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"What’s up with the Python Couchbase SDK\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/www.couchbase.com\/blog\/#website\",\"url\":\"https:\/\/www.couchbase.com\/blog\/\",\"name\":\"The Couchbase Blog\",\"description\":\"Couchbase, the NoSQL Database\",\"publisher\":{\"@id\":\"https:\/\/www.couchbase.com\/blog\/#organization\"},\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/www.couchbase.com\/blog\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"},{\"@type\":\"Organization\",\"@id\":\"https:\/\/www.couchbase.com\/blog\/#organization\",\"name\":\"The Couchbase Blog\",\"url\":\"https:\/\/www.couchbase.com\/blog\/\",\"logo\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/www.couchbase.com\/blog\/#\/schema\/logo\/image\/\",\"url\":\"https:\/\/www.couchbase.com\/blog\/wp-content\/uploads\/2023\/04\/admin-logo.png\",\"contentUrl\":\"https:\/\/www.couchbase.com\/blog\/wp-content\/uploads\/2023\/04\/admin-logo.png\",\"width\":218,\"height\":34,\"caption\":\"The Couchbase Blog\"},\"image\":{\"@id\":\"https:\/\/www.couchbase.com\/blog\/#\/schema\/logo\/image\/\"}},{\"@type\":\"Person\",\"@id\":\"https:\/\/www.couchbase.com\/blog\/#\/schema\/person\/b58f2bd342f110c188a5fd7652a9154b\",\"name\":\"Volker Mische, Software Engineer, Couchbase\",\"image\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/www.couchbase.com\/blog\/#\/schema\/person\/image\/b784e0ed70ddc6a966cca0cd67ea590d\",\"url\":\"https:\/\/secure.gravatar.com\/avatar\/36d6008327e7c68a3cb8b871b2232cb728b1097bce985c73052cfcc73479d576?s=96&d=mm&r=g\",\"contentUrl\":\"https:\/\/secure.gravatar.com\/avatar\/36d6008327e7c68a3cb8b871b2232cb728b1097bce985c73052cfcc73479d576?s=96&d=mm&r=g\",\"caption\":\"Volker Mische, Software Engineer, Couchbase\"},\"description\":\"Volker Mische is a Software Engineer, Couchbase. He is in the view-engine team working mostly in Erlang, C\/C++ to improve the geospatial & mapreduce indexing.\",\"url\":\"https:\/\/www.couchbase.com\/blog\/author\/volker-mische\/\"}]}<\/script>\n<!-- \/ Yoast SEO Premium plugin. -->","yoast_head_json":{"title":"What's up with the Python Couchbase SDK - The Couchbase Blog","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/www.couchbase.com\/blog\/whats-python-couchbase-sdk\/","og_locale":"en_US","og_type":"article","og_title":"What's up with the Python Couchbase SDK","og_description":"Recently, there have been a few new versions of the Couchbase Python client available. It features a new API that is easier to use. As the SDK is now based on libcouchbase,\u00a0it is also much faster. It’s also compatible with […]","og_url":"https:\/\/www.couchbase.com\/blog\/whats-python-couchbase-sdk\/","og_site_name":"The Couchbase Blog","article_published_time":"2014-12-16T17:39:35+00:00","article_modified_time":"2024-09-12T09:26:21+00:00","author":"Volker Mische, Software Engineer, Couchbase","twitter_card":"summary_large_image","twitter_misc":{"Written by":"Volker Mische, Software Engineer, Couchbase","Est. reading time":"2 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"Article","@id":"https:\/\/www.couchbase.com\/blog\/whats-python-couchbase-sdk\/#article","isPartOf":{"@id":"https:\/\/www.couchbase.com\/blog\/whats-python-couchbase-sdk\/"},"author":{"name":"Volker Mische, Software Engineer, Couchbase","@id":"https:\/\/www.couchbase.com\/blog\/#\/schema\/person\/b58f2bd342f110c188a5fd7652a9154b"},"headline":"What’s up with the Python Couchbase SDK","datePublished":"2014-12-16T17:39:35+00:00","dateModified":"2024-09-12T09:26:21+00:00","mainEntityOfPage":{"@id":"https:\/\/www.couchbase.com\/blog\/whats-python-couchbase-sdk\/"},"wordCount":465,"commentCount":1,"publisher":{"@id":"https:\/\/www.couchbase.com\/blog\/#organization"},"image":{"@id":"https:\/\/www.couchbase.com\/blog\/whats-python-couchbase-sdk\/#primaryimage"},"thumbnailUrl":"https:\/\/www.couchbase.com\/blog\/wp-content\/uploads\/sites\/1\/2022\/11\/couchbase-nosql-dbaas.png","inLanguage":"en-US","potentialAction":[{"@type":"CommentAction","name":"Comment","target":["https:\/\/www.couchbase.com\/blog\/whats-python-couchbase-sdk\/#respond"]}]},{"@type":"WebPage","@id":"https:\/\/www.couchbase.com\/blog\/whats-python-couchbase-sdk\/","url":"https:\/\/www.couchbase.com\/blog\/whats-python-couchbase-sdk\/","name":"What's up with the Python Couchbase SDK - The Couchbase Blog","isPartOf":{"@id":"https:\/\/www.couchbase.com\/blog\/#website"},"primaryImageOfPage":{"@id":"https:\/\/www.couchbase.com\/blog\/whats-python-couchbase-sdk\/#primaryimage"},"image":{"@id":"https:\/\/www.couchbase.com\/blog\/whats-python-couchbase-sdk\/#primaryimage"},"thumbnailUrl":"https:\/\/www.couchbase.com\/blog\/wp-content\/uploads\/sites\/1\/2022\/11\/couchbase-nosql-dbaas.png","datePublished":"2014-12-16T17:39:35+00:00","dateModified":"2024-09-12T09:26:21+00:00","breadcrumb":{"@id":"https:\/\/www.couchbase.com\/blog\/whats-python-couchbase-sdk\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/www.couchbase.com\/blog\/whats-python-couchbase-sdk\/"]}]},{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/www.couchbase.com\/blog\/whats-python-couchbase-sdk\/#primaryimage","url":"https:\/\/www.couchbase.com\/blog\/wp-content\/uploads\/sites\/1\/2022\/11\/couchbase-nosql-dbaas.png","contentUrl":"https:\/\/www.couchbase.com\/blog\/wp-content\/uploads\/sites\/1\/2022\/11\/couchbase-nosql-dbaas.png","width":1800,"height":630},{"@type":"BreadcrumbList","@id":"https:\/\/www.couchbase.com\/blog\/whats-python-couchbase-sdk\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/www.couchbase.com\/blog\/"},{"@type":"ListItem","position":2,"name":"What’s up with the Python Couchbase SDK"}]},{"@type":"WebSite","@id":"https:\/\/www.couchbase.com\/blog\/#website","url":"https:\/\/www.couchbase.com\/blog\/","name":"The Couchbase Blog","description":"Couchbase, the NoSQL Database","publisher":{"@id":"https:\/\/www.couchbase.com\/blog\/#organization"},"potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/www.couchbase.com\/blog\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"},{"@type":"Organization","@id":"https:\/\/www.couchbase.com\/blog\/#organization","name":"The Couchbase Blog","url":"https:\/\/www.couchbase.com\/blog\/","logo":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/www.couchbase.com\/blog\/#\/schema\/logo\/image\/","url":"https:\/\/www.couchbase.com\/blog\/wp-content\/uploads\/2023\/04\/admin-logo.png","contentUrl":"https:\/\/www.couchbase.com\/blog\/wp-content\/uploads\/2023\/04\/admin-logo.png","width":218,"height":34,"caption":"The Couchbase Blog"},"image":{"@id":"https:\/\/www.couchbase.com\/blog\/#\/schema\/logo\/image\/"}},{"@type":"Person","@id":"https:\/\/www.couchbase.com\/blog\/#\/schema\/person\/b58f2bd342f110c188a5fd7652a9154b","name":"Volker Mische, Software Engineer, Couchbase","image":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/www.couchbase.com\/blog\/#\/schema\/person\/image\/b784e0ed70ddc6a966cca0cd67ea590d","url":"https:\/\/secure.gravatar.com\/avatar\/36d6008327e7c68a3cb8b871b2232cb728b1097bce985c73052cfcc73479d576?s=96&d=mm&r=g","contentUrl":"https:\/\/secure.gravatar.com\/avatar\/36d6008327e7c68a3cb8b871b2232cb728b1097bce985c73052cfcc73479d576?s=96&d=mm&r=g","caption":"Volker Mische, Software Engineer, Couchbase"},"description":"Volker Mische is a Software Engineer, Couchbase. He is in the view-engine team working mostly in Erlang, C\/C++ to improve the geospatial & mapreduce indexing.","url":"https:\/\/www.couchbase.com\/blog\/author\/volker-mische\/"}]}},"authors":[{"term_id":8991,"user_id":32,"is_guest":0,"slug":"volker-mische","display_name":"Volker Mische, Software Engineer, Couchbase","avatar_url":"https:\/\/secure.gravatar.com\/avatar\/36d6008327e7c68a3cb8b871b2232cb728b1097bce985c73052cfcc73479d576?s=96&d=mm&r=g","author_category":"","last_name":"Mische","first_name":"Volker","job_title":"","user_url":"","description":"Volker Mische is a Software Engineer, Couchbase. He is in the view-engine team working mostly in Erlang, C\/C++ to improve the geospatial & mapreduce indexing."}],"_links":{"self":[{"href":"https:\/\/www.couchbase.com\/blog\/wp-json\/wp\/v2\/posts\/1829","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.couchbase.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.couchbase.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.couchbase.com\/blog\/wp-json\/wp\/v2\/users\/32"}],"replies":[{"embeddable":true,"href":"https:\/\/www.couchbase.com\/blog\/wp-json\/wp\/v2\/comments?post=1829"}],"version-history":[{"count":0,"href":"https:\/\/www.couchbase.com\/blog\/wp-json\/wp\/v2\/posts\/1829\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/www.couchbase.com\/blog\/wp-json\/wp\/v2\/media\/13873"}],"wp:attachment":[{"href":"https:\/\/www.couchbase.com\/blog\/wp-json\/wp\/v2\/media?parent=1829"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.couchbase.com\/blog\/wp-json\/wp\/v2\/categories?post=1829"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.couchbase.com\/blog\/wp-json\/wp\/v2\/tags?post=1829"},{"taxonomy":"author","embeddable":true,"href":"https:\/\/www.couchbase.com\/blog\/wp-json\/wp\/v2\/ppma_author?post=1829"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}