[PYCBC-176] merge the 1.1 updated documentation into docs templates Created: 21/Aug/13  Updated: 25/Sep/13

Status: Open
Project: Couchbase Python Client Library
Component/s: None
Affects Version/s: None
Fix Version/s: 1.1.0
Security Level: Public

Type: Task Priority: Blocker
Reporter: Matt Ingenthron Assignee: Matt Ingenthron
Resolution: Unresolved Votes: 0
Labels: None
Remaining Estimate: Not Specified
Time Spent: Not Specified
Original Estimate: Not Specified


 Description   
Need the updated documentation with 1.1 to be merged into the main docs.

Mark: this is assigned to you because you have supplied it, but Amy needs some guidance on how to handle the merge. The problem is that your generated docs make changes to the section of docs that had been previously edited and are part of the 1.0 docs.

Guidance needed: can you either generate just the 1.1 changed set, or let us know that it'll have to be manually merged. Also, how will we handle this going forward.

 Comments   
Comment by Mark Nunberg [ 25/Sep/13 ]
I really have no idea what this means. Traditionally my pattern with writing the docs has been to generate XML and stuff it inside the docs repo, with the other toolchain there applying the necessary formatting.

Feel free to reassign this to amy or close this if that's all that needs to be done on my part.




[PYCBC-234] Publish docs for Python SDK April 2014 release Created: 27/Feb/14  Updated: 04/Apr/14  Due: 04/Mar/14

Status: Open
Project: Couchbase Python Client Library
Component/s: docs
Affects Version/s: None
Fix Version/s: None
Security Level: Public

Type: Task Priority: Critical
Reporter: Amy Kurtzman Assignee: Amy Kurtzman
Resolution: Unresolved Votes: 0
Labels: None
Remaining Estimate: Not Specified
Time Spent: Not Specified
Original Estimate: Not Specified


 Description   
Edit and publish guide and autodocs.




[PYCBC-241] Use new "Semantic Errors" from libcouchbase 2.3.0 Created: 14/Apr/14  Updated: 14/Apr/14

Status: Open
Project: Couchbase Python Client Library
Component/s: None
Affects Version/s: None
Fix Version/s: .next
Security Level: Public

Type: Task Priority: Critical
Reporter: Mark Nunberg Assignee: Mark Nunberg
Resolution: Unresolved Votes: 0
Labels: None
Remaining Estimate: Not Specified
Time Spent: Not Specified
Original Estimate: Not Specified


 Comments   
Comment by Mark Nunberg [ 14/Apr/14 ]
http://review.couchbase.org/#/c/35689/




[PYCBC-173] syncwait in design_create() expects "views" key Created: 13/Aug/13  Updated: 13/Aug/13

Status: Open
Project: Couchbase Python Client Library
Component/s: library
Affects Version/s: 1.1.0
Fix Version/s: None
Security Level: Public

Type: Bug Priority: Major
Reporter: Volker Mische Assignee: Mark Nunberg
Resolution: Unresolved Votes: 0
Labels: None
Remaining Estimate: Not Specified
Time Spent: Not Specified
Original Estimate: Not Specified


 Description   
When you call design_create() with syncwait > 0 it polls the design document whether they are there or not. The polling seems to check the "views" key/value. The problem is that the design document might not contain any "views", but only spatial views that use "spatial" as key.




[PYCBC-163] Update documentation for 1.1.0 Created: 30/Jul/13  Updated: 27/Sep/13

Status: Open
Project: Couchbase Python Client Library
Component/s: docs
Affects Version/s: 1.1.0
Fix Version/s: 1.1.0
Security Level: Public

Type: Task Priority: Major
Reporter: Mark Nunberg Assignee: Mark Nunberg
Resolution: Unresolved Votes: 0
Labels: None
Σ Remaining Estimate: Not Specified Remaining Estimate: Not Specified
Σ Time Spent: Not Specified Time Spent: Not Specified
Σ Original Estimate: Not Specified Original Estimate: Not Specified

Sub-Tasks:
Key
Summary
Type
Status
Assignee
PYCBC-164 Document new Item API Technical task Resolved Mark Nunberg  
PYCBC-165 Document durability API Technical task Closed Mark Nunberg  
PYCBC-166 Document new AUTO_FMT flag Technical task Closed Mark Nunberg  
PYCBC-167 Document no_format option for get() m... Technical task Closed Mark Nunberg  
PYCBC-168 Document new get_replica API Technical task Resolved Mark Nunberg  
PYCBC-169 Create new 1.1 manual templates Technical task Closed Amy Kurtzman  
PYCBC-186 Combine copyedited Python 1.0 documen... Technical task Closed Mark Nunberg  
PYCBC-187 Copyedit Python 1.1 documentation Technical task Closed Amy Kurtzman  
PYCBC-188 Release Python 1.1 documentation Technical task Closed Amy Kurtzman  

 Description   
Super task for documenting new features added in 1.1.0

 Comments   
Comment by Matt Ingenthron [ 27/Sep/13 ]
Update: Since the site is now migrated, Mark will update the doc directly with the new section and send a PR for staging and then integration.




[PYCBC-144] Support PyPy Created: 24/Jun/13  Updated: 24/Oct/13

Status: In Progress
Project: Couchbase Python Client Library
Component/s: library
Affects Version/s: 0.10.0
Fix Version/s: None
Security Level: Public

Type: Epic Priority: Major
Reporter: Mark Nunberg Assignee: Mark Nunberg
Resolution: Unresolved Votes: 1
Labels: None
Remaining Estimate: Not Specified
Time Spent: Not Specified
Original Estimate: Not Specified

Issue Links:
Duplicate
is duplicated by PYCBC-183 Cannot run on PyPy Resolved

 Description   
I've made some experiments in supporting PyPy.

Supposedly it's CPython compatible -- but not really.

I've started a branch on my own github called https://github.com/mnunberg/couchbase-python-client/tree/pypy

As of now there is no ETA for support - but I'd like to see it working with PyPy as well.

 Comments   
Comment by Mark Nunberg [ 30/Jul/13 ]
Why is this resolved? PyPy is still not supported
Comment by Jai Gupta [ 26/Sep/13 ]
Is this planned to be fixed?
Comment by Mark Nunberg [ 26/Sep/13 ]
I'd like to have it open, but it will require a substantial amount of work to make it work with PyPy. PyPy's C extension layer is sorta broken, so it would require various workarounds in our code in order to play nice with whatever PyPy has.
Comment by Jai Gupta [ 27/Sep/13 ]
When we tested Couchbase python library last time, it used to work with PyPy. I think at that time it was in pure Python. I am not sure though.

Now that Couchbase python library is stable, it does not support PyPy. It is bad for our project.

Is there any workaround? Or, should we run older version of Couchbase python library?

PyPy makes huge difference to our application.
Comment by Mark Nunberg [ 20/Oct/13 ]
So i've done some more work regarding PyPy support. It's leaky and buggy, but 1.2 will have better support than previously. The core problem is that a lot of the stuff the extension does is implemented in pure C. It's easier to maintain and links better with libcouchbase.

* Currently PyPy offers 'cpyext' which is buggy, not to mention being slow. The support in place now relies on CPyExt.

* Changing the code to be pure python would be a bad idea since the overhead doesn't come from a single algorithm but from the overall structure and options provided in our code, not to mention the interaction with libcouchbase. Additionally, the C structure is proven quite well with multiple use cases in Twisted and gevent.

In this category is included interactions with 'cffi' which would be cumbersome and buggy, since all the libcouchbase structures would need to be enumerated properly.

A possible workaround in this case is to maintain the C logic "as-is" and implement the problematic bits in Python, perhaps bridging between the two using cffi - in the case of cffi, we'd only need to bridge the C structures internal to the extension (which are simpler and less numerous than what libcouchbase has)
Comment by Mark Nunberg [ 24/Oct/13 ]
I've started a new project to implement much of the functionality using the 'cffi' module which is supported by PyPy:

https://github.com/couchbaselabs/couchbase-python-cffi




[PYCBC-133] Provide class-level methods by which to not print out long values Created: 13/Jun/13  Updated: 13/Jun/13

Status: Open
Project: Couchbase Python Client Library
Component/s: library
Affects Version/s: 0.11.1
Fix Version/s: None
Security Level: Public

Type: Task Priority: Major
Reporter: Mark Nunberg Assignee: Mark Nunberg
Resolution: Unresolved Votes: 0
Labels: None
Remaining Estimate: Not Specified
Time Spent: Not Specified
Original Estimate: Not Specified


 Comments   
Comment by Mark Nunberg [ 13/Jun/13 ]
If a value is several long KBs and it has an exception, the screen will not be happy :)




[PYCBC-214] bucket flush needs to be added Created: 06/Jan/14  Updated: 08/Jan/14

Status: Open
Project: Couchbase Python Client Library
Component/s: docs, library
Affects Version/s: 1.1.0
Fix Version/s: None
Security Level: Public

Type: Bug Priority: Major
Reporter: Matt Ingenthron Assignee: Mark Nunberg
Resolution: Unresolved Votes: 0
Labels: None
Remaining Estimate: Not Specified
Time Spent: Not Specified
Original Estimate: Not Specified


 Description   
For a given bucket, there needs to be an easy way to invoke the bucket's RESTful flush(). This should be at the bucket level and authentication level. In other words, for a given bucket that I'm doing set()/get() with, I should be able to flush(). That flush() must use the REST interface for the bucket, not broadcast the libcouchbase/memached flush operation.

Note that it is safe for other client instances to be connected during this RESTful flush() operation. Also, it may be worth mentioning in the docs that flush is not atomic on the cluster and will propagate asynchronously.

 Comments   
Comment by Mark Nunberg [ 08/Jan/14 ]
We currently lack an admin interface; we'd be doing this via the admin interface if we were to support it.




[PYCBC-179] add_multi documentation could use improvement Created: 29/Aug/13  Updated: 03/Sep/13

Status: Open
Project: Couchbase Python Client Library
Component/s: docs
Affects Version/s: 1.0.0
Fix Version/s: None
Security Level: Public

Type: Improvement Priority: Major
Reporter: Michael Manfre Assignee: Mark Nunberg
Resolution: Unresolved Votes: 0
Labels: usability
Remaining Estimate: Not Specified
Time Spent: Not Specified
Original Estimate: Not Specified


 Description   
The docs don't mention that add_multi will raise KeyExistsError for the last already existing key, if any number of them already exist. If this is intentional behavior, mentioning it in the docs would be useful and that the KeyExistsError.all_results is where most people will need to look for the OperationResult list.

This behavior seems odd for the API. Assuming there is not a connection/server error, always returning the OperationResult dict would be more intuitive and avoid the code pattern of:

try:
  results = bucket.add_multi(keys)
except KeyExistsError as e:
  # ignore exception because I'm going to process the results anyway
  results = e.all_results

# now process/verify 'results'

---
If add_multi always returned an OperationResult dict, the code would simply be:

results = bucket.add_multi(keys)
# process/verify 'results' without the unnecessary exception

 Comments   
Comment by Mark Nunberg [ 03/Sep/13 ]
This may be fixed in subsequent versions, but the *multi API is expected to function identically to the single API with the exception of the return type being a dict rather than a Result object.

What I may do in the future is simply make all exception throwing optional (i.e. at least those exceptions caused by libcouchbase - the library may still throw exceptions in true "exceptional" situations).

Does that sound better?
Comment by Michael Manfre [ 03/Sep/13 ]
Given the API decision of "multi == single, except make the return type make sense for the function", how about changing that to "multi == single, except the return type and raised exceptions make sense for the function"? That API guideline change would open up two options to fix the multi functions.

1. (Preferred Fix) Always return a dict for the multi functions and don't raise the key errors. This is how memcached handles get_multi. Errors should still be raised in true "exceptional" situations.

2. Change the key error to also includes a list of keys that failed, instead of just all_results. While not ideal as always getting a result dict back, this would at least avoid all code from having to duplicate the work done by the couchbase driver, which already knows which keys failed.

----
If you make all exception throwing optional, please do so on a per function basis and not on a per connection basis. Per connection settings are only useful when you control all code that may use the connection, which may prevent using 3rd party packages that made a different 'quiet' choice when writing their code.
Comment by Mark Nunberg [ 03/Sep/13 ]
I'd like to get rid of exception throwing in _all_ situations except for true "unrecoverable" exceptions (for example, invalid format or some other serious error). Otherwise I do agree.

The problem with trying to figure out which keys "failed" is that currently only one exception (i.e. the first failure) is thrown - while the other ones still exist. Because Python cannot really return values when an exception has been thrown, those values are stored in the '.all_results' field of the exception object.

Note that you can use the Item API (though this is not present in 1.0.0, it will be available in 1.1.0) to go back to 'normal' behavior.

Also note that internally, the Couchbase driver doesn't really know which key failed - there is only _one_ failure flag internally for key failures - so that there isn't a huge performance hit if a lot of keys fail.

Feel free to rename this issue as "Don't raise exceptions on key failures", as this involves a lot of annoying boilerplate in any event. What we really should have done is something like:

# Raise on any error
cb.set(key, value, raise=True)

# Raise only on specific failures
cb.set(key, value, raise=[0x18, 0x27, 0x13])

# Don't raise (default)
cb.set(key, value)




[PYCBC-79] Create bucket function does not allow user to set the bucket type Created: 26/Jan/13  Updated: 06/Aug/13

Status: Open
Project: Couchbase Python Client Library
Component/s: library
Affects Version/s: 0.8.0
Fix Version/s: None
Security Level: Public

Type: Bug Priority: Major
Reporter: Tug Grall (Inactive) Assignee: Tug Grall (Inactive)
Resolution: Unresolved Votes: 0
Labels: None
Remaining Estimate: Not Specified
Time Spent: Not Specified
Original Estimate: Not Specified


 Description   
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')

 Comments   
Comment by Matt Ingenthron [ 30/Jul/13 ]
Tug: did you plan to implement this one? You seem to have assigned it to yourself.




[PYCBC-80] Write the Getting Started with Python on Linux section of the essentials guide Created: 04/Feb/13  Updated: 04/Feb/13

Status: Open
Project: Couchbase Python Client Library
Component/s: None
Affects Version/s: None
Fix Version/s: None
Security Level: Public

Type: Task Priority: Major
Reporter: MC Brown (Inactive) Assignee: Robin Johnson (Inactive)
Resolution: Unresolved Votes: 0
Labels: None
Remaining Estimate: Not Specified
Time Spent: Not Specified
Original Estimate: Not Specified


 Description   
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-81] Write the Getting Started with Python on Mac OS X section of the essentials guide Created: 04/Feb/13  Updated: 04/Feb/13

Status: Open
Project: Couchbase Python Client Library
Component/s: None
Affects Version/s: None
Fix Version/s: None
Security Level: Public

Type: Task Priority: Major
Reporter: MC Brown (Inactive) Assignee: Robin Johnson (Inactive)
Resolution: Unresolved Votes: 0
Labels: None
Remaining Estimate: Not Specified
Time Spent: Not Specified
Original Estimate: Not Specified


 Description   
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-42] Add a unit/integration test validation of OBSERVE + view stale=false Created: 12/Jul/12  Updated: 06/Aug/13

Status: Reopened
Project: Couchbase Python Client Library
Component/s: tests
Affects Version/s: None
Fix Version/s: 1.2.0
Security Level: Public

Type: Improvement Priority: Major
Reporter: Matt Ingenthron Assignee: Mark Nunberg
Resolution: Unresolved Votes: 0
Labels: None
Remaining Estimate: Not Specified
Time Spent: Not Specified
Original Estimate: Not Specified


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


 Comments   
Comment by Mark Nunberg [ 06/Aug/13 ]
Won't be done this cycle; should be deferred to libcouchbase in any event.
Comment by Matt Ingenthron [ 06/Aug/13 ]
I reopened this because the interaction between observe with persist to master and stale=false sure seems to me to be something at the PYCBC level. libcouchbase doesn't know what "stale=false" is and this is primary functionality we need to verify is behaving correctly with doing the endure, blocking, then doing the view request.

With libcouchbase 2.1, it's possible to do it at that level now but I still think it's appropriate at the higher level.




[PYCBC-233] add discussion of timeout accuracy and resolution to documentation Created: 27/Feb/14  Updated: 27/Feb/14

Status: Open
Project: Couchbase Python Client Library
Component/s: docs
Affects Version/s: None
Fix Version/s: .next
Security Level: Public

Type: Improvement Priority: Major
Reporter: Matt Ingenthron Assignee: Mark Nunberg
Resolution: Unresolved Votes: 0
Labels: None
Remaining Estimate: Not Specified
Time Spent: Not Specified
Original Estimate: Not Specified


 Description   
Since our timeouts are only as accurate as the underlying APIs/subsystems we use, we should document this for our users so they can plan accordingly. For instance, if processes aren't scheduled for a long period of time owing to CPU or memory contention... or in some cases IO doesn't happen for a long time and our timeout is IO event driven, we may not timeout to the application until later.




[PYCBC-235] Document MultiResult class a bit better Created: 05/Mar/14  Updated: 05/Mar/14

Status: Open
Project: Couchbase Python Client Library
Component/s: apidocs
Affects Version/s: None
Fix Version/s: .next
Security Level: Public

Type: Task Priority: Major
Reporter: Mark Nunberg Assignee: Mark Nunberg
Resolution: Unresolved Votes: 0
Labels: None
Remaining Estimate: Not Specified
Time Spent: Not Specified
Original Estimate: Not Specified


 Description   
Specify the purpose behind MultiResult - it's a dict, but show some examples.




[PYCBC-237] Add page_size option to RowProcessor to limit get_multi sizes Created: 06/Mar/14  Updated: 06/Mar/14

Status: Open
Project: Couchbase Python Client Library
Component/s: None
Affects Version/s: None
Fix Version/s: .next
Security Level: Public

Type: Improvement Priority: Major
Reporter: Mark Nunberg Assignee: Mark Nunberg
Resolution: Unresolved Votes: 0
Labels: None
Remaining Estimate: Not Specified
Time Spent: Not Specified
Original Estimate: Not Specified


 Description   
This option would be delivered to the RowProcessor implementation (if it's an instance of RowProcessor) to limit the number of documents fetched for a multi-get when dealing with many view results.

Currently if we get several thousand results in a single fetch, it means the include_docs handling with also try to do a get_multi on that many documents.

This will waste much memory and slow down the application.




[PYCBC-238] Add couchbase cluster compatibility to documentation Created: 25/Mar/14  Updated: 25/Mar/14

Status: Open
Project: Couchbase Python Client Library
Component/s: docs
Affects Version/s: None
Fix Version/s: .next
Security Level: Public

Type: Improvement Priority: Major
Reporter: Matt Ingenthron Assignee: Mark Nunberg
Resolution: Unresolved Votes: 0
Labels: None
Remaining Estimate: Not Specified
Time Spent: Not Specified
Original Estimate: Not Specified

Issue Links:
Gantt: finish-start
has to be done after JCBC-438 Add table for 1.8, 2.x and 3.x compat... Open

 Description   
We should probably specify for this given major.minor of the SDK, one of three things for Couchbase Cluster releases:
- unsupported
- supported
- supports all features

These might be an 'x', '—' and "✓" in a table, or whatever Amy comes up with.

This is, in part, planning for 3.0 including beta.

This should be based on the work done in JCBC-438, so it's blocked by that issue.




[PYCBC-223] Streaming on view crashes python. Created: 30/Jan/14  Updated: 28/Mar/14

Status: Open
Project: Couchbase Python Client Library
Component/s: None
Affects Version/s: 1.2.0
Fix Version/s: None
Security Level: Public

Type: Bug Priority: Major
Reporter: adonoho Assignee: Mark Nunberg
Resolution: Unresolved Votes: 0
Labels: customer
Remaining Estimate: Not Specified
Time Spent: Not Specified
Original Estimate: Not Specified
Environment: Python v3.3.3 on OS X 10.8.5


 Description   
The following query:

def query_by_timestamp(timestamp: int) -> Query:

    q = Query()

    q.stale = STALE_UPDATE_BEFORE
    q.startkey = timestamp
    q.endkey = int(timestamp + QUERY_PERIOD)
    q.inclusive_end = False

    return q

## query_by_timestamp()

being called by:

def by_timestamp(cb: Connection, timestamp: int) -> View:

    q = query_by_timestamp(timestamp)

    q.reduce = False

    view = cb.query("sensitive", "by_timestamp", include_docs=True, query=q, streaming=1)

    return view

## by_timestamp()

The timestamp is a traditional Unix timestamp, i.e. it is a number key and not a string key. When `streaming` is set to `0` and not `1`, the query operates properly by returning the expected documents. (I pass `0` and `1` instead of True or False because the documentation says it is a bool and not a boolean.)

Anon,
Andrew


 Comments   
Comment by adonoho [ 20/Mar/14 ]
Any progress on fixing streaming?

Anon,
Andrew
Comment by Mark Nunberg [ 20/Mar/14 ]
I was about to mark this as a duplicate some weeks ago when I fixed a related issue.

See if this fixes your issue (the fix is merged into current master): https://www.couchbase.com/issues/browse/PYCBC-236
Comment by Mark Nunberg [ 20/Mar/14 ]
Considering you are using include_docs with streaming, that _may_ have been your issue, too (should be fixed by the ticket referenced above).
Comment by adonoho [ 28/Mar/14 ]
Mark,

Forgive my noobitude, where do I find this patch? Is it on Github or on a CB repo somewhere?

Andrew
Comment by Mark Nunberg [ 28/Mar/14 ]
https://github.com/couchbase/couchbase-python-client

-- there is no special step required if you're familiar with building from a python package source.

However if you're not:

(1) checkout the repository
(2) cd into the repository
(3) pip install .
OR
(3) python setup.py install

Let me know if you have issues with this

Mark




[PYCBC-231] Use compact JSON encoding for Python objects Created: 25/Feb/14  Updated: 14/Apr/14

Status: Open
Project: Couchbase Python Client Library
Component/s: library
Affects Version/s: 1.2.0
Fix Version/s: .next
Security Level: Public

Type: Improvement Priority: Major
Reporter: Dave Rigby Assignee: Mark Nunberg
Resolution: Unresolved Votes: 0
Labels: None
Remaining Estimate: Not Specified
Time Spent: Not Specified
Original Estimate: Not Specified

Issue Links:
Dependency

 Description   
When encoding Python objects to JSON, we currently use json.dumps() with default arguments. This produces JSON encoded with spaces separating fields. This is somewhat wasteful from a memory / disk / network utilisation point of view.

More preferable would be to use a "compact" encoding which removes all spaces - this can be achieved using separators=(',', ':') or similar (see http://docs.python.org/2/library/json.html).






[PYCBC-222] gevent is still listed as experimental in the API doc Created: 14/Jan/14  Updated: 14/Apr/14

Status: In Progress
Project: Couchbase Python Client Library
Component/s: apidocs
Affects Version/s: 1.2.0
Fix Version/s: .next
Security Level: Public

Type: Bug Priority: Major
Reporter: Matt Ingenthron Assignee: Mark Nunberg
Resolution: Unresolved Votes: 0
Labels: None
Remaining Estimate: Not Specified
Time Spent: Not Specified
Original Estimate: Not Specified


 Description   
I happened to notice in the connect() that gevent is still listed as experimental. This is supported as of 1.2.0, correct?

 Comments   
Comment by Mark Nunberg [ 14/Jan/14 ]
Yes, the API itself is experimental. It's supported but experimental.
Comment by Mark Nunberg [ 14/Jan/14 ]
This will go away in 1.2.1; though gevent is inherently experimental.
Comment by Mark Nunberg [ 14/Apr/14 ]
http://review.couchbase.org/35692




[PYCBC-204] Release notes for the Windows SDK should have a link to the libcouchbase version used. Created: 04/Nov/13  Updated: 04/Nov/13

Status: Open
Project: Couchbase Python Client Library
Component/s: docs
Affects Version/s: 1.1.0
Fix Version/s: None
Security Level: Public

Type: Task Priority: Minor
Reporter: Patrick Varley Assignee: Mark Nunberg
Resolution: Unresolved Votes: 0
Labels: customer, documentation
Remaining Estimate: Not Specified
Time Spent: Not Specified
Original Estimate: Not Specified
Environment: http://docs.couchbase.com/couchbase-sdk-python-1.1/#release-notes-for-couchbase-python-sdk-110-ga-1-october-2013


 Description   
The Python SDK for Windows includes libcouchbase.
The release notes should say which version of libcouchbase it uses and a link to that version's release note.

 Comments   
Comment by Mark Nunberg [ 04/Nov/13 ]
You can determine this at runtime :) - Connection.lcb_version()




[PYCBC-152] Tutorial review comments Created: 10/Jul/13  Updated: 24/Jul/13

Status: Open
Project: Couchbase Python Client Library
Component/s: docs
Affects Version/s: None
Fix Version/s: 1.0.0
Security Level: Public

Type: Task Priority: Minor
Reporter: Amy Kurtzman Assignee: Mark Nunberg
Resolution: Unresolved Votes: 0
Labels: None
Remaining Estimate: Not Specified
Time Spent: Not Specified
Original Estimate: Not Specified

Attachments: PDF File couchbase-sdk-python_tutorial_20130626-checked-off.pdf    

 Description   
Volker reviewed the tutorial section in the Python client library SDK and made many comments. Some of those comments suggest changes to the beer sample application. The comments note items of varying severity. For example, one of the comments says that the sample application won't run without the addition of a couple of lines of code.

This task is to review the comments. Then, if needed, update & test the sample code in Github, and then update the SDK documentation to match the sample code.

Attachment: My copy of Volker's review comments. In my copy I checked off the comments that I updated in the documentation.




[PYCBC-239] Docs: transcoder improvement Created: 25/Mar/14  Updated: 14/Apr/14

Status: Open
Project: Couchbase Python Client Library
Component/s: docs
Affects Version/s: 1.2.0
Fix Version/s: .next
Security Level: Public

Type: Bug Priority: Minor
Reporter: Perry Krug Assignee: Mark Nunberg
Resolution: Unresolved Votes: 0
Labels: None
Remaining Estimate: Not Specified
Time Spent: Not Specified
Original Estimate: Not Specified

Attachments: File patch.diff    

 Description   
I think there's an error in the Python SDK Advanced
Usage page.
Under the Custom Transcoder Objects section:
http://docs.couchbase.com/couchbase-sdk-python-1.2/#custom-transcoder-objects

New to Python and to Couchbase I've been playing around, but was struggling
to get this to work.
I believe the problem is two folds (ignoring the lack of 1import Couchbase`
and `import FMT_BYTES` as this is only a snippet):
- use of `format` instead of `flags` in `decode_value()`
- not converting "long value" to bytes

Please find attached a patch which, if I am correct, I think would save
time, and avoid confusion, to newcomers like me.




Generated at Wed Apr 16 10:26:51 CDT 2014 using JIRA 5.2.4#845-sha1:c9f4cc41abe72fb236945343a1f485c2c844dac9.