You are viewing a plain text version of this content. The canonical link for it is here.
Posted to user@couchdb.apache.org by muji <fr...@gmail.com> on 2016/01/11 05:40:23 UTC
ANN: rlx(1) - Couchdb command line interface
Hello,
I am pleased to announce rlx[1], a full-featured command line interface for
couchdb:
npm i -g rlx && rlx i
Will launch an interactive session. Documentation is built in as man pages
with the `help` command - note that to edit documents `vim` is required.
It was built and tested against couchdb 1.6.x and if people find it useful
I could contribute some more time for couchdb 2.x compatibility.
All feedback very welcome - especially bugs[2]!
Relax and enjoy!
[1]: https://github.com/tmpfs/rlx
[2]: https://github.com/tmpfs/rlx/issues
Re: ANN: rlx(1) - Couchdb command line interface
Posted by Garren Smith <ga...@apache.org>.
Hi Muji,
Its great that you want to help. NMO is part of the Apache foundation. So we have to use JIRA for it. Here is a list of open issues:
https://issues.apache.org/jira/browse/COUCHDB-2810?jql=component%20%3D%20nmo%20AND%20project%20%3D%20COUCHDB%20AND%20resolution%20%3D%20Unresolved%20ORDER%20BY%20priority%20DESC <https://issues.apache.org/jira/browse/COUCHDB-2810?jql=component%20=%20nmo%20AND%20project%20=%20COUCHDB%20AND%20resolution%20=%20Unresolved%20ORDER%20BY%20priority%20DESC>
I’ve added two more that I would love some help on, They are the upload a file (COUCHDB-2936) and fast enable cors (COUCHDB-2935). If you need help you are welcome to email the dev@ list or reach out to me (garren) or Robert (robertkowalski) in the #couchdb-dev irc.
Also here is the full docs for nmo to give you an idea of how the commands work http://robertkowalski.github.io/nmo/ <http://robertkowalski.github.io/nmo/>
Cheers
Garren
> On 13 Jan 2016, at 9:43 AM, muji <fr...@gmail.com> wrote:
>
> Thanks Garren!
>
> Very good timing. I am about to embark on an ES6/Babel (learning) adventure
> as I find myself temporarily free of commercial work.
>
> However, looking at the repository and docs I am unsure how I might help.
> Are there bugs that need fixing or features that need implementing? I don't
> see an *issues* section on github. Feel free to add me as a contributor and
> raise issues assigned to me, I'll pick them up as I can.
>
> Do you think it is worth me folding these 2.x specific features
> (cluster/nodes) into rlx(1) or is it better left to a standalone tool like
> nmo(1)?
>
> Cheers - muji.
>
> On 13 January 2016 at 15:07, Garren Smith <ga...@apache.org> wrote:
>
>> Hi Muji,
>>
>> This is really cool. Awesome work. We also have NMO (
>> https://github.com/apache/couchdb-nmo <
>> https://github.com/apache/couchdb-nmo>) It is a command line client to
>> help with managing CouchDB 2.0 clusters and also add extra useful
>> functionality like importing data from MongoDB into CouchDB.
>> If you enjoy building CLI’s we would love your help on that.
>>
>> Cheers
>> Garren
>>
>>> On 13 Jan 2016, at 2:36 AM, muji <fr...@gmail.com> wrote:
>>>
>>> Thanks very much Andy - much appreciated :)
>>>
>>> I have pinged Jenn on the other thread so maybe it will make the news!
>>>
>>> Ciao!
>>>
>>> On 11 January 2016 at 18:01, Andy Wenk <an...@apache.org> wrote:
>>>
>>>> Hi muji,
>>>>
>>>> awesome! I have added the project to the wiki.
>>>>
>>>> https://cwiki.apache.org/confluence/display/COUCHDB/Node.js
>>>>
>>>> @marketing team - including into the news?
>>>>
>>>> All the best
>>>>
>>>> Andy
>>>>
>>>> On 11 January 2016 at 05:40, muji <fr...@gmail.com> wrote:
>>>>
>>>>> Hello,
>>>>>
>>>>> I am pleased to announce rlx[1], a full-featured command line interface
>>>> for
>>>>> couchdb:
>>>>>
>>>>> npm i -g rlx && rlx i
>>>>>
>>>>> Will launch an interactive session. Documentation is built in as man
>>>> pages
>>>>> with the `help` command - note that to edit documents `vim` is
>> required.
>>>>>
>>>>> It was built and tested against couchdb 1.6.x and if people find it
>>>> useful
>>>>> I could contribute some more time for couchdb 2.x compatibility.
>>>>>
>>>>> All feedback very welcome - especially bugs[2]!
>>>>>
>>>>> Relax and enjoy!
>>>>>
>>>>> [1]: https://github.com/tmpfs/rlx
>>>>> [2]: https://github.com/tmpfs/rlx/issues
>>>>>
>>>>
>>>>
>>>>
>>>> --
>>>> Andy Wenk
>>>> Hamburg - Germany
>>>> RockIt!
>>>>
>>>> GPG fingerprint: C044 8322 9E12 1483 4FEC 9452 B65D 6BE3 9ED3 9588
>>>>
>>>> https://people.apache.org/keys/committer/andywenk.asc
>>>>
>>
>>
Re: ANN: rlx(1) - Couchdb command line interface
Posted by muji <fr...@gmail.com>.
Thanks Garren!
Very good timing. I am about to embark on an ES6/Babel (learning) adventure
as I find myself temporarily free of commercial work.
However, looking at the repository and docs I am unsure how I might help.
Are there bugs that need fixing or features that need implementing? I don't
see an *issues* section on github. Feel free to add me as a contributor and
raise issues assigned to me, I'll pick them up as I can.
Do you think it is worth me folding these 2.x specific features
(cluster/nodes) into rlx(1) or is it better left to a standalone tool like
nmo(1)?
Cheers - muji.
On 13 January 2016 at 15:07, Garren Smith <ga...@apache.org> wrote:
> Hi Muji,
>
> This is really cool. Awesome work. We also have NMO (
> https://github.com/apache/couchdb-nmo <
> https://github.com/apache/couchdb-nmo>) It is a command line client to
> help with managing CouchDB 2.0 clusters and also add extra useful
> functionality like importing data from MongoDB into CouchDB.
> If you enjoy building CLI’s we would love your help on that.
>
> Cheers
> Garren
>
> > On 13 Jan 2016, at 2:36 AM, muji <fr...@gmail.com> wrote:
> >
> > Thanks very much Andy - much appreciated :)
> >
> > I have pinged Jenn on the other thread so maybe it will make the news!
> >
> > Ciao!
> >
> > On 11 January 2016 at 18:01, Andy Wenk <an...@apache.org> wrote:
> >
> >> Hi muji,
> >>
> >> awesome! I have added the project to the wiki.
> >>
> >> https://cwiki.apache.org/confluence/display/COUCHDB/Node.js
> >>
> >> @marketing team - including into the news?
> >>
> >> All the best
> >>
> >> Andy
> >>
> >> On 11 January 2016 at 05:40, muji <fr...@gmail.com> wrote:
> >>
> >>> Hello,
> >>>
> >>> I am pleased to announce rlx[1], a full-featured command line interface
> >> for
> >>> couchdb:
> >>>
> >>> npm i -g rlx && rlx i
> >>>
> >>> Will launch an interactive session. Documentation is built in as man
> >> pages
> >>> with the `help` command - note that to edit documents `vim` is
> required.
> >>>
> >>> It was built and tested against couchdb 1.6.x and if people find it
> >> useful
> >>> I could contribute some more time for couchdb 2.x compatibility.
> >>>
> >>> All feedback very welcome - especially bugs[2]!
> >>>
> >>> Relax and enjoy!
> >>>
> >>> [1]: https://github.com/tmpfs/rlx
> >>> [2]: https://github.com/tmpfs/rlx/issues
> >>>
> >>
> >>
> >>
> >> --
> >> Andy Wenk
> >> Hamburg - Germany
> >> RockIt!
> >>
> >> GPG fingerprint: C044 8322 9E12 1483 4FEC 9452 B65D 6BE3 9ED3 9588
> >>
> >> https://people.apache.org/keys/committer/andywenk.asc
> >>
>
>
Re: ANN: rlx(1) - Couchdb command line interface
Posted by Garren Smith <ga...@apache.org>.
Hi Muji,
This is really cool. Awesome work. We also have NMO (https://github.com/apache/couchdb-nmo <https://github.com/apache/couchdb-nmo>) It is a command line client to help with managing CouchDB 2.0 clusters and also add extra useful functionality like importing data from MongoDB into CouchDB.
If you enjoy building CLI’s we would love your help on that.
Cheers
Garren
> On 13 Jan 2016, at 2:36 AM, muji <fr...@gmail.com> wrote:
>
> Thanks very much Andy - much appreciated :)
>
> I have pinged Jenn on the other thread so maybe it will make the news!
>
> Ciao!
>
> On 11 January 2016 at 18:01, Andy Wenk <an...@apache.org> wrote:
>
>> Hi muji,
>>
>> awesome! I have added the project to the wiki.
>>
>> https://cwiki.apache.org/confluence/display/COUCHDB/Node.js
>>
>> @marketing team - including into the news?
>>
>> All the best
>>
>> Andy
>>
>> On 11 January 2016 at 05:40, muji <fr...@gmail.com> wrote:
>>
>>> Hello,
>>>
>>> I am pleased to announce rlx[1], a full-featured command line interface
>> for
>>> couchdb:
>>>
>>> npm i -g rlx && rlx i
>>>
>>> Will launch an interactive session. Documentation is built in as man
>> pages
>>> with the `help` command - note that to edit documents `vim` is required.
>>>
>>> It was built and tested against couchdb 1.6.x and if people find it
>> useful
>>> I could contribute some more time for couchdb 2.x compatibility.
>>>
>>> All feedback very welcome - especially bugs[2]!
>>>
>>> Relax and enjoy!
>>>
>>> [1]: https://github.com/tmpfs/rlx
>>> [2]: https://github.com/tmpfs/rlx/issues
>>>
>>
>>
>>
>> --
>> Andy Wenk
>> Hamburg - Germany
>> RockIt!
>>
>> GPG fingerprint: C044 8322 9E12 1483 4FEC 9452 B65D 6BE3 9ED3 9588
>>
>> https://people.apache.org/keys/committer/andywenk.asc
>>
Re: ANN: rlx(1) - Couchdb command line interface
Posted by muji <fr...@gmail.com>.
Thanks very much Andy - much appreciated :)
I have pinged Jenn on the other thread so maybe it will make the news!
Ciao!
On 11 January 2016 at 18:01, Andy Wenk <an...@apache.org> wrote:
> Hi muji,
>
> awesome! I have added the project to the wiki.
>
> https://cwiki.apache.org/confluence/display/COUCHDB/Node.js
>
> @marketing team - including into the news?
>
> All the best
>
> Andy
>
> On 11 January 2016 at 05:40, muji <fr...@gmail.com> wrote:
>
> > Hello,
> >
> > I am pleased to announce rlx[1], a full-featured command line interface
> for
> > couchdb:
> >
> > npm i -g rlx && rlx i
> >
> > Will launch an interactive session. Documentation is built in as man
> pages
> > with the `help` command - note that to edit documents `vim` is required.
> >
> > It was built and tested against couchdb 1.6.x and if people find it
> useful
> > I could contribute some more time for couchdb 2.x compatibility.
> >
> > All feedback very welcome - especially bugs[2]!
> >
> > Relax and enjoy!
> >
> > [1]: https://github.com/tmpfs/rlx
> > [2]: https://github.com/tmpfs/rlx/issues
> >
>
>
>
> --
> Andy Wenk
> Hamburg - Germany
> RockIt!
>
> GPG fingerprint: C044 8322 9E12 1483 4FEC 9452 B65D 6BE3 9ED3 9588
>
> https://people.apache.org/keys/committer/andywenk.asc
>
Re: ANN: rlx(1) - Couchdb command line interface
Posted by Andy Wenk <an...@apache.org>.
Hi muji,
awesome! I have added the project to the wiki.
https://cwiki.apache.org/confluence/display/COUCHDB/Node.js
@marketing team - including into the news?
All the best
Andy
On 11 January 2016 at 05:40, muji <fr...@gmail.com> wrote:
> Hello,
>
> I am pleased to announce rlx[1], a full-featured command line interface for
> couchdb:
>
> npm i -g rlx && rlx i
>
> Will launch an interactive session. Documentation is built in as man pages
> with the `help` command - note that to edit documents `vim` is required.
>
> It was built and tested against couchdb 1.6.x and if people find it useful
> I could contribute some more time for couchdb 2.x compatibility.
>
> All feedback very welcome - especially bugs[2]!
>
> Relax and enjoy!
>
> [1]: https://github.com/tmpfs/rlx
> [2]: https://github.com/tmpfs/rlx/issues
>
--
Andy Wenk
Hamburg - Germany
RockIt!
GPG fingerprint: C044 8322 9E12 1483 4FEC 9452 B65D 6BE3 9ED3 9588
https://people.apache.org/keys/committer/andywenk.asc
Re: ANN: rlx(1) - Couchdb command line interface
Posted by Andy Wenk <an...@apache.org>.
Hi muji,
awesome! I have added the project to the wiki.
https://cwiki.apache.org/confluence/display/COUCHDB/Node.js
@marketing team - including into the news?
All the best
Andy
On 11 January 2016 at 05:40, muji <fr...@gmail.com> wrote:
> Hello,
>
> I am pleased to announce rlx[1], a full-featured command line interface for
> couchdb:
>
> npm i -g rlx && rlx i
>
> Will launch an interactive session. Documentation is built in as man pages
> with the `help` command - note that to edit documents `vim` is required.
>
> It was built and tested against couchdb 1.6.x and if people find it useful
> I could contribute some more time for couchdb 2.x compatibility.
>
> All feedback very welcome - especially bugs[2]!
>
> Relax and enjoy!
>
> [1]: https://github.com/tmpfs/rlx
> [2]: https://github.com/tmpfs/rlx/issues
>
--
Andy Wenk
Hamburg - Germany
RockIt!
GPG fingerprint: C044 8322 9E12 1483 4FEC 9452 B65D 6BE3 9ED3 9588
https://people.apache.org/keys/committer/andywenk.asc
Re: ANN: rlx(1) - Couchdb command line interface
Posted by muji <fr...@gmail.com>.
Hi Pete,
Thanks for the message. I am glad you are enjoying it so far :)
The *app* functionality came from a desire to separate the elements of
design documents into a more structured approach and eventually came to
include database documents (and attachments) as well; so in effect it can
represent an entire *application*. Re-reading the man page I can see the
documentation needs improving, I have raised #5 (
https://github.com/tmpfs/rlx/issues/5).
Probably the easiest thing to do to get a grasp on it, is to browse the
test fixture:
https://github.com/tmpfs/rlx/tree/master/test/fixtures/app
I will try to expand more on this with some updated documentation. You may
also want to experiment with the *deploy* command as that follows all the
recommended steps to re-deploy a view in a production environment.
To get an idea of how the test fixture correlates to a single design
document, with the rlx repository as the working directory, try this
(couchdb running on localhost):
```
rlx i
cd :lh
db add mydb
cd mydb
app push test/fixtures/app -i myddoc
app get myddoc
```
I just tried this with the 2.x alpha version and it is working fine, I see
the entire collated design document in Fauxton. Hope that helps a little
with the app command.
Because the *app* command encapsulates a design document (and it's views) I
hope this also answers the second part of your question. Although,
executing and querying views still needs some work from what I recall to
cater for pagination and large result sets.
Feel free to raise questions and bugs on github!
Cheers - muji.
On 14 January 2016 at 09:59, Peter Figliozzi <pe...@gmail.com>
wrote:
> I have installed rlx and am keeping an interactive session open as I start
> two new Couch projects this week. Lovely so far, especially the vim
> integration.
>
> Muji, can you please explain the "app" functionality? Reading the man page
> on "app", it feels like rlx is supposed to know about view, list, show,
> etc., files in a project tree and put them into the design doc. And can
> you give an example of creating a new design doc using the templates? I
> get the same design doc created no matter what I put after "-t".
>
> Backing up a bit, maybe you could outline how rlx is intended to be used
> with design docs and writing views, etc.
>
> Thanks much,
>
> Pete
>
> On Sun, Jan 10, 2016 at 10:40 PM, muji <fr...@gmail.com> wrote:
>
> > Hello,
> >
> > I am pleased to announce rlx[1], a full-featured command line interface
> for
> > couchdb:
> >
> > npm i -g rlx && rlx i
> >
> > Will launch an interactive session. Documentation is built in as man
> pages
> > with the `help` command - note that to edit documents `vim` is required.
> >
> > It was built and tested against couchdb 1.6.x and if people find it
> useful
> > I could contribute some more time for couchdb 2.x compatibility.
> >
> > All feedback very welcome - especially bugs[2]!
> >
> > Relax and enjoy!
> >
> > [1]: https://github.com/tmpfs/rlx
> > [2]: https://github.com/tmpfs/rlx/issues
> >
>
Re: ANN: rlx(1) - Couchdb command line interface
Posted by Peter Figliozzi <pe...@gmail.com>.
I have installed rlx and am keeping an interactive session open as I start
two new Couch projects this week. Lovely so far, especially the vim
integration.
Muji, can you please explain the "app" functionality? Reading the man page
on "app", it feels like rlx is supposed to know about view, list, show,
etc., files in a project tree and put them into the design doc. And can
you give an example of creating a new design doc using the templates? I
get the same design doc created no matter what I put after "-t".
Backing up a bit, maybe you could outline how rlx is intended to be used
with design docs and writing views, etc.
Thanks much,
Pete
On Sun, Jan 10, 2016 at 10:40 PM, muji <fr...@gmail.com> wrote:
> Hello,
>
> I am pleased to announce rlx[1], a full-featured command line interface for
> couchdb:
>
> npm i -g rlx && rlx i
>
> Will launch an interactive session. Documentation is built in as man pages
> with the `help` command - note that to edit documents `vim` is required.
>
> It was built and tested against couchdb 1.6.x and if people find it useful
> I could contribute some more time for couchdb 2.x compatibility.
>
> All feedback very welcome - especially bugs[2]!
>
> Relax and enjoy!
>
> [1]: https://github.com/tmpfs/rlx
> [2]: https://github.com/tmpfs/rlx/issues
>