Notwithstanding Precautions, Misadventure

    npj

    1.0.4 • Public • Published

    NPJ

    npj (npm jumper) acts as a global bridge between all your npm projects.

    Installation

    npm i -g https://github.com/austinbillings/npj.git

    Overview

    npj makes use of a per-user local "registry" to keep track of which NPM packages are in development are in development where on your machine. This also allows it to easily run scripts from any registered package, triggerable from any directory on your system.

    The file used by npj to store your registry lives at ~/.npj-registry, and its contents are a plain JSON object which maps projectName keys to packageDirPath values.

    Usage

    See help

    npj --help

    Register a package

    cd my-project # anything with a package.json will do 
    npj add
    [NPJ] ✓ OK:    my-project -> /Users/admin/code/my-project @0.0.1
    

    Show registered packages

    npj ls
    [NPJ] «package»  my-project @0.0.1
    [NPJ] >>>>       -->--> /Users/admin/code/my-project
    

    Add another package

    cd ../some-other-project
    npj add
    [NPJ] ✓ OK:    some-other-project -> /Users/admin/code/some-other-project @1.0.3
    

    Listing packages afterward (npj ls):

    [NPJ] «package»  my-project @0.0.1
    [NPJ] >>>>       -->--> /Users/admin/code/my-project
    [NPJ] «package»  some-other-project @1.0.3
    [NPJ] >>>>       -->--> /Users/admin/code/some-other-project
    

    Remove from registry

    cd my-project
    npj remove
    
    [NPJ] ✓ OK:    Removed "some-other-project" from registry
    

    List scripts offered by a registered package

    npj scripts my-package
    [NPJ] «package»  my-package @0.0.1
    [NPJ] >>>>       -->--> /Users/admin/code/my-package
    [NPJ] «script»   test
    [NPJ] >>>>          node tests/all.js
    [NPJ] «script»   build
    [NPJ] >>>>          node build.js
    

    Run a registered package's script (or multiple!)

    When multiple <packageName>:<scriptName> sets are provided, they are run in sequence (not parallel!)

    npj my-project:build my-project:test
    [NPJ] «script»   my-project: Running script «build»
    
    > my-project@0.0.1 build /Users/admin/code/my-project
    > node build.js
    ...
    [NPJ] «script»   script process exited with code 0
    [NPJ] «script»   my-project: Running script «test»
    
    > my-project@0.0.1 test /Users/admin/code/my-project
    > node tests/all.js
    ...
    [NPJ] «script»   script process exited with code 0
    

    Keywords

    none

    Install

    npm i npj

    DownloadsWeekly Downloads

    0

    Version

    1.0.4

    License

    MIT

    Unpacked Size

    16.8 kB

    Total Files

    6

    Last publish

    Collaborators

    • austinbillings