Couchbase

[PYCBC-119] Add bucket attribute to see currently connected-to bucket

Fri, 17 May 2013 19:12:40 -0500

Add bucket attribute to see currently connected-to bucket

[PYCBC-118] Provide nicer str/repr for connection object

Fri, 17 May 2013 18:29:01 -0500

Provide nicer __str__/__repr__ for connection object

[PYCBC-64] Improve design document management error handling

Fri, 17 May 2013 14:28:08 -0500

The most likely error that needs better handling is invalid JavaScript.

[PYCBC-38] Replica read command

Fri, 17 May 2013 14:27:35 -0500

Implement a simple replica read command

[PYCBC-41] View error options at query time

Dependency — Fri, 17 May 2013 14:27:18 -0500

At view query time, we need to ensure the developer has the ability to add an "on_error" parameter with values of either "stop" or "continue".

[PYCBC-68] cannot delete design doc

Fri, 17 May 2013 14:27:00 -0500

This may be related to the _rev changes with design docs recently. It could also be related to authentication changes.

http://www.couchbase.com/forums/thread/python-client-delete-design-doc

[PYCBC-98] Multi methods should not raise exceptions

Fri, 17 May 2013 14:26:18 -0500

Multi methods should not raise exceptions. Instead they should return a custom dict with a field indicating whether all operations succeeded or not.

[PYCBC-90] Allow FMT_PLAIN for 'normal' python strings.

Fri, 17 May 2013 14:25:06 -0500

Currently simple strings, i.e. "str" will not properly be set in "plain" mode. The library should apply some heuristics to determine if the string is a simple "byte" string, or whether it needs some special encoding.

[PYCBC-109] Test for negative TTL

Fri, 17 May 2013 14:22:11 -0500

Test for negative TTL

[PYCBC-105] Provide simple 'raw' view API

Fri, 17 May 2013 14:21:10 -0500

This API will just provide a means by which a user can get a view results. Paths will be passed verbatim to LCB, and the view payload may be handled as a subclass of the Result object

[PYCBC-117] Conncache test failing on Windows

Fri, 17 May 2013 12:44:37 -0500

Conncache test failing on Windows

[PYCBC-78] Fix response.json incompatibility with requests module v1.0+

Thu, 16 May 2013 16:13:22 -0500

Prior to the 1.0.0 release of requests, response.json was a property. client.py tries to read config as json using a property, not callable

[PYCBC-111] Memory leak on bad arguments

Thu, 16 May 2013 16:13:05 -0500

There may be a memory leak in the MultiResult object if an error is thrown after the MultiResult object is allocated.

[PYCBC-115] Add touch command

Thu, 16 May 2013 16:12:56 -0500

Add touch command

[PYCBC-114] Internal base management implementation

Thu, 16 May 2013 16:12:44 -0500

This is a 'basic' HTTP implementation. This will be the basis for views as well. As it stands now, this is an unstable API (i.e. the interface may (and probably *will*)) change. This task is just to get the code bits in order so that we're able to do less work when adjusting APIs

[PYCBC-108] Pass ascii=False to json.dumps

Thu, 16 May 2013 16:12:35 -0500

This will decrease the data size for UTF-8 strings. However this will store JSON as non-ascii. Is this supported? (it should be, as JSON says it's utf-8 by definition).

[PYCBC-112] Add test to ensure objects can be pretty-printed

Thu, 16 May 2013 16:12:30 -0500

Write tests to ensure Result objects can be repr'd and stringified without errors.

[PYCBC-110] Document C Internals

Thu, 16 May 2013 16:12:23 -0500

Document C Internals

[PYCBC-100] add apache 2.0 copyright headers to repo, appropriate files

Thu, 16 May 2013 16:10:32 -0500

add apache 2.0 copyright headers to repo, appropriate files

[PYCBC-116] Review error messages to ensure they're concise, informative, actionable

Thu, 16 May 2013 16:00:59 -0500

There are some like "Couldn't connect", which should be more from a user perspective.

[PYCBC-113] TOC for Python 1.0

Wed, 15 May 2013 19:02:13 -0500

For the upcoming 1.0 Python client, we'll need to come up with a TOC. Likely something like MB-7714.

[PYCBC-103] Rewrite in Python C API

Wed, 15 May 2013 18:52:22 -0500

Rewrite in Python C API

[PYCBC-107] Support py3's 'dict_keys' for multi methods

Wed, 15 May 2013 18:51:43 -0500

'dict_keys' should be supported, rather than forcing users to do list(d.keys()).

[PYCBC-61] Provide Get and Lock

Wed, 15 May 2013 18:51:16 -0500

Provide get and lock as an API method.

[PYCBC-106] Expose server list

Wed, 15 May 2013 18:51:06 -0500

This might be needed for more advanced handling of views, or integration of views into a more efficient, "native" HTTP client.

[PYCBC-104] Provide unlock command

Mon, 13 May 2013 20:35:20 -0500

This is already in the library. It just needs tests and documentations.

[PYCBC-34] Exception is not thrown or caught anywhere in the code base

Mon, 13 May 2013 20:34:32 -0500

Catching Exception masks programming errors and should not be thrown or caught anywhere.

[PYCBC-25] vBucket Aware client accepts only 1 server

Mon, 13 May 2013 20:34:25 -0500

The vBucket Aware client only accepts 1 server. So if that server is down at the time of initial connection. The client will never connect. This results in users needing to write special code to handle this or put a Load Balance in between. Which a balancer would reduce performance. Client should ideally take a collection of servers like Standard Memcached Clients do, and auto connect to a different one if it fails connection.

[PYCBC-60] Consistent Order of Method Parameters

Sat, 11 May 2013 13:26:45 -0500

Provide consistent, predictable order for method parameters as other SDKS.

[PYCBC-92] Provide 'codec' options for keys and values

Sat, 11 May 2013 13:24:50 -0500

This will be a preliminary interface, and would allow users to circumvent (either for interoperability or for bugs in the client) "hard coded" encoding rules (pun intended)

The constructor for the Connection class should accept a 'codec' which is an object providing the
following functions:

To encode:
encode_key(self, key) => key_as_bytearray

To decode:
decode_key(self, bytearray) => whatever

To encode a value; should return the bytearray and flags to use
encode_value(self, value) => (bytearray, flags)

To decode a value, function should look at flags and return a bytearray
possibly examining flags.

decode_value(self, value, flags) => bytearray

[PYCBC-74] Get and Lock only sets time for default of 15 seconds

Sat, 11 May 2013 13:24:37 -0500

bucket.getl(key,5) //unlocked after 15 seconds

bucket.getl(key,30) //unlocked after 15 seconds

[PYCBC-1] error format is changing

Sat, 11 May 2013 12:44:50 -0500

The error format is changing, need to ensure that's updated in the client.

Rough example format:

{"total_rows":0,"rows":[

],
"errors": [{"from":"127.0.0.1:5984","reason":"Design document `_design/testfoobar` missing in database `test_db_b`."},
{"from":"http://localhost:5984/_view_merge/","reason":"Design document `_design/testfoobar` missing in database `test_db_c`."}]}

[PYCBC-4] cannot handle topology changes

Sat, 11 May 2013 12:44:44 -0500

The current Python client cannot handle topology changes dynamically. It should learn to do so in one of two ways.

1) Implement handling of fast-forward map.
2) Implement retry of nodes.

When a node is added to the cluster and rebalance is started, a new map is published with a fast-forward section and an updated node list with the new node listed.

The python client should handle not-my-vbucket errors by trying the fast forward map, or should retry each node (maybe twice?) until some node takes the item.

[PYCBC-18] Add prepend method to vbucketawarecouchbase client

Sat, 11 May 2013 12:44:34 -0500

Add prepend method to vbucketawarecouchbase client

[PYCBC-21] docloader fails due to some encoding issue on beers sample data

Sat, 11 May 2013 12:44:27 -0500

See http://review.couchbase.org/#change,11440

[PYCBC-30] Drop "VBucketAware" from Python SDK naming

Sat, 11 May 2013 12:44:21 -0500

Mike W. has good ideas. This is one of them.

We want to get this renaming done prior to the next release, so we don't miss the boat on changing it.

Additionally, we should be sure to deprecate the old naming (not just drop it altogether) as it's still in doc/samples/etc and eradicating those will take some time...

[PYCBC-23] Error using cas

Sat, 11 May 2013 12:44:14 -0500

http://www.couchbase.com/forums/thread/cas-error

[PYCBC-32] python SDK should use TCP NODELAY?

Sat, 11 May 2013 12:44:07 -0500

I noticed while writing a python app that going through server-side moxi against a 2 node cluster was faster than using the python smart client 1.0. Not 100% sure why, but a quick grep shows the python client is not using TCP NODELAY. Like...

s.setsockopt(socket.IPPROTO_TCP, socket.TCP_NODELAY, 1)

[PYCBC-84] Implement multi-get

Sat, 11 May 2013 12:43:42 -0500

http://www.couchbase.com/forums/thread/how-retrive-multiple-documents-python

Please follow up with the user who posted this in the forums upon completion.

[PYCBC-10] object should serialize and deserialize when being persisted to the cluster

Sat, 11 May 2013 12:43:32 -0500

With most other client libraries, objects are automatically serialized when being stored and retrieved from the system. This client library should have similar functionality.

For example, the Java spymemcached client library reserves the flags field for itself, and will set flags to indicate the datatype. One datatype is a serialized Java object.

One good option would also be to allow serialization into JSON, since there is good, built in support for JSON since 2.6 (I believe).

[PYCBC-7] An interface to access Couchbase Views is needed

Sat, 11 May 2013 12:43:23 -0500

Need an interface to be able to access Couchbase Views. Even without the ability to create and delete views, accessing view results is important, as views can be created through the Web UI interface.

The specific implementation should be specific to, and familiar to the surrounding language and library, but it should have some general capabilities:
- List views from a given cluster
- Instantiate an Object that represents a view on a given cluster
- Assemble query parameters for a View
- Retrieve non-reduced results from a View
* Be able to get the underlying document from the non-reduced results (this request should flow over binprot)
- Retrieve reduced results from a View (the format is the same, but there is no associated docid)

[PYCBC-87] Implement append/prepend

Sat, 11 May 2013 12:43:07 -0500

Append is needed in version 0.9.

[PYCBC-13] print statements everywhere

Sat, 11 May 2013 12:42:59 -0500

A lot of print statements are left around the python client library which breaks WSGI - including when you connect.

[PYCBC-47] make setup.py work for installation (and tests)

Sat, 11 May 2013 12:41:46 -0500

python setup.py install should be our preferred route of installation and prep us for PyPi listing.

[PYCBC-33] Many operations are timing out during rebalancing

Sat, 11 May 2013 12:41:08 -0500

I tried adding a fourth server with similar specs to the cluster, and found that during the rebalancing, a large number of operations simply timed out after about 30 secs.

The same behavior was observed using the VBucketAware Python client, local Moxi servers and telnetting directly to the CB servers.

I was under the impression that if the client/Moxi hits a wrong server during rebalancing it's supposed to immediately return a "not my vbucket" error so it can immediately figure out the actual server to query?

[PYCBC-101] warnings at compilation time

Fri, 10 May 2013 16:49:18 -0500

$ pip install couchbase==0.9
Downloading/unpacking couchbase
  Downloading couchbase-0.9.tar.gz (105Kb): 105Kb downloaded
  Running setup.py egg_info for package couchbase
    importerror

Installing collected packages: couchbase
  Running setup.py install for couchbase
    importerror
    building 'couchbase/libcouchbase' extension
    gcc -pthread -DNDEBUG -g -fwrapv -O2 -Wall -Wstrict-prototypes -D_FORTIFY_SOURCE=2 -g -fstack-protector --param=ssp-buffer-size=4 -Wformat -Werror=format-security -fPIC -I/usr/include/python3.2mu -c couchbase/libcouchbase.c -o build/temp.linux-x86_64-3.2/couchbase/libcouchbase.o
    couchbase/libcouchbase.c:880:1: warning: function declaration isn’t a prototype [-Wstrict-prototypes]
    couchbase/libcouchbase.c:5376:18: warning: function declaration isn’t a prototype [-Wstrict-prototypes]
    gcc -pthread -shared -Wl,-O1 -Wl,-Bsymbolic-functions -Wl,-Bsymbolic-functions -Wl,-z,relro build/temp.linux-x86_64-3.2/couchbase/libcouchbase.o -lcouchbase -o build/lib.linux-x86_64-3.2/couchbase/libcouchbase.cpython-32mu.so

[PYCBC-5] down server can hang the Python client

Fri, 10 May 2013 16:48:33 -0500

Since servers may die without resetting the TCP socket, the Python client has to have some kind of timeout on any given operation. Clients should not hang forever.

In the Java client, we implement a continuious operation timeout, where a certain number of timeouts on a connection will cause the client library to close/reopen the connection to the server.

[PYCBC-93] Don't encode bytearray keys

Fri, 10 May 2013 16:40:28 -0500

If a key is a bytearray, the Python client shouldn't try to encode it as UTF-8, but just pass the byte on.

[PYCBC-49] implement get_multi() in unified client

Dependency — Fri, 10 May 2013 16:40:14 -0500

implement get_multi() in unified client

[PYCBC-58] Provide Consistent Timeouts

Fri, 10 May 2013 16:39:48 -0500

Provides the consistent level of time outs with other SDKs. Provide ability to set timeouts at: 1) connection, 2) authentication, and 3) ops level.

[PYCBC-77] Staged Installs fail because pythonlibdir is not taking care of the DESTDIR Variable

Fri, 10 May 2013 16:17:10 -0500

Hello.

Staged install fails because in couchbase-examples/Makefile.am the following is set:

bindir=$(DESTDIR)$(localbindir)

pythonlibdir=$(libdir)/python

Is there a special reason $(DESTDIR) is missing for pythonlibdir?

best regards
Thomas

[PYCBC-67] Unified client should not raise an exception when key is not found

Fri, 10 May 2013 16:15:24 -0500

Unified client should not raise an exception when key is not found

[PYCBC-65] Unified client needs to support password protected buckets on view queries

Fri, 10 May 2013 16:15:07 -0500

Unified client needs to support password protected buckets on view queries

[PYCBC-66] get method should support unicode keys

Fri, 10 May 2013 16:14:40 -0500

The dictionary list returned by the view method contains unicode objects for id/key/value - not strings. To use the row["id"] value in a bucket.get, it's necessary to __str__() that value.

[PYCBC-91] ensure client can be used with UTF-16 formatted strings for keys

Fri, 10 May 2013 16:14:06 -0500

We have a requirement that the client be able to work with UTF-16 encoded strings.

In the ideal case, I think, this would just be if the environment were UTF-16 we simply encode the bytes when sending the key as UTF-16, and no special setup is required. If that's not possible, then we need to ensure that passing a UTF-16 encoded string as a key flows through to the server and back unharmed.

Tests needed.

[PYCBC-44] Updated screencast for /develop pages

Fri, 10 May 2013 16:06:54 -0500

Create an updated screencast to ship with the new 2.0 developer SDKs

[PYCBC-102] New Python 1.0 Guide

Wed, 8 May 2013 13:12:34 -0500

MarkN the component lead.

Matt: will have schedule next week.

[PYCBC-63] include docs over binary protocol

Tue, 7 May 2013 20:36:14 -0500

Currently, the include_docs=true parameter pulls in content over HTTP. It's less optimized and less performant than pulling the same content via a get_multi() request.

However, get_multi() is currently broken over the binary protocol.

This commit shows some progress on the API design:
http://review.couchbase.org/#/c/20349/

That would allow the developer to make a request like:
users = cb['default']['_design/game']['users_by_points'].results().docs()

and get back the content of each user's document, regardless of it being a JSON doc or not.

Currently, that code is broken and the implementation is knowingly bad due to having to work around the current lack of .get_multi() on CouchbaseClient and the brokenness of .get_multi() on the MemcachedClient. The current code in that commit returns only the last document requested in the list of results.

[PYCBC-56] document thoughts on using async-core for IO oriented parallelism

Sat, 4 May 2013 11:08:30 -0500

Related to ~~PYCBC-28~~

[PYCBC-75] Fixed "got not my vb error" problem that was causing a "30 second timeout" from memcached

Sat, 4 May 2013 11:07:34 -0500

Fixed "got not my vb error" problem that was causing a "30 second timeout" from the memcached client.

The code that was in there just had a little bug. I fixed a broken if statement and things started working. I tested this during a rebalance, saw the errors, and also saw my client continue to function fine.

Patch is here:
https://github.com/couchbase/couchbase-python-client/pull/14/files

[PYCBC-73] WARNING:client:unknown flags on get: 2000000

Sat, 4 May 2013 11:07:24 -0500

I was seeing these warnings suddenly from 2 days ago:
WARNING:client:unknown flags on get: 2000000
I modified the python client library to log the values, and they look good, (actually are int)
One thing might be related:
I did cbbackup and cbrestore before I saw these warnings.

[PYCBC-11] a disconnected or misbehaving connection may cause instability in the client library

Sat, 4 May 2013 11:06:24 -0500

This bug has not actually been observed, but it is expected that something like a stale connection (one where the server is gone, but no TCP timeout or RST packet has been received) could cause the client to continue to write to something not there forever. The client library should be more resiliant.

[PYCBC-22] A user has reported Dump is broken

Sat, 4 May 2013 11:06:06 -0500

http://www.couchbase.com/forums/thread/dump-all-keys-bucket

Another user here:

http://www.couchbase.com/forums/thread/get-all-key-names-bucket-php

[PYCBC-29] Setting a non-existant key from VBucketAwareCouchbaseClient throws an exception instead of returning None

Sat, 4 May 2013 11:05:44 -0500

The docs don't match the code. We need to determine which one is correct (or which route we'd prefer taking), write some tests, and make the docs and code match.

Reported via http://disq.us/78w7hy?imp=7fd22085-2821-40da-9b3f-0e5134554a91&thread=574422822&zone=email_notification&event=shortener_click
Using couchbase-python-client v0.6.0 from the MB 2.0 DP SDK downloads, the above doesn't seem to be true. I am seeing the following exception thrown (instead of None being returned) when trying to get a non-existant key from a VBucketAwareCouchbaseClient:

couchbase.couchbaseclient.MemcachedError: Memcached error #1: Not found

Also, the get function doesn't return object but a tuple, with the object is in position 2.

[PYCBC-85] Client Download Link doesn't work without referrer

Sat, 4 May 2013 11:05:25 -0500

There is a HTTP Referer issue with the download link

wget "http://packages.couchbase.com/clients/python/couchbase-0.8.2.tar.gz" doesn't work

wget --referer=http://www.couchbase.com/develop/python/next "http://packages.couchbase.com/clients/python/couchbase-0.8.2.tar.gz" - this works

Please fix.

[PYCBC-69] requests module update required to keep up with changing API

Sat, 4 May 2013 11:05:13 -0500

In requests 0.14, the API changed slightly and thus we need to update our use of the API.

Workaround:
Change line line 282 in couchbase/rest_client.py
- def _http_request(self, api, method='GET', params='', headers=None,
+ def _http_request(self, api, method='GET', params=None, headers=None,

[PYCBC-6] some bugs on sending data

Sat, 4 May 2013 11:04:48 -0500

At times, sending data can get hung up. This is well known by Farshid, who can offer details. Just filing the bug for tracking.

[PYCBC-26] Client throws intermittent "Exception in thread dispatcher-thread" errors

Sat, 4 May 2013 11:04:26 -0500

While working on the changes for 0.6, I started to get these errors. They went away after some time and I haven't seen them since (though I've used the Python client minimally since the 0.6 release). However, a user reported a similar experience on the forums today. I don't have steps to recreate, but wanted to make note of this as it's no longer isolated to my setup.

http://www.couchbase.com/forums/comment/reply/1001642#comment-form

Exception in thread dispatcher-thread (most likely raised during interpreter shutdown):
Traceback (most recent call last):
  File "/usr/lib64/python2.6/threading.py", line 532, in __bootstrap_inner
  File "/usr/lib64/python2.6/threading.py", line 484, in run
  File "/usr/lib/python2.6/site-packages/couchbase/couchbaseclient.py", line 661, in _start_dispatcher
  File "/usr/lib/python2.6/site-packages/couchbase/couchbaseclient.py", line 968, in dispatch
  File "/usr/lib64/python2.6/Queue.py", line 174, in get
<type 'exceptions.TypeError'>: 'NoneType' object is not callable

[PYCBC-24] Rebalance results in clients hanging

Sat, 4 May 2013 11:04:12 -0500

Using the latest version from Github. If you rebalance the cluster while activity is going on from a client. The client hangs with a Not My vBucket error. Even after the rebalance has finished it continues to hang.

[PYCBC-62] get_multi() doesn't work over binary client

Dependency — Sat, 4 May 2013 11:03:47 -0500

The MemcachedClient.get_multi() method works fine over 11211 (moxi), but fails against 11210. The implementation is using the suggested n-1 getq's + noop:
http://code.google.com/p/memcached/wiki/BinaryProtocolRevamped#Get,_Get_Quietly,_Get_Key,_Get_Key_Quietly

[PYCBC-70] shutdown in client takes over 2 seconds

Sat, 4 May 2013 10:58:16 -0500

The shutdown function in the Couchbase object seems to take over 2 seconds.

From the discussion with the bug reporter:
@ingenthr it looks like the mc_client.done() is the culprit. the bucket is being deleted every request, calling mc_client.done() which is taking 2.3 sec to finish asa @ 2:00

oh? thanks for tracing that down! I'll get an issue filed ingenthr @ 2:00
perezd [~derek@23-24-210-193-static.hfc.comcastbusiness.net] entered the room. 2:00

client.Bucket asa @ 2:01
perezd left the room (quit: Client Quit). 2:01

that's interesting ingenthr @ 2:03
I wonder what it's doing there 2:03

is it bad to not properly shutdown? asa @ 2:08
looks like there is self._dispatcher_stopped_event.wait(2) 2:08

well, I think there's a configuration thread. it may leak something? I'm not certain to be honest ingenthr @ 2:08

comment it out and suddenly it iis very fast. asa @ 2:08
line 66 in couchbaseclient.py 2:09

heh ingenthr @ 2:09
well, this has been the area we need to fix I beleive 2:09

asa @ 2:10

[PYCBC-95] Don't require username and password parameters

Thu, 2 May 2013 11:26:13 -0500

Don't require username and password parameters

[PYCBC-96] Allow better handling of lcb errors in error callbacks

Thu, 2 May 2013 11:26:05 -0500

Currently lcb errors are missed. We should add something which exposes them properly

[PYCBC-97] Allow for host list to be passed instead of single string

Thu, 2 May 2013 11:25:59 -0500

Allow for host list to be passed instead of single string

[PYCBC-94] allow for an option to configure the instance using the libcouchbase configuration cache

Thu, 2 May 2013 11:25:51 -0500

There may be some deployments where many instances will be created. For those, it would be desirable to be able to configure the use of the libcouchbase configuration cache to avoid needing to maintain many HTTP configuration streams.

[PYCBC-28] performance with python client library is sub-standard

Thu, 2 May 2013 11:24:57 -0500

Current basic tests with Python show the client library is not capable of the same kind of throughput we would expect from a basic client library. It's unclear if this owing to the fact that we're not that close to the IO or there's something just wrong in the current client library.

[PYCBC-72] requests.get should always use auth=

Thu, 2 May 2013 11:24:35 -0500

Multi-bucket usecases fail when authentication to bucket is invalid.

Here auth is set correctly:
https://github.com/couchbase/couchbase-python-client/blob/master/couchbase/rest_client.py#L293

but missing here:
https://github.com/couchbase/couchbase-python-client/blob/master/couchbase/couchbaseclient.py#L349

https://github.com/couchbase/couchbase-python-client/blob/master/couchbase/rest_client.py#L177

[PYCBC-76] It doesn't work with the latest python requests package

Thu, 2 May 2013 11:24:01 -0500

When I try to connect Couchbase as
self.client = Couchbase('127.0.0.1', 'user', 'pwd)
I get this error:
couchbase-python-client/couchbase/client.py", line 61, in __init__
self.couch_api_base = config["nodes"][0].get("couchApiBase")
TypeError: 'instancemethod' object has no attribute '__getitem__'

If I revert requests to 0.14.2, then everything is good.

From http://pypi.python.org/pypi/requests:
(version 1.0.0) This is not a backwards compatible change.

[PYCBC-54] Unable to connect to cluster if any of the nodes are down

Thu, 2 May 2013 11:23:37 -0500

http://www.couchbase.com/forums/thread/python-client-broken-pipe-when-one-node-down

[PYCBC-55] Memcached bucket operations fail via the unified client

Thu, 2 May 2013 11:23:20 -0500

http://www.couchbase.com/forums/thread/python-memcached-bucket-does-it-work

[PYCBC-99] Post Python Sphinx Docs output

Wed, 1 May 2013 16:32:12 -0500

Post Python Sphinx Docs output

[PYCBC-89] Implement add/replace

Tue, 30 Apr 2013 17:08:39 -0500

Implement add/replace

[PYCBC-88] Add support for increment/decrement

Tue, 30 Apr 2013 17:08:27 -0500

Add support for increment and decrement.

[PYCBC-86] Implement delete command

Sun, 28 Apr 2013 15:10:47 -0500

Implement the delete command on top of the new pylibcouchbase.

[PYCBC-57] Provide Error Handling Consistent with Other SDKs

Fri, 26 Apr 2013 20:11:03 -0500

Need to provides consistent error messages and error handling. Needs to be more consistent with other SDKS, and underlying memcached protocol

[PYCBC-82] Error handling documentation

Fri, 26 Apr 2013 20:11:03 -0500

Please create some documentation specifying possible error/failures to operations, what they "look" like in the logs/exceptions/stack traces and what our recommendation is on how to handle them.

i.e. tmp_oom, timeouts (connection/operation/java-internal/etc), "get miss" (it's technically a failure, let's make it overly obvious what it means), CAS failure, add() failure, replace() failure,

Some of this should be covered in the API reference, but this bug is specifically for a single page where this information is aggregated that a customer/user could read about how to handle errors.

[PYCBC-42] Add a unit/integration test validation of OBSERVE + view stale=false

Fri, 26 Apr 2013 20:11:02 -0500

Ensure that when a synchronous set is used with the new low-level observe, the index is fully updated when querying with view=false.

[PYCBC-9] an interface to paginate across large view results is needed

Fri, 26 Apr 2013 20:11:01 -0500

There can be some situations where querying a view returns results that way too large for the client to handle. In these cases, either the client library API or implementation of some Python specific API can allow for one to iterate over Views which have very large results.

The Ruby client does this with streaming. The Java client does this with traditional pagination:
http://guide.couchdb.org/draft/recipes.html#pagination

[PYCBC-12] client should provide some way of asynchronously running multiple ops in parallel

Fri, 26 Apr 2013 20:11:01 -0500

Currently, if one has to get multiple items to do something, they must all be done in serial.

get A
get B
get C

print "A + B + C is " A + B + C

it'd be better if A, B and C could all be fetched without blocking, and only when going to access them, would the request be blocked.

[PYCBC-59] Provide Standardized Logging

Fri, 26 Apr 2013 20:11:00 -0500

Provides the consistent level of logging provided by other SDKs. Provide more information on configuring logging for developers.

[PYCBC-71] Supporting _all_docs in the SDK

Fri, 26 Apr 2013 20:11:00 -0500

The Python SDK currently doesn't seem to support _all_docs at the moment.

I remember that it was possible in the past with something like `.view("_all_docs")`, but I think this is the wrong way to do it. _all_docs should really have its own method. The reasons are:

- _all_docs and Views are a different thing, this should not be hidden to the user
- _all_docs uses raw collation and not Unicode collation as Views do
- I'm not sure about this one, but it could be the case, that _all_docs also contains not yet persisted items (as opposed to views).

[PYCBC-83] Python client fails to encode view parameters

Fri, 26 Apr 2013 20:11:00 -0500

http://www.couchbase.com/forums/thread/reporting-issue-python-client-bucket-viewoptions-needs-encode-options

During querying a view, if the option is not encoded, it generates an error.
Example:
bucket.view("_design/beer/_view/by_name", limit=10, key="##")
The "##" characters generates:
"invalid UTF-8 JSON: {{error,insufficient_data},"[\"NONE"}"
The Couchbase Python client code should encode all the params in the client.py: view() method.

Please follow up with the user who posted the issue on the forums once this issue is resolved.

[PYCBC-27] support errors on views

Dependency — Fri, 26 Apr 2013 20:10:59 -0500

Views now have some options on capturing errors and stopping on errors as documented here:
http://www.couchbase.com/docs/couchbase-manual-2.0/couchbase-views-writing-errors.html

The client needs to support these.

[PYCBC-36] Implement observe command

Fri, 26 Apr 2013 20:10:59 -0500

Add the basic low level observe command

[PYCBC-37] Highlevel synchronous mutation operations atop observe

Fri, 26 Apr 2013 20:10:59 -0500

Highlevel synchronous mutation operations atop observe

[PYCBC-43] Update the getting started to match the Beer sample DB

Fri, 26 Apr 2013 20:10:59 -0500

Once the sample DB has been integrated into the server, update the getting started (both on the web page and in the documentation) to use the sample database.

[PYCBC-8] creating and destroying design docs with views from the client library should be available

Fri, 26 Apr 2013 20:10:57 -0500

Separate from accessing views, there should be methods of creating and destroying views and the associated design documents.

[PYCBC-81] Write the Getting Started with Python on Mac OS X section of the essentials guide

Mon, 4 Feb 2013 11:25:40 -0600

Write the Getting started with Python on Mac OS X section of the Essentials Guide

Needs to cover:

Installation of the Python module and any pre-requisites
Writing your first (small) app using Couchbase and Python

Submissions should be to MC, either through the couchbase/docs repo, or direct to MC in whatever format suits. Must include both the text and images.

[PYCBC-80] Write the Getting Started with Python on Linux section of the essentials guide

Mon, 4 Feb 2013 11:25:00 -0600

Write the Getting started with Python Linux (Redhat and Debian) section of the Essentials Guide

Needs to cover:

Installation of the Python module and any pre-requisites
Writing your first (small) app using Couchbase and Python

Submissions should be to MC, either through the couchbase/docs repo, or direct to MC in whatever format suits. Must include both the text and images.

[PYCBC-79] Create bucket function does not allow user to set the bucket type

Sat, 26 Jan 2013 09:14:33 -0600

Create bucket function does not allow user to set the bucket type

We should add the bucket type to the list of parameters

it is possible to work around this with the rest interface like:
couchbase = Couchbase("127.0.0.1:8091", "Administrator", "password")
#get the rest interface
rest = couchbase._rest()
rest.create_bucket(bucket='myBucket',
                   ramQuotaMB=160,
                   authType='sasl',
                   saslPassword='password',
                   replicaNumber=0,
                   bucketType='couchbase')

[PYCBC-20] couchbase client doesn't work against a bucket with dedicated port and no password

Fri, 31 Aug 2012 00:40:24 -0500

couchbase client doesn't work against a bucket with dedicated port and no password

[PYCBC-40] RESTful Bucket Flushing

Thu, 30 Aug 2012 23:21:47 -0500

Add the ability to call the RESTful bucket flush.

[PYCBC-16] increment from two clients seems to not work

Thu, 30 Aug 2012 15:51:49 -0500

This was originally observed with an older version, and in trying to reproduce it the latest change seems to show incr/decr is further broken. Still, this should be an easy test to add since it's been verified to fail.

from pymembase.membaseclient import VBucketAwareMembaseClient
client_one = VBucketAwareMembaseClient('http://host/pools/default','default','')
client_two = VBucketAwareMembaseClient('http://host/pools/default','default','')

# Client one sets a numeric key
client_one.set('jacob',0,0,'20')
client_one.get('jacob')

# Client two tries to increment this numeric key
client_two.incr('jacob')
# This returns (0, cas) - it should be 21!
# Client two can keep incrementing this weird key
client_two.incr('jacob')
# Returns (1, cas)

# However - if client two gets the key...
client_two.get('jacob')
client_two.incr('jacob')
# (21, cas)
# !!!

p.s.: want to thank oliland from IRC on reporting this

[PYCBC-39] Add Design document management, including error handling

Thu, 30 Aug 2012 14:24:08 -0500

Add the additional functionality needed to create and replace design documents. This will likely be an extension on the Bucket class.

[PYCBC-45] Remove Couchbase.save({'_id':'key', 'json':'doc'}) in favor of .set() doing key name detection

Thu, 30 Aug 2012 10:37:09 -0500

It seems .save() was added to do some special handling (_design/doc PUTing). It leans on doc._id which is going away in 2.0, so it "smells" if nothing else.

Additionally, leaning on .set() and cb['bucket']['key'] = 'value' for the API will give us great consistency and less confusion.

.save() should be deprecated
.set() should use JSON by default
.set() should handle keys named '_design/(*)' via the HTTP API

[PYCBC-35] Invalid reference made to create_view

Fri, 24 Aug 2012 12:55:44 -0500

See this forum post for details.

http://www.couchbase.com/forums/thread/python-client-library-import-bug-and-fix

[PYCBC-50] remove dependencies on pre-Python 2.6 "shims" (uuid, simplejson)

Fri, 24 Aug 2012 12:43:18 -0500

remove dependencies on pre-Python 2.6 "shims" (uuid, simplejson)

[PYCBC-53] improve bucket creation defaults

Tue, 7 Aug 2012 15:08:45 -0500

improve bucket creation defaults

[PYCBC-52] Install dependencies via setup.py rather than including them in the source distribution

Tue, 7 Aug 2012 15:06:54 -0500

Install dependencies via setup.py rather than including them in the source distribution

[PYCBC-51] install fails owing to missing version

Tue, 7 Aug 2012 15:05:01 -0500

Trying to install via PyPi with 0.7.1, ran into this issue:

(pyenv)ingenthr-mbp:~ ingenthr$ pip install couchbase
Downloading/unpacking couchbase
  Downloading couchbase-0.7.1.post1.tar.gz
  Running setup.py egg_info for package couchbase
    Traceback (most recent call last):
      File "<string>", line 14, in <module>
      File "/Users/ingenthr/opt/pyenv/build/couchbase/setup.py", line 25, in <module>
        from version import get_git_version
    ImportError: No module named version
    Complete output from command python setup.py egg_info:
    Traceback (most recent call last):

  File "<string>", line 14, in <module>

  File "/Users/ingenthr/opt/pyenv/build/couchbase/setup.py", line 25, in <module>

    from version import get_git_version

ImportError: No module named version

----------------------------------------
Command python setup.py egg_info failed with error code 1 in /Users/ingenthr/opt/pyenv/build/couchbase
Storing complete log in /Users/ingenthr/.pip/pip.log

[PYCBC-48] Fatal warning during client installation

Tue, 7 Aug 2012 10:37:25 -0500

> Steps to reproduce:
pip install couchbase

> Expected output:

Downloading/unpacking couchbase
  Downloading couchbase-0.7.0.tar.gz
  Running setup.py egg_info for package couchbase

> Actual output:

Downloading/unpacking couchbase
  Downloading couchbase-0.7.0.tar.gz
  Running setup.py egg_info for package couchbase
    fatal: Not a git repository (or any of the parent directories): .git

> Tip:
def get_version():
    try:
        p = subprocess.Popen('git describe', stdout=subprocess.PIPE,
                             shell=True)
        version = p.communicate()[0].strip()
    except:
        version = ''
    return version

[PYCBC-31] python SDK disables all logging

Fri, 3 Aug 2012 12:02:10 -0500

took a few hours to find why logging in my python app stopped working, and it's because I started using the couchbase python SDK which strangely disables logging...

  logging.disable(logging.ERROR)

here...

  https://github.com/couchbase/couchbase-python-client/blob/master/couchbase/client.py#L33

the temporary workaround in my app was to call...

  logging.disable(logging.NOTSET)

but, that's just a hack workaround against a socially awkward (read: rude) implementation.

[PYCBC-46] Unittests covering > 50% of the code

Wed, 25 Jul 2012 10:56:50 -0500

Unittests covering > 50% of the code

[PYCBC-15] client can't set() integer values

Tue, 24 Jul 2012 15:34:33 -0500

Attempting to set an integer value with the python client will produce:

TypeError: object of type 'int' has no len()

We should be getting the object length from the string (unicode?) representation of the object passed into set().

[PYCBC-14] incr() and decr() not working with VBucketAwareMembaseClient / Membase 1.7

Thu, 31 May 2012 23:30:39 -0500

See reproduction code attached. When executed it spits out a lot of errors ('amount') and eventually times out while still erroring in the background.

[PYCBC-17] client does not exit cleanly on interpreter exit

Fri, 6 Apr 2012 14:00:05 -0500

The couchbase client does not exit cleanly when the interpreter exits - i.e. does not disconnect unless you call client.done()

This can be fixed by daemonizing the CommandDispatcher threads. See http://docs.python.org/library/threading.html#threading.Thread.daemon

[PYCBC-19] use zlib.crc32 in couchbaseclient.py

Wed, 7 Dec 2011 17:00:52 -0600

use zlib.crc32 in couchbaseclient.py

[PYCBC-2] Update README file with simple example for quickstart

Mon, 22 Aug 2011 20:15:34 -0500

Update README file with simple example for quickstart

[PYCBC-3] decr() function fails gracelessly

Fri, 12 Aug 2011 13:11:38 -0500

While learning more about the functions in the vbucketawareclient I tried .decr() with minimal parameters. I lost control of my Python session as it didn't really fail gracefully. I wasn't really trying to make it work, but think this is broken :) and really hard to test further because of this tie-up.

Test script:

from couchbase.couchbaseclient import VBucketAwareCouchbaseClient as client
server = "http://localhost:8091/pools/default"
v = client(server,"default","")
# returns 11210
v.set("TESTKEY",0,0,"TESTVALUE")
# returns (4020540899, 602, '')
v.decr("TESTKEY",1)
#[2011-08-11 16:51:52,415] - [couchbaseclient] [4320661504] - ERROR - 'amount'
#[2011-08-11 16:51:52,627] - [couchbaseclient] [4320661504] - ERROR - 'amount'
#[2011-08-11 16:51:52,827] - [couchbaseclient] [4320661504] - ERROR - 'amount'
#.. never ends

Couchbase

[PYCBC-119] Add bucket attribute to see currently connected-to bucket

[PYCBC-118] Provide nicer __str__/__repr__ for connection object

[PYCBC-64] Improve design document management error handling

[PYCBC-38] Replica read command

[PYCBC-41] View error options at query time

[PYCBC-68] cannot delete design doc

[PYCBC-98] Multi methods should not raise exceptions

[PYCBC-90] Allow FMT_PLAIN for 'normal' python strings.

[PYCBC-109] Test for negative TTL

[PYCBC-105] Provide simple 'raw' view API

[PYCBC-117] Conncache test failing on Windows

[PYCBC-78] Fix response.json incompatibility with requests module v1.0+

[PYCBC-111] Memory leak on bad arguments

[PYCBC-115] Add touch command

[PYCBC-114] Internal base management implementation

[PYCBC-108] Pass ascii=False to json.dumps

[PYCBC-112] Add test to ensure objects can be pretty-printed

[PYCBC-110] Document C Internals

[PYCBC-100] add apache 2.0 copyright headers to repo, appropriate files

[PYCBC-116] Review error messages to ensure they're concise, informative, actionable

[PYCBC-113] TOC for Python 1.0

[PYCBC-103] Rewrite in Python C API

[PYCBC-107] Support py3's 'dict_keys' for multi methods

[PYCBC-61] Provide Get and Lock

[PYCBC-106] Expose server list

[PYCBC-104] Provide unlock command

[PYCBC-34] Exception is not thrown or caught anywhere in the code base

[PYCBC-25] vBucket Aware client accepts only 1 server

[PYCBC-60] Consistent Order of Method Parameters

[PYCBC-92] Provide 'codec' options for keys and values

[PYCBC-74] Get and Lock only sets time for default of 15 seconds

[PYCBC-1] error format is changing

[PYCBC-4] cannot handle topology changes

[PYCBC-18] Add prepend method to vbucketawarecouchbase client

[PYCBC-21] docloader fails due to some encoding issue on beers sample data

[PYCBC-30] Drop "VBucketAware" from Python SDK naming

[PYCBC-23] Error using cas

[PYCBC-32] python SDK should use TCP NODELAY?

[PYCBC-84] Implement multi-get

[PYCBC-10] object should serialize and deserialize when being persisted to the cluster

[PYCBC-7] An interface to access Couchbase Views is needed

[PYCBC-87] Implement append/prepend

[PYCBC-13] print statements everywhere

[PYCBC-47] make setup.py work for installation (and tests)

[PYCBC-33] Many operations are timing out during rebalancing

[PYCBC-101] warnings at compilation time

[PYCBC-5] down server can hang the Python client

[PYCBC-93] Don't encode bytearray keys

[PYCBC-49] implement get_multi() in unified client

[PYCBC-58] Provide Consistent Timeouts

[PYCBC-77] Staged Installs fail because pythonlibdir is not taking care of the DESTDIR Variable

[PYCBC-67] Unified client should not raise an exception when key is not found

[PYCBC-65] Unified client needs to support password protected buckets on view queries

[PYCBC-66] get method should support unicode keys

[PYCBC-91] ensure client can be used with UTF-16 formatted strings for keys

[PYCBC-44] Updated screencast for /develop pages

[PYCBC-102] New Python 1.0 Guide

[PYCBC-63] include docs over binary protocol

[PYCBC-56] document thoughts on using async-core for IO oriented parallelism

[PYCBC-75] Fixed "got not my vb error" problem that was causing a "30 second timeout" from memcached

[PYCBC-73] WARNING:client:unknown flags on get: 2000000

[PYCBC-11] a disconnected or misbehaving connection may cause instability in the client library

[PYCBC-22] A user has reported Dump is broken

[PYCBC-29] Setting a non-existant key from VBucketAwareCouchbaseClient throws an exception instead of returning None

[PYCBC-85] Client Download Link doesn't work without referrer

[PYCBC-69] requests module update required to keep up with changing API

[PYCBC-6] some bugs on sending data

[PYCBC-26] Client throws intermittent "Exception in thread dispatcher-thread" errors

[PYCBC-24] Rebalance results in clients hanging

[PYCBC-62] get_multi() doesn't work over binary client

[PYCBC-70] shutdown in client takes over 2 seconds

[PYCBC-95] Don't require username and password parameters

[PYCBC-96] Allow better handling of lcb errors in error callbacks

[PYCBC-97] Allow for host list to be passed instead of single string

[PYCBC-94] allow for an option to configure the instance using the libcouchbase configuration cache

[PYCBC-28] performance with python client library is sub-standard

[PYCBC-72] requests.get should always use auth=

[PYCBC-76] It doesn't work with the latest python requests package

[PYCBC-54] Unable to connect to cluster if any of the nodes are down

[PYCBC-118] Provide nicer str/repr for connection object