Mailing-List: contact user-help@couchdb.apache.org; run by ezmlm
Precedence: bulk
Reply-To: user@couchdb.apache.org
Received-SPF: pass (nike.apache.org: domain of paul.joseph.davis@gmail.com
 designates 209.85.198.237 as permitted sender)
DomainKey-Signature: a=rsa-sha1; c=nofws;
        d=gmail.com; s=gamma;
        h=message-id:date:from:to:subject:in-reply-to:mime-version
         :content-type:content-transfer-encoding:content-disposition
         :references;
        b=PvTHm+7j98rT4VcW0UxoIBrZo9h1MlBU8JVVav1e+KZlCokc8lsR/LZj8el5oPu4Dp
         VjW4ID8WIPB8vdhgLofpE/zm0OZgkt7d9gmF9QWOoChBeFeL/QZMK+i6sNWPwXewoL5+
         yDul+vhBNETSXYJhtZi9n2llZE+CtjmIoSlGg=
Message-ID: <e2111bbb0812280612p78054478j22cc99ae8d0aaa80@mail.gmail.com>
Date: Sun, 28 Dec 2008 09:12:59 -0500
From: "Paul Davis" <paul.joseph.davis@gmail.com>
To: user@couchdb.apache.org
Subject: Re: newbie question #1
In-Reply-To: <23480186-9A2A-4C87-9A65-59F8E0B53E07@pobox.com>
MIME-Version: 1.0
Content-Type: text/plain; charset=ISO-8859-1
Content-Transfer-Encoding: 7bit
Content-Disposition: inline
References: <98979283-BB61-4D15-AF05-196979FA42BC@pobox.com>
	 <20081228131927.GO21261@tumbolia.org>
	 <13A776CD-4E7F-48D4-A204-B6FECE50F291@pobox.com>
	 <20081228134018.GP21261@tumbolia.org>
	 <B14E20ED-C331-430C-8C38-DB1DC25E4C28@pobox.com>
	 <20081228135637.GQ21261@tumbolia.org>
	 <23480186-9A2A-4C87-9A65-59F8E0B53E07@pobox.com>

On Sun, Dec 28, 2008 at 9:06 AM, Geir Magnusson Jr. <geir@pobox.com> wrote:
> I'm really sorry - everyone please ignore this :)  I'm just an excited
> newbie on vacation...
>

Don't be! Some of use have been working with this long enough we may
not be seeing the forest for the trees. Like Antony mentioned,
renaming those things to "_id" and "_rev" isn't out of the question
even.

> On Dec 28, 2008, at 8:56 AM, Noah Slater wrote:
>
>> On Sun, Dec 28, 2008 at 08:47:44AM -0500, Geir Magnusson Jr. wrote:
>>>
>>> Fair enough.  I just never seem to understand what I'm getting in return
>>
>> Easy answer. Where else would you store this information? Moving this
>> outside of
>> the document would necessarily involve implementation complexity for both
>> client
>> and server, which is a trade-off.
>
> I kinda don't understand this, because from my reading of the docs, it seems
> like responses from the various API calls (e.g.  _all_docs, just getting a
> doc, views...)  are all different, so the client already needs to handle a
> wide-array of "shapes".
>

The two basic types are getting raw documents and getting view
results. There are a few slight differences in each that require some
logic, but if you look at client.py in couchdb-python as a rough
example the entire api has been implemented in 951 lines. (Which
includes copius documentation)

> But... I really didn't want to start a long thread on this :)
>
> I'm going to go off and poke around a bit and get a better feel for all the
> response formats...
>
> geir
>
>

Also, feel free to join us in #couchdb on irc.freenode.net there's
generally always someone around willing to answer questions.

HTH,
Paul Davis