@kaltura-ng/dev-workspace

Kaltura internal tool used to setup Kaltura applications development workspace

Stats

StarsIssuesVersionUpdatedCreatedSize
@kaltura-ng/dev-workspace
2.4.14 years ago4 years agoMinified + gzip package size for @kaltura-ng/dev-workspace in KB

Readme

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
    
  3. add this tool to your folder in your root folder by running the following command:

    $ npm install @kaltura-ng/dev-workspace
    
  4. 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"
    }
    }
    
  2. run setup command to build & symlink your repositories

    $ npm run setup
    

Commands

init

setup

run

licenses

clean

If you find any bugs or have a feature request, please open an issue on github!

The npm package download data comes from npm's download counts api and package details come from npms.io.