@kaltura-ng/dev-workspace

    2.4.1 • Public • Published

    Kaltura Dev Workspace

    Gitter chat npm version

    Tool for managing JavaScript projects with multiple packages.

    About

    Our code base for kmc-ng and tvm-ng is organized into multiple packages/repositories. However, making changes across many repositories is messy.

    For monorepos there is a great tool named lerna that optimizes the workflow around managing multi-package repositories with git and npm.

    But in our case with have a mix of:

    • single package repo.
    • single application repo.
    • multiple packages in monorepo.

    Unfortunately lerna only support monorepo so we cannot use it as-is.

    To overcome this issue we created this tool.

    Kaltura dev workspace package is inspired deeply from lerna tool. We find lerna the best tool that simplify complicated dev-op operation. We recommend you to try lerna for your own projects.

    Who should use this tool

    This tool was created for Kaltura applications development and is not suppose to be used for other projects.

    Getting Started

    Prerequisites

    Setup your workspace

    1. create a folder to hold your packages (your workspace root folder).
    2. create package.json in your root folder by running the following command:
     $ npm init -y
    
    1. add this tool to your folder in your root folder by running the following command:
    $ npm install @kaltura-ng/dev-workspace
    
    1. create file kaltura-ws.json in your root folder with the following format:
     {
       "version" : "2.0.0",
       "repositories": [
         { "origin" : "github", "uri": "https://github.com/kaltura/kaltura-ng.git"},
         { "origin" : "github", "uri": "https://github.com/kaltura/kaltura-ng-mc-theme.git"},
         { "origin" : "github", "uri": "https://github.com/kaltura/kmc-ng.git"}
       ],
       "licenses" : {
         "ignoreList" : [      
           "kaltura-typescript-client"
         ]
       }
     }
     

    Notes:

    • you should modify repositories property to hold a list of relevant repositories to your kaltura project ordering them by the dependency constraints.
    • the sample above will setup your workspace to develop kmc-ng application.
    1. add the following to your package.json:
    {  
      "scripts" : {
        "kws" : "kws",
        "setup" : "kws setup",
        "build" : "kws run build",
        "licenses" : "kws licenses",
        "clean" : "kws clean"
      }
    }
    1. run setup command to build & symlink your repositories
    $ npm run setup

    Commands

    init

    setup

    run

    licenses

    clean

    Keywords

    none

    Install

    npm i @kaltura-ng/dev-workspace

    DownloadsWeekly Downloads

    6

    Version

    2.4.1

    License

    ISC

    Last publish

    Collaborators

    • kaltura
    • eransakal
    • amirch