Add support for npm install

[rlouapre]

Would it be possible to add package.json in the root project so Roxy could be installed from npm?

MarkLogic Slush generator could then use it with gulp-install task and this code [2] would not be necessary.

[1] - https://docs.npmjs.com/cli/install
[2] - https://github.com/marklogic/slush-marklogic-node/blob/master/slushfile.js#L32-L66

[grtjn]

I like the idea of making Roxy into an npm package, but the section of slushfile you are referring to only downloads the ml script. The ml new command in the runRoxy part after that will do a git clone to fetch full Roxy, and run the init command on it.

Might be interesting though to consider reengineering ml new and ml upgrade to not use git, or allow npm as a fallback?

[rlouapre]

I never noticed and used ml new

npm would provide a easier way to install and update Roxy. It will also help to integrate Roxy in Gulp scripts.

[joemfb]

I like npm quite a bit, but Roxy is almost entirely Ruby. I think it should be published as a gem on rubygems.org

[grtjn]

Would make a lot of sense for RoxyJS if that ever sees life.. ;-)

[dmcassel]

My group will have some interns this summer. I'm thinking about putting them to work on a Node-based RoxyJS using the Management API.

[joemfb]

Do you know if there are the plans to include management API methods / bindings with the official node client?

[dmcassel]

From my sources, no concrete plans, but we're open to the official client expanding in that direction. Tickets for discussion would be good before PRs.

[rlouapre]

My initial question was just about to ease Roxy install from gulp / javascript.
I end up using download package and the following code:

    var installRoxy = function(answers, cb) {
        var Download = require('download');
        new Download({mode: '755', extract: true, strip: 1})
            .get('https://github.com/marklogic/roxy/releases/download/v' + answers.roxyVersion + '/roxy-' + answers.roxyVersion + '.zip')
            .dest('./roxy')
            .run(
                function() {
                    if (cb) cb();
                }
            );
    };

[grtjn]

Thnx for sharing!

[grtjn]

Elegant way to download Roxy by the way, using the release zip, instead of using git clone. It does mean you cannot make use of the dev branch, which often has some nice new extras, but alas.

I agree with Joe though, that it doesn't make too much sense to make an npm package of Roxy. But a Gem doesn't really make much sense either. Roxy is mostly a standalone app.

I would see something in making an mlpm package out of it. @joemfb WDYT? And if you agree, what would we need to do to get this as a package into mlpm registry?

[joemfb]

I disagree; I think Roxy is or should be a command-line tool for managing apps. And since it's written in Ruby, I think it should be distributed as a gem. (Homebrew could also work, but then what about Windows: nuget?)

That would mean that app_specific.rb, build.properties, and any environment-specific config would live within a Roxy project, but all the Ruby and XQuery libraries would be bundled within the gem. One nice consequence of this would be cleaner, smaller projects.

My view for mlpm is that it should manage packages that are to be evaluated within Marklogic. I think Marklogic-related tools should use language/environment specific distribution mechanisms (npm for js, Rubygems for ruby, pip for python, etc.).

[grtjn]

Makes sense. So not npm package, nor mlpm package. Still not sure about gem either though. A gem would make perfect sense if Roxy would be a library that you could 'require' from within a different Ruby project. But Roxy is a large mix of things. There is all kinds of stuff in there.

And apart from all that, I see not a lot of gain in packaging Roxy to be honest. Just downloading the zip, or the ml script seems pretty straight-forward already to me..

Anyone else thoughts on this?

[joemfb]

Like npm packages, ruby gems aren't just for managing dependencies, but also distributing executables:

• http://www.awesomecommandlineapps.com/gems.html
• http://robdodson.me/how-to-write-a-command-line-ruby-gem/

[grtjn]

I know, but still..

[rlouapre]

I did not say that Roxy should be published a npm package. I just suggested to add a package.json