iMLCP is an interactive shell for MarkLogic Content Pump.
Author: Matt Sun
- Run any MLCP command as-is
- Auto-completion: , Including all MLCP commands, all options, frequently-used value (true, false, xml, all input types, etc…) and system file path. (Hit TAB)
- Run any system shell command (for example: $ls –ltr | grep –iR “bin”)
- Support file path wildcard
- Easy to deploy, standalone project of MLCP
- MLCP command automatically copied to clipboard
- Enable/disable debug mode runtime
- History dump: all MLCP command and output history
- Interactive (Read-Eval-Print Loop) with many useful commands
- Get rid of many existing system shell limitations, include but not limit to:
- Use space in your option argument! (-output_uri_replace "str,'hello world'" doesn't work before becasue space between hello and world)
- No automatic path expanding limitation of system shell (which may cause 'Argument too long' error)
- Use | pipline as delimiter! or any other special character... No need to use double quote to enclose some fields (-delimiter | deosn't work before since vertical bar has special meaning in system shell)
| Command | Usage |
|---|---|
| debug | Enable/disable runtime debug mode |
| clear | Clean the screen |
| exit | Exit the MLCP interactive shell |
| $[command] | Execute system shell command. Example: $ls -al |
| jobs [number[,number]] | View command history and output. Example: jobs 1,2,4 |
| help | Help for MLCP |
| CTRL+C | Discard current command line input |
| ? | Help for interactive shell |
All the commands are case-insensitive (except system shell commands).
- Copy all the file(s) in ${rootdir}/deliverable/lib to ${mlcp}/lib
- Copy all the file(s) in ${rootdir}/deliverable/bin to ${mlcp}/bin
- from MLCP root directory, run following command:
bin/imlcp.shThen iMLCP should be lauched.
From root directory of the project, run following command:
sh build.shAfter successful build, follow the steps in #Usage to run iMLCP.
- Maven 3 (to build)
- Java 7 (same version requirement of MLCP)
- jlineEnhanced v2.15 A friendly fork of jline2 with specific enhancement for iMLCP
- MLCP MarkLogic Content Pump, an open-source, Java-based command-line tool that provides the fastest way to import, export, and copy data to or from MarkLogic databases
- Other dependencies are mostly for MLCP, see pom.xml for more details.
Currently only support *nix systems. Will extend the support to Windows and other system later.
iMLCP uses the same version number of MarkLogic Server. See branches or tags for iMLCP releases. Branches matching previous MarkLogic Server version can be made on demand. Email author for more details.
- Option value masking (password)
- Windows support
- Shell output coloring
- User experience improvement
Discuss Group All new releases, discuss, issues and feature requirement can be posted/viewed from discuss group. Subscribe to it now!
In place of a legal notice, here is a blessing:
May you do good and not evail.
May you find forgiveness for yourself and forgive others.
May you share freely, never taking more than you give.