nuxeo/nuxeo-cli

Name: nuxeo-cli

Owner: Nuxeo

Description: Nuxeo CLI is a command-line interface for helping developers around Nuxeo ecosystem. It provides project bootstrapping, bundles hot reload,...

Created: 2017-02-21 21:49:45.0

Updated: 2017-02-26 14:36:40.0

Pushed: 2018-02-23 21:10:34.0

Homepage: null

Size: 264

Language: JavaScript

GitHub Committers

User	Most Recent Commit	# Commits

Other Committers

User	Email	Most Recent Commit	# Commits

README

About

Nuxeo CLI is a command-line interface for helping developers around Nuxeo ecosystem. It provides project bootstrapping, bundles hot reload,…

Overview

Nuxeo CLI includes several commands for working with your Nuxeo Project

• bootstrap: Bootstrap Nuxeo project, bundles or several components
• hotreload: Trigger hot reload on your development server
• update: Keep Nuxeo CLI up to date

Installation

Install via NPM:

install -g nuxeo-cli

Then nuxeo executable should be available; ensure you can run:

o

Usage

o <command> [options] [args]

Options

, --help     Print Nuxeo CLI version                               [boolean]
, --version  Show version                                          [boolean]
             Quiet - Hide welcome message                          [boolean]

Commands

Sync

Usage

o sync [--src "<src_folder>"] [--dest "<dest_folder"]

One-way Synchronization files (src folder to dest folder), then watch any changes occured in a child from the source folder to repercute it to the dest folder.

If you start this command inside a nuxeo-cli bootstrap project that has been registered for hotreload (nuxeo hotreload configure), the destination path is computed to the registered distribution.

dest         Destination Folder                           [string] [default:
           "/Users/foo/nuxeo-server-tomcat-9.3-SNAPSHOT/nxserver/nuxeo.war"]

If you start command inside a Studio Project clone, the source path is computed to nuxeo.war folder.

src          Source Folder         [default: "./studio/resources/nuxeo.war"]

You can watch several source folders:

o sync --src "<src1_folder>" --src "<src2_folder>" --src "<src3_folder>" --dest "<dest_folder"

You can fine tune which files are tracked, by overriding the pattern option:

o sync --pattern "*.js"

Options

ons:
, --help     Show help                                             [boolean]
, --version  Show version                                          [boolean]
             Quiet - Hide welcome message                          [boolean]
src          Source Folder                     [default: "/tmp/watcher/src"]
dest         Destination Folder      [string] [default: "/tmp/watcher/dest"]
pattern      Glob matching pattern for synchronizable files
                          [default: "*.+(js|html|jpg|gif|svg|png|json|jsp)"]

Update

o update

Update internal generator-nuxeo module to gets latest changes without updating nuxeo-cli.

Bootstrap

o bootstrap [<generator>..] [options]

See: Generator Nuxeo Bootstrap

Bootstrap Script

Script project bootstrap by passing questions' answers as command options.

o-bootstrap [<generator>..] [options]

Options

ons:
dry-run, -n  Don't actually create the file(s), just list parameters,
             default values and errors.                     [default: false]
help         Show help                                             [boolean]

Examples

Dry-run an operation creation to check parameters names and default values:

o-bootstrap operation -n

Create a single-module plus an operation:

o-bootstrap single-module operation --package com.sample --operation_name SampleOperation --operation_label="My Sample Operation"

hotreload

o hotreload [hotreload|configure] [options]

See: Generator Nuxeo Hotreload

studio

o studio [link|unlink] [options]

Link or Unlink your project to your Studio project to package it easily and be able to test ev erything together.

o studio import

Import in your project a constant file containing your Studio features in order to reuse them easily in your code.

o studio export

Export your project's contributions to the Studio registries in order to reuse them in Studio.

Proxy

Proxy configuration rely on the common Unix environment variable HTTP_PROXY or http_proxy. Value format: [username:password@]www.host.com[:1334]

_PROXY=john:doe@fake.proxy:1337 nuxeo b multi-module

Tester/Developer Environment

Lots of Nuxeo CLI logic is held in generator-nuxeo project. You must link both projects to be able to have live modifications.

install -g nuxeo/nuxeo-cli#master

Release

Release tag and dependencies lock are plugged to the version NPM's command.

When you bump the version

preversion task

• node_modules folder and package-lock.json file are deleted.
• generator-nuxeo dependency installed using the latest release.
• Install all the others dependencies.
• add package-lock.json file to the next commit.

postversion task

• run npm publish
• remove package-lock.json for the next commit.
• bump module version without a new tag.
• install generator-nuxeo#master.
• add a post-release commit.
• push everything.

Examples

mp major version
version major

mp patch
version patch

Licensing

Apache License, Version 2.0

About Nuxeo

Nuxeo dramatically improves how content-based applications are built, managed and deployed, making customers more agile, innovative and successful. Nuxeo provides a next generation, enterprise ready platform for building traditional and cutting-edge content oriented applications. Combining a powerful application development environment with SaaS-based tools and a modular architecture, the Nuxeo Platform and Products provide clear business value to some of the most recognizable brands including Verizon, Electronic Arts, Sharp, FICO, the U.S. Navy, and Boeing. Nuxeo is headquartered in New York and Paris. More information is available at www.nuxeo.com.