Mailing-List: contact dev-help@couchdb.apache.org; run by ezmlm
Precedence: bulk
Reply-To: dev@couchdb.apache.org
Received-SPF: pass (athena.apache.org: domain of bchesneau@gmail.com
 designates 209.85.216.54 as permitted sender)
MIME-Version: 1.0
In-Reply-To: <7D8897CB-8A85-4A57-9ACA-FB9B3715D351@apache.org>
References: <7D8897CB-8A85-4A57-9ACA-FB9B3715D351@apache.org>
Date: Sat, 20 Jul 2013 21:38:15 +0200
Message-ID: 
 <CAJNb-9qAcJ5RQ3akpydDkR6yvR8Bw0L_RdaZUyoqx4Sq=qKm7Q@mail.gmail.com>
Subject: Re: [PROPOSAL] Port _db_updates from rcouch to master
From: Benoit Chesneau <bchesneau@gmail.com>
To: "dev@couchdb.apache.org" <dev@couchdb.apache.org>
Content-Type: multipart/alternative; boundary=047d7b2e5290a0d01804e1f69520

--047d7b2e5290a0d01804e1f69520
Content-Type: text/plain; charset=ISO-8859-1

+1.


On Wed, Jul 17, 2013 at 10:00 PM, Jan Lehnardt <jan@apache.org> wrote:

> Hi all,
>
> I would like to propose (lazy consensus) to port the _db_updates
> feature from rcouch to master before the next release.
>
> The code exists in a branch on ASF git (1684-feature-db-updates).
>
> Copying the full commit status:
>
> Import _db_updates from rcouch.
>
> This creates a new top level API endpoint: `/_db_updates`
> that returns a line of JSON for each database event along
> with the database name.
>
> A database event is one of `created`, `updated`, `deleted`.
>
> The API endpoint supports a `?feed=` parameter with the
> options: `longpoll`, `continuous` and `eventsource`.
>
> A second parameter `timeout=` specifies when the server should
> close the connection.
>
> `longpoll` closes the connection after a single notification.
> It is the default option.
>
> `continuous` keeps a socket open until the specified `timeout`
> or 60 seconds by default.
>
> `eventsource` works like continuous, but sends the data in
> EventSource format. See
> http://dev.w3.org/html5/eventsource/
>
>
> The parameters are modelled after the existing `/_changes` API
> endpoint. Note that `/_db_updates` does not support resuming
> of notifications via a sequence ID.
>
> This is a port of the existing DbUpdateNotification interface
> to the HTTP API.
>
> Functional changes compared to rcouch:
>
>  - make _db_updates an admin-only resource
>
> Docs:
>
>  - updated api/misc to include basic info on `/_db_updates`
>
> License:
>
>   Apache 2 license, updated LICENSE.
>
> Notice:
>
>   (c) 2012 Benoit Chesneau, updated NOTICE.
>
> Tests:
>
>  - only manual testing of the various API differences due to
>    complications with asynchronous HTTP requests in the JS
>    test suite and total annoyance of overly complicated
>    ibrowse/httpc modules for writing etap tests.
>
> Recommendation to ship this as EXPERIMENTAL until we have tests.
>
> Cheers
> Jan
> --
>
>

--047d7b2e5290a0d01804e1f69520--