node-reposync

Helper NPM package for syncing base project with multiple repos.

This nodejs module was created to substitute repo tool required to download and update multiple repositories while working with Yocto-based projects.

It also allows to use nodejs package.json to manage build scripts for your Yocto-based project.

Quick start

Existing project

1. Install module as developer dependency:

npm install node-reposync --save-dev
# or if you usually yarn:
yarn add node-reposync --dev

2. Add repos and reposDir to your package.json

• repos is stores all repos that needs to be synchronized;
• reposDir defines a directory where all repos will be synchronized;

For example:

{
	"reposync": {
		"repos": {
			"meta-openembedded": {
				"url": "https://github.com/openembedded/meta-openembedded.git",
				"branch": "kirkstone",
				"depth": 1
			}
		},
		"dir": "sources"
	}
}

4. Add script to your package.json

{
	"scripts": {
		"sources": "reposync"
	}
}

5. Run invocation script

npm run sources

New project

1. Create package.json for parent project

First, lets create package.json:

npm init

Second, add repos and/or reposDir to package.json.

Minimal package.json should have this:

{
	"reposync": {
		"repos": {
			"meta-openembedded": {
				"url": "https://github.com/openembedded/meta-openembedded.git"
			}
		}
	}
}

Practical package.json can have also branch names and depth levels, alone with directory where repos will be synchronized:

{
	"reposync": {
		"repos": {
			"meta-openembedded": {
				"url": "https://github.com/openembedded/meta-openembedded.git",
				"branch": "kirkstone",
				"depth": 1
			}
		},
		"dir": "sources"
	}
}

2. Invocation from parent project

Javascript:

// sources.js
var Reposync = require('node-reposync');
var sync = new Reposync.Sync();
console.log(sync.doSync({}));

Or if you prefer Typescript (you will need to enable Typescript support to run this):

import { Sync } from 'node-reposync';
new Sync().doSync({});

Full working example

For this example you will need nodejs and NPM installed.

0. Install required tools

Ubuntu

This will also install nodejs

sudo apt install -y npm

Other OSes

Please refer to this link:

https://docs.npmjs.com/downloading-and-installing-node-js-and-npm

1. package.json

Create package.json in root directory of your project.

{
	"name": "your-distro",
	"version": "0.0.1",
	"description": "",
	"scripts": {
		"sources": "node sources.js"
	},
	"dependencies": {
		"node-reposync": "^0.0.5"
	},
	"reposync": {
		"dir": "sources",
		"repos": {
			"poky": {
				"url": "git://git.yoctoproject.org/poky",
				"branch": "kirkstone",
				"depth": 1
			},
			"meta-openembedded": {
				"url": "https://github.com/openembedded/meta-openembedded.git",
				"branch": "kirkstone",
				"depth": 1
			},
			"openembedded-core": {
				"url": "git://git.openembedded.org/openembedded-core",
				"branch": "kirkstone",
				"depth": 1
			}
		}
	}
}

2. sources.js

Create sources.js in root directory of your project.

// sources.js
var Reposync = require('node-reposync');
var sync = new Reposync.Sync();
console.log(sync.doSync({}));

3. Initialize NPM

Run in terminal from root directory of your project.

npm install

4. Run

Now you can run sources sync script. It will git clone or git fetch into specified rootDir, depending on existence of repo directory.

npm run sources